orez-sync-executor 0.11.1 → 0.11.2

package/dist/realtime/host.d.ts

@@ -0,0 +1,7 @@
+import type { RealtimeHub, HubConnection, HubProducer } from './hub.js';
+import type { ClientFrame, HostFrame, ProducerFrame } from './protocol.js';
+import type { RealtimeStore } from './store.js';
+export declare function applyClientFrame(hub: RealtimeHub, connection: HubConnection, frame: ClientFrame): Promise<void>;
+export declare function applyProducerFrame(hub: RealtimeHub, producer: HubProducer, frame: ProducerFrame): void;
+export declare function applyHostFrame(store: RealtimeStore, frame: HostFrame): void;
+//# sourceMappingURL=host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/realtime/host.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACvE,OAAO,KAAK,EAAE,WAAW,EAAe,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAK/C,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,aAAa,EACzB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAIf;AAQD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,aAAa,GACnB,IAAI,CAuBN;AASD,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAc3E"}

package/dist/realtime/host.js

@@ -0,0 +1,77 @@
+// Frame routing. Every realtime surface is built from these three functions.
+//
+// A stream has exactly three directions, and there is one applier for each:
+//
+//   applyClientFrame    subscriber -> hub    subscribe, unsubscribe
+//   applyProducerFrame  producer   -> hub    begin, publish
+//   applyHostFrame      hub        -> store  subscribed, field, subscribe-error
+//
+// Everything else in a surface is channel plumbing: a MessagePort, a
+// WebSocket, or a direct call. Keeping the routing here is what lets a new
+// transport be written without re-deriving which frame maps to which call, and
+// it is why adding one cannot quietly disagree with the others.
+//
+// Subscribers and producers are deliberately separate roles with separate
+// frames. A subscriber socket can never publish, so a leaked streamID buys an
+// attacker nothing: the hub checks the producer HANDLE, and a subscriber does
+// not have one.
+// Apply one subscriber frame. The returned promise resolves when the frame has
+// been applied, which an adapter awaits before processing the next frame from
+// the same socket so a subscribe/unsubscribe pair cannot land out of order.
+export function applyClientFrame(hub, connection, frame) {
+    return frame[0] === 'subscribe'
+        ? hub.subscribe(connection, frame[1].topic)
+        : hub.unsubscribe(connection, frame[1].topic);
+}
+// Apply one producer frame.
+//
+// `begin` is answered either way: the producer cannot start streaming until it
+// knows the host accepted the generation. Updates are answered only when
+// rejected, so a token stream costs one frame per token rather than a round
+// trip per token.
+export function applyProducerFrame(hub, producer, frame) {
+    if (frame[0] === 'begin') {
+        const { topic, streamID } = frame[1];
+        const result = hub.beginGeneration(producer, topic, streamID);
+        producer.send([
+            'begin-result',
+            {
+                streamID,
+                topic: result.ok ? result.topicID : null,
+                reason: result.ok ? null : result.reason,
+            },
+        ]);
+        return;
+    }
+    const { update } = frame[1];
+    const result = hub.publish(producer, update);
+    if (!result.ok) {
+        producer.send([
+            'publish-rejected',
+            { topic: update.topic, streamID: update.streamID, reason: result.reason },
+        ]);
+    }
+}
+// Apply one frame the host sent back to a subscriber. Every client transport
+// ends in this call, so a MessagePort client and a WebSocket client cannot drift
+// apart in how they interpret the same frame.
+//
+// A `wake` frame is deliberately ignored here: it belongs to the Zero pull path,
+// not to the field overlay, and a client that shares one socket for both routes
+// it before reaching this.
+export function applyHostFrame(store, frame) {
+    switch (frame[0]) {
+        case 'field':
+            store.applyUpdates(frame[1].updates);
+            return;
+        case 'subscribed':
+            store.handleSubscribed(frame[1].topic, frame[1].status);
+            return;
+        case 'subscribe-error':
+            store.handleSubscribeError(frame[1].topic, frame[1].reason);
+            return;
+        case 'wake':
+            return;
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/realtime/host.js.map

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

package/dist/realtime/hub.d.ts

@@ -0,0 +1,67 @@
+import type { StreamingFieldSpec, StreamingManifest } from './manifest.js';
+import type { FieldUpdate, RealtimeTopic } from './protocol.js';
+export type RealtimeIdentity = {
+    readonly userID: string;
+    readonly clientID: string;
+    readonly clientGroupID: string;
+};
+export interface HubConnection {
+    readonly id: string;
+    readonly identity: RealtimeIdentity;
+    send(frame: unknown): void;
+}
+export interface HubProducer {
+    readonly id: string;
+    send(frame: unknown): void;
+}
+export type SubscribeAuthorization = {
+    readonly status: 'active' | 'pending';
+} | {
+    readonly status: 'denied';
+    readonly reason: string;
+};
+export type HubLimits = {
+    readonly maxTopicsPerConnection: number;
+    readonly maxSubscribersPerTopic: number;
+    readonly maxTopicsPerNamespace: number;
+    readonly maxBatchBytes: number;
+    readonly batchWindowMs: number;
+};
+export declare const DEFAULT_HUB_LIMITS: HubLimits;
+export type HubOptions = {
+    readonly manifest: StreamingManifest;
+    readonly authorizeSubscribe: (identity: RealtimeIdentity, topic: RealtimeTopic, spec: StreamingFieldSpec) => Promise<SubscribeAuthorization> | SubscribeAuthorization;
+    readonly limits?: Partial<HubLimits>;
+    readonly scheduleFlush?: (flush: () => void, ms: number) => void;
+};
+export declare class RealtimeHub {
+    #private;
+    constructor(options: HubOptions);
+    subscribe(connection: HubConnection, topic: RealtimeTopic): Promise<void>;
+    unsubscribe(connection: HubConnection, topic: RealtimeTopic): Promise<void>;
+    dropConnection(connectionID: string): void;
+    revokeMembership(clientGroupID: string, removed: readonly RealtimeTopic[]): void;
+    revokeAllForGroup(clientGroupID: string): void;
+    beginGeneration(producer: HubProducer, topic: RealtimeTopic, streamID: string): {
+        readonly ok: true;
+        readonly topicID: string;
+    } | {
+        readonly ok: false;
+        readonly reason: string;
+    };
+    publish(producer: HubProducer, update: FieldUpdate): {
+        readonly ok: true;
+    } | {
+        readonly ok: false;
+        readonly reason: string;
+    };
+    dropProducer(producerID: string): void;
+    flush(): void;
+    get activeTopics(): number;
+    get subscribedTopics(): number;
+    generationFor(topicID: string): {
+        readonly streamID: string;
+        readonly seq: number;
+    } | undefined;
+}
+//# sourceMappingURL=hub.d.ts.map

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

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

package/dist/realtime/hub.js

@@ -0,0 +1,456 @@
+// The host-side realtime hub: one pure state machine shared by every
+// TypeScript host (the Cloudflare Durable Object and the browser worker).
+//
+// It owns no I/O. Connections are opaque handles with a `send`, so the same
+// logic drives a hibernatable WebSocket, a MessagePort, and a test harness. A
+// host adapter is then only socket lifecycle plus authentication.
+//
+// The hub ACCUMULATES each generation's value. That is what makes append-mode
+// frames safe: a subscriber arriving at token 900 gets one snapshot of what the
+// hub has, then appends, and no client ever needs a replay buffer. It is also
+// why a lost frame cannot produce a wrong value, since the next snapshot after
+// any reconnect is authoritative.
+import { resolveTopic } from './manifest.js';
+import { canonicalEncode } from './store.js';
+export const DEFAULT_HUB_LIMITS = {
+    maxTopicsPerConnection: 256,
+    maxSubscribersPerTopic: 512,
+    maxTopicsPerNamespace: 4096,
+    maxBatchBytes: 512 * 1024,
+    batchWindowMs: 25,
+};
+export class RealtimeHub {
+    #manifest;
+    #authorize;
+    #limits;
+    #schedule;
+    #generations = new Map();
+    #subscribers = new Map();
+    #connectionTopics = new Map();
+    #connections = new Map();
+    // producer id -> every generation it currently leases. An application server
+    // streaming twenty agent sessions holds one connection, not twenty, so the
+    // lease is a set: the socket closing releases all of them at once.
+    #producerGenerations = new Map();
+    // per-connection outbound batch, flushed on the batching window
+    #outbox = new Map();
+    #flushScheduled = false;
+    // One chain per connection so its subscribe and unsubscribe frames apply in
+    // arrival order even though authorization may await. Without it, a
+    // subscribe/unsubscribe pair sent back to back could resolve out of order and
+    // leave a connection subscribed to a topic it had already dropped.
+    #connectionQueue = new Map();
+    // Bumped by dropConnection. A subscribe captures the epoch when the frame
+    // ARRIVES, not when its queued task runs, so a socket that closes while its
+    // authorization is still in flight abandons the subscription instead of
+    // completing it against a connection nobody is reading from.
+    #connectionEpoch = new Map();
+    constructor(options) {
+        this.#manifest = options.manifest;
+        this.#authorize = options.authorizeSubscribe;
+        this.#limits = { ...DEFAULT_HUB_LIMITS, ...options.limits };
+        this.#schedule =
+            options.scheduleFlush ??
+                ((flush, ms) => {
+                    setTimeout(flush, ms);
+                });
+    }
+    // ---- subscribers --------------------------------------------------------
+    // Queued per connection: the returned promise resolves once this frame has
+    // been applied, which is what a host adapter awaits before processing the
+    // next frame from the same socket.
+    subscribe(connection, topic) {
+        const epoch = this.#connectionEpoch.get(connection.id) ?? 0;
+        return this.#enqueue(connection.id, () => this.#subscribe(connection, topic, epoch));
+    }
+    unsubscribe(connection, topic) {
+        return this.#enqueue(connection.id, () => {
+            const resolved = resolveTopic(this.#manifest, topic);
+            if ('reason' in resolved)
+                return;
+            this.#removeSubscription(connection.id, resolved.id);
+        });
+    }
+    #enqueue(connectionID, task) {
+        const previous = this.#connectionQueue.get(connectionID) ?? Promise.resolve();
+        // a rejected task must not poison the chain for later frames
+        const next = previous.then(task).catch(() => { });
+        this.#connectionQueue.set(connectionID, next);
+        return next;
+    }
+    #isCurrent(connectionID, epoch) {
+        return (this.#connectionEpoch.get(connectionID) ?? 0) === epoch;
+    }
+    async #subscribe(connection, topic, epoch) {
+        if (!this.#isCurrent(connection.id, epoch))
+            return;
+        this.#connections.set(connection.id, connection);
+        const resolved = resolveTopic(this.#manifest, topic);
+        if ('reason' in resolved) {
+            connection.send([
+                'subscribe-error',
+                { topic: describe(topic), reason: resolved.reason },
+            ]);
+            return;
+        }
+        const { spec, id } = resolved;
+        const owned = this.#connectionTopics.get(connection.id) ?? new Set();
+        // a resubscribe after reconnect is not a new subscription
+        if (!owned.has(id)) {
+            if (owned.size >= this.#limits.maxTopicsPerConnection) {
+                connection.send([
+                    'subscribe-error',
+                    { topic: id, reason: 'connection is at its subscription limit' },
+                ]);
+                return;
+            }
+            if (!this.#subscribers.has(id) &&
+                this.#subscribers.size >= this.#limits.maxTopicsPerNamespace) {
+                connection.send([
+                    'subscribe-error',
+                    { topic: id, reason: 'namespace is at its active topic limit' },
+                ]);
+                return;
+            }
+            const existing = this.#subscribers.get(id);
+            if (existing && existing.size >= this.#limits.maxSubscribersPerTopic) {
+                connection.send([
+                    'subscribe-error',
+                    { topic: id, reason: 'topic is at its subscriber limit' },
+                ]);
+                return;
+            }
+        }
+        const authorization = await this.#authorize(connection.identity, topic, spec);
+        // the socket can close while authorization is in flight
+        if (!this.#isCurrent(connection.id, epoch))
+            return;
+        if (authorization.status === 'denied') {
+            connection.send(['subscribe-error', { topic: id, reason: authorization.reason }]);
+            return;
+        }
+        owned.add(id);
+        this.#connectionTopics.set(connection.id, owned);
+        if (authorization.status === 'active') {
+            let subscribers = this.#subscribers.get(id);
+            if (!subscribers) {
+                subscribers = new Set();
+                this.#subscribers.set(id, subscribers);
+            }
+            subscribers.add(connection);
+        }
+        connection.send(['subscribed', { topic: id, status: authorization.status }]);
+        // catch a new subscriber up on a generation already in flight. This is what
+        // lets append-mode frames be safe for late joiners, and it is sent
+        // immediately rather than batched so a mid-stream mount paints at once.
+        const generation = this.#generations.get(id);
+        if (authorization.status === 'active' && generation) {
+            connection.send([
+                'field',
+                {
+                    updates: [
+                        {
+                            topic: id,
+                            streamID: generation.streamID,
+                            seq: generation.seq,
+                            op: 'snapshot',
+                            value: generation.value,
+                        },
+                    ],
+                },
+            ]);
+        }
+    }
+    dropConnection(connectionID) {
+        this.#connectionEpoch.set(connectionID, (this.#connectionEpoch.get(connectionID) ?? 0) + 1);
+        this.#connectionQueue.delete(connectionID);
+        for (const topicID of this.#connectionTopics.get(connectionID) ?? []) {
+            this.#subscribers.get(topicID)?.forEach((connection) => {
+                if (connection.id === connectionID)
+                    this.#subscribers.get(topicID).delete(connection);
+            });
+            if (this.#subscribers.get(topicID)?.size === 0)
+                this.#subscribers.delete(topicID);
+        }
+        this.#connectionTopics.delete(connectionID);
+        this.#connections.delete(connectionID);
+        this.#outbox.delete(connectionID);
+    }
+    #removeSubscription(connectionID, topicID) {
+        this.#connectionTopics.get(connectionID)?.delete(topicID);
+        const subscribers = this.#subscribers.get(topicID);
+        if (!subscribers)
+            return;
+        for (const connection of subscribers) {
+            if (connection.id === connectionID)
+                subscribers.delete(connection);
+        }
+        if (subscribers.size === 0)
+            this.#subscribers.delete(topicID);
+    }
+    // A pull removed rows from a client group's query membership. The client is
+    // about to learn the row left its query, so its field subscriptions for those
+    // rows go with it, in the same update rather than on a later sweep.
+    revokeMembership(clientGroupID, removed) {
+        for (const topic of removed) {
+            const resolved = resolveTopic(this.#manifest, topic);
+            if ('reason' in resolved)
+                continue;
+            const subscribers = this.#subscribers.get(resolved.id);
+            if (!subscribers)
+                continue;
+            for (const connection of [...subscribers]) {
+                if (connection.identity.clientGroupID !== clientGroupID)
+                    continue;
+                this.#removeSubscription(connection.id, resolved.id);
+                connection.send([
+                    'subscribe-error',
+                    { topic: resolved.id, reason: 'row left your authorized query membership' },
+                ]);
+            }
+        }
+    }
+    // Every row a client group can currently subscribe to left its membership.
+    // Cheaper than enumerating rows when a whole query is dropped.
+    revokeAllForGroup(clientGroupID) {
+        for (const [topicID, subscribers] of [...this.#subscribers]) {
+            for (const connection of [...subscribers]) {
+                if (connection.identity.clientGroupID !== clientGroupID)
+                    continue;
+                this.#removeSubscription(connection.id, topicID);
+                connection.send([
+                    'subscribe-error',
+                    { topic: topicID, reason: 'row left your authorized query membership' },
+                ]);
+            }
+        }
+    }
+    // ---- producers ----------------------------------------------------------
+    // Open a generation. A newer generation always supersedes an older one for
+    // the same topic, matching how an LLM retry replaces its predecessor. The
+    // application still owns final-write fencing in the database; this only
+    // decides who may deliver display values.
+    beginGeneration(producer, topic, streamID) {
+        const resolved = resolveTopic(this.#manifest, topic);
+        if ('reason' in resolved)
+            return { ok: false, reason: resolved.reason };
+        const { spec, id } = resolved;
+        const previous = this.#generations.get(id);
+        if (previous && previous.streamID !== streamID) {
+            if (previous.producer) {
+                this.#releaseLease(previous.producer.id, id);
+                previous.producer.send(['superseded', { topic: id, streamID: previous.streamID }]);
+            }
+        }
+        this.#generations.set(id, {
+            topicID: id,
+            spec,
+            streamID,
+            seq: -1,
+            value: spec.mode === 'append' ? '' : null,
+            producer,
+        });
+        const leases = this.#producerGenerations.get(producer.id);
+        if (leases)
+            leases.add(id);
+        else
+            this.#producerGenerations.set(producer.id, new Set([id]));
+        return { ok: true, topicID: id };
+    }
+    // Accept one update from a producer, accumulate it, and fan it out. The
+    // rejection REASON is returned rather than a bare false: a producer that is
+    // told only "refused" has to guess between supersession, a stale sequence, and
+    // a manifest bound, and every adapter was inventing the same vague guess.
+    publish(producer, update) {
+        const generation = this.#generations.get(update.topic);
+        if (!generation) {
+            return { ok: false, reason: `no open generation for '${update.topic}'` };
+        }
+        // Only the producer holding this generation may publish. A subscriber
+        // socket is never a producer, so a leaked streamID grants nothing: the check
+        // is on the producer handle, not the frame contents. A superseded generation
+        // needs no flag of its own, because beginGeneration REPLACED it in this map;
+        // its old producer falls out here, and its old stream id falls out below.
+        if (generation.producer?.id !== producer.id) {
+            return { ok: false, reason: `another producer holds '${update.topic}'` };
+        }
+        if (generation.streamID !== update.streamID) {
+            return {
+                ok: false,
+                reason: `stream ${update.streamID} is not the current generation for '${update.topic}'`,
+            };
+        }
+        if (update.seq <= generation.seq) {
+            return {
+                ok: false,
+                reason: `seq ${update.seq} is not newer than the delivered ${generation.seq}`,
+            };
+        }
+        switch (update.op) {
+            case 'snapshot': {
+                if (!this.#validate(generation.spec, update.value)) {
+                    return {
+                        ok: false,
+                        reason: `value failed the manifest bounds for '${update.topic}'`,
+                    };
+                }
+                generation.value = update.value;
+                break;
+            }
+            case 'append': {
+                if (generation.spec.mode !== 'append') {
+                    return {
+                        ok: false,
+                        reason: `'${update.topic}' is replace mode and takes no appends`,
+                    };
+                }
+                const next = generation.value + update.text;
+                if (byteLength(next) > generation.spec.maxBytes) {
+                    return {
+                        ok: false,
+                        reason: `append would exceed maxBytes for '${update.topic}'`,
+                    };
+                }
+                generation.value = next;
+                break;
+            }
+            case 'end':
+            case 'abort':
+                break;
+        }
+        generation.seq = update.seq;
+        this.#fanOut(update);
+        if (update.op === 'end' || update.op === 'abort') {
+            this.#generations.delete(update.topic);
+            this.#releaseLease(producer.id, update.topic);
+        }
+        return { ok: true };
+    }
+    #releaseLease(producerID, topicID) {
+        const leases = this.#producerGenerations.get(producerID);
+        if (!leases)
+            return;
+        leases.delete(topicID);
+        if (leases.size === 0)
+            this.#producerGenerations.delete(producerID);
+    }
+    // A producer socket closed without a terminal frame (a crash, or a lost
+    // connection). The generation's lease is released so the next `begin` is
+    // clean; subscribers fall back to their inactivity deadline, which reveals
+    // the durable value rather than inventing a recovery value here.
+    dropProducer(producerID) {
+        const leases = this.#producerGenerations.get(producerID);
+        this.#producerGenerations.delete(producerID);
+        if (!leases)
+            return;
+        for (const topicID of leases) {
+            const generation = this.#generations.get(topicID);
+            if (generation?.producer?.id === producerID)
+                this.#generations.delete(topicID);
+        }
+    }
+    #validate(spec, value) {
+        if (spec.mode === 'append' && typeof value !== 'string')
+            return false;
+        if (spec.validate && !spec.validate(value))
+            return false;
+        return byteLength(canonicalEncode(value)) <= spec.maxBytes;
+    }
+    #fanOut(update) {
+        const subscribers = this.#subscribers.get(update.topic);
+        if (!subscribers || subscribers.size === 0)
+            return;
+        for (const connection of subscribers) {
+            const batch = this.#outbox.get(connection.id);
+            if (batch)
+                batch.push(update);
+            else
+                this.#outbox.set(connection.id, [update]);
+        }
+        this.#scheduleFlush();
+    }
+    // The "is a flush already pending" flag is separate from the cancel handle
+    // because a scheduler is allowed to run its callback SYNCHRONOUSLY, which the
+    // local in-process host does (there is no socket, so there is nothing to
+    // batch for). In that case flush() completes during the schedule call and
+    // clears its state before the handle could be assigned, so guarding on the
+    // handle alone left it permanently set and no later batch was ever scheduled.
+    #scheduleFlush() {
+        if (this.#flushScheduled)
+            return;
+        this.#flushScheduled = true;
+        this.#schedule(() => this.flush(), this.#limits.batchWindowMs);
+    }
+    // Deliver every pending batch. Public so an adapter can force a flush before
+    // it lets its runtime go idle.
+    flush() {
+        this.#flushScheduled = false;
+        if (this.#outbox.size === 0)
+            return;
+        const outbox = [...this.#outbox];
+        this.#outbox.clear();
+        let requeued = false;
+        for (const [connectionID, updates] of outbox) {
+            const connection = this.#connections.get(connectionID);
+            if (!connection)
+                continue;
+            // Stop a batch before it exceeds the frame ceiling; the rest goes in the
+            // next frame rather than being dropped or sent as one oversized frame.
+            let bytes = 0;
+            let cut = updates.length;
+            for (let index = 0; index < updates.length; index++) {
+                bytes += updateBytes(updates[index]);
+                if (bytes > this.#limits.maxBatchBytes && index > 0) {
+                    cut = index;
+                    break;
+                }
+            }
+            connection.send(['field', { updates: updates.slice(0, cut) }]);
+            if (cut < updates.length) {
+                this.#outbox.set(connectionID, updates.slice(cut));
+                requeued = true;
+            }
+        }
+        if (requeued)
+            this.#scheduleFlush();
+    }
+    // ---- introspection for adapters and tests -------------------------------
+    get activeTopics() {
+        return this.#generations.size;
+    }
+    get subscribedTopics() {
+        return this.#subscribers.size;
+    }
+    generationFor(topicID) {
+        const generation = this.#generations.get(topicID);
+        return generation ? { streamID: generation.streamID, seq: generation.seq } : undefined;
+    }
+}
+function describe(topic) {
+    return `${topic.table}.${topic.field}`;
+}
+function updateBytes(update) {
+    if (update.op === 'append')
+        return byteLength(update.text) + 96;
+    if (update.op === 'snapshot')
+        return byteLength(canonicalEncode(update.value)) + 96;
+    return 96;
+}
+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=hub.js.map

package/dist/realtime/hub.js.map

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