@inhuman.tools/harness 0.0.0-stage → 0.2.0

package/dist/yjs/rooms.js

@@ -0,0 +1,328 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+/**
+ * Public rooms over DocumentService. Occupancy is a fact; park() drops an
+ * execution hold without closing the room or destroying another consumer's replica.
+ */
+import { DisposableClass, disposableGuard } from "@inhuman.tools/harness-commons";
+import { encodeJsonRpcError, encodeJsonRpcResult, jsonRpcRequest, JSON_RPC_INTERNAL_ERROR, JSON_RPC_INVALID_REQUEST, JSON_RPC_PARSE_ERROR, } from "../protocol/rpc/index.js";
+import { DocumentService } from "./document-service.js";
+import { AwarenessRoom, attachLens } from "./relay.js";
+export const EXECUTION_UNAVAILABLE_CODE = -32_004;
+export const EXECUTION_UNAVAILABLE_MESSAGE = "execution-unavailable";
+function keyId(key) {
+    return `${key.kind}\0${key.id}`;
+}
+class OccupancyLedger {
+    serverEpoch;
+    #sequence = 0;
+    #nextClientId = 1;
+    #seats = new Map();
+    #listeners = new Set();
+    constructor(serverEpoch) {
+        this.serverEpoch = serverEpoch;
+    }
+    snapshot() {
+        return {
+            serverEpoch: this.serverEpoch,
+            sequence: this.#sequence,
+            seats: [...this.#seats.values()],
+        };
+    }
+    watch(listener) {
+        this.#listeners.add(listener);
+        return () => {
+            this.#listeners.delete(listener);
+        };
+    }
+    join(socket, sessionId) {
+        const seat = {
+            sessionId,
+            clientId: this.#nextClientId,
+        };
+        this.#nextClientId += 1;
+        this.#seats.set(socket, seat);
+        return this.#emit();
+    }
+    leave(socket) {
+        if (!this.#seats.delete(socket))
+            return undefined;
+        return this.#emit();
+    }
+    #emit() {
+        this.#sequence += 1;
+        const snapshot = this.snapshot();
+        for (const listener of this.#listeners)
+            listener(snapshot);
+        return snapshot;
+    }
+}
+let DocumentRoom = (() => {
+    let _classSuper = DisposableClass;
+    let _instanceExtraInitializers = [];
+    let _acquire_decorators;
+    let _hold_decorators;
+    return class DocumentRoom extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _acquire_decorators = [disposableGuard];
+            _hold_decorators = [disposableGuard];
+            __esDecorate(this, null, _acquire_decorators, { kind: "method", name: "acquire", static: false, private: false, access: { has: obj => "acquire" in obj, get: obj => obj.acquire }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _hold_decorators, { kind: "method", name: "hold", static: false, private: false, access: { has: obj => "hold" in obj, get: obj => obj.hold }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        ref = __runInitializers(this, _instanceExtraInitializers);
+        awareness = new AwarenessRoom();
+        #sockets = new Set();
+        #executionHolds = 0;
+        #closeCode = 1001;
+        #closeReason = "room closed";
+        constructor(ref) {
+            super();
+            this.ref = ref;
+        }
+        get key() {
+            return this.ref.key;
+        }
+        get doc() {
+            return this.ref.doc;
+        }
+        get closed() {
+            return this.disposed;
+        }
+        get socketCount() {
+            return this.#sockets.size;
+        }
+        get executionHolds() {
+            return this.#executionHolds;
+        }
+        /** Extra replica consumer (runtime). park() releases this, not the room. */
+        acquire() {
+            this.#executionHolds += 1;
+        }
+        /**
+         * Drop one execution hold. Does not close the room or disconnect sockets,
+         * and does not destroy a replica another consumer still holds.
+         */
+        park() {
+            if (this.#executionHolds > 0)
+                this.#executionHolds -= 1;
+        }
+        hold(socket) {
+            this.#sockets.add(socket);
+            socket.onClose(() => {
+                this.#sockets.delete(socket);
+            });
+        }
+        close(code = 1001, reason = "room closed") {
+            if (this.disposed)
+                return;
+            this.#closeCode = code;
+            this.#closeReason = reason;
+            this[Symbol.dispose]();
+        }
+        dispose() {
+            this.#executionHolds = 0;
+            this.#sockets.clear();
+            this.awareness.close(this.#closeCode, this.#closeReason);
+        }
+    };
+})();
+export { DocumentRoom };
+export class YjsServer {
+    documents;
+    #rooms = new Map();
+    #occupancy;
+    #ops = new Map();
+    constructor(options) {
+        this.documents = new DocumentService(options);
+        this.#occupancy = new OccupancyLedger(this.documents.serverEpoch);
+    }
+    occupancy() {
+        return this.#occupancy.snapshot();
+    }
+    watchOccupancy(listener) {
+        return this.#occupancy.watch(listener);
+    }
+    getLoaded(key) {
+        return this.documents.getLoaded(key);
+    }
+    /**
+     * Load an on-disk image into a public room. Never creates a missing
+     * identity and never constructs an interpreter.
+     */
+    async openExisting(key) {
+        return this.#locked(key, () => this.#openExistingNow(key));
+    }
+    /** Explicit storage create. HTTP GET/open-existing never calls this. */
+    async create(key, initial) {
+        return this.#locked(key, async () => {
+            const existing = this.#rooms.get(keyId(key));
+            if (existing != null && !existing.closed) {
+                return { ok: true, ref: existing.ref };
+            }
+            const created = await this.documents.create(key, initial);
+            if (!created.ok)
+                return created;
+            this.#adopt(created.ref);
+            return created;
+        });
+    }
+    /**
+     * Sync attach onto an already-opened room. Closes the socket instead of
+     * leaving a connected client with no replica. Optional `rpc` forwards
+     * envelopes; missing execution is `-32004`, not local dispatch.
+     */
+    attach(key, socket, rpc) {
+        const room = this.#rooms.get(keyId(key));
+        if (room == null || room.closed) {
+            socket.close(1001, "room closed");
+            return false;
+        }
+        room.hold(socket);
+        socket.onClose(() => {
+            this.#occupancy.leave(socket);
+        });
+        if (key.kind === "sessions")
+            this.#occupancy.join(socket, key.id);
+        attachLens(room.doc, socket, room.awareness);
+        socket.onText((text) => {
+            void relayJsonRpc(socket, text, rpc, key);
+        });
+        return true;
+    }
+    /**
+     * Extra replica consumer (private peer / runtime). park() releases this,
+     * not the room.
+     */
+    acquire(key) {
+        const room = this.#rooms.get(keyId(key));
+        if (room == null || room.closed)
+            return false;
+        room.acquire();
+        return true;
+    }
+    /**
+     * Release execution for this room. Connected sockets and other replica
+     * consumers keep the document.
+     */
+    park(key) {
+        this.#rooms.get(keyId(key))?.park();
+    }
+    closeRoom(key, code, reason) {
+        const id = keyId(key);
+        const room = this.#rooms.get(id);
+        if (room == null)
+            return;
+        this.#rooms.delete(id);
+        room.close(code, reason);
+        this.documents.release(key);
+    }
+    [Symbol.dispose]() {
+        const rooms = [...this.#rooms.values()];
+        for (const room of rooms)
+            this.closeRoom(room.key);
+    }
+    async #openExistingNow(key) {
+        const existing = this.#rooms.get(keyId(key));
+        if (existing != null && !existing.closed) {
+            return { ok: true, room: existing };
+        }
+        const opened = await this.documents.openExisting(key);
+        if (!opened.ok)
+            return opened;
+        return { ok: true, room: this.#adopt(opened.ref) };
+    }
+    #adopt(ref) {
+        const id = keyId(ref.key);
+        const existing = this.#rooms.get(id);
+        if (existing != null && !existing.closed)
+            return existing;
+        const room = new DocumentRoom(ref);
+        this.#rooms.set(id, room);
+        return room;
+    }
+    async #locked(key, run) {
+        const id = keyId(key);
+        const previous = this.#ops.get(id);
+        const execute = previous == null ? run() : previous.then(run, run);
+        const tracked = execute.then(() => undefined, () => undefined);
+        this.#ops.set(id, tracked);
+        void tracked.then(() => {
+            if (this.#ops.get(id) === tracked)
+                this.#ops.delete(id);
+            return undefined;
+        });
+        return execute;
+    }
+}
+async function relayJsonRpc(socket, text, handler, key) {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch {
+        socket.sendText(encodeJsonRpcError(null, JSON_RPC_PARSE_ERROR, "Parse error"));
+        return;
+    }
+    const parsed = jsonRpcRequest.safeParse(raw);
+    if (!parsed.success) {
+        socket.sendText(encodeJsonRpcError(null, JSON_RPC_INVALID_REQUEST, "Invalid Request"));
+        return;
+    }
+    const { method, params, id } = parsed.data;
+    if (handler == null) {
+        if (id === undefined)
+            return;
+        socket.sendText(encodeJsonRpcError(id, EXECUTION_UNAVAILABLE_CODE, EXECUTION_UNAVAILABLE_MESSAGE));
+        return;
+    }
+    try {
+        const result = await handler(method, params, key);
+        if (id === undefined)
+            return;
+        socket.sendText(encodeJsonRpcResult(id, result));
+    }
+    catch (error) {
+        if (id === undefined)
+            return;
+        const code = typeof error === "object" && error !== null && "code" in error
+            ? Number(error.code)
+            : JSON_RPC_INTERNAL_ERROR;
+        const message = error instanceof Error ? error.message : "Internal error";
+        socket.sendText(encodeJsonRpcError(id, Number.isInteger(code) ? code : JSON_RPC_INTERNAL_ERROR, message));
+    }
+}
+//# sourceMappingURL=rooms.js.map

package/dist/yjs/rooms.js.map

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

package/dist/yjs/storage.d.ts

@@ -0,0 +1,29 @@
+import { type DocumentCheckpoint, type DocumentKey, type FlushResult } from "../protocol/document/index.js";
+export type ImageFlushRequest = {
+    readonly checkpoint: DocumentCheckpoint;
+    readonly image: Uint8Array;
+    /** Whole-document update, a superset of `image`. Called only to compact. */
+    readonly snapshot?: () => Uint8Array;
+    /**
+     * Replace the file with one snapshot instead of appending `image`, whatever the log's size. Honored only when
+     * `snapshot` is given; without it the image is appended as usual.
+     */
+    readonly force?: boolean;
+    readonly runtimeGeneration: number;
+    readonly connectionEpoch: number;
+};
+export declare function documentImagePath(root: string, key: DocumentKey): string;
+export declare class DocumentImageStore {
+    #private;
+    constructor(root: string);
+    get root(): string;
+    pathFor(key: DocumentKey): string;
+    /** The merged document update, or undefined when the file is missing. */
+    read(key: DocumentKey): Promise<Uint8Array | undefined>;
+    /**
+     * Append the captured update. The receipt covers that prefix only after
+     * the append is durable. A local mutation is not success.
+     */
+    flush(request: ImageFlushRequest): Promise<FlushResult>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/yjs/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/yjs/storage.ts"],"names":[],"mappings":"AAoBA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAEhB,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,UAAU,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC,CAAC;AAQF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAExE;AA8BD,qBAAa,kBAAkB;;gBAKjB,IAAI,EAAE,MAAM;IAIxB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM;IAIjC,yEAAyE;IACnE,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAiF7D;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;CAwD9D"}

package/dist/yjs/storage.js

@@ -0,0 +1,205 @@
+/**
+ * Sole image writer for a daemon root. Flush captures one update and
+ * appends it; success is that append plus fsync, not a local mutation.
+ * The file is an update log, so a later flush does not rewrite the prefix.
+ * `read` joins a length-prefixed log, or one bare update from before that framing. A log that
+ * is much larger than the joined snapshot is replaced once, after the join,
+ * so the next open does not replay it. A flush that would grow the log past
+ * {@link COMPACT_RATIO}× the last snapshot writes a fresh snapshot instead,
+ * so the file stays within that bound without a rewrite per flush. A flush
+ * that is `force`d writes the snapshot whatever the log's size: the vacuum of
+ * a stored session shrinks the live document, and only a snapshot drops the
+ * log's prefix that still holds what the vacuum moved out.
+ */
+import { randomUUID } from "node:crypto";
+import { mkdir, open, readFile, rename } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { trace } from "@inhuman.tools/harness-diagnostics";
+import * as Y from "yjs";
+import { documentImageSegments, encodeDocUpdate, } from "../protocol/document/index.js";
+import { encodeLogEntry, readUpdateLog } from "./update-log.js";
+const COMPACT_RATIO = 2;
+const COMPACT_FLOOR_BYTES = 1 << 20;
+export function documentImagePath(root, key) {
+    return join(root, ...documentImageSegments(key.kind, key.id));
+}
+function slotOf(key) {
+    return `${key.kind}\0${key.id}`;
+}
+function yieldMacrotask() {
+    return new Promise((resolve) => {
+        setImmediate(resolve);
+    });
+}
+/**
+ * Create the file if it is missing, append one log entry, then fsync.
+ * A crash before the fsync leaves the entry out of the durable prefix;
+ * the next flush encodes it again from the state vector.
+ */
+async function appendLogEntry(path, update) {
+    await mkdir(dirname(path), { recursive: true });
+    const entry = encodeLogEntry(update);
+    const handle = await open(path, "a", 0o600);
+    try {
+        await handle.appendFile(entry);
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+    return entry.byteLength;
+}
+export class DocumentImageStore {
+    #root;
+    #writes = new Map();
+    #sizes = new Map();
+    constructor(root) {
+        this.#root = root;
+    }
+    get root() {
+        return this.#root;
+    }
+    pathFor(key) {
+        return documentImagePath(this.#root, key);
+    }
+    /** The merged document update, or undefined when the file is missing. */
+    async read(key) {
+        let bytes;
+        try {
+            bytes = await readFile(this.pathFor(key));
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return undefined;
+            throw error;
+        }
+        const updates = readUpdateLog(bytes);
+        if (updates == null || updates.length === 0)
+            return undefined;
+        const doc = new Y.Doc();
+        try {
+            for (let index = 0; index < updates.length; index += 1) {
+                const update = updates[index];
+                if (update == null)
+                    continue;
+                Y.applyUpdate(doc, update);
+                // One long replay used to freeze the process: the session socket
+                // never opened, and the client gave up at the sync timeout.
+                if ((index & 31) === 31)
+                    await yieldMacrotask();
+            }
+            const merged = Y.encodeStateAsUpdate(doc);
+            this.#sizes.set(slotOf(key), { logBytes: bytes.byteLength, snapshotBytes: merged.byteLength });
+            if (updates.length > 1 && bytes.byteLength > merged.byteLength) {
+                await this.#compactSnapshot(key, merged);
+            }
+            return merged;
+        }
+        finally {
+            doc.destroy();
+        }
+    }
+    /**
+     * The joined snapshot replaces a bloated log. A flush already in flight
+     * owns the tail, so this does not race it.
+     */
+    async #compactSnapshot(key, merged) {
+        const slot = slotOf(key);
+        if (this.#writes.has(slot))
+            return;
+        const run = this.#writeSnapshot(key, merged);
+        const tracked = run.then(() => undefined, () => undefined);
+        this.#writes.set(slot, tracked);
+        void tracked.then(() => {
+            if (this.#writes.get(slot) === tracked)
+                this.#writes.delete(slot);
+            return undefined;
+        });
+        try {
+            await run;
+        }
+        catch (error) {
+            trace("harness-yjs-server:storage", `compact failed ${key.kind} ${key.id}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async #writeSnapshot(key, merged) {
+        const path = this.pathFor(key);
+        const tmp = `${path}.${randomUUID()}.tmp`;
+        await mkdir(dirname(path), { recursive: true });
+        const entry = encodeLogEntry(merged);
+        const handle = await open(tmp, "w", 0o600);
+        try {
+            await handle.writeFile(entry);
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        await rename(tmp, path);
+        this.#sizes.set(slotOf(key), { logBytes: entry.byteLength, snapshotBytes: merged.byteLength });
+    }
+    #outgrows(key, image) {
+        const size = this.#sizes.get(slotOf(key));
+        if (size == null)
+            return false;
+        const next = size.logBytes + image.byteLength;
+        return next > COMPACT_FLOOR_BYTES && next > COMPACT_RATIO * size.snapshotBytes;
+    }
+    /**
+     * Append the captured update. The receipt covers that prefix only after
+     * the append is durable. A local mutation is not success.
+     */
+    async flush(request) {
+        const captured = {
+            checkpoint: request.checkpoint,
+            image: new Uint8Array(request.image),
+            snapshot: request.snapshot,
+            force: request.force,
+            runtimeGeneration: request.runtimeGeneration,
+            connectionEpoch: request.connectionEpoch,
+        };
+        const slot = slotOf(captured.checkpoint.key);
+        const previous = this.#writes.get(slot);
+        const persist = () => this.#persist(captured);
+        const run = previous == null ? persist() : previous.then(persist, persist);
+        const tracked = run.then(() => undefined, () => undefined);
+        this.#writes.set(slot, tracked);
+        void tracked.then(() => {
+            if (this.#writes.get(slot) === tracked)
+                this.#writes.delete(slot);
+            return undefined;
+        });
+        return run;
+    }
+    async #persist(request) {
+        const { checkpoint, image, snapshot, force, runtimeGeneration, connectionEpoch } = request;
+        const key = checkpoint.key;
+        try {
+            if (snapshot != null && (force === true || this.#outgrows(key, image))) {
+                await this.#writeSnapshot(key, snapshot());
+            }
+            else {
+                const entryBytes = await appendLogEntry(this.pathFor(key), image);
+                const size = this.#sizes.get(slotOf(key));
+                if (size == null)
+                    this.#sizes.set(slotOf(key), { logBytes: entryBytes, snapshotBytes: image.byteLength });
+                else
+                    size.logBytes += entryBytes;
+            }
+        }
+        catch (error) {
+            trace("harness-yjs-server:storage", `write failed ${checkpoint.key.kind} ${checkpoint.key.id}: ${error instanceof Error ? error.message : String(error)}`);
+            return { ok: false, reason: "storage-failed" };
+        }
+        const receipt = {
+            key: checkpoint.key,
+            serverEpoch: checkpoint.serverEpoch,
+            runtimeGeneration,
+            connectionEpoch,
+            revision: checkpoint.revision,
+            prefix: encodeDocUpdate(image),
+        };
+        return { ok: true, receipt };
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/yjs/storage.js.map

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

package/dist/yjs/update-log.d.ts

@@ -0,0 +1,13 @@
+/** Unchanged state encodes as `[0, 0]`, not a 0-length buffer. */
+export declare function isEmptyUpdate(update: Uint8Array): boolean;
+/**
+ * The updates in order. A caller applies them onto one document one after
+ * another: a later entry is a delta and does not stand on its own, so
+ * merging them into one buffer drops everything after the first.
+ *
+ * A torn last entry (crash before fsync) is dropped. Earlier entries stay.
+ */
+export declare function readUpdateLog(bytes: Uint8Array): Uint8Array[] | null;
+/** Length prefix plus the update. Appending it extends a log. */
+export declare function encodeLogEntry(update: Uint8Array): Uint8Array;
+//# sourceMappingURL=update-log.d.ts.map

package/dist/yjs/update-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-log.d.ts","sourceRoot":"","sources":["../../src/yjs/update-log.ts"],"names":[],"mappings":"AAaA,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI,CAYpE;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAK7D"}