orez-sync-executor 0.11.1 → 0.11.2

package/dist/realtime/publisher.js

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

package/dist/realtime/publisher.js.map

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

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

@@ -0,0 +1,25 @@
+import { RealtimeHub } from './hub.js';
+import type { HubOptions, RealtimeIdentity } from './hub.js';
+import type { RealtimeTopic } from './protocol.js';
+export type HostSocket = {
+    send(data: string): void;
+};
+export type HostConnection = {
+    handleMessage(raw: string): void;
+    close(): void;
+    topics(): readonly RealtimeTopic[];
+};
+export type RealtimeSocketHost = {
+    readonly hub: RealtimeHub;
+    acceptSubscriber(socket: HostSocket, identity: RealtimeIdentity, connectionID: string): HostConnection;
+    acceptProducer(socket: HostSocket, producerID: string): HostConnection;
+    rehydrate(entries: readonly {
+        socket: HostSocket;
+        identity: RealtimeIdentity;
+        connectionID: string;
+        topics: readonly RealtimeTopic[];
+    }[]): Promise<readonly HostConnection[]>;
+    flush(): void;
+};
+export declare function createSocketHost(options: HubOptions): RealtimeSocketHost;
+//# sourceMappingURL=socket-host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"socket-host.d.ts","sourceRoot":"","sources":["../../src/realtime/socket-host.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAGtC,OAAO,KAAK,EAA8B,UAAU,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AACxF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,CAAA;AAOD,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,KAAK,IAAI,IAAI,CAAA;IACb,MAAM,IAAI,SAAS,aAAa,EAAE,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;IAIzB,gBAAgB,CACd,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,gBAAgB,EAC1B,YAAY,EAAE,MAAM,GACnB,cAAc,CAAA;IAIjB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAAA;IAkBtE,SAAS,CACP,OAAO,EAAE,SAAS;QAChB,MAAM,EAAE,UAAU,CAAA;QAClB,QAAQ,EAAE,gBAAgB,CAAA;QAC1B,YAAY,EAAE,MAAM,CAAA;QACpB,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;KACjC,EAAE,GACF,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAA;IACrC,KAAK,IAAI,IAAI,CAAA;CACd,CAAA;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,kBAAkB,CA+FxE"}

package/dist/realtime/socket-host.js

@@ -0,0 +1,105 @@
+// The host role over sockets, for any runtime that has them.
+//
+// A Cloudflare Durable Object, a Node WebSocket server, and a test harness
+// differ in how they accept a socket and in nothing else. So this owns the
+// parts that are the same everywhere (which frames a role may send, when a
+// connection is dropped, what survives a cold start) and leaves each runtime
+// only its own socket lifecycle.
+//
+// The role split is enforced here rather than trusted. A subscriber socket is
+// accepted as a subscriber and can never publish, whatever it sends: it has no
+// producer handle, and the hub checks the handle rather than the frame. That is
+// why a leaked streamID grants nothing.
+import { applyClientFrame, applyProducerFrame } from './host.js';
+import { RealtimeHub } from './hub.js';
+import { decodeFrame, encodeFrame } from './protocol.js';
+export function createSocketHost(options) {
+    const hub = new RealtimeHub(options);
+    // One subscriber, whether it is being accepted for the first time or rebuilt
+    // after an eviction. Both paths need the same tracking, so neither gets its
+    // own copy of it.
+    const subscriber = (socket, identity, connectionID) => {
+        // keyed for dedup, valued with the structured topic so `topics()` can hand
+        // back something `rehydrate` accepts without a second parser
+        const owned = new Map();
+        const connection = {
+            id: connectionID,
+            identity,
+            send: (frame) => {
+                socket.send(encodeFrame(frame));
+            },
+        };
+        const host = {
+            handleMessage(raw) {
+                const frame = decodeFrame(raw);
+                if (!frame)
+                    return;
+                // A subscriber channel is never a publish channel, whatever arrives on
+                // it. Producer frames are not merely ignored by the hub here; they are
+                // refused before reaching it.
+                if (frame[0] !== 'subscribe' && frame[0] !== 'unsubscribe')
+                    return;
+                if (frame[0] === 'subscribe')
+                    owned.set(topicKey(frame[1].topic), frame[1].topic);
+                else
+                    owned.delete(topicKey(frame[1].topic));
+                void applyClientFrame(hub, connection, frame);
+            },
+            close() {
+                hub.dropConnection(connectionID);
+            },
+            topics: () => [...owned.values()],
+        };
+        return { connection, owned, host };
+    };
+    return {
+        hub,
+        acceptSubscriber: (socket, identity, connectionID) => subscriber(socket, identity, connectionID).host,
+        acceptProducer(socket, producerID) {
+            const producer = {
+                id: producerID,
+                send: (frame) => {
+                    socket.send(encodeFrame(frame));
+                },
+            };
+            return {
+                handleMessage(raw) {
+                    const frame = decodeFrame(raw);
+                    if (!frame)
+                        return;
+                    if (frame[0] !== 'begin' && frame[0] !== 'publish')
+                        return;
+                    applyProducerFrame(hub, producer, frame);
+                },
+                close() {
+                    hub.dropProducer(producerID);
+                },
+                topics: () => [],
+            };
+        },
+        async rehydrate(entries) {
+            const restored = [];
+            for (const entry of entries) {
+                const { connection, owned, host } = subscriber(entry.socket, entry.identity, entry.connectionID);
+                for (const topic of entry.topics) {
+                    // recorded before the result, exactly as a live subscribe frame does:
+                    // a topic denied during the gap stays the client's asserted interest,
+                    // so a membership that comes back is picked up at the next eviction
+                    // instead of being forgotten here.
+                    owned.set(topicKey(topic), topic);
+                    await hub.subscribe(connection, topic);
+                }
+                restored.push(host);
+            }
+            return restored;
+        },
+        flush: () => hub.flush(),
+    };
+}
+// Dedup key only. Never persisted and never parsed back: `topics()` hands out
+// the structured topic, so there is no second encoding to keep in agreement
+// with canonicalTopic.
+function topicKey(topic) {
+    return JSON.stringify(topic);
+}
+//# sourceMappingURL=socket-host.js.map

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

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

package/dist/realtime/store.d.ts

@@ -0,0 +1,28 @@
+import type { StreamingFieldHandle } from './manifest.js';
+import type { FieldUpdate } from './protocol.js';
+export type StreamingPhase = 'committing' | 'durable' | 'stale' | 'streaming';
+export type StreamingFieldState<Value> = {
+    readonly value: Value;
+    readonly phase: StreamingPhase;
+    readonly streamID: string | null;
+};
+export declare function canonicalEncode(value: unknown): string;
+export type RealtimeStoreOptions = {
+    readonly send: (frame: unknown) => void;
+    readonly staleAfterMs?: number;
+    readonly onError?: (message: string) => void;
+};
+export declare class RealtimeStore {
+    #private;
+    constructor(options: RealtimeStoreOptions);
+    subscribe(handle: StreamingFieldHandle, listener: () => void): () => void;
+    read<Value>(handle: StreamingFieldHandle, base: Value): StreamingFieldState<Value>;
+    applyUpdates(updates: readonly FieldUpdate[]): void;
+    handleSubscribed(topic: string, status: 'active' | 'pending'): void;
+    handleSubscribeError(topic: string, reason: string): void;
+    retryPending(): void;
+    handleDisconnect(): void;
+    handleReconnect(): void;
+    get topicCount(): number;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/realtime/store.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,oBAAoB,EAAsB,MAAM,eAAe,CAAA;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,eAAe,CAAA;AAE/D,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAA;AAE7E,MAAM,MAAM,mBAAmB,CAAC,KAAK,IAAI;IACvC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC,CAAA;AA0CD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGtD;AAaD,MAAM,MAAM,oBAAoB,GAAG;IAEjC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAI9B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7C,CAAA;AAED,qBAAa,aAAa;;gBASZ,OAAO,EAAE,oBAAoB;IASzC,SAAS,CAAC,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAsCzE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAE,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC;IAkDlF,YAAY,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI;IAqInD,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI;IAcnE,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAiBzD,YAAY,IAAI,IAAI;IAUpB,gBAAgB,IAAI,IAAI;IAYxB,eAAe,IAAI,IAAI;IAOvB,IAAI,UAAU,IAAI,MAAM,CAEvB;CACF"}

package/dist/realtime/store.js.map

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

package/dist/realtime/writer.d.ts

@@ -0,0 +1,17 @@
+import type { StreamingFieldHandle } from './manifest.js';
+import type { RealtimeTopic } from './protocol.js';
+import type { RealtimePublisher } from './publisher.js';
+export type FieldWriterOptions = {
+    readonly onError?: (error: Error, topic: RealtimeTopic) => void;
+};
+export declare class FieldWriter {
+    #private;
+    constructor(publisher: RealtimePublisher, options?: FieldWriterOptions);
+    set(handle: StreamingFieldHandle, value: unknown): void;
+    flush(handle: StreamingFieldHandle): Promise<void>;
+    finish(handle: StreamingFieldHandle, value: unknown, commit: () => Promise<void>): Promise<void>;
+    abort(handle: StreamingFieldHandle): Promise<void>;
+    isStreaming(handle: StreamingFieldHandle): boolean;
+    abortAll(): Promise<void>;
+}
+//# sourceMappingURL=writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/realtime/writer.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,gBAAgB,CAAA;AAUtE,MAAM,MAAM,kBAAkB,GAAG;IAI/B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;CAChE,CAAA;AAED,qBAAa,WAAW;;gBAKV,SAAS,EAAE,iBAAiB,EAAE,OAAO,GAAE,kBAAuB;IAqB1E,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAwCjD,KAAK,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD,MAAM,CACV,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC;IAqBV,KAAK,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxD,WAAW,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO;IAQ5C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAiBhC"}