@aster-rpc/aster 0.1.2

package/dist/server.js

@@ -0,0 +1,511 @@
+/**
+ * Aster RPC server — QUIC accept loop + stream dispatch.
+ *
+ * Spec reference: S8.1 (Server API), S8.2 (Server accept loop)
+ *
+ * Accepts connections on an IrohNode, reads StreamHeaders, dispatches
+ * to registered service handlers, and writes responses + trailers.
+ *
+ * This module handles real QUIC streams (via NAPI-RS native addon).
+ * For in-process testing, use LocalTransport instead.
+ */
+import { JsonCodec } from './codec.js';
+import { writeFrame, readFrame, HEADER, TRAILER, COMPRESSED, CANCEL, } from './framing.js';
+import { SessionServer } from './session.js';
+import { RpcStatus } from './protocol.js';
+import { StatusCode, RpcError } from './status.js';
+import { RpcPattern } from './types.js';
+import { buildCallContext, applyRequestInterceptors, applyResponseInterceptors, } from './interceptors/base.js';
+import { withRequestContext, createLogger } from './logging.js';
+import { validateMetadata, MAX_HANDLER_TIMEOUT_S, MAX_CLIENT_STREAM_ITEMS } from './limits.js';
+import { DeadlineInterceptor } from './interceptors/deadline.js';
+/**
+ * Aster RPC server over real QUIC streams.
+ *
+ * @example
+ * ```ts
+ * const server = new RpcServer({
+ *   registry,
+ *   codec: new JsonCodec(),
+ * });
+ * await server.serve(node);
+ * ```
+ */
+export class RpcServer {
+    registry;
+    codec;
+    interceptors;
+    logger;
+    peerStore;
+    _serving = false;
+    _connections = new Set();
+    /** Mark the server as serving (enables handleConnection loops). */
+    setServing(value = true) { this._serving = value; }
+    constructor(opts) {
+        this.registry = opts.registry;
+        this.codec = opts.codec ?? new JsonCodec();
+        this.interceptors = opts.interceptors ?? [new DeadlineInterceptor()];
+        this.logger = opts.logger ?? createLogger();
+        this.peerStore = opts.peerStore;
+    }
+    /** Start accepting connections. Runs until close() is called. */
+    async serve(node) {
+        this._serving = true;
+        this.logger.info('server starting', { node_id: node.nodeId() });
+        while (this._serving) {
+            try {
+                const conn = await node.acceptAster();
+                this._connections.add(conn);
+                this.handleConnection(conn).catch(e => {
+                    this.logger.error('connection error', { error: String(e) });
+                }).finally(() => {
+                    this._connections.delete(conn);
+                });
+            }
+            catch (e) {
+                if (!this._serving)
+                    break;
+                this.logger.error('accept error', { error: String(e) });
+            }
+        }
+    }
+    /** Handle a single connection (accept streams in a loop). */
+    async handleConnection(conn) {
+        const peerId = conn.remoteNodeId();
+        this.logger.debug('connection opened', { peer: peerId });
+        try {
+            while (this._serving) {
+                try {
+                    const bi = await conn.acceptBi();
+                    const send = bi.takeSend();
+                    const recv = bi.takeRecv();
+                    this.handleStream(conn, send, recv).catch(e => {
+                        this.logger.error('stream error', { error: String(e), peer: peerId });
+                    });
+                }
+                catch (e) {
+                    const msg = String(e);
+                    if (msg.includes('normal close') || msg.includes('code 0'))
+                        break;
+                    if (!this._serving)
+                        break;
+                    throw e;
+                }
+            }
+        }
+        finally {
+            this.logger.debug('connection closed', { peer: peerId });
+        }
+    }
+    /** Handle a single RPC stream. */
+    async handleStream(conn, send, recv) {
+        try {
+            // Read StreamHeader (first frame, HEADER flag)
+            const frame = await readFrame(recv, 0);
+            if (!frame)
+                return;
+            const [payload, flags] = frame;
+            if (!(flags & HEADER)) {
+                await this.writeErrorTrailer(send, StatusCode.INTERNAL, 'first frame must have HEADER flag');
+                return;
+            }
+            // Sniff the first byte: '{' (0x7B) means JSON, anything else is binary
+            // (Fory XLANG). The TypeScript binding only speaks JSON because Fory JS
+            // is not yet XLANG-compliant — refuse binary requests with a clear,
+            // JSON-encoded error trailer the peer can decode either way.
+            if (!payload || payload[0] !== 0x7b /* '{' */) {
+                await this.writeErrorTrailer(send, StatusCode.INVALID_ARGUMENT, 'this server only supports JSON serialization (mode 3); resend the StreamHeader as JSON');
+                return;
+            }
+            const header = this.codec.decode(payload);
+            if (!header.service) {
+                await this.writeErrorTrailer(send, StatusCode.INVALID_ARGUMENT, 'missing service name');
+                return;
+            }
+            // Look up service
+            const svcInfo = this.registry.lookup(header.service, header.version);
+            if (!svcInfo) {
+                await this.writeErrorTrailer(send, StatusCode.NOT_FOUND, `service '${header.service}' v${header.version} not found`);
+                return;
+            }
+            // ── Session discriminator check ─────────────────────────────────
+            const isSessionStream = (header.method === '');
+            const isSessionService = (svcInfo.scoped === 'session');
+            if (isSessionStream !== isSessionService) {
+                let peerId = '';
+                try {
+                    peerId = conn.remoteNodeId();
+                }
+                catch { /* ignore */ }
+                let msg;
+                if (isSessionService) {
+                    msg = `'${header.service}' is session-scoped: open a session stream (method='') instead of calling method '${header.method}' directly`;
+                }
+                else {
+                    msg = `'${header.service}' is shared: send a method name instead of opening a session stream (method='')`;
+                }
+                this.logger.warn(`scope mismatch: ${msg}; peer=${peerId}`);
+                await this.writeErrorTrailer(send, StatusCode.FAILED_PRECONDITION, msg);
+                return;
+            }
+            if (isSessionStream) {
+                let peerId;
+                try {
+                    peerId = conn.remoteNodeId();
+                }
+                catch { /* ignore */ }
+                let attributes;
+                if (peerId && this.peerStore) {
+                    const m = this.peerStore.getAttributes(peerId);
+                    if (m.size > 0)
+                        attributes = Object.fromEntries(m);
+                }
+                const sessionServer = new SessionServer(this.codec, this.interceptors);
+                await sessionServer.handleSession(recv, send, svcInfo, header, peerId, attributes);
+                try {
+                    await send.finish();
+                }
+                catch { /* best effort */ }
+                return;
+            }
+            // ── End session discriminator ──────────────────────────────────
+            // Look up method (shared services only — session dispatch is above)
+            const methodInfo = svcInfo.methods.get(header.method);
+            if (!methodInfo) {
+                await this.writeErrorTrailer(send, StatusCode.UNIMPLEMENTED, `method '${header.service}.${header.method}' not found`);
+                return;
+            }
+            // Validate metadata
+            if (header.metadataKeys.length > 0) {
+                try {
+                    validateMetadata(header.metadataKeys, header.metadataValues);
+                }
+                catch {
+                    await this.writeErrorTrailer(send, StatusCode.RESOURCE_EXHAUSTED, 'metadata exceeds limits');
+                    return;
+                }
+            }
+            // Build call context
+            let peerId;
+            try {
+                peerId = conn.remoteNodeId();
+            }
+            catch { /* ignore */ }
+            // Pull admission attributes from the peer store so authorization
+            // interceptors (CapabilityInterceptor) see the caller's roles.
+            let attributes;
+            if (peerId && this.peerStore) {
+                const m = this.peerStore.getAttributes(peerId);
+                if (m.size > 0) {
+                    attributes = Object.fromEntries(m);
+                }
+            }
+            const callCtx = buildCallContext({
+                service: header.service,
+                method: header.method,
+                metadata: this.buildMetadata(header),
+                deadlineEpochMs: header.deadlineEpochMs,
+                peer: peerId,
+                pattern: methodInfo.pattern,
+                idempotent: methodInfo.idempotent,
+                callId: header.callId || undefined,
+                attributes,
+            });
+            // Dispatch by pattern
+            await withRequestContext({ service: header.service, method: header.method, requestId: callCtx.callId, peer: peerId }, () => this.dispatchRpc(svcInfo, methodInfo, callCtx, send, recv));
+        }
+        catch (e) {
+            if (e instanceof RpcError) {
+                await this.writeErrorTrailer(send, e.code, e.message);
+            }
+            else {
+                this.logger.error('stream handler error', { error: String(e) });
+                await this.writeErrorTrailer(send, StatusCode.INTERNAL, String(e));
+            }
+        }
+    }
+    /** Dispatch an RPC based on pattern. */
+    async dispatchRpc(svcInfo, methodInfo, callCtx, send, recv) {
+        const handler = methodInfo.handler;
+        if (!handler) {
+            await this.writeErrorTrailer(send, StatusCode.INTERNAL, 'no handler');
+            return;
+        }
+        // Run authorization-style interceptors BEFORE pattern dispatch.
+        // CallContext-only interceptors (CapabilityInterceptor, deadline, metrics,
+        // rate-limit) execute here and can reject the stream before any frames
+        // are read. This guarantees auth checks fire on every pattern, including
+        // bidi streams that might never produce a request frame.
+        try {
+            await applyRequestInterceptors(this.interceptors, callCtx, null);
+        }
+        catch (e) {
+            if (e instanceof RpcError) {
+                await this.writeErrorTrailer(send, e.code, e.message);
+                return;
+            }
+            throw e;
+        }
+        switch (methodInfo.pattern) {
+            case RpcPattern.UNARY:
+                await this.handleUnary(svcInfo, methodInfo, handler, callCtx, send, recv);
+                break;
+            case RpcPattern.SERVER_STREAM:
+                await this.handleServerStream(svcInfo, methodInfo, handler, callCtx, send, recv);
+                break;
+            case RpcPattern.CLIENT_STREAM:
+                await this.handleClientStream(svcInfo, methodInfo, handler, callCtx, send, recv);
+                break;
+            case RpcPattern.BIDI_STREAM:
+                await this.handleBidiStream(svcInfo, methodInfo, handler, callCtx, send, recv);
+                break;
+            default:
+                await this.writeErrorTrailer(send, StatusCode.INTERNAL, `unknown pattern: ${methodInfo.pattern}`);
+        }
+    }
+    async handleUnary(svcInfo, methodInfo, handler, callCtx, send, recv) {
+        // Read request
+        const reqFrame = await readFrame(recv, 0);
+        if (!reqFrame) {
+            await this.writeErrorTrailer(send, StatusCode.UNAVAILABLE, 'stream ended before request');
+            return;
+        }
+        const [reqPayload, reqFlags] = reqFrame;
+        const compressed = !!(reqFlags & COMPRESSED);
+        // Pass the request type as the codec hint so JsonCodec can do
+        // strict shape validation. Wrong/extra/missing fields raise
+        // CONTRACT_VIOLATION before the handler runs.
+        const reqType = methodInfo.requestType;
+        let request = compressed
+            ? this.codec.decodeCompressed(reqPayload, true, reqType)
+            : this.codec.decode(reqPayload, reqType);
+        // Interceptors
+        request = await applyRequestInterceptors(this.interceptors, callCtx, request);
+        // Invoke handler with deadline enforcement
+        let response;
+        try {
+            response = await this.runWithDeadline(callCtx, () => handler.call(svcInfo.instance, request));
+        }
+        catch (e) {
+            if (e instanceof RpcError && e.code === StatusCode.DEADLINE_EXCEEDED) {
+                await this.writeErrorTrailer(send, StatusCode.DEADLINE_EXCEEDED, 'deadline exceeded');
+                return;
+            }
+            throw e;
+        }
+        response = await applyResponseInterceptors(this.interceptors, callCtx, response);
+        // Write response + trailer
+        const [respPayload, respCompressed] = this.codec.encodeCompressed(response);
+        await writeFrame(send, respPayload, respCompressed ? COMPRESSED : 0);
+        await this.writeOkTrailer(send);
+        await send.finish();
+    }
+    async handleServerStream(svcInfo, methodInfo, handler, callCtx, send, recv) {
+        const reqFrame = await readFrame(recv, 0);
+        if (!reqFrame) {
+            await this.writeErrorTrailer(send, StatusCode.UNAVAILABLE, 'stream ended');
+            return;
+        }
+        const [reqPayload, reqFlags] = reqFrame;
+        const compressed = !!(reqFlags & COMPRESSED);
+        const reqType = methodInfo.requestType;
+        let request = compressed
+            ? this.codec.decodeCompressed(reqPayload, true, reqType)
+            : this.codec.decode(reqPayload, reqType);
+        request = await applyRequestInterceptors(this.interceptors, callCtx, request);
+        const gen = handler.call(svcInfo.instance, request);
+        const deadlineMs = Date.now() + this.handlerTimeoutMs(callCtx);
+        for await (let response of gen) {
+            if (Date.now() > deadlineMs) {
+                await this.writeErrorTrailer(send, StatusCode.DEADLINE_EXCEEDED, 'deadline exceeded');
+                return;
+            }
+            response = await applyResponseInterceptors(this.interceptors, callCtx, response);
+            const [respPayload, respCompressed] = this.codec.encodeCompressed(response);
+            await writeFrame(send, respPayload, respCompressed ? COMPRESSED : 0);
+        }
+        await this.writeOkTrailer(send);
+        await send.finish();
+    }
+    async handleClientStream(svcInfo, methodInfo, handler, callCtx, send, recv) {
+        // Collect requests until stream ends
+        const requests = [];
+        const reqType = methodInfo.requestType;
+        while (true) {
+            const frame = await readFrame(recv, 0);
+            if (!frame)
+                break;
+            const [payload, flags] = frame;
+            if (flags & TRAILER) {
+                try {
+                    const eoi = this.codec.decode(payload);
+                    if (eoi.code !== StatusCode.OK) {
+                        await this.writeErrorTrailer(send, StatusCode.INTERNAL, `client sent non-OK EoI trailer (code=${eoi.code})`);
+                        return;
+                    }
+                }
+                catch { /* best-effort validation */ }
+                break;
+            }
+            if (flags & CANCEL)
+                continue;
+            if (requests.length >= MAX_CLIENT_STREAM_ITEMS) {
+                await this.writeErrorTrailer(send, StatusCode.RESOURCE_EXHAUSTED, `client stream exceeded ${MAX_CLIENT_STREAM_ITEMS} items`);
+                return;
+            }
+            const compressed = !!(flags & COMPRESSED);
+            let request = compressed
+                ? this.codec.decodeCompressed(payload, true, reqType)
+                : this.codec.decode(payload, reqType);
+            request = await applyRequestInterceptors(this.interceptors, callCtx, request);
+            requests.push(request);
+        }
+        // Provide as async iterable
+        async function* requestIter() { for (const r of requests)
+            yield r; }
+        let response;
+        try {
+            response = await this.runWithDeadline(callCtx, () => handler.call(svcInfo.instance, requestIter()));
+        }
+        catch (e) {
+            if (e instanceof RpcError && e.code === StatusCode.DEADLINE_EXCEEDED) {
+                await this.writeErrorTrailer(send, StatusCode.DEADLINE_EXCEEDED, 'deadline exceeded');
+                return;
+            }
+            throw e;
+        }
+        response = await applyResponseInterceptors(this.interceptors, callCtx, response);
+        const [respPayload, respCompressed] = this.codec.encodeCompressed(response);
+        await writeFrame(send, respPayload, respCompressed ? COMPRESSED : 0);
+        await this.writeOkTrailer(send);
+        await send.finish();
+    }
+    async handleBidiStream(svcInfo, methodInfo, handler, callCtx, send, recv) {
+        // Auth interceptors already ran in dispatchRpc() before this method.
+        // No need to run them again here.
+        // Create request iterable from incoming frames with error capture.
+        // Wrap the error in an object so TS doesn't narrow it to `never`
+        // after the for-await loop (TS can't track closure mutations to a
+        // local variable, but it can track property access through one).
+        const self = this;
+        const errBox = { value: null };
+        const reqType = methodInfo.requestType;
+        async function* requestIter() {
+            try {
+                while (true) {
+                    const frame = await readFrame(recv, 0);
+                    if (!frame)
+                        break;
+                    const [payload, flags] = frame;
+                    if (flags & TRAILER)
+                        break;
+                    if (flags & CANCEL)
+                        continue;
+                    const compressed = !!(flags & COMPRESSED);
+                    const request = compressed
+                        ? self.codec.decodeCompressed(payload, true, reqType)
+                        : self.codec.decode(payload, reqType);
+                    yield request;
+                }
+            }
+            catch (e) {
+                errBox.value = e instanceof Error ? e : new Error(String(e));
+            }
+        }
+        const gen = handler.call(svcInfo.instance, requestIter());
+        const deadlineMs = Date.now() + this.handlerTimeoutMs(callCtx);
+        for await (const response of gen) {
+            if (Date.now() > deadlineMs) {
+                await this.writeErrorTrailer(send, StatusCode.DEADLINE_EXCEEDED, 'deadline exceeded');
+                return;
+            }
+            const [respPayload, respCompressed] = this.codec.encodeCompressed(response);
+            await writeFrame(send, respPayload, respCompressed ? COMPRESSED : 0);
+        }
+        if (errBox.value !== null) {
+            await this.writeErrorTrailer(send, StatusCode.INTERNAL, `bidi stream reader error: ${errBox.value.message}`);
+            return;
+        }
+        await this.writeOkTrailer(send);
+        await send.finish();
+    }
+    // -- Helpers ----------------------------------------------------------------
+    handlerTimeoutMs(callCtx) {
+        const maxMs = MAX_HANDLER_TIMEOUT_S * 1000;
+        const deadline = callCtx.deadline;
+        if (deadline == null || deadline <= 0)
+            return maxMs;
+        const remaining = deadline * 1000 - Date.now();
+        return Math.max(0, Math.min(remaining, maxMs));
+    }
+    /** Run a handler with deadline enforcement, clearing the timer when done. */
+    async runWithDeadline(callCtx, fn) {
+        const timeout = this.handlerTimeoutMs(callCtx);
+        let timer;
+        try {
+            return await Promise.race([
+                fn(),
+                new Promise((_, reject) => {
+                    timer = setTimeout(() => reject(new RpcError(StatusCode.DEADLINE_EXCEEDED, 'deadline exceeded')), timeout);
+                }),
+            ]);
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+        }
+    }
+    buildMetadata(header) {
+        const metadata = {};
+        for (let i = 0; i < header.metadataKeys.length; i++) {
+            metadata[header.metadataKeys[i]] = header.metadataValues[i] ?? '';
+        }
+        return metadata;
+    }
+    async writeOkTrailer(send) {
+        const status = new RpcStatus({ code: StatusCode.OK });
+        await writeFrame(send, this.codec.encode(status), TRAILER);
+    }
+    async writeErrorTrailer(send, code, message) {
+        const status = new RpcStatus({ code, message });
+        try {
+            await writeFrame(send, this.codec.encode(status), TRAILER);
+            await send.finish();
+        }
+        catch {
+            // Best effort — stream may already be closed
+        }
+    }
+    /** Stop accepting new connections. */
+    close() {
+        this._serving = false;
+        for (const conn of this._connections) {
+            try {
+                conn.close(0, 'server shutdown');
+            }
+            catch { /* ignore */ }
+        }
+        this._connections.clear();
+    }
+    /** The service registry used by this server. */
+    get serviceRegistry() {
+        return this.registry;
+    }
+    /**
+     * Wait until the server is stopped (i.e., close() is called).
+     * Returns a promise that resolves when serving ends.
+     */
+    async waitUntilStopped() {
+        return new Promise(resolve => {
+            const check = () => {
+                if (!this._serving) {
+                    resolve();
+                    return;
+                }
+                setTimeout(check, 50);
+            };
+            check();
+        });
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/service.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Service metadata types and registry.
+ *
+ * These types describe the structure of an Aster RPC service at runtime.
+ * They are populated by the decorators in decorators.ts.
+ */
+import type { RpcPattern, SerializationMode } from './types.js';
+import type { Metadata } from './metadata.js';
+/** Capability requirement for method-level access control. */
+export interface CapabilityRequirement {
+    kind: 'role' | 'any_of' | 'all_of';
+    roles: string[];
+}
+/** Method metadata describing a single RPC method. */
+export interface MethodInfo {
+    name: string;
+    pattern: RpcPattern;
+    requestType: unknown;
+    responseType: unknown;
+    timeout: number | undefined;
+    idempotent: boolean;
+    serialization: SerializationMode | undefined;
+    requires: CapabilityRequirement | undefined;
+    handler: ((...args: any[]) => any) | undefined;
+    metadata: Metadata | undefined;
+}
+/** Service metadata describing an RPC service. */
+export interface ServiceInfo {
+    name: string;
+    version: number;
+    scoped: 'shared' | 'session';
+    methods: Map<string, MethodInfo>;
+    serializationModes: SerializationMode[];
+    requires: CapabilityRequirement | undefined;
+    metadata: Metadata | undefined;
+    /** The actual service instance (set when registered with a Server). */
+    instance: unknown;
+}
+/** Attribute key used to store ServiceInfo on decorated classes. */
+export declare const SERVICE_INFO_KEY: unique symbol;
+/** Attribute key used to store MethodInfo on decorated methods. */
+export declare const METHOD_INFO_KEY: unique symbol;
+/** Get ServiceInfo from a decorated class or instance. */
+export declare function getServiceInfo(target: unknown): ServiceInfo | undefined;
+/**
+ * Registry for looking up registered services and dispatching RPC calls.
+ */
+export declare class ServiceRegistry {
+    private _services;
+    private _servicesByName;
+    /** Register a service instance. */
+    register(serviceInstance: object): ServiceInfo;
+    /** Look up a service by name and optional version. */
+    lookup(serviceName: string, version?: number): ServiceInfo | undefined;
+    /** Look up a specific method in a service. */
+    lookupMethod(serviceName: string, methodName: string, version?: number): [ServiceInfo, MethodInfo] | undefined;
+    /** All registered services. */
+    services(): IterableIterator<ServiceInfo>;
+    /** Number of registered services. */
+    get size(): number;
+    /** Get all registered services as an array. */
+    getAllServices(): ServiceInfo[];
+}
+/** Look up a method on a service info object. */
+export declare function getMethod(serviceInfo: ServiceInfo, methodName: string): MethodInfo | undefined;
+/** Check if a service has a method. */
+export declare function hasMethod(serviceInfo: ServiceInfo, methodName: string): boolean;
+/** Get the process-wide default registry (creates one if not set). */
+export declare function getDefaultRegistry(): ServiceRegistry;
+/** Set the process-wide default registry. */
+export declare function setDefaultRegistry(registry: ServiceRegistry): void;
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC7C,QAAQ,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC;IAC/C,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;CAChC;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjC,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,QAAQ,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC5C,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,eAAmC,CAAC;AAEjE,mEAAmE;AACnE,eAAO,MAAM,eAAe,eAAkC,CAAC;AAE/D,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CASvE;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,eAAe,CAAkC;IAEzD,mCAAmC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW;IAwB9C,sDAAsD;IACtD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAOtE,8CAA8C;IAC9C,YAAY,CACV,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,CAAC,WAAW,EAAE,UAAU,CAAC,GAAG,SAAS;IAQxC,+BAA+B;IAC/B,QAAQ,IAAI,gBAAgB,CAAC,WAAW,CAAC;IAIzC,qCAAqC;IACrC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,+CAA+C;IAC/C,cAAc,IAAI,WAAW,EAAE;CAGhC;AAED,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE9F;AAED,uCAAuC;AACvC,wBAAgB,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE/E;AAMD,sEAAsE;AACtE,wBAAgB,kBAAkB,IAAI,eAAe,CAGpD;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAElE"}