orez-sync-executor 0.11.1 → 0.11.2

package/dist/realtime/index.d.ts

@@ -0,0 +1,24 @@
+export { defineStreamingFields, resolveTopic } from './manifest.js';
+export type { FieldMode, StreamingFieldDeclaration, StreamingFieldOptions, StreamingFieldHandle, StreamingFieldRef, StreamingFieldSpec, StreamingManifest, ZeroSchemaShape, } from './manifest.js';
+export { canonicalPrimaryKey, canonicalTopic, decodeFrame, encodeFrame, isLegacyWake, LEGACY_WAKE_FRAME, TOPIC_SEPARATOR, } from './protocol.js';
+export type { AnyFrame, ClientFrame, FieldUpdate, HostFrame, ProducerFrame, ProducerHostFrame, RealtimeKeyValue, RealtimeTopic, } from './protocol.js';
+export { canonicalEncode, RealtimeStore } from './store.js';
+export type { RealtimeStoreOptions, StreamingFieldState, StreamingPhase, } from './store.js';
+export { RealtimePublisher } from './publisher.js';
+export type { BeginOptions, PublisherTransport, StreamSession } from './publisher.js';
+export { DEFAULT_HUB_LIMITS, RealtimeHub } from './hub.js';
+export type { HubConnection, HubLimits, HubOptions, HubProducer, RealtimeIdentity, SubscribeAuthorization, } from './hub.js';
+export { FieldWriter } from './writer.js';
+export type { FieldWriterOptions } from './writer.js';
+export { createLocalRealtime } from './local.js';
+export type { LocalRealtime, LocalRealtimeOptions } from './local.js';
+export { BrowserRealtime, connectRealtimePort } from './message-port.js';
+export type { BrowserRealtimeOptions, MembershipReader } from './message-port.js';
+export { applyClientFrame, applyHostFrame, applyProducerFrame } from './host.js';
+export { createProducer, inProcessTransport } from './producer.js';
+export type { ProducerOptions, RealtimeProducer } from './producer.js';
+export { createSocketHost } from './socket-host.js';
+export type { HostConnection, HostSocket, RealtimeSocketHost } from './socket-host.js';
+export { createSocketProducer } from './producer-socket.js';
+export type { ProducerSocket, SocketProducer } from './producer-socket.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/realtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACnE,YAAY,EACV,SAAS,EACT,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC3D,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAErF,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC1D,YAAY,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAChD,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAErE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACxE,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAGjF,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAGhF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAItF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/realtime/index.js

@@ -0,0 +1,27 @@
+// Streaming fields: an ephemeral, typed field overlay beside Zero.
+//
+// The ordinary Zero row stays the durable truth. During a stream orez
+// broadcasts field values without writing the application row or advancing the
+// Zero cookie, and the application commits the final value through its existing
+// write path. See plans/streaming-fields.md for the design and its rejected
+// alternatives.
+export { defineStreamingFields, resolveTopic } from './manifest.js';
+export { canonicalPrimaryKey, canonicalTopic, decodeFrame, encodeFrame, isLegacyWake, LEGACY_WAKE_FRAME, TOPIC_SEPARATOR, } from './protocol.js';
+export { canonicalEncode, RealtimeStore } from './store.js';
+export { RealtimePublisher } from './publisher.js';
+export { DEFAULT_HUB_LIMITS, RealtimeHub } from './hub.js';
+export { FieldWriter } from './writer.js';
+export { createLocalRealtime } from './local.js';
+export { BrowserRealtime, connectRealtimePort } from './message-port.js';
+// Frame routing. One applier per direction; every surface is built from these.
+export { applyClientFrame, applyHostFrame, applyProducerFrame } from './host.js';
+// The producer role, identical on every surface
+export { createProducer, inProcessTransport } from './producer.js';
+// The host role over sockets, for any runtime that has them
+export { createSocketHost } from './socket-host.js';
+// A producer that reaches the hub over a socket: an application server
+// generating values while the subscribers are browsers elsewhere
+export { createSocketProducer } from './producer-socket.js';
+// The React binding lives in on-zero, which already owns the React peer
+// dependency. orez-lite stays framework-free: see on-zero's useStreamingField.
+//# sourceMappingURL=index.js.map

package/dist/realtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,sEAAsE;AACtE,+EAA+E;AAC/E,gFAAgF;AAChF,4EAA4E;AAC5E,gBAAgB;AAEhB,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAYnE,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,eAAe,GAChB,MAAM,eAAe,CAAA;AAYtB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAO3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGlD,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAU1D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGhD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAGxE,+EAA+E;AAC/E,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEhF,gDAAgD;AAChD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGlE,4DAA4D;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAGnD,uEAAuE;AACvE,iEAAiE;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAG3D,wEAAwE;AACxE,+EAA+E"}

package/dist/realtime/local.d.ts

@@ -0,0 +1,15 @@
+import { RealtimeStore } from './store.js';
+import type { StreamingManifest } from './manifest.js';
+import type { RealtimeProducer } from './producer.js';
+export type LocalRealtimeOptions = {
+    readonly manifest: StreamingManifest;
+    readonly staleAfterMs?: number;
+    readonly onError?: (message: string) => void;
+};
+export type LocalRealtime = RealtimeProducer & {
+    readonly store: RealtimeStore;
+    readonly flush: () => void;
+    readonly close: () => void;
+};
+export declare function createLocalRealtime(options: LocalRealtimeOptions): LocalRealtime;
+//# sourceMappingURL=local.d.ts.map

package/dist/realtime/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/realtime/local.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGrD,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IAEpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7C,CAAA;AAID,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG;IAE7C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAG7B,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAC3B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA0ChF"}

package/dist/realtime/local.js

@@ -0,0 +1,63 @@
+// Single-client realtime: a hub, a publisher, and a store wired together in
+// one JavaScript context, with no socket, no host, and no authorization.
+//
+// This is the shape an application needs when the thing producing the values
+// and the thing displaying them are the same client. Soot's agent loop runs in
+// the browser: the tab running the agent is the tab rendering its output, so
+// routing those values through a server and back would add latency and an auth
+// surface to reach the component sitting next to the producer.
+//
+// It is the same RealtimeHub every other host runs, so a stream behaves
+// identically here and over a socket: same generations, same append
+// accumulation, same durable handoff, same manifest bounds. Moving an
+// application from local to a shared host changes which realtime it constructs
+// and nothing about its components or its producer code.
+//
+// What it deliberately does NOT do is reach other clients. Values live in this
+// context only. The durable Zero row remains the cross-client story, which is
+// exactly the guarantee the overlay already makes: a reload, another tab, or
+// another user sees the committed value, never the in-flight one.
+import { applyClientFrame, applyHostFrame } from './host.js';
+import { RealtimeHub } from './hub.js';
+import { createProducer, inProcessTransport } from './producer.js';
+import { RealtimeStore } from './store.js';
+export function createLocalRealtime(options) {
+    // Every row is authorized: there is one client, it is the producer, and it
+    // already holds the data it is about to display. There is nothing to
+    // authorize against and nobody to withhold it from.
+    const hub = new RealtimeHub({
+        manifest: options.manifest,
+        authorizeSubscribe: () => ({ status: 'active' }),
+        // No batching: the window exists to collapse several updates into one
+        // WebSocket frame, and there is no socket here. Deferring an in-process
+        // call would only add a tick of latency between the producer and the
+        // component next to it.
+        scheduleFlush: (flush) => flush(),
+    });
+    const store = new RealtimeStore({
+        send: (frame) => void applyClientFrame(hub, connection, frame),
+        staleAfterMs: options.staleAfterMs,
+        onError: options.onError,
+    });
+    const connection = {
+        id: 'local',
+        identity: { userID: 'local', clientID: 'local', clientGroupID: 'local' },
+        // Frames are handed straight to the store, not serialized: this is one
+        // context, and a JSON round trip per token would be pure cost. The routing
+        // is still the shared one, so a frame means the same thing here as it does
+        // over a socket.
+        send: (frame) => applyHostFrame(store, frame),
+    };
+    const producerHandle = { id: 'local-producer', send: () => { } };
+    const producer = createProducer(inProcessTransport(hub, producerHandle), options);
+    return {
+        store,
+        ...producer,
+        flush: () => hub.flush(),
+        close: () => {
+            hub.dropProducer(producerHandle.id);
+            hub.dropConnection(connection.id);
+        },
+    };
+}
+//# sourceMappingURL=local.js.map

package/dist/realtime/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/realtime/local.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,yEAAyE;AACzE,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,+DAA+D;AAC/D,EAAE;AACF,wEAAwE;AACxE,oEAAoE;AACpE,sEAAsE;AACtE,+EAA+E;AAC/E,yDAAyD;AACzD,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,kEAAkE;AAElE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAyB1C,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,2EAA2E;IAC3E,qEAAqE;IACrE,oDAAoD;IACpD,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAChD,sEAAsE;QACtE,wEAAwE;QACxE,qEAAqE;QACrE,wBAAwB;QACxB,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE;KAClC,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC;QAC9B,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,KAAoB,CAAC;QAC7E,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAA;IAEF,MAAM,UAAU,GAAkB;QAChC,EAAE,EAAE,OAAO;QACX,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE;QACxE,uEAAuE;QACvE,2EAA2E;QAC3E,2EAA2E;QAC3E,iBAAiB;QACjB,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,KAAkB,CAAC;KAC3D,CAAA;IAED,MAAM,cAAc,GAAgB,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAA;IAC5E,MAAM,QAAQ,GAAG,cAAc,CAAC,kBAAkB,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAA;IAEjF,OAAO;QACL,KAAK;QACL,GAAG,QAAQ;QACX,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE;QACxB,KAAK,EAAE,GAAG,EAAE;YACV,GAAG,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC,CAAA;YACnC,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;QACnC,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/realtime/manifest.d.ts

@@ -0,0 +1,51 @@
+import type { RealtimeKeyValue, RealtimeTopic } from './protocol.js';
+export type ZeroSchemaShape = {
+    readonly tables: Readonly<Record<string, {
+        readonly columns: Readonly<Record<string, {
+            readonly type: string;
+        }>>;
+        readonly primaryKey: readonly string[];
+    }>>;
+};
+export type FieldMode = 'append' | 'replace';
+export type StreamingFieldOptions = {
+    readonly maxBytes: number;
+    readonly maxUpdatesPerSecond: number;
+    readonly maxBytesPerSecond: number;
+    readonly mode?: FieldMode;
+    readonly validate?: (value: unknown) => boolean;
+};
+export type StreamingFieldSpec = StreamingFieldOptions & {
+    readonly table: string;
+    readonly field: string;
+    readonly mode: FieldMode;
+    readonly columnType: string;
+    readonly primaryKey: readonly string[];
+};
+export type StreamingManifest = {
+    readonly fields: ReadonlyMap<string, StreamingFieldSpec>;
+    readonly schemaKey: string;
+};
+export type StreamingFieldHandle = {
+    readonly topic: RealtimeTopic;
+    readonly spec: StreamingFieldSpec;
+};
+export type StreamingFieldRef<Key, Value> = ((key: Key) => StreamingFieldHandle) & {
+    readonly spec: StreamingFieldSpec;
+    readonly __value?: Value;
+};
+export type StreamingFieldDeclaration = Readonly<Record<string, Readonly<Record<string, StreamingFieldOptions>>>>;
+export declare function defineStreamingFields<Declaration extends StreamingFieldDeclaration>(schema: ZeroSchemaShape, declaration: Declaration): {
+    readonly manifest: StreamingManifest;
+} & {
+    readonly [Table in keyof Declaration]: {
+        readonly [Field in keyof Declaration[Table]]: StreamingFieldRef<Record<string, RealtimeKeyValue>, unknown>;
+    };
+};
+export declare function resolveTopic(manifest: StreamingManifest, topic: RealtimeTopic): {
+    readonly spec: StreamingFieldSpec;
+    readonly id: string;
+} | {
+    readonly reason: string;
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/realtime/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/realtime/manifest.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAEpE,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CACvB,MAAM,CACJ,MAAM,EACN;QACE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC,CAAA;QACrE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;KACvC,CACF,CACF,CAAA;CACF,CAAA;AAOD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE5C,MAAM,MAAM,qBAAqB,GAAG;IAElC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IAGpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAElC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IAKzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;CAChD,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,GAAG;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IAIxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B,CAAA;AAMD,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;CAClC,CAAA;AAGD,MAAM,MAAM,iBAAiB,CAAC,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,oBAAoB,CAAC,GAAG;IACjF,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;IAEjC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CACzB,CAAA;AAoBD,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAC9C,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAChE,CAAA;AAED,wBAAgB,qBAAqB,CAAC,WAAW,SAAS,yBAAyB,EACjF,MAAM,EAAE,eAAe,EACvB,WAAW,EAAE,WAAW,GACvB;IACD,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;CACrC,GAAG;IACF,QAAQ,EAAE,KAAK,IAAI,MAAM,WAAW,GAAG;QACrC,QAAQ,EAAE,KAAK,IAAI,MAAM,WAAW,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAC7D,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAChC,OAAO,CACR;KACF;CACF,CA0EA;AAuBD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,aAAa,GAElB;IAAE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAU9B"}

package/dist/realtime/manifest.js

@@ -0,0 +1,110 @@
+// The streaming-field manifest: which columns may stream, in what mode, under
+// what bounds.
+//
+// It stays PARALLEL to the Zero schema rather than being a property on it.
+// Zero derives its client schema and compatibility hash from the stock column
+// shape, so an orez-specific property there would change Zero's schema identity
+// or depend on how its runtime treats unknown keys. The manifest takes the
+// schema as input, validates every table and column against it, and produces a
+// separate object.
+import { canonicalTopic } from './protocol.js';
+const APPENDABLE_TYPES = new Set(['string']);
+const VALIDATOR_REQUIRED_TYPES = new Set(['json']);
+function schemaIdentity(schema, fields) {
+    // identity covers exactly what a mismatch would break: the streamed columns,
+    // their type, their mode, and the key ordering topics are built from.
+    return fields
+        .map((spec) => {
+        const table = schema.tables[spec.table];
+        return `${spec.table}.${spec.field}:${spec.columnType}:${spec.mode}:${table.primaryKey.join(',')}`;
+    })
+        .sort()
+        .join('|');
+}
+export function defineStreamingFields(schema, declaration) {
+    const specs = [];
+    const tables = {};
+    for (const [table, fields] of Object.entries(declaration)) {
+        const schemaTable = schema.tables[table];
+        if (!schemaTable) {
+            throw new TypeError(`streaming field table '${table}' is not in the Zero schema`);
+        }
+        if (schemaTable.primaryKey.length === 0) {
+            throw new TypeError(`streaming field table '${table}' has no primary key`);
+        }
+        const refs = {};
+        for (const [field, options] of Object.entries(fields)) {
+            const column = schemaTable.columns[field];
+            if (!column) {
+                throw new TypeError(`streaming field '${table}.${field}' is not in the Zero schema`);
+            }
+            if (schemaTable.primaryKey.includes(field)) {
+                throw new TypeError(`streaming field '${table}.${field}' is a primary key column; a streamed key would change the row's identity mid-generation`);
+            }
+            validateBounds(table, field, options);
+            const mode = options.mode ?? (APPENDABLE_TYPES.has(column.type) ? 'append' : 'replace');
+            if (mode === 'append' && !APPENDABLE_TYPES.has(column.type)) {
+                throw new TypeError(`streaming field '${table}.${field}' is a ${column.type} column; append mode concatenates and only applies to string columns`);
+            }
+            if (VALIDATOR_REQUIRED_TYPES.has(column.type) && !options.validate) {
+                throw new TypeError(`streaming field '${table}.${field}' is a ${column.type} column and must supply validate(); Zero carries no runtime validator for it and realtime values bypass PayloadCodec.decodePull`);
+            }
+            const spec = {
+                ...options,
+                table,
+                field,
+                mode,
+                columnType: column.type,
+                primaryKey: schemaTable.primaryKey,
+            };
+            specs.push(spec);
+            const ref = ((key) => {
+                for (const column of spec.primaryKey) {
+                    if (key[column] === undefined) {
+                        throw new TypeError(`streaming topic '${table}.${field}' is missing primary key column '${column}'`);
+                    }
+                }
+                return { topic: { table, key, field }, spec };
+            });
+            Object.defineProperty(ref, 'spec', { value: spec, enumerable: true });
+            refs[field] = ref;
+        }
+        tables[table] = refs;
+    }
+    const fieldMap = new Map();
+    for (const spec of specs)
+        fieldMap.set(`${spec.table}.${spec.field}`, spec);
+    return {
+        ...tables,
+        manifest: { fields: fieldMap, schemaKey: schemaIdentity(schema, specs) },
+    };
+}
+function validateBounds(table, field, options) {
+    const bounds = [
+        ['maxBytes', options.maxBytes],
+        ['maxUpdatesPerSecond', options.maxUpdatesPerSecond],
+        ['maxBytesPerSecond', options.maxBytesPerSecond],
+    ];
+    for (const [name, value] of bounds) {
+        if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
+            throw new TypeError(`streaming field '${table}.${field}' needs a positive ${name}`);
+        }
+    }
+}
+// Host-side lookup: resolve a topic against the manifest, returning the spec
+// and the canonical wire identity, or a reason the topic is not streamable.
+// Every host runs this before it will fan anything out, so a producer bug or a
+// crafted subscribe frame cannot create a topic outside the manifest.
+export function resolveTopic(manifest, topic) {
+    const spec = manifest.fields.get(`${topic.table}.${topic.field}`);
+    if (!spec)
+        return { reason: `'${topic.table}.${topic.field}' is not a streaming field` };
+    for (const column of spec.primaryKey) {
+        const value = topic.key[column];
+        if (value === undefined) {
+            return { reason: `topic is missing primary key column '${column}'` };
+        }
+    }
+    return { spec, id: canonicalTopic(spec.primaryKey, topic) };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/realtime/manifest.js.map

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

package/dist/realtime/message-port.d.ts

@@ -0,0 +1,34 @@
+import { RealtimeHub } from './hub.js';
+import { RealtimeStore } from './store.js';
+import type { RealtimeIdentity } from './hub.js';
+import type { StreamingManifest } from './manifest.js';
+import type { RealtimeTopic } from './protocol.js';
+import type { RealtimePublisher } from './publisher.js';
+import type { FieldWriter } from './writer.js';
+export type MembershipReader = (identity: RealtimeIdentity, table: string, key: Readonly<Record<string, boolean | null | number | string>>) => Promise<{
+    readonly ownsGroup: boolean;
+    readonly authorized: boolean;
+}>;
+export type BrowserRealtimeOptions = {
+    readonly manifest: StreamingManifest;
+    readonly readMembership: MembershipReader;
+    readonly onError?: (message: string) => void;
+};
+export declare class BrowserRealtime {
+    #private;
+    constructor(options: BrowserRealtimeOptions);
+    get fields(): FieldWriter;
+    get publisher(): RealtimePublisher;
+    connect(port: MessagePort, identity: RealtimeIdentity): () => void;
+    revokeMembership(clientGroupID: string, removed: readonly RealtimeTopic[]): void;
+    flush(): void;
+    get hub(): RealtimeHub;
+}
+export declare function connectRealtimePort(port: MessagePort, options?: {
+    readonly staleAfterMs?: number;
+    readonly onError?: (message: string) => void;
+}): {
+    readonly store: RealtimeStore;
+    readonly close: () => void;
+};
+//# sourceMappingURL=message-port.d.ts.map

package/dist/realtime/message-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-port.d.ts","sourceRoot":"","sources":["../../src/realtime/message-port.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAGtC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,OAAO,KAAK,EAGV,gBAAgB,EAEjB,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAI9C,MAAM,MAAM,gBAAgB,GAAG,CAC7B,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC,KAC5D,OAAO,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CAAA;AAE3E,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAA;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7C,CAAA;AAED,qBAAa,eAAe;;gBAMd,OAAO,EAAE,sBAAsB;IAqC3C,IAAI,MAAM,IAAI,WAAW,CAExB;IAID,IAAI,SAAS,IAAI,iBAAiB,CAEjC;IAKD,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAqClE,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI;IAIhF,KAAK,IAAI,IAAI;IAIb,IAAI,GAAG,IAAI,WAAW,CAErB;CACF;AAKD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE;IACP,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC,GACL;IAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAiC/D"}

package/dist/realtime/message-port.js

@@ -0,0 +1,141 @@
+// MessagePort realtime adapter: the browser-worker host's transport.
+//
+// The hub state machine, publisher, and protocol are shared with every other
+// host (the realtime hub). This file is only the browser's socket lifecycle:
+// a MessagePort instead of a WebSocket, and an authorizer that reads the same
+// durable query membership the pull path maintains.
+//
+// The worker and its producer share one process lifecycle, so subscriptions and
+// stream generations are memory-only here. Nothing survives a worker restart,
+// which is correct: the durable value is whatever the client's next Zero pull
+// produces.
+import { applyClientFrame, applyHostFrame } from './host.js';
+import { RealtimeHub } from './hub.js';
+import { createProducer, inProcessTransport } from './producer.js';
+import { decodeFrame, encodeFrame } from './protocol.js';
+import { RealtimeStore } from './store.js';
+export class BrowserRealtime {
+    #hub;
+    #producer;
+    #producerCounter = 0;
+    #connectionCounter = 0;
+    constructor(options) {
+        this.#hub = new RealtimeHub({
+            manifest: options.manifest,
+            authorizeSubscribe: async (identity, topic) => {
+                const { ownsGroup, authorized } = await options.readMembership(identity, topic.table, topic.key);
+                // A client group id is not a bearer token: not owning it is a denial,
+                // and the reason deliberately does not say whether the row exists.
+                if (!ownsGroup) {
+                    return { status: 'denied', reason: 'client group does not belong to this user' };
+                }
+                // Owning the group without membership is the optimistic-row race: the
+                // client holds a row from its own mutation that the server has not
+                // recorded yet. It retries after its next pull.
+                return authorized ? { status: 'active' } : { status: 'pending' };
+            },
+        });
+        // There is no producer socket in the browser: the code running the model
+        // loop and the hub share one JavaScript context, so begin/publish are
+        // direct calls. The producer ROLE is still the shared one, so a loop
+        // written here runs unchanged against a socket host.
+        const producerHandle = {
+            id: `browser-producer-${++this.#producerCounter}`,
+            send: () => { },
+        };
+        this.#producer = createProducer(inProcessTransport(this.#hub, producerHandle), options);
+    }
+    // Imperative writing: set a row's field to its current value, generations
+    // managed for you. Trusted by construction, this is the worker's own code.
+    get fields() {
+        return this.#producer.fields;
+    }
+    // The explicit generation API underneath, for a producer that controls begin,
+    // commit, and end itself.
+    get publisher() {
+        return this.#producer.publisher;
+    }
+    // Attach a port. The identity comes from the host's authenticated pull path,
+    // never from the port itself, so a page cannot claim another user's client
+    // group by asserting one over the channel.
+    connect(port, identity) {
+        const connection = {
+            id: `browser-connection-${++this.#connectionCounter}`,
+            identity,
+            send: (frame) => {
+                port.postMessage({ event: 'realtime', frame: encodeFrame(frame) });
+            },
+        };
+        const onMessage = (event) => {
+            const message = event.data;
+            if (!message ||
+                typeof message !== 'object' ||
+                message.event !== 'realtime') {
+                return;
+            }
+            const raw = message.frame;
+            if (typeof raw !== 'string')
+                return;
+            const frame = decodeFrame(raw);
+            if (!frame)
+                return;
+            // A subscriber channel is never a publish channel. Only subscribe and
+            // unsubscribe are accepted here, whatever else a port sends.
+            if (frame[0] !== 'subscribe' && frame[0] !== 'unsubscribe')
+                return;
+            void applyClientFrame(this.#hub, connection, frame);
+        };
+        port.addEventListener('message', onMessage);
+        return () => {
+            port.removeEventListener('message', onMessage);
+            this.#hub.dropConnection(connection.id);
+        };
+    }
+    // A pull removed rows from a client group's membership, so its field
+    // subscriptions for those rows go with them.
+    revokeMembership(clientGroupID, removed) {
+        this.#hub.revokeMembership(clientGroupID, removed);
+    }
+    flush() {
+        this.#hub.flush();
+    }
+    get hub() {
+        return this.#hub;
+    }
+}
+// The page-side half of the port transport. Owns a RealtimeStore and pumps
+// frames both ways, so `useStreamingField` sees the same store it would against
+// a WebSocket host.
+export function connectRealtimePort(port, options = {}) {
+    const store = new RealtimeStore({
+        send: (frame) => {
+            port.postMessage({ event: 'realtime', frame: encodeFrame(frame) });
+        },
+        staleAfterMs: options.staleAfterMs,
+        onError: options.onError,
+    });
+    const onMessage = (event) => {
+        const message = event.data;
+        if (!message ||
+            typeof message !== 'object' ||
+            message.event !== 'realtime') {
+            return;
+        }
+        const raw = message.frame;
+        if (typeof raw !== 'string')
+            return;
+        const frame = decodeFrame(raw);
+        if (frame)
+            applyHostFrame(store, frame);
+    };
+    port.addEventListener('message', onMessage);
+    port.start();
+    return {
+        store,
+        close: () => {
+            port.removeEventListener('message', onMessage);
+            store.handleDisconnect();
+        },
+    };
+}
+//# sourceMappingURL=message-port.js.map

package/dist/realtime/message-port.js.map

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

package/dist/realtime/producer-socket.d.ts

@@ -0,0 +1,10 @@
+import type { ProducerOptions, RealtimeProducer } from './producer.js';
+export type ProducerSocket = {
+    send(data: string): void;
+};
+export type SocketProducer = RealtimeProducer & {
+    handleMessage(raw: string): void;
+    fail(reason: string): void;
+};
+export declare function createSocketProducer(socket: ProducerSocket, options: ProducerOptions): SocketProducer;
+//# sourceMappingURL=producer-socket.d.ts.map

package/dist/realtime/producer-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"producer-socket.d.ts","sourceRoot":"","sources":["../../src/realtime/producer-socket.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAItE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG;IAE9C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAIhC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,CAAA;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,eAAe,GACvB,cAAc,CA2EhB"}

package/dist/realtime/producer-socket.js

@@ -0,0 +1,90 @@
+// A PublisherTransport backed by a socket, for a producer that is not in the
+// same process as the hub.
+//
+// This is the shape soot does NOT need and the shape agentbus and chat do: an
+// application server generates the values, and the subscribers are browsers
+// somewhere else, so the updates have to cross a network to reach the hub that
+// fans them out.
+//
+// One socket carries every generation the producer has open. A server writing
+// twenty agent sessions holds one connection, and the hub releases all twenty
+// leases when it drops.
+//
+// Connecting, authenticating, and reconnecting are the caller's: it knows its
+// own deployment. This owns only the frame bookkeeping on top of a socket that
+// is already open.
+import { createProducer } from './producer.js';
+import { decodeFrame, encodeFrame } from './protocol.js';
+export function createSocketProducer(socket, options) {
+    const pendingBegins = new Map();
+    // streamID -> why it is unusable. Set by a host rejection or supersession, and
+    // raised on the producer's next publish for that stream.
+    const failures = new Map();
+    // The socket itself died. This is deliberately not per-stream: once the
+    // connection is gone every generation on it is gone, including ones that
+    // began successfully and are therefore absent from `failures`.
+    let socketFailure;
+    const transport = {
+        begin(topic, streamID) {
+            if (socketFailure)
+                return Promise.reject(new Error(socketFailure));
+            return new Promise((resolve, reject) => {
+                pendingBegins.set(streamID, { resolve, reject });
+                socket.send(encodeFrame(['begin', { topic, streamID }]));
+            });
+        },
+        publish(update) {
+            if (socketFailure)
+                throw new Error(socketFailure);
+            const failure = failures.get(update.streamID);
+            if (failure)
+                throw new Error(failure);
+            socket.send(encodeFrame(['publish', { update }]));
+        },
+        end(streamID) {
+            failures.delete(streamID);
+            pendingBegins.delete(streamID);
+        },
+    };
+    return {
+        ...createProducer(transport, options),
+        handleMessage(raw) {
+            const frame = decodeFrame(raw);
+            if (!frame)
+                return;
+            switch (frame[0]) {
+                case 'begin-result': {
+                    const { streamID, reason } = frame[1];
+                    const pending = pendingBegins.get(streamID);
+                    if (!pending)
+                        return;
+                    pendingBegins.delete(streamID);
+                    if (reason === null)
+                        pending.resolve();
+                    else
+                        pending.reject(new Error(reason));
+                    return;
+                }
+                case 'publish-rejected': {
+                    const { streamID, reason } = frame[1];
+                    failures.set(streamID, reason);
+                    return;
+                }
+                case 'superseded': {
+                    const { topic, streamID } = frame[1];
+                    failures.set(streamID, `generation for '${topic}' was superseded by a newer one`);
+                    return;
+                }
+                default:
+                    return;
+            }
+        },
+        fail(reason) {
+            socketFailure = reason;
+            for (const pending of pendingBegins.values())
+                pending.reject(new Error(reason));
+            pendingBegins.clear();
+        },
+    };
+}
+//# sourceMappingURL=producer-socket.js.map

package/dist/realtime/producer-socket.js.map

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