better-supabase 0.13.0 → 0.14.0

package/dist/vault-BQTdu4eH.d.ts

@@ -0,0 +1,62 @@
+import { T as ErrorMapper, t as AsyncResult } from "./result-C6jDfedy.js";
+import { c as SetCredentialOptions, i as CredentialRef, r as CredentialProvider } from "./provider-DmiaI1qt.js";
+import { t as BlockTransport } from "./block-transport-d53POsem.js";
+//#region src/credentials/vault.d.ts
+/** How a request the third party sends is signed with the stored secret. */
+type VaultInboundScheme = "standard-webhooks" | "hmac-sha256" | "shared-secret";
+/**
+ * A credential in Vault. `scope: 'user'` keeps one secret per user subject. The
+ * token goes out as `<header>: <scheme> <token>`, `Authorization: Bearer` by
+ * default; `scheme: null` sends it bare (`x-api-key`).
+ */
+interface VaultCredentialRef {
+  readonly provider: "vault";
+  readonly secret: string;
+  /**
+   * Stores the secret as `tenant/<tenant>/<secret>`, apart from every other
+   * tenant's.
+   */
+  readonly tenant?: string;
+  readonly scope?: "app" | "user";
+  readonly header?: string;
+  readonly scheme?: string | null;
+  readonly inbound?: VaultInboundScheme;
+  /**
+   * Defaults to `x-hub-signature-256` for `hmac-sha256`, `authorization` for
+   * `shared-secret`.
+   */
+  readonly signatureHeader?: string;
+}
+interface VaultCredentialsOptions {
+  /**
+   * `sqlTransport(postgres.asService())` or `rpcTransport` with the service
+   * role key.
+   */
+  readonly transport: BlockTransport;
+  /** The schema of the `credentials` module. Defaults to `better_supabase`. */
+  readonly schema?: string;
+  readonly mappers?: readonly ErrorMapper[];
+  /**
+   * How long a read secret stays in memory, in milliseconds. Defaults to 60000;
+   * `0` reads Vault on every call. `set` and `revoke` clear it.
+   */
+  readonly cacheMs?: number;
+}
+interface VaultCredentials extends CredentialProvider {
+  readonly name: "vault";
+  /**
+   * Stores or replaces the credential a ref names, for `subject` when the ref
+   * is per user.
+   */
+  set(ref: CredentialRef, value: string, options?: SetCredentialOptions): AsyncResult<void>;
+  verifyInbound(request: Request, ref: CredentialRef): AsyncResult<boolean>;
+}
+/**
+ * A `CredentialProvider` over the `credentials` SQL module: tokens and API keys
+ * in Supabase Vault, read through security definer functions only the service
+ * role may call. Static secrets only; OAuth connections come from a provider
+ * such as `better-supabase/vercel-connect`.
+ */
+declare function vaultCredentials(options: VaultCredentialsOptions): VaultCredentials;
+//#endregion
+export { vaultCredentials as a, VaultInboundScheme as i, VaultCredentials as n, VaultCredentialsOptions as r, VaultCredentialRef as t };

package/dist/vercel-connect/index.d.ts

@@ -1,4 +1,4 @@
-import { a as CredentialSubject, r as CredentialProvider } from "../provider-Dmsbl8ug.js";
+import { a as CredentialSubject, r as CredentialProvider } from "../provider-DmiaI1qt.js";
 //#region src/vercel-connect/vercel-connect.d.ts
 interface ConnectTokenParams {
   subject: CredentialSubject;

package/dist/vercel-connect/index.js

@@ -1,6 +1,6 @@
-import { n as dbError } from "../errors-D7u24ZJH.js";
+import { n as dbError } from "../errors-03ysrOt4.js";
 import { c as optionalTemporal } from "../temporal-DLZlWbOi.js";
-import { a as ok, r as err, t as AsyncResult } from "../result-DIT_qp4G.js";
+import { a as ok, r as err, t as AsyncResult } from "../result-B3m7xtRY.js";
 import { n as isRecord } from "../guards-6F2bCtQR.js";
 import { t as importOptionalPeer } from "../optional-peer-C1NbBRJm.js";
 //#region src/vercel-connect/vercel-connect.ts

package/dist/verify-27w0I5C9.js

@@ -0,0 +1,130 @@
+import { n as dbError } from "./errors-03ysrOt4.js";
+import { c as optionalTemporal, s as nowInstant } from "./temporal-DLZlWbOi.js";
+import { n as temporalMissing } from "./temporal-required-B8qQHYbI.js";
+import { a as ok, r as err } from "./result-B3m7xtRY.js";
+import { n as hmacHex, r as timingSafeEqual } from "./hmac-B3CTTlfv.js";
+import { a as unauthorized, n as header, r as replayed, s as verifyWebhook } from "./signatures-GUBuhLOB.js";
+import { t as toApp } from "./casing-DdFWEtqr.js";
+//#region src/blocks/webhooks/verify.ts
+/** Stripe signs with the endpoint secret's UTF-8 bytes, not its base64 decoding. */
+const stripeSignature = hmacHex;
+/** The `Stripe-Signature` header for `body`, for tests and local replays. */
+async function signStripeWebhook(secret, body, timestamp = nowInstant()) {
+	const seconds = String(Math.floor(timestamp.epochMilliseconds / 1e3));
+	return `t=${seconds},v1=${await stripeSignature(secret, `${seconds}.${body}`)}`;
+}
+/**
+* Verifies a `Stripe-Signature` header (`t=…,v1=…`) with the endpoint's
+* `whsec_…` secret and parses the event. Pass several secrets while rolling the
+* endpoint secret. Runs on WebCrypto, so it needs no `stripe` package.
+*/
+async function verifyStripeWebhook(input, secrets, options = {}) {
+	const value = header(input.headers, "stripe-signature");
+	if (!value) return err(unauthorized("WEBHOOK_MISSING_HEADERS", "Missing Stripe-Signature header"));
+	const parts = value.split(",").map((part) => {
+		const index = part.indexOf("=");
+		return [part.slice(0, index).trim(), part.slice(index + 1).trim()];
+	});
+	const timestamp = parts.find(([name]) => name === "t")?.[1] ?? "";
+	const offered = parts.filter(([name]) => name === "v1").map(([, sig]) => sig);
+	if (!/^\d+$/.test(timestamp)) return err(unauthorized("WEBHOOK_INVALID_TIMESTAMP", "Invalid webhook timestamp"));
+	const namespace = optionalTemporal();
+	if (namespace === void 0) return err(temporalMissing());
+	const seconds = Number(timestamp);
+	const now = (options.now?.() ?? namespace.Now.instant()).epochMilliseconds / 1e3;
+	if (Math.abs(now - seconds) > (options.tolerance ?? 300)) return err(unauthorized("WEBHOOK_TIMESTAMP_OUT_OF_RANGE", "Webhook timestamp is outside the tolerance"));
+	const body = input instanceof Request ? await input.text() : input.body;
+	let valid = false;
+	for (const secret of typeof secrets === "string" ? [secrets] : secrets) {
+		const expected = await stripeSignature(secret, `${timestamp}.${body}`);
+		for (const candidate of offered) if (timingSafeEqual(candidate, expected)) valid = true;
+	}
+	if (!valid) return err(unauthorized("WEBHOOK_INVALID_SIGNATURE", "Invalid webhook signature"));
+	let payload;
+	try {
+		payload = JSON.parse(body);
+	} catch {
+		return err(dbError("invalid_request", "Webhook body is not JSON"));
+	}
+	const id = typeof payload === "object" && payload !== null && "id" in payload ? String(payload.id) : "";
+	const replay = await replayed(options, id, namespace.Instant.fromEpochMilliseconds((seconds + (options.tolerance ?? 300)) * 1e3));
+	if (replay) return err(replay);
+	return ok({
+		id,
+		timestamp: namespace.Instant.fromEpochMilliseconds(seconds * 1e3),
+		payload,
+		body
+	});
+}
+/**
+* `createWebhookInbox({ source: 'stripe', verify: stripeInboxVerify(secret)
+* })`: stores Stripe events keyed by their event id.
+*/
+function stripeInboxVerify(secrets, options = {}) {
+	return async (request, body) => {
+		const verified = await verifyStripeWebhook({
+			headers: request.headers,
+			body
+		}, secrets, options);
+		return verified.ok ? ok({
+			id: verified.data.id,
+			payload: verified.data.payload
+		}) : verified;
+	};
+}
+/** Rejects a hook with a status and message Supabase Auth passes to the client. */
+function hookError(status, message) {
+	return { error: {
+		http_code: status,
+		message
+	} };
+}
+/**
+* A `(request) => Response` handler for a Supabase Auth hook: verifies the
+* Standard Webhooks signature, types the payload and serializes the answer.
+*
+* ```ts
+* export const POST = authHook(
+*   "custom_access_token",
+*   env.AUTH_HOOK_SECRET,
+*   async ({ claims, user_id }) => ({
+*     claims: { ...claims, tenant_id: await organizationFor(user_id) },
+*   }),
+* );
+* ```
+*/
+function authHook(_kind, secret, handler, options) {
+	return async (request) => {
+		const verified = await verifyWebhook(request, secret, options);
+		if (!verified.ok) return Response.json(hookError(verified.error.status, verified.error.message), { status: verified.error.status });
+		try {
+			const answer = await handler(verified.data.payload, verified.data);
+			const status = "error" in answer ? answer.error.http_code : 200;
+			return Response.json(answer, { status });
+		} catch (cause) {
+			console.error("better-supabase: auth hook failed", cause);
+			return Response.json(hookError(500, "Hook failed"), { status: 500 });
+		}
+	};
+}
+function isDatabaseWebhook(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const payload = value;
+	return (payload["type"] === "INSERT" || payload["type"] === "UPDATE" || payload["type"] === "DELETE") && typeof payload["table"] === "string" && typeof payload["schema"] === "string";
+}
+/**
+* Reads a database webhook payload for `table` as an app-cased change. Returns
+* `null` for other tables or payloads that aren't database webhooks.
+*/
+function databaseChange(betterSupabase, table, payload) {
+	const meta = betterSupabase.meta.tables[table];
+	if (!meta || !isDatabaseWebhook(payload) || payload.table !== meta.name || payload.schema !== meta.schema) return null;
+	return {
+		type: payload.type,
+		table,
+		record: payload.record ? toApp(meta, payload.record) : null,
+		oldRecord: payload.old_record ? toApp(meta, payload.old_record) : null
+	};
+}
+//#endregion
+export { signStripeWebhook as a, isDatabaseWebhook as i, databaseChange as n, stripeInboxVerify as o, hookError as r, verifyStripeWebhook as s, authHook as t };

package/dist/verify-BmuCB4PW.d.ts

@@ -0,0 +1,146 @@
+/// <reference lib="esnext.temporal" />
+import { f as Result } from "./result-C6jDfedy.js";
+import { M as AnyFunctions, N as AnyModels, mt as TableKey, st as Row } from "./executor-CPyrQdjh.js";
+import { t as BetterSupabase } from "./define-Dw7pRO4h.js";
+import { n as VerifyOptions, r as WebhookInput, t as VerifiedWebhook } from "./signatures-zbu6KTNQ.js";
+//#region src/blocks/webhooks/verify.d.ts
+/** The `Stripe-Signature` header for `body`, for tests and local replays. */
+declare function signStripeWebhook(secret: string, body: string, timestamp?: Temporal.Instant): Promise<string>;
+/**
+ * Verifies a `Stripe-Signature` header (`t=…,v1=…`) with the endpoint's
+ * `whsec_…` secret and parses the event. Pass several secrets while rolling the
+ * endpoint secret. Runs on WebCrypto, so it needs no `stripe` package.
+ */
+declare function verifyStripeWebhook<T = unknown>(input: WebhookInput, secrets: string | readonly string[], options?: VerifyOptions): Promise<Result<VerifiedWebhook<T>>>;
+/**
+ * `createWebhookInbox({ source: 'stripe', verify: stripeInboxVerify(secret)
+ * })`: stores Stripe events keyed by their event id.
+ */
+declare function stripeInboxVerify(secrets: string | readonly string[], options?: VerifyOptions): (request: Request, body: string) => Promise<Result<{
+  id: string;
+  payload: unknown;
+}>>;
+interface HookUser {
+  readonly id: string;
+  readonly email?: string;
+  readonly phone?: string;
+  readonly app_metadata?: Readonly<Record<string, unknown>>;
+  readonly user_metadata?: Readonly<Record<string, unknown>>;
+  readonly [key: string]: unknown;
+}
+interface AuthHookError {
+  readonly error: {
+    readonly http_code: number;
+    readonly message: string;
+  };
+}
+interface AuthHooks {
+  custom_access_token: {
+    input: {
+      readonly user_id: string;
+      readonly claims: Readonly<Record<string, unknown>> & {
+        readonly sub: string;
+        readonly role: string;
+      };
+      readonly authentication_method: string;
+    };
+    output: {
+      readonly claims: Readonly<Record<string, unknown>>;
+    };
+  };
+  send_email: {
+    input: {
+      readonly user: HookUser;
+      readonly email_data: {
+        readonly token: string;
+        readonly token_hash: string;
+        readonly redirect_to: string;
+        readonly email_action_type: string;
+        readonly site_url: string;
+        readonly token_new: string;
+        readonly token_hash_new: string;
+        /** Auth adds fields over time (`old_email`, `factor_type`, ...). */
+        readonly [key: string]: unknown;
+      };
+    };
+    output: Record<never, never>;
+  };
+  send_sms: {
+    input: {
+      readonly user: HookUser;
+      readonly sms: {
+        readonly otp: string;
+      };
+    };
+    output: Record<never, never>;
+  };
+  mfa_verification_attempt: {
+    input: {
+      readonly factor_id: string;
+      readonly factor_type: string;
+      readonly user_id: string;
+      readonly valid: boolean;
+    };
+    output: {
+      readonly decision: "continue" | "reject";
+      readonly message?: string;
+    };
+  };
+  password_verification_attempt: {
+    input: {
+      readonly user_id: string;
+      readonly valid: boolean;
+    };
+    output: {
+      readonly decision: "continue" | "reject";
+      readonly message?: string;
+      readonly should_logout_user?: boolean;
+    };
+  };
+  before_user_created: {
+    input: {
+      readonly metadata: Readonly<Record<string, unknown>>;
+      readonly user: HookUser;
+    };
+    output: Record<never, never>;
+  };
+}
+type AuthHookKind = keyof AuthHooks;
+/** Rejects a hook with a status and message Supabase Auth passes to the client. */
+declare function hookError(status: number, message: string): AuthHookError;
+/**
+ * A `(request) => Response` handler for a Supabase Auth hook: verifies the
+ * Standard Webhooks signature, types the payload and serializes the answer.
+ *
+ * ```ts
+ * export const POST = authHook(
+ *   "custom_access_token",
+ *   env.AUTH_HOOK_SECRET,
+ *   async ({ claims, user_id }) => ({
+ *     claims: { ...claims, tenant_id: await organizationFor(user_id) },
+ *   }),
+ * );
+ * ```
+ */
+declare function authHook<K extends AuthHookKind>(_kind: K, secret: string | readonly string[], handler: (payload: AuthHooks[K]["input"], webhook: VerifiedWebhook<AuthHooks[K]["input"]>) => AuthHooks[K]["output"] | AuthHookError | Promise<AuthHooks[K]["output"] | AuthHookError>, options?: VerifyOptions): (request: Request) => Promise<Response>;
+interface DatabaseWebhookPayload {
+  readonly type: "INSERT" | "UPDATE" | "DELETE";
+  readonly table: string;
+  readonly schema: string;
+  readonly record: Readonly<Record<string, unknown>> | null;
+  readonly old_record: Readonly<Record<string, unknown>> | null;
+}
+interface DatabaseChange<R> {
+  readonly type: "INSERT" | "UPDATE" | "DELETE";
+  readonly table: string;
+  readonly record: R | null;
+  readonly oldRecord: Partial<R> | null;
+}
+declare function isDatabaseWebhook(value: unknown): value is DatabaseWebhookPayload;
+/**
+ * Reads a database webhook payload for `table` as an app-cased change. Returns
+ * `null` for other tables or payloads that aren't database webhooks.
+ */
+declare function databaseChange<M extends AnyModels, D, F extends AnyFunctions, E, T extends TableKey<M>>(betterSupabase: BetterSupabase<M, D, F, E>, table: T, payload: unknown): DatabaseChange<Row<M, T>> | null;
+//#endregion
+export { DatabaseWebhookPayload as a, hookError as c, stripeInboxVerify as d, verifyStripeWebhook as f, DatabaseChange as i, isDatabaseWebhook as l, AuthHookKind as n, authHook as o, AuthHooks as r, databaseChange as s, AuthHookError as t, signStripeWebhook as u };

package/dist/view-2_I-2ukO.d.ts

@@ -0,0 +1,90 @@
+import { b as DbError } from "./result-C6jDfedy.js";
+import { i as InvalidReason, r as AuthState } from "./resolve-CzUKTIMq.js";
+import { a as SessionActor, o as SessionDelegation } from "./actor-CoveJgya.js";
+import { n as Impersonator } from "./impersonation-YTa9dZUv.js";
+import { n as AmrEntry, t as Aal } from "./mfa-wrx1rqJT.js";
+import { JWTClaims, UserClaims } from "@supabase/server";
+//#region src/auth/view.d.ts
+/**
+ * The verified caller as plain data: no token, no clients. Safe to return from
+ * a `'use cache: private'` function and to pass to Client Components.
+ */
+type AuthSession<C = unknown, P = unknown> = {
+  readonly kind: "user";
+  /**
+   * Read from the verified claims (`sub`, `email`, `role`, `app_metadata`,
+   * `user_metadata`), never from the user object in the cookie, so it is
+   * the same with `tokens-only` cookies. Call `auth.getUser()` when a flow
+   * must see a revoked or changed user.
+   */
+  readonly user: UserClaims;
+  /**
+   * The verified JWT payload, including custom access token hook claims,
+   * typed and validated by `betterSupabase.claims(schema)`.
+   */
+  readonly claims: JWTClaims & C;
+  /** Seconds since epoch, from the token's `exp`. */
+  readonly expiresAt: number | null;
+  /**
+   * `user_metadata` parsed by `betterSupabase.userMetadata(schema)`, for
+   * display. Absent without a schema or when the metadata fails it. Users
+   * write this data with `auth.updateUser()`: never base access on it.
+   */
+  readonly profile?: P;
+  /** `aal2` once the user verified a second factor in this session. */
+  readonly aal: Aal;
+  /**
+   * Signed in with `signInAnonymously()` (the `is_anonymous` claim). Guards
+   * refuse these users unless `allow` lists `'anonymous'`; `'anon'` means
+   * no session and never admits them.
+   */
+  readonly anonymous: boolean;
+  /** How the user signed in (`password`, `totp`, `sso/saml`, ...). */
+  readonly amr: readonly AmrEntry[];
+  /**
+   * Set when an admin acts as this user in a support session or an
+   * impersonated session (`act.kind`), for a banner. Matches `actor`.
+   */
+  readonly impersonator?: Impersonator;
+  /**
+   * Who acts for the user: an OAuth client or agent (`client_id`, or an
+   * `act` chain without `kind`), a support session or an impersonated
+   * session, read from the `act` and `client_id` claims.
+   */
+  readonly actor?: SessionActor;
+  /**
+   * The scopes the user granted an `oauth-client` actor (or an `agent` on a
+   * token with a `scope`), without the OpenID identity scopes in
+   * `IDENTITY_SCOPES`, plus its `act` chain. Never set for a support or
+   * impersonated session.
+   */
+  readonly delegation?: SessionDelegation;
+} | {
+  readonly kind: "service";
+  readonly keyName: string;
+} | {
+  readonly kind: "apiKey";
+  readonly keyId: string;
+  readonly name: string;
+  readonly organizationId?: string;
+  readonly userId?: string;
+  readonly scopes: readonly string[];
+  /** Seconds since epoch, when the key was created. */
+  readonly createdAt?: number;
+  /** The user who created the key. */
+  readonly createdBy?: string;
+} | {
+  readonly kind: "anon";
+  readonly reason: AnonReason;
+} | {
+  readonly kind: "invalid";
+  readonly reason: InvalidReason;
+  readonly error: DbError;
+};
+type AnonReason = Extract<AuthState, {
+  kind: "anon";
+}>["reason"];
+/** Drops the token from an `AuthState`, leaving only serializable fields. */
+declare function toSession<C, P>(auth: AuthState<C, P>): AuthSession<C, P>;
+//#endregion
+export { toSession as n, AuthSession as t };

package/dist/view-BtgqxQLM.js

@@ -0,0 +1,108 @@
+import { n as dbError } from "./errors-03ysrOt4.js";
+import { a as invalidActorError, i as delegationOf, n as actorOf } from "./actor-hNajGNEK.js";
+import { r as impersonatorOf } from "./impersonation-CZD9AOAk.js";
+//#region src/auth/mfa.ts
+/**
+* The session's assurance level from its claims; anything but `aal2` reads as
+* `aal1`.
+*/
+function aalOf(claims) {
+	return claims["aal"] === "aal2" ? "aal2" : "aal1";
+}
+/** The `amr` claim as typed entries, skipping malformed ones. */
+function amrOf(claims) {
+	const amr = claims["amr"];
+	if (!Array.isArray(amr)) return [];
+	return amr.flatMap((entry) => {
+		if (typeof entry !== "object" || entry === null) return [];
+		const { method, timestamp, provider } = entry;
+		if (typeof method !== "string" || typeof timestamp !== "number") return [];
+		return [typeof provider === "string" ? {
+			method,
+			timestamp,
+			provider
+		} : {
+			method,
+			timestamp
+		}];
+	});
+}
+/**
+* `undefined` when a user session meets `required`; otherwise a `forbidden`
+* error with `required` and code `INSUFFICIENT_AAL`, for the client to start an
+* MFA challenge. Non-user sessions pass: `allow` decides about them.
+*/
+function checkAal(auth, required) {
+	if (required === "aal1" || auth.kind !== "user" || !("claims" in auth)) return;
+	if (aalOf(auth.claims) === "aal2") return;
+	return dbError("forbidden", "Verify a second factor to continue", {
+		code: "INSUFFICIENT_AAL",
+		required
+	});
+}
+//#endregion
+//#region src/auth/view.ts
+/** Whether the token belongs to an anonymous user (`signInAnonymously()`). */
+function isAnonymousUser(claims) {
+	return "is_anonymous" in claims && claims.is_anonymous === true;
+}
+/** Drops the token from an `AuthState`, leaving only serializable fields. */
+function toSession(auth) {
+	switch (auth.kind) {
+		case "user": {
+			const outcome = actorOf(auth.claims);
+			if (!outcome.ok) return {
+				kind: "invalid",
+				reason: "actor",
+				error: invalidActorError()
+			};
+			const impersonator = impersonatorOf(auth.claims);
+			const actor = outcome.actor;
+			const client = actor?.kind === "oauth-client" || actor?.kind === "agent" && delegationOf(auth.claims) !== void 0 ? actor : void 0;
+			const scopes = client ? delegationOf(auth.claims)?.scopes : void 0;
+			const delegation = client && (scopes || client.chain) ? {
+				scopes: scopes ?? [],
+				...client.chain ? { chain: client.chain } : {}
+			} : void 0;
+			return {
+				kind: "user",
+				user: auth.user,
+				claims: auth.claims,
+				expiresAt: auth.expiresAt,
+				...auth.profile === void 0 ? {} : { profile: auth.profile },
+				aal: aalOf(auth.claims),
+				anonymous: isAnonymousUser(auth.claims),
+				amr: amrOf(auth.claims),
+				...impersonator ? { impersonator } : {},
+				...actor ? { actor } : {},
+				...delegation ? { delegation } : {}
+			};
+		}
+		case "service": return {
+			kind: "service",
+			keyName: auth.keyName
+		};
+		case "apiKey": return {
+			kind: "apiKey",
+			keyId: auth.keyId,
+			name: auth.name,
+			...auth.organizationId ? { organizationId: auth.organizationId } : {},
+			...auth.userId ? { userId: auth.userId } : {},
+			scopes: auth.scopes,
+			...auth.createdAt ? { createdAt: Math.floor(auth.createdAt.epochMilliseconds / 1e3) } : {},
+			...auth.createdBy ? { createdBy: auth.createdBy } : {}
+		};
+		case "anon": return {
+			kind: "anon",
+			reason: auth.reason
+		};
+		case "invalid": return {
+			kind: "invalid",
+			reason: auth.reason,
+			error: auth.error
+		};
+		default: return auth;
+	}
+}
+//#endregion
+export { checkAal as a, amrOf as i, toSession as n, aalOf as r, isAnonymousUser as t };

package/dist/vue/index.d.ts

@@ -1,14 +1,32 @@
-import { b as DbError } from "../result-mijqfoJN.js";
-import { J as QuerySpec } from "../define-D0LSXmUP.js";
-import { $ as TemplateValues } from "../bucket-DBay-ICp.js";
-import { g as TopicHandlers, m as Topic, p as SubscriptionStatus, r as PresenceMember, t as EventSchemas } from "../topic-CZvLXFND.js";
-import { t as AuthSnapshot } from "../bind-DcXLU1ul.js";
-import { t as AuthSession } from "../view-CKzCp8FW.js";
-import { a as BroadcastOptions, c as LiveCountHookOptions, d as PresenceHookOptions, f as PresenceTopic, i as ActionState, l as LiveCountSource, m as UseActionOptions, n as ActionInputOf, o as ClaimsOf, p as ProfileOf, r as ActionResultOf, s as ClientLike, t as fieldErrorsOf, u as LiveQueryHookOptions } from "../field-errors-CKEqR38q.js";
-import { t as SupportView } from "../support-view-BOJJSZKv.js";
+import { b as DbError } from "../result-C6jDfedy.js";
+import { Ct as Events, D as BlockEventPattern, T as BlockEvent, bt as EventMap, k as BlockEventsMatching } from "../events-DbLjvxDX.js";
+import { J as QuerySpec } from "../define-Dw7pRO4h.js";
+import { $ as TemplateValues } from "../bucket-TkB7_xv8.js";
+import { g as TopicHandlers, m as Topic, p as SubscriptionStatus, r as PresenceMember, t as EventSchemas } from "../topic-D9j8G2dw.js";
+import { t as AuthSnapshot } from "../bind-Dz8y3T5T.js";
+import { t as AuthSession } from "../view-2_I-2ukO.js";
+import { _ as LiveQueryHookOptions, a as BlockQueryActions, b as ProfileOf, c as BlockRefetchOn, d as ActionState, f as BroadcastOptions, g as LiveCountSource, h as LiveCountHookOptions, i as BlockMutationState, l as ActionInputOf, m as ClientLike, n as BlockEventSource, o as BlockQueryOptions, p as ClaimsOf, r as BlockMutationActions, s as BlockQueryState, t as fieldErrorsOf, u as ActionResultOf, v as PresenceHookOptions, x as UseActionOptions, y as PresenceTopic } from "../field-errors-vshYTVKr.js";
+import { t as VueController } from "../vue-bind-TPkbLl4z.js";
+import { i as BlockMethodName, n as BlockDataOf, t as BlockArgsOf } from "../block-method-hsPAGFi5.js";
+import { t as SupportView } from "../support-view-vwJbRMpV.js";
 import { SupabaseClient } from "@supabase/supabase-js";
 import { App, ComputedRef, MaybeRefOrGetter, Ref } from "vue";
 import { QueryClient } from "@tanstack/query-core";
+//#region src/vue/block-hooks.d.ts
+/**
+ * Calls a read method of any block client (`blocks.tasks.list`, renamed or not)
+ * from mount. `refetchOn` calls it again on block events.
+ */
+export declare function useBlockQuery<C extends object, const K extends BlockMethodName<C>>(client: C, method: K, args: BlockArgsOf<C, K>, options?: BlockQueryOptions): VueController<BlockQueryState<BlockDataOf<C, K>>, BlockQueryActions>;
+/** Calls a write method of any block client and tracks its state. */
+export declare function useBlockMutation<C extends object, const K extends BlockMethodName<C>>(client: C, method: K): VueController<BlockMutationState<BlockDataOf<C, K>>, BlockMutationActions<BlockArgsOf<C, K>, BlockDataOf<C, K>>>;
+/**
+ * Calls `handler` for each block event matching `pattern` (`"task.*"`), typed
+ * by `events` (`blockEvents` from `blocks.generated.ts`), from mount until the
+ * component goes away. `source` is the client's `betterSupabase`.
+ */
+export declare function useBlockEvent<M extends EventMap, const P extends BlockEventPattern<M>>(source: BlockEventSource, events: Events<M>, pattern: P, handler: (event: BlockEvent<M, BlockEventsMatching<M, P>>) => void): void;
+//#endregion
 //#region src/vue/index.d.ts
 export interface BetterSupabaseVueOptions {
   /** Better-supabase queries are reset when the user signs out or changes. */
@@ -153,4 +171,4 @@ export interface ActionHandle<I, T> extends ActionState<I, T> {
  */
 export declare function useAction<I, T>(action: (input: I) => Promise<ActionResultOf<T>>, options?: UseActionOptions<ActionInputOf<I>, T>): ActionHandle<ActionInputOf<I>, T>;
 //#endregion
-export { type ActionInputOf, type ActionResultOf, type ActionState, type AuthSession, type AuthSnapshot, type BroadcastOptions, type ClaimsOf, type ClientLike, type LiveCountHookOptions, type LiveCountSource, type LiveQueryHookOptions, type PresenceHookOptions, type PresenceTopic, type ProfileOf, type SupportView, type UseActionOptions, fieldErrorsOf };
+export { type ActionInputOf, type ActionResultOf, type ActionState, type AuthSession, type AuthSnapshot, type BlockEventSource, type BlockMutationActions, type BlockMutationState, type BlockQueryActions, type BlockQueryOptions, type BlockQueryState, type BlockRefetchOn, type BroadcastOptions, type ClaimsOf, type ClientLike, type LiveCountHookOptions, type LiveCountSource, type LiveQueryHookOptions, type PresenceHookOptions, type PresenceTopic, type ProfileOf, type SupportView, type UseActionOptions, fieldErrorsOf };

package/dist/vue/index.js

@@ -1,9 +1,34 @@
 import { t as clearOnUserChange } from "../user-change-CSR_prhd.js";
-import { a as createActionRunner, c as liveKey, d as shownCount, f as startBroadcast, i as countSource, l as notJoined, m as startLiveQuery, n as assertInvalidateClient, o as joinPresence, p as startLiveCount, r as callerOf, s as keyed, t as NO_COUNT, u as plainCaller } from "../client-YASsOslj.js";
+import { a as createActionRunner, c as liveKey, d as shownCount, f as startBroadcast, i as countSource, l as notJoined, m as startLiveQuery, n as assertInvalidateClient, o as joinPresence, p as startLiveCount, r as callerOf, s as keyed, t as NO_COUNT, u as plainCaller } from "../client-C_0XZieg.js";
 import { t as supportOf } from "../support-view-g4YLBeqX.js";
-import { t as fieldErrorsOf } from "../field-errors-DZVRWRkf.js";
-import { n as onClient, r as useContext, t as CLIENT } from "../context-CCz6ZgyI.js";
+import { a as fieldErrorsOf, i as listenToBlockEvents, n as createBlockMutation, r as createBlockQuery } from "../block-controller-DTGuBemi.js";
+import { i as useContext, n as CLIENT, r as onClient, t as bindVueController } from "../vue-bind-CFxon-Vs.js";
 import { computed, getCurrentScope, inject, onScopeDispose, provide, readonly, shallowRef, toValue, watch } from "vue";
+//#region src/vue/block-hooks.ts
+/**
+* Calls a read method of any block client (`blocks.tasks.list`, renamed or not)
+* from mount. `refetchOn` calls it again on block events.
+*/
+function useBlockQuery(client, method, args, options = {}) {
+	return bindVueController(createBlockQuery(client, method, args, options));
+}
+/** Calls a write method of any block client and tracks its state. */
+function useBlockMutation(client, method) {
+	return bindVueController(createBlockMutation(client, method));
+}
+/**
+* Calls `handler` for each block event matching `pattern` (`"task.*"`), typed
+* by `events` (`blockEvents` from `blocks.generated.ts`), from mount until the
+* component goes away. `source` is the client's `betterSupabase`.
+*/
+function useBlockEvent(source, events, pattern, handler) {
+	let stop;
+	onClient(() => {
+		stop = listenToBlockEvents(source, events, pattern, () => handler);
+	});
+	if (getCurrentScope()) onScopeDispose(() => stop?.());
+}
+//#endregion
 //#region src/vue/index.ts
 const SESSION = Symbol("better-supabase-session");
 /**
@@ -367,4 +392,4 @@ function useAction(action, options = {}) {
 	};
 }
 //#endregion
-export { betterSupabase, createBindings, fieldErrorsOf, provideSession, useAction, useAuth, useBroadcast, useLiveCount, useLiveQuery, usePresence, useSession, useSupabase, useSupportSession };
+export { betterSupabase, createBindings, fieldErrorsOf, provideSession, useAction, useAuth, useBlockEvent, useBlockMutation, useBlockQuery, useBroadcast, useLiveCount, useLiveQuery, usePresence, useSession, useSupabase, useSupportSession };