@fett/sql-translator 0.0.1-beta

package/lib/driver/mongodb/schema.d.ts

@@ -0,0 +1,37 @@
+/**
+ * MongoDB 集合结构采样（迁移自 WizBuild mongodb-analyzer.ts）
+ * 长任务形态：分批 cursor + 进度上报 + 取消（cursor.close）
+ */
+import type { Db, Document } from 'mongodb';
+import type { SchemaOptions } from '../../types/config.js';
+import type { IntrospectTask } from '../../types/task.js';
+import type { TableSchema } from '../../types/schema.js';
+type JsonType = 'string' | 'number' | 'boolean' | 'date' | 'objectid' | 'array' | 'object' | 'null' | 'unknown';
+export interface MongoSchemaAnalysis {
+    collectionName: string;
+    analyzedDocuments: number;
+    schema: {
+        types: JsonType[];
+        required: boolean;
+        nullable: boolean;
+        properties?: Record<string, any>;
+        items?: any;
+    };
+}
+/** 采样分析集合结构（长任务） */
+export declare function analyzeCollection(db: Db, collectionName: string, opts?: SchemaOptions): IntrospectTask<MongoSchemaAnalysis>;
+/** 采样分析 → TableSchema（columns + raw.properties 递归结构） */
+export declare function analysisToTableSchema(collectionName: string, analysis: MongoSchemaAnalysis, dbName?: string): TableSchema;
+/** 采样分析 → Field[]（getColumns 用） */
+export declare function analysisToFields(analysis: MongoSchemaAnalysis): {
+    field_name: string;
+    custom_name: string;
+    field_desc: string;
+    field_type: JsonType;
+    display_type: string;
+    is_primary: 0;
+}[];
+/** 从行推断字段（查询结果无协议元数据时用） */
+export declare function inferFieldsFromRows(rows: Document[]): any[];
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/lib/driver/mongodb/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/driver/mongodb/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEvE,KAAK,QAAQ,GACT,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,OAAO,GACP,QAAQ,GACR,MAAM,GACN,SAAS,CAAC;AA8Ed,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjC,KAAK,CAAC,EAAE,GAAG,CAAC;KACb,CAAC;CACH;AAuBD,oBAAoB;AACpB,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,EAAE,EACN,cAAc,EAAE,MAAM,EACtB,IAAI,GAAE,aAAkB,GACvB,cAAc,CAAC,mBAAmB,CAAC,CAyDrC;AAwBD,wDAAwD;AACxD,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,CAAC,EAAE,MAAM,GACd,WAAW,CA0Bb;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB;;;;;;;IAc7D;AAED,2BAA2B;AAC3B,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,GAAG,EAAE,CAe3D"}

package/lib/driver/mongodb/schema.js

@@ -0,0 +1,238 @@
+import { createTask } from '../../types/task.js';
+/** 值类型检测（含 ObjectId/Buffer/Date） */
+function detectType(v) {
+    if (v === null || v === undefined)
+        return 'null';
+    if (Array.isArray(v))
+        return 'array';
+    if (v instanceof Date)
+        return 'date';
+    if (typeof v === 'string')
+        return 'string';
+    if (typeof v === 'number')
+        return 'number';
+    if (typeof v === 'boolean')
+        return 'boolean';
+    if (typeof v === 'object') {
+        // ObjectId / Buffer / 其他 BSON 类型
+        const ctor = v.constructor?.name;
+        if (ctor === 'ObjectId')
+            return 'objectid';
+        if (ctor === 'Binary')
+            return 'object';
+        if (ctor === 'Long' || ctor === 'Int32' || ctor === 'Double' || ctor === 'Decimal128')
+            return 'number';
+        return 'object';
+    }
+    return 'unknown';
+}
+function ensureChild(parent, key) {
+    if (!parent.properties)
+        parent.properties = new Map();
+    let child = parent.properties.get(key);
+    if (!child) {
+        child = { types: new Set(), count: 0, nullCount: 0 };
+        parent.properties.set(key, child);
+    }
+    return child;
+}
+function ensureItems(parent) {
+    if (!parent.items)
+        parent.items = { types: new Set(), count: 0, nullCount: 0 };
+    return parent.items;
+}
+function mergeNode(target, source) {
+    source.types.forEach((t) => target.types.add(t));
+    target.count += source.count;
+    target.nullCount += source.nullCount;
+    if (source.properties) {
+        for (const [key, child] of source.properties) {
+            mergeNode(ensureChild(target, key), child);
+        }
+    }
+    if (source.items) {
+        mergeNode(ensureItems(target), source.items);
+    }
+}
+function sampleValue(node, v) {
+    node.count++;
+    const type = detectType(v);
+    node.types.add(type);
+    if (type === 'null') {
+        node.nullCount++;
+        return;
+    }
+    if (type === 'object') {
+        for (const [k, val] of Object.entries(v)) {
+            sampleValue(ensureChild(node, k), val);
+        }
+    }
+    else if (type === 'array') {
+        for (const item of v) {
+            sampleValue(ensureItems(node), item);
+        }
+    }
+}
+/** 把 NodeStats 转成可序列化 schema */
+function nodeToSchema(node) {
+    const types = [...node.types];
+    const result = {
+        types,
+        required: node.count > 0 && node.nullCount === 0,
+        nullable: node.nullCount > 0,
+    };
+    if (node.properties) {
+        const props = {};
+        for (const [key, child] of node.properties) {
+            props[key] = nodeToSchema(child);
+        }
+        result.properties = props;
+    }
+    if (node.items) {
+        result.items = nodeToSchema(node.items);
+    }
+    return result;
+}
+/** 采样分析集合结构（长任务） */
+export function analyzeCollection(db, collectionName, opts = {}) {
+    return createTask(async (ctx) => {
+        const sampleSize = opts.sampleSize ?? 100;
+        const batchSize = Math.min(Math.max(opts.sampleSize ?? 50, 1), 1000);
+        const coll = db.collection(collectionName);
+        const root = { types: new Set(), count: 0, nullCount: 0 };
+        const isAll = opts.analyzeAll === true;
+        const limit = isAll ? 0 : sampleSize;
+        // 全量模式先拿一个估计总量用于进度
+        let total;
+        if (isAll) {
+            try {
+                total = await coll.estimatedDocumentCount();
+            }
+            catch {
+                total = undefined;
+            }
+        }
+        else {
+            total = sampleSize;
+        }
+        const cursor = coll.find({}, { batchSize }).limit(limit);
+        const abortHandler = () => {
+            void cursor.close().catch(() => undefined);
+        };
+        ctx.signal.addEventListener('abort', abortHandler, { once: true });
+        try {
+            let processed = 0;
+            while (await cursor.hasNext()) {
+                if (ctx.isCancelled())
+                    break;
+                const doc = await cursor.next();
+                if (doc) {
+                    processed++;
+                    sampleValue(root, doc);
+                }
+                if (processed % batchSize === 0 || processed === total) {
+                    ctx.report({ stage: 'sampling', processed, total, message: collectionName });
+                }
+            }
+            if (!ctx.isCancelled()) {
+                ctx.report({ stage: 'analyzing', processed, total });
+            }
+            const schema = nodeToSchema(root);
+            const required = schema.required !== false;
+            schema.required = required;
+            return {
+                collectionName,
+                analyzedDocuments: processed,
+                schema,
+            };
+        }
+        finally {
+            ctx.signal.removeEventListener('abort', abortHandler);
+            await cursor.close().catch(() => undefined);
+        }
+    });
+}
+/** display_type 映射 */
+function typeToDisplay(type) {
+    switch (type) {
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'date':
+            return 'date';
+        case 'array':
+            return 'array';
+        case 'object':
+            return 'object';
+        case 'objectid':
+            return 'string';
+        case 'null':
+            return 'string';
+        default:
+            return 'string';
+    }
+}
+/** 采样分析 → TableSchema（columns + raw.properties 递归结构） */
+export function analysisToTableSchema(collectionName, analysis, dbName) {
+    const properties = analysis.schema.properties ?? {};
+    const columns = Object.entries(properties).map(([name, prop], i) => {
+        const types = prop.types ?? ['string'];
+        const primary = types[0] ?? 'string';
+        return {
+            name,
+            type: primary,
+            nullable: prop.nullable !== false,
+            comment: undefined,
+            primaryKey: false,
+            autoIncrement: false,
+            ordinal: i + 1,
+        };
+    });
+    return {
+        name: collectionName,
+        schema: dbName,
+        kind: 'collection',
+        comment: undefined,
+        columns,
+        indexes: undefined,
+        foreignKeys: undefined,
+        ddl: undefined,
+        raw: { properties, analyzedDocuments: analysis.analyzedDocuments },
+    };
+}
+/** 采样分析 → Field[]（getColumns 用） */
+export function analysisToFields(analysis) {
+    const properties = analysis.schema.properties ?? {};
+    return Object.entries(properties).map(([name, prop]) => {
+        const types = prop.types ?? ['string'];
+        const primary = types[0] ?? 'string';
+        return {
+            field_name: name,
+            custom_name: name,
+            field_desc: '',
+            field_type: primary,
+            display_type: typeToDisplay(primary),
+            is_primary: 0,
+        };
+    });
+}
+/** 从行推断字段（查询结果无协议元数据时用） */
+export function inferFieldsFromRows(rows) {
+    if (!rows.length)
+        return [];
+    const first = rows[0] ?? {};
+    return Object.keys(first).map((key) => {
+        const value = first[key];
+        const type = detectType(value);
+        return {
+            field_name: key,
+            custom_name: key,
+            field_desc: '',
+            field_type: type,
+            display_type: typeToDisplay(type),
+            is_primary: 0,
+        };
+    });
+}
+//# sourceMappingURL=schema.js.map

package/lib/driver/mongodb/schema.js.map

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

package/lib/driver/mongodb/sql-translator.d.ts

@@ -0,0 +1,19 @@
+import type { Document } from 'mongodb';
+interface NoqlResult {
+    type: 'query' | 'aggregate';
+    collection?: string;
+    collections?: string[];
+    query?: Document;
+    projection?: Document;
+    pipeline?: Document[];
+    limit?: number;
+    offset?: number;
+}
+/** 翻译 SELECT 语句 */
+export declare function translateSelect(sql: string): NoqlResult;
+/** 翻译 WHERE 子句 → Mongo match 文档（兼容带/不带 WHERE 前缀） */
+export declare function translateWhereToMatch(whereClause: string): Document;
+/** 将附加 match 与已有 query 用 $and 合并（避免覆盖） */
+export declare function mergeMatch(base: Document | undefined, additional: Document | undefined): Document;
+export type { NoqlResult };
+//# sourceMappingURL=sql-translator.d.ts.map

package/lib/driver/mongodb/sql-translator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-translator.d.ts","sourceRoot":"","sources":["../../../src/driver/mongodb/sql-translator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,UAAU,UAAU;IAClB,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,mBAAmB;AACnB,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAEvD;AAED,oDAAoD;AACpD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAQnE;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,EAAE,UAAU,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAIjG;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/lib/driver/mongodb/sql-translator.js

@@ -0,0 +1,30 @@
+/**
+ * MongoDB SQL 翻译：SELECT → {query | pipeline}（@synatic/noql）
+ */
+import noqlPkg from '@synatic/noql';
+const parseSQL = noqlPkg.parseSQL ??
+    noqlPkg;
+/** 翻译 SELECT 语句 */
+export function translateSelect(sql) {
+    return parseSQL(sql);
+}
+/** 翻译 WHERE 子句 → Mongo match 文档（兼容带/不带 WHERE 前缀） */
+export function translateWhereToMatch(whereClause) {
+    const trimmed = String(whereClause ?? '')
+        .trim()
+        .replace(/^where\b/i, '')
+        .trim();
+    if (!trimmed)
+        return {};
+    const { query } = parseSQL(`SELECT * FROM __t WHERE ${trimmed}`);
+    return query || {};
+}
+/** 将附加 match 与已有 query 用 $and 合并（避免覆盖） */
+export function mergeMatch(base, additional) {
+    if (!additional || Object.keys(additional).length === 0)
+        return base ?? {};
+    if (!base || Object.keys(base).length === 0)
+        return additional;
+    return { $and: [base, additional] };
+}
+//# sourceMappingURL=sql-translator.js.map

package/lib/driver/mongodb/sql-translator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-translator.js","sourceRoot":"","sources":["../../../src/driver/mongodb/sql-translator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,OAAO,MAAM,eAAe,CAAC;AAepC,MAAM,QAAQ,GAAI,OAA+C,CAAC,QAAQ;IACvE,OAAgC,CAAC;AAEpC,mBAAmB;AACnB,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;SACtC,IAAI,EAAE;SACN,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,IAAI,EAAE,CAAC;IACV,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;IACjE,OAAO,KAAK,IAAI,EAAE,CAAC;AACrB,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,IAA0B,EAAE,UAAgC;IACrF,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,IAAI,EAAE,CAAC;IAC3E,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAC/D,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC;AACtC,CAAC"}

package/lib/driver/mysql/index.d.ts

@@ -0,0 +1,41 @@
+import type { SqlDriver, PoolHandle } from '../interface.js';
+import type { MysqlConfig, SchemaOptions } from '../../types/config.js';
+import type { ExecResult, RunSqlRequest, TestResult } from '../../types/result.js';
+import type { TableSchema } from '../../types/schema.js';
+import type { IntrospectTask } from '../../types/task.js';
+import type { TransactionHandle } from '../../types/transaction.js';
+import { MysqlPoolHandle } from './pool.js';
+type Knex = Awaited<ReturnType<MysqlPoolHandle['getKnex']>>;
+export declare class MysqlDriver implements SqlDriver {
+    readonly dialect: 'mysql' | 'mariadb';
+    constructor(dialect?: 'mysql' | 'mariadb');
+    createPool(config: import('../../types/config.js').ConnectionConfig): Promise<PoolHandle>;
+    /** knex 参数绑定（RawBinding 类型限制，unknown[] → any[]） */
+    private bind;
+    testConnection(config: MysqlConfig): Promise<TestResult>;
+    getTableList(pool: PoolHandle): Promise<string[]>;
+    getTableDDL(pool: PoolHandle, table: string): Promise<string>;
+    getPreviewRows(pool: PoolHandle, table: string, offset: number, limit: number, whereClause?: string): Promise<any[]>;
+    getColumns(pool: PoolHandle, table: string): Promise<{
+        field_name: string;
+        custom_name: string;
+        field_desc: string;
+        field_type: string;
+        display_type: string;
+        is_primary: 0 | 1;
+    }[]>;
+    getRowsCount(pool: PoolHandle, table: string, whereClause?: string): Promise<number>;
+    runSql(pool: PoolHandle, request: RunSqlRequest): Promise<ExecResult>;
+    /** 事务/常规共用执行核心（k 可指定为事务连接） */
+    runSqlWithKnex(k: Knex, handle: MysqlPoolHandle, request: RunSqlRequest): Promise<ExecResult>;
+    /** 事务：knex.transaction（fn 抛错自动回滚，成功自动提交） */
+    withTransaction<T>(pool: PoolHandle, fn: (tx: TransactionHandle) => Promise<T>): Promise<T>;
+    private runSelect;
+    private runDml;
+    getTableSchema(pool: PoolHandle, table: string): Promise<TableSchema>;
+    getAllTableSchemas(pool: PoolHandle, opts?: SchemaOptions): IntrospectTask<TableSchema[]>;
+}
+export declare const mysqlDriver: MysqlDriver;
+export declare const mariadbDriver: MysqlDriver;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/driver/mysql/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/driver/mysql/index.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAe,aAAa,EAAE,UAAU,EAAe,MAAM,uBAAuB,CAAC;AAC7G,OAAO,KAAK,EAA+C,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAC;AAE5D,KAAK,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAE5D,qBAAa,WAAY,YAAW,SAAS;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;gBAE1B,OAAO,GAAE,OAAO,GAAG,SAAmB;IAI5C,UAAU,CAAC,MAAM,EAAE,OAAO,uBAAuB,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAY/F,mDAAmD;IACnD,OAAO,CAAC,IAAI;IAIN,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA+BxD,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAYjD,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7D,cAAc,CAClB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,GAAG,EAAE,CAAC;IAQX,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM;;;;;;;;IAO1C,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWpF,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAM3E,8BAA8B;IAC9B,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAwB7F,4CAA4C;IACtC,eAAe,CAAC,CAAC,EACrB,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,CAAC,CAAC;YAuBC,SAAS;YA0CT,MAAM;IAqDd,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAuH3E,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;CAoB1F;AASD,eAAO,MAAM,WAAW,aAA2B,CAAC;AACpD,eAAO,MAAM,aAAa,aAA6B,CAAC"}