@alpha.consultings/eloquent-orm.js 1.0.1

package/dist/core/connection/DatabaseConnection.d.ts

@@ -0,0 +1,49 @@
+import { Pool } from "mysql2/promise";
+import { Client as PgClient } from "pg";
+import { Db } from "mongodb";
+import { dbConfig } from "../../config/database";
+import { SQLiteConnectionLike } from "./BetterSqliteConnection";
+/** Supported driver names */
+export type DriverName = "mysql" | "pg" | "sqlite" | "mongo";
+/** MySQL connection configuration */
+export interface MySQLConfig {
+    driver: "mysql";
+    host: string;
+    user: string;
+    password: string;
+    database: string;
+    port?: number;
+    waitForConnections?: boolean;
+    connectionLimit?: number;
+    queueLimit?: number;
+}
+/** PostgreSQL connection configuration */
+export interface PostgresConfig {
+    driver: "pg";
+    host: string;
+    user: string;
+    password: string;
+    database: string;
+    port: number;
+}
+/** SQLite connection configuration */
+export interface SQLiteConfig {
+    driver: "sqlite";
+    sqlitePath: string;
+}
+/** MongoDB connection configuration */
+export interface MongoConfig {
+    driver: "mongo";
+    uri: string;
+    database: string;
+    dnsServers?: string[];
+}
+/** Union type for all connection configs */
+export type ConnectionConfig = MySQLConfig | PostgresConfig | SQLiteConfig | MongoConfig;
+/** Database connection instance types */
+export type ConnectionInstance = Pool | PgClient | SQLiteConnectionLike | Db;
+/** Supported connection names */
+export type ConnectionName = keyof typeof dbConfig.connections;
+export declare function connectDB(name: ConnectionName): Promise<ConnectionInstance>;
+export declare function closeMongoClient(connection: ConnectionInstance): Promise<boolean>;
+//# sourceMappingURL=DatabaseConnection.d.ts.map

package/dist/core/connection/DatabaseConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseConnection.d.ts","sourceRoot":"","sources":["../../../src/core/connection/DatabaseConnection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,EAAe,EAAE,EAAE,MAAM,SAAS,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAEL,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAMlC,6BAA6B;AAC7B,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7D,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,IAAI,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC;AAEzF,yCAAyC;AACzC,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,QAAQ,GAAG,oBAAoB,GAAG,EAAE,CAAC;AAE7E,iCAAiC;AACjC,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,QAAQ,CAAC,WAAW,CAAC;AA4D/D,wBAAsB,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6DjF;AAED,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvF"}

package/dist/core/connection/DatabaseConnection.js

@@ -0,0 +1,120 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectDB = connectDB;
+exports.closeMongoClient = closeMongoClient;
+const pg_1 = require("pg");
+const mongodb_1 = require("mongodb");
+const dns_1 = __importDefault(require("dns"));
+const database_1 = require("../../config/database");
+const BetterSqliteConnection_1 = require("./BetterSqliteConnection");
+const mongoClientByDb = new WeakMap();
+function applyMongoDnsServers(uri, dnsServers) {
+    if (!uri.startsWith("mongodb+srv://"))
+        return;
+    const normalizedServers = (dnsServers ?? [])
+        .map((value) => value.trim())
+        .filter((value) => value.length > 0);
+    if (normalizedServers.length === 0)
+        return;
+    const currentServers = dns_1.default.getServers();
+    if (currentServers.length === normalizedServers.length &&
+        currentServers.every((value, index) => value === normalizedServers[index])) {
+        return;
+    }
+    dns_1.default.setServers(normalizedServers);
+    console.log(`Using custom DNS servers for MongoDB SRV resolution: ${normalizedServers.join(", ")}`);
+}
+function normalizeMongoConnectionError(connectionName, error) {
+    const code = String(error?.code ?? "");
+    const codeName = String(error?.codeName ?? "");
+    const message = error instanceof Error ? error.message : String(error);
+    if (code === "ECONNREFUSED" && message.includes("querySrv")) {
+        const normalized = new Error(`MongoDB SRV lookup failed for "${connectionName}". ` +
+            `If system DNS works but Node fails, set MONGO_DNS_SERVERS ` +
+            `or switch to a non-SRV mongodb:// URI.`);
+        normalized.cause = error;
+        return normalized;
+    }
+    if ((code === "8000" || codeName === "AtlasError") && /auth/i.test(message)) {
+        const normalized = new Error(`MongoDB authentication failed for "${connectionName}". ` +
+            `Verify MONGO_URI credentials, Atlas DB user roles, and authSource.`);
+        normalized.cause = error;
+        return normalized;
+    }
+    return error instanceof Error ? error : new Error(String(error));
+}
+/* ----------------------------------------------------------
+ * 2. Connect Function (Multi-Driver)
+ * ---------------------------------------------------------- */
+async function connectDB(name) {
+    const config = database_1.dbConfig.connections[name];
+    switch (config.driver) {
+        /* ---------- MySQL ---------- */
+        case "mysql": {
+            const mysql = require("mysql2/promise");
+            return mysql.createPool({
+                host: config.host,
+                user: config.user,
+                password: config.password,
+                database: config.database,
+                port: config.port,
+                waitForConnections: config.waitForConnections ?? true,
+                connectionLimit: config.connectionLimit ?? 10,
+                queueLimit: config.queueLimit ?? 0,
+            });
+        }
+        /* ---------- PostgreSQL ---------- */
+        case "pg": {
+            const client = new pg_1.Client({
+                host: config.host,
+                user: config.user,
+                password: config.password,
+                database: config.database,
+                port: config.port,
+            });
+            await client.connect();
+            return client;
+        }
+        /* ---------- SQLite ---------- */
+        case "sqlite": {
+            return new BetterSqliteConnection_1.BetterSqliteConnection(config.sqlitePath);
+        }
+        /* ---------- MongoDB ---------- */
+        case "mongo": {
+            applyMongoDnsServers(config.uri, config.dnsServers);
+            const client = new mongodb_1.MongoClient(config.uri);
+            try {
+                await client.connect();
+                const db = client.db(config.database);
+                mongoClientByDb.set(db, client);
+                console.log(`Connected to MongoDB: ${config.database}`);
+                return db;
+            }
+            catch (error) {
+                try {
+                    await client.close();
+                }
+                catch {
+                    // no-op
+                }
+                throw normalizeMongoConnectionError(name, error);
+            }
+        }
+        /* ---------- Unknown ---------- */
+        default:
+            throw new Error(`Unsupported driver: ${config.driver}`);
+    }
+}
+async function closeMongoClient(connection) {
+    const db = connection;
+    const client = mongoClientByDb.get(db);
+    if (!client)
+        return false;
+    await client.close();
+    mongoClientByDb.delete(db);
+    return true;
+}
+//# sourceMappingURL=DatabaseConnection.js.map

package/dist/core/connection/DatabaseConnection.js.map

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

package/dist/core/connection/DriverAdapter.d.ts

@@ -0,0 +1,23 @@
+import type { ConnectionInstance, ConnectionName } from "./DatabaseConnection";
+export type AdapterKind = "sql" | "mongo";
+export interface DriverAdapter {
+    name: ConnectionName;
+    kind: AdapterKind;
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;
+    queryOne<T = unknown>(sql: string, params?: unknown[]): Promise<T | null>;
+    execute(sql: string, params?: unknown[]): Promise<void>;
+    insert(sql: string, params?: unknown[]): Promise<{
+        id?: unknown;
+        row?: Record<string, unknown>;
+    }>;
+    placeholder(index: number): string;
+    placeholders(count: number, startIndex?: number): string;
+    inClause(field: string, values: unknown[], startIndex?: number): {
+        sql: string;
+        params: unknown[];
+        nextIndex: number;
+    };
+    wrapId(id: string): string;
+}
+export declare function createAdapter(name: ConnectionName, connection: ConnectionInstance): DriverAdapter;
+//# sourceMappingURL=DriverAdapter.d.ts.map

package/dist/core/connection/DriverAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DriverAdapter.d.ts","sourceRoot":"","sources":["../../../src/core/connection/DriverAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG/E,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,WAAW,CAAC;IAElB,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAClE,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,CACJ,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAE5D,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzD,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,EAAE,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAmJD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,kBAAkB,GAC7B,aAAa,CAaf"}

package/dist/core/connection/DriverAdapter.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdapter = createAdapter;
+const database_1 = require("../../config/database");
+function isSqlDriver(driver) {
+    return driver === "mysql" || driver === "pg" || driver === "sqlite";
+}
+function assertSafeIdentifier(part) {
+    if (part === "*")
+        return;
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(part)) {
+        throw new Error(`Unsafe SQL identifier: ${part}`);
+    }
+}
+function wrapIdentifier(id, quote) {
+    if (id === "*")
+        return "*";
+    const parts = id.split(".");
+    const wrapped = parts.map((part) => {
+        assertSafeIdentifier(part);
+        if (part === "*")
+            return "*";
+        return `${quote}${part}${quote}`;
+    });
+    return wrapped.join(".");
+}
+function hasReturningClause(sql) {
+    return /\breturning\b/i.test(sql);
+}
+function buildSqlAdapter(name, connection, driver) {
+    const quote = driver === "mysql" ? "`" : "\"";
+    const placeholder = (index) => (driver === "pg" ? `$${index}` : "?");
+    const placeholders = (count, startIndex = 1) => {
+        const parts = [];
+        for (let i = 0; i < count; i++) {
+            parts.push(placeholder(startIndex + i));
+        }
+        return parts.join(", ");
+    };
+    const inClause = (field, values, startIndex = 1) => {
+        if (!values.length) {
+            return { sql: "1=0", params: [], nextIndex: startIndex };
+        }
+        if (driver === "pg") {
+            return {
+                sql: `${field} = ANY(${placeholder(startIndex)})`,
+                params: [values],
+                nextIndex: startIndex + 1,
+            };
+        }
+        const list = placeholders(values.length, startIndex);
+        return {
+            sql: `${field} IN (${list})`,
+            params: values,
+            nextIndex: startIndex + values.length,
+        };
+    };
+    if (driver === "mysql") {
+        return {
+            name,
+            kind: "sql",
+            async query(sql, params = []) {
+                const [rows] = await connection.query(sql, params);
+                return rows;
+            },
+            async queryOne(sql, params = []) {
+                const rows = await this.query(sql, params);
+                return rows[0] ?? null;
+            },
+            async execute(sql, params = []) {
+                await connection.query(sql, params);
+            },
+            async insert(sql, params = []) {
+                const [res] = await connection.query(sql, params);
+                const id = res?.insertId ?? res?.insertedId ?? undefined;
+                return { id };
+            },
+            placeholder,
+            placeholders,
+            inClause,
+            wrapId: (id) => wrapIdentifier(id, quote),
+        };
+    }
+    if (driver === "sqlite") {
+        return {
+            name,
+            kind: "sql",
+            async query(sql, params = []) {
+                return await connection.all(sql, params);
+            },
+            async queryOne(sql, params = []) {
+                const row = await connection.get(sql, params);
+                return row ?? null;
+            },
+            async execute(sql, params = []) {
+                await connection.run(sql, params);
+            },
+            async insert(sql, params = []) {
+                const res = await connection.run(sql, params);
+                return { id: res?.lastID };
+            },
+            placeholder,
+            placeholders,
+            inClause,
+            wrapId: (id) => wrapIdentifier(id, quote),
+        };
+    }
+    return {
+        name,
+        kind: "sql",
+        async query(sql, params = []) {
+            const res = await connection.query(sql, params);
+            return res.rows;
+        },
+        async queryOne(sql, params = []) {
+            const rows = await this.query(sql, params);
+            return rows[0] ?? null;
+        },
+        async execute(sql, params = []) {
+            await connection.query(sql, params);
+        },
+        async insert(sql, params = []) {
+            const finalSql = hasReturningClause(sql) ? sql : `${sql} RETURNING *`;
+            const res = await connection.query(finalSql, params);
+            const row = res.rows?.[0];
+            return { id: row?.id, row };
+        },
+        placeholder,
+        placeholders,
+        inClause,
+        wrapId: (id) => wrapIdentifier(id, quote),
+    };
+}
+function createAdapter(name, connection) {
+    const config = database_1.dbConfig.connections[name];
+    const driver = config?.driver;
+    if (driver === "mongo") {
+        throw new Error("Mongo driver does not support SQL adapter APIs.");
+    }
+    if (!driver || !isSqlDriver(driver)) {
+        throw new Error(`Unsupported driver for adapter: ${String(driver)}`);
+    }
+    return buildSqlAdapter(name, connection, driver);
+}
+//# sourceMappingURL=DriverAdapter.js.map

package/dist/core/connection/DriverAdapter.js.map

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

package/dist/core/connection/resolveConnectionName.d.ts

@@ -0,0 +1,17 @@
+import type { ConnectionName } from "./ConnectionFactory";
+/**
+ * 🔍 Resolve the correct connection name for a model or fallback globally.
+ * Priority:
+ * 1. Explicit model test/no-sql connection (test mode)
+ * 2. process.env.DB_TEST_CONNECTION (test mode)
+ * 3. ModelClass.connectionName
+ * 4. process.env.DB_CONNECTION
+ * 5. dbConfig.default
+ * 6. "mysql"
+ */
+export declare function resolveConnectionName(modelClass?: {
+    connectionName?: string;
+}, options?: {
+    test?: boolean;
+}): ConnectionName;
+//# sourceMappingURL=resolveConnectionName.d.ts.map

package/dist/core/connection/resolveConnectionName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveConnectionName.d.ts","sourceRoot":"","sources":["../../../src/core/connection/resolveConnectionName.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,cAAc,CA2ChB"}

package/dist/core/connection/resolveConnectionName.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConnectionName = resolveConnectionName;
+// src/core/connection/resolveConnectionName.ts
+const database_1 = require("../../config/database");
+/**
+ * 🔍 Resolve the correct connection name for a model or fallback globally.
+ * Priority:
+ * 1. Explicit model test/no-sql connection (test mode)
+ * 2. process.env.DB_TEST_CONNECTION (test mode)
+ * 3. ModelClass.connectionName
+ * 4. process.env.DB_CONNECTION
+ * 5. dbConfig.default
+ * 6. "mysql"
+ */
+function resolveConnectionName(modelClass, options) {
+    if (options?.test) {
+        const explicitModelConnection = modelClass?.connectionName;
+        if (explicitModelConnection &&
+            Object.prototype.hasOwnProperty.call(database_1.dbConfig.connections, explicitModelConnection)) {
+            const modelDriver = database_1.dbConfig.connections[explicitModelConnection]?.driver;
+            if (explicitModelConnection.endsWith("_test") || modelDriver === "mongo") {
+                return explicitModelConnection;
+            }
+        }
+        const explicitTest = process.env.DB_TEST_CONNECTION;
+        if (explicitTest &&
+            Object.prototype.hasOwnProperty.call(database_1.dbConfig.connections, explicitTest)) {
+            return explicitTest;
+        }
+        for (const fallback of ["mysql_test", "pg_test", "sqlite_test", "mongo_test", "mongo"]) {
+            if (Object.prototype.hasOwnProperty.call(database_1.dbConfig.connections, fallback)) {
+                return fallback;
+            }
+        }
+    }
+    const name = modelClass?.connectionName ||
+        process.env.DB_CONNECTION ||
+        database_1.dbConfig.default ||
+        "mysql";
+    if (!Object.keys(database_1.dbConfig.connections).includes(name)) {
+        console.warn(`⚠️ Invalid connection "${name}" — falling back to "mysql".`);
+        return "mysql";
+    }
+    return name;
+}
+//# sourceMappingURL=resolveConnectionName.js.map

package/dist/core/connection/resolveConnectionName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveConnectionName.js","sourceRoot":"","sources":["../../../src/core/connection/resolveConnectionName.ts"],"names":[],"mappings":";;AAcA,sDA8CC;AA5DD,+CAA+C;AAC/C,oDAAiD;AAGjD;;;;;;;;;GASG;AACH,SAAgB,qBAAqB,CACnC,UAAwC,EACxC,OAA4B;IAE5B,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,MAAM,uBAAuB,GAAG,UAAU,EAAE,cAAc,CAAC;QAC3D,IACE,uBAAuB;YACvB,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,mBAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC,EACnF,CAAC;YACD,MAAM,WAAW,GAAI,mBAAQ,CAAC,WAAmD,CAC/E,uBAAuB,CACxB,EAAE,MAAM,CAAC;YACV,IAAI,uBAAuB,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;gBACzE,OAAO,uBAAyC,CAAC;YACnD,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACpD,IACE,YAAY;YACZ,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,mBAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,EACxE,CAAC;YACD,OAAO,YAA8B,CAAC;QACxC,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,CAAC;YACvF,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,mBAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACzE,OAAO,QAA0B,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GACR,UAAU,EAAE,cAAc;QAC1B,OAAO,CAAC,GAAG,CAAC,aAAa;QACzB,mBAAQ,CAAC,OAAO;QAChB,OAAO,CAAC;IAEV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAQ,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,IAAI,CACV,0BAA0B,IAAI,8BAA8B,CAC7D,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,IAAsB,CAAC;AAChC,CAAC"}