@soulcraft/sdk 1.5.5 → 1.6.1

package/dist/modules/brainy/ydoc-manager.js

@@ -0,0 +1,424 @@
+/**
+ * @module modules/brainy/ydoc-manager
+ * @description Server-side Y.js document pool with binary append-log persistence.
+ *
+ * `YDocManager` maintains a pool of live `Y.Doc` instances, one per open file across
+ * all connected peers. Every Y.js update (each keypress or structural change) is
+ * immediately appended to a `.ydoc` binary file in Brainy's VFS alongside the
+ * human-readable `.wdoc`/`.wslide`/`.wviz` file. Brainy's mmap/SSD storage makes
+ * per-keypress appends essentially free.
+ *
+ * ## Persistence strategy
+ *
+ * ```
+ * /project/chapter-1.wdoc    ← WDOC JSON, flushed from Y.Doc every 30s
+ * /project/chapter-1.ydoc    ← binary Y.js update log, every keypress
+ * ```
+ *
+ * - **On every Y.js update:** append binary update to `.ydoc` via `vfs.appendFile`.
+ * - **Every 30s (debounced):** flush the live Y.Doc to `.wdoc` JSON so the canonical
+ *   format stays fresh for API consumers that read `.wdoc` directly.
+ * - **On last peer disconnect:** flush `.wdoc` immediately, then discard the Y.Doc
+ *   from memory. No warm cache — `.ydoc` binary replay is instant on mmap/SSD.
+ * - **On cold start (next peer):** reconstruct Y.Doc by replaying the `.ydoc` log
+ *   via `Y.applyUpdate`. Falls back to converting `.wdoc` JSON if no `.ydoc` exists.
+ *
+ * ## Invalidation
+ *
+ * When a VFS write bypasses Y.js (e.g. import, API overwrite), call `invalidate()`
+ * to rebuild the `.ydoc` log from the new `.wdoc` content so future peers get
+ * the correct document state.
+ *
+ * ## Scope key
+ *
+ * Documents are keyed by `${scope}:${filePath}` where scope is `${emailHash}:${workspaceId}`.
+ * This matches the WebSocket session scope so the manager can be addressed directly
+ * from message handlers without additional routing.
+ */
+import * as Y from 'yjs';
+// ─────────────────────────────────────────────────────────────────────────────
+// Types
+// ─────────────────────────────────────────────────────────────────────────────
+/** Extension appended to the source file path to form the Y.js update log path. */
+const YDOC_EXT = '.ydoc';
+/** Interval between debounced flushes of the live Y.Doc to the canonical format (ms). */
+const FLUSH_INTERVAL_MS = 30_000;
+// ─────────────────────────────────────────────────────────────────────────────
+// YDocManager
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Server-side pool of Y.js documents with binary append-log persistence.
+ *
+ * One shared instance per product server process. Pass it to `createBrainyWsHandler`
+ * so the WebSocket message handler can route Y.js messages to the correct doc.
+ *
+ * @example
+ * ```typescript
+ * import { YDocManager } from '@soulcraft/sdk/server'
+ * import { pool } from './instance-pool'
+ *
+ * export const ydocManager = new YDocManager()
+ *
+ * const wsHandler = createBrainyWsHandler({
+ *   resolveBrain: (scope) => pool.forTenant(scope),
+ *   authenticate: (token, scope) => verifyCapabilityToken(token, process.env.WS_TOKEN_SECRET!),
+ *   ydocManager,
+ * })
+ * ```
+ */
+export class YDocManager {
+    /** Pool of live Y.Doc instances keyed by `${scope}:${filePath}`. */
+    docs = new Map();
+    // ── Public API ─────────────────────────────────────────────────────────────
+    /**
+     * Returns the live Y.Doc for the given scope + file, loading from the `.ydoc`
+     * binary log (or converting from the canonical format) on first access.
+     *
+     * Registers `peerId` as an active peer so the manager can track when the last
+     * peer disconnects.
+     *
+     * @param scope - The session scope (`${emailHash}:${workspaceId}`).
+     * @param filePath - Absolute VFS path to the source file (e.g. `/proj/doc.wdoc`).
+     * @param brain - The Brainy instance owning the VFS for this scope.
+     * @param peerId - Unique ID for the connecting peer.
+     * @returns The live `Y.Doc` for this file.
+     */
+    async getOrCreate(scope, filePath, brain, peerId) {
+        const key = _key(scope, filePath);
+        let entry = this.docs.get(key);
+        if (!entry) {
+            const ydoc = await this._load(filePath, brain);
+            entry = {
+                ydoc,
+                peers: new Set(),
+                flushTimer: null,
+                flushPending: false,
+                brain,
+                filePath,
+                ydocPath: filePath + YDOC_EXT,
+                format: _formatFromPath(filePath),
+            };
+            this.docs.set(key, entry);
+            this._scheduleFlush(key, entry);
+        }
+        entry.peers.add(peerId);
+        return entry.ydoc;
+    }
+    /**
+     * Applies a Y.js update received from a peer.
+     *
+     * - Applies the update to the in-memory Y.Doc.
+     * - Appends the raw binary update to the `.ydoc` log immediately.
+     *
+     * The debounced 30s flush to the canonical format runs independently.
+     *
+     * @param scope - Session scope.
+     * @param filePath - Absolute VFS path to the source file.
+     * @param update - Raw binary Y.js update (from `Y.encodeStateAsUpdate` or an observer).
+     */
+    async applyUpdate(scope, filePath, update) {
+        const key = _key(scope, filePath);
+        const entry = this.docs.get(key);
+        if (!entry)
+            return;
+        Y.applyUpdate(entry.ydoc, update);
+        // Append to the binary log — mmap/SSD makes this free.
+        await entry.brain.vfs.appendFile(entry.ydocPath, Buffer.from(update));
+    }
+    /**
+     * Returns the current Y.js state vector for the given document.
+     *
+     * Used during the Y.js sync protocol: the client sends its state vector,
+     * the server replies with the diff (all updates the client is missing).
+     *
+     * @param scope - Session scope.
+     * @param filePath - Absolute VFS path to the source file.
+     * @returns Encoded state vector as `Uint8Array`.
+     */
+    async getStateVector(scope, filePath, brain) {
+        const key = _key(scope, filePath);
+        const entry = this.docs.get(key);
+        if (entry)
+            return Y.encodeStateVector(entry.ydoc);
+        // Not in memory — load transiently just for the state vector, then discard.
+        const ydoc = await this._load(filePath, brain);
+        const sv = Y.encodeStateVector(ydoc);
+        ydoc.destroy();
+        return sv;
+    }
+    /**
+     * Returns the Y.js diff between the server's state and the client's state vector.
+     *
+     * Called after the client sends a `y-sync` message. The diff contains all updates
+     * the client is missing so it can catch up to the server's current state.
+     *
+     * @param scope - Session scope.
+     * @param filePath - Absolute VFS path to the source file.
+     * @param clientStateVector - The state vector encoded by the client.
+     * @returns Encoded update diff as `Uint8Array`.
+     */
+    async getDiff(scope, filePath, brain, clientStateVector) {
+        const key = _key(scope, filePath);
+        const entry = this.docs.get(key);
+        if (entry)
+            return Y.encodeStateAsUpdate(entry.ydoc, clientStateVector);
+        // Not in memory — load transiently, compute diff, discard.
+        const ydoc = await this._load(filePath, brain);
+        const diff = Y.encodeStateAsUpdate(ydoc, clientStateVector);
+        ydoc.destroy();
+        return diff;
+    }
+    /**
+     * Notifies the manager that a peer has disconnected from the given document.
+     *
+     * If this was the last peer:
+     * 1. Flushes the Y.Doc to the canonical format immediately.
+     * 2. Cancels the periodic flush timer.
+     * 3. Destroys and discards the Y.Doc from memory.
+     *
+     * No warm cache — `.ydoc` binary replay is instant on mmap/SSD.
+     *
+     * @param scope - Session scope.
+     * @param filePath - Absolute VFS path to the source file.
+     * @param peerId - The peer that disconnected.
+     */
+    async onPeerDisconnect(scope, filePath, peerId) {
+        const key = _key(scope, filePath);
+        const entry = this.docs.get(key);
+        if (!entry)
+            return;
+        entry.peers.delete(peerId);
+        if (entry.peers.size === 0) {
+            // Last peer — flush immediately and discard. No warm cache.
+            if (entry.flushTimer) {
+                clearInterval(entry.flushTimer);
+                entry.flushTimer = null;
+            }
+            await this._flush(entry);
+            entry.ydoc.destroy();
+            this.docs.delete(key);
+        }
+    }
+    /**
+     * Invalidates a cached Y.Doc when the canonical file is overwritten externally
+     * (e.g. via import or direct API write that bypasses Y.js).
+     *
+     * If the document is currently in memory (has active peers), it is rebuilt from
+     * the new canonical file content. If no peers are connected, any stale `.ydoc`
+     * log is deleted so the next cold start reads the new canonical file.
+     *
+     * @param scope - Session scope.
+     * @param filePath - Absolute VFS path to the source file.
+     * @param brain - The Brainy instance owning the VFS.
+     */
+    async invalidate(scope, filePath, brain) {
+        const key = _key(scope, filePath);
+        const entry = this.docs.get(key);
+        const ydocPath = filePath + YDOC_EXT;
+        if (entry) {
+            // Rebuild in-place so active peers automatically get the new state.
+            const newYdoc = await _loadFromCanonical(filePath, brain);
+            const update = Y.encodeStateAsUpdate(newYdoc);
+            Y.applyUpdate(entry.ydoc, update);
+            newYdoc.destroy();
+            // Rewrite the .ydoc log with the new full state.
+            await brain.vfs.writeFile(ydocPath, Buffer.from(Y.encodeStateAsUpdate(entry.ydoc)));
+        }
+        else {
+            // No active peers — just delete the stale .ydoc so next cold start is clean.
+            try {
+                await brain.vfs.writeFile(ydocPath, Buffer.from(Y.encodeStateAsUpdate(await _loadFromCanonical(filePath, brain))));
+            }
+            catch {
+                // File may not exist yet — ignore.
+            }
+        }
+    }
+    /**
+     * Notifies the manager that a peer has disconnected from ALL documents it had open.
+     *
+     * Called from `BrainyWsHandler.handleClose()` when a WebSocket connection closes.
+     * Iterates all documents in this scope and removes the peer — if it was the last
+     * peer on any document, that document is flushed and discarded immediately.
+     *
+     * @param scope - Session scope (`${emailHash}:${workspaceId}`).
+     * @param peerId - The peer that disconnected.
+     */
+    async onPeerDisconnectAll(scope, peerId) {
+        const prefix = scope + ':';
+        for (const [key, entry] of this.docs) {
+            if (key.startsWith(prefix) && entry.peers.has(peerId)) {
+                entry.peers.delete(peerId);
+                if (entry.peers.size === 0) {
+                    if (entry.flushTimer) {
+                        clearInterval(entry.flushTimer);
+                        entry.flushTimer = null;
+                    }
+                    await this._flush(entry);
+                    entry.ydoc.destroy();
+                    this.docs.delete(key);
+                }
+            }
+        }
+    }
+    /**
+     * Flushes and discards all Y.Docs for a given scope.
+     *
+     * Called during unpublish to clean up all open documents for a project before
+     * the project is removed from the publish registry.
+     *
+     * @param scope - Session scope (`${emailHash}:${workspaceId}`).
+     */
+    async flushAndDiscardScope(scope) {
+        const prefix = scope + ':';
+        const toDiscard = [];
+        for (const [key, entry] of this.docs) {
+            if (key.startsWith(prefix)) {
+                if (entry.flushTimer)
+                    clearInterval(entry.flushTimer);
+                await this._flush(entry);
+                entry.ydoc.destroy();
+                toDiscard.push(key);
+            }
+        }
+        for (const key of toDiscard)
+            this.docs.delete(key);
+    }
+    // ── Internal ───────────────────────────────────────────────────────────────
+    /**
+     * Loads a Y.Doc from the `.ydoc` binary log, falling back to converting the
+     * canonical file if no log exists yet.
+     */
+    async _load(filePath, brain) {
+        const ydocPath = filePath + YDOC_EXT;
+        const ydoc = new Y.Doc();
+        try {
+            const buf = await brain.vfs.readFile(ydocPath);
+            if (buf && buf.length > 0) {
+                // Binary replay — instant on mmap/SSD.
+                Y.applyUpdate(ydoc, new Uint8Array(buf));
+                return ydoc;
+            }
+        }
+        catch {
+            // .ydoc not found — fall through to canonical load.
+        }
+        // No .ydoc yet — bootstrap from the canonical format.
+        const bootstrapYdoc = await _loadFromCanonical(filePath, brain);
+        const bootstrapUpdate = Y.encodeStateAsUpdate(bootstrapYdoc);
+        Y.applyUpdate(ydoc, bootstrapUpdate);
+        bootstrapYdoc.destroy();
+        // Write the initial .ydoc log so future cold starts use binary replay.
+        await brain.vfs.writeFile(ydocPath, Buffer.from(bootstrapUpdate));
+        return ydoc;
+    }
+    /**
+     * Schedules the periodic 30s flush for the given document entry.
+     */
+    _scheduleFlush(key, entry) {
+        entry.flushTimer = setInterval(async () => {
+            if (this.docs.has(key)) {
+                await this._flush(entry);
+            }
+        }, FLUSH_INTERVAL_MS);
+    }
+    /**
+     * Flushes the live Y.Doc to the canonical format in the VFS.
+     */
+    async _flush(entry) {
+        try {
+            const json = _ydocToCanonicalJson(entry.ydoc, entry.format);
+            await entry.brain.vfs.writeFile(entry.filePath, JSON.stringify(json, null, 2));
+        }
+        catch (err) {
+            console.error(`[YDocManager] flush failed for ${entry.filePath}:`, err);
+        }
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Helpers — format conversion
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Builds the pool key from scope and file path.
+ *
+ * @param scope - Session scope.
+ * @param filePath - Absolute VFS path.
+ * @returns Compound key string.
+ */
+function _key(scope, filePath) {
+    return `${scope}:${filePath}`;
+}
+/**
+ * Derives the flush format from a file path extension.
+ *
+ * @param filePath - Absolute VFS path.
+ * @returns One of the supported flush format identifiers.
+ */
+function _formatFromPath(filePath) {
+    if (filePath.endsWith('.wdoc'))
+        return 'wdoc';
+    if (filePath.endsWith('.wslide'))
+        return 'wslide';
+    if (filePath.endsWith('.wviz'))
+        return 'wviz';
+    if (filePath.endsWith('.wquiz'))
+        return 'wquiz';
+    return 'text';
+}
+/**
+ * Loads a Y.Doc from the canonical format file (`.wdoc`, `.wslide`, etc.).
+ *
+ * Each format stores its content as the root XmlFragment's children in the Y.Doc.
+ * For v1, all formats serialize as a JSON string stored in a Y.Text field named
+ * `'content'` — simple and sufficient for the sync protocol to work. The rich
+ * TipTap↔Y.js binding (`prosemirror-binding`) handles the structured mapping
+ * on the client side; the server only needs the raw bytes.
+ *
+ * @param filePath - Absolute VFS path to the canonical file.
+ * @param brain - The Brainy instance owning the VFS.
+ * @returns A bootstrapped `Y.Doc` containing the file's current content.
+ */
+async function _loadFromCanonical(filePath, brain) {
+    const ydoc = new Y.Doc();
+    try {
+        const raw = await brain.vfs.readFile(filePath);
+        if (raw && raw.length > 0) {
+            // Store the canonical JSON as a Y.Text so Y.js can manage it as a shared type.
+            // TipTap's Collaboration extension replaces this with the ProseMirror Y.XmlFragment
+            // once the first peer connects with a real editor.
+            const text = ydoc.getText('content');
+            text.insert(0, raw.toString('utf-8'));
+        }
+    }
+    catch {
+        // File doesn't exist yet — empty doc.
+    }
+    return ydoc;
+}
+/**
+ * Serializes a Y.Doc back to the canonical JSON format for writing to the VFS.
+ *
+ * For the `text` format (code files), returns the raw string content.
+ * For all document formats (wdoc, wslide, wviz, wquiz), returns the parsed JSON
+ * object so the VFS file stays human-readable and API-consumable.
+ *
+ * @param ydoc - The live Y.Doc to serialize.
+ * @param format - The target format.
+ * @returns The canonical content as a JavaScript value (JSON.stringify'd by the caller).
+ */
+function _ydocToCanonicalJson(ydoc, format) {
+    const text = ydoc.getText('content').toString();
+    if (format === 'text' || !text)
+        return text;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        // If TipTap's Y.XmlFragment binding has taken over, the 'content' Y.Text may be
+        // empty. In that case, fall back to the XmlFragment serialization path.
+        // This is handled by the TipTap binding on the client — server sees the canonical
+        // JSON via the 30s flush path which the client drives via onChange.
+        return {};
+    }
+}
+//# sourceMappingURL=ydoc-manager.js.map

package/dist/modules/brainy/ydoc-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ydoc-manager.js","sourceRoot":"","sources":["../../../src/modules/brainy/ydoc-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAGxB,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,mFAAmF;AACnF,MAAM,QAAQ,GAAG,OAAO,CAAA;AAExB,yFAAyF;AACzF,MAAM,iBAAiB,GAAG,MAAM,CAAA;AA4BhC,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,WAAW;IACtB,oEAAoE;IACnD,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAA;IAEnD,8EAA8E;IAE9E;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,WAAW,CACf,KAAa,EACb,QAAgB,EAChB,KAAa,EACb,MAAc;QAEd,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QACjC,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAE9B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YAC9C,KAAK,GAAG;gBACN,IAAI;gBACJ,KAAK,EAAE,IAAI,GAAG,EAAE;gBAChB,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,KAAK;gBACnB,KAAK;gBACL,QAAQ;gBACR,QAAQ,EAAE,QAAQ,GAAG,QAAQ;gBAC7B,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC;aAClC,CAAA;YACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACzB,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACjC,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACvB,OAAO,KAAK,CAAC,IAAI,CAAA;IACnB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,QAAgB,EAAE,MAAkB;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,CAAC,KAAK;YAAE,OAAM;QAElB,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAEjC,uDAAuD;QACvD,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IACvE,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,cAAc,CAAC,KAAa,EAAE,QAAgB,EAAE,KAAa;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,KAAK;YAAE,OAAO,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAEjD,4EAA4E;QAC5E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAC9C,MAAM,EAAE,GAAG,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,OAAO,EAAE,CAAA;QACd,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,CACX,KAAa,EACb,QAAgB,EAChB,KAAa,EACb,iBAA6B;QAE7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,KAAK;YAAE,OAAO,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAA;QAEtE,2DAA2D;QAC3D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAC9C,MAAM,IAAI,GAAG,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAA;QAC3D,IAAI,CAAC,OAAO,EAAE,CAAA;QACd,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,gBAAgB,CAAC,KAAa,EAAE,QAAgB,EAAE,MAAc;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,CAAC,KAAK;YAAE,OAAM;QAElB,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAE1B,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC3B,4DAA4D;YAC5D,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;gBAC/B,KAAK,CAAC,UAAU,GAAG,IAAI,CAAA;YACzB,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACxB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAA;YACpB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACvB,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,QAAgB,EAAE,KAAa;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAChC,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;QAEpC,IAAI,KAAK,EAAE,CAAC;YACV,oEAAoE;YACpE,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YACzD,MAAM,MAAM,GAAG,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAA;YAC7C,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACjC,OAAO,CAAC,OAAO,EAAE,CAAA;YAEjB,iDAAiD;YACjD,MAAM,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACrF,CAAC;aAAM,CAAC;YACN,6EAA6E;YAC7E,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,GAAG,CAAC,SAAS,CACvB,QAAQ,EACR,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAC9E,CAAA;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,mCAAmC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,mBAAmB,CAAC,KAAa,EAAE,MAAc;QACrD,MAAM,MAAM,GAAG,KAAK,GAAG,GAAG,CAAA;QAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACrC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtD,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;gBAC1B,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBAC3B,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;wBACrB,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;wBAC/B,KAAK,CAAC,UAAU,GAAG,IAAI,CAAA;oBACzB,CAAC;oBACD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;oBACxB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAA;oBACpB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,oBAAoB,CAAC,KAAa;QACtC,MAAM,MAAM,GAAG,KAAK,GAAG,GAAG,CAAA;QAC1B,MAAM,SAAS,GAAa,EAAE,CAAA;QAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACrC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,UAAU;oBAAE,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;gBACrD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACxB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAA;gBACpB,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACrB,CAAC;QACH,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACpD,CAAC;IAED,8EAA8E;IAE9E;;;OAGG;IACK,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,KAAa;QACjD,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,CAAA;QAExB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;YAC9C,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,uCAAuC;gBACvC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;gBACxC,OAAO,IAAI,CAAA;YACb,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;QAED,sDAAsD;QACtD,MAAM,aAAa,GAAG,MAAM,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAC/D,MAAM,eAAe,GAAG,CAAC,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAA;QAC5D,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;QACpC,aAAa,CAAC,OAAO,EAAE,CAAA;QAEvB,uEAAuE;QACvE,MAAM,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAA;QAEjE,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,GAAW,EAAE,KAAe;QACjD,KAAK,CAAC,UAAU,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;YACxC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAC1B,CAAC;QACH,CAAC,EAAE,iBAAiB,CAAC,CAAA;IACvB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,MAAM,CAAC,KAAe;QAClC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;YAC3D,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAChF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,kCAAkC,KAAK,CAAC,QAAQ,GAAG,EAAE,GAAG,CAAC,CAAA;QACzE,CAAC;IACH,CAAC;CACF;AAED,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF;;;;;;GAMG;AACH,SAAS,IAAI,CAAC,KAAa,EAAE,QAAgB;IAC3C,OAAO,GAAG,KAAK,IAAI,QAAQ,EAAE,CAAA;AAC/B,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,QAAgB;IACvC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAA;IAC7C,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAA;IACjD,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAA;IAC7C,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAA;IAC/C,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,KAAa;IAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,CAAA;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAC9C,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,+EAA+E;YAC/E,oFAAoF;YACpF,mDAAmD;YACnD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;YACpC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;QACvC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,oBAAoB,CAAC,IAAW,EAAE,MAAmB;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC/C,IAAI,MAAM,KAAK,MAAM,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,gFAAgF;QAChF,wEAAwE;QACxE,kFAAkF;QAClF,oEAAoE;QACpE,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC"}

package/dist/modules/skills/types.d.ts

@@ -4,7 +4,7 @@
  *
  * Skills are Markdown files (SKILL.md convention) that define an AI persona,
  * capabilities, glossary, and workflow steps for a specific domain. They drive
- * Briggy's system prompt construction and define what Claude knows how to do
+ * Brainy AI system prompt construction and define what Claude knows how to do
  * within a kit's context.
  *
  * ## Skill sources (in priority order)

package/dist/modules/skills/types.js

@@ -4,7 +4,7 @@
  *
  * Skills are Markdown files (SKILL.md convention) that define an AI persona,
  * capabilities, glossary, and workflow steps for a specific domain. They drive
- * Briggy's system prompt construction and define what Claude knows how to do
+ * Brainy AI system prompt construction and define what Claude knows how to do
  * within a kit's context.
  *
  * ## Skill sources (in priority order)

package/dist/server/handlers.d.ts

@@ -72,6 +72,7 @@
 import type { Brainy } from '@soulcraft/brainy';
 import { LocalTransport } from '../transports/local.js';
 import type { BrainyChangeEvent } from '../modules/brainy/events.js';
+import { YDocManager } from '../modules/brainy/ydoc-manager.js';
 /**
  * Configuration for {@link createBrainyHandler}.
  */
@@ -138,16 +139,16 @@ export interface BrainyWsHandlerConfig {
     /**
      * Authenticates the WebSocket upgrade request.
      *
-     * The `token` is extracted from `Authorization: Bearer <token>`. Return `null`
-     * to close the socket with code 4001 (unauthorized).
+     * The `token` is extracted from `Authorization: Bearer <token>` (Bun/Node) or
+     * `?token=` query param (browser). Return `null` to reject with close code 4001.
      *
-     * @param token - The bearer token from the Authorization header.
+     * @param token - The bearer token from the header or query string.
      * @param scope - The requested scope from the URL.
      * @returns An auth context on success, or `null` to reject.
      */
     authenticate: (token: string, scope: string) => Promise<unknown | null>;
     /**
-     * Optional per-call authorization check.
+     * Optional per-call authorization check for Brainy RPC methods.
      *
      * @param method - Dot-separated Brainy method name.
      * @param args - Positional arguments.
@@ -157,8 +158,18 @@ export interface BrainyWsHandlerConfig {
     authorize?: (method: string, args: unknown[], auth: unknown) => boolean | null | Promise<boolean | null>;
     /** Methods blocked for all callers. @default [] */
     blockedMethods?: string[];
+    /**
+     * Optional Y.js document manager for real-time collaborative editing.
+     *
+     * When provided, the handler routes `y-sync`, `y-update`, and `y-awareness`
+     * messages through the `YDocManager` instead of the Brainy RPC dispatcher.
+     * Y.js update broadcasts are sent to all other peers via the `broadcast` callback
+     * on the session — the product server must populate this callback when a peer
+     * connects (see {@link WsSession.broadcast}).
+     */
+    ydocManager?: YDocManager;
 }
-/** Per-connection session state stored on the WebSocket. */
+/** Per-connection session state stored on the WebSocket data field. */
 export interface WsSession {
     /** The tenant scope extracted from `?scope=`. */
     scope: string;
@@ -168,6 +179,23 @@ export interface WsSession {
     brain: Brainy;
     /** Local transport wrapping the Brainy instance for this session. */
     transport: LocalTransport;
+    /**
+     * Unique peer ID for this connection. Used by `YDocManager` to track per-file
+     * peer counts so it knows when the last peer has disconnected.
+     */
+    peerId: string;
+    /**
+     * Broadcast callback set by the product server after upgrade.
+     *
+     * Called by the handler to fan out `y-update` and `y-awareness` messages to all
+     * other peers connected to this scope. The product server owns the connection map
+     * (keyed by scope) and provides this callback so the SDK doesn't need to manage
+     * WebSocket handles directly.
+     *
+     * @param msg - Encoded MessagePack frame to send to all OTHER peers in this scope.
+     * @param excludePeerId - The peer that sent the message — must be excluded from broadcast.
+     */
+    broadcast: (msg: Uint8Array, excludePeerId: string) => void;
 }
 /**
  * The object returned by {@link createBrainyWsHandler}.
@@ -180,6 +208,9 @@ export interface BrainyWsHandler {
      * the Brainy instance. Returns `null` if authentication fails (caller should
      * respond with 401 and not proceed with the upgrade).
      *
+     * After a successful upgrade the product server must set `session.broadcast` to
+     * a function that sends a `Uint8Array` to all other peers in the same scope.
+     *
      * @param request - The HTTP upgrade Request.
      * @returns Session state on success, or `null` on auth failure.
      */
@@ -187,19 +218,29 @@ export interface BrainyWsHandler {
     /**
      * Processes an incoming WebSocket message.
      *
-     * Decodes the MessagePack frame, dispatches the RPC, and calls `send` with
-     * the encoded response.
+     * Decodes the MessagePack frame and routes it to either:
+     * - The Brainy RPC dispatcher (frames with an `id` field), or
+     * - The `YDocManager` (frames with `type: 'y-sync' | 'y-update' | 'y-awareness'`).
+     *
+     * Y.js update and awareness frames are also broadcast to other peers via
+     * `session.broadcast`.
      *
      * @param session - The session state from `handleUpgrade()`.
      * @param data - Raw binary message frame.
-     * @param send - Callback to send a binary response to this client.
+     * @param send - Callback to send a binary response to THIS client only.
      */
     handleMessage(session: WsSession, data: ArrayBuffer | Uint8Array, send: (msg: Uint8Array) => void): Promise<void>;
     /**
-     * Broadcasts a Brainy change event to a connected client.
+     * Called when a peer's WebSocket connection closes.
+     *
+     * Notifies the `YDocManager` so it can flush and discard Y.Docs that no longer
+     * have any active peers.
      *
-     * Call this from your mutation hooks or after `brain.add()` / `brain.update()` /
-     * `brain.delete()` to push real-time updates to the client.
+     * @param session - The session state of the disconnecting peer.
+     */
+    handleClose(session: WsSession): Promise<void>;
+    /**
+     * Broadcasts a Brainy change event to a connected client.
      *
      * @param event - The change event to broadcast.
      * @param send - Callback to send the encoded event to the target client.
@@ -207,7 +248,62 @@ export interface BrainyWsHandler {
     broadcastChange(event: BrainyChangeEvent, send: (msg: Uint8Array) => void): void;
 }
 /**
- * Creates a server-side WebSocket handler for bidirectional Brainy RPC + change push.
+ * Creates a server-side WebSocket handler for bidirectional Brainy RPC, real-time
+ * change push, and optional Y.js collaborative document editing.
+ *
+ * ## Y.js collaborative editing
+ *
+ * Pass a `ydocManager` in the config to enable co-editing. The handler will
+ * automatically route `y-sync`, `y-update`, and `y-awareness` messages through the
+ * manager. The product server must:
+ *
+ * 1. Maintain a `Map<scope, Map<peerId, sendFn>>` of connected peers.
+ * 2. Set `session.broadcast` after `handleUpgrade()` to fan out Y.js frames.
+ * 3. Call `handleClose(session)` when a peer disconnects.
+ *
+ * @example Workshop server wiring with Y.js
+ * ```typescript
+ * import { createBrainyWsHandler, YDocManager } from '@soulcraft/sdk/server'
+ *
+ * const ydocManager = new YDocManager()
+ * const wsHandler = createBrainyWsHandler({ resolveBrain, authenticate, ydocManager })
+ *
+ * // Map<scope, Map<peerId, send>>
+ * const peers = new Map<string, Map<string, (msg: Uint8Array) => void>>()
+ *
+ * Bun.serve({
+ *   async fetch(req, server) {
+ *     if (new URL(req.url).pathname === '/api/brainy/ws') {
+ *       const session = await wsHandler.handleUpgrade(req)
+ *       if (!session) return new Response('Unauthorized', { status: 401 })
+ *       // Register peer in broadcast map
+ *       if (!peers.has(session.scope)) peers.set(session.scope, new Map())
+ *       server.upgrade(req, { data: session })
+ *       return undefined
+ *     }
+ *   },
+ *   websocket: {
+ *     open(ws) {
+ *       const session = ws.data as WsSession
+ *       peers.get(session.scope)!.set(session.peerId, (msg) => ws.send(msg))
+ *       session.broadcast = (msg, excludeId) => {
+ *         for (const [id, send] of peers.get(session.scope) ?? []) {
+ *           if (id !== excludeId) send(msg)
+ *         }
+ *       }
+ *       ws.send(encode({ type: 'ready', scope: session.scope }))
+ *     },
+ *     async message(ws, data) {
+ *       await wsHandler.handleMessage(ws.data, data as ArrayBuffer, (msg) => ws.send(msg))
+ *     },
+ *     async close(ws) {
+ *       const session = ws.data as WsSession
+ *       peers.get(session.scope)?.delete(session.peerId)
+ *       await wsHandler.handleClose(session)
+ *     },
+ *   },
+ * })
+ * ```
  *
  * @param config - Handler configuration.
  * @returns A {@link BrainyWsHandler} instance.

package/dist/server/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/server/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAMpE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;OAQG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAEnD;;;;;;;;OAQG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAE3D;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,CACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EAAE,EACf,IAAI,EAAE,OAAO,KACV,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAE7C;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAQD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,GAC1B,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA0DzC;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAEhD;;;;;;;;;OASG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAEvE;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EAAE,EACf,IAAI,EAAE,OAAO,KACV,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAE7C,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,4DAA4D;AAC5D,MAAM,WAAW,SAAS;IACxB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,qDAAqD;IACrD,IAAI,EAAE,OAAO,CAAA;IACb,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,SAAS,EAAE,cAAc,CAAA;CAC1B;AASD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;OASG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAE1D;;;;;;;;;OASG;IACH,aAAa,CACX,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,WAAW,GAAG,UAAU,EAC9B,IAAI,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAC9B,OAAO,CAAC,IAAI,CAAC,CAAA;IAEhB;;;;;;;;OAQG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAA;CACjF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAkEpF"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/server/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAM/D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;OAQG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAEnD;;;;;;;;OAQG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAE3D;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,CACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EAAE,EACf,IAAI,EAAE,OAAO,KACV,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAE7C;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAQD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,GAC1B,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA0DzC;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAEhD;;;;;;;;;OASG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAEvE;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EAAE,EACf,IAAI,EAAE,OAAO,KACV,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAE7C,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IAEzB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAoDD,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACxB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,qDAAqD;IACrD,IAAI,EAAE,OAAO,CAAA;IACb,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,SAAS,EAAE,cAAc,CAAA;IACzB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;;;;;;;;;OAUG;IACH,SAAS,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5D;AAiBD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAE1D;;;;;;;;;;;;;OAaG;IACH,aAAa,CACX,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,WAAW,GAAG,UAAU,EAC9B,IAAI,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAC9B,OAAO,CAAC,IAAI,CAAC,CAAA;IAEhB;;;;;;;OAOG;IACH,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE9C;;;;;OAKG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAA;CACjF;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CA2GpF"}