@soulcraft/sdk 1.5.5 → 1.6.0

package/dist/client/index.d.ts

@@ -59,6 +59,8 @@ export { PostMessageTransport } from '../transports/postmessage.js';
 export type { PostMessageRequest, PostMessageResponse } from '../transports/postmessage.js';
 export type { SDKTransport } from '../transports/transport.js';
 export { createBrainyProxy } from '../modules/brainy/proxy.js';
+export { createYjsProvider } from '../transports/yjs-provider.js';
+export type { YjsProvider } from '../transports/yjs-provider.js';
 export { joinHallRoom } from '../modules/hall/browser.js';
 export type { JoinHallRoomOptions } from '../modules/hall/browser.js';
 export type { HallRoomHandle, HallRoomHandleEvents, TranscriptEvent, ConceptMentionEvent, RelationProposedEvent, SpeakerChangedEvent, PeerJoinedEvent, PeerLeftEvent, RoomOptions, RecordingManifest, ConceptInput, } from '../modules/hall/types.js';

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAGxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAC3F,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAG9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AACrE,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAA;AAGjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAGxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAC3F,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AACrE,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAA;AAGjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}

package/dist/client/index.js

@@ -60,6 +60,8 @@ export { SseTransport } from '../transports/sse.js';
 export { PostMessageTransport } from '../transports/postmessage.js';
 // ── Proxy factory ─────────────────────────────────────────────────────────────
 export { createBrainyProxy } from '../modules/brainy/proxy.js';
+// ── Y.js provider (collaborative editing) ─────────────────────────────────────
+export { createYjsProvider } from '../transports/yjs-provider.js';
 // ── Hall room client (browser WebRTC) ─────────────────────────────────────────
 export { joinHallRoom } from '../modules/hall/browser.js';
 export { SDKError, SDKDisconnectedError, SDKTimeoutError, SDKAuthError, SDKForbiddenError, SDKRpcError, SDKMethodNotFoundError, } from '../modules/brainy/errors.js';

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,iFAAiF;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAInE,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAE9D,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAoBzD,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,iFAAiF;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAInE,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAE9D,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAGjE,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAoBzD,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}

package/dist/modules/brainy/ydoc-manager.d.ts

@@ -0,0 +1,175 @@
+/**
+ * @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';
+import type { Brainy } from '@soulcraft/brainy';
+/**
+ * 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 declare class YDocManager {
+    /** Pool of live Y.Doc instances keyed by `${scope}:${filePath}`. */
+    private readonly docs;
+    /**
+     * 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.
+     */
+    getOrCreate(scope: string, filePath: string, brain: Brainy, peerId: string): Promise<Y.Doc>;
+    /**
+     * 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).
+     */
+    applyUpdate(scope: string, filePath: string, update: Uint8Array): Promise<void>;
+    /**
+     * 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`.
+     */
+    getStateVector(scope: string, filePath: string, brain: Brainy): Promise<Uint8Array>;
+    /**
+     * 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`.
+     */
+    getDiff(scope: string, filePath: string, brain: Brainy, clientStateVector: Uint8Array): Promise<Uint8Array>;
+    /**
+     * 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.
+     */
+    onPeerDisconnect(scope: string, filePath: string, peerId: string): Promise<void>;
+    /**
+     * 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.
+     */
+    invalidate(scope: string, filePath: string, brain: Brainy): Promise<void>;
+    /**
+     * 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.
+     */
+    onPeerDisconnectAll(scope: string, peerId: string): Promise<void>;
+    /**
+     * 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}`).
+     */
+    flushAndDiscardScope(scope: string): Promise<void>;
+    /**
+     * Loads a Y.Doc from the `.ydoc` binary log, falling back to converting the
+     * canonical file if no log exists yet.
+     */
+    private _load;
+    /**
+     * Schedules the periodic 30s flush for the given document entry.
+     */
+    private _scheduleFlush;
+    /**
+     * Flushes the live Y.Doc to the canonical format in the VFS.
+     */
+    private _flush;
+}
+//# sourceMappingURL=ydoc-manager.d.ts.map

package/dist/modules/brainy/ydoc-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ydoc-manager.d.ts","sourceRoot":"","sources":["../../../src/modules/brainy/ydoc-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AA0C/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAW;IACtB,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IAInD;;;;;;;;;;;;OAYG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAwBjB;;;;;;;;;;;OAWG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrF;;;;;;;;;OASG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAYzF;;;;;;;;;;OAUG;IACG,OAAO,CACX,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,UAAU,GAC5B,OAAO,CAAC,UAAU,CAAC;IAYtB;;;;;;;;;;;;;OAaG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtF;;;;;;;;;;;OAWG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B/E;;;;;;;;;OASG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvE;;;;;;;OAOG;IACG,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBxD;;;OAGG;YACW,KAAK;IA2BnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;YACW,MAAM;CAQrB"}

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"}