better-supabase 0.8.0 → 0.10.0

package/README.md

@@ -57,14 +57,14 @@ Each call is still one PostgREST request, and it runs as the signed-in user, so
 - **Auth without extra round trips.** Valid access tokens are [verified locally](https://bettersupabase.com/docs/auth) against the JWKS and never reach the Auth server. Refresh happens once, in the proxy. The service role is an explicit `bs.admin()` call.
 - **Cache tags that follow writes.** Mutations [invalidate the tables they change](https://bettersupabase.com/docs/concepts/caching), with read-your-writes in Next.js server actions and table-based invalidation in TanStack Query.
 - **Plugins.** [Timestamps, soft delete, tenant scoping, actor columns, validation and rules](https://bettersupabase.com/docs/plugins), each versioned and opt-in.
-- **Blocks for the SQL every app repeats.** [Jobs on Supabase Queues](https://bettersupabase.com/docs/blocks/jobs), webhook inboxes, idempotency keys, organizations and invitations, notifications, outgoing webhooks, API keys, billing, usage quotas, feature flags, SSO and SCIM, vector search and Stripe entitlements. [`better-supabase sql add`](https://bettersupabase.com/docs/blocks/sql) writes the tables, functions and policies into your declarative schema.
+- **Blocks for the SQL every app repeats.** [Jobs on Supabase Queues](https://bettersupabase.com/docs/blocks/jobs), webhook inboxes, idempotency keys, organizations and invitations, notifications, outgoing webhooks, API keys, billing, usage quotas, feature flags, SSO and SCIM, vector search and Stripe entitlements. [`better-supabase add`](https://bettersupabase.com/docs/blocks/sql) writes the tables, functions and policies into your declarative schema.
 - **Tests and CI checks.** [`asUser`](https://bettersupabase.com/docs/testing) runs RLS tests as any user against the local stack, `gen --check` fails on schema drift, and [`doctor`](https://bettersupabase.com/docs/cli/doctor) reports security and performance findings, with SARIF output for code scanning.
 
 ## Install
 
 ```bash
 pnpm add better-supabase @supabase/supabase-js
-pnpm add -D pg @supabase/postgrest-typegen@0.4.0
+pnpm add -D pg @supabase/postgrest-typegen@0.6.0
 ```
 
 `pg` and `@supabase/postgrest-typegen` are optional peers that only the CLI loads, to read your schema and write `database.types.ts`; apps that only run the runtime entries skip them. Before installing, `npx better-supabase init` detects your frameworks and prints the install command for your package manager. The package is ESM only. The CLI needs Node 24 or later, and the runtime entries run on every WinterTC runtime. On runtimes without a native `Temporal` (Node 24, Safari), load [`temporal-polyfill`](https://bettersupabase.com/docs/concepts/temporal) once at startup. TypeScript 6 and 7 are tested.
@@ -152,7 +152,7 @@ pnpm better-supabase gen                    # database.types.ts and generated.ts
 pnpm better-supabase gen --check            # exit 1 in CI when the schema drifted
 pnpm better-supabase doctor                 # RLS, grants, indexes and Supabase advisors
 pnpm better-supabase doctor --format sarif  # the same findings for GitHub code scanning
-pnpm better-supabase sql add jobs           # a SQL module into supabase/schemas
+pnpm better-supabase add jobs               # a block's SQL into supabase/schemas
 pnpm better-supabase skills install         # Agent Skills for your coding agent
 ```
 
@@ -163,29 +163,29 @@ See the [CLI reference](https://bettersupabase.com/docs/cli) for every command a
 Blocks are the features most SaaS apps build by hand. Each one installs [SQL modules](https://bettersupabase.com/docs/blocks/sql) (tables, functions and RLS policies) into your declarative schema, and blocks with a TypeScript side import it from `better-supabase/blocks/<name>`:
 
 ```bash
-pnpm better-supabase sql add organizations invitations
+pnpm better-supabase add organizations invitations
 ```
 
-List them in `sql.modules` in `better-supabase.config.ts` so `better-supabase sql sync` keeps the files up to date. Each key is a module, and its value holds that module's settings, such as its roles, permission keys or the existing tables it adopts:
+`add` lists them under `blocks` in `better-supabase.config.ts`, so `better-supabase sql sync` keeps the files up to date. Each key is a block, and its value holds that block's settings, such as its roles, permission keys or the existing tables it adopts:
 
 ```ts
 export default defineConfig({
-  sql: {
-    modules: {
-      access: {
-        roles: {
-          owner: ["*"],
-          admin: ["organization.*", "members.*"],
-          member: ["organization.read"],
-        },
+  blocks: {
+    access: {
+      roles: {
+        owner: ["*"],
+        admin: ["organization.*", "members.*"],
+        member: ["organization.read"],
       },
-      organizations: {},
-      invitations: { permissions: { invite: "organization.members.invite" } },
     },
+    organizations: {},
+    invitations: { permissions: { invite: "organization.members.invite" } },
   },
 });
 ```
 
+Or start from a preset, such as `npx better-supabase init --preset saas`, and add or remove blocks from there.
+
 The TypeScript side calls those functions as the signed-in user:
 
 ```ts
@@ -195,44 +195,101 @@ const organizations = createOrganizations({ transport, actorId: user.id });
 await organizations.invite({ organizationId, email, role: "member" });
 ```
 
-| Block                                                                                                                                                                                   | Import                                                                                     | SQL modules                            |
-| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | -------------------------------------- |
-| [createBlocks](https://bettersupabase.com/docs/blocks/create-blocks): builds several blocks from one set of options and wires the blocks that use each other                            | `better-supabase/blocks`                                                                   | none                                   |
-| [Access contract](https://bettersupabase.com/docs/blocks/access): `can()` for policies, over fixed roles, your own permission catalog or an authorization provider                      | SQL only                                                                                   | `access`, `tenant`                     |
-| [Organizations](https://bettersupabase.com/docs/blocks/organizations): members, invitations, roles and switching                                                                        | `better-supabase/blocks/organizations`                                                     | `organizations`, `invitations`         |
-| [Profiles](https://bettersupabase.com/docs/blocks/profiles): a profile row per user, synced from Auth                                                                                   | `better-supabase/blocks/profiles`                                                          | `profiles`                             |
-| [Jobs](https://bettersupabase.com/docs/blocks/jobs): Supabase Queues jobs, cron, idempotency keys and a webhook inbox                                                                   | `better-supabase/blocks/jobs`                                                              | `jobs`, `idempotency`, `webhook-inbox` |
-| [Outbox](https://bettersupabase.com/docs/blocks/outbox): transactional events with consumer cursors, relayed as CloudEvents                                                             | `better-supabase/blocks/outbox`                                                            | `outbox`                               |
-| [Notifications](https://bettersupabase.com/docs/blocks/notifications): sending, listing and delivering notifications, and `useNotifications` for a live list                            | `better-supabase/blocks/notifications`, `better-supabase/blocks/notifications/react`       | `notifications`                        |
-| [Inbox](https://bettersupabase.com/docs/blocks/inbox): shared inboxes with conversations, assignment, notes, read receipts and channel delivery, plus `useInbox` and a chat widget      | `better-supabase/blocks/inbox`, `better-supabase/blocks/inbox/react`                       | `inbox`, `chat-sdk-state`              |
-| [Webhooks](https://bettersupabase.com/docs/blocks/webhooks-out): Standard Webhooks, verifying incoming ones and delivering outgoing ones                                                | `better-supabase/blocks/webhooks`                                                          | `webhooks-out`                         |
-| [API keys](https://bettersupabase.com/docs/blocks/api-keys): hashed keys per tenant and per user, with scopes, rotation, expiry and an `apiKey` caller in every adapter                 | `better-supabase/blocks/api-keys`                                                          | `api-keys`                             |
-| [Audit log](https://bettersupabase.com/docs/blocks/audit): list, filter, export as NDJSON or OCSF, and purge per tenant                                                                 | `better-supabase/blocks/audit`                                                             | `audit`                                |
-| [Settings](https://bettersupabase.com/docs/blocks/settings): typed settings per user and per organization, validated with Standard Schema                                               | `better-supabase/blocks/settings`                                                          | `settings`                             |
-| [Usage](https://bettersupabase.com/docs/blocks/usage): idempotent usage counters, quotas in RLS and RPCs, and Stripe meter reporting                                                    | `better-supabase/blocks/usage`                                                             | `usage`                                |
-| [Billing](https://bettersupabase.com/docs/blocks/billing): Stripe Checkout, the customer portal, seat sync and webhook handling                                                         | `better-supabase/blocks/billing`                                                           | `billing`                              |
-| [Feature flags](https://bettersupabase.com/docs/blocks/flags): targeting rules, overrides and rollouts, evaluated in RLS and in an OpenFeature-shaped provider                          | `better-supabase/blocks/flags`                                                             | `flags`                                |
-| [Comments](https://bettersupabase.com/docs/blocks/comments): threaded comments with mentions, and an activity feed from the outbox                                                      | `better-supabase/blocks/comments`                                                          | `comments`                             |
-| [Attachments](https://bettersupabase.com/docs/blocks/attachments): files linked to records, signed uploads and downloads, and a malware scan gate                                       | `better-supabase/blocks/attachments`                                                       | `attachments`                          |
-| [Data lifecycle](https://bettersupabase.com/docs/blocks/data-lifecycle): data exports and organization deletion with a grace period                                                     | `better-supabase/blocks/data-lifecycle`                                                    | `data-lifecycle`                       |
-| [SSO](https://bettersupabase.com/docs/blocks/sso): verified domains, SAML per organization, SSO enforcement and SCIM 2.0                                                                | `better-supabase/blocks/sso`                                                               | `sso`                                  |
-| [Onboarding](https://bettersupabase.com/docs/blocks/onboarding): checklists per user or organization, and `useOnboarding`                                                               | `better-supabase/blocks/onboarding`, `better-supabase/blocks/onboarding/react`             | `onboarding`                           |
-| [Waitlist](https://bettersupabase.com/docs/blocks/waitlist): a waitlist with approvals, hashed invite codes and an invite-only sign-up hook                                             | `better-supabase/blocks/waitlist`                                                          | `waitlist`                             |
-| [Announcements](https://bettersupabase.com/docs/blocks/announcements): in-app announcements by audience and time window, and `useAnnouncements`                                         | `better-supabase/blocks/announcements`, `better-supabase/blocks/announcements/react`       | `announcements`                        |
-| [AI chat](https://bettersupabase.com/docs/blocks/ai-chat): chats with branches, shares, a model catalog, moderation and runs, in the canonical message format, and `useAiChats`         | `better-supabase/blocks/ai-chat`, `better-supabase/blocks/ai-chat/react`                   | `ai-chat`                              |
-| [AI files](https://bettersupabase.com/docs/blocks/ai-files): attachments and generated files in a private bucket, provider file references and versioned documents with suggested edits | `better-supabase/blocks/ai-files`                                                          | `ai-files`                             |
-| [Knowledge](https://bettersupabase.com/docs/blocks/knowledge): documents chunked and embedded per organization, user, agent or chat, and hybrid search                                  | `better-supabase/blocks/knowledge`                                                         | `knowledge`                            |
-| [Memory](https://bettersupabase.com/docs/blocks/memory): memory files, archival facts and message recall per user, agent or chat                                                        | `better-supabase/blocks/memory`                                                            | `memory`                               |
-| [Agents](https://bettersupabase.com/docs/blocks/agents): custom assistants with instructions, tools, knowledge and starters, a gallery with installs and ratings                        | `better-supabase/blocks/agents`                                                            | `agents`                               |
-| [Connectors](https://bettersupabase.com/docs/blocks/connectors): MCP servers per organization, per-user grants behind a `credential_ref`, sessions and tool fingerprints                | `better-supabase/blocks/connectors`                                                        | `connectors`                           |
-| [AI tasks](https://bettersupabase.com/docs/blocks/ai-tasks): scheduled prompts that run an agent on a cron and record each run                                                          | `better-supabase/blocks/ai-tasks`                                                          | `ai-tasks`                             |
-| [Push notifications](https://bettersupabase.com/docs/blocks/push): device tokens with RLS, Expo registration and an Expo Push API sender                                                | `better-supabase/blocks/push`                                                              | `push`                                 |
-| [AI cache](https://bettersupabase.com/docs/blocks/ai-cache): model responses cached by key with a capped TTL and a purge job                                                            | `better-supabase/blocks/ai-cache`                                                          | `ai-cache`                             |
-| [AI providers](https://bettersupabase.com/docs/blocks/ai-providers): per-tenant provider keys as credential refs, batch jobs and sandboxes with an idle stop                            | `better-supabase/blocks/ai-providers`                                                      | `ai-providers`                         |
-| [Workflows](https://bettersupabase.com/docs/blocks/workflows): a run registry for any engine, schedules, semaphores, admission control, and `useWorkflowRuns`                           | `better-supabase/blocks/workflows`, `better-supabase/blocks/workflows/react`               | `workflows`, `workflow-sdk-world`      |
-| [Workflow builder](https://bettersupabase.com/docs/blocks/workflow-builder): graph workflows members edit and publish, triggers, credentials, node run status and alerts                | `better-supabase/blocks/workflow-builder`, `better-supabase/blocks/workflow-builder/react` | `workflow-builder`                     |
-| [Entitlements](https://bettersupabase.com/docs/blocks/entitlements): Stripe entitlements per tenant, `hasEntitlement` and the members of a plan change                                  | `better-supabase/blocks/entitlements`                                                      | `entitlements`                         |
-| [Vector search](https://bettersupabase.com/docs/blocks/vector-search): `search_<table>` functions over embedding columns, called with `db.$search`                                      | SQL only                                                                                   | `vector-search`                        |
+| Block                                                                                                                                                                                                                                 | Import                                                                                                                                                                                                                                       | SQL modules                            |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
+| -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------   | ------------------------------------------------------------------------------------------                                                                                                                                                   | -------------------------------------- |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------                                               | ------------------------------------------------------------------------------------------                                                                                                                                                   | -------------------------------------- |
+| [createBlocks](https://bettersupabase.com/docs/blocks/create-blocks): builds several blocks from one set of options and wires them on the ports they provide and consume                                                              | `better-supabase/blocks`                                                                                                                                                                                                                     | none                                   |
+| [Access contract](https://bettersupabase.com/docs/blocks/access): `can()` for policies, over fixed roles, your own permission catalog or an authorization provider                                                                    | SQL only                                                                                                                                                                                                                                     | `access`, `tenant`                     |
+| [Organizations](https://bettersupabase.com/docs/blocks/organizations): members, invitations, roles and switching                                                                                                                      | `better-supabase/blocks/organizations`, `better-supabase/blocks/organizations/react`, `better-supabase/blocks/organizations/vue`, `better-supabase/blocks/organizations/svelte`, `better-supabase/blocks/organizations/solid`                | `organizations`, `invitations`         |
+| [Profiles](https://bettersupabase.com/docs/blocks/profiles): a profile row per user, synced from Auth                                                                                                                                 | `better-supabase/blocks/profiles`                                                                                                                                                                                                            | `profiles`                             |
+| [Jobs](https://bettersupabase.com/docs/blocks/jobs): Supabase Queues jobs, cron, idempotency keys and a webhook inbox                                                                                                                 | `better-supabase/blocks/jobs`                                                                                                                                                                                                                | `jobs`, `idempotency`, `webhook-inbox` |
+| [Outbox](https://bettersupabase.com/docs/blocks/outbox): transactional events with consumer cursors, relayed as CloudEvents                                                                                                           | `better-supabase/blocks/outbox`                                                                                                                                                                                                              | `outbox`                               |
+| [Notifications](https://bettersupabase.com/docs/blocks/notifications): sending, listing and delivering notifications, and `useNotifications` for a live list                                                                          | `better-supabase/blocks/notifications`, `better-supabase/blocks/notifications/react`, `better-supabase/blocks/notifications/vue`, `better-supabase/blocks/notifications/svelte`, `better-supabase/blocks/notifications/solid`                | `notifications`                        |
+| [Inbox](https://bettersupabase.com/docs/blocks/inbox): shared inboxes with conversations, assignment, notes, read receipts and channel delivery, plus `useInbox` and a chat widget                                                    | `better-supabase/blocks/inbox`, `better-supabase/blocks/inbox/react`, `better-supabase/blocks/inbox/vue`, `better-supabase/blocks/inbox/svelte`, `better-supabase/blocks/inbox/solid`                                                        | `inbox`, `chat-sdk-state`              |
+| [Webhooks](https://bettersupabase.com/docs/blocks/webhooks-out): Standard Webhooks, verifying incoming ones and delivering outgoing ones                                                                                              | `better-supabase/blocks/webhooks`                                                                                                                                                                                                            | `webhooks-out`                         |
+| [API keys](https://bettersupabase.com/docs/blocks/api-keys): hashed keys per tenant and per user, with scopes, rotation, expiry and an `apiKey` caller in every adapter                                                               | `better-supabase/blocks/api-keys`, `better-supabase/blocks/api-keys/react`, `better-supabase/blocks/api-keys/vue`, `better-supabase/blocks/api-keys/svelte`, `better-supabase/blocks/api-keys/solid`                                         | `api-keys`                             |
+| [MFA](https://bettersupabase.com/docs/auth/mfa-sso): TOTP enrolment and step-up to `aal2`, with `useMfa` and `useStepUp`                                                                                                              | `better-supabase/blocks/mfa`, `better-supabase/blocks/mfa/react`, `better-supabase/blocks/mfa/vue`, `better-supabase/blocks/mfa/svelte`, `better-supabase/blocks/mfa/solid`                                                                  | `mfa`                                  |
+| [OAuth consent](https://bettersupabase.com/docs/auth/oauth-consent): the consent page and connected agents for the Auth OAuth server, with `useOAuthConsent` and `useOAuthGrants`                                                     | `better-supabase/blocks/sessions`, `better-supabase/blocks/sessions/react`, `better-supabase/blocks/sessions/vue`, `better-supabase/blocks/sessions/svelte`, `better-supabase/blocks/sessions/solid`                                         | `sessions`                             |
+| [Audit log](https://bettersupabase.com/docs/blocks/audit): list, filter, export as NDJSON or OCSF, and purge per tenant                                                                                                               | `better-supabase/blocks/audit`, `better-supabase/blocks/audit/react`, `better-supabase/blocks/audit/vue`, `better-supabase/blocks/audit/svelte`, `better-supabase/blocks/audit/solid`                                                        | `audit`                                |
+| [Settings](https://bettersupabase.com/docs/blocks/settings): typed settings per user and per organization, validated with Standard Schema                                                                                             | `better-supabase/blocks/settings`, `better-supabase/blocks/settings/react`, `better-supabase/blocks/settings/vue`, `better-supabase/blocks/settings/svelte`, `better-supabase/blocks/settings/solid`                                         | `settings`                             |
+| [Usage](https://bettersupabase.com/docs/blocks/usage): idempotent usage counters, quotas in RLS and RPCs, and Stripe meter reporting                                                                                                  | `better-supabase/blocks/usage`, `better-supabase/blocks/usage/react`, `better-supabase/blocks/usage/vue`, `better-supabase/blocks/usage/svelte`, `better-supabase/blocks/usage/solid`                                                        | `usage`                                |
+| [Billing](https://bettersupabase.com/docs/blocks/billing): Stripe Checkout, the customer portal, seat sync and webhook handling                                                                                                       | `better-supabase/blocks/billing`, `better-supabase/blocks/billing/react`, `better-supabase/blocks/billing/vue`, `better-supabase/blocks/billing/svelte`, `better-supabase/blocks/billing/solid`                                              | `billing`                              |
+| [Feature flags](https://bettersupabase.com/docs/blocks/flags): targeting rules, overrides and rollouts, evaluated in RLS and in an OpenFeature-shaped provider                                                                        | `better-supabase/blocks/flags`                                                                                                                                                                                                               | `flags`                                |
+| [Comments](https://bettersupabase.com/docs/blocks/comments): threaded comments with mentions, and an activity feed from the outbox                                                                                                    | `better-supabase/blocks/comments`, `better-supabase/blocks/comments/react`, `better-supabase/blocks/comments/vue`, `better-supabase/blocks/comments/svelte`, `better-supabase/blocks/comments/solid`                                         | `comments`                             |
+| [Attachments](https://bettersupabase.com/docs/blocks/attachments): files linked to records, signed uploads and downloads, and a malware scan gate                                                                                     | `better-supabase/blocks/attachments`                                                                                                                                                                                                         | `attachments`                          |
+| [Data lifecycle](https://bettersupabase.com/docs/blocks/data-lifecycle): data exports and organization deletion with a grace period                                                                                                   | `better-supabase/blocks/data-lifecycle`                                                                                                                                                                                                      | `data-lifecycle`                       |
+| [SSO](https://bettersupabase.com/docs/blocks/sso): verified domains, SAML per organization, SSO enforcement and SCIM 2.0                                                                                                              | `better-supabase/blocks/sso`                                                                                                                                                                                                                 | `sso`                                  |
+| [Onboarding](https://bettersupabase.com/docs/blocks/onboarding): checklists per user or organization, and `useOnboarding`                                                                                                             | `better-supabase/blocks/onboarding`, `better-supabase/blocks/onboarding/react`, `better-supabase/blocks/onboarding/vue`, `better-supabase/blocks/onboarding/svelte`, `better-supabase/blocks/onboarding/solid`                               | `onboarding`                           |
+| [Waitlist](https://bettersupabase.com/docs/blocks/waitlist): a waitlist with approvals, hashed invite codes and an invite-only sign-up hook                                                                                           | `better-supabase/blocks/waitlist`                                                                                                                                                                                                            | `waitlist`                             |
+| [Announcements](https://bettersupabase.com/docs/blocks/announcements): in-app announcements by audience and time window, and `useAnnouncements`                                                                                       | `better-supabase/blocks/announcements`, `better-supabase/blocks/announcements/react`, `better-supabase/blocks/announcements/vue`, `better-supabase/blocks/announcements/svelte`, `better-supabase/blocks/announcements/solid`                | `announcements`                        |
+| [Number sequences](https://bettersupabase.com/docs/blocks/number-sequences): gapless numbers per period, assigned in the document's transaction                                                                                       | `better-supabase/blocks/number-sequences`                                                                                                                                                                                                    | `number-sequences`                     |
+| [Teams](https://bettersupabase.com/docs/blocks/teams): tenant teams and members, shared with the inbox                                                                                                                                | `better-supabase/blocks/teams`                                                                                                                                                                                                               | `teams`                                |
+| [Tags](https://bettersupabase.com/docs/blocks/tags): tag definitions and per-subject link tables                                                                                                                                      | `better-supabase/blocks/tags`, `better-supabase/blocks/tags/react`, `better-supabase/blocks/tags/vue`, `better-supabase/blocks/tags/svelte`, `better-supabase/blocks/tags/solid`                                                             | `tags`                                 |
+| [State machine](https://bettersupabase.com/docs/blocks/state-machine): allowed transitions, history and `status.changed`                                                                                                              | `better-supabase/blocks/state-machine`                                                                                                                                                                                                       | `state-machine`                        |
+| [Custom fields](https://bettersupabase.com/docs/blocks/custom-fields): typed values, with a permission check for sensitive fields                                                                                                     | `better-supabase/blocks/custom-fields`                                                                                                                                                                                                       | `custom-fields`                        |
+| [Share links](https://bettersupabase.com/docs/blocks/share-links): hashed links, view counts and per-user state                                                                                                                       | `better-supabase/blocks/share-links`                                                                                                                                                                                                         | `share-links`                          |
+| [Identities](https://bettersupabase.com/docs/blocks/identities): verified email and chat identities linked to users                                                                                                                   | `better-supabase/blocks/identities`                                                                                                                                                                                                          | `identities`                           |
+| [Service principals](https://bettersupabase.com/docs/blocks/service-principals): non-human members that run organization-owned workflows and webhooks                                                                                 | `better-supabase/blocks/service-principals`                                                                                                                                                                                                  | `service-principals`                   |
+| [Signing keys](https://bettersupabase.com/docs/blocks/signing-keys): Ed25519 and ES256 keys in Vault, rotation, JWKS and a JWT signer                                                                                                 | `better-supabase/blocks/signing-keys`                                                                                                                                                                                                        | `signing-keys`                         |
+| [Shared signals](https://bettersupabase.com/docs/blocks/shared-signals): an OpenID SSF transmitter and receiver with CAEP and RISC events                                                                                             | `better-supabase/blocks/shared-signals`                                                                                                                                                                                                      | `shared-signals`                       |
+| [OAuth server](https://bettersupabase.com/docs/blocks/oauth-server): client registry, PKCE authorization codes, device codes, grants and token revocation storage                                                                     | `better-supabase/blocks/oauth-server`                                                                                                                                                                                                        | `oauth-server`                         |
+| [Custom domains](https://bettersupabase.com/docs/blocks/domains): custom domains verified by DNS, platform subdomains, a primary hostname and the proxy lookup                                                                        | `better-supabase/blocks/domains`                                                                                                                                                                                                             | `domains`                              |
+| [Reminders](https://bettersupabase.com/docs/blocks/reminders): RFC 5545 recurrence, scheduled on jobs and delivered as notifications                                                                                                  | `better-supabase/blocks/reminders`                                                                                                                                                                                                           | `reminders`                            |
+| [Imports](https://bettersupabase.com/docs/blocks/imports): CSV mapping, a dry run and a jobs handler                                                                                                                                  | `better-supabase/blocks/imports`                                                                                                                                                                                                             | `imports`                              |
+| [Rank](https://bettersupabase.com/docs/blocks/rank): fractional rank keys, `move()` between neighbours and into a group, and a rebalance job                                                                                          | `better-supabase/blocks/rank`                                                                                                                                                                                                                | `rank`                                 |
+| [Saved views](https://bettersupabase.com/docs/blocks/saved-views): named list views per user, team or organization, checked against the list, and `useSavedViews` for nuqs                                                            | `better-supabase/blocks/saved-views`, `better-supabase/blocks/saved-views/react`, `better-supabase/blocks/saved-views/vue`, `better-supabase/blocks/saved-views/svelte`, `better-supabase/blocks/saved-views/solid`                          | `saved-views`                          |
+| [Relations](https://bettersupabase.com/docs/blocks/relations): typed links between subjects with cycle checks, ancestors, descendants, rollups and Gantt and tree adapters                                                            | `better-supabase/blocks/relations`                                                                                                                                                                                                           | `relations`                            |
+| [Bulk actions](https://bettersupabase.com/docs/blocks/bulk): one action over many rows with a result per row, and background runs on the jobs queue                                                                                   | `better-supabase/blocks/bulk`                                                                                                                                                                                                                | `bulk`                                 |
+| [Undo](https://bettersupabase.com/docs/blocks/undo): apply the undo tokens block methods return, and `useUndoStack` for a toast's Undo button                                                                                         | `better-supabase/blocks/undo`, `better-supabase/blocks/undo/react`, `better-supabase/blocks/undo/vue`, `better-supabase/blocks/undo/svelte`, `better-supabase/blocks/undo/solid`                                                             |                                        |
+| [Search](https://bettersupabase.com/docs/blocks/search): a search index kept by triggers, `search(q)` as the caller, recents, favorites and `useCommandSearch`                                                                        | `better-supabase/blocks/search`, `better-supabase/blocks/search/react`, `better-supabase/blocks/search/vue`, `better-supabase/blocks/search/svelte`, `better-supabase/blocks/search/solid`                                                   | `search`                               |
+| [Metrics](https://bettersupabase.com/docs/blocks/metrics): `defineMetric`, rollups, `series()` and `kpi()` with a previous-range comparison                                                                                           | `better-supabase/blocks/metrics`                                                                                                                                                                                                             | `metrics`                              |
+| [Commerce](https://bettersupabase.com/docs/concepts/commerce): money in bigint minor units, and versioned payment and tax providers with Stripe adapters                                                                              | `better-supabase/commerce`                                                                                                                                                                                                                   | none                                   |
+| [Calendar](https://bettersupabase.com/docs/blocks/calendar): calendars, recurring events with overrides, RFC 5545 import and export, an iCal feed and `useCalendar`                                                                   | `better-supabase/blocks/calendar`, `better-supabase/blocks/calendar/react`, `better-supabase/blocks/calendar/vue`, `better-supabase/blocks/calendar/svelte`, `better-supabase/blocks/calendar/solid`                                         | `calendar`                             |
+| [Bookings](https://bettersupabase.com/docs/blocks/bookings): resources, weekly hours, open slots in SQL, holds, no double bookings and public booking links                                                                           | `better-supabase/blocks/bookings`, `better-supabase/blocks/bookings/react`, `better-supabase/blocks/bookings/vue`, `better-supabase/blocks/bookings/svelte`, `better-supabase/blocks/bookings/solid`                                         | `bookings`                             |
+| [Versions](https://bettersupabase.com/docs/blocks/versions): numbered snapshots with JSON Patch diffs, restore, auto and frozen snapshots, and retention                                                                              | `better-supabase/blocks/versions`                                                                                                                                                                                                            | `versions`                             |
+| [Trash](https://bettersupabase.com/docs/blocks/trash): soft delete with children in one batch, restore with unique checks, and purge after a retention period                                                                         | `better-supabase/blocks/trash`                                                                                                                                                                                                               | `trash`                                |
+| [Reactions](https://bettersupabase.com/docs/blocks/reactions): emoji reactions on any subject, comments and inbox messages, with custom emoji and live counts                                                                         | `better-supabase/blocks/reactions`, `better-supabase/blocks/reactions/react`, `better-supabase/blocks/reactions/vue`, `better-supabase/blocks/reactions/svelte`, `better-supabase/blocks/reactions/solid`                                    | `reactions`                            |
+| [Approvals](https://bettersupabase.com/docs/blocks/approvals): approval steps per subject and action, delegation, expiry, reminders and a gated state-machine transition                                                              | `better-supabase/blocks/approvals`                                                                                                                                                                                                           | `approvals`                            |
+| [Access requests](https://bettersupabase.com/docs/blocks/access-requests): members ask for a role for a set time, approved through approvals, and the grant ends on its own                                                           | `better-supabase/blocks/access-requests`                                                                                                                                                                                                     | `access-requests`                      |
+| [Documents](https://bettersupabase.com/docs/blocks/documents): Yjs documents on any subject, with an update log, compaction and a private topic per document                                                                          | `better-supabase/blocks/documents`, `better-supabase/yjs`                                                                                                                                                                                    | `documents`                            |
+| [Catalog](https://bettersupabase.com/docs/blocks/catalog): products, options and variants, prices in bigint minor units per currency and price list, categories, collections and a public storefront                                  | `better-supabase/blocks/catalog`                                                                                                                                                                                                             | `catalog`                              |
+| [Inventory](https://bettersupabase.com/docs/blocks/inventory): stock per variant and location from an append-only movement ledger, reservations that expire, transfers between locations and purchase orders with partial receiving   | `better-supabase/blocks/inventory`                                                                                                                                                                                                           | `inventory`                            |
+| [Drive](https://bettersupabase.com/docs/blocks/drive): folders and files on attachments, with inherited grants, revisions, a bin, stars, recent items and share links                                                                 | `better-supabase/blocks/drive`                                                                                                                                                                                                               | `drive`, `drive-files`                 |
+| [Orders](https://bettersupabase.com/docs/blocks/orders): carts, a checkout that prices from the catalog, quotes tax, reserves stock and takes one payment, then fulfillments, returns, refunds and invoices                           | `better-supabase/blocks/orders`                                                                                                                                                                                                              | `orders`                               |
+| [Promotions](https://bettersupabase.com/docs/blocks/promotions): percentage, fixed and free-shipping promotions, automatic or by code, with usage limits and stacking rules, priced into orders carts                                 | `better-supabase/blocks/promotions`                                                                                                                                                                                                          | `promotions`                           |
+| [Forms](https://bettersupabase.com/docs/blocks/forms): versioned multi-step forms whose JSON Schema Postgres checks on submit, public links and `useQuestionnaire`                                                                    | `better-supabase/blocks/forms`, `better-supabase/blocks/forms/react`, `better-supabase/blocks/forms/vue`, `better-supabase/blocks/forms/svelte`, `better-supabase/blocks/forms/solid`                                                        | `forms`                                |
+| [Time tracking](https://bettersupabase.com/docs/blocks/time-tracking): timers and logged time on any record, weekly timesheets approved through approvals and `toWeeklyGrid`                                                          | `better-supabase/blocks/time-tracking`                                                                                                                                                                                                       | `time-tracking`                        |
+| [Reviews](https://bettersupabase.com/docs/blocks/reviews): ratings and reviews of products and records, verified purchases, moderation and a public aggregate                                                                         | `better-supabase/blocks/reviews`                                                                                                                                                                                                             | `reviews`                              |
+| [Leave](https://bettersupabase.com/docs/blocks/leave): leave types, requests approved through approvals and a balance ledger with accruals and carryover                                                                              | `better-supabase/blocks/leave`                                                                                                                                                                                                               | `leave`                                |
+| [Rules](https://bettersupabase.com/docs/blocks/rules): tenant rules that test a subject against a filter tree on a trigger event and name actions your app runs                                                                       | `better-supabase/blocks/rules`, `better-supabase/blocks/rules/react`, `better-supabase/blocks/rules/vue`, `better-supabase/blocks/rules/svelte`, `better-supabase/blocks/rules/solid`                                                        | `rules`                                |
+| [Templates](https://bettersupabase.com/docs/blocks/templates): versioned templates that create records, system starters and forks, merge fields, and the workflows each record starts                                                 | `better-supabase/blocks/templates`                                                                                                                                                                                                           | `templates`                            |
+| [Pipelines](https://bettersupabase.com/docs/blocks/pipelines): tenant-editable stages for any record, categories that map to open, success or failure, stage history, time in stage and board totals per currency                     | `better-supabase/blocks/pipelines`                                                                                                                                                                                                           | `pipelines`                            |
+| [Parties](https://bettersupabase.com/docs/blocks/parties): companies and people with lifecycle stages and owners, who works where with a role and a primary contact, dedupe by domain and email, merges and search                    | `better-supabase/blocks/parties`                                                                                                                                                                                                             | `parties`                              |
+| [Engagements](https://bettersupabase.com/docs/blocks/engagements): calls, emails, meetings, notes and tasks logged on one or more records, with an owner, a due time and an outcome, a record's next step and a member's open tasks   | `better-supabase/blocks/engagements`                                                                                                                                                                                                         | `engagements`                          |
+| [Deals](https://bettersupabase.com/docs/blocks/deals): deals on pipelines with amounts in minor units, a company and contacts, a team, line items, forecast calls with attainment, close-date slips, a next step and batched edits    | `better-supabase/blocks/deals`                                                                                                                                                                                                               | `deals`                                |
+| [Work items](https://bettersupabase.com/docs/blocks/work-items): issues and tasks on pipelines with identifiers, parents, several assignees, priority, dates, locking, projects, iterations and a progress tree                       | `better-supabase/blocks/work-items`                                                                                                                                                                                                          | `work-items`                           |
+| [Quotes](https://bettersupabase.com/docs/blocks/quotes): quotes with line items and totals, revisions, a public link the customer accepts, rejects or asks changes through, expiry and quotes from deals                              | `better-supabase/blocks/quotes`                                                                                                                                                                                                              | `quotes`                               |
+| [Invoices](https://bettersupabase.com/docs/blocks/invoices): invoices a tenant sends its own customers, numbered on issue, with payments, credit notes, void, write-off, aging and invoices from accepted quotes                      | `better-supabase/blocks/invoices`                                                                                                                                                                                                            | `invoices`                             |
+| [Service levels](https://bettersupabase.com/docs/blocks/sla): first response, next response and resolution clocks on any record from policies per type and priority, business hours, pauses, warnings and breaches                    | `better-supabase/blocks/sla`                                                                                                                                                                                                                 | `sla`                                  |
+| [Targets](https://bettersupabase.com/docs/blocks/targets): goals per period for a member, a team or the organization, with progress from won deals, completed work items and paid invoices                                            | `better-supabase/blocks/targets`                                                                                                                                                                                                             | `targets`                              |
+| [Hiring](https://bettersupabase.com/docs/blocks/hiring): jobs and applications on a pipeline per job, candidates from config.subjects, scorecards per stage, interviews and hire events                                               | `better-supabase/blocks/hiring`                                                                                                                                                                                                              | `hiring`                               |
+| [Employees](https://bettersupabase.com/docs/blocks/employees): employees with or without an account, managers and an org chart, offboarding, employees from hired applications, and private details and contracts behind a permission | `better-supabase/blocks/employees`                                                                                                                                                                                                           | `employees`                            |
+| [Collections](https://bettersupabase.com/docs/blocks/collections): favorites a member ranks in a sidebar, and static lists of records for a user, a team or the organization                                                          | `better-supabase/blocks/collections`                                                                                                                                                                                                         | `collections`                          |
+| [AI chat](https://bettersupabase.com/docs/blocks/ai-chat): chats with branches, shares, a model catalog, moderation and runs, in the canonical message format, and `useAiChats`                                                       | `better-supabase/blocks/ai-chat`, `better-supabase/blocks/ai-chat/react`, `better-supabase/blocks/ai-chat/vue`, `better-supabase/blocks/ai-chat/svelte`, `better-supabase/blocks/ai-chat/solid`                                              | `ai-chat`                              |
+| [AI files](https://bettersupabase.com/docs/blocks/ai-files): attachments and generated files in a private bucket, provider file references and versioned documents with suggested edits                                               | `better-supabase/blocks/ai-files`                                                                                                                                                                                                            | `ai-files`                             |
+| [Knowledge](https://bettersupabase.com/docs/blocks/knowledge): documents chunked and embedded per organization, user, agent or chat, and hybrid search                                                                                | `better-supabase/blocks/knowledge`                                                                                                                                                                                                           | `knowledge`                            |
+| [Memory](https://bettersupabase.com/docs/blocks/memory): memory files, archival facts and message recall per user, agent or chat                                                                                                      | `better-supabase/blocks/memory`                                                                                                                                                                                                              | `memory`                               |
+| [Agents](https://bettersupabase.com/docs/blocks/agents): custom assistants with instructions, tools, knowledge and starters, a gallery with installs and ratings                                                                      | `better-supabase/blocks/agents`                                                                                                                                                                                                              | `agents`                               |
+| [Connectors](https://bettersupabase.com/docs/blocks/connectors): MCP servers per organization, per-user grants behind a `credential_ref`, sessions and tool fingerprints                                                              | `better-supabase/blocks/connectors`                                                                                                                                                                                                          | `connectors`                           |
+| [AI tasks](https://bettersupabase.com/docs/blocks/ai-tasks): scheduled prompts that run an agent on a cron and record each run                                                                                                        | `better-supabase/blocks/ai-tasks`                                                                                                                                                                                                            | `ai-tasks`                             |
+| [Push notifications](https://bettersupabase.com/docs/blocks/push): device tokens with RLS, Expo registration and an Expo Push API sender                                                                                              | `better-supabase/blocks/push`                                                                                                                                                                                                                | `push`                                 |
+| [AI cache](https://bettersupabase.com/docs/blocks/ai-cache): model responses cached by key with a capped TTL and a purge job                                                                                                          | `better-supabase/blocks/ai-cache`                                                                                                                                                                                                            | `ai-cache`                             |
+| [AI providers](https://bettersupabase.com/docs/blocks/ai-providers): per-tenant provider keys as credential refs, batch jobs and sandboxes with an idle stop                                                                          | `better-supabase/blocks/ai-providers`                                                                                                                                                                                                        | `ai-providers`                         |
+| [Workflows](https://bettersupabase.com/docs/blocks/workflows): a run registry for any engine, schedules, semaphores, admission control, and `useWorkflowRuns`                                                                         | `better-supabase/blocks/workflows`, `better-supabase/blocks/workflows/react`, `better-supabase/blocks/workflows/vue`, `better-supabase/blocks/workflows/svelte`, `better-supabase/blocks/workflows/solid`                                    | `workflows`, `workflow-sdk-world`      |
+| [Workflow builder](https://bettersupabase.com/docs/blocks/workflow-builder): graph workflows members edit and publish, triggers, credentials, node run status and alerts                                                              | `better-supabase/blocks/workflow-builder`, `better-supabase/blocks/workflow-builder/react`, `better-supabase/blocks/workflow-builder/vue`, `better-supabase/blocks/workflow-builder/svelte`, `better-supabase/blocks/workflow-builder/solid` | `workflow-builder`                     |
+| [Entitlements](https://bettersupabase.com/docs/blocks/entitlements): Stripe entitlements per tenant, `hasEntitlement` and the members of a plan change                                                                                | `better-supabase/blocks/entitlements`, `better-supabase/blocks/entitlements/react`, `better-supabase/blocks/entitlements/vue`, `better-supabase/blocks/entitlements/svelte`, `better-supabase/blocks/entitlements/solid`                     | `entitlements`                         |
+| [Vector search](https://bettersupabase.com/docs/blocks/vector-search): `search_<table>` functions over embedding columns, called with `db.$search`                                                                                    | SQL only                                                                                                                                                                                                                                     | `vector-search`                        |
 
 The other SQL modules (`updated-at`, `actor`, `rate-limit`, `support-sessions` and the rest) are listed on the [SQL modules page](https://bettersupabase.com/docs/blocks/sql), and the [roadmap](https://bettersupabase.com/docs/roadmap) lists what comes next.
 
@@ -246,7 +303,7 @@ The other SQL modules (`updated-at`, `actor`, `rate-limit`, `support-sessions` a
 | Local data | PowerSync, expo-sqlite                                                                                                                                                                                               |
 | AI         | AI SDK, Chat SDK, eve, Workflow SDK, MCP                                                                                                                                                                             |
 | Validation | Zod, Valibot and any Standard Schema                                                                                                                                                                                 |
-| Standards  | OpenAPI 3.1, RFC 9457, OpenTelemetry, CloudEvents, Standard Webhooks, MCP                                                                                                                                            |
+| Standards  | OpenAPI 3.0 to 3.2, AsyncAPI 3, Arazzo 1, RFC 9457, OpenTelemetry, CloudEvents, Standard Webhooks, MCP                                                                                                               |
 | Testing    | Vitest, pgTAP, the Supabase local stack                                                                                                                                                                              |
 
 ## Good to know
@@ -262,24 +319,29 @@ The package has one entry per feature, so an app only loads what it imports. Eve
 
 ### Core
 
-| Import                                                                                                                                     | What it gives you                                                                    |
-| ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
-| `better-supabase`                                                                                                                          | `defineSupabase`, repositories, `Result`, `DbError`, `SPEC_PINS`                     |
-| `better-supabase/config`                                                                                                                   | `defineConfig` and generators for `better-supabase.config.ts`                        |
-| `better-supabase/server`                                                                                                                   | Repositories bound to the caller, admin and acting-as identities                     |
-| `better-supabase/postgres`                                                                                                                 | The same repositories over direct Postgres                                           |
-| `better-supabase/env`                                                                                                                      | Validated Supabase settings                                                          |
-| `better-supabase/list`                                                                                                                     | Search, facets, sorting and pagination from one definition                           |
-| `better-supabase/better-result`                                                                                                            | `withBetterResult`: a `db` whose methods return better-result values                 |
-| `better-supabase/storage`, `/realtime`                                                                                                     | Typed buckets (paths, versions, vector, analytics) and broadcast topics              |
-| `better-supabase/plugins/timestamps`, `/plugins/soft-delete`, `/plugins/tenant`, `/plugins/actor`, `/plugins/validation`, `/plugins/rules` | Timestamps, soft delete, tenant scoping, actor columns, validation and runtime rules |
-| `better-supabase/sql`                                                                                                                      | The SQL modules and read-set compiler behind `better-supabase sql`                   |
-| `better-supabase/lint`                                                                                                                     | Editor rules for unbounded reads and unscoped deletes                                |
-| `better-supabase/cli`                                                                                                                      | `run`, `registerCommand` and codegen for scripts that drive the CLI                  |
-| `better-supabase/testing`                                                                                                                  | `asUser`, `localAuth`, typed seeds and conformance kits                              |
-| `better-supabase/events`, `/otel`                                                                                                          | CloudEvents and OpenTelemetry                                                        |
-| `better-supabase/spec`, `/openapi`, `/asyncapi`, `/arazzo`                                                                                 | One API model rendered as OpenAPI 3.0 to 3.2, AsyncAPI 3 and Arazzo 1 documents      |
-| `better-supabase/overlay`                                                                                                                  | Apply, define and diff OpenAPI Overlay 1.0 to 1.2 documents                          |
+| Import                                                                                                                                     | What it gives you                                                                      |
+| ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
+| `better-supabase`                                                                                                                          | `defineSupabase`, repositories, `Result`, `DbError`, `SPEC_PINS`                       |
+| `better-supabase/config`                                                                                                                   | `defineConfig` and generators for `better-supabase.config.ts`                          |
+| `better-supabase/preset`                                                                                                                   | Named presets, preset codes and the resolver behind `/create`                          |
+| `better-supabase/create`                                                                                                                   | Designs, schema parsing, previews and deploy plans behind `/create`                    |
+| `better-supabase/create/lite`                                                                                                              | Validates a design in PGlite and reports what Postgres rejects                         |
+| `better-supabase/create/supabase`                                                                                                          | Supabase OAuth with PKCE, sealed sessions and the Management API client                |
+| `better-supabase/server`                                                                                                                   | Repositories bound to the caller, admin and acting-as identities                       |
+| `better-supabase/postgres`                                                                                                                 | The same repositories over direct Postgres                                             |
+| `better-supabase/env`                                                                                                                      | Validated Supabase settings                                                            |
+| `better-supabase/stripe`                                                                                                                   | `stripeFromKey`: a Stripe client for billing, usage and commerce that bundlers resolve |
+| `better-supabase/list`                                                                                                                     | Search, facets, sorting and pagination from one definition                             |
+| `better-supabase/better-result`                                                                                                            | `withBetterResult`: a `db` whose methods return better-result values                   |
+| `better-supabase/storage`, `/realtime`                                                                                                     | Typed buckets (paths, versions, vector, analytics) and broadcast topics                |
+| `better-supabase/plugins/timestamps`, `/plugins/soft-delete`, `/plugins/tenant`, `/plugins/actor`, `/plugins/validation`, `/plugins/rules` | Timestamps, soft delete, tenant scoping, actor columns, validation and runtime rules   |
+| `better-supabase/sql`                                                                                                                      | The SQL modules and read-set compiler behind `better-supabase sql`                     |
+| `better-supabase/lint`                                                                                                                     | Editor rules for unbounded reads and unscoped deletes                                  |
+| `better-supabase/cli`                                                                                                                      | `run`, `createCli` and codegen for scripts that drive the CLI                          |
+| `better-supabase/testing`                                                                                                                  | `asUser`, `localAuth`, typed seeds and conformance kits                                |
+| `better-supabase/events`, `/otel`                                                                                                          | CloudEvents and OpenTelemetry                                                          |
+| `better-supabase/spec`, `/openapi`, `/asyncapi`, `/arazzo`                                                                                 | One API model rendered as OpenAPI 3.0 to 3.2, AsyncAPI 3 and Arazzo 1 documents        |
+| `better-supabase/overlay`                                                                                                                  | Apply, define and diff OpenAPI Overlay 1.0 to 1.2 documents                            |
 
 ### Frontend and local data
 
@@ -314,17 +376,18 @@ The package has one entry per feature, so an app only loads what it imports. Eve
 
 ### AI and agents
 
-| Import                                                      | What it gives you                                                                                                 |
-| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
-| `better-supabase/ai-sdk`                                    | AI SDK message converters, gateway usage attribution and the model catalog                                        |
-| `better-supabase/ai-sdk/chat`, `/ai-sdk/react`              | `createAssistant` for a chat route and `useAssistant` on the client                                               |
-| `better-supabase/ai-sdk/files`, `/ai-sdk/cache`             | File parts from Storage and generated files, and a middleware that answers from the AI cache                      |
-| `better-supabase/ai-sdk/batches`                            | AI SDK batches per tenant, polled from a job, with results in Postgres                                            |
-| `better-supabase/ai-sdk/embeddings`, `/ai-sdk/memory`       | Embedders, reranking and a knowledge search tool; memory and recall tools and fact extraction                     |
-| `better-supabase/ai-sdk/agents`, `/ai-sdk/mcp`              | A `ToolLoopAgent` from a stored agent with moderation, and MCP connections authorized through OAuth               |
-| `better-supabase/ai-sdk/workflow`, `/ai-sdk/workflow/react` | Durable chat on the Workflow SDK with `durableChat`, `durableTurn` and `useDurableAssistant`                      |
-| `better-supabase/chat-sdk`, `/chat-sdk/react`               | Chat SDK state in Postgres, the inbox adapter and channel webhooks                                                |
-| `better-supabase/eve`                                       | eve on Supabase: route auth, connections over credential providers, memory, sessions and the inbox channel (Node) |
+| Import                                                      | What it gives you                                                                                                     |
+| ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `better-supabase/ai-sdk`                                    | AI SDK message converters, gateway usage attribution and the model catalog                                            |
+| `better-supabase/ai-sdk/chat`, `/ai-sdk/react`              | `createAssistant` for a chat route and `useAssistant` on the client                                                   |
+| `better-supabase/ai-sdk/files`, `/ai-sdk/cache`             | File parts from Storage and generated files, and a middleware that answers from the AI cache                          |
+| `better-supabase/ai-sdk/batches`                            | AI SDK batches per tenant, polled from a job, with results in Postgres                                                |
+| `better-supabase/ai-sdk/embeddings`, `/ai-sdk/memory`       | Embedders, reranking and a knowledge search tool; memory and recall tools and fact extraction                         |
+| `better-supabase/ai-sdk/agents`, `/ai-sdk/mcp`              | A `ToolLoopAgent` from a stored agent with moderation, and MCP connections authorized through OAuth                   |
+| `better-supabase/ai-sdk/workflow`, `/ai-sdk/workflow/react` | Durable chat on the Workflow SDK with `durableChat`, `durableTurn` and `useDurableAssistant`                          |
+| `better-supabase/chat-sdk`, `/chat-sdk/react`               | Chat SDK state in Postgres, the inbox adapter and channel webhooks                                                    |
+| `better-supabase/eve`                                       | eve on Supabase: route auth, connections over credential providers, memory, sessions and the inbox channel (Node)     |
+| `better-supabase/flags-sdk`                                 | A Flags SDK adapter over the flags block, an `identify` for user, tenant and custom contexts, and Flags Explorer data |
 
 ### Workflows, streams and credentials
 
@@ -334,6 +397,7 @@ The package has one entry per feature, so an app only loads what it imports. Eve
 | `better-supabase/workflow-sdk/builder`                | Compiles workflow builder graphs to Workflow SDK workflows and starts them          |
 | `better-supabase/streams`, `/streams/redis`           | Resumable output for chats, workflows and agents, in Postgres or Redis              |
 | `better-supabase/credentials`, `/vercel-connect`      | Third-party tokens behind a `credential_ref`, over Supabase Vault or Vercel Connect |
+| `better-supabase/yjs`                                 | A Yjs provider for the documents block: stored edits, a private topic, presence     |
 
 The 40 `better-supabase/blocks/*` subpaths are listed under [Blocks](#blocks).
 

package/bin/better-supabase.js

@@ -1,4 +1,16 @@
 #!/usr/bin/env node
 // Checked in so pnpm can link the bin on a fresh install, before dist/ is built.
-// oxlint-disable-next-line import/no-unassigned-import -- the CLI module runs on import.
-import "../dist/cli/bin.js";
+import { enableCompileCache } from "node:module";
+
+import manifest from "../package.json" with { type: "json" };
+
+enableCompileCache();
+
+const argv = process.argv.slice(2);
+
+if (argv.length === 1 && argv[0] === "--version") {
+  // A bare --version needs no CLI module; the CLI prints the same line.
+  process.stdout.write(`${manifest.version}\n`);
+} else {
+  await import("../dist/cli/bin.js");
+}