orpc-fn 0.4.0 → 0.5.1

package/dist/live/scoped-change-bus.d.ts

@@ -0,0 +1,45 @@
+import type { ZodType, z } from 'zod';
+import type { AnyFnContext, FnDefinition, FnRouteOptions, GuardOptions, ProcedureKey, ProcedureOption } from '../types.js';
+import type { CreatePubSub, ObjectSchema, PubSub, PubSubOptions } from './pub-sub.js';
+/** Where a change bus partitions its channels, e.g. one per organization. */
+export type ChangeBusScope<TContext, TEvent> = {
+    /** The subscriber's scope key, from its context. Throw to refuse the subscription. */
+    subscribe: (context: TContext) => string;
+    /** The event's scope key, carried in the event itself. */
+    publish: (event: TEvent) => string;
+};
+/** A bus's channel definition; pass it to `fnLive` to share the bus's events. */
+export type ChangeBusChannel<TContext, TEvent> = {
+    subscribe: (params: {
+        context: TContext;
+    }) => string;
+    publish: (event: TEvent) => string;
+};
+export type ScopedChangeBus<TDef extends FnDefinition, TInputSchema extends ObjectSchema, TEventSchema extends ZodType, TKey extends ProcedureKey<TDef>, TScopeEvent> = PubSub<TDef, TInputSchema, TEventSchema, TKey> & {
+    channel: ChangeBusChannel<AnyFnContext<TDef>, TScopeEvent>;
+};
+/**
+ * Binds the app's `createPubSub` to one scope rule, for buses that tell every
+ * subscriber in a scope "something changed". Each bus then names only its
+ * channel prefix: events go to `${prefix}:${scope}`. Publishing is safe by
+ * default (`safePublish: true`), because buses publish after committed writes.
+ *
+ * ```ts
+ * const defineChangeBus = defineScopedChangeBus(createPubSub, {
+ *   subscribe: (context) => activeOrganizationId(context),
+ *   publish: (event: { organizationId: string }) => event.organizationId
+ * })
+ * export const dealChanges = defineChangeBus({
+ *   name: 'deal.subscribe',
+ *   prefix: 'deal:change',
+ *   inputSchema: z.object({}),
+ *   eventSchema: z.object({ organizationId: z.string(), dealId: z.string() })
+ * })
+ * // fnLive({ live: { channel: dealChanges.channel, ... } }) shares the channel.
+ * ```
+ */
+export declare function defineScopedChangeBus<TDef extends FnDefinition, TScopeEvent>(createPubSub: CreatePubSub<TDef>, scope: ChangeBusScope<AnyFnContext<TDef>, TScopeEvent>): <TInputSchema extends ObjectSchema, TEventSchema extends ZodType<TScopeEvent>, TKey extends ProcedureKey<TDef> = TDef['default']>(options: Omit<PubSubOptions<TDef, TInputSchema, TEventSchema, NoInfer<TKey>>, 'channel'> & GuardOptions<TDef['guards']> & Pick<FnRouteOptions<TDef, TKey, z.output<TInputSchema>>, 'meta' | 'guardResolvers'> & ProcedureOption<TDef, TKey> & {
+    /** Channel prefix; the scope key is appended as `${prefix}:${scope}`. */
+    prefix: string;
+}) => ScopedChangeBus<TDef, TInputSchema, TEventSchema, TKey, TScopeEvent>;
+//# sourceMappingURL=scoped-change-bus.d.ts.map

package/dist/live/scoped-change-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-change-bus.d.ts","sourceRoot":"","sources":["../../src/live/scoped-change-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACrC,OAAO,KAAK,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EACX,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,aAAa,EACb,MAAM,cAAc,CAAA;AAErB,6EAA6E;AAC7E,MAAM,MAAM,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI;IAC9C,sFAAsF;IACtF,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,MAAM,CAAA;IACxC,0DAA0D;IAC1D,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CAClC,CAAA;AAED,iFAAiF;AACjF,MAAM,MAAM,gBAAgB,CAAC,QAAQ,EAAE,MAAM,IAAI;IAChD,SAAS,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,QAAQ,CAAA;KAAE,KAAK,MAAM,CAAA;IACpD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,eAAe,CAC1B,IAAI,SAAS,YAAY,EACzB,YAAY,SAAS,YAAY,EACjC,YAAY,SAAS,OAAO,EAC5B,IAAI,SAAS,YAAY,CAAC,IAAI,CAAC,EAC/B,WAAW,IACR,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,CAAC,GAAG;IACpD,OAAO,EAAE,gBAAgB,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAA;CAC1D,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,SAAS,YAAY,EAAE,WAAW,EAC3E,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,EAChC,KAAK,EAAE,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,IAGrD,YAAY,SAAS,YAAY,EACjC,YAAY,SAAS,OAAO,CAAC,WAAW,CAAC,EACzC,IAAI,SAAS,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,WAExC,IAAI,CACZ,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,EAC9D,SAAS,CACT,GACA,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAC5B,IAAI,CACH,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAClD,MAAM,GAAG,gBAAgB,CACzB,GACD,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG;IAC7B,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAA;CACd,KACA,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,CAAC,CAevE"}

package/dist/live/scoped-change-bus.js

@@ -0,0 +1,38 @@
+/**
+ * Binds the app's `createPubSub` to one scope rule, for buses that tell every
+ * subscriber in a scope "something changed". Each bus then names only its
+ * channel prefix: events go to `${prefix}:${scope}`. Publishing is safe by
+ * default (`safePublish: true`), because buses publish after committed writes.
+ *
+ * ```ts
+ * const defineChangeBus = defineScopedChangeBus(createPubSub, {
+ *   subscribe: (context) => activeOrganizationId(context),
+ *   publish: (event: { organizationId: string }) => event.organizationId
+ * })
+ * export const dealChanges = defineChangeBus({
+ *   name: 'deal.subscribe',
+ *   prefix: 'deal:change',
+ *   inputSchema: z.object({}),
+ *   eventSchema: z.object({ organizationId: z.string(), dealId: z.string() })
+ * })
+ * // fnLive({ live: { channel: dealChanges.channel, ... } }) shares the channel.
+ * ```
+ */
+export function defineScopedChangeBus(createPubSub, scope) {
+    return (options) => {
+        const { prefix, ...pubsubOptions } = options;
+        const channel = {
+            subscribe: ({ context }) => `${prefix}:${scope.subscribe(context)}`,
+            publish: (event) => `${prefix}:${scope.publish(event)}`
+        };
+        // The bus's context is one member of AnyFnContext, which the generic
+        // signature of createPubSub cannot see.
+        const bus = createPubSub({
+            safePublish: true,
+            ...pubsubOptions,
+            channel
+        });
+        return { ...bus, channel };
+    };
+}
+//# sourceMappingURL=scoped-change-bus.js.map

package/dist/live/scoped-change-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-change-bus.js","sourceRoot":"","sources":["../../src/live/scoped-change-bus.ts"],"names":[],"mappings":"AAwCA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,qBAAqB,CACpC,YAAgC,EAChC,KAAsD;IAEtD,OAAO,CAKN,OAYE,EACqE,EAAE;QACzE,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAA;QAC5C,MAAM,OAAO,GAAsD;YAClE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;YACnE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;SACvD,CAAA;QACD,qEAAqE;QACrE,wCAAwC;QACxC,MAAM,GAAG,GAAI,YAA4C,CAAC;YACzD,WAAW,EAAE,IAAI;YACjB,GAAG,aAAa;YAChB,OAAO;SACP,CAAmD,CAAA;QACpD,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,CAAA;IAC3B,CAAC,CAAA;AACF,CAAC","sourcesContent":["import type { ZodType, z } from 'zod'\nimport type {\n\tAnyFnContext,\n\tFnDefinition,\n\tFnRouteOptions,\n\tGuardOptions,\n\tProcedureKey,\n\tProcedureOption\n} from '../types.js'\nimport type {\n\tCreatePubSub,\n\tObjectSchema,\n\tPubSub,\n\tPubSubOptions\n} from './pub-sub.js'\n\n/** Where a change bus partitions its channels, e.g. one per organization. */\nexport type ChangeBusScope<TContext, TEvent> = {\n\t/** The subscriber's scope key, from its context. Throw to refuse the subscription. */\n\tsubscribe: (context: TContext) => string\n\t/** The event's scope key, carried in the event itself. */\n\tpublish: (event: TEvent) => string\n}\n\n/** A bus's channel definition; pass it to `fnLive` to share the bus's events. */\nexport type ChangeBusChannel<TContext, TEvent> = {\n\tsubscribe: (params: { context: TContext }) => string\n\tpublish: (event: TEvent) => string\n}\n\nexport type ScopedChangeBus<\n\tTDef extends FnDefinition,\n\tTInputSchema extends ObjectSchema,\n\tTEventSchema extends ZodType,\n\tTKey extends ProcedureKey<TDef>,\n\tTScopeEvent\n> = PubSub<TDef, TInputSchema, TEventSchema, TKey> & {\n\tchannel: ChangeBusChannel<AnyFnContext<TDef>, TScopeEvent>\n}\n\n/**\n * Binds the app's `createPubSub` to one scope rule, for buses that tell every\n * subscriber in a scope \"something changed\". Each bus then names only its\n * channel prefix: events go to `${prefix}:${scope}`. Publishing is safe by\n * default (`safePublish: true`), because buses publish after committed writes.\n *\n * ```ts\n * const defineChangeBus = defineScopedChangeBus(createPubSub, {\n *   subscribe: (context) => activeOrganizationId(context),\n *   publish: (event: { organizationId: string }) => event.organizationId\n * })\n * export const dealChanges = defineChangeBus({\n *   name: 'deal.subscribe',\n *   prefix: 'deal:change',\n *   inputSchema: z.object({}),\n *   eventSchema: z.object({ organizationId: z.string(), dealId: z.string() })\n * })\n * // fnLive({ live: { channel: dealChanges.channel, ... } }) shares the channel.\n * ```\n */\nexport function defineScopedChangeBus<TDef extends FnDefinition, TScopeEvent>(\n\tcreatePubSub: CreatePubSub<TDef>,\n\tscope: ChangeBusScope<AnyFnContext<TDef>, TScopeEvent>\n) {\n\treturn <\n\t\tTInputSchema extends ObjectSchema,\n\t\tTEventSchema extends ZodType<TScopeEvent>,\n\t\tTKey extends ProcedureKey<TDef> = TDef['default']\n\t>(\n\t\toptions: Omit<\n\t\t\tPubSubOptions<TDef, TInputSchema, TEventSchema, NoInfer<TKey>>,\n\t\t\t'channel'\n\t\t> &\n\t\t\tGuardOptions<TDef['guards']> &\n\t\t\tPick<\n\t\t\t\tFnRouteOptions<TDef, TKey, z.output<TInputSchema>>,\n\t\t\t\t'meta' | 'guardResolvers'\n\t\t\t> &\n\t\t\tProcedureOption<TDef, TKey> & {\n\t\t\t\t/** Channel prefix; the scope key is appended as `${prefix}:${scope}`. */\n\t\t\t\tprefix: string\n\t\t\t}\n\t): ScopedChangeBus<TDef, TInputSchema, TEventSchema, TKey, TScopeEvent> => {\n\t\tconst { prefix, ...pubsubOptions } = options\n\t\tconst channel: ChangeBusChannel<AnyFnContext<TDef>, TScopeEvent> = {\n\t\t\tsubscribe: ({ context }) => `${prefix}:${scope.subscribe(context)}`,\n\t\t\tpublish: (event) => `${prefix}:${scope.publish(event)}`\n\t\t}\n\t\t// The bus's context is one member of AnyFnContext, which the generic\n\t\t// signature of createPubSub cannot see.\n\t\tconst bus = (createPubSub as (options: object) => object)({\n\t\t\tsafePublish: true,\n\t\t\t...pubsubOptions,\n\t\t\tchannel\n\t\t}) as PubSub<TDef, TInputSchema, TEventSchema, TKey>\n\t\treturn { ...bus, channel }\n\t}\n}\n"]}

package/dist/live/transport.d.ts

@@ -3,6 +3,15 @@ export type PubSubMessage = {
     channel: string;
     payload: string;
 };
+/** What a transport holds open on this instance, for gauges and health checks. */
+export type PubSubTransportStats = {
+    /** Broker channels subscribed (one per channel, however many listeners). */
+    channels: number;
+    /** Local listeners across those channels. */
+    listeners: number;
+    /** The subscriber connection is open; false before the first subscribe. */
+    subscriberConnected: boolean;
+};
 export type BacklogOptions = {
     /** Items kept per channel (oldest dropped). */
     size: number;
@@ -34,6 +43,8 @@ export interface PubSubTransport {
     subscribe(channel: string, listener: (payload: string) => void, onLost?: (error: Error) => void, options?: {
         onReconnect?: () => void;
     }): Promise<() => Promise<void>>;
+    /** Current subscription counts and connection state. */
+    stats?(): PubSubTransportStats;
 }
 export declare const backlogKey: (channel: string) => string;
 //# sourceMappingURL=transport.d.ts.map

package/dist/live/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/live/transport.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhE,MAAM,MAAM,cAAc,GAAG;IAC5B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC;;;;OAIG;IACH,OAAO,CACN,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAAA;IAChB,2CAA2C;IAC3C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC/C;;;;OAIG;IACH,SAAS,CACR,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACnC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAC/B,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GACpC,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;CAC/B;AAED,eAAO,MAAM,UAAU,YAAa,MAAM,WAAyB,CAAA"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/live/transport.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhE,kFAAkF;AAClF,MAAM,MAAM,oBAAoB,GAAG;IAClC,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAA;IAChB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,2EAA2E;IAC3E,mBAAmB,EAAE,OAAO,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC5B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC;;;;OAIG;IACH,OAAO,CACN,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAAA;IAChB,2CAA2C;IAC3C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC/C;;;;OAIG;IACH,SAAS,CACR,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACnC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAC/B,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GACpC,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAC/B,wDAAwD;IACxD,KAAK,CAAC,IAAI,oBAAoB,CAAA;CAC9B;AAED,eAAO,MAAM,UAAU,YAAa,MAAM,WAAyB,CAAA"}

package/dist/live/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/live/transport.ts"],"names":[],"mappings":"AA2CA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,GAAG,OAAO,UAAU,CAAA","sourcesContent":["/** One payload for one channel. */\nexport type PubSubMessage = { channel: string; payload: string }\n\nexport type BacklogOptions = {\n\t/** Items kept per channel (oldest dropped). */\n\tsize: number\n\t/** Seconds the backlog lives after its last write. */\n\tttlSeconds: number\n}\n\n/**\n * The broker behind `createPubSub` / `fnLive`. Implementations:\n * `orpc-fn/live/redis-bun`, `orpc-fn/live/ioredis` and `orpc-fn/live/memory`.\n *\n * The backlog of a channel lives at `${channel}:backlog` (see {@link backlogKey}).\n */\nexport interface PubSubTransport {\n\t/** Optional disposal, used only with ownsTransport: true. */\n\tclose?: () => void | Promise<void>\n\t/**\n\t * Publish every message, in order. With `backlog`, also append each payload\n\t * to its channel's backlog, trim and refresh its TTL - atomically, so a\n\t * message is never published without its backlog entry or vice versa.\n\t */\n\tpublish(\n\t\tmessages: readonly PubSubMessage[],\n\t\tbacklog?: BacklogOptions\n\t): Promise<void>\n\t/** The channel's backlog, oldest first. */\n\treadBacklog(channel: string): Promise<string[]>\n\t/**\n\t * Deliver every payload published to `channel` until the returned function\n\t * is called. `onLost` fires when the subscription can no longer deliver\n\t * (connection closed for good); the caller resubscribes.\n\t */\n\tsubscribe(\n\t\tchannel: string,\n\t\tlistener: (payload: string) => void,\n\t\tonLost?: (error: Error) => void,\n\t\toptions?: { onReconnect?: () => void }\n\t): Promise<() => Promise<void>>\n}\n\nexport const backlogKey = (channel: string) => `${channel}:backlog`\n"]}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/live/transport.ts"],"names":[],"mappings":"AAuDA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,GAAG,OAAO,UAAU,CAAA","sourcesContent":["/** One payload for one channel. */\nexport type PubSubMessage = { channel: string; payload: string }\n\n/** What a transport holds open on this instance, for gauges and health checks. */\nexport type PubSubTransportStats = {\n\t/** Broker channels subscribed (one per channel, however many listeners). */\n\tchannels: number\n\t/** Local listeners across those channels. */\n\tlisteners: number\n\t/** The subscriber connection is open; false before the first subscribe. */\n\tsubscriberConnected: boolean\n}\n\nexport type BacklogOptions = {\n\t/** Items kept per channel (oldest dropped). */\n\tsize: number\n\t/** Seconds the backlog lives after its last write. */\n\tttlSeconds: number\n}\n\n/**\n * The broker behind `createPubSub` / `fnLive`. Implementations:\n * `orpc-fn/live/redis-bun`, `orpc-fn/live/ioredis` and `orpc-fn/live/memory`.\n *\n * The backlog of a channel lives at `${channel}:backlog` (see {@link backlogKey}).\n */\nexport interface PubSubTransport {\n\t/** Optional disposal, used only with ownsTransport: true. */\n\tclose?: () => void | Promise<void>\n\t/**\n\t * Publish every message, in order. With `backlog`, also append each payload\n\t * to its channel's backlog, trim and refresh its TTL - atomically, so a\n\t * message is never published without its backlog entry or vice versa.\n\t */\n\tpublish(\n\t\tmessages: readonly PubSubMessage[],\n\t\tbacklog?: BacklogOptions\n\t): Promise<void>\n\t/** The channel's backlog, oldest first. */\n\treadBacklog(channel: string): Promise<string[]>\n\t/**\n\t * Deliver every payload published to `channel` until the returned function\n\t * is called. `onLost` fires when the subscription can no longer deliver\n\t * (connection closed for good); the caller resubscribes.\n\t */\n\tsubscribe(\n\t\tchannel: string,\n\t\tlistener: (payload: string) => void,\n\t\tonLost?: (error: Error) => void,\n\t\toptions?: { onReconnect?: () => void }\n\t): Promise<() => Promise<void>>\n\t/** Current subscription counts and connection state. */\n\tstats?(): PubSubTransportStats\n}\n\nexport const backlogKey = (channel: string) => `${channel}:backlog`\n"]}

package/dist/procedure-cli.d.ts

@@ -0,0 +1,25 @@
+import { type CommandGroup } from 'hanzio/cli';
+import { type FnMeta } from './meta.js';
+export type ProcedureCommandsOptions<C> = {
+    /**
+     * Which procedures become commands. Default: those declared with
+     * `meta: { cli: true }` (add `cli?: boolean` to the app's meta type).
+     */
+    filter?: (meta: FnMeta) => boolean;
+    /**
+     * The oRPC context a command calls its procedure with, from the CLI's
+     * context (`defineCli({ context })`). Default: that context as-is. It gets
+     * the procedure's meta, so it can refuse early with a `CliError`, e.g. a
+     * protected procedure run without a user.
+     */
+    context?: (cliContext: C, meta: FnMeta) => unknown;
+};
+/**
+ * The opted-in `fn()` procedures of a router as hanzio/cli commands, nested
+ * like the router: `supportLearning.syncRun` is `support-learning sync-run`.
+ * Flags come from the procedure's input schema, help from its summary. A
+ * command calls the procedure through oRPC, so middleware, guards, tracing
+ * and errors run as they do over HTTP.
+ */
+export declare function procedureCommands<C = unknown>(router: object, options?: ProcedureCommandsOptions<C>): CommandGroup<C>;
+//# sourceMappingURL=procedure-cli.d.ts.map

package/dist/procedure-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure-cli.d.ts","sourceRoot":"","sources":["../src/procedure-cli.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,KAAK,YAAY,EAEjB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,KAAK,MAAM,EAAc,MAAM,WAAW,CAAA;AAEnD,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI;IACzC;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IAClC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CAClD,CAAA;AAOD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC5C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,wBAAwB,CAAC,CAAC,CAAM,GACvC,YAAY,CAAC,CAAC,CAAC,CAejB"}

package/dist/procedure-cli.js

@@ -0,0 +1,67 @@
+import { call, isProcedure, ORPCError } from '@orpc/server';
+import { CliError, defineCommand } from 'hanzio/cli';
+import { z } from 'zod';
+import { readFnMeta } from './meta.js';
+const optedIn = (meta) => meta.meta.cli === true;
+const kebab = (key) => key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+/**
+ * The opted-in `fn()` procedures of a router as hanzio/cli commands, nested
+ * like the router: `supportLearning.syncRun` is `support-learning sync-run`.
+ * Flags come from the procedure's input schema, help from its summary. A
+ * command calls the procedure through oRPC, so middleware, guards, tracing
+ * and errors run as they do over HTTP.
+ */
+export function procedureCommands(router, options = {}) {
+    const filter = options.filter ?? optedIn;
+    const commands = {};
+    for (const [key, value] of Object.entries(router)) {
+        if (isProcedure(value)) {
+            const meta = readFnMeta(value);
+            if (filter(meta))
+                commands[kebab(key)] = toCommand(value, meta, options);
+        }
+        else if (value && typeof value === 'object') {
+            const group = procedureCommands(value, options);
+            if (Object.keys(group).length > 0)
+                commands[kebab(key)] = group;
+        }
+    }
+    return commands;
+}
+function toCommand(procedure, meta, options) {
+    const name = meta.name ?? 'procedure';
+    if (meta.stream) {
+        throw new TypeError(`orpc-fn: ${name} streams and cannot be a CLI command`);
+    }
+    const input = meta.inputSchema;
+    if (input !== undefined && !(input instanceof z.ZodObject)) {
+        throw new TypeError(`orpc-fn: ${name} must take a z.object() input to be a CLI command`);
+    }
+    return defineCommand({
+        description: meta.description,
+        input: input ?? z.object({}),
+        run: async (parsed, ctx) => {
+            const context = options.context
+                ? await options.context(ctx.context, meta)
+                : ctx.context;
+            try {
+                // The flags were validated against this schema; the procedure parses
+                // them again, like any nested call with a parsed value.
+                return await call(procedure, input ? parsed : undefined, {
+                    context: context
+                });
+            }
+            catch (error) {
+                // A refusal the caller drives (auth, permission, not found) reads as
+                // a message, not a crash with a stack trace.
+                if (error instanceof ORPCError && error.status < 500) {
+                    throw new CliError(`${error.code}: ${error.message}`, {
+                        cause: error
+                    });
+                }
+                throw error;
+            }
+        }
+    });
+}
+//# sourceMappingURL=procedure-cli.js.map

package/dist/procedure-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure-cli.js","sourceRoot":"","sources":["../src/procedure-cli.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyProcedure, call, isProcedure, ORPCError } from '@orpc/server'\nimport {\n\tCliError,\n\ttype Command,\n\ttype CommandGroup,\n\tdefineCommand\n} from 'hanzio/cli'\nimport { z } from 'zod'\nimport { type FnMeta, readFnMeta } from './meta.js'\n\nexport type ProcedureCommandsOptions<C> = {\n\t/**\n\t * Which procedures become commands. Default: those declared with\n\t * `meta: { cli: true }` (add `cli?: boolean` to the app's meta type).\n\t */\n\tfilter?: (meta: FnMeta) => boolean\n\t/**\n\t * The oRPC context a command calls its procedure with, from the CLI's\n\t * context (`defineCli({ context })`). Default: that context as-is. It gets\n\t * the procedure's meta, so it can refuse early with a `CliError`, e.g. a\n\t * protected procedure run without a user.\n\t */\n\tcontext?: (cliContext: C, meta: FnMeta) => unknown\n}\n\nconst optedIn = (meta: FnMeta) => (meta.meta as { cli?: unknown }).cli === true\n\nconst kebab = (key: string) =>\n\tkey.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)\n\n/**\n * The opted-in `fn()` procedures of a router as hanzio/cli commands, nested\n * like the router: `supportLearning.syncRun` is `support-learning sync-run`.\n * Flags come from the procedure's input schema, help from its summary. A\n * command calls the procedure through oRPC, so middleware, guards, tracing\n * and errors run as they do over HTTP.\n */\nexport function procedureCommands<C = unknown>(\n\trouter: object,\n\toptions: ProcedureCommandsOptions<C> = {}\n): CommandGroup<C> {\n\tconst filter = options.filter ?? optedIn\n\tconst commands: Record<string, Command<C> | CommandGroup<C>> = {}\n\n\tfor (const [key, value] of Object.entries(router)) {\n\t\tif (isProcedure(value)) {\n\t\t\tconst meta = readFnMeta(value)\n\t\t\tif (filter(meta)) commands[kebab(key)] = toCommand(value, meta, options)\n\t\t} else if (value && typeof value === 'object') {\n\t\t\tconst group = procedureCommands(value, options)\n\t\t\tif (Object.keys(group).length > 0) commands[kebab(key)] = group\n\t\t}\n\t}\n\n\treturn commands\n}\n\nfunction toCommand<C>(\n\tprocedure: AnyProcedure,\n\tmeta: FnMeta,\n\toptions: ProcedureCommandsOptions<C>\n): Command<C> {\n\tconst name = meta.name ?? 'procedure'\n\tif (meta.stream) {\n\t\tthrow new TypeError(`orpc-fn: ${name} streams and cannot be a CLI command`)\n\t}\n\tconst input = meta.inputSchema\n\tif (input !== undefined && !(input instanceof z.ZodObject)) {\n\t\tthrow new TypeError(\n\t\t\t`orpc-fn: ${name} must take a z.object() input to be a CLI command`\n\t\t)\n\t}\n\n\treturn defineCommand<z.ZodObject, unknown, C>({\n\t\tdescription: meta.description,\n\t\tinput: input ?? z.object({}),\n\t\trun: async (parsed, ctx) => {\n\t\t\tconst context = options.context\n\t\t\t\t? await options.context(ctx.context, meta)\n\t\t\t\t: ctx.context\n\t\t\ttry {\n\t\t\t\t// The flags were validated against this schema; the procedure parses\n\t\t\t\t// them again, like any nested call with a parsed value.\n\t\t\t\treturn await call(procedure, input ? parsed : undefined, {\n\t\t\t\t\tcontext: context as Record<never, never>\n\t\t\t\t})\n\t\t\t} catch (error) {\n\t\t\t\t// A refusal the caller drives (auth, permission, not found) reads as\n\t\t\t\t// a message, not a crash with a stack trace.\n\t\t\t\tif (error instanceof ORPCError && error.status < 500) {\n\t\t\t\t\tthrow new CliError(`${error.code}: ${error.message}`, {\n\t\t\t\t\t\tcause: error\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t\tthrow error\n\t\t\t}\n\t\t}\n\t})\n}\n"]}

package/dist/react.d.ts

@@ -0,0 +1,116 @@
+import { type QueryKey, type UseQueryOptions, type UseQueryResult } from '@tanstack/react-query';
+import { type InvalidationStreamOptions, type LiveConnectionStatus } from './realtime.js';
+export type { InvalidationDomain, LiveConnectionStatus } from './realtime.js';
+/** An oRPC client procedure fits: `client.order.watch`. */
+export type SubscribeFn<TInput, TEvent> = (input: TInput, options: {
+    signal: AbortSignal;
+}) => Promise<AsyncIterable<TEvent>>;
+export type UseOrpcSubscriptionOptions<TInput, TEvent> = {
+    /** Run the stream (default: true). */
+    enabled?: boolean | undefined;
+    onEvent?: (event: TEvent, meta: {
+        connectionId: number;
+        input: TInput;
+    }) => void;
+    /** Every successful connect; `connectionId > 1` is a reconnect. */
+    onConnect?: (connectionId: number) => void;
+    onError?: ((error: Error) => void) | undefined;
+    onClose?: () => void;
+    /**
+     * Close the stream while the app is not focused (default: true). Focus is
+     * TanStack's `focusManager`: on React Native, wire it to `AppState` once.
+     */
+    pauseWhenUnfocused?: boolean | undefined;
+};
+/**
+ * An oRPC event iterator with backoff reconnects that closes while the app is
+ * backgrounded. A changed input (compared as JSON) reconnects with a fresh
+ * retry budget.
+ */
+export declare function useOrpcSubscription<TInput, TEvent>(input: TInput, subscribe: SubscribeFn<TInput, TEvent>, options?: UseOrpcSubscriptionOptions<TInput, TEvent>): {
+    status: LiveConnectionStatus;
+};
+type ApplyEvent<TStreamEvent, TData> = (event: TStreamEvent, previous: TData | undefined) => TData | undefined;
+type LiveQueryOptions<TInput, TRouteData, TStreamEvent, TData, TSubscriptionInput> = {
+    /** Run the query and its stream (default: true). */
+    enabled?: boolean | undefined;
+    /** Input for the stream when it differs from the query's. */
+    subscriptionInput?: TSubscriptionInput | undefined;
+    /**
+     * Convert the route output once at fetch time into a differently typed
+     * cache; `applyEvent` then reduces stream events into that cache.
+     */
+    select?: (data: TRouteData) => TData;
+    /** The raw route output of a seed, before `select` drops fields. */
+    onSeed?: (data: TRouteData, input: TInput) => void;
+    /**
+     * Fold a stream event into the cached data. Required when the stream sends
+     * something other than the cached type (an `fnLive` patch route, or a
+     * `select`ed cache). Return `undefined` to skip the write.
+     */
+    applyEvent?: ApplyEvent<TStreamEvent, NoInfer<TData>>;
+    onEvent?: (event: TStreamEvent, meta: {
+        connectionId: number;
+    }) => void;
+    onError?: ((error: Error) => void) | undefined;
+    /**
+     * Reconcile a fetched seed with what the stream already wrote. The HTTP
+     * request can resolve last, so a plain overwrite would drop events that
+     * arrived while it was in flight. Default: take the fetched value.
+     */
+    mergeSeed?: (fetched: NoInfer<TData>, cached: NoInfer<TData> | undefined) => NoInfer<TData>;
+    /** Show the previous key's data while a new key loads (default: true). */
+    keepPreviousData?: boolean;
+    /** Close the stream while the app is not focused (default: true). */
+    pauseWhenUnfocused?: boolean | undefined;
+};
+type LiveQueryOptionsFn<TInput, TData, TError> = (input: TInput) => UseQueryOptions<TData, TError, TData, QueryKey>;
+type LiveQueryResult<TData, TError> = UseQueryResult<TData, TError> & {
+    liveStatus: LiveConnectionStatus;
+};
+/**
+ * The client half of `fnLive`: the HTTP query seeds the cache, and the live
+ * route's stream writes each snapshot into the same cache entry. Marked
+ * `meta.live`, so invalidation streams leave it alone.
+ *
+ * ```tsx
+ * const order = useLiveQuery({ id }, (input) => orpc.order.get.queryOptions({ input }), client.order.watch)
+ * ```
+ *
+ * One signature, not overloads: TypeScript fixes an untyped callback's
+ * parameters at the first overload it tries, which made valid calls fail.
+ */
+export declare function useLiveQuery<TInput, TRouteData, TStreamEvent, TData = TRouteData, TError = Error, TSubscriptionInput = TInput>(input: TInput, queryOptionsFn: LiveQueryOptionsFn<TInput, TRouteData, TError>, subscribe: SubscribeFn<NoInfer<TSubscriptionInput>, TStreamEvent>, ...options: [TStreamEvent] extends [TData] ? [
+    options?: LiveQueryOptions<TInput, TRouteData, TStreamEvent, TData, TSubscriptionInput>
+] : [
+    options: LiveQueryOptions<TInput, TRouteData, TStreamEvent, TData, TSubscriptionInput> & {
+        applyEvent: ApplyEvent<TStreamEvent, NoInfer<TData>>;
+    }
+]): LiveQueryResult<TData, TError>;
+/**
+ * One app-wide stream of `{ domain }` change events that keeps list and count
+ * queries fresh: each event invalidates its domain's query keys (debounced),
+ * and a reconnect that proves healthy invalidates every domain to cover
+ * events lost while it was down. Mount once, in the signed-in shell.
+ *
+ * ```ts
+ * useInvalidationStream({}, client.realtime.subscribeChanges, {
+ *   enabled: signedIn,
+ *   domains: { order: { debounceMs: 100, queryKeys: [orpc.order.key()] } }
+ * })
+ * ```
+ */
+export declare function useInvalidationStream<TInput, TEvent extends {
+    domain: string;
+}>(input: TInput, subscribe: SubscribeFn<TInput, TEvent>, options: InvalidationStreamOptions<TEvent> & Pick<UseOrpcSubscriptionOptions<TInput, TEvent>, 'enabled' | 'pauseWhenUnfocused'>): {
+    status: LiveConnectionStatus;
+};
+/**
+ * Clear the query cache when the signed-in owner of the cached data changes
+ * (another user, another organization), so the next one never sees it.
+ * `null` means signed out: signing in starts from the cache sign-out emptied.
+ * Pass the same owner as the persister's `buster` so a saved cache from
+ * someone else is discarded on the next launch too.
+ */
+export declare function useQueryCacheOwner(owner: string | null): void;
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"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"}

package/dist/react.js

@@ -0,0 +1,156 @@
+import { focusManager, hashKey, keepPreviousData, useQuery, useQueryClient } from '@tanstack/react-query';
+import { useEffect, useRef, useState, useSyncExternalStore } from 'react';
+import { createInvalidationCoordinator, createStreamScope, createSubscriptionRunner, seedQueryFn } from './realtime.js';
+const subscribeFocus = (listener) => focusManager.subscribe(listener);
+const getFocus = () => focusManager.isFocused();
+/** Whether the app is focused, from TanStack's `focusManager`. */
+function useIsFocused() {
+    return useSyncExternalStore(subscribeFocus, getFocus, getFocus);
+}
+/**
+ * An oRPC event iterator with backoff reconnects that closes while the app is
+ * backgrounded. A changed input (compared as JSON) reconnects with a fresh
+ * retry budget.
+ */
+export function useOrpcSubscription(input, subscribe, options = {}) {
+    const { enabled = true, pauseWhenUnfocused = true } = options;
+    const focused = useIsFocused();
+    const shouldRun = enabled && (!pauseWhenUnfocused || focused);
+    const [status, setStatus] = useState('idle');
+    const latest = useRef({ input, subscribe, options, shouldRun });
+    latest.current = { input, subscribe, options, shouldRun };
+    const runnerRef = useRef(null);
+    if (!runnerRef.current) {
+        let openedInput = input;
+        runnerRef.current = createSubscriptionRunner({
+            open: (signal) => {
+                openedInput = latest.current.input;
+                return latest.current.subscribe(openedInput, { signal });
+            },
+            canConnect: () => latest.current.shouldRun,
+            shouldReconnect: () => latest.current.shouldRun,
+            onStatus: setStatus,
+            onEvent: (event, connectionId) => latest.current.options.onEvent?.(event, {
+                connectionId,
+                input: openedInput
+            }),
+            onConnect: (id) => latest.current.options.onConnect?.(id),
+            onError: (error) => latest.current.options.onError?.(error),
+            onClose: () => latest.current.options.onClose?.()
+        });
+    }
+    const runner = runnerRef.current;
+    const serializedInput = JSON.stringify(input);
+    // biome-ignore lint/correctness/useExhaustiveDependencies: a changed input resubscribes
+    useEffect(() => {
+        if (!shouldRun)
+            return;
+        void runner.start();
+        return () => void runner.disconnect();
+    }, [runner, shouldRun, serializedInput]);
+    return { status };
+}
+export function useLiveQuery(input, queryOptionsFn, subscribe, options = {}) {
+    const queryClient = useQueryClient();
+    const focused = useIsFocused();
+    const [scope] = useState(createStreamScope);
+    // oRPC query options are plain objects; `queryFn` is read through one shape.
+    const raw = queryOptionsFn(input);
+    const keyHash = hashKey(raw.queryKey);
+    const latest = useRef({ raw, keyHash, options });
+    latest.current = { raw, keyHash, options };
+    const { status } = useOrpcSubscription((options.subscriptionInput === undefined
+        ? input
+        : options.subscriptionInput), subscribe, {
+        enabled: options.enabled,
+        pauseWhenUnfocused: options.pauseWhenUnfocused,
+        onError: options.onError,
+        onConnect: (connectionId) => scope.open(connectionId, latest.current.keyHash),
+        onEvent: (event, { connectionId }) => {
+            const current = latest.current;
+            // The consumer callback must not see an event for a scope no longer shown.
+            if (!scope.owns(connectionId, current.keyHash))
+                return;
+            // Without `applyEvent` the stream event is the cache type (the first overload).
+            const applyEvent = current.options.applyEvent ??
+                ((streamEvent) => streamEvent);
+            const key = current.raw.queryKey;
+            const next = applyEvent(event, queryClient.getQueryData(key));
+            if (next !== undefined)
+                queryClient.setQueryData(key, next);
+            current.options.onEvent?.(event, { connectionId });
+        }
+    });
+    const wrapsSeed = options.select || options.mergeSeed;
+    const queryFn = raw.queryFn && wrapsSeed
+        ? seedQueryFn(raw.queryFn, {
+            input,
+            readCache: () => queryClient.getQueryData(raw.queryKey),
+            select: options.select,
+            onSeed: options.onSeed,
+            mergeSeed: options.mergeSeed
+        })
+        : raw.queryFn;
+    const runs = options.enabled !== false && focused;
+    const query = useQuery({
+        ...raw,
+        ...(queryFn ? { queryFn } : {}),
+        enabled: runs ? (raw.enabled ?? true) : false,
+        ...(options.keepPreviousData === false
+            ? {}
+            : { placeholderData: keepPreviousData }),
+        staleTime: Number.POSITIVE_INFINITY,
+        meta: { ...raw.meta, live: true }
+    });
+    return Object.assign(query, { liveStatus: status });
+}
+/**
+ * One app-wide stream of `{ domain }` change events that keeps list and count
+ * queries fresh: each event invalidates its domain's query keys (debounced),
+ * and a reconnect that proves healthy invalidates every domain to cover
+ * events lost while it was down. Mount once, in the signed-in shell.
+ *
+ * ```ts
+ * useInvalidationStream({}, client.realtime.subscribeChanges, {
+ *   enabled: signedIn,
+ *   domains: { order: { debounceMs: 100, queryKeys: [orpc.order.key()] } }
+ * })
+ * ```
+ */
+export function useInvalidationStream(input, subscribe, options) {
+    const queryClient = useQueryClient();
+    const latestOptions = useRef(options);
+    latestOptions.current = options;
+    // `domains`, `refetchType` and `logger` are read on mount; `onEvent` stays current.
+    const [coordinator] = useState(() => createInvalidationCoordinator(queryClient, {
+        ...options,
+        onEvent: (event) => latestOptions.current.onEvent?.(event)
+    }));
+    useEffect(() => coordinator.dispose, [coordinator]);
+    return useOrpcSubscription(input, subscribe, {
+        enabled: options.enabled,
+        pauseWhenUnfocused: options.pauseWhenUnfocused,
+        onEvent: coordinator.event,
+        onConnect: coordinator.connect,
+        onError: coordinator.lost,
+        onClose: coordinator.lost
+    });
+}
+/**
+ * Clear the query cache when the signed-in owner of the cached data changes
+ * (another user, another organization), so the next one never sees it.
+ * `null` means signed out: signing in starts from the cache sign-out emptied.
+ * Pass the same owner as the persister's `buster` so a saved cache from
+ * someone else is discarded on the next launch too.
+ */
+export function useQueryCacheOwner(owner) {
+    const queryClient = useQueryClient();
+    const previous = useRef(owner);
+    useEffect(() => {
+        const before = previous.current;
+        previous.current = owner;
+        if (owner !== before && before !== null)
+            queryClient.clear();
+    }, [owner, queryClient]);
+}
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tfocusManager,\n\thashKey,\n\tkeepPreviousData,\n\ttype QueryKey,\n\ttype UseQueryOptions,\n\ttype UseQueryResult,\n\tuseQuery,\n\tuseQueryClient\n} from '@tanstack/react-query'\nimport { useEffect, useRef, useState, useSyncExternalStore } from 'react'\nimport {\n\tcreateInvalidationCoordinator,\n\tcreateStreamScope,\n\tcreateSubscriptionRunner,\n\ttype InvalidationStreamOptions,\n\ttype LiveConnectionStatus,\n\ttype SubscriptionRunner,\n\tseedQueryFn\n} from './realtime.js'\n\nexport type { InvalidationDomain, LiveConnectionStatus } from './realtime.js'\n\n/** An oRPC client procedure fits: `client.order.watch`. */\nexport type SubscribeFn<TInput, TEvent> = (\n\tinput: TInput,\n\toptions: { signal: AbortSignal }\n) => Promise<AsyncIterable<TEvent>>\n\nexport type UseOrpcSubscriptionOptions<TInput, TEvent> = {\n\t/** Run the stream (default: true). */\n\tenabled?: boolean | undefined\n\tonEvent?: (\n\t\tevent: TEvent,\n\t\tmeta: { connectionId: number; input: TInput }\n\t) => void\n\t/** Every successful connect; `connectionId > 1` is a reconnect. */\n\tonConnect?: (connectionId: number) => void\n\tonError?: ((error: Error) => void) | undefined\n\tonClose?: () => void\n\t/**\n\t * Close the stream while the app is not focused (default: true). Focus is\n\t * TanStack's `focusManager`: on React Native, wire it to `AppState` once.\n\t */\n\tpauseWhenUnfocused?: boolean | undefined\n}\n\nconst subscribeFocus = (listener: () => void) =>\n\tfocusManager.subscribe(listener)\nconst getFocus = () => focusManager.isFocused()\n\n/** Whether the app is focused, from TanStack's `focusManager`. */\nfunction useIsFocused(): boolean {\n\treturn useSyncExternalStore(subscribeFocus, getFocus, getFocus)\n}\n\n/**\n * An oRPC event iterator with backoff reconnects that closes while the app is\n * backgrounded. A changed input (compared as JSON) reconnects with a fresh\n * retry budget.\n */\nexport function useOrpcSubscription<TInput, TEvent>(\n\tinput: TInput,\n\tsubscribe: SubscribeFn<TInput, TEvent>,\n\toptions: UseOrpcSubscriptionOptions<TInput, TEvent> = {}\n): { status: LiveConnectionStatus } {\n\tconst { enabled = true, pauseWhenUnfocused = true } = options\n\tconst focused = useIsFocused()\n\tconst shouldRun = enabled && (!pauseWhenUnfocused || focused)\n\tconst [status, setStatus] = useState<LiveConnectionStatus>('idle')\n\n\tconst latest = useRef({ input, subscribe, options, shouldRun })\n\tlatest.current = { input, subscribe, options, shouldRun }\n\n\tconst runnerRef = useRef<SubscriptionRunner | null>(null)\n\tif (!runnerRef.current) {\n\t\tlet openedInput = input\n\t\trunnerRef.current = createSubscriptionRunner<TEvent>({\n\t\t\topen: (signal) => {\n\t\t\t\topenedInput = latest.current.input\n\t\t\t\treturn latest.current.subscribe(openedInput, { signal })\n\t\t\t},\n\t\t\tcanConnect: () => latest.current.shouldRun,\n\t\t\tshouldReconnect: () => latest.current.shouldRun,\n\t\t\tonStatus: setStatus,\n\t\t\tonEvent: (event, connectionId) =>\n\t\t\t\tlatest.current.options.onEvent?.(event, {\n\t\t\t\t\tconnectionId,\n\t\t\t\t\tinput: openedInput\n\t\t\t\t}),\n\t\t\tonConnect: (id) => latest.current.options.onConnect?.(id),\n\t\t\tonError: (error) => latest.current.options.onError?.(error),\n\t\t\tonClose: () => latest.current.options.onClose?.()\n\t\t})\n\t}\n\tconst runner = runnerRef.current\n\tconst serializedInput = JSON.stringify(input)\n\n\t// biome-ignore lint/correctness/useExhaustiveDependencies: a changed input resubscribes\n\tuseEffect(() => {\n\t\tif (!shouldRun) return\n\t\tvoid runner.start()\n\t\treturn () => void runner.disconnect()\n\t}, [runner, shouldRun, serializedInput])\n\n\treturn { status }\n}\n\ntype ApplyEvent<TStreamEvent, TData> = (\n\tevent: TStreamEvent,\n\tprevious: TData | undefined\n) => TData | undefined\n\ntype LiveQueryOptions<\n\tTInput,\n\tTRouteData,\n\tTStreamEvent,\n\tTData,\n\tTSubscriptionInput\n> = {\n\t/** Run the query and its stream (default: true). */\n\tenabled?: boolean | undefined\n\t/** Input for the stream when it differs from the query's. */\n\tsubscriptionInput?: TSubscriptionInput | undefined\n\t/**\n\t * Convert the route output once at fetch time into a differently typed\n\t * cache; `applyEvent` then reduces stream events into that cache.\n\t */\n\tselect?: (data: TRouteData) => TData\n\t/** The raw route output of a seed, before `select` drops fields. */\n\tonSeed?: (data: TRouteData, input: TInput) => void\n\t/**\n\t * Fold a stream event into the cached data. Required when the stream sends\n\t * something other than the cached type (an `fnLive` patch route, or a\n\t * `select`ed cache). Return `undefined` to skip the write.\n\t */\n\tapplyEvent?: ApplyEvent<TStreamEvent, NoInfer<TData>>\n\tonEvent?: (event: TStreamEvent, meta: { connectionId: number }) => void\n\tonError?: ((error: Error) => void) | undefined\n\t/**\n\t * Reconcile a fetched seed with what the stream already wrote. The HTTP\n\t * request can resolve last, so a plain overwrite would drop events that\n\t * arrived while it was in flight. Default: take the fetched value.\n\t */\n\tmergeSeed?: (\n\t\tfetched: NoInfer<TData>,\n\t\tcached: NoInfer<TData> | undefined\n\t) => NoInfer<TData>\n\t/** Show the previous key's data while a new key loads (default: true). */\n\tkeepPreviousData?: boolean\n\t/** Close the stream while the app is not focused (default: true). */\n\tpauseWhenUnfocused?: boolean | undefined\n}\n\ntype LiveQueryOptionsFn<TInput, TData, TError> = (\n\tinput: TInput\n) => UseQueryOptions<TData, TError, TData, QueryKey>\n\ntype LiveQueryResult<TData, TError> = UseQueryResult<TData, TError> & {\n\tliveStatus: LiveConnectionStatus\n}\n\n/**\n * The client half of `fnLive`: the HTTP query seeds the cache, and the live\n * route's stream writes each snapshot into the same cache entry. Marked\n * `meta.live`, so invalidation streams leave it alone.\n *\n * ```tsx\n * const order = useLiveQuery({ id }, (input) => orpc.order.get.queryOptions({ input }), client.order.watch)\n * ```\n *\n * One signature, not overloads: TypeScript fixes an untyped callback's\n * parameters at the first overload it tries, which made valid calls fail.\n */\nexport function useLiveQuery<\n\tTInput,\n\tTRouteData,\n\tTStreamEvent,\n\tTData = TRouteData,\n\tTError = Error,\n\tTSubscriptionInput = TInput\n>(\n\tinput: TInput,\n\tqueryOptionsFn: LiveQueryOptionsFn<TInput, TRouteData, TError>,\n\tsubscribe: SubscribeFn<NoInfer<TSubscriptionInput>, TStreamEvent>,\n\t...options: [TStreamEvent] extends [TData]\n\t\t? [\n\t\t\t\toptions?: LiveQueryOptions<\n\t\t\t\t\tTInput,\n\t\t\t\t\tTRouteData,\n\t\t\t\t\tTStreamEvent,\n\t\t\t\t\tTData,\n\t\t\t\t\tTSubscriptionInput\n\t\t\t\t>\n\t\t\t]\n\t\t: [\n\t\t\t\toptions: LiveQueryOptions<\n\t\t\t\t\tTInput,\n\t\t\t\t\tTRouteData,\n\t\t\t\t\tTStreamEvent,\n\t\t\t\t\tTData,\n\t\t\t\t\tTSubscriptionInput\n\t\t\t\t> & { applyEvent: ApplyEvent<TStreamEvent, NoInfer<TData>> }\n\t\t\t]\n): LiveQueryResult<TData, TError>\nexport function useLiveQuery<\n\tTInput,\n\tTRouteData,\n\tTStreamEvent,\n\tTData,\n\tTError,\n\tTSubscriptionInput\n>(\n\tinput: TInput,\n\tqueryOptionsFn: LiveQueryOptionsFn<TInput, TRouteData, TError>,\n\tsubscribe: SubscribeFn<TSubscriptionInput, TStreamEvent>,\n\toptions: LiveQueryOptions<\n\t\tTInput,\n\t\tTRouteData,\n\t\tTStreamEvent,\n\t\tTData,\n\t\tTSubscriptionInput\n\t> = {}\n): LiveQueryResult<TData, TError> {\n\tconst queryClient = useQueryClient()\n\tconst focused = useIsFocused()\n\tconst [scope] = useState(createStreamScope)\n\n\t// oRPC query options are plain objects; `queryFn` is read through one shape.\n\tconst raw = queryOptionsFn(input) as unknown as {\n\t\tqueryKey: QueryKey\n\t\tqueryFn?: (context: unknown) => Promise<TRouteData>\n\t\tenabled?: UseQueryOptions['enabled']\n\t\tmeta?: Record<string, unknown>\n\t} & Record<string, unknown>\n\tconst keyHash = hashKey(raw.queryKey)\n\tconst latest = useRef({ raw, keyHash, options })\n\tlatest.current = { raw, keyHash, options }\n\n\tconst { status } = useOrpcSubscription(\n\t\t(options.subscriptionInput === undefined\n\t\t\t? input\n\t\t\t: options.subscriptionInput) as TSubscriptionInput,\n\t\tsubscribe,\n\t\t{\n\t\t\tenabled: options.enabled,\n\t\t\tpauseWhenUnfocused: options.pauseWhenUnfocused,\n\t\t\tonError: options.onError,\n\t\t\tonConnect: (connectionId) =>\n\t\t\t\tscope.open(connectionId, latest.current.keyHash),\n\t\t\tonEvent: (event, { connectionId }) => {\n\t\t\t\tconst current = latest.current\n\t\t\t\t// The consumer callback must not see an event for a scope no longer shown.\n\t\t\t\tif (!scope.owns(connectionId, current.keyHash)) return\n\t\t\t\t// Without `applyEvent` the stream event is the cache type (the first overload).\n\t\t\t\tconst applyEvent =\n\t\t\t\t\tcurrent.options.applyEvent ??\n\t\t\t\t\t((streamEvent: TStreamEvent) => streamEvent as unknown as TData)\n\t\t\t\tconst key = current.raw.queryKey\n\t\t\t\tconst next = applyEvent(event, queryClient.getQueryData<TData>(key))\n\t\t\t\tif (next !== undefined) queryClient.setQueryData(key, next)\n\t\t\t\tcurrent.options.onEvent?.(event, { connectionId })\n\t\t\t}\n\t\t}\n\t)\n\n\tconst wrapsSeed = options.select || options.mergeSeed\n\tconst queryFn =\n\t\traw.queryFn && wrapsSeed\n\t\t\t? seedQueryFn(raw.queryFn, {\n\t\t\t\t\tinput,\n\t\t\t\t\treadCache: () => queryClient.getQueryData<TData>(raw.queryKey),\n\t\t\t\t\tselect: options.select,\n\t\t\t\t\tonSeed: options.onSeed,\n\t\t\t\t\tmergeSeed: options.mergeSeed\n\t\t\t\t})\n\t\t\t: raw.queryFn\n\tconst runs = options.enabled !== false && focused\n\tconst query = useQuery({\n\t\t...raw,\n\t\t...(queryFn ? { queryFn } : {}),\n\t\tenabled: runs ? (raw.enabled ?? true) : false,\n\t\t...(options.keepPreviousData === false\n\t\t\t? {}\n\t\t\t: { placeholderData: keepPreviousData }),\n\t\tstaleTime: Number.POSITIVE_INFINITY,\n\t\tmeta: { ...raw.meta, live: true }\n\t} as UseQueryOptions<TData, TError, TData, QueryKey>)\n\n\treturn Object.assign(query, { liveStatus: status })\n}\n\n/**\n * One app-wide stream of `{ domain }` change events that keeps list and count\n * queries fresh: each event invalidates its domain's query keys (debounced),\n * and a reconnect that proves healthy invalidates every domain to cover\n * events lost while it was down. Mount once, in the signed-in shell.\n *\n * ```ts\n * useInvalidationStream({}, client.realtime.subscribeChanges, {\n *   enabled: signedIn,\n *   domains: { order: { debounceMs: 100, queryKeys: [orpc.order.key()] } }\n * })\n * ```\n */\nexport function useInvalidationStream<\n\tTInput,\n\tTEvent extends { domain: string }\n>(\n\tinput: TInput,\n\tsubscribe: SubscribeFn<TInput, TEvent>,\n\toptions: InvalidationStreamOptions<TEvent> &\n\t\tPick<\n\t\t\tUseOrpcSubscriptionOptions<TInput, TEvent>,\n\t\t\t'enabled' | 'pauseWhenUnfocused'\n\t\t>\n): { status: LiveConnectionStatus } {\n\tconst queryClient = useQueryClient()\n\tconst latestOptions = useRef(options)\n\tlatestOptions.current = options\n\t// `domains`, `refetchType` and `logger` are read on mount; `onEvent` stays current.\n\tconst [coordinator] = useState(() =>\n\t\tcreateInvalidationCoordinator<TEvent>(queryClient, {\n\t\t\t...options,\n\t\t\tonEvent: (event) => latestOptions.current.onEvent?.(event)\n\t\t})\n\t)\n\tuseEffect(() => coordinator.dispose, [coordinator])\n\n\treturn useOrpcSubscription<TInput, TEvent>(input, subscribe, {\n\t\tenabled: options.enabled,\n\t\tpauseWhenUnfocused: options.pauseWhenUnfocused,\n\t\tonEvent: coordinator.event,\n\t\tonConnect: coordinator.connect,\n\t\tonError: coordinator.lost,\n\t\tonClose: coordinator.lost\n\t})\n}\n\n/**\n * Clear the query cache when the signed-in owner of the cached data changes\n * (another user, another organization), so the next one never sees it.\n * `null` means signed out: signing in starts from the cache sign-out emptied.\n * Pass the same owner as the persister's `buster` so a saved cache from\n * someone else is discarded on the next launch too.\n */\nexport function useQueryCacheOwner(owner: string | null): void {\n\tconst queryClient = useQueryClient()\n\tconst previous = useRef(owner)\n\tuseEffect(() => {\n\t\tconst before = previous.current\n\t\tprevious.current = owner\n\t\tif (owner !== before && before !== null) queryClient.clear()\n\t}, [owner, queryClient])\n}\n"]}