ai.matey.http 0.2.0

package/dist/esm/fastify/handler.js

@@ -0,0 +1,51 @@
+/**
+ * Fastify Handler
+ *
+ * HTTP request handler for Fastify that uses the core handler.
+ *
+ * @module
+ */
+import { CoreHTTPHandler } from 'ai.matey.http.core';
+import { FastifyRequestAdapter, FastifyResponseAdapter } from './adapter.js';
+/**
+ * Create Fastify route handler for handling AI chat requests
+ *
+ * @param bridge - Bridge instance
+ * @param options - HTTP listener options
+ * @returns Fastify route handler function
+ *
+ * @example
+ * ```typescript
+ * import Fastify from 'fastify';
+ * import { FastifyHandler } from 'ai.matey.http/fastify';
+ *
+ * const fastify = Fastify();
+ * const bridge = new Bridge(frontend, backend);
+ *
+ * // Add AI chat route
+ * fastify.post('/v1/messages', FastifyHandler(bridge, {
+ *   cors: true,
+ *   streaming: true,
+ * }));
+ *
+ * fastify.listen({ port: 3000 });
+ * ```
+ */
+export function FastifyHandler(bridge, options = {}) {
+    // Create core handler with all business logic
+    const { cors, ...restOptions } = options;
+    const coreHandler = new CoreHTTPHandler({
+        bridge,
+        cors: cors === false || cors === undefined ? undefined : cors === true ? {} : cors,
+        ...restOptions, // HTTPListenerOptions types are compatible with CoreHandlerOptions at runtime
+    });
+    // Return Fastify route handler
+    return async (request, reply) => {
+        // Create adapters
+        const genericReq = new FastifyRequestAdapter(request);
+        const genericRes = new FastifyResponseAdapter(reply);
+        // Handle request through core handler
+        await coreHandler.handle(genericReq, genericRes);
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/esm/fastify/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/fastify/handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,UAA+B,EAAE;IAEjC,8CAA8C;IAC9C,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;IAEzC,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;QACtC,MAAM;QACN,IAAI,EAAE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;QAClF,GAAI,WAAmB,EAAE,8EAA8E;KACxG,CAAC,CAAC;IAEH,+BAA+B;IAC/B,OAAO,KAAK,EAAE,OAAuB,EAAE,KAAmB,EAAiB,EAAE;QAC3E,kBAAkB;QAClB,MAAM,UAAU,GAAG,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAErD,sCAAsC;QACtC,MAAM,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/fastify/index.js

@@ -0,0 +1,10 @@
+/**
+ * Fastify HTTP Adapter
+ *
+ * HTTP adapter for Fastify
+ *
+ * @module
+ */
+export * from './adapter.js';
+export * from './handler.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/fastify/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fastify/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/esm/hono/adapter.js

@@ -0,0 +1,167 @@
+/**
+ * Hono HTTP Adapter
+ *
+ * Converts Hono Context to GenericRequest/GenericResponse
+ *
+ * @module
+ */
+/**
+ * Adapter that converts Hono Context to GenericRequest
+ */
+export class HonoRequestAdapter {
+    c;
+    constructor(c) {
+        this.c = c;
+    }
+    get method() {
+        return this.c.req.method || 'GET';
+    }
+    get url() {
+        return this.c.req.url || '/';
+    }
+    get headers() {
+        const headers = {};
+        // Hono headers is a Headers object
+        this.c.req.raw.headers.forEach((value, key) => {
+            headers[key.toLowerCase()] = value;
+        });
+        return headers;
+    }
+    get body() {
+        // Hono doesn't automatically parse body - it must be done with middleware
+        // Access the parsed body from context if available
+        return this.c.body ?? null;
+    }
+    get params() {
+        // Hono params are available via c.req.param()
+        const params = this.c.req.param();
+        return Object.keys(params).length > 0 ? params : undefined;
+    }
+    get query() {
+        // Hono query is available via c.req.query()
+        const query = {};
+        const queryParams = this.c.req.query();
+        for (const [key, value] of Object.entries(queryParams)) {
+            if (value !== undefined) {
+                query[key] = String(value);
+            }
+        }
+        return Object.keys(query).length > 0 ? query : undefined;
+    }
+    get ip() {
+        // Try to get IP from various headers
+        const forwarded = this.c.req.header('x-forwarded-for');
+        if (forwarded) {
+            return forwarded.split(',')[0]?.trim();
+        }
+        const realIp = this.c.req.header('x-real-ip');
+        if (realIp) {
+            return realIp;
+        }
+        // Fallback to undefined as we can't access socket in all Hono runtimes
+        return undefined;
+    }
+    /**
+     * Get the underlying Hono context object
+     */
+    get raw() {
+        return this.c;
+    }
+}
+/**
+ * Adapter that converts GenericResponse methods to Hono Context
+ */
+export class HonoResponseAdapter {
+    c;
+    _statusCode = 200;
+    _headers = new Map();
+    _sent = false;
+    constructor(c) {
+        this.c = c;
+    }
+    status(code) {
+        if (!this._sent) {
+            this._statusCode = code;
+        }
+    }
+    header(name, value) {
+        if (!this._sent) {
+            this._headers.set(name, value);
+        }
+    }
+    send(data) {
+        if (this._sent) {
+            return;
+        }
+        this._sent = true;
+        // Collect headers for response
+        const headers = new Headers();
+        for (const [name, value] of this._headers.entries()) {
+            headers.set(name, value);
+        }
+        // Handle empty string (e.g., for CORS preflight 204 responses)
+        if (data === '') {
+            // 204 No Content responses cannot have a body (not even empty string)
+            // Use null for 204, empty string for other status codes
+            this.c.res = new Response(this._statusCode === 204 ? null : '', {
+                status: this._statusCode,
+                headers,
+            });
+            return;
+        }
+        // Send JSON response
+        headers.set('Content-Type', 'application/json');
+        this.c.res = new Response(JSON.stringify(data), {
+            status: this._statusCode,
+            headers,
+        });
+    }
+    stream(generator) {
+        if (this._sent) {
+            return Promise.resolve();
+        }
+        this._sent = true;
+        // Set all headers
+        for (const [name, value] of this._headers.entries()) {
+            this.c.header(name, value);
+        }
+        // Create SSE stream
+        const stream = new ReadableStream({
+            async start(controller) {
+                try {
+                    for await (const chunk of generator) {
+                        const data = `data: ${JSON.stringify(chunk)}\n\n`;
+                        controller.enqueue(new TextEncoder().encode(data));
+                    }
+                    // Send done marker
+                    const done = 'data: [DONE]\n\n';
+                    controller.enqueue(new TextEncoder().encode(done));
+                    controller.close();
+                }
+                catch (error) {
+                    console.error('Streaming error:', error);
+                    controller.error(error);
+                }
+            },
+        });
+        // Set SSE headers and return stream
+        this.c.header('Content-Type', 'text/event-stream');
+        this.c.header('Cache-Control', 'no-cache');
+        this.c.header('Connection', 'keep-alive');
+        this.c.res = new Response(stream, {
+            status: this._statusCode,
+            headers: this.c.res?.headers,
+        });
+        return Promise.resolve();
+    }
+    isWritable() {
+        return !this._sent;
+    }
+    /**
+     * Get the underlying Hono context object
+     */
+    get raw() {
+        return this.c;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/esm/hono/adapter.js.map

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

package/dist/esm/hono/index.js

@@ -0,0 +1,10 @@
+/**
+ * Hono HTTP Adapter
+ *
+ * HTTP adapter for Hono
+ *
+ * @module
+ */
+export * from './adapter.js';
+export * from './middleware.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/hono/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hono/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/esm/hono/middleware.js

@@ -0,0 +1,72 @@
+/**
+ * Hono Middleware
+ *
+ * HTTP request middleware for Hono that uses the core handler.
+ *
+ * @module
+ */
+import { CoreHTTPHandler } from 'ai.matey.http.core';
+import { HonoRequestAdapter, HonoResponseAdapter } from './adapter.js';
+/**
+ * Create Hono middleware for handling AI chat requests
+ *
+ * @param bridge - Bridge instance
+ * @param options - HTTP listener options
+ * @returns Hono middleware function
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { HonoMiddleware } from 'ai.matey.http/hono';
+ *
+ * const app = new Hono();
+ * const bridge = new Bridge(frontend, backend);
+ *
+ * // Add AI chat middleware
+ * app.post('/v1/messages', HonoMiddleware(bridge, {
+ *   cors: true,
+ *   streaming: true,
+ * }));
+ *
+ * export default app;
+ * ```
+ */
+export function HonoMiddleware(bridge, options = {}) {
+    // Create core handler with all business logic
+    const { cors, ...restOptions } = options;
+    const coreHandler = new CoreHTTPHandler({
+        bridge,
+        cors: cors === false || cors === undefined ? undefined : cors === true ? {} : cors,
+        ...restOptions, // HTTPListenerOptions types are compatible with CoreHandlerOptions at runtime
+    });
+    // Return Hono middleware
+    return async (c) => {
+        try {
+            // Parse JSON body if present (but not for OPTIONS requests)
+            const contentType = c.req.header('content-type') || '';
+            const method = c.req.method;
+            if (method !== 'OPTIONS' && contentType.includes('application/json')) {
+                try {
+                    c.body = await c.req.json();
+                }
+                catch {
+                    // If JSON parsing fails, leave body as null
+                    c.body = null;
+                }
+            }
+            // Create adapters
+            const genericReq = new HonoRequestAdapter(c);
+            const genericRes = new HonoResponseAdapter(c);
+            // Handle request through core handler
+            await coreHandler.handle(genericReq, genericRes);
+            // Return the response set by the adapter
+            return c.res || new Response('Internal Server Error', { status: 500 });
+        }
+        catch (error) {
+            // Return error response
+            console.error('Hono middleware error:', error);
+            return c.json({ error: 'Internal Server Error' }, 500);
+        }
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/esm/hono/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../src/hono/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,UAA+B,EAAE;IAEjC,8CAA8C;IAC9C,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;IAEzC,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;QACtC,MAAM;QACN,IAAI,EAAE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;QAClF,GAAI,WAAmB,EAAE,8EAA8E;KACxG,CAAC,CAAC;IAEH,yBAAyB;IACzB,OAAO,KAAK,EAAE,CAAU,EAAqB,EAAE;QAC7C,IAAI,CAAC;YACH,4DAA4D;YAC5D,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;YACvD,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;YAE5B,IAAI,MAAM,KAAK,SAAS,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACrE,IAAI,CAAC;oBACF,CAAS,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACvC,CAAC;gBAAC,MAAM,CAAC;oBACP,4CAA4C;oBAC3C,CAAS,CAAC,IAAI,GAAG,IAAI,CAAC;gBACzB,CAAC;YACH,CAAC;YAED,kBAAkB;YAClB,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC;YAC7C,MAAM,UAAU,GAAG,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAAC;YAE9C,sCAAsC;YACtC,MAAM,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAEjD,yCAAyC;YACzC,OAAO,CAAC,CAAC,GAAG,IAAI,IAAI,QAAQ,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wBAAwB;YACxB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;YAC/C,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,21 @@
+/**
+ * AI Matey HTTP Adapters
+ *
+ * Consolidated package containing HTTP framework adapters.
+ * Each adapter provides integration with a specific HTTP framework.
+ *
+ * @module ai.matey.http
+ */
+// Express adapter
+export * from './express/index.js';
+// Fastify adapter
+export * from './fastify/index.js';
+// Hono adapter
+export * from './hono/index.js';
+// Koa adapter
+export * from './koa/index.js';
+// Node.js native HTTP adapter
+export * from './node/index.js';
+// Deno adapter
+export * from './deno/index.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,kBAAkB;AAClB,cAAc,oBAAoB,CAAC;AAEnC,kBAAkB;AAClB,cAAc,oBAAoB,CAAC;AAEnC,eAAe;AACf,cAAc,iBAAiB,CAAC;AAEhC,cAAc;AACd,cAAc,gBAAgB,CAAC;AAE/B,8BAA8B;AAC9B,cAAc,iBAAiB,CAAC;AAEhC,eAAe;AACf,cAAc,iBAAiB,CAAC"}

package/dist/esm/koa/adapter.js

@@ -0,0 +1,148 @@
+/**
+ * Koa HTTP Adapter
+ *
+ * Converts Koa Context to GenericRequest/GenericResponse
+ *
+ * @module
+ */
+import { sendSSEHeaders, sendSSEChunk, sendSSEDone } from 'ai.matey.http.core';
+/**
+ * Adapter that converts Koa Context to GenericRequest
+ */
+export class KoaRequestAdapter {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    get method() {
+        return this.ctx.method || 'GET';
+    }
+    get url() {
+        return this.ctx.originalUrl || this.ctx.url || '/';
+    }
+    get headers() {
+        const headers = {};
+        for (const [key, value] of Object.entries(this.ctx.headers)) {
+            if (typeof value === 'string') {
+                headers[key.toLowerCase()] = value;
+            }
+            else if (Array.isArray(value)) {
+                headers[key.toLowerCase()] = value.join(', ');
+            }
+        }
+        return headers;
+    }
+    get body() {
+        // Koa body is already parsed if koa-bodyparser middleware is used
+        return this.ctx.request.body ?? null;
+    }
+    get params() {
+        // Koa router stores params in ctx.params
+        return this.ctx.params;
+    }
+    get query() {
+        // Koa query is available as ctx.query
+        const query = {};
+        for (const [key, value] of Object.entries(this.ctx.query)) {
+            if (typeof value === 'string') {
+                query[key] = value;
+            }
+            else if (Array.isArray(value)) {
+                query[key] = value.join(',');
+            }
+            else if (value !== undefined) {
+                query[key] = String(value);
+            }
+        }
+        return Object.keys(query).length > 0 ? query : undefined;
+    }
+    get ip() {
+        // Koa provides IP through ctx.ip
+        return this.ctx.ip || this.ctx.request.socket?.remoteAddress;
+    }
+    /**
+     * Get the underlying Koa context object
+     */
+    get raw() {
+        return this.ctx;
+    }
+}
+/**
+ * Adapter that converts GenericResponse methods to Koa Context
+ */
+export class KoaResponseAdapter {
+    ctx;
+    _statusCode = 200;
+    _headersSent = false;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    status(code) {
+        this._statusCode = code;
+        if (!this._headersSent) {
+            this.ctx.status = code;
+        }
+    }
+    header(name, value) {
+        if (!this._headersSent) {
+            this.ctx.set(name, value);
+        }
+    }
+    send(data) {
+        if (!this.isWritable()) {
+            return;
+        }
+        this._headersSent = true;
+        // Handle empty string (e.g., for CORS preflight 204 responses)
+        if (data === '') {
+            this.ctx.body = '';
+            return;
+        }
+        // Koa automatically JSON-stringifies objects
+        this.ctx.status = this._statusCode;
+        this.ctx.body = data;
+    }
+    async stream(generator) {
+        if (!this.isWritable()) {
+            return;
+        }
+        this._headersSent = true;
+        // Get the underlying Node.js response for SSE
+        const nodeRes = this.ctx.res;
+        // Set SSE headers
+        sendSSEHeaders(nodeRes, {});
+        // Set Koa to not handle the response
+        this.ctx.respond = false;
+        try {
+            // Stream chunks
+            for await (const chunk of generator) {
+                if (!this.isWritable()) {
+                    break;
+                }
+                sendSSEChunk(nodeRes, chunk);
+            }
+            // Send done marker
+            if (this.isWritable()) {
+                sendSSEDone(nodeRes);
+            }
+        }
+        catch (error) {
+            // If error occurs during streaming, we can't change status code
+            // Just log and close
+            console.error('Streaming error:', error);
+            if (this.isWritable()) {
+                nodeRes.end();
+            }
+        }
+    }
+    isWritable() {
+        return !this.ctx.response.headerSent && this.ctx.writable;
+    }
+    /**
+     * Get the underlying Koa context object
+     */
+    get raw() {
+        return this.ctx;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/esm/koa/adapter.js.map

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

package/dist/esm/koa/index.js

@@ -0,0 +1,10 @@
+/**
+ * Koa HTTP Adapter
+ *
+ * HTTP adapter for Koa
+ *
+ * @module
+ */
+export * from './adapter.js';
+export * from './middleware.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/koa/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/koa/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/esm/koa/middleware.js

@@ -0,0 +1,55 @@
+/**
+ * Koa Middleware
+ *
+ * HTTP request middleware for Koa that uses the core handler.
+ *
+ * @module
+ */
+import { CoreHTTPHandler } from 'ai.matey.http.core';
+import { KoaRequestAdapter, KoaResponseAdapter } from './adapter.js';
+/**
+ * Create Koa middleware for handling AI chat requests
+ *
+ * @param bridge - Bridge instance
+ * @param options - HTTP listener options
+ * @returns Koa middleware function
+ *
+ * @example
+ * ```typescript
+ * import Koa from 'koa';
+ * import bodyParser from 'koa-bodyparser';
+ * import { KoaMiddleware } from 'ai.matey.http/koa';
+ *
+ * const app = new Koa();
+ * const bridge = new Bridge(frontend, backend);
+ *
+ * // Use body parser middleware first
+ * app.use(bodyParser());
+ *
+ * // Add AI chat middleware
+ * app.use(KoaMiddleware(bridge, {
+ *   cors: true,
+ *   streaming: true,
+ * }));
+ *
+ * app.listen(3000);
+ * ```
+ */
+export function KoaMiddleware(bridge, options = {}) {
+    // Create core handler with all business logic
+    const { cors, ...restOptions } = options;
+    const coreHandler = new CoreHTTPHandler({
+        bridge,
+        cors: cors === false || cors === undefined ? undefined : cors === true ? {} : cors,
+        ...restOptions, // HTTPListenerOptions types are compatible with CoreHandlerOptions at runtime
+    });
+    // Return Koa middleware
+    return async (ctx, _next) => {
+        // Create adapters
+        const genericReq = new KoaRequestAdapter(ctx);
+        const genericRes = new KoaResponseAdapter(ctx);
+        // Handle request through core handler
+        await coreHandler.handle(genericReq, genericRes);
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/esm/koa/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../src/koa/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,UAA+B,EAAE;IAEjC,8CAA8C;IAC9C,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;IAEzC,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;QACtC,MAAM;QACN,IAAI,EAAE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;QAClF,GAAI,WAAmB,EAAE,8EAA8E;KACxG,CAAC,CAAC;IAEH,wBAAwB;IACxB,OAAO,KAAK,EAAE,GAAY,EAAE,KAAW,EAAiB,EAAE;QACxD,kBAAkB;QAClB,MAAM,UAAU,GAAG,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAE/C,sCAAsC;QACtC,MAAM,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC,CAAC;AACJ,CAAC"}