@yuhere/js-jsonrpc2 0.0.0-stage → 2.1.2

package/dist/transport/stdio/middleware.js

@@ -0,0 +1,274 @@
+import { StringDecoder } from 'node:string_decoder';
+import { Repository } from '../../core/Repository';
+import { INTERNAL_ERROR, PARSE_ERROR } from '../../errors/codes';
+import { RPCVersion } from '../../schema/z/protocol';
+import { stringify } from '../../stream/stringify-stream';
+function isStreamSuccess(payload) {
+    return (!!payload &&
+        typeof payload === 'object' &&
+        typeof payload.chunks === 'object' &&
+        payload.chunks !== null &&
+        typeof payload.chunks[Symbol.asyncIterator] === 'function');
+}
+/**
+ * Serve JSON-RPC 2.0 over a pair of newline-delimited JSON (NDJSON) streams.
+ *
+ * This is useful for IDE/CLI integrations where each request is a single line
+ * of JSON on stdin and each response is a single line of JSON on stdout.
+ *
+ * Resolves when the input stream ends.
+ */
+export async function serveStdio(options = {}) {
+    const repository = options.repository ?? new Repository();
+    const input = options.input ?? process.stdin;
+    const output = options.output ?? process.stdout;
+    const framing = options.framing ?? 'lines';
+    const maxFrameBytes = options.maxFrameBytes ?? 1024 * 1024;
+    const decoder = new StringDecoder('utf8');
+    let buffer = '';
+    // Serialize writes so responses don't interleave.
+    let writeChain = Promise.resolve();
+    const ctx = {
+        repository,
+        options,
+        injectables: buildInjectables(options.mkInjectable, repository),
+        writeChain: () => writeChain,
+        setWriteChain: (p) => {
+            writeChain = p;
+        },
+        output,
+    };
+    await new Promise((resolve, reject) => {
+        const onData = (chunk) => {
+            try {
+                buffer += typeof chunk === 'string' ? chunk : decoder.write(chunk);
+                if (framing === 'lines') {
+                    const parts = buffer.split('\n');
+                    buffer = parts.pop() ?? '';
+                    for (const line of parts) {
+                        const trimmed = line.trim();
+                        if (trimmed.length > 0) {
+                            void dispatch(ctx, trimmed);
+                        }
+                    }
+                }
+                else {
+                    // JSON framing: extract balanced JSON values.
+                    let consumed = 0;
+                    let rest = buffer;
+                    while (rest.length > 0) {
+                        const slice = extractJsonValue(rest);
+                        if (slice === undefined)
+                            break;
+                        consumed += slice.length;
+                        rest = rest.slice(slice.length);
+                        if (slice.trim().length > 0) {
+                            void dispatch(ctx, slice);
+                        }
+                    }
+                    buffer = rest;
+                }
+                if (buffer.length > maxFrameBytes) {
+                    throw new Error(`JSON-RPC frame exceeded ${maxFrameBytes} bytes without terminator.`);
+                }
+            }
+            catch (error) {
+                reject(error);
+            }
+        };
+        const onEnd = () => {
+            // Flush any trailing frame (no trailing newline).
+            const trailing = framing === 'lines' ? buffer.trim() : buffer.trim();
+            buffer = '';
+            if (trailing.length > 0) {
+                void dispatch(ctx, trailing);
+            }
+            input.off('data', onData);
+            input.off('end', onEnd);
+            input.off('error', onError);
+            // Wait for outstanding writes to drain before resolving.
+            writeChain.then(() => resolve(), reject);
+        };
+        const onError = (error) => {
+            input.off('data', onData);
+            input.off('end', onEnd);
+            input.off('error', onError);
+            reject(error);
+        };
+        input.on('data', onData);
+        input.on('end', onEnd);
+        input.on('error', onError);
+    });
+}
+async function dispatch(ctx, text) {
+    let input;
+    try {
+        input = JSON.parse(text);
+    }
+    catch (error) {
+        await writeResponse(ctx, {
+            jsonrpc: RPCVersion,
+            id: null,
+            error: {
+                code: PARSE_ERROR,
+                message: 'Parse error',
+                ...(process.env['NODE_ENV'] !== 'production'
+                    ? { data: error instanceof Error ? error.message : String(error) }
+                    : {}),
+            },
+        });
+        return;
+    }
+    let output;
+    try {
+        output = await ctx.repository.invoke(input, {
+            injections: ctx.injectables,
+            errorTransform: ctx.options.errorTransform,
+        });
+    }
+    catch (error) {
+        output = fallbackFailure(error);
+    }
+    if (isStreamSuccess(output)) {
+        await writeStream(ctx, output);
+        return;
+    }
+    await writeResponse(ctx, output);
+}
+async function writeStream(ctx, stream) {
+    try {
+        for await (const chunk of stream.chunks) {
+            await writeFrame(ctx, chunk);
+        }
+    }
+    catch (error) {
+        if (process.env['NODE_ENV'] !== 'production') {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error('Failed to stream JSON-RPC response over stdio', message, error);
+        }
+    }
+}
+async function writeResponse(ctx, payload) {
+    await enqueueWrite(ctx, payload);
+}
+async function writeFrame(ctx, chunk) {
+    await enqueueWrite(ctx, chunk);
+}
+async function enqueueWrite(ctx, payload) {
+    const next = ctx.writeChain().then(() => new Promise(async (resolve) => {
+        const text = await stringify(payload) + '\n';
+        let done = false;
+        const finish = () => {
+            if (done)
+                return;
+            done = true;
+            resolve();
+        };
+        try {
+            const flushed = ctx.output.write(text, 'utf8', finish);
+            if (flushed) {
+                // Node may not call the callback if the buffer was already flushed
+                // for some streams; still resolve on next tick to be safe.
+                queueMicrotask(finish);
+            }
+        }
+        catch (error) {
+            if (process.env['NODE_ENV'] !== 'production') {
+                console.error('Failed to write JSON-RPC response to stdio', error);
+            }
+            finish();
+        }
+        if ('chunks' in payload === false && ctx.options.onResponse) {
+            try {
+                ctx.options.onResponse(payload);
+            }
+            catch {
+                /* ignore listener errors */
+            }
+        }
+    }));
+    ctx.setWriteChain(next);
+    await next;
+}
+function buildInjectables(factory, repository) {
+    if (typeof factory === 'function') {
+        // No HTTP req/res in stdio; pass through placeholder values.
+        return factory(undefined, undefined, repository);
+    }
+    return {
+        repository,
+        input: process.stdin,
+        output: process.stdout,
+    };
+}
+function fallbackFailure(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        jsonrpc: RPCVersion,
+        id: null,
+        error: {
+            code: INTERNAL_ERROR,
+            message: 'Internal error',
+            ...(process.env['NODE_ENV'] !== 'production' ? { data: message } : {}),
+        },
+    };
+}
+/**
+ * Scan `text` for the first complete JSON value and return it.
+ * Returns `undefined` if `text` does not yet contain a complete value.
+ */
+function extractJsonValue(text) {
+    let i = 0;
+    // Skip leading whitespace.
+    while (i < text.length && isWs(text.charCodeAt(i)))
+        i++;
+    if (i >= text.length)
+        return undefined;
+    const start = i;
+    const first = text.charCodeAt(i);
+    if (first !== 0x7b /* { */ && first !== 0x5b /* [ */) {
+        // Primitive top-level values (unusual for RPC, but JSON-valid).
+        // Consume until whitespace or end.
+        while (i < text.length && !isWs(text.charCodeAt(i)))
+            i++;
+        if (i >= text.length)
+            return undefined;
+        return text.slice(start, i);
+    }
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (; i < text.length; i++) {
+        const ch = text.charCodeAt(i);
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+            }
+            else if (ch === 0x5c /* \ */) {
+                escaped = true;
+            }
+            else if (ch === 0x22 /* " */) {
+                inString = false;
+            }
+            continue;
+        }
+        if (ch === 0x22) {
+            inString = true;
+        }
+        else if (ch === 0x7b || ch === 0x5b) {
+            depth++;
+        }
+        else if (ch === 0x7d || ch === 0x5d) {
+            depth--;
+            if (depth === 0) {
+                return text.slice(start, i + 1);
+            }
+        }
+    }
+    return undefined;
+}
+function isWs(code) {
+    // space, \t, \n, \r
+    return code === 0x20 || code === 0x09 || code === 0x0a || code === 0x0d;
+}
+//# sourceMappingURL=middleware.js.map

package/dist/transport/stdio/middleware.js.map

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

package/dist/transport/ws/index.d.ts

@@ -0,0 +1,3 @@
+export { attachWebSocket, type WSOptions } from './middleware';
+export { createWebSocketServer, type StandaloneWsOptions, type StandaloneWsHandle, } from './standalone';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/ws/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/ws/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC"}

package/dist/transport/ws/index.js

@@ -0,0 +1,3 @@
+export { attachWebSocket } from './middleware';
+export { createWebSocketServer, } from './standalone';
+//# sourceMappingURL=index.js.map

package/dist/transport/ws/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transport/ws/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,qBAAqB,GAGtB,MAAM,cAAc,CAAC"}

package/dist/transport/ws/middleware.d.ts

@@ -0,0 +1,25 @@
+import type { IncomingMessage, Server } from 'node:http';
+import { WebSocketServer, WebSocket } from 'ws';
+import { Repository } from '../../core/Repository';
+import type { InjectableFactory, RPCErrorTransform } from '../../types';
+export interface WSOptions {
+    /** Build injectables for a WS connection. */
+    mkInjectable?: InjectableFactory;
+    /** Global error transform. */
+    errorTransform?: RPCErrorTransform;
+    /** WebSocket server path (default: `/`). Only used by `attachWebSocket`. */
+    path?: string;
+    /** Whether to skip connection upgrade for non-matching paths. */
+    allowOrigin?: (origin: string | undefined, req: IncomingMessage) => boolean;
+    /** Max payload size forwarded to `ws` (default 1mb). */
+    maxPayload?: number;
+    /** Called once a connection is established. */
+    onConnection?: (socket: WebSocket, req: IncomingMessage) => void;
+}
+/**
+ * Attach a JSON-RPC 2.0 WebSocket endpoint to an existing `http.Server`.
+ *
+ * Returns the underlying `WebSocketServer` so the caller can close it.
+ */
+export declare function attachWebSocket(server: Server, repository: Repository, options: WSOptions): WebSocketServer;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/transport/ws/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/transport/ws/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,KAAK,EACR,iBAAiB,EAEjB,iBAAiB,EAIpB,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,SAAS;IACtB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,8BAA8B;IAC9B,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC;IAC5E,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;CACpE;AAmBD;;;;GAIG;AACH,wBAAgB,eAAe,CAC3B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,SAAS,GACnB,eAAe,CAgDjB"}

package/dist/transport/ws/middleware.js

@@ -0,0 +1,209 @@
+import { WebSocketServer, WebSocket } from 'ws';
+import { INTERNAL_ERROR, PARSE_ERROR } from '../../errors/codes';
+import { stringify } from "../../stream/stringify-stream";
+import { RPCVersion } from '../../schema/z/protocol';
+function isStreamSuccess(payload) {
+    return (!!payload &&
+        typeof payload === 'object' &&
+        typeof payload.chunks === 'object' &&
+        payload.chunks !== null &&
+        typeof payload.chunks[Symbol.asyncIterator] === 'function');
+}
+/**
+ * Attach a JSON-RPC 2.0 WebSocket endpoint to an existing `http.Server`.
+ *
+ * Returns the underlying `WebSocketServer` so the caller can close it.
+ */
+export function attachWebSocket(server, repository, options) {
+    const wss = new WebSocketServer({
+        noServer: true,
+        maxPayload: options.maxPayload ?? 1024 * 1024,
+    });
+    const path = options.path ?? '/';
+    const upgradeHandler = (req, socket, head) => {
+        const url = req.url ?? '/';
+        // Strip query string before matching.
+        const pathname = url.split('?', 1)[0] ?? '/';
+        if (pathname !== path) {
+            socket.destroy();
+            return;
+        }
+        if (options.allowOrigin) {
+            const origin = req.headers.origin;
+            if (!options.allowOrigin(origin, req)) {
+                socket.destroy();
+                return;
+            }
+        }
+        wss.handleUpgrade(req, socket, head, (ws) => {
+            wss.emit('connection', ws, req);
+        });
+    };
+    server.on('upgrade', upgradeHandler);
+    // Cleanup hook so callers can detach the upgrade handler.
+    const originalClose = wss.close.bind(wss);
+    wss.close = ((callback) => {
+        server.off('upgrade', upgradeHandler);
+        return originalClose(callback);
+    });
+    wss.on('connection', (ws, req) => {
+        handleConnection(ws, req, repository, options);
+    });
+    return wss;
+}
+function handleConnection(ws, req, repository, options) {
+    const injectables = buildInjectables(options.mkInjectable, ws, req, repository);
+    const ctx = {
+        repository,
+        options,
+        injectables,
+        closed: false,
+    };
+    if (options.onConnection) {
+        options.onConnection(ws, req);
+    }
+    ws.on('message', (data, isBinary) => {
+        void onMessage(ctx, ws, data, isBinary);
+    });
+    ws.on('close', () => {
+        ctx.closed = true;
+    });
+    ws.on('error', (error) => {
+        if (process.env['NODE_ENV'] !== 'production') {
+            console.error('JSON-RPC WebSocket error', error);
+        }
+    });
+}
+async function onMessage(ctx, ws, data, isBinary) {
+    if (ctx.closed || ws.readyState !== WebSocket.OPEN)
+        return;
+    let input;
+    try {
+        input = parseFrame(data, isBinary);
+    }
+    catch (error) {
+        await send(ctx, ws, {
+            jsonrpc: RPCVersion,
+            id: null,
+            error: {
+                code: PARSE_ERROR,
+                message: 'Parse error',
+                ...(process.env['NODE_ENV'] !== 'production'
+                    ? { data: error instanceof Error ? error.message : String(error) }
+                    : {}),
+            },
+        });
+        return;
+    }
+    let output;
+    try {
+        output = await ctx.repository.invoke(input, {
+            injections: ctx.injectables,
+            errorTransform: ctx.options.errorTransform,
+        });
+    }
+    catch (error) {
+        output = fallbackFailure(error);
+    }
+    if (isStreamSuccess(output)) {
+        await sendStream(ctx, ws, output);
+        return;
+    }
+    await send(ctx, ws, output);
+}
+async function sendStream(ctx, ws, stream) {
+    const onClose = () => {
+        void stream.chunks.return?.(undefined);
+    };
+    ws.once('close', onClose);
+    try {
+        for await (const chunk of stream.chunks) {
+            if (ctx.closed || ws.readyState !== WebSocket.OPEN)
+                break;
+            await sendRaw(ctx, ws, chunk);
+        }
+    }
+    catch (error) {
+        if (process.env['NODE_ENV'] !== 'production') {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error('Failed to stream JSON-RPC response over WebSocket', message, error);
+        }
+    }
+    finally {
+        ws.off('close', onClose);
+    }
+}
+function parseFrame(data, isBinary) {
+    // Reject binary frames: protocol requires text JSON.
+    if (isBinary) {
+        throw new Error('Binary frames are not supported; send JSON text.');
+    }
+    let text;
+    if (typeof data === 'string') {
+        text = data;
+    }
+    else if (Buffer.isBuffer(data)) {
+        text = data.toString('utf8');
+    }
+    else if (Array.isArray(data)) {
+        text = Buffer.concat(data).toString('utf8');
+    }
+    else {
+        text = Buffer.from(data).toString('utf8');
+    }
+    return JSON.parse(text);
+}
+async function send(ctx, ws, payload) {
+    if (ctx.closed || ws.readyState !== WebSocket.OPEN)
+        return;
+    try {
+        const text = await stringify(payload);
+        await new Promise((resolve, reject) => {
+            ws.send(text, (error) => (error ? reject(error) : resolve()));
+        });
+    }
+    catch (error) {
+        if (process.env['NODE_ENV'] !== 'production') {
+            console.error('Failed to send JSON-RPC response over WebSocket', error);
+        }
+    }
+}
+/** 发送一个流帧（RPCStreamChunk 已是完整帧）。 */
+async function sendRaw(ctx, ws, chunk) {
+    if (ctx.closed || ws.readyState !== WebSocket.OPEN)
+        return;
+    try {
+        const text = await stringify(chunk);
+        await new Promise((resolve, reject) => {
+            ws.send(text, (error) => (error ? reject(error) : resolve()));
+        });
+    }
+    catch (error) {
+        if (process.env['NODE_ENV'] !== 'production') {
+            console.error('Failed to send JSON-RPC stream chunk over WebSocket', error);
+        }
+    }
+}
+function fallbackFailure(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        jsonrpc: RPCVersion,
+        id: null,
+        error: {
+            code: INTERNAL_ERROR,
+            message: 'Internal error',
+            ...(process.env['NODE_ENV'] !== 'production' ? { data: message } : {}),
+        },
+    };
+}
+function buildInjectables(factory, ws, req, repository) {
+    if (typeof factory === 'function') {
+        return factory(ws, req, repository);
+    }
+    return {
+        socket: ws,
+        request: req,
+        repository,
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/transport/ws/middleware.js.map

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

package/dist/transport/ws/standalone.d.ts

@@ -0,0 +1,22 @@
+import { type Server } from 'node:http';
+import { WebSocketServer } from 'ws';
+import { type WSOptions } from './middleware';
+export interface StandaloneWsOptions extends WSOptions {
+    /** Existing HTTP server to attach to. If omitted, one is created. */
+    server?: Server;
+    /** Port for the auto-created server. */
+    port?: number;
+    /** Host for the auto-created server. */
+    host?: string;
+}
+export interface StandaloneWsHandle {
+    server: Server;
+    wss: WebSocketServer;
+    close(): Promise<void>;
+}
+/**
+ * Create a standalone HTTP server (unless one is provided) and attach the
+ * JSON-RPC WebSocket endpoint. Returns a handle for clean shutdown.
+ */
+export declare function createWebSocketServer(options?: StandaloneWsOptions): Promise<StandaloneWsHandle>;
+//# sourceMappingURL=standalone.d.ts.map

package/dist/transport/ws/standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../../src/transport/ws/standalone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAErC,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE/D,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,eAAe,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAgC7B"}

package/dist/transport/ws/standalone.js

@@ -0,0 +1,39 @@
+import { createServer } from 'node:http';
+import { Repository } from '../../core/Repository';
+import { attachWebSocket } from './middleware';
+/**
+ * Create a standalone HTTP server (unless one is provided) and attach the
+ * JSON-RPC WebSocket endpoint. Returns a handle for clean shutdown.
+ */
+export async function createWebSocketServer(options = {}) {
+    const server = options.server ?? createServer();
+    const wss = attachWebSocket(server, new Repository(), options);
+    if (!options.server) {
+        const port = options.port ?? 8080;
+        const host = options.host ?? '127.0.0.1';
+        await new Promise((resolve, reject) => {
+            const onError = (error) => {
+                server.off('listening', onListening);
+                reject(error);
+            };
+            const onListening = () => {
+                server.off('error', onError);
+                resolve();
+            };
+            server.once('error', onError);
+            server.once('listening', onListening);
+            server.listen(port, host);
+        });
+    }
+    return {
+        server,
+        wss,
+        async close() {
+            await new Promise((resolve) => wss.close(() => resolve()));
+            if (!options.server) {
+                await new Promise((resolve) => server.close(() => resolve()));
+            }
+        },
+    };
+}
+//# sourceMappingURL=standalone.js.map

package/dist/transport/ws/standalone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.js","sourceRoot":"","sources":["../../../src/transport/ws/standalone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAkB,MAAM,cAAc,CAAC;AAiB/D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAO,GAAwB,EAAE;IAEjC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;IAChD,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IAE/D,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;QACzC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,EAAE;gBAC/B,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;gBACrC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC;YACF,MAAM,WAAW,GAAG,GAAG,EAAE;gBACvB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC7B,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,MAAM;QACN,GAAG;QACH,KAAK,CAAC,KAAK;YACT,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACjE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}