better-supabase 0.15.1 → 0.17.0

package/dist/react/server.js

@@ -1,8 +1,8 @@
 import { t as escapeLike } from "../escape-like-DHfx6jRr.js";
-import { d as useSupabase, i as BetterSupabaseProvider, o as useAuth, s as useBroadcast, u as useLiveQuery } from "../sign-in-BsIaNx2C.js";
+import { d as useSupabase, i as BetterSupabaseProvider, o as useAuth, s as useBroadcast, u as useLiveQuery } from "../sign-in-CmPK1AgM.js";
 import { t as supportOf } from "../support-view-g4YLBeqX.js";
 import { d as fieldErrorsOf } from "../data-hooks-tgF1Ct0F.js";
-import "../react-BuDYI62C.js";
+import "../react-CZUZYn9E.js";
 import { t as tenantOf } from "../tenant-BgIiMQpo.js";
 import { SessionProvider } from "./session.js";
 //#region src/react/server.ts
@@ -39,6 +39,11 @@ const useActionForm = clientOnly("useActionForm");
 */
 const usePresence = clientOnly("usePresence");
 /**
+* The `react-server` build of `useRealtimeRelay`: create the relay client in a
+* Client Component.
+*/
+const useRealtimeRelay = clientOnly("useRealtimeRelay");
+/**
 * The `react-server` build of `useSignIn`: sign in from a Client Component or a
 * Server Action.
 */
@@ -138,4 +143,4 @@ const useBlockEnv = clientOnly("useBlockEnv");
 */
 const useBlockTenant = clientOnly("useBlockTenant");
 //#endregion
-export { BetterSupabaseProvider, SessionProvider, createHooks, createRecordProvider, defineDataHooks, escapeLike, fieldErrorsOf, supportOf, tenantOf, useAction, useActionForm, useAuth, useBlockEnv, useBlockEvent, useBlockMutation, useBlockQuery, useBlockTenant, useBroadcast, useConflicts, useController, useDebouncedSearch, useImage, useLatest, useLiveCount, useLiveQuery, usePresence, useRecordForm, useRecordListState, useSession, useSignIn, useSignOut, useSignedUrl, useSupabase, useSupportSession, useSyncStatus, useUpload };
+export { BetterSupabaseProvider, SessionProvider, createHooks, createRecordProvider, defineDataHooks, escapeLike, fieldErrorsOf, supportOf, tenantOf, useAction, useActionForm, useAuth, useBlockEnv, useBlockEvent, useBlockMutation, useBlockQuery, useBlockTenant, useBroadcast, useConflicts, useController, useDebouncedSearch, useImage, useLatest, useLiveCount, useLiveQuery, usePresence, useRealtimeRelay, useRecordForm, useRecordListState, useSession, useSignIn, useSignOut, useSignedUrl, useSupabase, useSupportSession, useSyncStatus, useUpload };

package/dist/react/session.d.ts

@@ -26,4 +26,9 @@ export declare function useSession<C = unknown, P = unknown>(): AuthSession<C, P
  * `useSession`.
  */
 export declare function useSupportSession(): SupportView | undefined;
+/**
+ * `useSupportSession()` that answers `undefined` outside a `<SessionProvider>`
+ * instead of throwing.
+ */
+export declare function useOptionalSupportSession(): SupportView | undefined;
 //#endregion

package/dist/react/session.js

@@ -27,5 +27,13 @@ function useSession() {
 function useSupportSession() {
 	return supportOf(useSession());
 }
+/**
+* `useSupportSession()` that answers `undefined` outside a `<SessionProvider>`
+* instead of throwing.
+*/
+function useOptionalSupportSession() {
+	const promise = useContext(SessionContext);
+	return promise ? supportOf(use(promise)) : void 0;
+}
 //#endregion
-export { SessionProvider, useSession, useSupportSession };
+export { SessionProvider, useOptionalSupportSession, useSession, useSupportSession };

package/dist/{react-BuDYI62C.js → react-CZUZYn9E.js}

@@ -1,13 +1,14 @@
 import { n as dbError } from "./errors-BVFgt8BZ.js";
 import { t as escapeLike } from "./escape-like-DHfx6jRr.js";
 import { a as ok, r as err, s as toDbError } from "./result-ntFBW2p2.js";
-import { c as useBroadcastAuth, f as ClientContext } from "./sign-in-BsIaNx2C.js";
-import "./react/session.js";
+import { c as useBroadcastAuth, f as ClientContext } from "./sign-in-CmPK1AgM.js";
+import { useOptionalSupportSession } from "./react/session.js";
 import { a as blockArgsKey, c as listenToBlockEvents, d as fieldErrorsOf, i as dataTarget, l as blockEnv, n as createDataOne, o as createBlockMutation, r as dataArgsKey, s as createBlockQuery, t as createDataList } from "./data-hooks-tgF1Ct0F.js";
 import { H as rpcTransport } from "./block-helpers-CtBdjgO4.js";
 import { r as createBlocks } from "./create-blocks-Bu4H5TXw.js";
 import { a as recordCan, i as plainData, l as runBindingWrite, s as recordSubject } from "./record-type-DRbnlj5q.js";
 import { t as createRecordController } from "./controller-BNZKd6bJ.js";
+import { t as relayRealtimeClient } from "./relay-gKvKJ3xf.js";
 import { a as ttlSeconds, n as scaleTransform, r as transformFor } from "./variants-Cy--Ub-a.js";
 import { createContext, createElement, use, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore, useTransition } from "react";
 //#region src/react/actions.ts
@@ -529,7 +530,7 @@ const notJoined = () => Promise.resolve(dbError("invalid_request", "better-supab
 */
 function usePresence(topic, values, options = {}) {
 	const context = useContext(ClientContext);
-	const supabase = options.client ?? context?.client.supabase;
+	const supabase = options.client ?? context?.realtime ?? context?.client.supabase;
 	if (!supabase) throw new Error("better-supabase: usePresence needs <BetterSupabaseProvider client={bsb}> or { client: supabase }");
 	const auth = useBroadcastAuth(options.client === void 0 ? context?.client : void 0, supabase);
 	const [members, setMembers] = useState(NONE);
@@ -606,6 +607,42 @@ function syncState(joined, current, tracked) {
 	else joined.track(current.state);
 }
 //#endregion
+//#region src/react/relay.ts
+/**
+* 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>
+* );
+* ```
+*/
+function useRealtimeRelay(url, options = {}) {
+	const support = useOptionalSupportSession();
+	const active = options.when === "always" || support !== void 0;
+	const { EventSource: source, fetch: send, timeoutMs, maxBackoffMs } = options;
+	return useMemo(() => active ? relayRealtimeClient(url, {
+		...source === void 0 ? {} : { EventSource: source },
+		...send === void 0 ? {} : { fetch: send },
+		...timeoutMs === void 0 ? {} : { timeoutMs },
+		...maxBackoffMs === void 0 ? {} : { maxBackoffMs }
+	}) : void 0, [
+		active,
+		url,
+		source,
+		send,
+		timeoutMs,
+		maxBackoffMs
+	]);
+}
+//#endregion
 //#region src/react/search.ts
 /**
 * A search box's value, debounced. Pass `term` to `contains` (which escapes it)
@@ -976,4 +1013,4 @@ function useUpload(bucket, options = {}) {
 	};
 }
 //#endregion
-export { useController as _, usePresence as a, useActionForm as b, defineDataHooks as c, useBlockQuery as d, useRecordForm as f, useBlockTenant as g, useBlockEnv as h, useDebouncedSearch as i, useBlockEvent as l, createRecordProvider as m, useSignedUrl as n, useConflicts as o, useRecordListState as p, useUpload as r, useSyncStatus as s, useImage as t, useBlockMutation as u, useLatest as v, useAction as y };
+export { useBlockTenant as _, useRealtimeRelay as a, useAction as b, useSyncStatus as c, useBlockMutation as d, useBlockQuery as f, useBlockEnv as g, createRecordProvider as h, useDebouncedSearch as i, defineDataHooks as l, useRecordListState as m, useSignedUrl as n, usePresence as o, useRecordForm as p, useUpload as r, useConflicts as s, useImage as t, useBlockEvent as u, useController as v, useActionForm as x, useLatest as y };

package/dist/react-router/index.d.ts

@@ -1,10 +1,10 @@
 import { O as AnyFunctions, k as AnyModels } from "../types-DFdg_4yN.js";
 import { l as PermissionRef, t as AnyAuthorizer } from "../authorizer-B6X09otb.js";
-import { t as BetterSupabase } from "../define-DFBnQyYg.js";
-import { n as BetterServer } from "../server-types-7QPzW2bF.js";
+import { t as BetterSupabase } from "../define-Cgru0_kF.js";
+import { n as BetterServer } from "../server-types-gR4Q1aM0.js";
 import { a as AuthorizedContext, c as ResourceLoaderContext, i as AuthorizeOptions, l as Unwrapped, n as ActionParsed, o as BlockActionOptions, r as ActionResult, s as BlockRequireOptions } from "../kit-DOwKpSkA.js";
 import { t as RefusalRedirects } from "../refusal-CSntB_x8.js";
-import { n as FrameworkOptions, r as LocalsResource, t as FrameworkLocals } from "../framework-h5lP_5yj.js";
+import { n as FrameworkOptions, r as LocalsResource, t as FrameworkLocals } from "../framework-CF6zFU7a.js";
 import { t as Validated } from "../shared-CRRfQAKG.js";
 import { AnyEntry, Contributions } from "@supabase/middleware";
 import { StandardSchemaV1 } from "@standard-schema/spec";

package/dist/realtime/index.d.ts

@@ -1,8 +1,8 @@
 import { D as AccessTopicPolicy, E as AccessPolicySql } from "../types-DFdg_4yN.js";
-import { $ as TemplateValues, Q as TemplateParams } from "../bucket-CiNi8sIw.js";
+import { et as TemplateParams, tt as TemplateValues } from "../bucket-vc-QRrva.js";
 import { t as RealtimeStatus } from "../realtime-status-BhNkb-Ow.js";
-import { A as TriggerTopic, C as TopicSubscription, D as TriggerLookup, E as TopicTriggerValue, F as FanOutResult, I as TopicFanOutOptions, M as defineTopic, N as rowChange, O as TriggerOptions, P as rowKeys, S as TopicSubscribeOptions, T as TopicTriggerOptions, _ as TopicMessage, a as PresenceOutput, b as TopicPermission, c as RealtimeClient, d as SubscribeOptions, f as Subscription, g as TopicHandlers, h as TopicEvent, i as PresenceOptions, j as TriggerValue, k as TriggerPayloadMode, l as RowChange, m as Topic, n as PresenceInput, o as PresenceSchema, p as SubscriptionStatus, r as PresenceMember, s as PresenceSubscription, t as EventSchemas, u as RowKeys, v as TopicOptions, w as TopicTriggerLookup, x as TopicSqlOptions, y as TopicPayload } from "../topic-DNFEFGKI.js";
-import { a as watchTopic, i as topicPort, n as TopicPort, r as TopicWatch, t as TopicHandle } from "../watch-topic-Bo9S2R4P.js";
-import { _ as subjectPresenceValues, a as LiveSource, c as liveCount, d as realtimeChanges, f as SUBJECT_PRESENCE_TEMPLATE, g as subjectPresenceTopic, h as subjectPresence, i as LiveQueryOptions, l as liveQuery, m as SubjectPresenceValues, n as LiveCountOptions, o as LiveSubscription, p as SubjectPresenceTopic, r as LiveCountSeed, s as RealtimeChangesOptions, t as CountRunner, u as liveTopic } from "../index-DN9mfmhA.js";
+import { A as TriggerTopic, C as TopicSubscription, D as TriggerLookup, E as TopicTriggerValue, F as FanOutResult, I as TopicFanOutOptions, M as defineTopic, N as rowChange, O as TriggerOptions, P as rowKeys, S as TopicSubscribeOptions, T as TopicTriggerOptions, _ as TopicMessage, a as PresenceOutput, b as TopicPermission, c as RealtimeClient, d as SubscribeOptions, f as Subscription, g as TopicHandlers, h as TopicEvent, i as PresenceOptions, j as TriggerValue, k as TriggerPayloadMode, l as RowChange, m as Topic, n as PresenceInput, o as PresenceSchema, p as SubscriptionStatus, r as PresenceMember, s as PresenceSubscription, t as EventSchemas, u as RowKeys, v as TopicOptions, w as TopicTriggerLookup, x as TopicSqlOptions, y as TopicPayload } from "../topic-BtLz-qTI.js";
+import { a as watchTopic, i as topicPort, n as TopicPort, r as TopicWatch, t as TopicHandle } from "../watch-topic-tnfOTa3-.js";
+import { S as relayTopicPort, _ as subjectPresenceValues, a as LiveSource, b as RelayEventSourceConstructor, c as liveCount, d as realtimeChanges, f as SUBJECT_PRESENCE_TEMPLATE, g as subjectPresenceTopic, h as subjectPresence, i as LiveQueryOptions, l as liveQuery, m as SubjectPresenceValues, n as LiveCountOptions, o as LiveSubscription, p as SubjectPresenceTopic, r as LiveCountSeed, s as RealtimeChangesOptions, t as CountRunner, u as liveTopic, v as RelayClientOptions, x as relayRealtimeClient, y as RelayEventSource } from "../index-lB-8iPmY.js";
 import { n as subjectReaders, t as SubjectReadersOptions } from "../subject-readers-8GySC9Z8.js";
-export { type AccessPolicySql, type AccessTopicPolicy, type CountRunner, type EventSchemas, type FanOutResult, type LiveCountOptions, type LiveCountSeed, type LiveQueryOptions, type LiveSource, type LiveSubscription, type PresenceInput, type PresenceMember, type PresenceOptions, type PresenceOutput, type PresenceSchema, type PresenceSubscription, type RealtimeChangesOptions, type RealtimeClient, type RealtimeStatus, type RowChange, type RowKeys, SUBJECT_PRESENCE_TEMPLATE, type SubjectPresenceTopic, type SubjectPresenceValues, type SubjectReadersOptions, type SubscribeOptions, type Subscription, type SubscriptionStatus, type TemplateParams, type TemplateValues, type Topic, type TopicEvent, type TopicFanOutOptions, type TopicHandle, type TopicHandlers, type TopicMessage, type TopicOptions, type TopicPayload, type TopicPermission, type TopicPort, type TopicSqlOptions, type TopicSubscribeOptions, type TopicSubscription, type TopicTriggerLookup, type TopicTriggerOptions, type TopicTriggerValue, type TopicWatch, type TriggerLookup, type TriggerOptions, type TriggerPayloadMode, type TriggerTopic, type TriggerValue, defineTopic, liveCount, liveQuery, liveTopic, realtimeChanges, rowChange, rowKeys, subjectPresence, subjectPresenceTopic, subjectPresenceValues, subjectReaders, topicPort, watchTopic };
+export { type AccessPolicySql, type AccessTopicPolicy, type CountRunner, type EventSchemas, type FanOutResult, type LiveCountOptions, type LiveCountSeed, type LiveQueryOptions, type LiveSource, type LiveSubscription, type PresenceInput, type PresenceMember, type PresenceOptions, type PresenceOutput, type PresenceSchema, type PresenceSubscription, type RealtimeChangesOptions, type RealtimeClient, type RealtimeStatus, type RelayClientOptions, type RelayEventSource, type RelayEventSourceConstructor, type RowChange, type RowKeys, SUBJECT_PRESENCE_TEMPLATE, type SubjectPresenceTopic, type SubjectPresenceValues, type SubjectReadersOptions, type SubscribeOptions, type Subscription, type SubscriptionStatus, type TemplateParams, type TemplateValues, type Topic, type TopicEvent, type TopicFanOutOptions, type TopicHandle, type TopicHandlers, type TopicMessage, type TopicOptions, type TopicPayload, type TopicPermission, type TopicPort, type TopicSqlOptions, type TopicSubscribeOptions, type TopicSubscription, type TopicTriggerLookup, type TopicTriggerOptions, type TopicTriggerValue, type TopicWatch, type TriggerLookup, type TriggerOptions, type TriggerPayloadMode, type TriggerTopic, type TriggerValue, defineTopic, liveCount, liveQuery, liveTopic, realtimeChanges, relayRealtimeClient, relayTopicPort, rowChange, rowKeys, subjectPresence, subjectPresenceTopic, subjectPresenceValues, subjectReaders, topicPort, watchTopic };

package/dist/realtime/index.js

@@ -1,5 +1,6 @@
 import { i as realtimeChanges, n as liveQuery, r as liveTopic, t as liveCount } from "../live-C21DgbsD.js";
 import { n as watchTopic, t as topicPort } from "../watch-topic-CuaWfCuv.js";
+import { n as relayTopicPort, t as relayRealtimeClient } from "../relay-gKvKJ3xf.js";
 import { t as subjectReaders } from "../subject-readers-B-pQ9Mmo.js";
 import { n as rowChange, r as rowKeys, t as defineTopic } from "../topic-ikV_pLTX.js";
 //#region src/realtime/subject-presence.ts
@@ -34,4 +35,4 @@ function subjectPresenceValues(subject) {
 	} : null;
 }
 //#endregion
-export { SUBJECT_PRESENCE_TEMPLATE, defineTopic, liveCount, liveQuery, liveTopic, realtimeChanges, rowChange, rowKeys, subjectPresence, subjectPresenceTopic, subjectPresenceValues, subjectReaders, topicPort, watchTopic };
+export { SUBJECT_PRESENCE_TEMPLATE, defineTopic, liveCount, liveQuery, liveTopic, realtimeChanges, relayRealtimeClient, relayTopicPort, rowChange, rowKeys, subjectPresence, subjectPresenceTopic, subjectPresenceValues, subjectReaders, topicPort, watchTopic };

package/dist/{record-form-DB_5Ue_B.d.ts → record-form-xWvVcb86.d.ts}

@@ -1,4 +1,4 @@
-import { Sn as EntitySchema } from "./define-block-DvvcM54N.js";
+import { Sn as EntitySchema } from "./define-block-Xxw8Hroe.js";
 import { s as FormFieldType } from "./form-definition-BjEtH8BT.js";
 //#region src/records/record-form.d.ts
 /** The input a field renders: a forms block field type, or a date and time. */

package/dist/records/index.d.ts

@@ -1,13 +1,13 @@
 import { b as DbError, t as AsyncResult } from "../result-DZeA5KS6.js";
 import { $ as RecordRef } from "../types-DFdg_4yN.js";
-import { _n as recordBindingWrite, an as RecordBindingDefinition, cn as RecordBindingResult, dn as RecordBindingWriteName, fn as RecordBindingWriteOutput, gn as defineRecordBinding, hn as TimelineItem, in as RecordBindingData, ln as RecordBindingWrite, mn as RecordRowInput, nn as AnyRecordBindingWrite, on as RecordBindingOptions, pn as RecordBindingWrites, rn as RecordBinding, sn as RecordBindingPermissions, tn as AnyRecordBinding, un as RecordBindingWriteInput, vn as recordEventMatches, yn as recordRowInput } from "../define-block-DvvcM54N.js";
-import { A as BindingBlocks, B as PermissionFlags, C as defineRecordType, D as recordPermissionKeys, E as recordCan, F as LoadBindingsOptions, H as can, I as LoadedBindings, L as bindingCan, M as BindingName, N as BindingOf, O as recordSubject, P as BindingSource, R as countBinding, S as RecordWriteInput, T as plainData, U as permissionFlags, V as PermissionSet, _ as RecordTypeBlocks, b as RecordTypeWriteInput, d as BindingWritesOf, f as Plain, g as RecordType, h as RecordCan, j as BindingCheck, k as recordWriteInput, m as PlainBindings, p as PlainBinding, v as RecordTypePermissions, w as findBindingWrite, x as RecordTypeWriteOutput, y as RecordTypeSpec, z as loadBindings } from "../index-BfkltrGJ.js";
-import { p as SubscriptionStatus } from "../topic-DNFEFGKI.js";
-import { n as TopicPort } from "../watch-topic-Bo9S2R4P.js";
-import { n as Controller, t as AuthPort } from "../controller-DyPPMFSw.js";
+import { _n as recordBindingWrite, an as RecordBindingDefinition, cn as RecordBindingResult, dn as RecordBindingWriteName, fn as RecordBindingWriteOutput, gn as defineRecordBinding, hn as TimelineItem, in as RecordBindingData, ln as RecordBindingWrite, mn as RecordRowInput, nn as AnyRecordBindingWrite, on as RecordBindingOptions, pn as RecordBindingWrites, rn as RecordBinding, sn as RecordBindingPermissions, tn as AnyRecordBinding, un as RecordBindingWriteInput, vn as recordEventMatches, yn as recordRowInput } from "../define-block-Xxw8Hroe.js";
+import { A as BindingBlocks, B as PermissionFlags, C as defineRecordType, D as recordPermissionKeys, E as recordCan, F as LoadBindingsOptions, H as can, I as LoadedBindings, L as bindingCan, M as BindingName, N as BindingOf, O as recordSubject, P as BindingSource, R as countBinding, S as RecordWriteInput, T as plainData, U as permissionFlags, V as PermissionSet, _ as RecordTypeBlocks, b as RecordTypeWriteInput, d as BindingWritesOf, f as Plain, g as RecordType, h as RecordCan, j as BindingCheck, k as recordWriteInput, m as PlainBindings, p as PlainBinding, v as RecordTypePermissions, w as findBindingWrite, x as RecordTypeWriteOutput, y as RecordTypeSpec, z as loadBindings } from "../index-B8YjrfVl.js";
+import { p as SubscriptionStatus } from "../topic-BtLz-qTI.js";
+import { n as TopicPort } from "../watch-topic-tnfOTa3-.js";
+import { n as Controller, t as AuthPort } from "../controller-CJUXhshv.js";
 import { a as RecordSummaryOptions, c as Subjects, f as MyWorkKind, i as RecordSummary, n as MyWorkItem, r as MyWorkOptions } from "../subjects-BpIEN1MS.js";
-import { a as timelineBindings, c as RecordListCells, d as RecordListQuery, f as RecordListRow, h as defineRecordList, i as loadTimeline, l as RecordListColumn, m as RecordListSpec, n as Timeline, o as RecordList, p as RecordListSource, r as TimelineEntry, s as RecordListCell, t as LoadTimelineOptions, u as RecordListPage } from "../timeline-WrFMgd3U.js";
-import { a as RecordFormOptions, c as recordForm, i as RecordFormInput, n as RecordFormCustomField, o as RecordFormResult, r as RecordFormField, s as RecordFormValues, t as RecordForm } from "../record-form-DB_5Ue_B.js";
+import { a as timelineBindings, c as RecordListCells, d as RecordListQuery, f as RecordListRow, h as defineRecordList, i as loadTimeline, l as RecordListColumn, m as RecordListSpec, n as Timeline, o as RecordList, p as RecordListSource, r as TimelineEntry, s as RecordListCell, t as LoadTimelineOptions, u as RecordListPage } from "../timeline-BBfKuMVL.js";
+import { a as RecordFormOptions, c as recordForm, i as RecordFormInput, n as RecordFormCustomField, o as RecordFormResult, r as RecordFormField, s as RecordFormValues, t as RecordForm } from "../record-form-xWvVcb86.js";
 //#region src/records/controller.d.ts
 interface RecordControllerOptions<B extends BindingBlocks, N extends BindingName<B>> extends LoadBindingsOptions<B, N> {
   readonly source: BindingSource<B>;

package/dist/relay-gKvKJ3xf.js

@@ -0,0 +1,208 @@
+import { t as topicPort } from "./watch-topic-CuaWfCuv.js";
+//#region src/realtime/relay.ts
+const CLOSED_STATE = 2;
+function parse(event) {
+	if (typeof event.data !== "string") return;
+	try {
+		return JSON.parse(event.data);
+	} catch {
+		return;
+	}
+}
+/** The runtime's `EventSource`, read without assuming DOM types. */
+function globalEventSource() {
+	const value = "EventSource" in globalThis ? globalThis.EventSource : void 0;
+	return typeof value === "function" ? value : void 0;
+}
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/**
+* 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);
+* ```
+*/
+function relayRealtimeClient(url, options = {}) {
+	const channels = [];
+	const timeoutMs = options.timeoutMs ?? 15e3;
+	const maxBackoffMs = options.maxBackoffMs ?? 3e4;
+	const channelClose = /* @__PURE__ */ new WeakMap();
+	const post = async (topic, event, payload) => {
+		const doFetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+		try {
+			const response = await doFetch(url, {
+				method: "POST",
+				credentials: "same-origin",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify({
+					topic,
+					event,
+					payload
+				})
+			});
+			if (response.ok) {
+				await response.body?.cancel();
+				return { success: true };
+			}
+			const problem = await response.json().catch(() => void 0);
+			const detail = isRecord(problem) && typeof problem["detail"] === "string" ? problem["detail"] : isRecord(problem) && typeof problem["title"] === "string" ? problem["title"] : response.statusText;
+			return {
+				success: false,
+				status: response.status,
+				error: detail
+			};
+		} catch (cause) {
+			return {
+				success: false,
+				status: 0,
+				error: cause instanceof Error ? cause.message : String(cause)
+			};
+		}
+	};
+	const create = (name) => {
+		const topic = `realtime:${name}`;
+		const listeners = [];
+		let presence = {};
+		let source;
+		let status;
+		let subscribed = false;
+		let ending = false;
+		let removed = false;
+		let backoff = 1e3;
+		let joinTimer;
+		let retryTimer;
+		const dispatch = (type, event, message) => {
+			for (const listener of listeners) if (listener.event === `${type}:*` || listener.event === `${type}:${event}`) listener.callback(message);
+		};
+		const open = () => {
+			if (removed) return;
+			const Source = options.EventSource ?? globalEventSource();
+			if (Source === void 0) {
+				status?.("CHANNEL_ERROR", /* @__PURE__ */ new Error("relayRealtimeClient needs EventSource"));
+				return;
+			}
+			const next = new Source(`${url}${url.includes("?") ? "&" : "?"}topic=${encodeURIComponent(name)}`, { withCredentials: true });
+			source = next;
+			clearTimeout(joinTimer);
+			joinTimer = setTimeout(() => {
+				if (!subscribed && source === next) status?.("TIMED_OUT");
+			}, timeoutMs);
+			next.addEventListener("status", (event) => {
+				const data = parse(event);
+				if (!isRecord(data) || source !== next) return;
+				if (data["status"] === "subscribed") {
+					clearTimeout(joinTimer);
+					subscribed = true;
+					ending = false;
+					backoff = 1e3;
+					status?.("SUBSCRIBED");
+				} else if (data["status"] === "error") status?.("CHANNEL_ERROR", /* @__PURE__ */ new Error(`Realtime error on ${name}`));
+			});
+			next.addEventListener("broadcast", (event) => {
+				const data = parse(event);
+				if (!isRecord(data) || typeof data["event"] !== "string") return;
+				dispatch("broadcast", data["event"], {
+					type: "broadcast",
+					event: data["event"],
+					payload: data["payload"]
+				});
+			});
+			next.addEventListener("presence", (event) => {
+				const data = parse(event);
+				if (!isRecord(data)) return;
+				presence = Object.fromEntries(Object.entries(data).filter((entry) => Array.isArray(entry[1])));
+				dispatch("presence", "sync", {});
+			});
+			next.addEventListener("end", () => {
+				ending = true;
+			});
+			next.addEventListener("error", () => {
+				if (removed || source !== next) return;
+				if (next.readyState !== CLOSED_STATE) {
+					if (subscribed && !ending) status?.("CHANNEL_ERROR", /* @__PURE__ */ new Error(`The relay connection for ${name} dropped`));
+					return;
+				}
+				next.close();
+				source = void 0;
+				if (!subscribed) {
+					clearTimeout(joinTimer);
+					status?.("CHANNEL_ERROR", /* @__PURE__ */ new Error(`The relay refused ${name}`));
+					return;
+				}
+				status?.("CHANNEL_ERROR", /* @__PURE__ */ new Error(`The relay closed ${name}; reconnecting`));
+				retryTimer = setTimeout(open, backoff);
+				backoff = Math.min(backoff * 2, maxBackoffMs);
+			});
+		};
+		const close = () => {
+			removed = true;
+			clearTimeout(joinTimer);
+			clearTimeout(retryTimer);
+			source?.close();
+			source = void 0;
+		};
+		const channel = {
+			topic,
+			on(type, filter, callback) {
+				listeners.push({
+					event: `${type}:${filter.event ?? "*"}`,
+					callback
+				});
+				return channel;
+			},
+			subscribe(callback) {
+				if (status !== void 0 || removed) throw new Error(`tried to subscribe multiple times to ${name} on the relay`);
+				status = callback ?? (() => void 0);
+				open();
+				return channel;
+			},
+			unsubscribe: () => {
+				close();
+				status?.("CLOSED");
+				return Promise.resolve("ok");
+			},
+			presenceState: () => presence,
+			track: () => Promise.resolve("error"),
+			untrack: () => Promise.resolve("error"),
+			send: async (message) => (await post(name, message.event, message.payload)).success ? "ok" : "error",
+			httpSend: (event, payload) => post(name, event, payload)
+		};
+		channelClose.set(channel, close);
+		return channel;
+	};
+	return {
+		channel: (name) => {
+			const topic = `realtime:${name}`;
+			const open = channels.find((each) => each.topic === topic);
+			if (open) return open;
+			const channel = create(name);
+			channels.push(channel);
+			return channel;
+		},
+		getChannels: () => [...channels],
+		removeChannel: (channel) => {
+			const index = channels.indexOf(channel);
+			if (index !== -1) channels.splice(index, 1);
+			channelClose.get(channel)?.();
+			return Promise.resolve("ok");
+		},
+		realtime: { setAuth: () => Promise.resolve() }
+	};
+}
+/**
+* The block controllers' realtime port over `realtimeRelay`:
+* `topicPort(relayRealtimeClient(url, options))`.
+*/
+function relayTopicPort(url, options = {}) {
+	return topicPort(relayRealtimeClient(url, options));
+}
+//#endregion
+export { relayTopicPort as n, relayRealtimeClient as t };

package/dist/{resource-execute-CzHuDsil.d.ts → resource-execute-DqWfEc56.d.ts}

@@ -1,5 +1,5 @@
 import { n as ResourceActionSpec } from "./resource-D8pzB5Qf.js";
-import { i as ResourceContext, n as Parsed, r as ResourceAction, t as ActionArgs } from "./resource-types-DnKiH4G2.js";
+import { i as ResourceContext, n as Parsed, r as ResourceAction, t as ActionArgs } from "./resource-types-BIoz_ElD.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/server/resource-execute.d.ts
 /**

package/dist/{resource-types-DnKiH4G2.d.ts → resource-types-BIoz_ElD.d.ts}

@@ -1,6 +1,6 @@
 import { D as ValidationIssue, f as Result } from "./result-DZeA5KS6.js";
 import { Ft as RequestContext, K as Insert, dt as TableMeta, ht as Update, it as Row, k as AnyModels, ut as TableKey } from "./types-DFdg_4yN.js";
-import { Wt as SelectArg } from "./define-DFBnQyYg.js";
+import { Wt as SelectArg } from "./define-Cgru0_kF.js";
 import { a as RespondOptions } from "./respond-Dn1_YhC1.js";
 import { D as ResourceOperation, k as TableVerb } from "./model-hwpvole9.js";
 import { a as ResourcePlan, i as ResourcePagination, n as ResourceActionSpec, r as ResourceDescription } from "./resource-D8pzB5Qf.js";

package/dist/{resources-B9cQxhjw.d.ts → resources-Bt2PDKE7.d.ts}

@@ -1,5 +1,5 @@
 import { k as AnyModels, ut as TableKey } from "./types-DFdg_4yN.js";
-import { l as ResourceRouteOptions } from "./resource-types-DnKiH4G2.js";
+import { l as ResourceRouteOptions } from "./resource-types-BIoz_ElD.js";
 //#region src/server/resources.d.ts
 /** Resources by table name; `true` serves a table with the defaults. */
 type ResourceMap<M extends AnyModels, Ref = string, DbT = unknown> = { readonly [T in TableKey<M>]?: ResourceRouteOptions<M, T, Ref, DbT> | true; };