@dotdo/postgres 0.1.0

package/dist/extensions/registry.js

@@ -0,0 +1,182 @@
+/**
+ * Extension Registry and Loader
+ *
+ * Provides a registry system for PGLite extensions with:
+ * - Registration of extension definitions
+ * - Built-in support for common PostgreSQL extensions
+ * - Configuration-based enabling/disabling
+ * - PGLite extension object generation
+ */
+/**
+ * Registry for managing PostgreSQL extensions
+ */
+export class ExtensionRegistry {
+    extensions = new Map();
+    /**
+     * Register an extension definition
+     */
+    register(definition) {
+        if (this.extensions.has(definition.name)) {
+            throw new Error(`Extension "${definition.name}" is already registered`);
+        }
+        this.extensions.set(definition.name, definition);
+    }
+    /**
+     * Check if an extension is registered
+     */
+    has(name) {
+        return this.extensions.has(name);
+    }
+    /**
+     * Get an extension definition by name
+     */
+    get(name) {
+        return this.extensions.get(name);
+    }
+    /**
+     * List all registered extensions
+     */
+    list() {
+        return Array.from(this.extensions.values());
+    }
+    /**
+     * Resolve enabled extensions from config
+     */
+    resolveEnabled(config) {
+        const enabled = [];
+        if (!config.extensions) {
+            return enabled;
+        }
+        for (const [name, value] of Object.entries(config.extensions)) {
+            const definition = this.extensions.get(name);
+            if (!definition) {
+                continue; // Ignore unknown extensions
+            }
+            const isEnabled = typeof value === 'boolean' ? value : value.enabled;
+            if (isEnabled) {
+                enabled.push(definition);
+            }
+        }
+        return enabled;
+    }
+    /**
+     * Convert enabled extensions to PGLite-compatible format
+     */
+    async toPGLiteExtensions(enabled) {
+        const result = {};
+        for (const definition of enabled) {
+            result[definition.name] = {
+                name: definition.displayName,
+                setup: async (_pg, emscriptenOpts) => {
+                    return {
+                        emscriptenOpts,
+                        bundlePath: new URL(definition.bundlePath, import.meta.url),
+                    };
+                },
+            };
+        }
+        return result;
+    }
+    /**
+     * Generate SQL for creating enabled extensions with autoCreate
+     */
+    generateCreateExtensionSQL(config) {
+        if (!config.extensions) {
+            return '';
+        }
+        const statements = [];
+        for (const [name, value] of Object.entries(config.extensions)) {
+            if (typeof value !== 'boolean' && value.autoCreate) {
+                statements.push(`CREATE EXTENSION IF NOT EXISTS ${name};`);
+            }
+        }
+        return statements.join('\n');
+    }
+    /**
+     * Create a registry with built-in PostgreSQL extensions
+     */
+    static withBuiltins() {
+        const registry = new ExtensionRegistry();
+        // Register built-in extensions
+        registry.register({
+            name: 'vector',
+            displayName: 'pgvector',
+            description: 'Vector similarity search for PostgreSQL',
+            bundlePath: '../../pglite/release/vector.tar.gz',
+        });
+        registry.register({
+            name: 'pg_trgm',
+            displayName: 'pg_trgm',
+            description: 'Text similarity using trigram matching',
+            bundlePath: '../../pglite/release/pg_trgm.tar.gz',
+        });
+        registry.register({
+            name: 'hstore',
+            displayName: 'hstore',
+            description: 'Key-value pairs storage',
+            bundlePath: '../../pglite/release/hstore.tar.gz',
+        });
+        registry.register({
+            name: 'citext',
+            displayName: 'citext',
+            description: 'Case-insensitive character string type',
+            bundlePath: '../../pglite/release/citext.tar.gz',
+        });
+        registry.register({
+            name: 'uuid_ossp',
+            displayName: 'uuid-ossp',
+            description: 'Generate universally unique identifiers (UUIDs)',
+            bundlePath: '../../pglite/release/uuid_ossp.tar.gz',
+        });
+        registry.register({
+            name: 'pgcrypto',
+            displayName: 'pgcrypto',
+            description: 'Cryptographic functions',
+            bundlePath: '../../pglite/release/pgcrypto.tar.gz',
+        });
+        registry.register({
+            name: 'btree_gin',
+            displayName: 'btree_gin',
+            description: 'GIN operator classes for btree-indexable types',
+            bundlePath: '../../pglite/release/btree_gin.tar.gz',
+        });
+        registry.register({
+            name: 'btree_gist',
+            displayName: 'btree_gist',
+            description: 'GiST operator classes for btree-indexable types',
+            bundlePath: '../../pglite/release/btree_gist.tar.gz',
+        });
+        registry.register({
+            name: 'fuzzystrmatch',
+            displayName: 'fuzzystrmatch',
+            description: 'Fuzzy string matching functions',
+            bundlePath: '../../pglite/release/fuzzystrmatch.tar.gz',
+        });
+        registry.register({
+            name: 'intarray',
+            displayName: 'intarray',
+            description: 'Functions and operators for integer arrays',
+            bundlePath: '../../pglite/release/intarray.tar.gz',
+        });
+        registry.register({
+            name: 'ltree',
+            displayName: 'ltree',
+            description: 'Hierarchical tree-like data type',
+            bundlePath: '../../pglite/release/ltree.tar.gz',
+        });
+        registry.register({
+            name: 'tablefunc',
+            displayName: 'tablefunc',
+            description: 'Functions for manipulating tables',
+            bundlePath: '../../pglite/release/tablefunc.tar.gz',
+        });
+        registry.register({
+            name: 'unaccent',
+            displayName: 'unaccent',
+            description: 'Text search dictionary for removing accents',
+            bundlePath: '../../pglite/release/unaccent.tar.gz',
+        });
+        return registry;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/extensions/registry.js.map

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

package/dist/extensions/vector.d.ts

@@ -0,0 +1,106 @@
+/**
+ * pgvector Extension Integration
+ *
+ * Provides utilities and helpers for working with the pgvector extension
+ * for vector similarity search in PostgreSQL.
+ */
+import type { ExtensionDefinition } from './registry';
+/**
+ * Vector type - can be a number array or Float32Array
+ */
+export type Vector = number[] | Float32Array;
+/**
+ * Distance operator types for vector similarity
+ */
+export type DistanceOperator = '<->' | '<=>' | '<#>' | '<+>';
+/**
+ * Options for HNSW index creation
+ */
+export interface HNSWIndexOptions {
+    /** Maximum number of connections per layer (default: 16) */
+    m?: number;
+    /** Size of the dynamic candidate list for construction (default: 64) */
+    efConstruction?: number;
+    /** Operator class for the index */
+    operatorClass?: 'vector_l2_ops' | 'vector_cosine_ops' | 'vector_ip_ops';
+}
+/**
+ * Options for IVFFlat index creation
+ */
+export interface IVFFlatIndexOptions {
+    /** Number of lists/clusters (default: 100) */
+    lists?: number;
+    /** Operator class for the index */
+    operatorClass?: 'vector_l2_ops' | 'vector_cosine_ops' | 'vector_ip_ops';
+}
+/**
+ * Options for similarity search
+ */
+export interface SimilaritySearchOptions {
+    /** Distance operator to use */
+    operator?: DistanceOperator;
+    /** Maximum number of results */
+    limit?: number;
+    /** Additional WHERE clause */
+    where?: string;
+    /** Columns to select (default: *) */
+    select?: string | string[];
+}
+/**
+ * pgvector Extension wrapper with utilities
+ */
+export declare const VectorExtension: {
+    name: "vector";
+    displayName: "pgvector";
+    description: string;
+    /**
+     * Distance operators for vector similarity
+     */
+    operators: {
+        /** L2 (Euclidean) distance */
+        L2: "<->";
+        /** Cosine distance */
+        COSINE: "<=>";
+        /** Negative inner product */
+        INNER_PRODUCT: "<#>";
+        /** L1 (Manhattan) distance */
+        L1: "<+>";
+    };
+    /**
+     * Get the extension definition for registration
+     */
+    getDefinition(): ExtensionDefinition;
+    /**
+     * Generate SQL to create the vector extension
+     */
+    createExtensionSQL(): string;
+    /**
+     * Generate SQL to create a table with a vector column
+     */
+    createVectorTableSQL(tableName: string, vectorColumn: string, dimensions: number, additionalColumns?: string): string;
+    /**
+     * Generate SQL to create an HNSW index
+     */
+    createHNSWIndexSQL(tableName: string, vectorColumn: string, indexName: string, options?: HNSWIndexOptions): string;
+    /**
+     * Generate SQL to create an IVFFlat index
+     */
+    createIVFFlatIndexSQL(tableName: string, vectorColumn: string, indexName: string, options?: IVFFlatIndexOptions): string;
+    /**
+     * Generate SQL for similarity search
+     */
+    similaritySearchSQL(tableName: string, vectorColumn: string, queryVector: string, options?: SimilaritySearchOptions): string;
+};
+/**
+ * Parse a PostgreSQL vector string to a number array
+ * @param value PostgreSQL vector string like "[1,2,3]"
+ * @returns Number array or null if invalid
+ */
+export declare function parseVector(value: string): number[] | null;
+/**
+ * Serialize a number array or Float32Array to PostgreSQL vector string
+ * @param vector Number array or Float32Array
+ * @returns PostgreSQL vector string like "[1,2,3]"
+ */
+export declare function serializeVector(vector: Vector): string;
+//# sourceMappingURL=vector.d.ts.map

package/dist/extensions/vector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../src/extensions/vector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,EAAE,GAAG,YAAY,CAAA;AAE5C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAA;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mCAAmC;IACnC,aAAa,CAAC,EAAE,eAAe,GAAG,mBAAmB,GAAG,eAAe,CAAA;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mCAAmC;IACnC,aAAa,CAAC,EAAE,eAAe,GAAG,mBAAmB,GAAG,eAAe,CAAA;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;IAK1B;;OAEG;;QAED,8BAA8B;;QAE9B,sBAAsB;;QAEtB,6BAA6B;;QAE7B,8BAA8B;;;IAIhC;;OAEG;qBACc,mBAAmB;IASpC;;OAEG;0BACmB,MAAM;IAI5B;;OAEG;oCAEU,MAAM,gBACH,MAAM,cACR,MAAM,sBACE,MAAM,GACzB,MAAM;IAQT;;OAEG;kCAEU,MAAM,gBACH,MAAM,aACT,MAAM,YACR,gBAAgB,GACxB,MAAM;IAYT;;OAEG;qCAEU,MAAM,gBACH,MAAM,aACT,MAAM,YACR,mBAAmB,GAC3B,MAAM;IAMT;;OAEG;mCAEU,MAAM,gBACH,MAAM,eACP,MAAM,YACV,uBAAuB,GAC/B,MAAM;CAgBV,CAAA;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CA6B1D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD"}

package/dist/extensions/vector.js

@@ -0,0 +1,129 @@
+/**
+ * pgvector Extension Integration
+ *
+ * Provides utilities and helpers for working with the pgvector extension
+ * for vector similarity search in PostgreSQL.
+ */
+/**
+ * pgvector Extension wrapper with utilities
+ */
+export const VectorExtension = {
+    name: 'vector',
+    displayName: 'pgvector',
+    description: 'Vector similarity search extension for PostgreSQL',
+    /**
+     * Distance operators for vector similarity
+     */
+    operators: {
+        /** L2 (Euclidean) distance */
+        L2: '<->',
+        /** Cosine distance */
+        COSINE: '<=>',
+        /** Negative inner product */
+        INNER_PRODUCT: '<#>',
+        /** L1 (Manhattan) distance */
+        L1: '<+>',
+    },
+    /**
+     * Get the extension definition for registration
+     */
+    getDefinition() {
+        return {
+            name: this.name,
+            displayName: this.displayName,
+            description: this.description,
+            bundlePath: '../../pglite/release/vector.tar.gz',
+        };
+    },
+    /**
+     * Generate SQL to create the vector extension
+     */
+    createExtensionSQL() {
+        return 'CREATE EXTENSION IF NOT EXISTS vector;';
+    },
+    /**
+     * Generate SQL to create a table with a vector column
+     */
+    createVectorTableSQL(tableName, vectorColumn, dimensions, additionalColumns) {
+        const cols = additionalColumns ? `${additionalColumns},\n  ` : '';
+        return `CREATE TABLE IF NOT EXISTS ${tableName} (
+  id SERIAL PRIMARY KEY,
+  ${cols}${vectorColumn} vector(${dimensions})
+);`;
+    },
+    /**
+     * Generate SQL to create an HNSW index
+     */
+    createHNSWIndexSQL(tableName, vectorColumn, indexName, options = {}) {
+        const { m, efConstruction, operatorClass = 'vector_cosine_ops' } = options;
+        const withOpts = [];
+        if (m !== undefined)
+            withOpts.push(`m = ${m}`);
+        if (efConstruction !== undefined)
+            withOpts.push(`ef_construction = ${efConstruction}`);
+        const withClause = withOpts.length > 0 ? ` WITH (${withOpts.join(', ')})` : '';
+        return `CREATE INDEX ${indexName} ON ${tableName} USING hnsw (${vectorColumn} ${operatorClass})${withClause};`;
+    },
+    /**
+     * Generate SQL to create an IVFFlat index
+     */
+    createIVFFlatIndexSQL(tableName, vectorColumn, indexName, options = {}) {
+        const { lists = 100, operatorClass = 'vector_l2_ops' } = options;
+        return `CREATE INDEX ${indexName} ON ${tableName} USING ivfflat (${vectorColumn} ${operatorClass}) WITH (lists = ${lists});`;
+    },
+    /**
+     * Generate SQL for similarity search
+     */
+    similaritySearchSQL(tableName, vectorColumn, queryVector, options = {}) {
+        const { operator = '<->', limit = 10, where, select = '*', } = options;
+        const selectClause = Array.isArray(select) ? select.join(', ') : select;
+        const whereClause = where ? `WHERE ${where}\n` : '';
+        return `SELECT ${selectClause}
+FROM ${tableName}
+${whereClause}ORDER BY ${vectorColumn} ${operator} '${queryVector}'
+LIMIT ${limit};`;
+    },
+};
+/**
+ * Parse a PostgreSQL vector string to a number array
+ * @param value PostgreSQL vector string like "[1,2,3]"
+ * @returns Number array or null if invalid
+ */
+export function parseVector(value) {
+    if (!value || typeof value !== 'string') {
+        return null;
+    }
+    // Remove brackets and whitespace
+    const trimmed = value.trim();
+    if (!trimmed.startsWith('[') || !trimmed.endsWith(']')) {
+        return null;
+    }
+    const inner = trimmed.slice(1, -1).trim();
+    if (inner === '') {
+        return [];
+    }
+    try {
+        const parts = inner.split(',').map((s) => s.trim());
+        const numbers = parts.map((p) => {
+            const n = parseFloat(p);
+            if (isNaN(n)) {
+                throw new Error(`Invalid number: ${p}`);
+            }
+            return n;
+        });
+        return numbers;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Serialize a number array or Float32Array to PostgreSQL vector string
+ * @param vector Number array or Float32Array
+ * @returns PostgreSQL vector string like "[1,2,3]"
+ */
+export function serializeVector(vector) {
+    const arr = vector instanceof Float32Array ? Array.from(vector) : vector;
+    return `[${arr.join(',')}]`;
+}
+//# sourceMappingURL=vector.js.map

package/dist/extensions/vector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.js","sourceRoot":"","sources":["../../src/extensions/vector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkDH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,QAAiB;IACvB,WAAW,EAAE,UAAmB;IAChC,WAAW,EAAE,mDAAmD;IAEhE;;OAEG;IACH,SAAS,EAAE;QACT,8BAA8B;QAC9B,EAAE,EAAE,KAAc;QAClB,sBAAsB;QACtB,MAAM,EAAE,KAAc;QACtB,6BAA6B;QAC7B,aAAa,EAAE,KAAc;QAC7B,8BAA8B;QAC9B,EAAE,EAAE,KAAc;KACnB;IAED;;OAEG;IACH,aAAa;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,oCAAoC;SACjD,CAAA;IACH,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,wCAAwC,CAAA;IACjD,CAAC;IAED;;OAEG;IACH,oBAAoB,CAClB,SAAiB,EACjB,YAAoB,EACpB,UAAkB,EAClB,iBAA0B;QAE1B,MAAM,IAAI,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,iBAAiB,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;QACjE,OAAO,8BAA8B,SAAS;;IAE9C,IAAI,GAAG,YAAY,WAAW,UAAU;GACzC,CAAA;IACD,CAAC;IAED;;OAEG;IACH,kBAAkB,CAChB,SAAiB,EACjB,YAAoB,EACpB,SAAiB,EACjB,UAA4B,EAAE;QAE9B,MAAM,EAAE,CAAC,EAAE,cAAc,EAAE,aAAa,GAAG,mBAAmB,EAAE,GAAG,OAAO,CAAA;QAE1E,MAAM,QAAQ,GAAa,EAAE,CAAA;QAC7B,IAAI,CAAC,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAC9C,IAAI,cAAc,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,qBAAqB,cAAc,EAAE,CAAC,CAAA;QAEtF,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QAE9E,OAAO,gBAAgB,SAAS,OAAO,SAAS,gBAAgB,YAAY,IAAI,aAAa,IAAI,UAAU,GAAG,CAAA;IAChH,CAAC;IAED;;OAEG;IACH,qBAAqB,CACnB,SAAiB,EACjB,YAAoB,EACpB,SAAiB,EACjB,UAA+B,EAAE;QAEjC,MAAM,EAAE,KAAK,GAAG,GAAG,EAAE,aAAa,GAAG,eAAe,EAAE,GAAG,OAAO,CAAA;QAEhE,OAAO,gBAAgB,SAAS,OAAO,SAAS,mBAAmB,YAAY,IAAI,aAAa,mBAAmB,KAAK,IAAI,CAAA;IAC9H,CAAC;IAED;;OAEG;IACH,mBAAmB,CACjB,SAAiB,EACjB,YAAoB,EACpB,WAAmB,EACnB,UAAmC,EAAE;QAErC,MAAM,EACJ,QAAQ,GAAG,KAAK,EAChB,KAAK,GAAG,EAAE,EACV,KAAK,EACL,MAAM,GAAG,GAAG,GACb,GAAG,OAAO,CAAA;QAEX,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;QACvE,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;QAEnD,OAAO,UAAU,YAAY;OAC1B,SAAS;EACd,WAAW,YAAY,YAAY,IAAI,QAAQ,KAAK,WAAW;QACzD,KAAK,GAAG,CAAA;IACd,CAAC;CACF,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,iCAAiC;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACzC,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACjB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QACnD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC9B,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;YACvB,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAA;YACzC,CAAC;YACD,OAAO,CAAC,CAAA;QACV,CAAC,CAAC,CAAA;QACF,OAAO,OAAO,CAAA;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,GAAG,GAAG,MAAM,YAAY,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IACxE,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;AAC7B,CAAC"}