
# Dart で書く Edge Function

Edge Function は TypeScript でなくてもかまいません。[`spring_boot_starter_edge`](../spring-boot-starter-edge/index.md) は、Spring for Dart のアプリケーションを JavaScript にコンパイルし、Supabase の Edge Runtime が必要とする `index.ts` を書きます。アプリケーションにこのスターターがあれば、関数は呼び出し元としてプロジェクトに届きます。設定は [Supabase Edge Functions](../spring-boot-starter-edge/supabase.md) を参照してください。

[`example/supabase/function`](https://github.com/farum-azula/spring_core_dart/tree/main/example/supabase/function) がそのような関数で、名前は `api` です。その `main` は次のとおりです。

```dart
@SpringBootApplication()
void main() => runFetchApplication(() => springApplication);
```

```bash
dart run build_runner build
dart run spring_boot_starter_edge:build \
  --platform supabase --name api \
  --output ../supabase/functions/api
```

## 示しているもの

- **呼び出し元としての、REST パスによる todos。** `Todos` リポジトリ (`ListCrudRepository<Todo, int>`) に、`findByListIdOrderById` と `@Procedure('close_all')` があります。リクエストのトークンはプロジェクトにそのまま渡されるので、呼び出し元に何が見えるかはプロジェクトの行レベルセキュリティが決めます。関数にはソケットがないため、使えるのは REST パスだけで、SQL は使えません。
- **ロール。** `/health` は誰にでも開かれています。`/me` は、リソースサーバーがプロジェクトのトークンから読んだ ID とロールを返します。`/admin` は `@PreAuthorize("hasRole('ADMIN')")` です。ベアラートークンはプロジェクトのアクセストークンで、Supabase スターターのデフォルトに従います。
- **ユーザーごとに 1 分 10 回のレート制限。** todo の追加には `@RateLimiter('10/1m', key: '#{authentication.name}', name: 'add-todo')` が付いています。カウンターはプロジェクトのデータベースにあり、サービスロールとして呼ばれるデータベース関数 `rate_limit_acquire` を通して数えるので、関数のすべてのインスタンスが同じ数を共有します。`spring.web.rate-limit.enabled: true` のとき、これは Supabase スターターのデフォルトのストアです。

```dart
@PostMapping()
@ResponseStatus(HttpStatus.created)
@RateLimiter('10/1m', key: '#{authentication.name}', name: 'add-todo')
Future<Todo> add(@RequestBody() @Valid() NewTodo todo) => todos.save(
  Todo(
    title: todo.title,
    listId: todo.listId,
    createdAt: DateTime.now().toUtc(),
  ),
);
```

- **アプリとサーバーが呼ぶもの。** `GET /stats` は、誰が呼んだか (リソースサーバーが検証済みのトークンから読んだユーザーとロール、そして `apikey` ヘッダーが届いたかどうか) を返します。`from=fail` は 422 を返します。`POST /send-invite` は `{email}` を受け取り、呼び出し元の ID とアドレスからなる `{id}` を返します。アプリとサーバーは、それぞれの `@EdgeFunctions` インターフェースの `@EdgeFunction('api/stats')` と `@EdgeFunction('api/send-invite')` を通してこれらを呼びます。アプリはブラウザーでも動き、プロジェクトとは別のオリジンになるため、コントローラーには `@CrossOrigin` があり、プリフライトに応答します。

サンプルのプロジェクトには、TypeScript で書かれた関数はありません。この二つは、この関数のエンドポイントです。

関数は、サンプルの `config.toml` で `verify_jwt = false` の `[functions.api]` となり、ローカルスタックのために `[edge_runtime.secrets]` に `SPRING_SUPABASE_AUTH_ISSUER` があります。

## 関連項目

- [spring_boot_starter_edge](../spring-boot-starter-edge/index.md)
- [関数が異なる点](../spring-boot-starter-edge/differences.md)
- [誰として呼び出すか](credentials.md)
