narai-primitives 2.0.0-rc.1

package/dist/connectors/db/lib/drivers/mongodb.js

@@ -0,0 +1,371 @@
+/**
+ * drivers/mongodb.ts — MongoDB driver via the official `mongodb` package.
+ *
+ * Design:
+ *  - `MongoClient` *is* the pool. The driver lazily creates one shared
+ *    client on the first `connect()` call and reuses it for subsequent
+ *    handles. `close()` is a no-op because we don't want one caller's
+ *    `getConnection()/releaseConnection()` cycle to destroy the pool for
+ *    concurrent callers. {@link shutdown} closes the client at teardown.
+ *  - Collections are the MongoDB equivalent of tables. `getSchemaAsync`
+ *    lists collections and infers columns by sampling up to 50 documents
+ *    and unioning their top-level keys.
+ *  - `executeReadAsync(conn, query)` treats `query` as a JSON envelope:
+ *        { "collection": "<name>", "op": "find"|"aggregate"|"count",
+ *          "filter": {...}, "projection": {...}, "sort": {...},
+ *          "pipeline": [ ... ]
+ *        }
+ *    This is the same shape the wiki_db policy layer emits for Mongo envs.
+ *  - READ-ONLY: the driver exposes only `find`, `aggregate`, and `count`.
+ *    Any other `op` is rejected at the driver layer with a `SQL_ERROR`
+ *    whose error message begins `"forbidden op"`. We never call any
+ *    mutating method (insertOne, updateOne, deleteOne, …).
+ *  - The `mongodb` package is loaded via dynamic `import()`; missing
+ *    install throws a clear `npm install mongodb` hint.
+ */
+import { performance } from "node:perf_hooks";
+import { Column, DatabaseDriver, Table, } from "./base.js";
+import { OperationType } from "../policy.js";
+/**
+ * G-DB-1: MongoDB verb → OperationType mapping (V2.0 vocab).
+ *
+ * READ: read-only verbs. WRITE: insert/update/replace/findAndModify update
+ * variants + bulk (which may write). DELETE: deletion verbs (deleteOne,
+ * deleteMany, findOneAndDelete). ADMIN: collection/index lifecycle.
+ * Unknown verbs default to ADMIN (most restrictive).
+ */
+const _MONGO_READ_OPS = new Set([
+    "find", "findOne", "aggregate", "count", "countDocuments",
+    "estimatedDocumentCount", "distinct",
+]);
+const _MONGO_WRITE_OPS = new Set([
+    "insertOne", "insertMany", "updateOne", "updateMany",
+    "replaceOne", "bulkWrite",
+    "findOneAndUpdate", "findOneAndReplace",
+]);
+const _MONGO_DELETE_OPS = new Set([
+    "deleteOne", "deleteMany", "findOneAndDelete",
+]);
+const _MONGO_ADMIN_OPS = new Set([
+    "createCollection", "drop", "dropCollection", "renameCollection",
+    "createIndex", "createIndexes", "dropIndex", "dropIndexes",
+]);
+const READ_ONLY_OPS = new Set(["find", "aggregate", "count"]);
+export class MongoDriver extends DatabaseDriver {
+    _mongoModule = null;
+    _client = null;
+    _clientPromise = null;
+    _database = "";
+    async _loadMongo() {
+        if (this._mongoModule !== null)
+            return this._mongoModule;
+        try {
+            const mod = (await import("mongodb"));
+            this._mongoModule =
+                "MongoClient" in mod
+                    ? mod
+                    : mod.default;
+            return this._mongoModule;
+        }
+        catch (e) {
+            throw new Error(`Driver 'mongodb' requires 'mongodb' — run: npm install mongodb (${e.message})`);
+        }
+    }
+    _ensureClient(envConfig) {
+        if (this._client !== null)
+            return Promise.resolve(this._client);
+        if (this._clientPromise !== null)
+            return this._clientPromise;
+        this._clientPromise = this._loadMongo().then(async (mongo) => {
+            const uri = typeof envConfig["uri"] === "string"
+                ? envConfig["uri"]
+                : _buildUri(envConfig);
+            this._database =
+                typeof envConfig["database"] === "string" ? envConfig["database"] : "";
+            const opts = {
+                readPreference: "secondaryPreferred",
+                maxPoolSize: typeof envConfig["pool_max"] === "number"
+                    ? envConfig["pool_max"]
+                    : 10,
+            };
+            const client = new mongo.MongoClient(uri, opts);
+            await client.connect();
+            this._client = client;
+            return client;
+        });
+        return this._clientPromise;
+    }
+    connect(envConfig) {
+        return this._ensureClient(envConfig).then((client) => {
+            const db = client.db(this._database.length > 0 ? this._database : undefined);
+            return { db, database: this._database };
+        });
+    }
+    executeRead(_conn, _query, _params = null, _maxRows = 1000, _timeoutMs = 30_000) {
+        return {
+            status: "error",
+            error_code: "SYNC_UNSUPPORTED",
+            error: "MongoDriver.executeRead is async — call executeReadAsync() instead.",
+            execution_time_ms: 0,
+        };
+    }
+    async executeReadAsync(conn, query, _params = null, maxRows = 1000, _timeoutMs = 30_000) {
+        const handle = (await conn);
+        const start = performance.now();
+        try {
+            const env = _parseEnvelope(query);
+            if (env === null) {
+                return {
+                    status: "error",
+                    error_code: "SQL_ERROR",
+                    error: "MongoDriver: query must be a JSON envelope {collection, op, ...}",
+                    execution_time_ms: roundTo2(performance.now() - start),
+                };
+            }
+            if (!READ_ONLY_OPS.has(env.op)) {
+                return {
+                    status: "error",
+                    error_code: "SQL_ERROR",
+                    error: `forbidden op: '${env.op}' — MongoDriver allows only [${[...READ_ONLY_OPS].join(", ")}]`,
+                    execution_time_ms: roundTo2(performance.now() - start),
+                };
+            }
+            const coll = handle.db.collection(env.collection);
+            if (env.op === "count") {
+                const total = await coll.countDocuments(env.filter ?? {});
+                return {
+                    status: "success",
+                    rows: [{ count: total }],
+                    row_count: 1,
+                    columns: ["count"],
+                    execution_time_ms: roundTo2(performance.now() - start),
+                    truncated: false,
+                };
+            }
+            let cursor;
+            if (env.op === "find") {
+                cursor = coll.find(env.filter ?? {});
+                if (env.projection)
+                    cursor = cursor.project(env.projection);
+                if (env.sort)
+                    cursor = cursor.sort(env.sort);
+                cursor = cursor.limit(maxRows + 1);
+            }
+            else {
+                const pipeline = env.pipeline ?? [];
+                cursor = coll.aggregate([
+                    ...pipeline,
+                    { $limit: maxRows + 1 },
+                ]);
+            }
+            const docs = await cursor.toArray();
+            let truncated = false;
+            let rows = docs;
+            if (rows.length > maxRows) {
+                truncated = true;
+                rows = rows.slice(0, maxRows);
+            }
+            const columns = _inferColumns(rows);
+            return {
+                status: "success",
+                rows,
+                row_count: rows.length,
+                columns,
+                execution_time_ms: roundTo2(performance.now() - start),
+                truncated,
+            };
+        }
+        catch (e) {
+            return {
+                status: "error",
+                error_code: "SQL_ERROR",
+                error: e.message,
+                execution_time_ms: roundTo2(performance.now() - start),
+            };
+        }
+    }
+    getSchema(_conn, _schemaName = "", _tableFilter = null) {
+        return [];
+    }
+    async getSchemaAsync(conn, schemaName = "", tableFilter = null) {
+        const handle = (await conn);
+        try {
+            const colls = await handle.db.listCollections().toArray();
+            const filtered = colls.filter((c) => {
+                if (tableFilter === null || tableFilter === undefined)
+                    return true;
+                const pattern = new RegExp("^" +
+                    tableFilter.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/%/g, ".*") +
+                    "$");
+                return pattern.test(c.name);
+            });
+            // Sample all collections in parallel — each .toArray() is a round-trip,
+            // so for an N-collection DB this trims latency from N×rtt to ~1×rtt.
+            const samples = await Promise.all(filtered.map((c) => handle.db.collection(c.name).find({}, {}).limit(50).toArray()));
+            const out = [];
+            for (let i = 0; i < filtered.length; i++) {
+                const c = filtered[i];
+                const sample = samples[i];
+                const keyTypes = new Map();
+                for (const doc of sample) {
+                    for (const k of Object.keys(doc)) {
+                        if (!keyTypes.has(k) && doc[k] !== null && doc[k] !== undefined) {
+                            keyTypes.set(k, _mongoType(doc[k]));
+                        }
+                        else if (!keyTypes.has(k)) {
+                            keyTypes.set(k, "null");
+                        }
+                    }
+                }
+                const columns = [...keyTypes.entries()].map(([name, type]) => new Column({
+                    name,
+                    data_type: type,
+                    nullable: name !== "_id",
+                    is_primary_key: name === "_id",
+                    default: null,
+                }));
+                out.push(new Table({
+                    name: c.name,
+                    schema: schemaName.length > 0 ? schemaName : handle.database,
+                    columns,
+                }));
+            }
+            return out;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * No-op: the MongoClient is the pool and is shared across handles.
+     * {@link shutdown} closes the client at process teardown.
+     */
+    close(_conn) {
+        /* pool is shared — nothing to release per-handle */
+    }
+    async closeAsync(_conn) {
+        /* pool is shared — nothing to release per-handle */
+    }
+    /** Per-driver health check via MongoDB's `ping` command. */
+    async healthCheck(conn) {
+        try {
+            const handle = (await conn);
+            const res = await handle.db.command({ ping: 1 });
+            return Number(res["ok"]) === 1;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * G-DB-1: classify a Mongo query for the policy gate (V2.0 vocab).
+     *
+     * Accepts either a JSON envelope `{collection, op, ...}` or a free-form
+     * mongo statement like `db.users.insertOne({...})`. Unknown verbs default
+     * to ADMIN — default-deny.
+     */
+    classifyOperation(query) {
+        const trimmed = query.trim();
+        if (trimmed.length === 0) {
+            throw new Error("Empty MongoDB statement");
+        }
+        let op = null;
+        // Envelope form: {"collection": "...", "op": "..."}
+        if (trimmed.startsWith("{")) {
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (typeof parsed.op === "string")
+                    op = parsed.op;
+            }
+            catch {
+                /* fall through to dot-notation parse */
+            }
+        }
+        // Dot-notation form: db.<collection>.<verb>(...)
+        if (op === null) {
+            const match = /(?:^|\.)([A-Za-z][A-Za-z0-9_]*)\s*\(/.exec(trimmed);
+            if (match !== null)
+                op = match[1] ?? null;
+        }
+        if (op === null)
+            return OperationType.ADMIN;
+        if (_MONGO_READ_OPS.has(op))
+            return OperationType.READ;
+        if (_MONGO_WRITE_OPS.has(op))
+            return OperationType.WRITE;
+        if (_MONGO_DELETE_OPS.has(op))
+            return OperationType.DELETE;
+        if (_MONGO_ADMIN_OPS.has(op))
+            return OperationType.ADMIN;
+        return OperationType.ADMIN;
+    }
+    /** Close the shared MongoClient. */
+    async shutdown() {
+        const client = this._client;
+        this._client = null;
+        this._clientPromise = null;
+        if (client !== null) {
+            try {
+                await client.close();
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function _buildUri(envConfig) {
+    const host = typeof envConfig["host"] === "string" ? envConfig["host"] : "localhost";
+    const port = typeof envConfig["port"] === "number" ? envConfig["port"] : 27017;
+    const user = typeof envConfig["user"] === "string" ? envConfig["user"] : "";
+    const password = typeof envConfig["password"] === "string" ? envConfig["password"] : "";
+    const authPart = user.length > 0 && password.length > 0
+        ? `${encodeURIComponent(user)}:${encodeURIComponent(password)}@`
+        : "";
+    return `mongodb://${authPart}${host}:${port}`;
+}
+function _parseEnvelope(query) {
+    try {
+        const parsed = JSON.parse(query);
+        if (parsed === null ||
+            typeof parsed !== "object" ||
+            typeof parsed.collection !== "string" ||
+            typeof parsed.op !== "string") {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function _mongoType(v) {
+    if (v === null)
+        return "null";
+    if (Array.isArray(v))
+        return "array";
+    const t = typeof v;
+    if (t === "object") {
+        const ctor = v?.constructor?.name;
+        if (ctor === "ObjectId")
+            return "objectId";
+        if (ctor === "Date")
+            return "date";
+        return "object";
+    }
+    return t;
+}
+function _inferColumns(rows) {
+    const seen = new Set();
+    for (const r of rows)
+        for (const k of Object.keys(r))
+            seen.add(k);
+    return [...seen];
+}
+function roundTo2(n) {
+    return Math.round(n * 100) / 100;
+}
+//# sourceMappingURL=mongodb.js.map

package/dist/connectors/db/lib/drivers/mongodb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb.js","sourceRoot":"","sources":["../../../../../src/connectors/db/lib/drivers/mongodb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EACL,MAAM,EACN,cAAc,EACd,KAAK,GAEN,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC;IACnD,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB;IACzD,wBAAwB,EAAE,UAAU;CACrC,CAAC,CAAC;AACH,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IACpD,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY;IACpD,YAAY,EAAE,WAAW;IACzB,kBAAkB,EAAE,mBAAmB;CACxC,CAAC,CAAC;AACH,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAC;IACrD,WAAW,EAAE,YAAY,EAAE,kBAAkB;CAC9C,CAAC,CAAC;AACH,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IACpD,kBAAkB,EAAE,MAAM,EAAE,gBAAgB,EAAE,kBAAkB;IAChE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa;CAC3D,CAAC,CAAC;AAuDH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAW9D,MAAM,OAAO,WAAY,SAAQ,cAAc;IACrC,YAAY,GAAuB,IAAI,CAAC;IACxC,OAAO,GAAuB,IAAI,CAAC;IACnC,cAAc,GAAgC,IAAI,CAAC;IACnD,SAAS,GAAG,EAAE,CAAC;IAEf,KAAK,CAAC,UAAU;QACtB,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,YAAY,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAER,CAAC;YAC7B,IAAI,CAAC,YAAY;gBACf,aAAa,IAAK,GAAc;oBAC9B,CAAC,CAAE,GAAmB;oBACtB,CAAC,CAAE,GAAgC,CAAC,OAAO,CAAC;YAChD,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,mEACG,CAAW,CAAC,OACf,GAAG,CACJ,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,aAAa,CACnB,SAAkC;QAElC,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChE,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7D,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC3D,MAAM,GAAG,GACP,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ;gBAClC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;gBAClB,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAC3B,IAAI,CAAC,SAAS;gBACZ,OAAO,SAAS,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,GAA4B;gBACpC,cAAc,EAAE,oBAAoB;gBACpC,WAAW,EACT,OAAO,SAAS,CAAC,UAAU,CAAC,KAAK,QAAQ;oBACvC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC;oBACvB,CAAC,CAAC,EAAE;aACT,CAAC;YACF,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAChD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;YACtB,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAEQ,OAAO,CAAC,SAAkC;QACjD,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACnD,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC7E,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAwB,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC;IAEQ,WAAW,CAClB,KAAc,EACd,MAAc,EACd,UAA4B,IAAI,EAChC,WAAmB,IAAI,EACvB,aAAqB,MAAM;QAE3B,OAAO;YACL,MAAM,EAAE,OAAO;YACf,UAAU,EAAE,kBAAkB;YAC9B,KAAK,EACH,qEAAqE;YACvE,iBAAiB,EAAE,CAAC;SACrB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,IAAa,EACb,KAAa,EACb,UAA4B,IAAI,EAChC,UAAkB,IAAI,EACtB,aAAqB,MAAM;QAE3B,MAAM,MAAM,GAAG,CAAC,MAAO,IAA2C,CAAgB,CAAC;QACnF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjB,OAAO;oBACL,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,WAAW;oBACvB,KAAK,EACH,kEAAkE;oBACpE,iBAAiB,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;iBACvD,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC/B,OAAO;oBACL,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,WAAW;oBACvB,KAAK,EAAE,kBAAkB,GAAG,CAAC,EAAE,gCAAgC,CAAC,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBAC/F,iBAAiB,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;iBACvD,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAElD,IAAI,GAAG,CAAC,EAAE,KAAK,OAAO,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;gBAC1D,OAAO;oBACL,MAAM,EAAE,SAAS;oBACjB,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;oBACxB,SAAS,EAAE,CAAC;oBACZ,OAAO,EAAE,CAAC,OAAO,CAAC;oBAClB,iBAAiB,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;oBACtD,SAAS,EAAE,KAAK;iBACjB,CAAC;YACJ,CAAC;YAED,IAAI,MAA4C,CAAC;YACjD,IAAI,GAAG,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;gBACtB,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;gBACrC,IAAI,GAAG,CAAC,UAAU;oBAAE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC5D,IAAI,GAAG,CAAC,IAAI;oBAAE,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC7C,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;gBACpC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;oBACtB,GAAG,QAAQ;oBACX,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,EAA6B;iBACnD,CAAC,CAAC;YACL,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,IAAI,IAAI,GAAG,IAAI,CAAC;YAChB,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;gBAC1B,SAAS,GAAG,IAAI,CAAC;gBACjB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAChC,CAAC;YAED,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,IAAI;gBACJ,SAAS,EAAE,IAAI,CAAC,MAAM;gBACtB,OAAO;gBACP,iBAAiB,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;gBACtD,SAAS;aACV,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE,WAAW;gBACvB,KAAK,EAAG,CAAW,CAAC,OAAO;gBAC3B,iBAAiB,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;aACvD,CAAC;QACJ,CAAC;IACH,CAAC;IAEQ,SAAS,CAChB,KAAc,EACd,cAAsB,EAAE,EACxB,eAA8B,IAAI;QAElC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,IAAa,EACb,aAAqB,EAAE,EACvB,cAA6B,IAAI;QAEjC,MAAM,MAAM,GAAG,CAAC,MAAO,IAA2C,CAAgB,CAAC;QACnF,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,CAAC;YAC1D,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;gBAClC,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS;oBAAE,OAAO,IAAI,CAAC;gBACnE,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,GAAG;oBACD,WAAW,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;oBACpE,GAAG,CACN,CAAC;gBACF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;YAEH,wEAAwE;YACxE,qEAAqE;YACrE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACjB,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAC9D,CACF,CAAC;YAEF,MAAM,GAAG,GAAY,EAAE,CAAC;YACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;gBAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;oBACzB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;wBACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;4BAChE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBACtC,CAAC;6BAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;4BAC5B,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;wBAC1B,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,MAAM,OAAO,GAAa,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CACnD,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CACf,IAAI,MAAM,CAAC;oBACT,IAAI;oBACJ,SAAS,EAAE,IAAI;oBACf,QAAQ,EAAE,IAAI,KAAK,KAAK;oBACxB,cAAc,EAAE,IAAI,KAAK,KAAK;oBAC9B,OAAO,EAAE,IAAI;iBACd,CAAC,CACL,CAAC;gBACF,GAAG,CAAC,IAAI,CACN,IAAI,KAAK,CAAC;oBACR,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ;oBAC5D,OAAO;iBACR,CAAC,CACH,CAAC;YACJ,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;OAGG;IACM,KAAK,CAAC,KAAc;QAC3B,oDAAoD;IACtD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAc;QAC7B,oDAAoD;IACtD,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,WAAW,CAAC,IAAa;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,CAAC,MAAO,IAA2C,CAAgB,CAAC;YACnF,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACjD,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACM,iBAAiB,CAAC,KAAa;QACtC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,EAAE,GAAkB,IAAI,CAAC;QAE7B,oDAAoD;QACpD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB,CAAC;gBACvD,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;oBAAE,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,wCAAwC;YAC1C,CAAC;QACH,CAAC;QAED,iDAAiD;QACjD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,sCAAsC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnE,IAAI,KAAK,KAAK,IAAI;gBAAE,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC5C,CAAC;QAED,IAAI,EAAE,KAAK,IAAI;YAAE,OAAO,aAAa,CAAC,KAAK,CAAC;QAE5C,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,aAAa,CAAC,IAAI,CAAC;QACvD,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,aAAa,CAAC,KAAK,CAAC;QACzD,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,aAAa,CAAC,MAAM,CAAC;QAC3D,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,aAAa,CAAC,KAAK,CAAC;QACzD,OAAO,aAAa,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,QAAQ;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,SAAS,CAAC,SAAkC;IACnD,MAAM,IAAI,GACR,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IAC1E,MAAM,IAAI,GACR,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACpE,MAAM,IAAI,GAAG,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,QAAQ,GACZ,OAAO,SAAS,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,QAAQ,GACZ,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QACpC,CAAC,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,GAAG;QAChE,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,aAAa,QAAQ,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAC;QAC5C,IACE,MAAM,KAAK,IAAI;YACf,OAAO,MAAM,KAAK,QAAQ;YAC1B,OAAQ,MAA6B,CAAC,UAAU,KAAK,QAAQ;YAC7D,OAAQ,MAA6B,CAAC,EAAE,KAAK,QAAQ,EACrD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,MAA4B,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,CAAU;IAC5B,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IACrC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC;IACnB,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnB,MAAM,IAAI,GAAI,CAAyC,EAAE,WAAW,EAAE,IAAI,CAAC;QAC3E,IAAI,IAAI,KAAK,UAAU;YAAE,OAAO,UAAU,CAAC;QAC3C,IAAI,IAAI,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC;QACnC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,aAAa,CAAC,IAA+B;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACnC,CAAC"}

package/dist/connectors/db/lib/drivers/mysql.d.ts

@@ -0,0 +1,45 @@
+import { DatabaseDriver, Table, type ExecuteReadResult } from "./base.js";
+import { type OperationType } from "../policy.js";
+interface MysqlFieldPacket {
+    name: string;
+    columnType?: number;
+}
+type MysqlQueryResult = [
+    Record<string, unknown>[] | Record<string, unknown>,
+    MysqlFieldPacket[] | undefined
+];
+interface MysqlConnection {
+    query(sql: string, params?: unknown[]): Promise<MysqlQueryResult>;
+    execute(sql: string, params?: unknown[]): Promise<MysqlQueryResult>;
+    release(): void;
+    beginTransaction(): Promise<void>;
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+}
+interface MysqlHandle {
+    client: MysqlConnection;
+    database: string;
+}
+export declare class MysqlDriver extends DatabaseDriver {
+    private _mysqlModule;
+    private _pool;
+    private _poolPromise;
+    private _database;
+    private _loadMysql;
+    private _ensurePool;
+    connect(envConfig: Record<string, unknown>): Promise<MysqlHandle>;
+    executeRead(_conn: unknown, _query: string, _params?: unknown[] | null, _maxRows?: number, _timeoutMs?: number): ExecuteReadResult;
+    executeReadAsync(conn: unknown, query: string, params?: unknown[] | null, maxRows?: number, timeoutMs?: number): Promise<ExecuteReadResult>;
+    getSchema(_conn: unknown, _schemaName?: string, _tableFilter?: string | null): Table[];
+    getSchemaAsync(conn: unknown, schemaName?: string, tableFilter?: string | null): Promise<Table[]>;
+    /** Release the checked-out client back to the pool. */
+    close(conn: unknown): void;
+    classifyOperation(query: string): OperationType;
+    closeAsync(conn: unknown): Promise<void>;
+    /** Per-driver health check. Runs `SELECT 1` on the handle. */
+    healthCheck(conn: unknown): Promise<boolean>;
+    /** Drain and destroy the pool. */
+    shutdown(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=mysql.d.ts.map

package/dist/connectors/db/lib/drivers/mysql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/db/lib/drivers/mysql.ts"],"names":[],"mappings":"AAgBA,OAAO,EAEL,cAAc,EACd,KAAK,EACL,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAMvE,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,KAAK,gBAAgB,GAAG;IACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,gBAAgB,EAAE,GAAG,SAAS;CAC/B,CAAC;AACF,UAAU,eAAe;IACvB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpE,OAAO,IAAI,IAAI,CAAC;IAChB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAcD,UAAU,WAAW;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAY,SAAQ,cAAc;IAC7C,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,SAAS,CAAM;YAET,UAAU;IAoBxB,OAAO,CAAC,WAAW;IA6CV,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAOjE,WAAW,CAClB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAAO,EAAE,GAAG,IAAW,EAChC,QAAQ,GAAE,MAAa,EACvB,UAAU,GAAE,MAAe,GAC1B,iBAAiB;IAUd,gBAAgB,CACpB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,OAAO,EAAE,GAAG,IAAW,EAC/B,OAAO,GAAE,MAAa,EACtB,SAAS,GAAE,MAAe,GACzB,OAAO,CAAC,iBAAiB,CAAC;IAwDpB,SAAS,CAChB,KAAK,EAAE,OAAO,EACd,WAAW,GAAE,MAAW,EACxB,YAAY,GAAE,MAAM,GAAG,IAAW,GACjC,KAAK,EAAE;IAIJ,cAAc,CAClB,IAAI,EAAE,OAAO,EACb,UAAU,GAAE,MAAW,EACvB,WAAW,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,KAAK,EAAE,CAAC;IAoFnB,uDAAuD;IAC9C,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAgB1B,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IAIlD,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C,8DAA8D;IACxD,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAUlD,kCAAkC;IAC5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAYhC"}