better-supabase 0.15.0 → 0.16.0

package/dist/hono/index.js

@@ -1,9 +1,9 @@
 import { r as dbErrorOf } from "../errors-BVFgt8BZ.js";
 import { o as problemResponse } from "../problem-Bf0cJ7tk.js";
-import { a as unexpectedResponse, c as extendServer, n as flushEvents, s as createServer } from "../adapter-B0b6MXYS.js";
+import { a as unexpectedResponse, c as extendServer, n as flushEvents, s as createServer } from "../adapter-Dyks1lX1.js";
 import { l as snapshotOf, n as toSession } from "../view-C8Ve14ja.js";
 import { a as respond, t as defaultExpose } from "../respond-C3CcOZlA.js";
-import { t as withBetterSupabase } from "../composite-BARuBEDE.js";
+import { t as withBetterSupabase } from "../composite-B3TIjId4.js";
 import { i as defineAction, t as defineResource } from "../resource-DV2GC2dB.js";
 import { i as requireCaller } from "../kit-5l-o8RxL.js";
 import { t as matchResource } from "../resources-C02l_YBJ.js";

package/dist/{index-C-qpk8EQ.d.ts → index-CENWq3zb.d.ts}

@@ -1,4 +1,4 @@
-import { $r as PresetCatalog, Nn as PresetSpec, Un as PresetName, _t as presetConfig, ar as AppColumnConfig, mr as AppTableConfig, ni as PresetGlueItem, si as Preset, sr as AppColumnType, xt as ResolvedPreset, yr as AppTablesConfig } from "./context-CEuTKrkz.js";
+import { Pn as PresetSpec, St as ResolvedPreset, Wn as PresetName, br as AppTablesConfig, ci as Preset, cr as AppColumnType, ei as PresetCatalog, hr as AppTableConfig, or as AppColumnConfig, ri as PresetGlueItem, vt as presetConfig } from "./context-8kb8m5uO.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/preset/catalog.generated.d.ts
 declare const PRESET_CATALOG: PresetCatalog;

package/dist/{index-Do2ChN_y.d.ts → index-CQhPHHDF.d.ts}

@@ -1,5 +1,5 @@
 import { b as DbError, f as Result, t as AsyncResult } from "./result-DZeA5KS6.js";
-import { X as StoragePath, a as BucketConnectOptions, g as StorageAdminClient, i as BucketConfig, j as StorageClient, n as Bucket, r as BucketClient, s as BucketPolicy, x as TransformOptions } from "./bucket-CiNi8sIw.js";
+import { C as TransformOptions, N as StorageClient, Q as StoragePath, a as BucketConnectOptions, i as BucketConfig, n as Bucket, r as BucketClient, s as BucketPolicy, v as StorageAdminClient } from "./bucket-vc-QRrva.js";
 import { SupabaseClient } from "@supabase/supabase-js";
 //#region src/storage/errors.d.ts
 /** Maps a Storage error (`StorageApiError`, fetch failures) to a `DbError`. */
@@ -284,4 +284,22 @@ interface VectorBucket<Id extends string, I extends Readonly<Record<string, Vect
  */
 declare function defineVectorBucket<const Id extends string, const I extends Readonly<Record<string, VectorIndexConfig>>>(config: VectorBucketConfig<Id, I>): VectorBucket<Id, I>;
 //#endregion
-export { StoredRef as A, AnyBucket as C, Buckets as D, BucketWithId as E, storageImageUrl as F, fromStorageError as I, StorageImageOptions as M, StorageImageSize as N, ConnectedRef as O, storageImageSrcSet as P, organizationLogoBucket as S, BucketMap as T, IMAGE_TYPES as _, VectorHit as a, OrganizationLogoBucketOptions as b, VectorMetadata as c, defineVectorBucket as d, AnalyticsBucket as f, AvatarBucketOptions as g, defineAnalyticsBucket as h, VectorDistance as i, defineBuckets as j, ResolvedRef as k, VectorQueryOptions as l, AnalyticsCatalog as m, VectorBucketClient as n, VectorIndexClient as o, AnalyticsBucketClient as p, VectorBucketConfig as r, VectorIndexConfig as s, VectorBucket as t, VectorRecord as u, ImageBucketOptions as v, BucketIdOf as w, avatarBucket as x, ImageVariant as y };
+//#region src/storage/resumable.d.ts
+interface ResumableEndpointOptions {
+  /**
+   * On a hosted project, send the upload to the direct Storage host
+   * (`<project-ref>.storage.supabase.co`), which Supabase recommends for large
+   * files. Defaults to true; other hosts, such as a local stack or a custom
+   * domain, are kept.
+   */
+  readonly direct?: boolean;
+}
+/**
+ * The TUS endpoint for a signed resumable upload,
+ * `<storage>/upload/resumable/sign`. `url` is the project URL (`SUPABASE_URL`),
+ * the Storage URL (`.../storage/v1`) or a signed upload URL from
+ * `createSignedUploadUrl`.
+ */
+declare function resumableEndpoint(url: string, options?: ResumableEndpointOptions): string;
+//#endregion
+export { ConnectedRef as A, avatarBucket as C, BucketMap as D, BucketIdOf as E, StorageImageSize as F, storageImageSrcSet as I, storageImageUrl as L, StoredRef as M, defineBuckets as N, BucketWithId as O, StorageImageOptions as P, fromStorageError as R, OrganizationLogoBucketOptions as S, AnyBucket as T, defineAnalyticsBucket as _, VectorBucketConfig as a, ImageBucketOptions as b, VectorIndexClient as c, VectorQueryOptions as d, VectorRecord as f, AnalyticsCatalog as g, AnalyticsBucketClient as h, VectorBucketClient as i, ResolvedRef as j, Buckets as k, VectorIndexConfig as l, AnalyticsBucket as m, resumableEndpoint as n, VectorDistance as o, defineVectorBucket as p, VectorBucket as r, VectorHit as s, ResumableEndpointOptions as t, VectorMetadata as u, AvatarBucketOptions as v, organizationLogoBucket as w, ImageVariant as x, IMAGE_TYPES as y };

package/dist/{index-B938YqY-.d.ts → index-CTu-3fJB.d.ts}

@@ -1,9 +1,57 @@
 import { b as DbError, f as Result } from "./result-DZeA5KS6.js";
 import { $ as RecordRef, ot as SchemaMeta } from "./types-DFdg_4yN.js";
-import { pt as QuerySpec } from "./define-DFBnQyYg.js";
+import { pt as QuerySpec } from "./define-C5AcEkEJ.js";
 import { t as DataChanges } from "./data-engine-BWoz9lED.js";
-import { c as RealtimeClient, m as Topic, p as SubscriptionStatus } from "./topic-CJrQZQaa.js";
+import { c as RealtimeClient, m as Topic, p as SubscriptionStatus } from "./topic-CZXHhZye.js";
+import { n as TopicPort } from "./watch-topic-BAxoPKZx.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
+//#region src/realtime/relay.d.ts
+/** The `EventSource` the relay client reads with; the browser's fits. */
+interface RelayEventSource {
+  readonly readyState: number;
+  addEventListener(type: string, listener: (event: {
+    readonly data?: unknown;
+  }) => void): void;
+  close(): void;
+}
+type RelayEventSourceConstructor = new (url: string, init?: {
+  withCredentials?: boolean;
+}) => RelayEventSource;
+interface RelayClientOptions {
+  /** Defaults to the global `EventSource`. */
+  readonly EventSource?: RelayEventSourceConstructor;
+  /** `fetch` for broadcasts; defaults to the global one. */
+  readonly fetch?: typeof fetch;
+  /**
+   * Milliseconds to wait for the first join before reporting `TIMED_OUT`.
+   * Defaults to 15000.
+   */
+  readonly timeoutMs?: number;
+  /** The longest wait between reconnects after the relay refused. Defaults to 30000. */
+  readonly maxBackoffMs?: number;
+}
+/**
+ * A Realtime client that joins topics through `realtimeRelay` on the server
+ * instead of a browser connection with the user's token: for support sessions
+ * ("view as user") and apps that keep sessions in httpOnly cookies. It has the
+ * `RealtimeClient` surface, so `defineTopic(...).subscribe`, `send`,
+ * `liveQuery`, `watchTopic` and the React hooks take it unchanged. Each topic
+ * is one server-sent event stream that reconnects on its own and reports a
+ * rejoin after a gap, so live queries refetch. Presence states arrive, but
+ * `track` answers `error`: presence is not relayed upstream.
+ *
+ * ```ts
+ * const realtime = relayRealtimeClient("/api/realtime");
+ * using sub = notifications.subscribe(realtime, { userId }, handlers);
+ * ```
+ */
+declare function relayRealtimeClient(url: string, options?: RelayClientOptions): RealtimeClient;
+/**
+ * The block controllers' realtime port over `realtimeRelay`:
+ * `topicPort(relayRealtimeClient(url, options))`.
+ */
+declare function relayTopicPort(url: string, options?: RelayClientOptions): TopicPort;
+//#endregion
 //#region src/realtime/subject-presence.d.ts
 /** The presence topic template; the subjects module's policies authorize it. */
 declare const SUBJECT_PRESENCE_TEMPLATE = "presence:{subjectType}:{subjectId}";
@@ -185,4 +233,4 @@ interface RealtimeChangesOptions {
  */
 declare function realtimeChanges(betterSupabase: LiveSource, client: RealtimeClient, options?: RealtimeChangesOptions): DataChanges;
 //#endregion
-export { subjectPresenceValues as _, LiveSource as a, liveCount as c, realtimeChanges as d, SUBJECT_PRESENCE_TEMPLATE as f, subjectPresenceTopic as g, subjectPresence as h, LiveQueryOptions as i, liveQuery as l, SubjectPresenceValues as m, LiveCountOptions as n, LiveSubscription as o, SubjectPresenceTopic as p, LiveCountSeed as r, RealtimeChangesOptions as s, CountRunner as t, liveTopic as u };
+export { relayTopicPort as S, subjectPresenceValues as _, LiveSource as a, RelayEventSourceConstructor as b, liveCount as c, realtimeChanges as d, SUBJECT_PRESENCE_TEMPLATE as f, subjectPresenceTopic as g, subjectPresence as h, LiveQueryOptions as i, liveQuery as l, SubjectPresenceValues as m, LiveCountOptions as n, LiveSubscription as o, SubjectPresenceTopic as p, LiveCountSeed as r, RealtimeChangesOptions as s, CountRunner as t, liveTopic as u, RelayClientOptions as v, relayRealtimeClient as x, RelayEventSource as y };

package/dist/{index-CguFm716.d.ts → index-Cc4mIQS8.d.ts}

@@ -1,7 +1,7 @@
 import { E as AccessPolicySql } from "./types-DFdg_4yN.js";
 import { p as AnyBlocksConfig, t as AuthorizationFunctions } from "./authorization-HZdJCaVm.js";
-import { tt as ReadSet } from "./define-DFBnQyYg.js";
-import { Ar as CatalogPolicy, T as TableGrant, Zt as ResolvedConfig, _ as BlockSqlDeprecation, b as BlockSqlLayout, c as BlockSqlIdType, g as BlockSqlAccessProvider, h as BlockSql, mr as AppTableConfig, o as BlockSqlContractFunction, v as BlockSqlEntitlementsProvider, y as BlockSqlFile } from "./context-CEuTKrkz.js";
+import { tt as ReadSet } from "./define-C5AcEkEJ.js";
+import { E as TableGrant, Qt as ResolvedConfig, _ as BlockSqlDeprecation, b as BlockSqlLayout, c as BlockSqlIdType, g as BlockSqlAccessProvider, h as BlockSql, hr as AppTableConfig, jr as CatalogPolicy, o as BlockSqlContractFunction, v as BlockSqlEntitlementsProvider, y as BlockSqlFile } from "./context-8kb8m5uO.js";
 import { t as SubjectConfig } from "./subjects-DvmQeF_F.js";
 //#region src/sql/render.d.ts
 /** A module's SQL for `layout`, without header; `undefined` in custom mode. */
@@ -249,7 +249,7 @@ interface AdoptedTable {
  * `ownTables` lists it or `blocks.<name>.on` names it, with the columns their
  * SQL names: mapped to `null` and unused optional columns are left out.
  */
-declare function adoptedTables(modules: AnyBlocksConfig, ownTables?: Readonly<Record<string, string>>): readonly AdoptedTable[];
+declare function adoptedTables(modules: AnyBlocksConfig, ownTables?: Readonly<Record<string, string>>, views?: Pick<BlockSqlLayout, "ownViews" | "ownColumns">): readonly AdoptedTable[];
 /**
  * The columns the modules write on the app's other tables (`appSubjectTables`,
  * such as a tag link table) that those tables lack, and the enum columns they
@@ -259,6 +259,19 @@ declare function adoptedTables(modules: AnyBlocksConfig, ownTables?: Readonly<Re
 declare function adoptedColumnProblems(modules: AnyBlocksConfig, files: readonly {
   readonly text: string;
 }[], schemas: readonly string[], ownTables?: Readonly<Record<string, string>>): readonly string[];
+/** A block table mapped to a view of the app's. */
+interface AdoptedView {
+  readonly module: string;
+  readonly logical: string;
+  /** `schema.view`. */
+  readonly view: string;
+  /** Whether Postgres writes through the view to its table. */
+  readonly updatable: boolean;
+  /** Whether the block's TypeScript API writes rows of the table. */
+  readonly writes: boolean;
+}
+/** The block tables in `modules` that run over the app's views. */
+declare function adoptedViews(modules: AnyBlocksConfig, ownTables: Readonly<Record<string, string>>, views: Required<Pick<BlockSqlLayout, "ownViews">> & Pick<BlockSqlLayout, "ownColumns">): readonly AdoptedView[];
 //#endregion
 //#region src/sql/expose-columns.d.ts
 /**
@@ -355,6 +368,21 @@ interface PolicyGrant {
 declare function declaredTables(files: readonly {
   readonly text: string;
 }[], schemas: readonly string[]): string[];
+/** A view the app's files create. */
+interface DeclaredView {
+  /** Its columns, or `undefined` when they can't be read (`select *`). */
+  readonly columns: readonly string[] | undefined;
+  /** Whether `insert`, `update` and `delete` reach the table under it. */
+  readonly updatable: boolean;
+}
+/**
+ * The views and materialized views `files` create, as `schema.view`, with their
+ * columns and whether they are auto-updatable. A later `drop view` removes one.
+ * Only views in `schemas` are kept.
+ */
+declare function declaredViews(files: readonly {
+  readonly text: string;
+}[], schemas: readonly string[]): ReadonlyMap<string, DeclaredView>;
 /**
  * The tables in `schemas` that `files` leave with row level security on: `alter
  * table ... enable row level security`, until a later `disable` or `drop
@@ -515,4 +543,4 @@ declare function declaredPolicies(sources: readonly {
   readonly text: string;
 }[], schemas: readonly string[]): Record<string, CatalogPolicy[]>;
 //#endregion
-export { moduleFileVersion as $, DataExportPlan as A, appTablesFiles as B, rlsTables as C, expiredFlagsQuery as D, tenantsQuery as E, AdoptedTable as F, BlockSqlExtension as G, instanceFunctions as H, adoptedColumnProblems as I, moduleHidingColumns as J, BlockSqlPermissionKey as K, adoptedTables as L, dataExportPlan as M, excludedColumns as N, sameTenantColumn as O, resolveExposeColumns as P, isModuleDataFile as Q, APP_TABLES_MARKER as R, policyGrants as S, TenantQuery as T, SQL_MODULES as U, DEFAULT_ROLES as V, resolveBlocks as W, moduleSchemaExtensions as X, modulePermissionKeys as Y, blockFileState as Z, PolicyGrant as _, moduleTopics as _t, hasColumnAccess as a, entityRenamePlan as at, declaredUpdatedAtTriggers as b, compileReadSets as c, formerBlockName as ct, migrationOptionUses as d, InstalledBlock as dt, sameBlockFile as et, moduleLayout as f, moduleDeprecations as ft, templateFunctions as g, moduleBody as gt, scopeProblems as h, customContracts as ht, scopePolicyName as i, EntityRenameStep as it, SECRET_COLUMNS as j, sameTenantTrigger as k, sharedRolesProblems as l, renamedBlock as lt, resolveProviderSql as m, BlockSqlTopic as mt, widenedCommands as n, moduleFilePaths as nt, CompiledReadSet as o, BLOCK_RENAMES as ot, SCOPE_ID_TYPES as p, upgradePlan as pt, moduleEventTriggers as q, TENANT_SCOPE_POLICY as r, EntityRenamePlan as rt, compileReadSet as s, currentBlockName as st, declaredPolicies as t, moduleDataDir as tt, MigrationOptionUse as u, BlockSqlUpgradePlan as ut, declaredTableColumns as v, renderBlocks as vt, subjectColumns as w, extensionSchema as x, declaredTables as y, APP_TABLES_MODULE as z };
+export { modulePermissionKeys as $, sameTenantColumn as A, adoptedTables as B, extensionSchema as C, TenantQuery as D, subjectColumns as E, excludedColumns as F, DEFAULT_ROLES as G, APP_TABLES_MARKER as H, resolveExposeColumns as I, resolveBlocks as J, instanceFunctions as K, AdoptedTable as L, DataExportPlan as M, SECRET_COLUMNS as N, tenantsQuery as O, dataExportPlan as P, moduleHidingColumns as Q, AdoptedView as R, declaredViews as S, renderBlocks as St, rlsTables as T, APP_TABLES_MODULE as U, adoptedViews as V, appTablesFiles as W, BlockSqlPermissionKey as X, BlockSqlExtension as Y, moduleEventTriggers as Z, DeclaredView as _, upgradePlan as _t, hasColumnAccess as a, moduleDataDir as at, declaredTables as b, moduleBody as bt, compileReadSets as c, EntityRenameStep as ct, migrationOptionUses as d, currentBlockName as dt, moduleSchemaExtensions as et, moduleLayout as f, formerBlockName as ft, templateFunctions as g, moduleDeprecations as gt, scopeProblems as h, InstalledBlock as ht, scopePolicyName as i, sameBlockFile as it, sameTenantTrigger as j, expiredFlagsQuery as k, sharedRolesProblems as l, entityRenamePlan as lt, resolveProviderSql as m, BlockSqlUpgradePlan as mt, widenedCommands as n, isModuleDataFile as nt, CompiledReadSet as o, moduleFilePaths as ot, SCOPE_ID_TYPES as p, renamedBlock as pt, SQL_MODULES as q, TENANT_SCOPE_POLICY as r, moduleFileVersion as rt, compileReadSet as s, EntityRenamePlan as st, declaredPolicies as t, blockFileState as tt, MigrationOptionUse as u, BLOCK_RENAMES as ut, PolicyGrant as v, BlockSqlTopic as vt, policyGrants as w, declaredUpdatedAtTriggers as x, moduleTopics as xt, declaredTableColumns as y, customContracts as yt, adoptedColumnProblems as z };

package/dist/{index-DLq69k3F.d.ts → index-CcAmFNVi.d.ts}

@@ -3,9 +3,9 @@ import { n as DbException } from "./escape-like-PReMbEEU.js";
 import { f as Result, t as AsyncResult } from "./result-DZeA5KS6.js";
 import { $ as RecordRef, K as Insert, O as AnyFunctions, Z as PrimaryKeyValue, ht as Update, k as AnyModels, ut as TableKey } from "./types-DFdg_4yN.js";
 import { o as EventHub } from "./events-vcqenSYU.js";
-import { A as OffsetRangeArgs, Bt as Payload, C as GetKey, Dt as CountArgs, K as WriteArgs, Nt as ListArgs, O as OffsetPage, S as FindExt, St as AggregateResult, U as UpdateArgs, W as UpsertArgs, Zt as CacheAdapter, _ as CursorPageArgs, b as DeleteArgs, ft as InferResult, g as CursorPage, k as OffsetPageArgs, kt as GetArgs, pt as QuerySpec, t as BetterSupabase, v as Db, x as DeleteExt, yt as AggregateArgs, z as Returned } from "./define-DFBnQyYg.js";
+import { A as OffsetRangeArgs, Bt as Payload, C as GetKey, Dt as CountArgs, K as WriteArgs, Nt as ListArgs, O as OffsetPage, S as FindExt, St as AggregateResult, U as UpdateArgs, W as UpsertArgs, Zt as CacheAdapter, _ as CursorPageArgs, b as DeleteArgs, ft as InferResult, g as CursorPage, k as OffsetPageArgs, kt as GetArgs, pt as QuerySpec, t as BetterSupabase, v as Db, x as DeleteExt, yt as AggregateArgs, z as Returned } from "./define-C5AcEkEJ.js";
 import { n as DataEngine, r as DataEngineOptions } from "./data-engine-BWoz9lED.js";
-import { Dn as GeneratedBlocks, cn as RecordBindingResult, dn as RecordBindingWriteName, fn as RecordBindingWriteOutput, in as RecordBindingData, nn as AnyRecordBindingWrite, on as RecordBindingOptions, t as AnyBlock, tn as AnyRecordBinding, un as RecordBindingWriteInput } from "./define-block-BVcLQ3DF.js";
+import { Dn as GeneratedBlocks, cn as RecordBindingResult, dn as RecordBindingWriteName, fn as RecordBindingWriteOutput, in as RecordBindingData, nn as AnyRecordBindingWrite, on as RecordBindingOptions, t as AnyBlock, tn as AnyRecordBinding, un as RecordBindingWriteInput } from "./define-block-C1RHXz7L.js";
 import { t as BetterQueryMeta } from "./invalidate-DMp4eqfF.js";
 import { DataTag, InfiniteData, QueryClient, SkipToken } from "@tanstack/query-core";
 import { StandardSchemaV1 } from "@standard-schema/spec";

package/dist/{index-BnH4Gomw.d.ts → index-Craf712U.d.ts}

@@ -1,19 +1,19 @@
 import { b as DbError, f as Result, t as AsyncResult } from "./result-DZeA5KS6.js";
 import { $ as RecordRef } from "./types-DFdg_4yN.js";
 import { Ct as Events, D as BlockEventPattern, T as BlockEvent, bt as EventMap, k as BlockEventsMatching } from "./events-vcqenSYU.js";
-import { pt as QuerySpec } from "./define-DFBnQyYg.js";
-import { $ as TemplateValues, C as UploadOptions, O as TtlPreset, S as UploadBody, l as ImageTransform, w as UrlOptions, x as TransformOptions } from "./bucket-CiNi8sIw.js";
+import { pt as QuerySpec } from "./define-C5AcEkEJ.js";
+import { A as TtlPreset, C as TransformOptions, E as UrlOptions, T as UploadOptions, l as ImageTransform, tt as TemplateValues, w as UploadBody } from "./bucket-vc-QRrva.js";
 import { m as RejectedChange, o as DataSyncState } from "./data-engine-BWoz9lED.js";
-import { M as BindingName, S as RecordWriteInput, _ as RecordTypeBlocks, b as RecordTypeWriteInput, d as BindingWritesOf, f as Plain, g as RecordType, h as RecordCan, m as PlainBindings, x as RecordTypeWriteOutput } from "./index-DLq69k3F.js";
-import { c as RealtimeClient, d as SubscribeOptions, g as TopicHandlers, i as PresenceOptions, m as Topic, p as SubscriptionStatus, r as PresenceMember, s as PresenceSubscription, t as EventSchemas } from "./topic-CJrQZQaa.js";
-import { t as AuthSnapshot } from "./bind-CrMBwrPN.js";
+import { M as BindingName, S as RecordWriteInput, _ as RecordTypeBlocks, b as RecordTypeWriteInput, d as BindingWritesOf, f as Plain, g as RecordType, h as RecordCan, m as PlainBindings, x as RecordTypeWriteOutput } from "./index-CcAmFNVi.js";
+import { c as RealtimeClient, d as SubscribeOptions, g as TopicHandlers, i as PresenceOptions, m as Topic, p as SubscriptionStatus, r as PresenceMember, s as PresenceSubscription, t as EventSchemas } from "./topic-CZXHhZye.js";
+import { t as AuthSnapshot } from "./bind-JGCPGUJh.js";
 import { t as AuthSession } from "./view-DyFdMCqg.js";
-import { r as LiveCountSeed } from "./index-B938YqY-.js";
-import { n as Controller } from "./controller-BrP0gn47.js";
-import { D as ProfileOf, O as UseActionOptions, S as LiveCountHookOptions, _ as ActionResultOf, a as DataRows, b as ClaimsOf, c as DataWrites, d as BlockMutationState, f as BlockQueryActions, g as ActionInputOf, i as DataRow, l as BlockEventSource, m as BlockQueryState, n as DataId, o as DataSource, p as BlockQueryOptions, r as DataListArgs, s as DataState, u as BlockMutationActions, w as LiveQueryHookOptions, x as ClientLike, y as BroadcastOptions } from "./field-errors-fsbFktYF.js";
-import { t as BlockEnv } from "./block-env-B_uEM2xz.js";
+import { r as LiveCountSeed, v as RelayClientOptions } from "./index-CTu-3fJB.js";
+import { n as Controller } from "./controller-BW-5Opig.js";
+import { D as ProfileOf, O as UseActionOptions, S as LiveCountHookOptions, _ as ActionResultOf, a as DataRows, b as ClaimsOf, c as DataWrites, d as BlockMutationState, f as BlockQueryActions, g as ActionInputOf, i as DataRow, l as BlockEventSource, m as BlockQueryState, n as DataId, o as DataSource, p as BlockQueryOptions, r as DataListArgs, s as DataState, u as BlockMutationActions, w as LiveQueryHookOptions, x as ClientLike, y as BroadcastOptions } from "./field-errors-Dt86dCKk.js";
+import { t as BlockEnv } from "./block-env-y65GF_px.js";
 import { n as BlockDataOf, r as BlockMethodName, t as BlockArgsOf } from "./block-method-CiVa2G-J.js";
-import { s as RecordFormValues, t as RecordForm } from "./record-form-BYs9xv_N.js";
+import { s as RecordFormValues, t as RecordForm } from "./record-form-D9ILuVtA.js";
 import { SupabaseClient } from "@supabase/supabase-js";
 import { DependencyList, ReactNode, SubmitEvent } from "react";
 import { QueryClient } from "@tanstack/query-core";
@@ -22,6 +22,11 @@ interface BetterSupabaseProviderProps {
   readonly client: ClientLike;
   /** Better-supabase queries are removed when the user signs out or changes. */
   readonly queryClient?: QueryClient;
+  /**
+   * The Realtime client the hooks join with instead of the client's `supabase`,
+   * such as `useRealtimeRelay(url)` in a support session.
+   */
+  readonly realtime?: RealtimeClient;
   readonly children?: ReactNode;
 }
 /** Provides the better-supabase client to the hooks. */
@@ -450,7 +455,7 @@ interface PresenceHookOptions<I> {
    */
   readonly state?: I | null;
   /** A supabase-js client for apps without `<BetterSupabaseProvider>`. */
-  readonly client?: SupabaseClient;
+  readonly client?: RealtimeClient;
 }
 interface Presence<I, O> {
   /** Everyone on the topic, this client included, from the last sync. */
@@ -480,6 +485,33 @@ interface PresenceTopic<P extends string, I, O> {
  */
 declare function usePresence<P extends string, I, O>(topic: PresenceTopic<P, I, O>, values: TemplateValues<P> | null | undefined, options?: PresenceHookOptions<I>): Presence<I, O>;
 //#endregion
+//#region src/react/relay.d.ts
+interface UseRealtimeRelayOptions extends RelayClientOptions {
+  /**
+   * `support` (the default): the relay only while a support session runs, as
+   * `useSupportSession()` reports it from the nearest `<SessionProvider>`.
+   * `always`: for apps that keep sessions in httpOnly cookies.
+   */
+  readonly when?: "support" | "always";
+}
+/**
+ * A `relayRealtimeClient(url)` while it is needed, else `undefined`. Pass it to
+ * `<BetterSupabaseProvider realtime={...}>`, and `useBroadcast`, `usePresence`,
+ * `useLiveQuery` and `useLiveCount` join through the server's `realtimeRelay`
+ * route, as the viewed user in a support session. The client is created once
+ * per `url` and options, so pass a stable `fetch` and `EventSource`.
+ *
+ * ```tsx
+ * const realtime = useRealtimeRelay("/api/realtime");
+ * return (
+ *   <BetterSupabaseProvider client={bsb} realtime={realtime}>
+ *     {children}
+ *   </BetterSupabaseProvider>
+ * );
+ * ```
+ */
+declare function useRealtimeRelay(url: string, options?: UseRealtimeRelayOptions): RealtimeClient | undefined;
+//#endregion
 //#region src/react/search.d.ts
 interface DebouncedSearchOptions {
   /** Defaults to 250 ms. */
@@ -630,4 +662,4 @@ interface UseUploadOptions<R> {
  */
 declare function useUpload<T, R>(bucket: UploadTarget<T, R>, options?: UseUploadOptions<R>): Upload<T, R>;
 //#endregion
-export { useActionForm as $, useBlockEvent as A, useRecordListState as B, DataHooks as C, useBlockTenant as D, useBlockEnv as E, useRecordForm as F, RecordProviderProps as G, RecordContextValue as H, RecordListQueryStates as I, createRecordProvider as J, RecordState as K, RecordListState as L, useBlockQuery as M, RecordFormState as N, useController as O, UseRecordFormOptions as P, useAction as Q, RecordListUrl as R, useSyncStatus as S, defineDataHooks as T, RecordInitial as U, RecordActionsOf as V, RecordProviderKit as W, ActionHandle as X, ActionForm as Y, UseActionFormOptions as Z, PresenceHookOptions as _, Upload as a, useAuth as at, Conflicts as b, UseImageOptions as c, useLiveQuery as ct, useSignedUrl as d, BetterHooks as et, useUpload as f, Presence as g, useDebouncedSearch as h, StorageImage as i, createHooks as it, useBlockMutation as j, useLatest as k, UseUploadOptions as l, useSupabase as lt, DebouncedSearchOptions as m, SignedUrl as n, BetterSupabaseProviderProps as nt, UploadStatus as o, useBroadcast as ot, DebouncedSearch as p, RecordWriteHandlers as q, SignedUrlSource as r, LiveCount as rt, UploadTarget as s, useLiveCount as st, ImageSource as t, BetterSupabaseProvider as tt, useImage as u, PresenceTopic as v, DataView as w, useConflicts as x, usePresence as y, RecordListUrlState as z };
+export { UseActionFormOptions as $, useController as A, RecordListUrl as B, useConflicts as C, defineDataHooks as D, DataView as E, RecordFormState as F, RecordInitial as G, useRecordListState as H, UseRecordFormOptions as I, RecordState as J, RecordProviderKit as K, useRecordForm as L, useBlockEvent as M, useBlockMutation as N, useBlockEnv as O, useBlockQuery as P, ActionHandle as Q, RecordListQueryStates as R, Conflicts as S, DataHooks as T, RecordActionsOf as U, RecordListUrlState as V, RecordContextValue as W, createRecordProvider as X, RecordWriteHandlers as Y, ActionForm as Z, useRealtimeRelay as _, Upload as a, LiveCount as at, PresenceTopic as b, UseImageOptions as c, useBroadcast as ct, useSignedUrl as d, useSupabase as dt, useAction as et, useUpload as f, UseRealtimeRelayOptions as g, useDebouncedSearch as h, StorageImage as i, BetterSupabaseProviderProps as it, useLatest as j, useBlockTenant as k, UseUploadOptions as l, useLiveCount as lt, DebouncedSearchOptions as m, SignedUrl as n, BetterHooks as nt, UploadStatus as o, createHooks as ot, DebouncedSearch as p, RecordProviderProps as q, SignedUrlSource as r, BetterSupabaseProvider as rt, UploadTarget as s, useAuth as st, ImageSource as t, useActionForm as tt, useImage as u, useLiveQuery as ut, Presence as v, useSyncStatus as w, usePresence as x, PresenceHookOptions as y, RecordListState as z };

package/dist/{index-BUuVq1co.d.ts → index-DZKCc2WM.d.ts}

@@ -2,9 +2,9 @@ import { t as AsyncResult } from "./result-DZeA5KS6.js";
 import { O as AnyFunctions, k as AnyModels } from "./types-DFdg_4yN.js";
 import { l as PublicEnv } from "./index-NRMMhhEi.js";
 import { g as SessionEncoding } from "./resolve-CXX6DHv3.js";
-import { t as BetterSupabase } from "./define-DFBnQyYg.js";
-import { i as KeyboardPort, l as StoragePort, n as DeepLinkPort, r as FilePickerPort, s as PushTokenPort, t as ClientPorts } from "./ports-sx226JUL.js";
-import { i as BindClientOptions, r as BetterClient } from "./bind-CrMBwrPN.js";
+import { t as BetterSupabase } from "./define-C5AcEkEJ.js";
+import { i as KeyboardPort, l as StoragePort, n as DeepLinkPort, r as FilePickerPort, s as PushTokenPort, t as ClientPorts } from "./ports-mObLgH1z.js";
+import { i as BindClientOptions, r as BetterClient } from "./bind-JGCPGUJh.js";
 import { n as FunctionContract } from "./function-contract-DxFNOmsm.js";
 import { FunctionInvokeOptions, SupabaseClient, SupabaseClientOptions } from "@supabase/supabase-js";
 //#region src/client/functions.d.ts

package/dist/index.d.ts

@@ -6,8 +6,8 @@ import { $ as RecordRef, A as BucketMeta, At as NoExtension, B as FunctionMeta,
 import { Ct as Events, O as BlockEventType, T as BlockEvent, a as EventHandler, bt as EventMap, c as MutationNotice, d as RpcNotice, i as ErrorEvent, l as QueryEvent, n as AuthOutageEvent, o as EventHub, r as BetterSupabaseEvents, s as EventName, t as AuthEvent, u as RefreshEvent } from "./events-vcqenSYU.js";
 import { i as silentLogger, n as Logger, r as consoleLogger, t as LogFields } from "./logger-DWVYUmwi.js";
 import { a as ProblemFormat, c as fromProblem, d as toProblem, i as ProblemDetails, l as isProblem, n as PROBLEM_CONTENT_TYPE, o as ProblemOptions, r as PROBLEM_TYPE_BASE, s as ProblemResponseOptions, t as BlockProblemOptions, u as problemResponse } from "./problem-DNwN8iGz.js";
-import { $t as MemoryCache, A as OffsetRangeArgs, At as IncludeArg, B as RowFilter, Bt as Payload, C as GetKey, Ct as AggregateRow, Dt as CountArgs, E as ManyWriteArgs, Et as CountArg, Ft as MeasureKey, G as UpsertManyArgs, Gt as SortDirection, H as RpcOptions, Ht as RelationMeasureArg, It as MutableWhere, J as DbStats, Jt as WhereInput, K as WriteArgs, Kt as SortSpec, L as Repository, Lt as NumericMeasureArg, Mt as JsonPathOps, Nt as ListArgs, O as OffsetPage, Ot as FieldFilter, P as PageOf, Pt as MeasureArg, Q as SearchArgs, Qt as CacheTarget, R as RepositoryOf, Rt as OrderByArg, S as FindExt, St as AggregateResult, T as ManyResult, Tt as ColumnOrderByArg, U as UpdateArgs, Ut as RequestArgs, Vt as ReadArgs, W as UpsertArgs, Wt as SelectArg, X as StatsRecorder, Xt as BucketsHelper, Y as EMPTY_STATS, Yt as BucketRegistry, Z as recordStats, Zt as CacheAdapter, _ as CursorPageArgs, _t as isQuerySpec, a as explainPostgrest, at as ReadSetParamTypes, b as DeleteArgs, bt as AggregateOrderBy, c as RpcDefinition, ct as ReadSetResult, d as BlocksHelper, dt as readSetTables, en as cacheTargetOf, et as InferReadSetParams, f as DbBlockSource, ft as InferResult, g as CursorPage, gt as TableSpecs, h as ConflictTarget, ht as Specs, i as PostgrestExecutorOptions, it as ReadSetParamType, jt as IncludeArgs, k as OffsetPageArgs, kt as GetArgs, l as SupabaseOptions, lt as defineReadSet, m as DbOf, mt as ReadMethod, n as defineSupabase, nn as rowKey, nt as ReadSetAuth, o as postgrestExecutor, ot as ReadSetParamValue, p as DbExtras, pt as QuerySpec, q as WriteManyArgs, qt as WhereArg, r as PostgrestClientLike, rn as rpcCacheTargets, rt as ReadSetOptions, s as ConnectOptions, st as ReadSetParams, t as BetterSupabase, tn as memoryCache, tt as ReadSet, ut as isReadSet, v as Db, vt as specTables, wt as ColumnOrderBy, x as DeleteExt, xt as AggregateOrderByArg, y as DbHelpers, yt as AggregateArgs, z as Returned, zt as OrderByInput } from "./define-DFBnQyYg.js";
-import { X as StoragePath } from "./bucket-CiNi8sIw.js";
+import { $t as MemoryCache, A as OffsetRangeArgs, At as IncludeArg, B as RowFilter, Bt as Payload, C as GetKey, Ct as AggregateRow, Dt as CountArgs, E as ManyWriteArgs, Et as CountArg, Ft as MeasureKey, G as UpsertManyArgs, Gt as SortDirection, H as RpcOptions, Ht as RelationMeasureArg, It as MutableWhere, J as DbStats, Jt as WhereInput, K as WriteArgs, Kt as SortSpec, L as Repository, Lt as NumericMeasureArg, Mt as JsonPathOps, Nt as ListArgs, O as OffsetPage, Ot as FieldFilter, P as PageOf, Pt as MeasureArg, Q as SearchArgs, Qt as CacheTarget, R as RepositoryOf, Rt as OrderByArg, S as FindExt, St as AggregateResult, T as ManyResult, Tt as ColumnOrderByArg, U as UpdateArgs, Ut as RequestArgs, Vt as ReadArgs, W as UpsertArgs, Wt as SelectArg, X as StatsRecorder, Xt as BucketsHelper, Y as EMPTY_STATS, Yt as BucketRegistry, Z as recordStats, Zt as CacheAdapter, _ as CursorPageArgs, _t as isQuerySpec, a as explainPostgrest, at as ReadSetParamTypes, b as DeleteArgs, bt as AggregateOrderBy, c as RpcDefinition, ct as ReadSetResult, d as BlocksHelper, dt as readSetTables, en as cacheTargetOf, et as InferReadSetParams, f as DbBlockSource, ft as InferResult, g as CursorPage, gt as TableSpecs, h as ConflictTarget, ht as Specs, i as PostgrestExecutorOptions, it as ReadSetParamType, jt as IncludeArgs, k as OffsetPageArgs, kt as GetArgs, l as SupabaseOptions, lt as defineReadSet, m as DbOf, mt as ReadMethod, n as defineSupabase, nn as rowKey, nt as ReadSetAuth, o as postgrestExecutor, ot as ReadSetParamValue, p as DbExtras, pt as QuerySpec, q as WriteManyArgs, qt as WhereArg, r as PostgrestClientLike, rn as rpcCacheTargets, rt as ReadSetOptions, s as ConnectOptions, st as ReadSetParams, t as BetterSupabase, tn as memoryCache, tt as ReadSet, ut as isReadSet, v as Db, vt as specTables, wt as ColumnOrderBy, x as DeleteExt, xt as AggregateOrderByArg, y as DbHelpers, yt as AggregateArgs, z as Returned, zt as OrderByInput } from "./define-C5AcEkEJ.js";
+import { Q as StoragePath } from "./bucket-vc-QRrva.js";
 import { a as PostgrestPlan, n as PlanLimit, o as compilePostgrest, r as PlanOrder, t as PlanFilter } from "./postgrest-z-T0l23T.js";
 import { i as FieldSpec, n as TableSchema, o as TableSchemaSpec, r as tableSchema, t as StandardJSONSchemaV1 } from "./table-schema-BlF6k62Q.js";
 import { n as postgrestCompiler, t as Compiler } from "./compiler-D3UmE7ao.js";

package/dist/{knowledge-CtL-Vfgy.d.ts → knowledge-F1IhRI4Q.d.ts}

@@ -5,7 +5,7 @@ import { r as BlockTemporalOptions } from "./block-helpers-CRpAHrp_.js";
 import { t as BlockTransport } from "./block-transport-DWZSJrwN.js";
 import { n as BlockHooks } from "./block-hooks-DZN2w69m.js";
 import { f as AiFiles, o as AiFile } from "./types-Dr9wZgNy.js";
-import { g as JobHandler } from "./types-SFRomQF7.js";
+import { g as JobHandler } from "./types-Czq9Xtpa.js";
 //#region src/blocks/knowledge/knowledge.d.ts
 /**
  * Turns texts into vectors. `model` is stored with each document, so a document

package/dist/list/index.d.ts

@@ -1,4 +1,4 @@
 import { _ as FilterRule, a as FilterDateValue, b as encodeFilterQuery, c as FilterFieldLabels, d as FilterLimits, f as FilterNode, g as FilterRelativeDate, h as FilterQuery, i as FilterCombinator, l as FilterFieldType, m as FilterOperatorSpec, n as FILTER_OPERATOR_LABELS, o as FilterField, p as FilterOperatorArity, r as FilterClock, s as FilterFieldInfo, t as FILTER_OPERATORS, u as FilterGroupNode, v as ListFilterConfig, y as decodeFilterQuery } from "../filter-query-BXLs72G9.js";
-import { _ as UNSET, a as ListExtra, c as ListParseOptions, d as ListQuery, f as ListQueryConfig, g as ParserSpec, h as OpenApiParameter, i as ListDefinition, l as ListParseResult, m as ListSearchParams, n as FacetCounts, o as ListPage, p as ListQueryInput, r as FacetInfo, s as ListPagination, t as FacetCountFields, u as ListParsers, v as defineListQuery } from "../list-query-BDVutLFr.js";
+import { _ as UNSET, a as ListExtra, c as ListParseOptions, d as ListQuery, f as ListQueryConfig, g as ParserSpec, h as OpenApiParameter, i as ListDefinition, l as ListParseResult, m as ListSearchParams, n as FacetCounts, o as ListPage, p as ListQueryInput, r as FacetInfo, s as ListPagination, t as FacetCountFields, u as ListParsers, v as defineListQuery } from "../list-query-DYhgRTd5.js";
 import { n as FilterRecordField, r as evaluateFilterQuery, t as FilterEvaluation } from "../filter-evaluate-CPxeae5X.js";
 export { FILTER_OPERATORS, FILTER_OPERATOR_LABELS, type FacetCountFields, type FacetCounts, type FacetInfo, type FilterClock, type FilterCombinator, type FilterDateValue, type FilterEvaluation, type FilterField, type FilterFieldInfo, type FilterFieldLabels, type FilterFieldType, type FilterGroupNode, type FilterLimits, type FilterNode, type FilterOperatorArity, type FilterOperatorSpec, type FilterQuery, type FilterRecordField, type FilterRelativeDate, type FilterRule, type ListDefinition, type ListExtra, type ListFilterConfig, type ListPage, type ListPagination, type ListParseOptions, type ListParseResult, type ListParsers, type ListQuery, type ListQueryConfig, type ListQueryInput, type ListSearchParams, type OpenApiParameter, type ParserSpec, UNSET, decodeFilterQuery, defineListQuery, encodeFilterQuery, evaluateFilterQuery };

package/dist/{list-query-BDVutLFr.d.ts → list-query-DYhgRTd5.d.ts}

@@ -1,6 +1,6 @@
 import { D as ValidationIssue, t as AsyncResult } from "./result-DZeA5KS6.js";
 import { O as AnyFunctions, a as CountMode, it as Row, k as AnyModels, ut as TableKey } from "./types-DFdg_4yN.js";
-import { At as IncludeArg, Bt as Payload, Jt as WhereInput, O as OffsetPage, R as RepositoryOf, Rt as OrderByArg, S as FindExt, Wt as SelectArg, _ as CursorPageArgs, g as CursorPage, k as OffsetPageArgs, t as BetterSupabase } from "./define-DFBnQyYg.js";
+import { At as IncludeArg, Bt as Payload, Jt as WhereInput, O as OffsetPage, R as RepositoryOf, Rt as OrderByArg, S as FindExt, Wt as SelectArg, _ as CursorPageArgs, g as CursorPage, k as OffsetPageArgs, t as BetterSupabase } from "./define-C5AcEkEJ.js";
 import { c as FilterFieldLabels, h as FilterQuery, o as FilterField, r as FilterClock, s as FilterFieldInfo, v as ListFilterConfig } from "./filter-query-BXLs72G9.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/list/list-query.d.ts

package/dist/mapper/bin.js

@@ -1,10 +1,10 @@
-import { t as VERSION } from "../cli/version-Du4CgONY.js";
-import { a as lastTypesModule, c as writeAtomic, s as typesModuleKey } from "../cli/cache-CXgR_Ahi.js";
-import { t as loadSnapshot } from "../cli/snapshot-C8MVPyO8.js";
-import { i as renderTypesModule, t as mapperFilePath } from "../cli/render-ucJmUyuM.js";
+import { t as VERSION } from "../cli/version-B2Dr6VmJ.js";
+import { a as lastTypesModule, c as writeAtomic, s as typesModuleKey } from "../cli/cache-AznIssjI.js";
+import { t as loadSnapshot } from "../cli/snapshot-uTUlEzY2.js";
+import { i as renderTypesModule, t as mapperFilePath } from "../cli/render-5y5a1QZr.js";
 import { i as discoverConfig, s as loadConfig } from "../cli/config-9t5ec_N7.js";
 import { i as parseEnv, n as configEnvironment } from "../cli/env-DMgjB_4y.js";
-import { s as schemaStampPath } from "../cli/content-mapper-DNs7lTu7.js";
+import { s as schemaStampPath } from "../cli/content-mapper-DCrz6OIv.js";
 import { existsSync, realpathSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
 import { createHash } from "node:crypto";

package/dist/mcp/index.d.ts

@@ -1,11 +1,11 @@
 import { O as AnyFunctions, k as AnyModels, ut as TableKey } from "../types-DFdg_4yN.js";
 import { t as OperationTable } from "../operations-CSc_IsHO.js";
 import { l as PermissionRef, t as AnyAuthorizer } from "../authorizer-B6X09otb.js";
-import { t as BetterSupabase } from "../define-DFBnQyYg.js";
-import { a as ServerContext, c as ServerOptions, n as BetterServer } from "../server-types-CFtehAsr.js";
+import { t as BetterSupabase } from "../define-C5AcEkEJ.js";
+import { a as ServerContext, c as ServerOptions, n as BetterServer } from "../server-types-CK8mUIUT.js";
 import { r as GuardOptions } from "../respond-Dn1_YhC1.js";
 import { D as ResourceOperation } from "../model-hwpvole9.js";
-import { l as ResourceRouteOptions } from "../resource-types-DnKiH4G2.js";
+import { l as ResourceRouteOptions } from "../resource-types-pMeLs68X.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/mcp/dialect.d.ts
 /**

package/dist/mcp/index.js

@@ -6,7 +6,7 @@ import { a as methodNotAllowed, c as toProblem, o as problemResponse } from "../
 import { t as SPEC_PINS } from "../spec-pins-C1Vm8OBl.js";
 import { r as toDraft07, t as buildJsonSchema } from "../json-schema-Ca6gYbEP.js";
 import { r as operationPermission, t as OPERATION_PREFIXES } from "../operations-DVHRHvv6.js";
-import { c as extendServer, n as flushEvents, s as createServer } from "../adapter-B0b6MXYS.js";
+import { c as extendServer, n as flushEvents, s as createServer } from "../adapter-Dyks1lX1.js";
 import { n as checkEach, r as checkPermission } from "../authorizer-BGhXaDmo.js";
 import { n as jsonResponse, t as jsonReplacer } from "../json-DaByVJpw.js";
 import { o as settle, r as guard, t as defaultExpose } from "../respond-C3CcOZlA.js";

package/dist/mcp/sdk/index.d.ts

@@ -2,8 +2,8 @@ import { O as AnyFunctions, k as AnyModels } from "../../types-DFdg_4yN.js";
 import { r as AuthState } from "../../resolve-CXX6DHv3.js";
 import { i as CredentialRef, r as CredentialProvider } from "../../provider-CqwEOLCA.js";
 import { i as SupabaseMcpScope, n as SupabaseMcpModule, r as SupabaseMcpPlatformModule, t as SupabaseMcpFeature } from "../../supabase-mcp-Z4vtsuoO.js";
-import { t as BetterSupabase } from "../../define-DFBnQyYg.js";
-import { a as ServerContext$1, c as ServerOptions, n as BetterServer } from "../../server-types-CFtehAsr.js";
+import { t as BetterSupabase } from "../../define-C5AcEkEJ.js";
+import { a as ServerContext$1, c as ServerOptions, n as BetterServer } from "../../server-types-CK8mUIUT.js";
 import { r as GuardOptions, t as AllowedCaller } from "../../respond-Dn1_YhC1.js";
 import { AuthInfo, CallToolResult, Icon, InputRequiredResult, OAuthTokenVerifier, RegisteredTool, ScopeChallengeHandler, ServerContext, StandardSchemaWithJSON, ToolAnnotations } from "@modelcontextprotocol/server";
 //#region src/mcp/sdk/sdk.d.ts

package/dist/mcp/sdk/index.js

@@ -1,7 +1,7 @@
 import { n as dbError } from "../../errors-BVFgt8BZ.js";
 import { o as problemResponse } from "../../problem-Bf0cJ7tk.js";
 import { i as delegationOf } from "../../actor-go7p9-CJ.js";
-import { c as extendServer, i as resolveToken, n as flushEvents, s as createServer } from "../../adapter-B0b6MXYS.js";
+import { c as extendServer, i as resolveToken, n as flushEvents, s as createServer } from "../../adapter-Dyks1lX1.js";
 import { r as guard } from "../../respond-C3CcOZlA.js";
 import { t as withExtra } from "../../extra-CGQ2_q3S.js";
 import { a as withCors, i as metadataPreflight, n as endpointPreflight, r as isMetadataRequest, t as discovery } from "../../http-DzbloBR-.js";

package/dist/next/client/index.d.ts

@@ -1,3 +1,54 @@
+import { i as SessionWatchStatus, t as SessionStatusBody } from "../../session-status-qQLm7jzh.js";
+//#region src/next/client/session-watch.d.ts
+/**
+ * Why the session changed: Auth ended it or banned the user, the user signed
+ * out, or the claims or support target behind the session changed.
+ */
+type SessionChangeReason = "ended" | "banned" | "signed_out" | "claims_changed";
+interface SessionWatchEvent {
+  readonly reason: SessionChangeReason;
+  /** The route's answer; `null` when another tab reported the change. */
+  readonly status: SessionStatusBody | null;
+  /** `check`: this tab saw it. `tab`: another tab of the app did. */
+  readonly source: "check" | "tab";
+}
+interface SessionWatchOptions {
+  /** Where `sessionStatusRoute` is mounted. Defaults to `/api/session-status`. */
+  readonly url?: string;
+  /**
+   * Milliseconds between checks while the page is visible. Defaults to 60000; 0
+   * checks on focus and visibility only.
+   */
+  readonly intervalMs?: number;
+  /**
+   * The fingerprint the page rendered with, such as from the session status of
+   * the server render. Without it the first check sets it.
+   */
+  readonly fingerprint?: string | null;
+  /**
+   * The `BroadcastChannel` that tells the app's other tabs, or `false` for
+   * none. Defaults to `better-supabase:session`.
+   */
+  readonly channel?: string | false;
+  readonly fetch?: typeof fetch;
+  /** Called with every answer of the route, changed or not. */
+  readonly onStatus?: (status: SessionStatusBody) => void;
+}
+interface SessionWatcher {
+  /** Checks now; a check already running is reused. */
+  check(): Promise<SessionStatusBody | undefined>;
+  stop(): void;
+}
+/**
+ * Watches the session through `sessionStatusRoute`: checks when the window gets
+ * focus or becomes visible and on an interval while visible, and calls
+ * `onChange` when the session ended, the user was banned or signed out, or the
+ * claims fingerprint changed. Each change is posted to the app's other tabs,
+ * which call their own `onChange` with `source: "tab"`. Failed checks are
+ * ignored and retried on the next trigger.
+ */
+export declare function watchSession(onChange: (event: SessionWatchEvent) => void, options?: SessionWatchOptions): SessionWatcher;
+//#endregion
 //#region src/next/client/index.d.ts
 /** The `push` and `refresh` `useSessionChange` needs; next-intl's router fits. */
 export interface SessionChangeRouter {
@@ -33,4 +84,33 @@ export interface SessionChangeOptions {
  * ```
  */
 export declare function useSessionChange(changed: () => Promise<void>, router?: SessionChangeRouter, options?: SessionChangeOptions): (to?: string) => Promise<void>;
-//#endregion
+export interface UseSessionWatchOptions extends SessionWatchOptions {
+  /**
+   * Replaces the default reaction. By default an ended, banned or signed-out
+   * session loads `redirect` (or the current page, which the proxy then sends
+   * to sign-in) as a full document load, and a claims change refreshes the
+   * router so Server Components render with the new claims.
+   */
+  readonly onChange?: (event: SessionWatchEvent) => void;
+  /** Where an ended session goes. Defaults to reloading the current page. */
+  readonly redirect?: string;
+  /** The router a claims change refreshes. Defaults to Next.js's. */
+  readonly router?: Pick<SessionChangeRouter, "refresh">;
+  /** Pauses the watch, e.g. on pages without a session. */
+  readonly enabled?: boolean;
+}
+/**
+ * Watches the session of an app that keeps it in httpOnly cookies, without a
+ * browser Supabase client: it asks `sessionStatusRoute` on focus, when the tab
+ * becomes visible and on an interval, and reacts when Auth ended the session,
+ * banned the user, the user signed out, or the claims or support target
+ * changed. Other tabs of the app hear each change through a `BroadcastChannel`.
+ * Returns the last answer.
+ *
+ * ```tsx
+ * useSessionWatch({ url: "/api/session-status", redirect: "/sign-in" });
+ * ```
+ */
+export declare function useSessionWatch(options?: UseSessionWatchOptions): SessionStatusBody | undefined;
+//#endregion
+export type { SessionChangeReason, SessionStatusBody, SessionWatchEvent, SessionWatchOptions, SessionWatchStatus, SessionWatcher };