@edryslabs/genericprovider 1.0.4 → 1.5.2

package/dist/providers/ably/index.js

@@ -0,0 +1,561 @@
+/**
+ * Ably Transport Provider
+ *
+ * Real-time synchronization using Ably's managed pub/sub messaging platform.
+ *
+ * Features:
+ * - Global edge network with low latency
+ * - Built-in presence tracking
+ * - API-key or token-based authentication
+ * - Optional password-protected rooms (channel name obfuscation)
+ * - Automatic chunking for messages above Ably's size limit
+ *
+ * The Ably SDK class is injected via the constructor (not imported directly)
+ * so this file compiles without the `ably` package installed, and consumers
+ * only pull in Ably if they actually use this provider.
+ *
+ * @example
+ * ```typescript
+ * import * as Y from 'yjs'
+ * import { GenericProvider } from 'y-generic'
+ * import { AblyTransport } from 'y-generic/providers/ably'
+ * import * as Ably from 'ably'
+ *
+ * const doc = new Y.Doc()
+ * const transport = new AblyTransport({ Realtime: Ably.Realtime })
+ * const provider = new GenericProvider(doc, transport)
+ *
+ * await provider.connect({
+ *   apiKey: 'your-ably-api-key',
+ *   room: 'my-collab-room',
+ * })
+ * ```
+ *
+ * @example Token auth (recommended for browser clients)
+ * ```typescript
+ * await provider.connect({
+ *   authUrl: '/api/ably-token',
+ *   room: 'my-collab-room',
+ * })
+ * ```
+ */
+import * as encoding from 'lib0/encoding';
+import * as syncProtocol from 'y-protocols/sync';
+// ---------------------------------------------------------------------------
+// CRC32 translation helpers
+//
+// GenericProvider wraps every outgoing message as [CRC32 (4 bytes)][payload].
+// Ably message data is JSON-friendly, so we strip the CRC32 header before
+// base64-encoding and re-add it after decoding so GenericProvider accepts
+// the incoming message.
+// ---------------------------------------------------------------------------
+const _CRC32_TABLE = (() => {
+    const table = new Uint32Array(256);
+    for (let i = 0; i < 256; i++) {
+        let c = i;
+        for (let j = 0; j < 8; j++)
+            c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        table[i] = c;
+    }
+    return table;
+})();
+function _crc32(data) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < data.length; i++)
+        crc = (crc >>> 8) ^ _CRC32_TABLE[(crc ^ data[i]) & 0xff];
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/** Strip the 4-byte CRC32 header that GenericProvider prepends. */
+function stripCRC32Header(data) {
+    return data.length >= 4 ? data.subarray(4) : data;
+}
+/** Add a valid CRC32 header so GenericProvider accepts the message. */
+function addCRC32Header(data) {
+    const crc = _crc32(data);
+    const wrapped = new Uint8Array(4 + data.length);
+    wrapped[0] = (crc >>> 24) & 0xff;
+    wrapped[1] = (crc >>> 16) & 0xff;
+    wrapped[2] = (crc >>> 8) & 0xff;
+    wrapped[3] = crc & 0xff;
+    wrapped.set(data, 4);
+    return wrapped;
+}
+// ---------------------------------------------------------------------------
+// Base64 helpers (no Buffer/Node dependency)
+// ---------------------------------------------------------------------------
+function uint8ToBase64(data) {
+    const chunkSize = 8192; // Process 8KB at a time to avoid arg-count overflow
+    let binary = '';
+    for (let i = 0; i < data.length; i += chunkSize) {
+        const chunk = data.subarray(i, Math.min(i + chunkSize, data.length));
+        binary += String.fromCharCode(...chunk);
+    }
+    return btoa(binary);
+}
+function base64ToUint8(str) {
+    const binary = atob(str);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+// ---------------------------------------------------------------------------
+// Password hashing (obfuscates channel name — not encryption)
+// ---------------------------------------------------------------------------
+async function hashPassword(password) {
+    const encoded = new TextEncoder().encode(password);
+    const hashBuffer = await crypto.subtle.digest('SHA-256', encoded);
+    return Array.from(new Uint8Array(hashBuffer))
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('')
+        .substring(0, 16);
+}
+function generateUUID() {
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+const EVENT_NAME = 'yjs-update';
+// Ably's default max message size is ~64 KiB; stay well under it. Used both
+// as a base64-string cap for send()'s pub/sub chunking, and as a raw-byte
+// cap for the persistence snapshot's LiveMap chunking (LiveMap values are
+// raw ArrayBuffer/Buffer, no base64 inflation, so the same conservative
+// number is a safe threshold for both).
+const MAX_MESSAGE_SIZE = 55000;
+// Message type identifiers (must match GenericProvider's wire format).
+const MESSAGE_AWARENESS = 1;
+/**
+ * Ably transport for y-generic.
+ *
+ * Publishes Yjs binary updates as base64-encoded messages on an Ably channel
+ * and subscribes to matching messages from peers.
+ */
+export class AblyTransport {
+    constructor(options) {
+        this.client = null;
+        this.channel = null;
+        this.clientId = '';
+        this.channelName = '';
+        this._isConnected = false;
+        this.debug = false;
+        this.messageBuffer = [];
+        this.chunkBuffer = new Map();
+        // No preferredCompressMinBytes: this transport strips the CRC32 header
+        // and synthesizes frames from persisted snapshots, both of which assume
+        // the uncompressed frame layout (see compressionThresholdBytes).
+        // Persistence
+        this.persistentMode = false;
+        this.persistDoc = null;
+        this.persistDebounceMs = 2000;
+        this.isWritingSnapshot = false;
+        this.savePending = false;
+        /** True once loadSnapshot()'s initial read has completed */
+        this.snapshotLoaded = false;
+        /** Cached LiveObjects root, resolved once per connect() */
+        this.liveRoot = null;
+        this.opts = options;
+    }
+    get isConnected() {
+        return this._isConnected;
+    }
+    async connect(config) {
+        this.debug = config.debug ?? this.opts.debug ?? false;
+        if (!config.apiKey && !config.authUrl) {
+            throw new Error('AblyTransport: apiKey or authUrl is required');
+        }
+        if (!config.room) {
+            throw new Error('AblyTransport: room name is required');
+        }
+        this.persistentMode = config.persistent ?? false;
+        this.persistDoc = config.doc ?? null;
+        this.persistDebounceMs = config.persistDebounceMs ?? 2000;
+        if (this.persistentMode && !this.persistDoc) {
+            throw new Error('AblyTransport: a Y.Doc must be provided via config.doc when persistent is true');
+        }
+        if (this.persistentMode && !this.opts.LiveObjects) {
+            throw new Error('AblyTransport: the "LiveObjects" plugin class must be provided via constructor options when persistent is true. ' +
+                'import { LiveObjects } from "ably/liveobjects"; new AblyTransport({ Realtime, LiveObjects })');
+        }
+        this.clientId = generateUUID();
+        this.channelName = config.password
+            ? `${config.room}-${await hashPassword(config.password)}`
+            : config.room;
+        // Don't deliver our own published messages back to ourselves — except
+        // in persistent mode, where Ably's LiveObjects requires echoMessages to
+        // be enabled for write operations (root.set() throws otherwise). Any
+        // resulting self-echo of our own pub/sub messages is harmless:
+        // GenericProvider applies updates idempotently under its own origin
+        // sentinel, which also prevents re-broadcasting them.
+        const clientOptions = {
+            clientId: this.clientId,
+            echoMessages: this.persistentMode,
+        };
+        if (config.apiKey)
+            clientOptions.key = config.apiKey;
+        if (config.authUrl)
+            clientOptions.authUrl = config.authUrl;
+        if (config.authMethod)
+            clientOptions.authMethod = config.authMethod;
+        if (this.persistentMode) {
+            clientOptions.plugins = { LiveObjects: this.opts.LiveObjects };
+        }
+        this.log('Connecting as', this.clientId, 'to channel', this.channelName);
+        this.client = new this.opts.Realtime(clientOptions);
+        // Passing `modes` replaces the channel's default (unrestricted) mode set,
+        // so the persistent path must explicitly list everything this transport
+        // needs, not just the OBJECT_* modes LiveObjects requires. The
+        // non-persistent path is left untouched (no modes option, as before).
+        this.channel = this.persistentMode
+            ? this.client.channels.get(this.channelName, {
+                modes: [
+                    'PUBLISH',
+                    'SUBSCRIBE',
+                    'PRESENCE',
+                    'PRESENCE_SUBSCRIBE',
+                    'OBJECT_PUBLISH',
+                    'OBJECT_SUBSCRIBE',
+                ],
+            })
+            : this.client.channels.get(this.channelName);
+        await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error('Ably connection timeout'));
+            }, 10000);
+            this.client.connection.once('connected', () => {
+                clearTimeout(timeout);
+                this._isConnected = true;
+                this.log('Connected to Ably');
+                resolve();
+            });
+            this.client.connection.on('failed', (stateChange) => {
+                clearTimeout(timeout);
+                reject(new Error(`Ably connection failed: ${stateChange?.reason?.message ?? 'unknown error'}`));
+            });
+            this.client.connection.on('suspended', () => {
+                this.log('Connection suspended');
+                this._isConnected = false;
+            });
+            this.client.connection.on('disconnected', () => {
+                this.log('Connection disconnected');
+                this._isConnected = false;
+            });
+        });
+        await this.channel.subscribe((message) => {
+            // In persistent mode, echoMessages is enabled (LiveObjects requires it
+            // for writes) — filter out our own echoed pub/sub messages here so
+            // they never reach GenericProvider, same as Gun's transport dedupes
+            // its own writes before delivery. Otherwise a stale self-echo (hash
+            // computed a moment before our own newer local edits) trips the
+            // hash-mismatch resync check for no reason.
+            if (message.clientId === this.clientId)
+                return;
+            // The publisher's clientId is the peer id GenericProvider learns as
+            // `from` - the same id a presence leave reports (onPeerDisconnect).
+            this.handleMessage(message.data, message.clientId);
+        });
+        await this.channel.presence.enter();
+        // Presence leave: a clean leave, or Ably's own removal after a dropped
+        // connection's TTL. Delivered to every subscriber, so GenericProvider
+        // drops the member's awareness without a broadcast burst and lets the
+        // awareness lease default to 5 min (round 5, item 2). The client was
+        // already a presence member (enter/leave above); this subscribes to the
+        // events it ignored before.
+        await this.channel.presence.subscribe('leave', (member) => {
+            const id = member?.clientId;
+            if (typeof id === 'string' && id !== this.clientId) {
+                this.log('Peer left:', id);
+                this._peerDisconnectCallback?.(id);
+            }
+        });
+        // Persistence: load any existing snapshot. Unlike Gun, there's no
+        // "clear stale snapshot on non-persistent connect" step here — a plain
+        // channel (no OBJECT_* modes) never attaches LiveObjects at all, so a
+        // non-persistent connect has nothing to clear.
+        this.snapshotLoaded = false;
+        if (this.persistentMode) {
+            this.liveRoot = await this.channel.object.get();
+            this.loadSnapshot();
+        }
+    }
+    async disconnect() {
+        this.log('Disconnecting...');
+        if (this.persistTimer) {
+            clearTimeout(this.persistTimer);
+            this.persistTimer = undefined;
+        }
+        if (this.persistentMode && this.persistDoc) {
+            try {
+                await this.saveSnapshot();
+            }
+            catch (error) {
+                this.log('Error flushing snapshot on disconnect:', error);
+            }
+        }
+        if (this.channel) {
+            try {
+                await this.channel.presence.leave();
+            }
+            catch (error) {
+                this.log('Error leaving presence:', error);
+            }
+            this.channel.unsubscribe();
+            this.channel = null;
+        }
+        if (this.client) {
+            this.client.close();
+            this.client = null;
+        }
+        this._isConnected = false;
+        this.messageCallback = undefined;
+        this.messageBuffer = [];
+        this.chunkBuffer.clear();
+        this.persistentMode = false;
+        this.persistDoc = null;
+        this.snapshotLoaded = false;
+        this.liveRoot = null;
+    }
+    send(data) {
+        if (!this.channel || !this._isConnected) {
+            this.log('Cannot send: not connected');
+            return;
+        }
+        const payload = stripCRC32Header(data);
+        const base64Data = uint8ToBase64(payload);
+        if (base64Data.length > MAX_MESSAGE_SIZE) {
+            this.sendChunked(base64Data, payload.length);
+        }
+        else {
+            this.channel.publish(EVENT_NAME, base64Data).catch((error) => {
+                this.log('Publish error:', error);
+            });
+        }
+        // Only real doc updates trigger a snapshot save, not every awareness
+        // heartbeat (peekMessageType() reads the type byte right after the
+        // 4-byte CRC header GenericProvider prepends to every message).
+        if (this.persistentMode && this.peekMessageType(data) !== MESSAGE_AWARENESS) {
+            this.queuePersist();
+        }
+    }
+    /** Peek the message type byte from CRC32-wrapped data (byte 4, after the 4-byte CRC32 header). */
+    peekMessageType(data) {
+        return data.length < 5 ? -1 : data[4];
+    }
+    onMessage(callback) {
+        this.messageCallback = callback;
+        if (this.messageBuffer.length > 0) {
+            for (const { data, from } of this.messageBuffer) {
+                callback(data, from);
+            }
+            this.messageBuffer = [];
+        }
+        return () => {
+            this.messageCallback = undefined;
+        };
+    }
+    /** Get the clientIds of other peers currently present on the channel. */
+    async getPresence() {
+        if (!this.channel || !this._isConnected) {
+            return [];
+        }
+        try {
+            const members = await this.channel.presence.get();
+            return members
+                .map((m) => m.clientId)
+                .filter((id) => id !== this.clientId);
+        }
+        catch (error) {
+            this.log('Error getting presence:', error);
+            return [];
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Persistence helpers (LiveObjects)
+    // ---------------------------------------------------------------------------
+    /** Schedule a debounced snapshot write. Called on every non-awareness send(). */
+    queuePersist() {
+        if (this.persistTimer)
+            clearTimeout(this.persistTimer);
+        this.persistTimer = setTimeout(() => this.saveSnapshot(), this.persistDebounceMs);
+    }
+    /**
+     * Encode the full Y.Doc state as a SYNC_STEP_2 message and write it across
+     * one or more LiveMap keys (each `set()` is capped at Ably's 64 KiB message
+     * size, so a real snapshot needs chunking — see `snapshot-count`/`snapshot-N`
+     * below). Chunk keys are written first, `snapshot-count` last, so a reader
+     * can treat its presence as "this snapshot is complete."
+     */
+    async saveSnapshot() {
+        if (!this.persistDoc || !this.persistentMode || !this.liveRoot)
+            return;
+        if (!this.snapshotLoaded) {
+            // The initial LiveObjects read hasn't resolved yet — saving now could
+            // clobber the real persisted state with our still-unmerged local doc.
+            this.persistTimer = setTimeout(() => this.saveSnapshot(), 100);
+            return;
+        }
+        if (this.isWritingSnapshot) {
+            this.savePending = true;
+            return;
+        }
+        this.isWritingSnapshot = true;
+        this.savePending = false;
+        try {
+            const enc = encoding.createEncoder();
+            encoding.writeVarUint(enc, 0); // MESSAGE_SYNC
+            syncProtocol.writeSyncStep2(enc, this.persistDoc);
+            const snapshotBytes = encoding.toUint8Array(enc);
+            const chunks = [];
+            for (let i = 0; i < snapshotBytes.length; i += MAX_MESSAGE_SIZE) {
+                const end = Math.min(i + MAX_MESSAGE_SIZE, snapshotBytes.length);
+                chunks.push(snapshotBytes.buffer.slice(snapshotBytes.byteOffset + i, snapshotBytes.byteOffset + end));
+            }
+            await Promise.all(chunks.map((chunk, i) => this.liveRoot.set(`snapshot-${i}`, chunk)));
+            await this.liveRoot.set('snapshot-count', chunks.length);
+            this.log('Snapshot saved', snapshotBytes.length, 'bytes in', chunks.length, 'chunk(s)');
+        }
+        catch (error) {
+            this.log('Error saving snapshot:', error.message);
+            console.warn('AblyTransport: Failed to save snapshot. Will retry later.', error);
+            this.savePending = true;
+        }
+        finally {
+            this.isWritingSnapshot = false;
+            if (this.savePending) {
+                setTimeout(() => this.saveSnapshot(), 1000);
+            }
+        }
+    }
+    /**
+     * Load the snapshot from LiveObjects and deliver it to the message
+     * callback. Aborts without delivering anything if a chunk is missing —
+     * partial data is worse than none.
+     */
+    async loadSnapshot() {
+        if (!this.liveRoot)
+            return;
+        try {
+            const count = this.liveRoot.get('snapshot-count').value();
+            if (!count) {
+                this.log('No snapshot found in LiveObjects');
+                return;
+            }
+            const chunks = [];
+            for (let i = 0; i < count; i++) {
+                const chunk = this.liveRoot.get(`snapshot-${i}`).value();
+                if (!chunk) {
+                    this.log(`Missing chunk ${i}, cannot reassemble snapshot`);
+                    return;
+                }
+                chunks.push(new Uint8Array(chunk));
+            }
+            const totalLength = chunks.reduce((sum, c) => sum + c.length, 0);
+            const snapshotBytes = new Uint8Array(totalLength);
+            let offset = 0;
+            for (const chunk of chunks) {
+                snapshotBytes.set(chunk, offset);
+                offset += chunk.length;
+            }
+            if (snapshotBytes.length > 0) {
+                this.deliver(addCRC32Header(snapshotBytes));
+                this.log('Loaded snapshot:', snapshotBytes.length, 'bytes');
+            }
+        }
+        catch (error) {
+            this.log('Error loading snapshot:', error);
+            console.warn('AblyTransport: Failed to load snapshot:', error);
+        }
+        finally {
+            this.snapshotLoaded = true;
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    sendChunked(base64Data, originalSize) {
+        const chunkId = generateUUID();
+        const chunks = [];
+        for (let i = 0; i < base64Data.length; i += MAX_MESSAGE_SIZE) {
+            chunks.push(base64Data.slice(i, i + MAX_MESSAGE_SIZE));
+        }
+        this.log(`Splitting ${originalSize} bytes into ${chunks.length} chunks (id: ${chunkId.slice(0, 8)}...)`);
+        chunks.forEach((chunk, index) => {
+            const message = { chunked: true, id: chunkId, index, total: chunks.length, data: chunk };
+            this.channel.publish(EVENT_NAME, message).catch((error) => {
+                this.log(`Failed to send chunk ${index + 1}:`, error);
+            });
+        });
+    }
+    handleChunkedMessage(message, from) {
+        const { id, index, total, data } = message;
+        if (!this.chunkBuffer.has(id)) {
+            this.chunkBuffer.set(id, new Map());
+        }
+        const chunks = this.chunkBuffer.get(id);
+        chunks.set(index, data);
+        if (chunks.size !== total)
+            return;
+        let base64Data = '';
+        for (let i = 0; i < total; i++) {
+            const chunk = chunks.get(i);
+            if (!chunk) {
+                this.log(`Missing chunk ${i}, cannot reassemble message ${id}`);
+                this.chunkBuffer.delete(id);
+                return;
+            }
+            base64Data += chunk;
+        }
+        this.chunkBuffer.delete(id);
+        try {
+            const raw = base64ToUint8(base64Data);
+            this.deliver(addCRC32Header(raw), from);
+        }
+        catch (error) {
+            this.log('Error reassembling chunked message:', error);
+        }
+    }
+    handleMessage(data, from) {
+        try {
+            if (data && typeof data === 'object' && data.chunked) {
+                this.handleChunkedMessage(data, from);
+                return;
+            }
+            if (typeof data !== 'string')
+                return;
+            const raw = base64ToUint8(data);
+            this.deliver(addCRC32Header(raw), from);
+        }
+        catch (error) {
+            this.log('Error handling message:', error);
+        }
+    }
+    deliver(data, from) {
+        if (this.messageCallback) {
+            this.messageCallback(data, from);
+        }
+        else {
+            this.messageBuffer.push({ data, from });
+        }
+    }
+    /**
+     * Transport.onPeerDisconnect: Ably presence 'leave' on the channel. Peer
+     * ids are Ably clientIds, the same `from` onMessage passes.
+     */
+    onPeerDisconnect(callback) {
+        this._peerDisconnectCallback = callback;
+        return () => {
+            this._peerDisconnectCallback = undefined;
+        };
+    }
+    log(...args) {
+        if (this.debug) {
+            console.log('[AblyTransport]', ...args);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/ably/index.js.map

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

package/dist/providers/chunking.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Chunk envelope shared by the providers whose backend caps a single
+ * message (Matrix 65,536 B canonical JSON per event, Nostr 64 KiB per
+ * event, Supabase 256 KB per broadcast). Same shape PubNub and Ably use
+ * for theirs. Payloads are the provider's base64 string; the provider
+ * decides the limit after its own encoding.
+ */
+export interface Chunk {
+    chunked: true;
+    id: string;
+    index: number;
+    total: number;
+    data: string;
+}
+export declare function isChunk(x: unknown): x is Chunk;
+/** Split `data` into chunks of at most `maxChars`; one chunk when it fits. */
+export declare function splitChunks(data: string, maxChars: number): Chunk[];
+/** Reassembles chunks per id; returns the whole payload once complete. */
+export declare class ChunkAssembler {
+    private readonly maxPending;
+    private pending;
+    constructor(maxPending?: number);
+    push(chunk: Chunk): string | null;
+    clear(): void;
+}
+//# sourceMappingURL=chunking.d.ts.map

package/dist/providers/chunking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.d.ts","sourceRoot":"","sources":["../../src/providers/chunking.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,IAAI,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,KAAK,CAQ9C;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE,CAQnE;AAED,0EAA0E;AAC1E,qBAAa,cAAc;IAEb,OAAO,CAAC,QAAQ,CAAC,UAAU;IADvC,OAAO,CAAC,OAAO,CAAyC;gBAC3B,UAAU,SAAK;IAE5C,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI;IAuBjC,KAAK,IAAI,IAAI;CAGd"}

package/dist/providers/chunking.js

@@ -0,0 +1,52 @@
+export function isChunk(x) {
+    return (typeof x === 'object' &&
+        x !== null &&
+        x.chunked === true &&
+        typeof x.id === 'string' &&
+        typeof x.data === 'string');
+}
+/** Split `data` into chunks of at most `maxChars`; one chunk when it fits. */
+export function splitChunks(data, maxChars) {
+    const id = Math.random().toString(36).slice(2) + Date.now().toString(36);
+    const total = Math.max(1, Math.ceil(data.length / maxChars));
+    const chunks = [];
+    for (let i = 0; i < total; i++) {
+        chunks.push({ chunked: true, id, index: i, total, data: data.slice(i * maxChars, (i + 1) * maxChars) });
+    }
+    return chunks;
+}
+/** Reassembles chunks per id; returns the whole payload once complete. */
+export class ChunkAssembler {
+    constructor(maxPending = 32) {
+        this.maxPending = maxPending;
+        this.pending = new Map();
+    }
+    push(chunk) {
+        let parts = this.pending.get(chunk.id);
+        if (!parts) {
+            // ponytail: oldest-first eviction bounds memory when a sender's
+            // chunks never complete (lost event); no per-id timers.
+            if (this.pending.size >= this.maxPending) {
+                this.pending.delete(this.pending.keys().next().value);
+            }
+            parts = new Map();
+            this.pending.set(chunk.id, parts);
+        }
+        parts.set(chunk.index, chunk.data);
+        if (parts.size < chunk.total)
+            return null;
+        this.pending.delete(chunk.id);
+        let out = '';
+        for (let i = 0; i < chunk.total; i++) {
+            const part = parts.get(i);
+            if (part === undefined)
+                return null;
+            out += part;
+        }
+        return out;
+    }
+    clear() {
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=chunking.js.map