narai-primitives 2.0.0-rc.1

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

@@ -0,0 +1,265 @@
+/**
+ * drivers/mysql.ts — MySQL driver via `mysql2/promise`.
+ *
+ * Design:
+ *  - The driver owns a `mysql2 Pool` lazily created on the first
+ *    `connect()` call and cached for the lifetime of the driver
+ *    instance. Each `connect()` checks out a connection from the pool
+ *    (`pool.getConnection()`); `close()` releases it back.
+ *  - `shutdown()` drains the pool. connection.ts calls `shutdown()` on
+ *    each driver at process teardown.
+ *  - Read-only: every `executeReadAsync` sets the session to
+ *    `TRANSACTION READ ONLY` with a server-side `MAX_EXECUTION_TIME`.
+ *  - `mysql2` is loaded via dynamic `import()`; a missing install throws
+ *    a clear `npm install mysql2` hint.
+ */
+import { performance } from "node:perf_hooks";
+import { Column, DatabaseDriver, Table, } from "./base.js";
+import { classifySqlKeywords } from "../policy.js";
+export class MysqlDriver extends DatabaseDriver {
+    _mysqlModule = null;
+    _pool = null;
+    _poolPromise = null;
+    _database = "";
+    async _loadMysql() {
+        if (this._mysqlModule !== null)
+            return this._mysqlModule;
+        try {
+            const mod = (await import("mysql2/promise"));
+            this._mysqlModule =
+                "createPool" in mod
+                    ? mod
+                    : mod.default;
+            return this._mysqlModule;
+        }
+        catch (e) {
+            throw new Error(`Driver 'mysql' requires 'mysql2' — run: npm install mysql2 (${e.message})`);
+        }
+    }
+    _ensurePool(envConfig) {
+        if (this._pool !== null)
+            return Promise.resolve(this._pool);
+        if (this._poolPromise !== null)
+            return this._poolPromise;
+        this._poolPromise = this._loadMysql().then((mysql) => {
+            const host = typeof envConfig["host"] === "string" ? envConfig["host"] : "localhost";
+            const port = typeof envConfig["port"] === "number" ? envConfig["port"] : 3306;
+            this._database =
+                typeof envConfig["database"] === "string" ? envConfig["database"] : "";
+            const user = typeof envConfig["user"] === "string" ? envConfig["user"] : undefined;
+            const password = typeof envConfig["password"] === "string"
+                ? envConfig["password"]
+                : undefined;
+            const ssl = envConfig["ssl"] === true
+                ? { rejectUnauthorized: false }
+                : typeof envConfig["ssl"] === "object" && envConfig["ssl"] !== null
+                    ? envConfig["ssl"]
+                    : undefined;
+            const poolConfig = {
+                host,
+                port,
+                database: this._database,
+                waitForConnections: true,
+                connectionLimit: typeof envConfig["pool_max"] === "number"
+                    ? envConfig["pool_max"]
+                    : 10,
+                supportBigNumbers: true,
+            };
+            if (user !== undefined)
+                poolConfig["user"] = user;
+            if (password !== undefined)
+                poolConfig["password"] = password;
+            if (ssl !== undefined)
+                poolConfig["ssl"] = ssl;
+            const pool = mysql.createPool(poolConfig);
+            this._pool = pool;
+            return pool;
+        });
+        return this._poolPromise;
+    }
+    connect(envConfig) {
+        return this._ensurePool(envConfig).then(async (pool) => {
+            const client = await pool.getConnection();
+            return { client, database: this._database };
+        });
+    }
+    executeRead(_conn, _query, _params = null, _maxRows = 1000, _timeoutMs = 30_000) {
+        return {
+            status: "error",
+            error_code: "SYNC_UNSUPPORTED",
+            error: "MysqlDriver.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 {
+            await handle.client.query("SET SESSION TRANSACTION READ ONLY");
+            await handle.client.query(`SET SESSION MAX_EXECUTION_TIME=${Math.max(1, timeoutMs)}`);
+            await handle.client.beginTransaction();
+            // G-LIMIT-WRAP: wrap as a subquery so bounded semantics hold even
+            // when the outer query has a trailing `-- limit` comment, a CTE
+            // with its own LIMIT, or a LIMIT on an inner SELECT that the old
+            // substring check mistook for the bound.
+            const inner = query.trim().replace(/;\s*$/, "");
+            const limited = `SELECT * FROM (${inner}) AS _limited LIMIT ${maxRows + 1}`;
+            const [rawRows, fields] = await handle.client.query(limited, params ?? []);
+            await handle.client.commit();
+            const rowsArr = Array.isArray(rawRows)
+                ? rawRows
+                : [];
+            let truncated = false;
+            let rows = rowsArr;
+            if (rows.length > maxRows) {
+                truncated = true;
+                rows = rows.slice(0, maxRows);
+            }
+            return {
+                status: "success",
+                rows,
+                row_count: rows.length,
+                columns: (fields ?? []).map((f) => f.name),
+                execution_time_ms: roundTo2(performance.now() - start),
+                truncated,
+            };
+        }
+        catch (e) {
+            try {
+                await handle.client.rollback();
+            }
+            catch {
+                /* best-effort */
+            }
+            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);
+        const ns = schemaName.length > 0 ? schemaName : handle.database;
+        try {
+            const tableParams = [ns];
+            let tableSql = "SELECT table_name FROM information_schema.tables " +
+                "WHERE table_schema = ? AND table_type = 'BASE TABLE'";
+            if (tableFilter !== null && tableFilter !== undefined) {
+                tableSql += " AND table_name LIKE ? ESCAPE '!'";
+                tableParams.push(tableFilter.replace(/[!_%]/g, "!$&"));
+            }
+            tableSql += " ORDER BY table_name";
+            const [tablesRaw] = await handle.client.query(tableSql, tableParams);
+            const tablesRows = Array.isArray(tablesRaw)
+                ? tablesRaw
+                : [];
+            const tableNames = tablesRows.map((r) => String(r["table_name"] ?? r["TABLE_NAME"]));
+            if (tableNames.length === 0)
+                return [];
+            // G-SCHEMA-BATCH: fold per-table column queries into one set-based
+            // query using `WHERE TABLE_NAME IN (?, ?, …)`. MySQL exposes PK
+            // membership as `COLUMN_KEY = 'PRI'` on the columns row so we do
+            // not need a separate PK query. For N tables we drop from N+1
+            // round-trips to 2.
+            const placeholders = tableNames.map(() => "?").join(", ");
+            const [colsRaw] = await handle.client.query("SELECT table_name, column_name, data_type, is_nullable, column_default, column_key, ordinal_position " +
+                "FROM information_schema.columns " +
+                `WHERE table_schema = ? AND table_name IN (${placeholders}) ` +
+                "ORDER BY table_name, ordinal_position", [ns, ...tableNames]);
+            const colsRows = Array.isArray(colsRaw)
+                ? colsRaw
+                : [];
+            const colsByTable = new Map();
+            for (const r of colsRows) {
+                const t = String(r["table_name"] ?? r["TABLE_NAME"]);
+                let list = colsByTable.get(t);
+                if (list === undefined) {
+                    list = [];
+                    colsByTable.set(t, list);
+                }
+                list.push(new Column({
+                    name: String(r["column_name"] ?? r["COLUMN_NAME"]),
+                    data_type: String(r["data_type"] ?? r["DATA_TYPE"]),
+                    nullable: String(r["is_nullable"] ?? r["IS_NULLABLE"]).toUpperCase() ===
+                        "YES",
+                    is_primary_key: String(r["column_key"] ?? r["COLUMN_KEY"]).toUpperCase() ===
+                        "PRI",
+                    default: (r["column_default"] ?? r["COLUMN_DEFAULT"]) === null ||
+                        (r["column_default"] ?? r["COLUMN_DEFAULT"]) === undefined
+                        ? null
+                        : String(r["column_default"] ?? r["COLUMN_DEFAULT"]),
+                }));
+            }
+            const out = [];
+            for (const tableName of tableNames) {
+                out.push(new Table({
+                    name: tableName,
+                    schema: ns,
+                    columns: colsByTable.get(tableName) ?? [],
+                }));
+            }
+            return out;
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Release the checked-out client back to the pool. */
+    close(conn) {
+        Promise.resolve(conn)
+            .then((h) => h.client.release())
+            .catch((e) => {
+            // G-CLOSE-LOG: surface release errors on stderr instead of
+            // swallowing them. close() is called from sync cleanup paths
+            // so we cannot await; keep it fire-and-forget but at least
+            // give an operator something to grep for in a misbehaving run.
+            process.stderr.write(`[mysql] release error (best-effort): ${e instanceof Error ? e.message : String(e)}\n`);
+        });
+    }
+    classifyOperation(query) {
+        return classifySqlKeywords(query);
+    }
+    async closeAsync(conn) {
+        const handle = (await conn);
+        try {
+            handle.client.release();
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    /** Per-driver health check. Runs `SELECT 1` on the handle. */
+    async healthCheck(conn) {
+        try {
+            const handle = (await conn);
+            const [rows] = await handle.client.query("SELECT 1");
+            return Array.isArray(rows);
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Drain and destroy the pool. */
+    async shutdown() {
+        const pool = this._pool;
+        this._pool = null;
+        this._poolPromise = null;
+        if (pool !== null) {
+            try {
+                await pool.end();
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+    }
+}
+function roundTo2(n) {
+    return Math.round(n * 100) / 100;
+}
+//# sourceMappingURL=mysql.js.map

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

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

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

@@ -0,0 +1,53 @@
+import { DatabaseDriver, Table, type ExecuteReadResult } from "./base.js";
+import { type OperationType } from "../policy.js";
+interface OracleExecuteResult {
+    rows?: Record<string, unknown>[];
+    metaData?: Array<{
+        name: string;
+    }>;
+    rowsAffected?: number;
+}
+interface OracleConnection {
+    execute(sql: string, params?: unknown, options?: Record<string, unknown>): Promise<OracleExecuteResult>;
+    close(): Promise<void>;
+    callTimeout: number;
+}
+interface OracleHandle {
+    connection: OracleConnection;
+    schema: string | null;
+}
+export declare class OracleDriver extends DatabaseDriver {
+    private _oracleModule;
+    private _pool;
+    private _schema;
+    private _poolPromise;
+    private _loadOracle;
+    /**
+     * Options passed to every read-path `connection.execute()` — returns
+     * rows as `Record<string, unknown>[]` (matching PG/MySQL driver shape).
+     * Requires `_loadOracle()` to have populated `_oracleModule` first.
+     */
+    private _readOpts;
+    /**
+     * Build the pool on first call; subsequent callers receive the cached
+     * instance (or await the in-flight creation promise to avoid racing two
+     * `createPool()` calls on concurrent connects).
+     */
+    private _ensurePool;
+    connect(envConfig: Record<string, unknown>): Promise<OracleHandle>;
+    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 connection back to the pool. Does NOT destroy
+     * the pool — use {@link shutdown} for that.
+     */
+    close(conn: unknown): void;
+    classifyOperation(query: string): OperationType;
+    closeAsync(conn: unknown): Promise<void>;
+    healthCheck(conn: unknown): Promise<boolean>;
+    shutdown(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=oracle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/db/lib/drivers/oracle.ts"],"names":[],"mappings":"AAmBA,OAAO,EAEL,cAAc,EACd,KAAK,EACL,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAMvE,UAAU,mBAAmB;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AACD,UAAU,gBAAgB;IACxB,OAAO,CACL,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAiBD,UAAU,YAAY;IACpB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,qBAAa,YAAa,SAAQ,cAAc;IAC9C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,YAAY,CAAoC;YAE1C,WAAW;IA0BzB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAIjB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAiEV,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAOlE,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;IAwFpB,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;IA2HnB;;;OAGG;IACM,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAY1B,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IAIlD,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxC,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB5C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAYhC"}