orez-sync-executor 0.11.1 → 0.11.2

package/dist/realtime/producer.d.ts

@@ -0,0 +1,16 @@
+import { RealtimePublisher } from './publisher.js';
+import { FieldWriter } from './writer.js';
+import type { RealtimeHub, HubProducer } from './hub.js';
+import type { StreamingManifest } from './manifest.js';
+import type { PublisherTransport } from './publisher.js';
+export type RealtimeProducer = {
+    readonly fields: FieldWriter;
+    readonly publisher: RealtimePublisher;
+};
+export type ProducerOptions = {
+    readonly manifest: StreamingManifest;
+    readonly onError?: (message: string) => void;
+};
+export declare function createProducer(transport: PublisherTransport, options: ProducerOptions): RealtimeProducer;
+export declare function inProcessTransport(hub: RealtimeHub, producer: HubProducer): PublisherTransport;
+//# sourceMappingURL=producer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"producer.d.ts","sourceRoot":"","sources":["../../src/realtime/producer.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IAIpC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7C,CAAA;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,kBAAkB,EAC7B,OAAO,EAAE,eAAe,GACvB,gBAAgB,CAQlB;AASD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,WAAW,GACpB,kBAAkB,CAcpB"}

package/dist/realtime/producer.js

@@ -0,0 +1,51 @@
+// The producer role, identical on every surface.
+//
+// A producer is whatever generates values: a browser agent loop, an application
+// server, a Rust daemon. What differs between them is only how their frames
+// reach the hub (a direct call, a MessagePort, a WebSocket). What must NOT
+// differ is the API they write through, because otherwise moving a producer
+// between surfaces means rewriting it.
+//
+// So the transport varies and this does not. Every surface builds its producer
+// here, and every producer gets the same two handles:
+//
+//   fields     imperative: set(handle, value), generations managed for you.
+//              This is what a token loop wants and what most code should use.
+//   publisher  the explicit generation API underneath, for a producer that
+//              needs to control begin, commit, and end itself.
+import { RealtimePublisher } from './publisher.js';
+import { FieldWriter } from './writer.js';
+export function createProducer(transport, options) {
+    const publisher = new RealtimePublisher(transport, options.manifest);
+    const fields = new FieldWriter(publisher, {
+        onError: (error, topic) => {
+            options.onError?.(`${topic.table}.${topic.field}: ${error.message}`);
+        },
+    });
+    return { fields, publisher };
+}
+// The transport for a producer that shares a process with the hub: the local
+// single-client host and the browser worker. `begin` and `publish` are direct
+// calls, so there is nothing to serialize and nothing to await.
+//
+// A rejection throws, which is what the publisher's own failure handling
+// expects; it converts that into a reported error rather than letting it reach
+// the producer's loop.
+export function inProcessTransport(hub, producer) {
+    return {
+        begin: (topic, streamID) => {
+            const result = hub.beginGeneration(producer, topic, streamID);
+            if (!result.ok)
+                throw new Error(result.reason);
+        },
+        publish: (update) => {
+            const result = hub.publish(producer, update);
+            if (!result.ok)
+                throw new Error(result.reason);
+        },
+        // Nothing to release: the generation closed when its terminal update was
+        // published, and there is no socket whose bookkeeping could outlive it.
+        end: () => { },
+    };
+}
+//# sourceMappingURL=producer.js.map

package/dist/realtime/producer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"producer.js","sourceRoot":"","sources":["../../src/realtime/producer.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,gFAAgF;AAChF,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,uCAAuC;AACvC,EAAE;AACF,+EAA+E;AAC/E,sDAAsD;AACtD,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,+DAA+D;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAoBzC,MAAM,UAAU,cAAc,CAC5B,SAA6B,EAC7B,OAAwB;IAExB,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACpE,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,SAAS,EAAE;QACxC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACxB,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QACtE,CAAC;KACF,CAAC,CAAA;IACF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;AAC9B,CAAC;AAED,6EAA6E;AAC7E,8EAA8E;AAC9E,gEAAgE;AAChE,EAAE;AACF,yEAAyE;AACzE,+EAA+E;AAC/E,uBAAuB;AACvB,MAAM,UAAU,kBAAkB,CAChC,GAAgB,EAChB,QAAqB;IAErB,OAAO;QACL,KAAK,EAAE,CAAC,KAAoB,EAAE,QAAgB,EAAE,EAAE;YAChD,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;YAC7D,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAChD,CAAC;QACD,OAAO,EAAE,CAAC,MAAmB,EAAE,EAAE;YAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YAC5C,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAChD,CAAC;QACD,yEAAyE;QACzE,wEAAwE;QACxE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;KACd,CAAA;AACH,CAAC"}

package/dist/realtime/protocol.d.ts

@@ -0,0 +1,99 @@
+export type RealtimeKeyValue = string | number | boolean | null;
+export type RealtimeTopic = {
+    readonly table: string;
+    readonly key: Readonly<Record<string, RealtimeKeyValue>>;
+    readonly field: string;
+};
+export declare function canonicalPrimaryKey(primaryKey: readonly string[], key: Readonly<Record<string, RealtimeKeyValue>>): string;
+export declare const TOPIC_SEPARATOR = "\u001F";
+export declare function canonicalTopic(primaryKey: readonly string[], topic: RealtimeTopic): string;
+export type SubscribeFrame = readonly ['subscribe', {
+    readonly topic: RealtimeTopic;
+}];
+export type UnsubscribeFrame = readonly ['unsubscribe', {
+    readonly topic: RealtimeTopic;
+}];
+export type ClientFrame = SubscribeFrame | UnsubscribeFrame;
+export type BeginFrame = readonly [
+    'begin',
+    {
+        readonly topic: RealtimeTopic;
+        readonly streamID: string;
+    }
+];
+export type PublishFrame = readonly ['publish', {
+    readonly update: FieldUpdate;
+}];
+export type ProducerFrame = BeginFrame | PublishFrame;
+export type BeginResultFrame = readonly [
+    'begin-result',
+    {
+        readonly streamID: string;
+        readonly topic: string | null;
+        readonly reason: string | null;
+    }
+];
+export type PublishRejectedFrame = readonly [
+    'publish-rejected',
+    {
+        readonly topic: string;
+        readonly streamID: string;
+        readonly reason: string;
+    }
+];
+export type SupersededFrame = readonly [
+    'superseded',
+    {
+        readonly topic: string;
+        readonly streamID: string;
+    }
+];
+export type ProducerHostFrame = BeginResultFrame | PublishRejectedFrame | SupersededFrame;
+export type SubscribedFrame = readonly [
+    'subscribed',
+    {
+        readonly topic: string;
+        readonly status: 'active' | 'pending';
+    }
+];
+export type SubscribeErrorFrame = readonly [
+    'subscribe-error',
+    {
+        readonly topic: string;
+        readonly reason: string;
+    }
+];
+export type FieldUpdate = {
+    readonly topic: string;
+    readonly streamID: string;
+    readonly seq: number;
+    readonly op: 'snapshot';
+    readonly value: unknown;
+} | {
+    readonly topic: string;
+    readonly streamID: string;
+    readonly seq: number;
+    readonly op: 'append';
+    readonly text: string;
+} | {
+    readonly topic: string;
+    readonly streamID: string;
+    readonly seq: number;
+    readonly op: 'end';
+} | {
+    readonly topic: string;
+    readonly streamID: string;
+    readonly seq: number;
+    readonly op: 'abort';
+};
+export type FieldFrame = readonly ['field', {
+    readonly updates: readonly FieldUpdate[];
+}];
+export type WakeFrame = readonly ['wake', Record<string, never>];
+export type HostFrame = FieldFrame | SubscribeErrorFrame | SubscribedFrame | WakeFrame;
+export declare const LEGACY_WAKE_FRAME = "wake";
+export declare function isLegacyWake(raw: string): boolean;
+export type AnyFrame = ClientFrame | HostFrame | ProducerFrame | ProducerHostFrame;
+export declare function encodeFrame(frame: AnyFrame): string;
+export declare function decodeFrame(raw: string): AnyFrame | undefined;
+//# sourceMappingURL=protocol.d.ts.map

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

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

package/dist/realtime/protocol.js

@@ -0,0 +1,191 @@
+// Wire protocol for orez realtime field streaming.
+//
+// Field values are ephemeral: they never enter the Zero store, never advance a
+// cookie, and never survive a reload. The durable value is whatever the
+// ordinary Zero row says. A stream is a presentation-latency optimization over
+// that row, so a dropped frame costs latency and can never cost correctness.
+//
+// Two publish modes, declared per field in the manifest and fixed for the life
+// of the field, so no host ever branches on frame shape at runtime:
+//
+// - `append` (string columns): a frame carries only the new characters. Cost
+//   per frame stays flat as the value grows, which is the whole point for token
+//   streams. The host accumulates, so a subscriber that arrives at token 900
+//   gets one snapshot and then appends.
+// - `replace` (every other column type): a frame carries the complete value.
+//   Correct for any JSON-representable column, and the right cost model for
+//   fields that change at semantic-event frequency rather than per token.
+//
+// Recovery is the host's accumulator, not a client-side replay buffer. Frames
+// travel over one WebSocket, so they arrive in order or the socket is gone; a
+// reconnect resubscribes and gets a fresh snapshot. `seq` therefore only has to
+// fence a superseded generation and mark where a snapshot ended.
+// The canonical primary-key encoding, mirroring sync_core::value::canonical_pk
+// byte for byte: primary-key columns in the schema's declared order, each key
+// and value serialized as JSON. Both sides derive topics independently and must
+// land on the same string, so harness/fixtures/canonical-pk-vectors.json is
+// asserted here as well as in the native and wasm builds.
+export function canonicalPrimaryKey(primaryKey, key) {
+    let out = '{';
+    for (let index = 0; index < primaryKey.length; index++) {
+        const column = primaryKey[index];
+        if (index > 0)
+            out += ',';
+        out += `${JSON.stringify(column)}:${JSON.stringify(key[column] ?? null)}`;
+    }
+    return `${out}}`;
+}
+// ASCII unit separator. A Zero table or column name cannot contain it, and the
+// encoded primary key is JSON where it would appear escaped, so the three parts
+// of a topic can never run together ambiguously. Written as an escape rather
+// than a literal so it stays visible in source.
+export const TOPIC_SEPARATOR = '\u001f';
+// A topic's wire identity. Field frames carry this string rather than the
+// structured topic: it is the map key on both sides, and re-deriving it per
+// frame would be pure overhead.
+export function canonicalTopic(primaryKey, topic) {
+    const key = canonicalPrimaryKey(primaryKey, topic.key);
+    return `${topic.table}${TOPIC_SEPARATOR}${topic.field}${TOPIC_SEPARATOR}${key}`;
+}
+// The legacy notification-only channel sent the bare text "wake". It stays
+// accepted so an old client against a new host, or a new client against the
+// /wake route during migration, still pulls.
+export const LEGACY_WAKE_FRAME = 'wake';
+export function isLegacyWake(raw) {
+    return raw === LEGACY_WAKE_FRAME;
+}
+export function encodeFrame(frame) {
+    return JSON.stringify(frame);
+}
+// Parsing is total: a malformed frame returns undefined rather than throwing,
+// because a socket message is attacker-influenced input on the host side and a
+// throw inside a message handler would tear down an otherwise healthy socket.
+export function decodeFrame(raw) {
+    if (isLegacyWake(raw))
+        return ['wake', {}];
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+    if (!Array.isArray(parsed) || parsed.length !== 2)
+        return undefined;
+    const [kind, body] = parsed;
+    if (typeof kind !== 'string' || !body || typeof body !== 'object')
+        return undefined;
+    switch (kind) {
+        case 'subscribe':
+        case 'unsubscribe': {
+            const topic = body.topic;
+            return isTopic(topic) ? [kind, { topic }] : undefined;
+        }
+        case 'subscribed': {
+            const { topic, status } = body;
+            if (typeof topic !== 'string')
+                return undefined;
+            if (status !== 'active' && status !== 'pending')
+                return undefined;
+            return ['subscribed', { topic, status }];
+        }
+        case 'subscribe-error': {
+            const { topic, reason } = body;
+            if (typeof topic !== 'string' || typeof reason !== 'string')
+                return undefined;
+            return ['subscribe-error', { topic, reason }];
+        }
+        case 'field': {
+            const updates = body.updates;
+            if (!Array.isArray(updates))
+                return undefined;
+            const decoded = [];
+            for (const update of updates) {
+                const valid = decodeUpdate(update);
+                if (!valid)
+                    return undefined;
+                decoded.push(valid);
+            }
+            return ['field', { updates: decoded }];
+        }
+        case 'begin': {
+            const { topic, streamID } = body;
+            if (!isTopic(topic) || typeof streamID !== 'string' || !streamID)
+                return undefined;
+            return ['begin', { topic, streamID }];
+        }
+        case 'publish': {
+            const update = decodeUpdate(body.update);
+            return update ? ['publish', { update }] : undefined;
+        }
+        case 'begin-result': {
+            const { streamID, topic, reason } = body;
+            if (typeof streamID !== 'string')
+                return undefined;
+            if (topic !== null && typeof topic !== 'string')
+                return undefined;
+            if (reason !== null && typeof reason !== 'string')
+                return undefined;
+            return ['begin-result', { streamID, topic, reason }];
+        }
+        case 'publish-rejected': {
+            const { topic, streamID, reason } = body;
+            if (typeof topic !== 'string' || typeof streamID !== 'string')
+                return undefined;
+            if (typeof reason !== 'string')
+                return undefined;
+            return ['publish-rejected', { topic, streamID, reason }];
+        }
+        case 'superseded': {
+            const { topic, streamID } = body;
+            if (typeof topic !== 'string' || typeof streamID !== 'string')
+                return undefined;
+            return ['superseded', { topic, streamID }];
+        }
+        case 'wake':
+            return ['wake', {}];
+        default:
+            return undefined;
+    }
+}
+function decodeUpdate(update) {
+    if (!update || typeof update !== 'object')
+        return undefined;
+    const { topic, streamID, seq, op } = update;
+    if (typeof topic !== 'string' || typeof streamID !== 'string')
+        return undefined;
+    if (typeof seq !== 'number' || !Number.isSafeInteger(seq) || seq < 0)
+        return undefined;
+    switch (op) {
+        case 'snapshot':
+            return { topic, streamID, seq, op, value: update.value };
+        case 'append': {
+            const text = update.text;
+            return typeof text === 'string' ? { topic, streamID, seq, op, text } : undefined;
+        }
+        case 'abort':
+        case 'end':
+            return { topic, streamID, seq, op };
+        default:
+            return undefined;
+    }
+}
+function isTopic(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const { table, key, field } = value;
+    if (typeof table !== 'string' || !table)
+        return false;
+    if (typeof field !== 'string' || !field)
+        return false;
+    if (!key || typeof key !== 'object' || Array.isArray(key))
+        return false;
+    for (const entry of Object.values(key)) {
+        const type = typeof entry;
+        if (entry !== null && type !== 'string' && type !== 'number' && type !== 'boolean') {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/realtime/protocol.js.map

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

package/dist/realtime/publisher.d.ts

@@ -0,0 +1,28 @@
+import type { StreamingManifest } from './manifest.js';
+import type { FieldUpdate, RealtimeTopic } from './protocol.js';
+export type PublisherTransport = {
+    readonly publish: (update: FieldUpdate) => Promise<void> | void;
+    readonly begin: (topic: RealtimeTopic, streamID: string) => Promise<void> | void;
+    readonly end: (streamID: string) => Promise<void> | void;
+};
+export type BeginOptions = {
+    readonly namespace: string;
+    readonly key: Readonly<Record<string, boolean | null | number | string>>;
+};
+export type StreamSession<Value> = {
+    readonly streamID: string;
+    readonly topic: RealtimeTopic;
+    set(value: Value): void;
+    flush(): Promise<void>;
+    finish(value: Value, commit: () => Promise<void>): Promise<void>;
+    abort(): Promise<void>;
+};
+export declare class RealtimePublisher {
+    #private;
+    constructor(transport: PublisherTransport, manifest: StreamingManifest, options?: {
+        readonly now?: () => number;
+        readonly randomID?: () => string;
+    });
+    begin<Value = string>(table: string, field: string, options: BeginOptions): Promise<StreamSession<Value>>;
+}
+//# sourceMappingURL=publisher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.d.ts","sourceRoot":"","sources":["../../src/realtime/publisher.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE/D,MAAM,MAAM,kBAAkB,GAAG;IAG/B,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAG/D,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAChF,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACzD,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC,CAAA;CACzE,CAAA;AAED,MAAM,MAAM,aAAa,CAAC,KAAK,IAAI;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAI7B,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IAEvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB,CAAA;AAcD,qBAAa,iBAAiB;;gBAO1B,SAAS,EAAE,kBAAkB,EAC7B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;KAAO;IAQ3E,KAAK,CAAC,KAAK,GAAG,MAAM,EACxB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;CAyBjC"}