@dotdo/postgres 0.1.2 → 0.1.3

package/dist/mcp/index.d.ts

@@ -0,0 +1,92 @@
+/**
+ * MCP Server Module for PostgresDO
+ *
+ * Provides MCP (Model Context Protocol) server implementation for PostgreSQL
+ * databases running in Cloudflare Durable Objects.
+ *
+ * ## Overview
+ *
+ * This module implements the three core MCP primitives:
+ *
+ * 1. **search** - Query the database with SQL, list tables, or get schema
+ * 2. **fetch** - Get a specific row by table/id or table schema
+ * 3. **do** - Execute code with the `pg` binding for full database access
+ *
+ * ## Usage
+ *
+ * @example Basic MCP server setup
+ * ```typescript
+ * import { createMCPServer } from '@dotdo/postgres/mcp'
+ * import { PostgresDO } from '@dotdo/postgres/worker'
+ *
+ * // In your worker
+ * const stub = env.POSTGRES_DO.get(doId) as DurableObjectStub<PostgresDO>
+ * const mcpServer = createMCPServer(stub, { databaseId: 'mydb' })
+ *
+ * // Mount routes
+ * app.route('/mcp', mcpServer.routes())
+ * ```
+ *
+ * @example With auth context from oauth.do JWT
+ * ```typescript
+ * const mcpServer = createMCPServer(stub, {
+ *   databaseId: 'mydb',
+ *   authContext: {
+ *     userId: user.id,
+ *     email: user.email,
+ *     scopes: ['read', 'write'],
+ *   },
+ * })
+ * ```
+ *
+ * @example Using tools directly
+ * ```typescript
+ * // Search for tables
+ * const result = await mcpServer.handleRequest({
+ *   jsonrpc: '2.0',
+ *   id: 1,
+ *   method: 'tools/call',
+ *   params: {
+ *     name: 'search',
+ *     arguments: { query: 'tables' }
+ *   }
+ * })
+ *
+ * // Fetch a row
+ * const row = await mcpServer.handleRequest({
+ *   jsonrpc: '2.0',
+ *   id: 2,
+ *   method: 'tools/call',
+ *   params: {
+ *     name: 'fetch',
+ *     arguments: { resource: 'users/123' }
+ *   }
+ * })
+ *
+ * // Execute code
+ * const code = await mcpServer.handleRequest({
+ *   jsonrpc: '2.0',
+ *   id: 3,
+ *   method: 'tools/call',
+ *   params: {
+ *     name: 'do',
+ *     arguments: {
+ *       code: `
+ *         const users = await pg.query('SELECT * FROM users LIMIT 5')
+ *         return users.rows
+ *       `
+ *     }
+ *   }
+ * })
+ * ```
+ *
+ * @module mcp
+ */
+export type { QueryResult, TableInfo, ColumnInfo, MCPSearchResult, MCPFetchResult, PGBinding, PGTransaction, ToolResponse, SearchInput, FetchInput, DoInput, MCPAuthContext, MCPServerConfig, } from './types.js';
+export { createPGBinding, PG_BINDING_TYPES } from './binding.js';
+export type { QueryExecutor } from './binding.js';
+export { searchTool, fetchTool, doTool, getToolDefinitions, createToolHandlers, createSearchHandler, createFetchHandler, createDoHandler, } from './tools.js';
+export type { Tool } from './tools.js';
+export { createMCPServer, createMCPRoutes } from './server.js';
+export type { MCPServer } from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AAGH,YAAY,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,eAAe,EACf,cAAc,EACd,SAAS,EACT,aAAa,EACb,YAAY,EACZ,WAAW,EACX,UAAU,EACV,OAAO,EACP,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAChE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD,OAAO,EACL,UAAU,EACV,SAAS,EACT,MAAM,EACN,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAGtC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC9D,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}

package/dist/mcp/index.js

@@ -0,0 +1,91 @@
+/**
+ * MCP Server Module for PostgresDO
+ *
+ * Provides MCP (Model Context Protocol) server implementation for PostgreSQL
+ * databases running in Cloudflare Durable Objects.
+ *
+ * ## Overview
+ *
+ * This module implements the three core MCP primitives:
+ *
+ * 1. **search** - Query the database with SQL, list tables, or get schema
+ * 2. **fetch** - Get a specific row by table/id or table schema
+ * 3. **do** - Execute code with the `pg` binding for full database access
+ *
+ * ## Usage
+ *
+ * @example Basic MCP server setup
+ * ```typescript
+ * import { createMCPServer } from '@dotdo/postgres/mcp'
+ * import { PostgresDO } from '@dotdo/postgres/worker'
+ *
+ * // In your worker
+ * const stub = env.POSTGRES_DO.get(doId) as DurableObjectStub<PostgresDO>
+ * const mcpServer = createMCPServer(stub, { databaseId: 'mydb' })
+ *
+ * // Mount routes
+ * app.route('/mcp', mcpServer.routes())
+ * ```
+ *
+ * @example With auth context from oauth.do JWT
+ * ```typescript
+ * const mcpServer = createMCPServer(stub, {
+ *   databaseId: 'mydb',
+ *   authContext: {
+ *     userId: user.id,
+ *     email: user.email,
+ *     scopes: ['read', 'write'],
+ *   },
+ * })
+ * ```
+ *
+ * @example Using tools directly
+ * ```typescript
+ * // Search for tables
+ * const result = await mcpServer.handleRequest({
+ *   jsonrpc: '2.0',
+ *   id: 1,
+ *   method: 'tools/call',
+ *   params: {
+ *     name: 'search',
+ *     arguments: { query: 'tables' }
+ *   }
+ * })
+ *
+ * // Fetch a row
+ * const row = await mcpServer.handleRequest({
+ *   jsonrpc: '2.0',
+ *   id: 2,
+ *   method: 'tools/call',
+ *   params: {
+ *     name: 'fetch',
+ *     arguments: { resource: 'users/123' }
+ *   }
+ * })
+ *
+ * // Execute code
+ * const code = await mcpServer.handleRequest({
+ *   jsonrpc: '2.0',
+ *   id: 3,
+ *   method: 'tools/call',
+ *   params: {
+ *     name: 'do',
+ *     arguments: {
+ *       code: `
+ *         const users = await pg.query('SELECT * FROM users LIMIT 5')
+ *         return users.rows
+ *       `
+ *     }
+ *   }
+ * })
+ * ```
+ *
+ * @module mcp
+ */
+// Binding
+export { createPGBinding, PG_BINDING_TYPES } from './binding.js';
+// Tools
+export { searchTool, fetchTool, doTool, getToolDefinitions, createToolHandlers, createSearchHandler, createFetchHandler, createDoHandler, } from './tools.js';
+// Server
+export { createMCPServer, createMCPRoutes } from './server.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AAmBH,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGhE,QAAQ;AACR,OAAO,EACL,UAAU,EACV,SAAS,EACT,MAAM,EACN,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAA;AAGnB,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,62 @@
+/**
+ * MCP Server for PostgresDO
+ *
+ * Creates an MCP (Model Context Protocol) server that exposes PostgreSQL
+ * functionality through the search/fetch/do pattern.
+ */
+import { Hono } from 'hono';
+import type { Context as HonoContext } from 'hono';
+import type { MCPServerConfig, MCPAuthContext, ToolResponse } from './types.js';
+import type { QueryExecutor } from './binding.js';
+import { getToolDefinitions, createToolHandlers } from './tools.js';
+/**
+ * MCP Protocol Message Types
+ */
+interface MCPMessage {
+    jsonrpc: '2.0';
+    id?: string | number;
+    method?: string;
+    params?: Record<string, unknown>;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * MCP Server implementation
+ */
+export interface MCPServer {
+    /** Handle an MCP request */
+    handleRequest(request: MCPMessage): Promise<MCPMessage>;
+    /** Get the Hono routes for HTTP transport */
+    routes(): Hono;
+}
+/**
+ * Create an MCP server for PostgresDO
+ *
+ * @param executor - Query executor (PostgresDO stub)
+ * @param config - Server configuration
+ * @returns MCP server instance
+ */
+export declare function createMCPServer(executor: QueryExecutor, config?: MCPServerConfig): MCPServer;
+/**
+ * Variables stored in Hono context for MCP routes
+ */
+interface MCPVariables {
+    mcpServer: MCPServer;
+}
+/**
+ * Create MCP routes for integration with PostgresDO worker
+ */
+export declare function createMCPRoutes(getExecutor: (c: HonoContext) => QueryExecutor, getConfig?: (c: HonoContext) => MCPServerConfig): Hono<{
+    Variables: MCPVariables;
+}>;
+/**
+ * Re-export types and tools
+ */
+export { getToolDefinitions, createToolHandlers };
+export type { Tool } from './tools.js';
+export type { MCPServerConfig, MCPAuthContext, ToolResponse };
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,MAAM,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,UAAU,UAAU;IAClB,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,OAAO,CAAA;KACf,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,4BAA4B;IAC5B,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACvD,6CAA6C;IAC7C,MAAM,IAAI,IAAI,CAAA;CACf;AAaD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,aAAa,EACvB,MAAM,GAAE,eAA2C,GAClD,SAAS,CA4PX;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,SAAS,EAAE,SAAS,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,aAAa,EAC9C,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,eAAe,GAC9C,IAAI,CAAC;IAAE,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC,CAuBnC;AAED;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAA;AACjD,YAAY,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,CAAA"}

package/dist/mcp/server.js

@@ -0,0 +1,278 @@
+/**
+ * MCP Server for PostgresDO
+ *
+ * Creates an MCP (Model Context Protocol) server that exposes PostgreSQL
+ * functionality through the search/fetch/do pattern.
+ */
+import { Hono } from 'hono';
+import { getToolDefinitions, createToolHandlers, } from './tools.js';
+/**
+ * MCP Error codes
+ */
+const MCP_ERRORS = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+};
+/**
+ * Create an MCP server for PostgresDO
+ *
+ * @param executor - Query executor (PostgresDO stub)
+ * @param config - Server configuration
+ * @returns MCP server instance
+ */
+export function createMCPServer(executor, config = { databaseId: 'default' }) {
+    const { timeout = 5000, authContext } = config;
+    const handlers = createToolHandlers(executor, { timeout, authContext });
+    const tools = getToolDefinitions();
+    /**
+     * Handle tools/list request
+     */
+    function handleToolsList() {
+        return {
+            jsonrpc: '2.0',
+            result: {
+                tools: tools.map((tool) => ({
+                    name: tool.name,
+                    description: tool.description,
+                    inputSchema: tool.inputSchema,
+                })),
+            },
+        };
+    }
+    /**
+     * Handle tools/call request
+     */
+    async function handleToolsCall(params) {
+        const toolName = params.name;
+        const toolArgs = (params.arguments || {});
+        const handler = handlers[toolName];
+        if (!handler) {
+            return {
+                jsonrpc: '2.0',
+                error: {
+                    code: MCP_ERRORS.METHOD_NOT_FOUND,
+                    message: `Unknown tool: ${toolName}`,
+                },
+            };
+        }
+        try {
+            const result = await handler(toolArgs);
+            return {
+                jsonrpc: '2.0',
+                result,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                jsonrpc: '2.0',
+                error: {
+                    code: MCP_ERRORS.INTERNAL_ERROR,
+                    message,
+                },
+            };
+        }
+    }
+    /**
+     * Handle initialize request
+     */
+    function handleInitialize(_params) {
+        return {
+            jsonrpc: '2.0',
+            result: {
+                protocolVersion: '2024-11-05',
+                capabilities: {
+                    tools: {},
+                },
+                serverInfo: {
+                    name: 'postgres-mcp',
+                    version: '0.1.0',
+                },
+            },
+        };
+    }
+    /**
+     * Handle ping request
+     */
+    function handlePing() {
+        return {
+            jsonrpc: '2.0',
+            result: {},
+        };
+    }
+    /**
+     * Main request handler
+     */
+    async function handleRequest(request) {
+        const { method, params = {}, id } = request;
+        let response;
+        switch (method) {
+            case 'initialize':
+                response = handleInitialize(params);
+                break;
+            case 'ping':
+                response = handlePing();
+                break;
+            case 'tools/list':
+                response = handleToolsList();
+                break;
+            case 'tools/call':
+                response = await handleToolsCall(params);
+                break;
+            default:
+                response = {
+                    jsonrpc: '2.0',
+                    error: {
+                        code: MCP_ERRORS.METHOD_NOT_FOUND,
+                        message: `Unknown method: ${method}`,
+                    },
+                };
+        }
+        // Add request ID to response
+        if (id !== undefined) {
+            response.id = id;
+        }
+        return response;
+    }
+    /**
+     * Create Hono routes for HTTP transport
+     */
+    function routes() {
+        const app = new Hono();
+        // MCP protocol endpoint (JSON-RPC over HTTP)
+        app.post('/mcp', async (c) => {
+            try {
+                const request = await c.req.json();
+                if (request.jsonrpc !== '2.0') {
+                    return c.json({
+                        jsonrpc: '2.0',
+                        error: {
+                            code: MCP_ERRORS.INVALID_REQUEST,
+                            message: 'Invalid JSON-RPC version',
+                        },
+                    }, 400);
+                }
+                const response = await handleRequest(request);
+                return c.json(response);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Parse error';
+                return c.json({
+                    jsonrpc: '2.0',
+                    error: {
+                        code: MCP_ERRORS.PARSE_ERROR,
+                        message,
+                    },
+                }, 400);
+            }
+        });
+        // Well-known MCP discovery endpoint
+        app.get('/.well-known/mcp', (c) => {
+            return c.json({
+                name: 'postgres-mcp',
+                version: '0.1.0',
+                protocol_version: '2024-11-05',
+                capabilities: {
+                    tools: true,
+                },
+                endpoints: {
+                    mcp: '/mcp',
+                    sse: '/mcp/sse',
+                },
+            });
+        });
+        // SSE endpoint for streaming transport
+        app.get('/mcp/sse', async (c) => {
+            // SSE transport - to be implemented
+            return c.text('SSE transport not yet implemented', 501);
+        });
+        // Direct tool endpoints for convenience
+        app.post('/mcp/search', async (c) => {
+            try {
+                const input = await c.req.json();
+                const result = await handlers.search(input);
+                return c.json(result);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                return c.json({ error: message }, 500);
+            }
+        });
+        app.post('/mcp/fetch', async (c) => {
+            try {
+                const input = await c.req.json();
+                const result = await handlers.fetch(input);
+                return c.json(result);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                return c.json({ error: message }, 500);
+            }
+        });
+        app.post('/mcp/do', async (c) => {
+            try {
+                const input = await c.req.json();
+                const result = await handlers.do(input);
+                return c.json(result);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                return c.json({ error: message }, 500);
+            }
+        });
+        // Tool definitions endpoint
+        app.get('/mcp/tools', (c) => {
+            return c.json({
+                tools: tools.map((tool) => ({
+                    name: tool.name,
+                    description: tool.description,
+                    inputSchema: tool.inputSchema,
+                })),
+            });
+        });
+        // Health check
+        app.get('/mcp/health', (c) => {
+            return c.json({
+                status: 'healthy',
+                server: 'postgres-mcp',
+                version: '0.1.0',
+                timestamp: new Date().toISOString(),
+            });
+        });
+        return app;
+    }
+    return {
+        handleRequest,
+        routes,
+    };
+}
+/**
+ * Create MCP routes for integration with PostgresDO worker
+ */
+export function createMCPRoutes(getExecutor, getConfig) {
+    const app = new Hono();
+    // Middleware to create MCP server per request
+    app.use('*', async (c, next) => {
+        const executor = getExecutor(c);
+        const config = getConfig?.(c) || { databaseId: 'default' };
+        const mcpServer = createMCPServer(executor, config);
+        // Store in context
+        c.set('mcpServer', mcpServer);
+        await next();
+    });
+    // Forward to MCP server routes
+    app.all('*', async (c) => {
+        const mcpServer = c.get('mcpServer');
+        const routes = mcpServer.routes();
+        return routes.fetch(c.req.raw);
+    });
+    return app;
+}
+/**
+ * Re-export types and tools
+ */
+export { getToolDefinitions, createToolHandlers };
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,58 @@
+/**
+ * MCP Tools for PostgresDO
+ *
+ * Implements the three core MCP tools: search, fetch, and do.
+ */
+import type { ToolResponse, SearchInput, FetchInput, DoInput, MCPAuthContext } from './types.js';
+import type { QueryExecutor } from './binding.js';
+/**
+ * Tool definition for MCP protocol
+ */
+export interface Tool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: Record<string, unknown>;
+        required: string[];
+    };
+}
+/**
+ * Search tool definition
+ */
+export declare const searchTool: Tool;
+/**
+ * Fetch tool definition
+ */
+export declare const fetchTool: Tool;
+/**
+ * Do tool definition
+ */
+export declare const doTool: Tool;
+/**
+ * Create the search tool handler
+ */
+export declare function createSearchHandler(executor: QueryExecutor): (input: SearchInput) => Promise<ToolResponse>;
+/**
+ * Create the fetch tool handler
+ */
+export declare function createFetchHandler(executor: QueryExecutor): (input: FetchInput) => Promise<ToolResponse>;
+/**
+ * Create the do tool handler
+ */
+export declare function createDoHandler(executor: QueryExecutor, options?: {
+    timeout?: number;
+    authContext?: MCPAuthContext;
+}): (input: DoInput) => Promise<ToolResponse>;
+/**
+ * Get all tool definitions
+ */
+export declare function getToolDefinitions(): Tool[];
+/**
+ * Create all tool handlers
+ */
+export declare function createToolHandlers(executor: QueryExecutor, options?: {
+    timeout?: number;
+    authContext?: MCPAuthContext;
+}): Record<string, (input: unknown) => Promise<ToolResponse>>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAGV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,OAAO,EACP,cAAc,EACf,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACnC,QAAQ,EAAE,MAAM,EAAE,CAAA;KACnB,CAAA;CACF;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,IAmBxB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,IAevB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,IAgBpB,CAAA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,GACtB,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAqH/C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,GACtB,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,YAAY,CAAC,CAiI9C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,cAAc,CAAA;CAAO,GAC/D,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,CAgF3C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,EAAE,CAE3C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,cAAc,CAAA;CAAO,GAC/D,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,CAM3D"}