orez-lite 0.11.1 → 0.11.2

package/dist/realtime/protocol.d.ts

@@ -1,99 +0,0 @@
-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

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

package/dist/realtime/protocol.js

@@ -1,191 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/realtime/protocol.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,+EAA+E;AAC/E,wEAAwE;AACxE,+EAA+E;AAC/E,6EAA6E;AAC7E,EAAE;AACF,+EAA+E;AAC/E,oEAAoE;AACpE,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,6EAA6E;AAC7E,wCAAwC;AACxC,6EAA6E;AAC7E,4EAA4E;AAC5E,0EAA0E;AAC1E,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,gFAAgF;AAChF,iEAAiE;AAUjE,+EAA+E;AAC/E,8EAA8E;AAC9E,gFAAgF;AAChF,4EAA4E;AAC5E,0DAA0D;AAC1D,MAAM,UAAU,mBAAmB,CACjC,UAA6B,EAC7B,GAA+C;IAE/C,IAAI,GAAG,GAAG,GAAG,CAAA;IACb,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACvD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAE,CAAA;QACjC,IAAI,KAAK,GAAG,CAAC;YAAE,GAAG,IAAI,GAAG,CAAA;QACzB,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE,CAAA;IAC3E,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,CAAA;AAClB,CAAC;AAED,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAA;AAEvC,0EAA0E;AAC1E,4EAA4E;AAC5E,gCAAgC;AAChC,MAAM,UAAU,cAAc,CAC5B,UAA6B,EAC7B,KAAoB;IAEpB,MAAM,GAAG,GAAG,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IACtD,OAAO,GAAG,KAAK,CAAC,KAAK,GAAG,eAAe,GAAG,KAAK,CAAC,KAAK,GAAG,eAAe,GAAG,GAAG,EAAE,CAAA;AACjF,CAAC;AAyHD,2EAA2E;AAC3E,4EAA4E;AAC5E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAA;AAEvC,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,KAAK,iBAAiB,CAAA;AAClC,CAAC;AAID,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;AAC9B,CAAC;AAED,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,YAAY,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAC1C,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACnE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAA4B,CAAA;IACjD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IACnF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW,CAAC;QACjB,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,KAAK,GAAI,IAA4B,CAAC,KAAK,CAAA;YACjD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAiB,CAAC,CAAC,CAAC,SAAS,CAAA;QACxE,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAA6C,CAAA;YACvE,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAC/C,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAA;YACjE,OAAO,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1C,CAAC;QACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAA6C,CAAA;YACvE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAC7E,OAAO,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QAC/C,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,OAAO,GAAI,IAA8B,CAAC,OAAO,CAAA;YACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBAAE,OAAO,SAAS,CAAA;YAC7C,MAAM,OAAO,GAAkB,EAAE,CAAA;YACjC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;gBAClC,IAAI,CAAC,KAAK;oBAAE,OAAO,SAAS,CAAA;gBAC5B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACrB,CAAC;YACD,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;QACxC,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAA+C,CAAA;YAC3E,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAClF,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;QACvC,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,MAAM,GAAG,YAAY,CAAE,IAA6B,CAAC,MAAM,CAAC,CAAA;YAClE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACrD,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAInC,CAAA;YACD,IAAI,OAAO,QAAQ,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAClD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YACjE,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YACnE,OAAO,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QACtD,CAAC;QACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAInC,CAAA;YACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAC/E,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAChD,OAAO,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1D,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAA+C,CAAA;YAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAC/E,OAAO,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC5C,CAAC;QACD,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QACrB;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,MAAe;IACnC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC3D,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,MAAiC,CAAA;IACtE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC/E,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IACtF,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,UAAU;YACb,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAG,MAA6B,CAAC,KAAK,EAAE,CAAA;QAClF,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,IAAI,GAAI,MAA6B,CAAC,IAAI,CAAA;YAChD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;QAClF,CAAC;QACD,KAAK,OAAO,CAAC;QACb,KAAK,KAAK;YACR,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,CAAA;QACrC;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACrD,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAgC,CAAA;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACrD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IACvE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,GAA8B,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,GAAG,OAAO,KAAK,CAAA;QACzB,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACnF,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/realtime/publisher.d.ts

@@ -1,28 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}

package/dist/realtime/publisher.js

@@ -1,309 +0,0 @@
-// The producer side of a streaming field.
-//
-// A producer opens one generation per field, pushes values, and finishes by
-// running the application's authoritative durable write. Orez never performs
-// that write: in a delegated-push deployment the application worker is the
-// write authority, so the commit is a callback the application supplies.
-//
-// The transport is injected. Trusted server code gets an in-process publisher
-// on the native and local hosts; on Cloudflare the same interface is backed by
-// one private service-bound producer WebSocket per generation.
-import { canonicalTopic } from './protocol.js';
-export class RealtimePublisher {
-    #transport;
-    #manifest;
-    #now;
-    #randomID;
-    constructor(transport, manifest, options = {}) {
-        this.#transport = transport;
-        this.#manifest = manifest;
-        this.#now = options.now ?? (() => Date.now());
-        this.#randomID = options.randomID ?? (() => crypto.randomUUID());
-    }
-    async begin(table, field, options) {
-        const spec = this.#manifest.fields.get(`${table}.${field}`);
-        if (!spec) {
-            throw new TypeError(`'${table}.${field}' is not a streaming field in this manifest`);
-        }
-        const topic = { table, key: options.key, field };
-        for (const column of spec.primaryKey) {
-            if (options.key[column] === undefined) {
-                throw new TypeError(`streaming topic '${table}.${field}' is missing primary key column '${column}'`);
-            }
-        }
-        const streamID = this.#randomID();
-        await this.#transport.begin(topic, streamID);
-        return new Session(this.#transport, spec, topic, canonicalTopic(spec.primaryKey, topic), streamID, this.#now);
-    }
-}
-class Session {
-    streamID;
-    topic;
-    #transport;
-    #spec;
-    #id;
-    #now;
-    #seq = 0;
-    // what the subscribers have been told, so append mode can ship the suffix
-    #delivered = '';
-    #started = false;
-    #closed = false;
-    #pending;
-    #inFlight = Promise.resolve();
-    // A background flush cannot reject into the caller's stack, so a transport
-    // failure (most often: this generation was superseded by a retry) is held
-    // here and raised on the next set/finish. Without this the failure would
-    // surface as an unhandled rejection and the producer would keep writing into
-    // a stream nobody accepts.
-    #failure;
-    constructor(transport, spec, topic, id, streamID, now) {
-        this.#transport = transport;
-        this.#spec = spec;
-        this.topic = topic;
-        this.#id = id;
-        this.streamID = streamID;
-        this.#now = now;
-        this.#pending = {
-            value: undefined,
-            windowBytes: 0,
-            windowUpdates: 0,
-            windowStartedAt: now(),
-            timer: undefined,
-            flushing: false,
-        };
-    }
-    set(value) {
-        this.#throwIfUnusable();
-        this.#validate(value);
-        this.#pending.value = value;
-        this.#schedule();
-    }
-    // Deliver whatever is pending now, waiting only as long as the manifest's
-    // rate bounds require. `set` is fire-and-forget by design so a token loop
-    // never awaits; this is for the places a producer needs the value to have
-    // actually left: a semantic checkpoint, or a deterministic test.
-    //
-    // It waits rather than bypassing the bound, so a producer calling flush in a
-    // loop still cannot exceed its declared maxUpdatesPerSecond.
-    async flush() {
-        this.#throwIfUnusable();
-        if (this.#pending.value === undefined)
-            return;
-        const delay = this.#delayUntilAllowed();
-        if (delay > 0)
-            await new Promise((resolve) => setTimeout(resolve, delay));
-        // A scheduled flush can fire during that wait, and if it failed then this
-        // generation is dead and its pending value was never delivered. Re-checking
-        // is what keeps flush() honest: it either delivered, or it throws. Without
-        // it the scheduled flush's suffix bookkeeping makes the retry here a no-op
-        // and the producer is told its value went out when it did not.
-        this.#throwIfUnusable();
-        this.#cancelTimer();
-        await this.#flush(false);
-    }
-    async finish(value, commit) {
-        this.#throwIfUnusable();
-        this.#validate(value);
-        this.#pending.value = value;
-        this.#cancelTimer();
-        // 1. flush the final value so subscribers see it before the commit round-trip
-        await this.#flush(true);
-        // 2. the application's authoritative durable write. Orez cannot do this
-        //    generically: in a delegated-push deployment the application worker is
-        //    the write authority.
-        await commit();
-        // 3. `end` puts every subscriber in `committing`, holding the final overlay
-        //    until their own Zero query produces the committed value. No waiting on
-        //    replication here: the client's durable-equality check is what ends the
-        //    overlay, and blocking the generation on replica observation would
-        //    couple producer lifetime to pull lag for no extra safety.
-        this.#closed = true;
-        await this.#emit({
-            topic: this.#id,
-            streamID: this.streamID,
-            seq: ++this.#seq,
-            op: 'end',
-        });
-        await this.#transport.end(this.streamID);
-    }
-    async abort() {
-        if (this.#closed)
-            return;
-        this.#closed = true;
-        this.#cancelTimer();
-        await this.#emit({
-            topic: this.#id,
-            streamID: this.streamID,
-            seq: ++this.#seq,
-            op: 'abort',
-        });
-        await this.#transport.end(this.streamID);
-    }
-    #throwIfUnusable() {
-        if (this.#failure)
-            throw this.#failure;
-        if (this.#closed)
-            throw new Error('streaming field generation is already closed');
-    }
-    #validate(value) {
-        if (this.#spec.mode === 'append' && typeof value !== 'string') {
-            throw new TypeError(`streaming field '${this.#spec.table}.${this.#spec.field}' is append mode and takes a string`);
-        }
-        if (this.#spec.validate && !this.#spec.validate(value)) {
-            throw new TypeError(`streaming field '${this.#spec.table}.${this.#spec.field}' rejected a value in validate()`);
-        }
-        const bytes = byteLength(typeof value === 'string' ? value : JSON.stringify(value ?? null));
-        if (bytes > this.#spec.maxBytes) {
-            throw new RangeError(`streaming field '${this.#spec.table}.${this.#spec.field}' value is ${bytes} bytes, over its ${this.#spec.maxBytes} maxBytes`);
-        }
-        if (this.#spec.mode === 'append' && this.#started) {
-            // append ships suffixes, so the value must only ever grow. A producer that
-            // rewrites history needs `mode: 'replace'`; silently shipping a bogus
-            // suffix would leave every subscriber with a corrupted value.
-            const next = value;
-            if (!next.startsWith(this.#delivered)) {
-                // A text column holding JSON is the common way to hit this: the
-                // manifest infers append from the Zero column type, but the producer
-                // replaces the value rather than extending it. Naming the fix here
-                // saves the reader from inferring it from a corrupted overlay.
-                throw new TypeError(`streaming field '${this.#spec.table}.${this.#spec.field}' is append mode, but its new value is not an extension of what was already sent. ` +
-                    `Append ships only the added suffix, so the value must grow. If this field is replaced rather than extended (a JSON payload in a text column, for example), declare mode: 'replace' for it in the manifest.`);
-            }
-        }
-    }
-    #schedule() {
-        if (this.#pending.timer || this.#pending.flushing || this.#failure)
-            return;
-        const delay = this.#delayUntilAllowed();
-        if (delay === 0) {
-            void this.#flush(false).catch((error) => this.#fail(error));
-            return;
-        }
-        this.#pending.timer = setTimeout(() => {
-            this.#pending.timer = undefined;
-            void this.#flush(false).catch((error) => this.#fail(error));
-        }, delay);
-    }
-    // How long before another update may go out, honouring BOTH manifest bounds.
-    // In append mode the byte budget is charged against new bytes only, which is
-    // what keeps a long generation's update rate flat instead of degrading as the
-    // accumulated value grows.
-    #delayUntilAllowed() {
-        const now = this.#now();
-        const elapsed = now - this.#pending.windowStartedAt;
-        if (elapsed >= 1000)
-            return 0;
-        const newBytes = this.#pendingBytes();
-        const overUpdates = this.#pending.windowUpdates >= this.#spec.maxUpdatesPerSecond;
-        const overBytes = this.#pending.windowBytes + newBytes > this.#spec.maxBytesPerSecond;
-        if (!overUpdates && !overBytes) {
-            // spread updates evenly rather than bursting then starving
-            const minGap = Math.floor(1000 / this.#spec.maxUpdatesPerSecond);
-            const sinceWindowStart = elapsed;
-            const expected = this.#pending.windowUpdates * minGap;
-            return Math.max(0, expected - sinceWindowStart);
-        }
-        return 1000 - elapsed;
-    }
-    #pendingBytes() {
-        const value = this.#pending.value;
-        if (this.#spec.mode === 'append') {
-            const text = value ?? '';
-            return byteLength(text.slice(this.#delivered.length));
-        }
-        return byteLength(JSON.stringify(value ?? null));
-    }
-    async #flush(final) {
-        const value = this.#pending.value;
-        if (value === undefined)
-            return;
-        this.#pending.flushing = true;
-        try {
-            const now = this.#now();
-            if (now - this.#pending.windowStartedAt >= 1000) {
-                this.#pending.windowStartedAt = now;
-                this.#pending.windowBytes = 0;
-                this.#pending.windowUpdates = 0;
-            }
-            let update;
-            if (this.#spec.mode === 'append' && this.#started) {
-                const text = value.slice(this.#delivered.length);
-                if (!text && !final)
-                    return;
-                update = {
-                    topic: this.#id,
-                    streamID: this.streamID,
-                    seq: ++this.#seq,
-                    op: 'append',
-                    text,
-                };
-                this.#delivered = value;
-            }
-            else {
-                update = {
-                    topic: this.#id,
-                    streamID: this.streamID,
-                    seq: ++this.#seq,
-                    op: 'snapshot',
-                    value,
-                };
-                this.#started = true;
-                this.#delivered = this.#spec.mode === 'append' ? value : '';
-            }
-            this.#pending.windowBytes += this.#pendingBytes();
-            this.#pending.windowUpdates++;
-            await this.#emit(update);
-        }
-        finally {
-            this.#pending.flushing = false;
-        }
-        // a value that arrived while this flush was in flight still needs sending
-        if (!final && this.#pendingHasNewBytes())
-            this.#schedule();
-    }
-    #pendingHasNewBytes() {
-        if (this.#spec.mode !== 'append')
-            return false;
-        const text = this.#pending.value ?? '';
-        return text.length > this.#delivered.length;
-    }
-    #cancelTimer() {
-        if (this.#pending.timer) {
-            clearTimeout(this.#pending.timer);
-            this.#pending.timer = undefined;
-        }
-    }
-    // Serialize every emit for the generation. WebSocket ordering owns frame
-    // order on the wire, but two overlapping flushes could otherwise hand the
-    // transport its frames out of sequence.
-    #emit(update) {
-        this.#inFlight = this.#inFlight.then(() => this.#transport.publish(update));
-        return this.#inFlight;
-    }
-    // Record a background failure and stop the generation. `finish` and `abort`
-    // await their emits directly, so they still reject into the caller; only the
-    // scheduled flushes route through here.
-    #fail(error) {
-        this.#failure = error instanceof Error ? error : new Error(String(error));
-        this.#closed = true;
-        this.#cancelTimer();
-    }
-}
-function byteLength(value) {
-    let bytes = 0;
-    for (let index = 0; index < value.length; index++) {
-        const code = value.charCodeAt(index);
-        if (code < 0x80)
-            bytes += 1;
-        else if (code < 0x800)
-            bytes += 2;
-        else if (code >= 0xd800 && code < 0xdc00) {
-            bytes += 4;
-            index++;
-        }
-        else
-            bytes += 3;
-    }
-    return bytes;
-}
-//# sourceMappingURL=publisher.js.map