@uns-kit/database 2.0.46

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Aljoša Vister
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# @uns-kit/database
+
+Database helpers for UNS services. The package keeps database access outside `@uns-kit/core` while still fitting the same config/secret-resolution flow used by the rest of `uns-kit`.
+
+## Installation
+
+Install the package plus only the driver(s) you need:
+
+```bash
+pnpm add @uns-kit/database pg
+# or
+pnpm add @uns-kit/database better-sqlite3
+# or
+pnpm add @uns-kit/database oracledb
+```
+
+`pnpm add @uns-kit/database pg` is the intended one-command install pattern for Postgres support. Replace `pg` with `oracledb` or `better-sqlite3` for the other drivers.
+
+## What it provides
+
+- Driver-aware client factory for `pg`, `sqlite`, and `oracle`
+- One portable SQL parameter style for all drivers: write SQL with `:namedParams`
+- Shared database manager for multiple named connections
+- SQL file loading from a configured `sqlDir`
+- Zod schemas for app-level `databases` config extensions
+
+## Config schema integration
+
+Inside your app's `src/config/project.config.extension.ts`:
+
+```ts
+import { z } from "zod";
+import { databasesConfigSchema } from "@uns-kit/database";
+
+export const projectExtrasSchema = z.object({
+  databases: databasesConfigSchema,
+});
+```
+
+The schema uses the same placeholder object shapes as `@uns-kit/core`, so `ConfigFile.loadConfig()` resolves database secrets automatically.
+
+## Example config
+
+```json
+{
+  "databases": {
+    "main": {
+      "dialect": "pg",
+      "host": { "provider": "external", "key": "PG_HOST" },
+      "port": 5432,
+      "database": "factory",
+      "user": "app_user",
+      "password": { "provider": "env", "key": "PG_PASSWORD" },
+      "usePool": true,
+      "sqlDir": "./sql"
+    }
+  }
+}
+```
+
+Set `"usePool": false` for Postgres or Oracle when you want a direct non-pooled connection, matching the old local proxy behavior.
+
+## Usage
+
+```ts
+import { ConfigFile } from "@uns-kit/core";
+import { registerDatabase } from "@uns-kit/database";
+
+const config = await ConfigFile.loadConfig();
+registerDatabase("main", config.databases.main);
+registerDatabase("reporting", config.databases.reporting);
+registerDatabase("mesOracle", config.databases.mesOracle);
+```
+
+Then in another file:
+
+```ts
+import { getDatabase } from "@uns-kit/database";
+
+const db = await getDatabase("main");
+const rows = await db.queryFile("queries/get-orders.sql", {
+  lineId: "L1",
+  fromTs: "2026-05-20T08:00:00Z",
+});
+```
+
+Use `:lineId`, `:fromTs`, etc. in SQL files. The package compiles them to `$1`, `?`, or Oracle bind syntax depending on the selected driver. The authoring style stays the same for all supported databases: plain SQL plus `:namedParam` bindings.
+
+See also:
+- [`examples/app-startup.ts`](D:/projects/uns-kit/packages/uns-database/examples/app-startup.ts)
+- [`examples/orders-service.ts`](D:/projects/uns-kit/packages/uns-database/examples/orders-service.ts)

package/dist/client.d.ts

@@ -0,0 +1,19 @@
+import type { DatabaseConnectionConfig } from "./schema.js";
+import type { DatabaseClient } from "./types.js";
+export declare function createDatabaseClient(config: DatabaseConnectionConfig, options?: {
+    name?: string;
+}): Promise<DatabaseClient>;
+export declare class DatabaseManager {
+    private readonly configs;
+    private readonly clients;
+    register(name: string, config: DatabaseConnectionConfig): this;
+    has(name: string): boolean;
+    getNames(): string[];
+    get(name: string): Promise<DatabaseClient>;
+    close(name: string): Promise<void>;
+    closeAll(): Promise<void>;
+}
+export declare function registerDatabase(name: string, config: DatabaseConnectionConfig): DatabaseManager;
+export declare function getDatabaseManager(): DatabaseManager;
+export declare function getDatabase(name: string): Promise<DatabaseClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAG5D,OAAO,KAAK,EAEV,cAAc,EAIf,MAAM,YAAY,CAAC;AAyDpB,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,wBAAwB,EAChC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,OAAO,CAAC,cAAc,CAAC,CAmBzB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+C;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IAEtE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,GAAG,IAAI;IAgB9D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,QAAQ,IAAI,MAAM,EAAE;IAId,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAsB1C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC;AAID,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,GAAG,eAAe,CAEhG;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAEjE"}

package/dist/client.js

@@ -0,0 +1,120 @@
+import path from "node:path";
+import logger from "@uns-kit/core/logger.js";
+import { compileNamedParams } from "./params.js";
+import { loadSqlFile } from "./sql.js";
+import { createPgAdapter } from "./drivers/pg.js";
+import { createSqliteAdapter } from "./drivers/sqlite.js";
+import { createOracleAdapter } from "./drivers/oracle.js";
+class DatabaseClientImpl {
+    adapter;
+    dialect;
+    name;
+    sqlDir;
+    constructor(adapter, name, sqlDir) {
+        this.adapter = adapter;
+        this.dialect = adapter.dialect;
+        this.name = name;
+        this.sqlDir = sqlDir;
+    }
+    async query(sqlText, params = {}) {
+        const statement = compileNamedParams(this.dialect, sqlText, params);
+        return this.adapter.query(statement);
+    }
+    async execute(sqlText, params = {}) {
+        const statement = compileNamedParams(this.dialect, sqlText, params);
+        return this.adapter.execute(statement);
+    }
+    async queryFile(filePath, params = {}) {
+        const sqlText = await loadSqlFile(filePath, { baseDir: this.sqlDir });
+        return this.query(sqlText, params);
+    }
+    async executeFile(filePath, params = {}) {
+        const sqlText = await loadSqlFile(filePath, { baseDir: this.sqlDir });
+        return this.execute(sqlText, params);
+    }
+    async close() {
+        await this.adapter.close();
+    }
+}
+export async function createDatabaseClient(config, options = {}) {
+    const sqlDir = config.sqlDir
+        ? path.resolve(process.cwd(), config.sqlDir)
+        : undefined;
+    logger.info(`uns-database - Creating database client: ${options.name ?? "unnamed"} (${config.dialect}, pool=${config.dialect === "sqlite" ? "n/a" : config.usePool !== false})`);
+    switch (config.dialect) {
+        case "pg":
+            return new DatabaseClientImpl(await createPgAdapter(config), options.name, sqlDir);
+        case "sqlite":
+            return new DatabaseClientImpl(await createSqliteAdapter(config), options.name, sqlDir);
+        case "oracle":
+            return new DatabaseClientImpl(await createOracleAdapter(config), options.name, sqlDir);
+    }
+    throw new Error(`Unsupported database dialect: ${String(config.dialect)}`);
+}
+export class DatabaseManager {
+    configs = new Map();
+    clients = new Map();
+    register(name, config) {
+        const hadExistingConfig = this.configs.has(name);
+        const hadExistingClient = this.clients.has(name);
+        this.configs.set(name, config);
+        this.clients.delete(name);
+        logger.info(hadExistingConfig
+            ? `uns-database - Re-registered database: ${name} (${config.dialect}, pool=${config.dialect === "sqlite" ? "n/a" : config.usePool !== false}, replacedClient=${hadExistingClient})`
+            : `uns-database - Registered database: ${name} (${config.dialect}, pool=${config.dialect === "sqlite" ? "n/a" : config.usePool !== false})`);
+        return this;
+    }
+    has(name) {
+        return this.configs.has(name);
+    }
+    getNames() {
+        return Array.from(this.configs.keys());
+    }
+    async get(name) {
+        const existing = this.clients.get(name);
+        if (existing) {
+            logger.info(`uns-database - Reusing cached database client: ${name}`);
+            return existing;
+        }
+        const config = this.configs.get(name);
+        if (!config) {
+            throw new Error(`Database connection '${name}' is not configured.`);
+        }
+        const clientPromise = createDatabaseClient(config, { name }).catch((error) => {
+            this.clients.delete(name);
+            logger.error(`uns-database - Database client initialization failed: ${name}`, error);
+            throw error;
+        });
+        this.clients.set(name, clientPromise);
+        logger.info(`uns-database - Initialized database client cache entry: ${name} (${config.dialect})`);
+        return clientPromise;
+    }
+    async close(name) {
+        const client = this.clients.get(name);
+        if (!client) {
+            logger.info(`uns-database - Close requested for database without active client: ${name}`);
+            return;
+        }
+        this.clients.delete(name);
+        await (await client).close();
+        logger.info(`uns-database - Closed database client: ${name}`);
+    }
+    async closeAll() {
+        const pendingClients = Array.from(this.clients.values());
+        const count = pendingClients.length;
+        this.clients.clear();
+        await Promise.all(pendingClients.map(async (client) => (await client).close()));
+        logger.info(`uns-database - Closed all database clients (${count})`);
+    }
+}
+const defaultDatabaseManager = new DatabaseManager();
+export function registerDatabase(name, config) {
+    return defaultDatabaseManager.register(name, config);
+}
+export function getDatabaseManager() {
+    return defaultDatabaseManager;
+}
+export function getDatabase(name) {
+    return defaultDatabaseManager.get(name);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"node:path\";\nimport logger from \"@uns-kit/core/logger.js\";\nimport type { DatabaseConnectionConfig } from \"./schema.js\";\nimport { compileNamedParams } from \"./params.js\";\nimport { loadSqlFile } from \"./sql.js\";\nimport type {\n  DatabaseAdapter,\n  DatabaseClient,\n  DatabaseExecuteResult,\n  DatabaseQueryResult,\n  SqlParams,\n} from \"./types.js\";\nimport { createPgAdapter } from \"./drivers/pg.js\";\nimport { createSqliteAdapter } from \"./drivers/sqlite.js\";\nimport { createOracleAdapter } from \"./drivers/oracle.js\";\n\nclass DatabaseClientImpl implements DatabaseClient {\n  readonly dialect;\n  readonly name?;\n  readonly sqlDir?;\n\n  constructor(\n    private readonly adapter: DatabaseAdapter,\n    name?: string,\n    sqlDir?: string\n  ) {\n    this.dialect = adapter.dialect;\n    this.name = name;\n    this.sqlDir = sqlDir;\n  }\n\n  async query<T = Record<string, unknown>>(\n    sqlText: string,\n    params: SqlParams = {}\n  ): Promise<DatabaseQueryResult<T>> {\n    const statement = compileNamedParams(this.dialect, sqlText, params);\n    return this.adapter.query<T>(statement);\n  }\n\n  async execute(\n    sqlText: string,\n    params: SqlParams = {}\n  ): Promise<DatabaseExecuteResult> {\n    const statement = compileNamedParams(this.dialect, sqlText, params);\n    return this.adapter.execute(statement);\n  }\n\n  async queryFile<T = Record<string, unknown>>(\n    filePath: string,\n    params: SqlParams = {}\n  ): Promise<DatabaseQueryResult<T>> {\n    const sqlText = await loadSqlFile(filePath, { baseDir: this.sqlDir });\n    return this.query<T>(sqlText, params);\n  }\n\n  async executeFile(\n    filePath: string,\n    params: SqlParams = {}\n  ): Promise<DatabaseExecuteResult> {\n    const sqlText = await loadSqlFile(filePath, { baseDir: this.sqlDir });\n    return this.execute(sqlText, params);\n  }\n\n  async close(): Promise<void> {\n    await this.adapter.close();\n  }\n}\n\nexport async function createDatabaseClient(\n  config: DatabaseConnectionConfig,\n  options: { name?: string } = {}\n): Promise<DatabaseClient> {\n  const sqlDir = config.sqlDir\n    ? path.resolve(process.cwd(), config.sqlDir)\n    : undefined;\n\n  logger.info(\n    `uns-database - Creating database client: ${options.name ?? \"unnamed\"} (${config.dialect}, pool=${config.dialect === \"sqlite\" ? \"n/a\" : config.usePool !== false})`\n  );\n\n  switch (config.dialect) {\n    case \"pg\":\n      return new DatabaseClientImpl(await createPgAdapter(config), options.name, sqlDir);\n    case \"sqlite\":\n      return new DatabaseClientImpl(await createSqliteAdapter(config), options.name, sqlDir);\n    case \"oracle\":\n      return new DatabaseClientImpl(await createOracleAdapter(config), options.name, sqlDir);\n  }\n\n  throw new Error(`Unsupported database dialect: ${String((config as { dialect?: string }).dialect)}`);\n}\n\nexport class DatabaseManager {\n  private readonly configs = new Map<string, DatabaseConnectionConfig>();\n  private readonly clients = new Map<string, Promise<DatabaseClient>>();\n\n  register(name: string, config: DatabaseConnectionConfig): this {\n    const hadExistingConfig = this.configs.has(name);\n    const hadExistingClient = this.clients.has(name);\n\n    this.configs.set(name, config);\n    this.clients.delete(name);\n\n    logger.info(\n      hadExistingConfig\n        ? `uns-database - Re-registered database: ${name} (${config.dialect}, pool=${config.dialect === \"sqlite\" ? \"n/a\" : config.usePool !== false}, replacedClient=${hadExistingClient})`\n        : `uns-database - Registered database: ${name} (${config.dialect}, pool=${config.dialect === \"sqlite\" ? \"n/a\" : config.usePool !== false})`\n    );\n\n    return this;\n  }\n\n  has(name: string): boolean {\n    return this.configs.has(name);\n  }\n\n  getNames(): string[] {\n    return Array.from(this.configs.keys());\n  }\n\n  async get(name: string): Promise<DatabaseClient> {\n    const existing = this.clients.get(name);\n    if (existing) {\n      logger.info(`uns-database - Reusing cached database client: ${name}`);\n      return existing;\n    }\n\n    const config = this.configs.get(name);\n    if (!config) {\n      throw new Error(`Database connection '${name}' is not configured.`);\n    }\n\n    const clientPromise = createDatabaseClient(config, { name }).catch((error) => {\n      this.clients.delete(name);\n      logger.error(`uns-database - Database client initialization failed: ${name}`, error);\n      throw error;\n    });\n    this.clients.set(name, clientPromise);\n    logger.info(`uns-database - Initialized database client cache entry: ${name} (${config.dialect})`);\n    return clientPromise;\n  }\n\n  async close(name: string): Promise<void> {\n    const client = this.clients.get(name);\n    if (!client) {\n      logger.info(`uns-database - Close requested for database without active client: ${name}`);\n      return;\n    }\n\n    this.clients.delete(name);\n    await (await client).close();\n    logger.info(`uns-database - Closed database client: ${name}`);\n  }\n\n  async closeAll(): Promise<void> {\n    const pendingClients = Array.from(this.clients.values());\n    const count = pendingClients.length;\n    this.clients.clear();\n    await Promise.all(pendingClients.map(async client => (await client).close()));\n    logger.info(`uns-database - Closed all database clients (${count})`);\n  }\n}\n\nconst defaultDatabaseManager = new DatabaseManager();\n\nexport function registerDatabase(name: string, config: DatabaseConnectionConfig): DatabaseManager {\n  return defaultDatabaseManager.register(name, config);\n}\n\nexport function getDatabaseManager(): DatabaseManager {\n  return defaultDatabaseManager;\n}\n\nexport function getDatabase(name: string): Promise<DatabaseClient> {\n  return defaultDatabaseManager.get(name);\n}\n"]}

package/dist/drivers/oracle.d.ts

@@ -0,0 +1,4 @@
+import type { DatabaseAdapter } from "../types.js";
+import type { OracleDatabaseConfig } from "../schema.js";
+export declare function createOracleAdapter(config: OracleDatabaseConfig): Promise<DatabaseAdapter>;
+//# sourceMappingURL=oracle.d.ts.map

package/dist/drivers/oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/drivers/oracle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,aAAa,CAAC;AAExE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAmCzD,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAyGhG"}

package/dist/drivers/oracle.js

@@ -0,0 +1,96 @@
+function buildOracleConnectString(config) {
+    if (config.connectString) {
+        return config.connectString;
+    }
+    return config.serviceName
+        ? `${config.host}:${config.port}/${config.serviceName}`
+        : `${config.host}:${config.port}/${config.sid}`;
+}
+export async function createOracleAdapter(config) {
+    let oracleModule;
+    try {
+        const importedModule = await import("oracledb");
+        oracleModule = (importedModule.default ??
+            importedModule);
+    }
+    catch (error) {
+        throw new Error("The 'oracledb' package is required for dialect 'oracle'. Install it with `pnpm add oracledb`.", { cause: error });
+    }
+    const connectionOptions = {
+        user: config.user,
+        password: config.password,
+        connectString: buildOracleConnectString(config),
+        poolMin: config.poolMin,
+        poolMax: config.poolMax,
+        poolIncrement: config.poolIncrement,
+        stmtCacheSize: config.stmtCacheSize,
+    };
+    if (config.usePool !== false) {
+        const pool = await oracleModule.createPool(connectionOptions);
+        return {
+            dialect: "oracle",
+            async query(statement) {
+                const connection = await pool.getConnection();
+                try {
+                    const result = await connection.execute(statement.text, statement.values, { outFormat: oracleModule.OUT_FORMAT_OBJECT });
+                    const rows = result.rows ?? [];
+                    return {
+                        rows,
+                        rowCount: rows.length,
+                    };
+                }
+                finally {
+                    await connection.close();
+                }
+            },
+            async execute(statement) {
+                const connection = await pool.getConnection();
+                try {
+                    const result = await connection.execute(statement.text, statement.values, { autoCommit: true });
+                    return {
+                        rowCount: result.rowsAffected ?? 0,
+                    };
+                }
+                finally {
+                    await connection.close();
+                }
+            },
+            close() {
+                return pool.close(0);
+            },
+        };
+    }
+    return {
+        dialect: "oracle",
+        async query(statement) {
+            const connection = await oracleModule.getConnection(connectionOptions);
+            try {
+                const result = await connection.execute(statement.text, statement.values, { outFormat: oracleModule.OUT_FORMAT_OBJECT });
+                const rows = result.rows ?? [];
+                return {
+                    rows,
+                    rowCount: rows.length,
+                };
+            }
+            finally {
+                await connection.close();
+            }
+        },
+        async execute(statement) {
+            const connection = await oracleModule.getConnection(connectionOptions);
+            try {
+                const result = await connection.execute(statement.text, statement.values, { autoCommit: true });
+                return {
+                    rowCount: result.rowsAffected ?? 0,
+                };
+            }
+            finally {
+                await connection.close();
+            }
+        },
+        async close() {
+            // Non-pooled Oracle mode opens/closes per operation, so there is nothing to tear down.
+        },
+    };
+}
+//# sourceMappingURL=oracle.js.map

package/dist/drivers/oracle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.js","sourceRoot":"","sources":["../../src/drivers/oracle.ts"],"names":[],"mappings":"AA2BA,SAAS,wBAAwB,CAAC,MAA4B;IAC5D,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,OAAO,MAAM,CAAC,WAAW;QACvB,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE;QACvD,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAA4B;IACpE,IAAI,YAA0B,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QAChD,YAAY,GAAG,CAAE,cAA6C,CAAC,OAAO;YACpE,cAAc,CAAiB,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,+FAA+F,EAC/F,EAAE,KAAK,EAAE,KAAc,EAAE,CAC1B,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GAAG;QACxB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,aAAa,EAAE,wBAAwB,CAAC,MAAM,CAAC;QAC/C,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC;IAEF,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QAE9D,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,KAAK,CAAC,KAAK,CAA8B,SAA+B;gBACtE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC9C,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CACrC,SAAS,CAAC,IAAI,EACd,SAAS,CAAC,MAAiC,EAC3C,EAAE,SAAS,EAAE,YAAY,CAAC,iBAAiB,EAAE,CAC9C,CAAC;oBACF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;oBAC/B,OAAO;wBACL,IAAI;wBACJ,QAAQ,EAAE,IAAI,CAAC,MAAM;qBACtB,CAAC;gBACJ,CAAC;wBAAS,CAAC;oBACT,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;gBAC3B,CAAC;YACH,CAAC;YACD,KAAK,CAAC,OAAO,CAAC,SAA+B;gBAC3C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC9C,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CACrC,SAAS,CAAC,IAAI,EACd,SAAS,CAAC,MAAiC,EAC3C,EAAE,UAAU,EAAE,IAAI,EAAE,CACrB,CAAC;oBACF,OAAO;wBACL,QAAQ,EAAE,MAAM,CAAC,YAAY,IAAI,CAAC;qBACnC,CAAC;gBACJ,CAAC;wBAAS,CAAC;oBACT,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;gBAC3B,CAAC;YACH,CAAC;YACD,KAAK;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,QAAQ;QACjB,KAAK,CAAC,KAAK,CAA8B,SAA+B;YACtE,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;YACvE,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CACrC,SAAS,CAAC,IAAI,EACd,SAAS,CAAC,MAAiC,EAC3C,EAAE,SAAS,EAAE,YAAY,CAAC,iBAAiB,EAAE,CAC9C,CAAC;gBACF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC/B,OAAO;oBACL,IAAI;oBACJ,QAAQ,EAAE,IAAI,CAAC,MAAM;iBACtB,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,SAA+B;YAC3C,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;YACvE,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CACrC,SAAS,CAAC,IAAI,EACd,SAAS,CAAC,MAAiC,EAC3C,EAAE,UAAU,EAAE,IAAI,EAAE,CACrB,CAAC;gBACF,OAAO;oBACL,QAAQ,EAAE,MAAM,CAAC,YAAY,IAAI,CAAC;iBACnC,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK;YACT,uFAAuF;QACzF,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { DatabaseAdapter, DatabaseQueryResult } from \"../types.js\";\nimport type { CompiledSqlStatement } from \"../types.js\";\nimport type { OracleDatabaseConfig } from \"../schema.js\";\n\ntype OraclePool = {\n  getConnection(): Promise<OracleConnection>;\n  close(closeMode?: number): Promise<void>;\n};\n\ntype OracleConnection = {\n  execute<T = Record<string, unknown>>(\n    sqlText: string,\n    bindParams?: Record<string, unknown>,\n    options?: Record<string, unknown>\n  ): Promise<{\n    rows?: T[];\n    rowsAffected?: number;\n  }>;\n  close(): Promise<void>;\n};\n\ntype OracleModule = {\n  OUT_FORMAT_OBJECT: number;\n  createPool(options: Record<string, unknown>): Promise<OraclePool>;\n  getConnection(options: Record<string, unknown>): Promise<OracleConnection>;\n};\n\nfunction buildOracleConnectString(config: OracleDatabaseConfig): string {\n  if (config.connectString) {\n    return config.connectString;\n  }\n\n  return config.serviceName\n    ? `${config.host}:${config.port}/${config.serviceName}`\n    : `${config.host}:${config.port}/${config.sid}`;\n}\n\nexport async function createOracleAdapter(config: OracleDatabaseConfig): Promise<DatabaseAdapter> {\n  let oracleModule: OracleModule;\n\n  try {\n    const importedModule = await import(\"oracledb\");\n    oracleModule = ((importedModule as { default?: OracleModule }).default ??\n      importedModule) as OracleModule;\n  } catch (error) {\n    throw new Error(\n      \"The 'oracledb' package is required for dialect 'oracle'. Install it with `pnpm add oracledb`.\",\n      { cause: error as Error }\n    );\n  }\n\n  const connectionOptions = {\n    user: config.user,\n    password: config.password,\n    connectString: buildOracleConnectString(config),\n    poolMin: config.poolMin,\n    poolMax: config.poolMax,\n    poolIncrement: config.poolIncrement,\n    stmtCacheSize: config.stmtCacheSize,\n  };\n\n  if (config.usePool !== false) {\n    const pool = await oracleModule.createPool(connectionOptions);\n\n    return {\n      dialect: \"oracle\",\n      async query<T = Record<string, unknown>>(statement: CompiledSqlStatement): Promise<DatabaseQueryResult<T>> {\n        const connection = await pool.getConnection();\n        try {\n          const result = await connection.execute<T>(\n            statement.text,\n            statement.values as Record<string, unknown>,\n            { outFormat: oracleModule.OUT_FORMAT_OBJECT }\n          );\n          const rows = result.rows ?? [];\n          return {\n            rows,\n            rowCount: rows.length,\n          };\n        } finally {\n          await connection.close();\n        }\n      },\n      async execute(statement: CompiledSqlStatement) {\n        const connection = await pool.getConnection();\n        try {\n          const result = await connection.execute(\n            statement.text,\n            statement.values as Record<string, unknown>,\n            { autoCommit: true }\n          );\n          return {\n            rowCount: result.rowsAffected ?? 0,\n          };\n        } finally {\n          await connection.close();\n        }\n      },\n      close() {\n        return pool.close(0);\n      },\n    };\n  }\n\n  return {\n    dialect: \"oracle\",\n    async query<T = Record<string, unknown>>(statement: CompiledSqlStatement): Promise<DatabaseQueryResult<T>> {\n      const connection = await oracleModule.getConnection(connectionOptions);\n      try {\n        const result = await connection.execute<T>(\n          statement.text,\n          statement.values as Record<string, unknown>,\n          { outFormat: oracleModule.OUT_FORMAT_OBJECT }\n        );\n        const rows = result.rows ?? [];\n        return {\n          rows,\n          rowCount: rows.length,\n        };\n      } finally {\n        await connection.close();\n      }\n    },\n    async execute(statement: CompiledSqlStatement) {\n      const connection = await oracleModule.getConnection(connectionOptions);\n      try {\n        const result = await connection.execute(\n          statement.text,\n          statement.values as Record<string, unknown>,\n          { autoCommit: true }\n        );\n        return {\n          rowCount: result.rowsAffected ?? 0,\n        };\n      } finally {\n        await connection.close();\n      }\n    },\n    async close() {\n      // Non-pooled Oracle mode opens/closes per operation, so there is nothing to tear down.\n    },\n  };\n}\n"]}

package/dist/drivers/pg.d.ts

@@ -0,0 +1,4 @@
+import type { DatabaseAdapter } from "../types.js";
+import type { PostgresDatabaseConfig } from "../schema.js";
+export declare function createPgAdapter(config: PostgresDatabaseConfig): Promise<DatabaseAdapter>;
+//# sourceMappingURL=pg.d.ts.map

package/dist/drivers/pg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg.d.ts","sourceRoot":"","sources":["../../src/drivers/pg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,aAAa,CAAC;AAExE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAqC3D,wBAAsB,eAAe,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8E9F"}

package/dist/drivers/pg.js

@@ -0,0 +1,84 @@
+function buildPgSsl(config) {
+    if (config.ssl === undefined) {
+        return undefined;
+    }
+    if (typeof config.ssl === "boolean") {
+        return config.ssl;
+    }
+    return {
+        rejectUnauthorized: config.ssl.rejectUnauthorized,
+        ca: config.ssl.ca,
+        cert: config.ssl.cert,
+        key: config.ssl.key,
+        servername: config.ssl.servername,
+    };
+}
+export async function createPgAdapter(config) {
+    let pgModule;
+    try {
+        const importedModule = await import("pg");
+        pgModule = (importedModule.default ??
+            importedModule);
+    }
+    catch (error) {
+        throw new Error("The 'pg' package is required for dialect 'pg'. Install it with `pnpm add pg`.", { cause: error });
+    }
+    const connectionOptions = {
+        host: config.host,
+        port: config.port,
+        database: config.database,
+        user: config.user,
+        password: config.password,
+        ssl: buildPgSsl(config),
+        application_name: config.applicationName,
+        statement_timeout: config.statementTimeoutMs,
+        connectionTimeoutMillis: config.connectionTimeoutMs,
+        idleTimeoutMillis: config.idleTimeoutMs,
+        max: config.maxPoolSize,
+        min: config.minPoolSize,
+    };
+    if (config.usePool !== false) {
+        const pool = new pgModule.Pool(connectionOptions);
+        return {
+            dialect: "pg",
+            async query(statement) {
+                const result = await pool.query(statement.text, statement.values);
+                return {
+                    rows: result.rows,
+                    rowCount: result.rowCount ?? result.rows.length,
+                };
+            },
+            async execute(statement) {
+                const result = await pool.query(statement.text, statement.values);
+                return {
+                    rowCount: result.rowCount ?? 0,
+                };
+            },
+            close() {
+                return pool.end();
+            },
+        };
+    }
+    const client = new pgModule.Client(connectionOptions);
+    await client.connect();
+    return {
+        dialect: "pg",
+        async query(statement) {
+            const result = await client.query(statement.text, statement.values);
+            return {
+                rows: result.rows,
+                rowCount: result.rowCount ?? result.rows.length,
+            };
+        },
+        async execute(statement) {
+            const result = await client.query(statement.text, statement.values);
+            return {
+                rowCount: result.rowCount ?? 0,
+            };
+        },
+        close() {
+            return client.end();
+        },
+    };
+}
+//# sourceMappingURL=pg.js.map

package/dist/drivers/pg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg.js","sourceRoot":"","sources":["../../src/drivers/pg.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DatabaseAdapter, DatabaseQueryResult } from \"../types.js\";\nimport type { CompiledSqlStatement } from \"../types.js\";\nimport type { PostgresDatabaseConfig } from \"../schema.js\";\n\ntype PgPool = {\n  query<T = Record<string, unknown>>(text: string, values?: unknown[]): Promise<{\n    rows: T[];\n    rowCount?: number | null;\n  }>;\n  end(): Promise<void>;\n};\n\ntype PgClient = {\n  connect(): Promise<void>;\n  query<T = Record<string, unknown>>(text: string, values?: unknown[]): Promise<{\n    rows: T[];\n    rowCount?: number | null;\n  }>;\n  end(): Promise<void>;\n};\n\nfunction buildPgSsl(config: PostgresDatabaseConfig): unknown {\n  if (config.ssl === undefined) {\n    return undefined;\n  }\n\n  if (typeof config.ssl === \"boolean\") {\n    return config.ssl;\n  }\n\n  return {\n    rejectUnauthorized: config.ssl.rejectUnauthorized,\n    ca: config.ssl.ca,\n    cert: config.ssl.cert,\n    key: config.ssl.key,\n    servername: config.ssl.servername,\n  };\n}\n\nexport async function createPgAdapter(config: PostgresDatabaseConfig): Promise<DatabaseAdapter> {\n  let pgModule: {\n    Pool: new (options: Record<string, unknown>) => PgPool;\n    Client: new (options: Record<string, unknown>) => PgClient;\n  };\n\n  try {\n    const importedModule = await import(\"pg\");\n    pgModule = ((importedModule as { default?: typeof importedModule }).default ??\n      importedModule) as typeof pgModule;\n  } catch (error) {\n    throw new Error(\n      \"The 'pg' package is required for dialect 'pg'. Install it with `pnpm add pg`.\",\n      { cause: error as Error }\n    );\n  }\n\n  const connectionOptions = {\n    host: config.host,\n    port: config.port,\n    database: config.database,\n    user: config.user,\n    password: config.password,\n    ssl: buildPgSsl(config),\n    application_name: config.applicationName,\n    statement_timeout: config.statementTimeoutMs,\n    connectionTimeoutMillis: config.connectionTimeoutMs,\n    idleTimeoutMillis: config.idleTimeoutMs,\n    max: config.maxPoolSize,\n    min: config.minPoolSize,\n  };\n\n  if (config.usePool !== false) {\n    const pool = new pgModule.Pool(connectionOptions);\n\n    return {\n      dialect: \"pg\",\n      async query<T = Record<string, unknown>>(statement: CompiledSqlStatement): Promise<DatabaseQueryResult<T>> {\n        const result = await pool.query<T>(statement.text, statement.values as unknown[]);\n        return {\n          rows: result.rows,\n          rowCount: result.rowCount ?? result.rows.length,\n        };\n      },\n      async execute(statement: CompiledSqlStatement) {\n        const result = await pool.query(statement.text, statement.values as unknown[]);\n        return {\n          rowCount: result.rowCount ?? 0,\n        };\n      },\n      close() {\n        return pool.end();\n      },\n    };\n  }\n\n  const client = new pgModule.Client(connectionOptions);\n  await client.connect();\n\n  return {\n    dialect: \"pg\",\n    async query<T = Record<string, unknown>>(statement: CompiledSqlStatement): Promise<DatabaseQueryResult<T>> {\n      const result = await client.query<T>(statement.text, statement.values as unknown[]);\n      return {\n        rows: result.rows,\n        rowCount: result.rowCount ?? result.rows.length,\n      };\n    },\n    async execute(statement: CompiledSqlStatement) {\n      const result = await client.query(statement.text, statement.values as unknown[]);\n      return {\n        rowCount: result.rowCount ?? 0,\n      };\n    },\n    close() {\n      return client.end();\n    },\n  };\n}\n"]}

package/dist/drivers/sqlite.d.ts

@@ -0,0 +1,4 @@
+import type { DatabaseAdapter } from "../types.js";
+import type { SqliteDatabaseConfig } from "../schema.js";
+export declare function createSqliteAdapter(config: SqliteDatabaseConfig): Promise<DatabaseAdapter>;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/drivers/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/drivers/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,aAAa,CAAC;AAExE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAsBzD,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0ChG"}

package/dist/drivers/sqlite.js

@@ -0,0 +1,38 @@
+export async function createSqliteAdapter(config) {
+    let sqliteModule;
+    try {
+        sqliteModule = await import("better-sqlite3");
+    }
+    catch (error) {
+        throw new Error("The 'better-sqlite3' package is required for dialect 'sqlite'. Install it with `pnpm add better-sqlite3`.", { cause: error });
+    }
+    const Database = sqliteModule.default;
+    const db = new Database(config.filename, {
+        readonly: config.readonly,
+        fileMustExist: config.fileMustExist,
+        timeout: config.timeoutMs,
+    });
+    db.pragma("journal_mode = WAL");
+    return {
+        dialect: "sqlite",
+        async query(statement) {
+            const prepared = db.prepare(statement.text);
+            const rows = prepared.all(...statement.values);
+            return {
+                rows,
+                rowCount: rows.length,
+            };
+        },
+        async execute(statement) {
+            const prepared = db.prepare(statement.text);
+            const result = prepared.run(...statement.values);
+            return {
+                rowCount: result.changes ?? 0,
+            };
+        },
+        async close() {
+            db.close();
+        },
+    };
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/drivers/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/drivers/sqlite.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAA4B;IACpE,IAAI,YAAkD,CAAC;IAEvD,IAAI,CAAC;QACH,YAAY,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,2GAA2G,EAC3G,EAAE,KAAK,EAAE,KAAc,EAAE,CAC1B,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC;IACtC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE;QACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,OAAO,EAAE,MAAM,CAAC,SAAS;KAC1B,CAAC,CAAC;IAEH,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEhC,OAAO;QACL,OAAO,EAAE,QAAQ;QACjB,KAAK,CAAC,KAAK,CAA8B,SAA+B;YACtE,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAI,SAAS,CAAC,MAAoB,CAAQ,CAAC;YACrE,OAAO;gBACL,IAAI;gBACJ,QAAQ,EAAE,IAAI,CAAC,MAAM;aACtB,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,SAA+B;YAC3C,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAI,SAAS,CAAC,MAAoB,CAAC,CAAC;YAChE,OAAO;gBACL,QAAQ,EAAE,MAAM,CAAC,OAAO,IAAI,CAAC;aAC9B,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,KAAK;YACT,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { DatabaseAdapter, DatabaseQueryResult } from \"../types.js\";\nimport type { CompiledSqlStatement } from \"../types.js\";\nimport type { SqliteDatabaseConfig } from \"../schema.js\";\n\ntype BetterSqliteStatement = {\n  all(...params: unknown[]): Record<string, unknown>[];\n  run(...params: unknown[]): { changes: number };\n};\n\ntype BetterSqliteDatabase = {\n  pragma(value: string): void;\n  prepare(sqlText: string): BetterSqliteStatement;\n  close(): void;\n};\n\ntype BetterSqliteConstructor = new (\n  filename: string,\n  options?: {\n    readonly?: boolean;\n    fileMustExist?: boolean;\n    timeout?: number;\n  }\n) => BetterSqliteDatabase;\n\nexport async function createSqliteAdapter(config: SqliteDatabaseConfig): Promise<DatabaseAdapter> {\n  let sqliteModule: { default: BetterSqliteConstructor };\n\n  try {\n    sqliteModule = await import(\"better-sqlite3\");\n  } catch (error) {\n    throw new Error(\n      \"The 'better-sqlite3' package is required for dialect 'sqlite'. Install it with `pnpm add better-sqlite3`.\",\n      { cause: error as Error }\n    );\n  }\n\n  const Database = sqliteModule.default;\n  const db = new Database(config.filename, {\n    readonly: config.readonly,\n    fileMustExist: config.fileMustExist,\n    timeout: config.timeoutMs,\n  });\n\n  db.pragma(\"journal_mode = WAL\");\n\n  return {\n    dialect: \"sqlite\",\n    async query<T = Record<string, unknown>>(statement: CompiledSqlStatement): Promise<DatabaseQueryResult<T>> {\n      const prepared = db.prepare(statement.text);\n      const rows = prepared.all(...(statement.values as unknown[])) as T[];\n      return {\n        rows,\n        rowCount: rows.length,\n      };\n    },\n    async execute(statement: CompiledSqlStatement) {\n      const prepared = db.prepare(statement.text);\n      const result = prepared.run(...(statement.values as unknown[]));\n      return {\n        rowCount: result.changes ?? 0,\n      };\n    },\n    async close() {\n      db.close();\n    },\n  };\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./types.js";
+export * from "./placeholders.js";
+export * from "./schema.js";
+export * from "./sql.js";
+export * from "./params.js";
+export * from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./types.js";
+export * from "./placeholders.js";
+export * from "./schema.js";
+export * from "./sql.js";
+export * from "./params.js";
+export * from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC","sourcesContent":["export * from \"./types.js\";\nexport * from \"./placeholders.js\";\nexport * from \"./schema.js\";\nexport * from \"./sql.js\";\nexport * from \"./params.js\";\nexport * from \"./client.js\";\n"]}

package/dist/params.d.ts

@@ -0,0 +1,4 @@
+import type { CompiledSqlStatement, DatabaseDialect, SqlParams } from "./types.js";
+export declare const ORACLE_IN_LIST_LIMIT = 1000;
+export declare function compileNamedParams(dialect: DatabaseDialect, sqlText: string, params?: SqlParams): CompiledSqlStatement;
+//# sourceMappingURL=params.d.ts.map

package/dist/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../src/params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAoBzC,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,SAAc,GACrB,oBAAoB,CAiJtB"}