exisjs 0.5.9 → 0.5.11

package/dist/database/adapters/mongodb.d.ts

@@ -0,0 +1,58 @@
+/**
+ * MongoDB Database Adapter.
+ *
+ * Uses the `mongodb` npm package for native MongoDB driver support.
+ * Maps the relational-style DatabaseAdapter interface to document-oriented operations.
+ *
+ * For MongoDB, `query()` executes raw commands or aggregation pipelines,
+ * and `execute()` handles insert/update/delete operations.
+ *
+ * Peer Dependencies required:
+ *   npm install mongodb
+ */
+import type { DatabaseAdapter, DatabaseConfig, QueryResult, ExecuteResult, Transaction } from '../types';
+export declare class MongodbAdapter implements DatabaseAdapter {
+    readonly dialect: "mongodb";
+    private client;
+    private database;
+    private config;
+    constructor(config: DatabaseConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    /**
+     * Execute a MongoDB find query.
+     *
+     * For MongoDB, `sql` is treated as a JSON command string:
+     *   `{ "collection": "users", "filter": { "role": "admin" }, "options": { "limit": 10 } }`
+     *
+     * Or simply pass the collection name as `sql` and the filter as `params[0]`:
+     *   query('users', [{ role: 'admin' }])
+     */
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
+    /**
+     * Execute a MongoDB write operation.
+     *
+     * The `sql` parameter is a JSON command string:
+     *   `{ "collection": "users", "operation": "insertOne", "document": { ... } }`
+     *   `{ "collection": "users", "operation": "updateOne", "filter": { ... }, "update": { ... } }`
+     *   `{ "collection": "users", "operation": "deleteOne", "filter": { ... } }`
+     *
+     * Or use the shorthand: execute('users.insertOne', [document])
+     */
+    execute(sql: string, params?: unknown[]): Promise<ExecuteResult>;
+    transaction<T>(fn: (tx: Transaction) => Promise<T>): Promise<T>;
+    isHealthy(): Promise<boolean>;
+    getRawClient(): unknown;
+    /**
+     * Get the raw MongoDB database instance for native operations.
+     */
+    getDatabase(): unknown;
+    private executeJsonCommand;
+    private executeOperation;
+    private ensureConnected;
+    private buildConnectionUrl;
+    private extractDbName;
+    private logQuery;
+    private log;
+}
+//# sourceMappingURL=mongodb.d.ts.map

package/dist/database/adapters/mongodb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/mongodb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACZ,MAAM,UAAU,CAAA;AAEjB,qBAAa,cAAe,YAAW,eAAe;IACpD,QAAQ,CAAC,OAAO,EAAG,SAAS,CAAS;IAErC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,cAAc;IAI5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiDxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC;;;;;;;;OAQG;IACG,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,EAAO,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAuB1B;;;;;;;;;OASG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAsBpE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAwD/D,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAUnC,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,WAAW,IAAI,OAAO;YAMR,kBAAkB;YAWlB,gBAAgB;IA2C9B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,GAAG;CAMZ"}

package/dist/database/adapters/mongodb.js

@@ -0,0 +1,264 @@
+"use strict";
+/**
+ * MongoDB Database Adapter.
+ *
+ * Uses the `mongodb` npm package for native MongoDB driver support.
+ * Maps the relational-style DatabaseAdapter interface to document-oriented operations.
+ *
+ * For MongoDB, `query()` executes raw commands or aggregation pipelines,
+ * and `execute()` handles insert/update/delete operations.
+ *
+ * Peer Dependencies required:
+ *   npm install mongodb
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongodbAdapter = void 0;
+class MongodbAdapter {
+    constructor(config) {
+        this.dialect = 'mongodb';
+        this.client = null;
+        this.database = null;
+        this.config = config;
+    }
+    async connect() {
+        let MongoClient;
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            MongoClient = require('mongodb').MongoClient;
+        }
+        catch {
+            throw new Error('Missing dependency. Please run: npm install mongodb');
+        }
+        const url = this.config.url || this.buildConnectionUrl();
+        const poolConfig = this.config.pool || {};
+        this.client = new MongoClient(url, {
+            maxPoolSize: poolConfig.max ?? 10,
+            minPoolSize: poolConfig.min ?? 2,
+            maxIdleTimeMS: poolConfig.idleTimeoutMs ?? 30000,
+            connectTimeoutMS: this.config.connectTimeoutMs ?? 5000,
+            serverSelectionTimeoutMS: this.config.connectTimeoutMs ?? 5000,
+            tls: this.config.ssl === true ? true : undefined,
+            ...(typeof this.config.ssl === 'object'
+                ? {
+                    tls: true,
+                    tlsCAFile: typeof this.config.ssl.ca === 'string'
+                        ? this.config.ssl.ca
+                        : undefined,
+                    tlsCertificateKeyFile: typeof this.config.ssl.key === 'string'
+                        ? this.config.ssl.key
+                        : undefined,
+                }
+                : {}),
+        });
+        await this.client.connect();
+        const dbName = this.config.database || this.extractDbName(url);
+        if (!dbName) {
+            throw new Error('MongoDB requires a database name. Provide it via `database` config or in the connection URL.');
+        }
+        this.database = this.client.db(dbName);
+        this.log('MongoDB connection established');
+    }
+    async disconnect() {
+        if (this.client) {
+            await this.client.close();
+            this.client = null;
+            this.database = null;
+            this.log('MongoDB connection closed');
+        }
+    }
+    /**
+     * Execute a MongoDB find query.
+     *
+     * For MongoDB, `sql` is treated as a JSON command string:
+     *   `{ "collection": "users", "filter": { "role": "admin" }, "options": { "limit": 10 } }`
+     *
+     * Or simply pass the collection name as `sql` and the filter as `params[0]`:
+     *   query('users', [{ role: 'admin' }])
+     */
+    async query(sql, params = []) {
+        this.ensureConnected();
+        this.logQuery(sql, params);
+        // If sql looks like a JSON command
+        if (sql.trim().startsWith('{')) {
+            const cmd = JSON.parse(sql);
+            const collection = this.database.collection(cmd.collection);
+            const filter = cmd.filter || {};
+            const options = cmd.options || {};
+            const rows = (await collection.find(filter, options).toArray());
+            return { rows, rowCount: rows.length, fields: [] };
+        }
+        // Otherwise, treat sql as collection name, params[0] as filter, params[1] as options
+        const collection = this.database.collection(sql);
+        const filter = params[0] || {};
+        const options = params[1] || {};
+        const rows = (await collection.find(filter, options).toArray());
+        return { rows, rowCount: rows.length, fields: [] };
+    }
+    /**
+     * Execute a MongoDB write operation.
+     *
+     * The `sql` parameter is a JSON command string:
+     *   `{ "collection": "users", "operation": "insertOne", "document": { ... } }`
+     *   `{ "collection": "users", "operation": "updateOne", "filter": { ... }, "update": { ... } }`
+     *   `{ "collection": "users", "operation": "deleteOne", "filter": { ... } }`
+     *
+     * Or use the shorthand: execute('users.insertOne', [document])
+     */
+    async execute(sql, params = []) {
+        this.ensureConnected();
+        this.logQuery(sql, params);
+        // JSON command mode
+        if (sql.trim().startsWith('{')) {
+            return this.executeJsonCommand(sql);
+        }
+        // Shorthand mode: 'collection.operation'
+        const dotIndex = sql.indexOf('.');
+        if (dotIndex !== -1) {
+            const collectionName = sql.substring(0, dotIndex);
+            const operation = sql.substring(dotIndex + 1);
+            return this.executeOperation(collectionName, operation, params);
+        }
+        throw new Error(`MongoDB execute: Unrecognized command format. Use JSON or 'collection.operation' syntax.`);
+    }
+    async transaction(fn) {
+        this.ensureConnected();
+        const session = this.client.startSession();
+        try {
+            let result;
+            await session.withTransaction(async () => {
+                const tx = {
+                    query: async (queryStr, params = []) => {
+                        // For transactions, inject session into the query
+                        return this.query(queryStr, params);
+                    },
+                    execute: async (queryStr, params = []) => {
+                        return this.execute(queryStr, params);
+                    },
+                    savepoint: async () => {
+                        // MongoDB does not support savepoints
+                        throw new Error('MongoDB does not support savepoints within transactions');
+                    },
+                    rollbackTo: async () => {
+                        throw new Error('MongoDB does not support savepoints within transactions');
+                    },
+                    commit: async () => {
+                        // Handled by session.withTransaction
+                    },
+                    rollback: async () => {
+                        await session.abortTransaction();
+                    },
+                };
+                result = await fn(tx);
+            });
+            return result;
+        }
+        finally {
+            await session.endSession();
+        }
+    }
+    async isHealthy() {
+        try {
+            this.ensureConnected();
+            await this.database.command({ ping: 1 });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    getRawClient() {
+        return this.client;
+    }
+    /**
+     * Get the raw MongoDB database instance for native operations.
+     */
+    getDatabase() {
+        return this.database;
+    }
+    // ─── Private Helpers ───────────────────────────────────────────────────────
+    async executeJsonCommand(json) {
+        const cmd = JSON.parse(json);
+        const collection = this.database.collection(cmd.collection);
+        return this.executeOperation(cmd.collection, cmd.operation, [cmd.document || cmd.filter, cmd.update].filter(Boolean), collection);
+    }
+    async executeOperation(collectionName, operation, params, collection) {
+        const coll = collection || this.database.collection(collectionName);
+        switch (operation) {
+            case 'insertOne': {
+                const result = await coll.insertOne(params[0]);
+                return { affectedRows: 1, insertId: result.insertedId?.toString() };
+            }
+            case 'insertMany': {
+                const docs = params[0];
+                const result = await coll.insertMany(docs);
+                return { affectedRows: result.insertedCount };
+            }
+            case 'updateOne': {
+                const result = await coll.updateOne(params[0], params[1]);
+                return { affectedRows: result.modifiedCount };
+            }
+            case 'updateMany': {
+                const result = await coll.updateMany(params[0], params[1]);
+                return { affectedRows: result.modifiedCount };
+            }
+            case 'deleteOne': {
+                const result = await coll.deleteOne(params[0]);
+                return { affectedRows: result.deletedCount };
+            }
+            case 'deleteMany': {
+                const result = await coll.deleteMany(params[0]);
+                return { affectedRows: result.deletedCount };
+            }
+            case 'replaceOne': {
+                const result = await coll.replaceOne(params[0], params[1]);
+                return { affectedRows: result.modifiedCount };
+            }
+            default:
+                throw new Error(`MongoDB: Unsupported operation '${operation}'`);
+        }
+    }
+    ensureConnected() {
+        if (!this.client || !this.database) {
+            throw new Error('MongoDB adapter is not connected. Call connect() first.');
+        }
+    }
+    buildConnectionUrl() {
+        const { host, port, username, password, authSource } = this.config;
+        if (!host) {
+            throw new Error('MongoDB requires either a `url` or `host` in the config.');
+        }
+        const auth = username
+            ? password
+                ? `${encodeURIComponent(username)}:${encodeURIComponent(password)}@`
+                : `${encodeURIComponent(username)}@`
+            : '';
+        const authSrc = authSource ? `?authSource=${authSource}` : '';
+        return `mongodb://${auth}${host}:${port || 27017}${authSrc}`;
+    }
+    extractDbName(url) {
+        try {
+            const parsed = new URL(url);
+            const path = parsed.pathname;
+            return path && path.length > 1 ? path.substring(1) : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    logQuery(sql, params) {
+        if (!this.config.logging)
+            return;
+        if (typeof this.config.logging === 'function') {
+            this.config.logging(sql, params);
+        }
+    }
+    log(message) {
+        if (!this.config.logging)
+            return;
+        if (typeof this.config.logging === 'function') {
+            this.config.logging(message);
+        }
+    }
+}
+exports.MongodbAdapter = MongodbAdapter;
+//# sourceMappingURL=mongodb.js.map

package/dist/database/adapters/mongodb.js.map

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

package/dist/database/adapters/mysql.d.ts

@@ -0,0 +1,27 @@
+/**
+ * MySQL Database Adapter.
+ *
+ * Uses the `mysql2` npm package for high-performance prepared statements,
+ * connection pooling, and transaction support.
+ *
+ * Peer Dependencies required:
+ *   npm install mysql2
+ */
+import type { DatabaseAdapter, DatabaseConfig, QueryResult, ExecuteResult, Transaction } from '../types';
+export declare class MysqlAdapter implements DatabaseAdapter {
+    readonly dialect: "mysql";
+    private pool;
+    private config;
+    constructor(config: DatabaseConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
+    execute(sql: string, params?: unknown[]): Promise<ExecuteResult>;
+    transaction<T>(fn: (tx: Transaction) => Promise<T>): Promise<T>;
+    isHealthy(): Promise<boolean>;
+    getRawClient(): unknown;
+    private ensureConnected;
+    private logQuery;
+    private log;
+}
+//# sourceMappingURL=mysql.d.ts.map

package/dist/database/adapters/mysql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/mysql.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EAEZ,MAAM,UAAU,CAAA;AAEjB,qBAAa,YAAa,YAAW,eAAe;IAClD,QAAQ,CAAC,OAAO,EAAG,OAAO,CAAS;IAEnC,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,cAAc;IAI5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqDxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,EAAO,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAqBpB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAYpE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoE/D,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAUnC,YAAY,IAAI,OAAO;IAMvB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,GAAG;CAMZ"}

package/dist/database/adapters/mysql.js

@@ -0,0 +1,188 @@
+"use strict";
+/**
+ * MySQL Database Adapter.
+ *
+ * Uses the `mysql2` npm package for high-performance prepared statements,
+ * connection pooling, and transaction support.
+ *
+ * Peer Dependencies required:
+ *   npm install mysql2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MysqlAdapter = void 0;
+class MysqlAdapter {
+    constructor(config) {
+        this.dialect = 'mysql';
+        this.pool = null;
+        this.config = config;
+    }
+    async connect() {
+        let mysql;
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            mysql = require('mysql2/promise');
+        }
+        catch {
+            throw new Error('Missing dependency. Please run: npm install mysql2');
+        }
+        const poolConfig = this.config.pool || {};
+        if (this.config.url) {
+            this.pool = mysql.createPool({
+                uri: this.config.url,
+                waitForConnections: true,
+                connectionLimit: poolConfig.max ?? 10,
+                idleTimeout: poolConfig.idleTimeoutMs ?? 30000,
+                connectTimeout: this.config.connectTimeoutMs ?? 5000,
+                ssl: this.config.ssl === true
+                    ? {}
+                    : typeof this.config.ssl === 'object'
+                        ? this.config.ssl
+                        : undefined,
+            });
+        }
+        else {
+            this.pool = mysql.createPool({
+                host: this.config.host || 'localhost',
+                port: this.config.port || 3306,
+                database: this.config.database,
+                user: this.config.username,
+                password: this.config.password,
+                waitForConnections: true,
+                connectionLimit: poolConfig.max ?? 10,
+                idleTimeout: poolConfig.idleTimeoutMs ?? 30000,
+                connectTimeout: this.config.connectTimeoutMs ?? 5000,
+                ssl: this.config.ssl === true
+                    ? {}
+                    : typeof this.config.ssl === 'object'
+                        ? this.config.ssl
+                        : undefined,
+            });
+        }
+        // Test the connection
+        const conn = await this.pool.getConnection();
+        conn.release();
+        this.log('MySQL connection pool established');
+    }
+    async disconnect() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+            this.log('MySQL connection pool closed');
+        }
+    }
+    async query(sql, params = []) {
+        this.ensureConnected();
+        this.logQuery(sql, params);
+        const [rows, columns] = await this.pool.execute(sql, params);
+        const fields = Array.isArray(columns)
+            ? columns.map((col) => ({
+                name: col.name,
+                dataType: col.type?.toString(),
+                tableId: col.table?.length ? undefined : undefined,
+            }))
+            : [];
+        return {
+            rows: rows,
+            rowCount: Array.isArray(rows) ? rows.length : 0,
+            fields,
+        };
+    }
+    async execute(sql, params = []) {
+        this.ensureConnected();
+        this.logQuery(sql, params);
+        const [result] = await this.pool.execute(sql, params);
+        return {
+            affectedRows: result.affectedRows ?? 0,
+            insertId: result.insertId ?? undefined,
+        };
+    }
+    async transaction(fn) {
+        this.ensureConnected();
+        const conn = await this.pool.getConnection();
+        try {
+            await conn.beginTransaction();
+            const tx = {
+                query: async (queryStr, params = []) => {
+                    this.logQuery(queryStr, params);
+                    const [rows, columns] = await conn.execute(queryStr, params);
+                    const fields = Array.isArray(columns)
+                        ? columns.map((col) => ({
+                            name: col.name,
+                            dataType: col.type?.toString(),
+                        }))
+                        : [];
+                    return {
+                        rows: rows,
+                        rowCount: Array.isArray(rows) ? rows.length : 0,
+                        fields,
+                    };
+                },
+                execute: async (queryStr, params = []) => {
+                    this.logQuery(queryStr, params);
+                    const [result] = await conn.execute(queryStr, params);
+                    return {
+                        affectedRows: result.affectedRows ?? 0,
+                        insertId: result.insertId ?? undefined,
+                    };
+                },
+                savepoint: async (name) => {
+                    await conn.execute(`SAVEPOINT ${name}`);
+                },
+                rollbackTo: async (name) => {
+                    await conn.execute(`ROLLBACK TO SAVEPOINT ${name}`);
+                },
+                commit: async () => {
+                    await conn.commit();
+                },
+                rollback: async () => {
+                    await conn.rollback();
+                },
+            };
+            const result = await fn(tx);
+            await conn.commit();
+            return result;
+        }
+        catch (err) {
+            await conn.rollback();
+            throw err;
+        }
+        finally {
+            conn.release();
+        }
+    }
+    async isHealthy() {
+        try {
+            this.ensureConnected();
+            await this.pool.execute('SELECT 1');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    getRawClient() {
+        return this.pool;
+    }
+    // ─── Private Helpers ───────────────────────────────────────────────────────
+    ensureConnected() {
+        if (!this.pool) {
+            throw new Error('MySQL adapter is not connected. Call connect() first.');
+        }
+    }
+    logQuery(sql, params) {
+        if (!this.config.logging)
+            return;
+        if (typeof this.config.logging === 'function') {
+            this.config.logging(sql, params);
+        }
+    }
+    log(message) {
+        if (!this.config.logging)
+            return;
+        if (typeof this.config.logging === 'function') {
+            this.config.logging(message);
+        }
+    }
+}
+exports.MysqlAdapter = MysqlAdapter;
+//# sourceMappingURL=mysql.js.map

package/dist/database/adapters/mysql.js.map

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

package/dist/database/adapters/postgres.d.ts

@@ -0,0 +1,28 @@
+/**
+ * PostgreSQL Database Adapter.
+ *
+ * Uses the `postgres` (postgres.js) npm package for high-performance connection pooling,
+ * parameterized queries, and transaction support.
+ *
+ * Peer Dependencies required:
+ *   npm install postgres
+ */
+import type { DatabaseAdapter, DatabaseConfig, QueryResult, ExecuteResult, Transaction } from '../types';
+export declare class PostgresAdapter implements DatabaseAdapter {
+    readonly dialect: "postgres";
+    private client;
+    private config;
+    constructor(config: DatabaseConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
+    execute(sql: string, params?: unknown[]): Promise<ExecuteResult>;
+    transaction<T>(fn: (tx: Transaction) => Promise<T>): Promise<T>;
+    isHealthy(): Promise<boolean>;
+    getRawClient(): unknown;
+    private ensureConnected;
+    private buildConnectionUrl;
+    private logQuery;
+    private log;
+}
+//# sourceMappingURL=postgres.d.ts.map

package/dist/database/adapters/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/postgres.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EAEZ,MAAM,UAAU,CAAA;AAEjB,qBAAa,eAAgB,YAAW,eAAe;IACrD,QAAQ,CAAC,OAAO,EAAG,UAAU,CAAS;IAEtC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,cAAc;IAI5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqCxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,EAAO,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAqBpB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAYpE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA0D/D,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAUnC,YAAY,IAAI,OAAO;IAMvB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,GAAG;CAMZ"}