@ibgib/node-gib 0.0.9 → 0.0.13

package/dist/serve-gib/handlers/handler-base.mjs

@@ -0,0 +1,402 @@
+/**
+ * @module serve-gib/handler
+ *
+ * Base class and utilities for serve-gib handlers.
+ */
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { getIbAndGib } from '@ibgib/ts-gib/dist/helper.mjs';
+import { getGibInfo } from '@ibgib/ts-gib/dist/V1/transforms/transform-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from '../constants.mjs';
+import { bootstrapDomainMetaspace } from '../bootstrap-helper.mjs';
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * Abstract base class for serve-gib handlers.
+ * Provides a "pit of success" plumbing for routing, error handling, and parameter parsing.
+ *
+ * @template TParams Type for the parsed query parameters.
+ * @template TQueryParams Type for the parsed query parameters.
+ */
+export class ServeGibHandlerBase {
+    lc = `[${ServeGibHandlerBase.name}]`;
+    /**
+     * The main entry point processing incoming requests.
+     * Implements standard plumbing for matching, error handling, and param parsing.
+     */
+    async handleRoute(reqCtx) {
+        const lc = `${this.lc}[${this.handleRoute.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: ad1a523a7bbd222db2e6ffab54f59c26)`);
+            }
+            // First check if we can handle it
+            if (!this.canHandleRoute(reqCtx)) {
+                if (logalot) {
+                    console.log(`${lc} cannot handle route. returning undefined. (I: 359bd4a9d44acb2408e3ad9570cfa526)`);
+                }
+                return undefined; /* <<<< returns early */
+            }
+            // prepare handling params, e.g., keystone/domain addr(s), ibgib
+            // addr(s), not sure what else
+            reqCtx.params = await this.parseParams(reqCtx);
+            // prepare queryParams
+            reqCtx.queryParams = await this.parseQueryParams(reqCtx);
+            // hook to initialize contextual things like metaspace
+            await this.initConcreteContext(reqCtx);
+            // Delegate to implementation
+            return await this.handleRouteImpl(reqCtx);
+        }
+        catch (error) {
+            const emsg = `${lc} Error handling route: ${extractErrorMsg(error)}`;
+            console.error(emsg);
+            // Standard fallback error. Individual handlers can override with more specific catches in handleRouteImpl.
+            return this.error(500, 'Internal Server Error', {
+                errorMsg: emsg,
+                method: this.method,
+                regex: this.regex?.source,
+                rawUrl: reqCtx?.rawUrl,
+            });
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * Extracts per-handler/route params from a request context.
+     *
+     * @see {@link RequestContext.params}
+     */
+    parseParams(reqCtx) {
+        const lc = `${this.lc}[${this.parseParams.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: c08d98768f449317b8e4b56925d3b826)`);
+            }
+            return this.parseParamsImpl(reqCtx);
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * Concrete implementation for extracting params from a path.
+     *
+     * @see {@link RequestContext.params}
+     */
+    async parseParamsImpl(reqCtx) {
+        const lc = `${this.lc}[${this.parseParamsImpl.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 849e491b436860d6788b76c898b0a826)`);
+            }
+            if (logalot) {
+                console.log(`${lc} default implementation in base class is a no-op (I: 88d128a11e1c66030839dc582486e826)`);
+            }
+            return undefined;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * Hook to initialize concrete context, e.g., initializing a metaspace for the
+     * specific domain. The base implementation is a no-op.
+     */
+    async initConcreteContext(reqCtx) {
+        const lc = `${this.lc}[${this.initConcreteContext.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting...`);
+            }
+            if (logalot) {
+                console.log(`${lc} default implementation in base class is a no-op`);
+            }
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * Determines if this handler should attempt to handle the given request.
+     *
+     * Default implementation checks {@link method} and {@link regex} matching
+     * against the pathname. Override for more advanced logic for edge cases.
+     */
+    canHandleRoute(reqCtx) {
+        const lc = `${this.lc}[${this.canHandleRoute.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: d790f637074feee63c4bfcb158f47826)`);
+            }
+            const isMethodMatch = this.method === 'ALL' || reqCtx.method === this.method;
+            const isRegexMatch = this.regex.test(reqCtx.pathname);
+            return isMethodMatch && isRegexMatch;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * Parses query parameters from the URL.
+     * Defaults to a basic key-value mapping of the URL search params.
+     */
+    async parseQueryParams(reqCtx) {
+        const lc = `${this.lc}[${this.parseQueryParams.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: b5d985a4a58b8f3edff9f5ab500e5c26)`);
+            }
+            const queryParams = {};
+            reqCtx.url.searchParams.forEach((value, key) => {
+                queryParams[key] = value;
+            });
+            if (Object.keys(queryParams).length > 0) {
+                // query params exist, validate and return if valid, throw if not
+                const validationErrors = await this.validateQueryParams({ queryParams });
+                if (validationErrors.length === 0) {
+                    return queryParams;
+                }
+                else {
+                    throw new Error(`invalid query params. validationErrors: ${validationErrors.join(', ')} (E: 9355f8a9643803f52f2241f1c7f39826)`);
+                }
+            }
+            else {
+                // no query params given
+                return undefined;
+            }
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * base class implementation is a no-op. override this in descendant class
+     * who expect the possibility of query params
+     * @returns array of validation errors, empty if valid
+     */
+    async validateQueryParams({ queryParams }) {
+        const lc = `${this.lc}[${this.validateQueryParams.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 33b448e223c8682bd8b8b055cab86f26)`);
+            }
+            if (logalot) {
+                console.log(`${lc} base class implementation is a no-op. returning empty array (i.e., valid) (I: 393e8db53d5a9e6ca8eb69ae25810826)`);
+            }
+            return [];
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * Standard JSON success response.
+     */
+    ok(body, status = 200) {
+        return { status, body, isJson: true };
+    }
+    /**
+     * Standard JSON error response.
+     */
+    error(status, message, details) {
+        return { status, body: { error: message, details }, isJson: true };
+    }
+    /**
+     * 404 Not Found response.
+     */
+    notFound(message = 'Not found') {
+        return this.error(404, message);
+    }
+}
+/**
+ * Base class for handlers that have to first initialize a metaspace in order to
+ * process the incoming request.
+ *
+ * ## notes
+ *
+ * Some handlers, like those who do error handling or serving static files, do
+ * not need to initialize a metaspace or do any get/put of any ibgibs. So those
+ * don't need to descend from this class.
+ *
+ * But if the handler is one that has to put/get an ibgib, then a metaspace will
+ * need to be init. Those handlers should descend from this class.
+ */
+export class ServeGibHandlerWithMetaspaceBase extends ServeGibHandlerBase {
+    lc = `[${ServeGibHandlerWithMetaspaceBase.name}]`;
+    async initConcreteContext(reqCtx) {
+        const lc = `${this.lc}[${this.initConcreteContext.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting...`);
+            }
+            await this.initAndPopulateDomainContext(reqCtx);
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    parseParamsImpl(reqCtx) {
+        const lc = `${this.lc}[${this.parseParamsImpl.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: f3ae6e662fe8d28db8c230e80a700826)`);
+            }
+            throw new Error(`(UNEXPECTED) not implemented. this function must be implemented in handlers that initialize metaspace. in that concrete handler class, you must parse out the raw path and build up the params object. That params object must at least include domain info, because that drives the multitenancy. (E: bd6a584b8f988f9ed81c77eedd36b826)`);
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    validateQueryParams({ queryParams }) {
+        const lc = `${this.lc}[${this.validateQueryParams.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 14bb4659f9587d18786105c8e4966826)`);
+            }
+            throw new Error(`(UNEXPECTED) not implemented. this function must be implemented in handlers that initialize metaspace. in that concrete handler class, you must provide a function that validates query params expectations, even if you expect no query params. (E: 804c98a724ddf59998199ec87a9ee126)`);
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * helper that should extract the "domain" (driven by the correctly scoped
+     * keystone) and set related props on the context.
+     */
+    async initAndPopulateDomainContext(reqCtx) {
+        const lc = `${this.lc}[${this.initAndPopulateDomainContext.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting...`);
+            }
+            if (!reqCtx.params) {
+                throw new Error(`invalid RequestContext. params is falsy but we expected params.domainInfo at the minimum. (E: 433c15116e2e821768847d23f7853a26)`);
+            }
+            if (!reqCtx.params.domainInfo) {
+                throw new Error(`invalid RequestContext. reqCtx.params is truthy but params.domainInfo is falsy. at this point, we should have parsed domain info from reqCtx.params (E: ae40882910aa6f45a810e268fd126f26)`);
+            }
+            const { domainInfo } = reqCtx.params;
+            const { addr: domainAddr, } = domainInfo;
+            if (!domainAddr) {
+                throw new Error(`(UNEXPECTED) domainAddr falsy? reqCtx.params does not contain domainIb and domainGib for a handler extending ServeGibHandlerWithMetaspaceBase. If extending this metaspace base, we are expected to have a domain addr with ib and gib. (E: 06bae6908ba8f200e8c50b28ed8df626)`);
+            }
+            // since we have access to reqCtx.dataDir, not sure if we need rootPath in DomainInfo?
+            reqCtx.metaspace = await bootstrapDomainMetaspace(domainAddr, reqCtx.dataDir);
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * Helper to build the domain info from a {@link domainAddr}.
+     *
+     * ## usage
+     *
+     * Use this helper function once your concrete handler has parsed the
+     * domainAddr from the request url.
+     *
+     * For example, say the incoming path is /api/ibgib/:domainAddr/:ibgibAddr (GET)
+     * Then the concrete handler for this path would pull out domainAddr, call
+     * this function to build the domain info, and then put that domain info on
+     * the `reqCtx`.
+     */
+    getDomainInfo({ domainAddr,
+    // dataDir,
+     }) {
+        const lc = `${this.lc}[${this.getDomainInfo.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 2d8bc8f40fd8ae3c98b84f6aaf6e0f26)`);
+            }
+            if (!domainAddr) {
+                throw new Error(`(UNEXPECTED) domainAddr falsy? (E: 7009f98fead9712cb5d4c8985162c826)`);
+            }
+            const domainGibInfo = getGibInfo({ ibGibAddr: domainAddr });
+            const { tjpGib, punctiliarHash } = domainGibInfo;
+            const { ib: domainIb, gib: domainGib } = getIbAndGib({ ibGibAddr: domainAddr });
+            const finalDomainGib = tjpGib || punctiliarHash;
+            if (!finalDomainGib) {
+                throw new Error(`(UNEXPECTED) finalDomainGib falsy? we have a domainAddr (${domainAddr}) so we should have a domain gib. (E: de1e18078678f3b4887ebfae3c893626)`);
+            }
+            const domainInfo = {
+                addr: domainAddr,
+                gib: domainGib,
+                ib: domainIb,
+                gibInfo: domainGibInfo,
+                // rootPath: getDomainRootPath(finalDomainGib, dataDir),
+            };
+            return domainInfo;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=handler-base.mjs.map

package/dist/serve-gib/handlers/handler-base.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-base.mjs","sourceRoot":"","sources":["../../../src/serve-gib/handlers/handler-base.mts"],"names":[],"mappings":"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"}

package/dist/serve-gib/handlers/static-handler.d.mts

@@ -0,0 +1,17 @@
+/**
+ * @module serve-gib/handlers/static-handler
+ *
+ * Handler for serving static client assets and SPA fallback.
+ */
+import { ServeGibHandlerBase } from './handler-base.mjs';
+import { RequestContext, ResponseResult, ServeGibHttpMethod } from '../types.mjs';
+export declare class StaticFileHandler extends ServeGibHandlerBase {
+    private clientDir;
+    protected lc: string;
+    protected method: ServeGibHttpMethod;
+    protected regex: RegExp;
+    private MIME_TYPES;
+    constructor(clientDir: string);
+    protected handleRouteImpl(reqCtx: RequestContext): Promise<ResponseResult | undefined>;
+}
+//# sourceMappingURL=static-handler.d.mts.map

package/dist/serve-gib/handlers/static-handler.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-handler.d.mts","sourceRoot":"","sources":["../../../src/serve-gib/handlers/static-handler.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAMlF,qBAAa,iBAAkB,SAAQ,mBAAmB;IAsB1C,OAAO,CAAC,SAAS;IArB7B,UAAmB,EAAE,EAAE,MAAM,CAAiC;IAC9D,UAAmB,MAAM,EAAE,kBAAkB,CAAS;IACtD,UAAmB,KAAK,SAAQ;IAEhC,OAAO,CAAC,UAAU,CAehB;IAEF,YAAoB,SAAS,EAAE,MAAM,EAAc;IAEnD,UAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAwC3F;CACJ"}

package/dist/serve-gib/handlers/static-handler.mjs

@@ -0,0 +1,85 @@
+/**
+ * @module serve-gib/handlers/static-handler
+ *
+ * Handler for serving static client assets and SPA fallback.
+ */
+import { readFile } from 'node:fs/promises';
+import { existsSync, statSync } from 'node:fs';
+import { join, extname } from 'node:path';
+import { ServeGibHandlerBase } from './handler-base.mjs';
+import { isValidStaticPath } from '../path-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from '../constants.mjs';
+const logalot = GLOBAL_LOG_A_LOT;
+export class StaticFileHandler extends ServeGibHandlerBase {
+    clientDir;
+    lc = `[${StaticFileHandler.name}]`;
+    method = 'GET';
+    regex = /.*/;
+    MIME_TYPES = {
+        '.html': 'text/html; charset=utf-8',
+        '.css': 'text/css; charset=utf-8',
+        '.js': 'text/javascript; charset=utf-8',
+        '.mjs': 'text/javascript; charset=utf-8',
+        '.json': 'application/json; charset=utf-8',
+        '.png': 'image/png',
+        '.jpg': 'image/jpeg',
+        '.jpeg': 'image/jpeg',
+        '.svg': 'image/svg+xml',
+        '.ico': 'image/x-icon',
+        '.woff': 'font/woff',
+        '.woff2': 'font/woff2',
+        '.ttf': 'font/ttf',
+        '.webp': 'image/webp',
+    };
+    constructor(clientDir) {
+        super();
+        this.clientDir = clientDir;
+    }
+    async handleRouteImpl(reqCtx) {
+        const lc = `${this.lc}[${this.handleRouteImpl.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting...`);
+            }
+            // Hardened path validation
+            const { pathname } = reqCtx;
+            if (pathname.startsWith('/api/')) {
+                return undefined;
+            }
+            if (!isValidStaticPath(pathname)) {
+                return undefined;
+            }
+            let filePath = join(this.clientDir, pathname);
+            // Directory → index.html
+            if (existsSync(filePath) && statSync(filePath).isDirectory()) {
+                filePath = join(filePath, 'index.html');
+            }
+            // File not found → SPA fallback
+            if (!existsSync(filePath)) {
+                filePath = join(this.clientDir, 'index.html');
+            }
+            // Final check just in case the fallback doesn't exist
+            if (!existsSync(filePath)) {
+                return undefined;
+            }
+            const content = await readFile(filePath);
+            const ext = extname(filePath).toLowerCase();
+            const contentType = this.MIME_TYPES[ext] ?? 'application/octet-stream';
+            return {
+                status: 200,
+                headers: { 'Content-Type': contentType },
+                body: content
+            };
+        }
+        catch (error) {
+            console.error(`${lc} ${error.message}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=static-handler.mjs.map

package/dist/serve-gib/handlers/static-handler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-handler.mjs","sourceRoot":"","sources":["../../../src/serve-gib/handlers/static-handler.mts"],"names":[],"mappings":"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"}

package/dist/serve-gib/handlers/ws/sync-upgrade-handler-base.d.mts

@@ -0,0 +1,35 @@
+/**
+ * @module handlers/ws/sync-upgrade-handler-base
+ *
+ * Highly generic, reusable base class in serve-gib for handling WebSocket upgrades,
+ * mapping socket streams to isomorphic SyncPeers, and checking upfront connect handshakes.
+ */
+import { Socket } from 'node:net';
+import { ServeGibHandlerWithMetaspaceBase } from '../handler-base.mjs';
+import { ParamsWithDomain, RequestContext, ResponseResult, ServeGibHttpMethod } from '../../types.mjs';
+export interface SyncChannelQueryParams {
+    sAddr: string;
+    solution: string;
+}
+export interface SyncChannelRequestContext extends RequestContext<ParamsWithDomain, SyncChannelQueryParams> {
+}
+/**
+ * Reusable server-side upgrade handler plumbing.
+ * Binds raw node socket streams to platform-agnostic receiver peers.
+ */
+export declare abstract class SyncUpgradeHandlerBase extends ServeGibHandlerWithMetaspaceBase<ParamsWithDomain, SyncChannelQueryParams> {
+    protected lc: string;
+    protected method: ServeGibHttpMethod;
+    /**
+     * Entry point for WebSocket upgrades.
+     * Orchestrates the upgrade, upfront validation, and registers the Receiver peer.
+     */
+    handleUpgrade(reqCtx: RequestContext<ParamsWithDomain>, socket: Socket, head: Buffer): Promise<boolean>;
+    protected parseParamsImpl(reqCtx: RequestContext<ParamsWithDomain>): Promise<ParamsWithDomain | undefined>;
+    protected parseQueryParams(reqCtx: RequestContext<ParamsWithDomain, SyncChannelQueryParams>): Promise<SyncChannelQueryParams | undefined>;
+    protected validateQueryParams({ queryParams }: {
+        queryParams: any;
+    }): Promise<string[]>;
+    protected handleRouteImpl(reqCtx: RequestContext<ParamsWithDomain>): Promise<ResponseResult | undefined>;
+}
+//# sourceMappingURL=sync-upgrade-handler-base.d.mts.map

package/dist/serve-gib/handlers/ws/sync-upgrade-handler-base.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-upgrade-handler-base.d.mts","sourceRoot":"","sources":["../../../../src/serve-gib/handlers/ws/sync-upgrade-handler-base.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAclC,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAIvG,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAA0B,SAAQ,cAAc,CAAC,gBAAgB,EAAE,sBAAsB,CAAC;CAC1G;AAED;;;GAGG;AACH,8BAAsB,sBAAuB,SAAQ,gCAAgC,CAAC,gBAAgB,EAAE,sBAAsB,CAAC;IAC3H,UAAmB,EAAE,EAAE,MAAM,CAAsC;IACnE,UAAmB,MAAM,EAAE,kBAAkB,CAAS;IAEtD;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqH5G;IAED,UAAyB,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAUxH;IAED,UAAyB,gBAAgB,CACrC,MAAM,EAAE,cAAc,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,GACjE,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAkB7C;IAED,UAAyB,mBAAmB,CAAC,EAAE,WAAW,EAAE,EAAE;QAAE,WAAW,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA2BrG;IAED,UAAyB,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAEtH;CACJ"}