@framers/sql-storage-adapter 0.1.0

package/dist/adapters/capacitorSqliteAdapter.d.ts

@@ -0,0 +1,33 @@
+import type { StorageAdapter, StorageCapability, StorageOpenOptions, StorageParameters, StorageRunResult } from '../types';
+export interface CapacitorAdapterOptions {
+    /**
+     * Database name. Defaults to `app`.
+     */
+    database?: string;
+    /**
+     * Whether to enable WAL when platform supports it.
+     */
+    enableWal?: boolean;
+}
+/**
+ * Adapter using @capacitor-community/sqlite for native mobile targets.
+ */
+export declare class CapacitorSqliteAdapter implements StorageAdapter {
+    private readonly options;
+    readonly kind = "capacitor-sqlite";
+    readonly capabilities: ReadonlySet<StorageCapability>;
+    private plugin;
+    private connection;
+    private dbName;
+    constructor(options?: CapacitorAdapterOptions);
+    open(options?: StorageOpenOptions): Promise<void>;
+    run(statement: string, parameters?: StorageParameters): Promise<StorageRunResult>;
+    get<T>(statement: string, parameters?: StorageParameters): Promise<T | null>;
+    all<T>(statement: string, parameters?: StorageParameters): Promise<T[]>;
+    exec(script: string): Promise<void>;
+    transaction<T>(fn: (trx: StorageAdapter) => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+    private ensureConnection;
+}
+export declare const createCapacitorSqliteAdapter: (options?: CapacitorAdapterOptions) => StorageAdapter;
+//# sourceMappingURL=capacitorSqliteAdapter.d.ts.map

package/dist/adapters/capacitorSqliteAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacitorSqliteAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/capacitorSqliteAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAM3H,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAWD;;GAEG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAa/C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZpC,SAAgB,IAAI,sBAAsB;IAC1C,SAAgB,YAAY,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAKzD;IAEH,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,MAAM,CAAS;gBAEM,OAAO,GAAE,uBAA4B;IAIrD,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBjD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOjF,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5E,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAOvE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAanE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC,OAAO,CAAC,gBAAgB;CAMzB;AAED,eAAO,MAAM,4BAA4B,GAAI,UAAU,uBAAuB,KAAG,cAC5C,CAAC"}

package/dist/adapters/capacitorSqliteAdapter.js

@@ -0,0 +1,95 @@
+import { normaliseParameters } from '../utils/parameterUtils';
+const loadCapacitorSqlite = async () => {
+    try {
+        return await import('@capacitor-community/sqlite');
+    }
+    catch (error) {
+        console.warn('[StorageAdapter] @capacitor-community/sqlite module not available.', error);
+        return null;
+    }
+};
+/**
+ * Adapter using @capacitor-community/sqlite for native mobile targets.
+ */
+export class CapacitorSqliteAdapter {
+    constructor(options = {}) {
+        this.options = options;
+        this.kind = 'capacitor-sqlite';
+        this.capabilities = new Set([
+            'transactions',
+            'wal',
+            'locks',
+            'persistence'
+        ]);
+        this.plugin = null;
+        this.connection = null;
+        this.dbName = options.database ?? 'app';
+    }
+    async open(options) {
+        if (this.connection) {
+            return;
+        }
+        this.plugin = await loadCapacitorSqlite();
+        if (!this.plugin) {
+            throw new Error('@capacitor-community/sqlite is unavailable. Install the plugin or choose a different adapter.');
+        }
+        const dbName = options?.adapterOptions?.database ?? this.options.database ?? this.dbName;
+        this.connection = await this.plugin.createConnection(dbName, false, 'no-encryption', 1, false);
+        await this.connection.open();
+        if (this.options.enableWal ?? true) {
+            try {
+                await this.connection.execute('PRAGMA journal_mode = WAL;');
+            }
+            catch (error) {
+                console.warn('[StorageAdapter] Failed to enable WAL on Capacitor SQLite.', error);
+            }
+        }
+    }
+    async run(statement, parameters) {
+        const conn = this.ensureConnection();
+        const { positional } = normaliseParameters(parameters);
+        const result = await conn.run(statement, positional ?? []);
+        return { changes: result.changes ?? 0, lastInsertRowid: result.lastId ?? null };
+    }
+    async get(statement, parameters) {
+        const rows = await this.all(statement, parameters);
+        return rows.length > 0 ? rows[0] : null;
+    }
+    async all(statement, parameters) {
+        const conn = this.ensureConnection();
+        const { positional } = normaliseParameters(parameters);
+        const result = await conn.query(statement, positional ?? []);
+        return (result.values ?? []);
+    }
+    async exec(script) {
+        const conn = this.ensureConnection();
+        await conn.execute(script);
+    }
+    async transaction(fn) {
+        const conn = this.ensureConnection();
+        await conn.execute('BEGIN TRANSACTION;');
+        try {
+            const result = await fn(this);
+            await conn.execute('COMMIT;');
+            return result;
+        }
+        catch (error) {
+            await conn.execute('ROLLBACK;');
+            throw error;
+        }
+    }
+    async close() {
+        if (this.connection) {
+            await this.connection.close();
+            this.connection = null;
+        }
+    }
+    ensureConnection() {
+        if (!this.connection) {
+            throw new Error('Storage adapter not opened. Call open() before executing statements.');
+        }
+        return this.connection;
+    }
+}
+export const createCapacitorSqliteAdapter = (options) => new CapacitorSqliteAdapter(options);
+//# sourceMappingURL=capacitorSqliteAdapter.js.map

package/dist/adapters/capacitorSqliteAdapter.js.map

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

package/dist/adapters/postgresAdapter.d.ts

@@ -0,0 +1,180 @@
+import type { StorageAdapter, StorageCapability, StorageOpenOptions, StorageParameters, StorageRunResult } from '../types';
+/**
+ * Configuration options for PostgreSQL adapter.
+ * Supports both connection strings and granular configuration.
+ */
+export interface PostgresAdapterOptions {
+    /** PostgreSQL connection string (e.g., 'postgresql://user:pass@host:5432/dbname') */
+    connectionString?: string;
+    /** Host name or IP address (default: localhost) */
+    host?: string;
+    /** Port number (default: 5432) */
+    port?: number;
+    /** Database name */
+    database?: string;
+    /** Username for authentication */
+    user?: string;
+    /** Password for authentication */
+    password?: string;
+    /** Enable SSL/TLS connection (recommended for remote) */
+    ssl?: boolean | {
+        rejectUnauthorized?: boolean;
+        ca?: string;
+        cert?: string;
+        key?: string;
+    };
+    /** Connection pool size (default: 10) */
+    max?: number;
+    /** Minimum pool size (default: 0) */
+    min?: number;
+    /** Idle timeout in ms (default: 10000) */
+    idleTimeoutMillis?: number;
+    /** Connection timeout in ms (default: 0 = no timeout) */
+    connectionTimeoutMillis?: number;
+    /** Application name for connection tracking */
+    application_name?: string;
+    /** Statement timeout in ms (0 = no timeout) */
+    statement_timeout?: number;
+    /** Query timeout in ms (0 = no timeout) */
+    query_timeout?: number;
+}
+/**
+ * PostgreSQL adapter for production-grade SQL operations.
+ *
+ * ## Performance Characteristics
+ * - Connection pooling for efficient resource usage
+ * - Excellent concurrent access with MVCC
+ * - Optimized for complex queries and large datasets
+ * - ~10,000 queries/second with connection pooling
+ *
+ * ## Advantages
+ * - Full SQL feature set (CTEs, window functions, etc.)
+ * - Native JSON/JSONB support
+ * - Robust replication and backup options
+ * - Battle-tested in production environments
+ * - Secure remote connections with SSL/TLS
+ *
+ * ## Limitations
+ * - Requires separate server process
+ * - Network latency for remote connections
+ * - Higher resource consumption than SQLite
+ * - Configuration complexity for optimal performance
+ *
+ * ## When to Use
+ * - Production web applications
+ * - Multi-user systems
+ * - When you need advanced SQL features
+ * - Cloud deployments (AWS RDS, Heroku, Supabase, etc.)
+ * - Remote database access
+ *
+ * ## Remote Connection Examples
+ *
+ * ### Connection String (Recommended)
+ * ```typescript
+ * const db = createPostgresAdapter({
+ *   connectionString: 'postgresql://user:password@db.example.com:5432/mydb?sslmode=require'
+ * });
+ * ```
+ *
+ * ### Granular Configuration
+ * ```typescript
+ * const db = createPostgresAdapter({
+ *   host: 'db.example.com',
+ *   port: 5432,
+ *   database: 'mydb',
+ *   user: 'dbuser',
+ *   password: 'secure_password',
+ *   ssl: true,  // Enable SSL for security
+ *   max: 20,    // Connection pool size
+ *   statement_timeout: 30000  // 30 second timeout
+ * });
+ * ```
+ *
+ * ### Cloud Provider Examples
+ *
+ * #### AWS RDS
+ * ```typescript
+ * const db = createPostgresAdapter({
+ *   host: 'mydb.abc123.us-east-1.rds.amazonaws.com',
+ *   port: 5432,
+ *   database: 'postgres',
+ *   user: 'admin',
+ *   password: process.env.RDS_PASSWORD,
+ *   ssl: { rejectUnauthorized: true }
+ * });
+ * ```
+ *
+ * #### Heroku Postgres
+ * ```typescript
+ * const db = createPostgresAdapter({
+ *   connectionString: process.env.DATABASE_URL,
+ *   ssl: { rejectUnauthorized: false }  // Heroku uses self-signed certs
+ * });
+ * ```
+ *
+ * #### Supabase
+ * ```typescript
+ * const db = createPostgresAdapter({
+ *   connectionString: process.env.SUPABASE_DB_URL,
+ *   ssl: true
+ * });
+ * ```
+ *
+ * #### DigitalOcean Managed Database
+ * ```typescript
+ * const db = createPostgresAdapter({
+ *   host: 'db-postgresql-nyc3-12345.ondigitalocean.com',
+ *   port: 25060,
+ *   database: 'defaultdb',
+ *   user: 'doadmin',
+ *   password: process.env.DO_DB_PASSWORD,
+ *   ssl: { rejectUnauthorized: true, ca: process.env.DO_CA_CERT }
+ * });
+ * ```
+ *
+ * ## Graceful Degradation
+ * - Automatic reconnection on connection loss
+ * - Connection pool handles transient failures
+ * - Falls back to SQLite if PostgreSQL unavailable
+ */
+export declare class PostgresAdapter implements StorageAdapter {
+    readonly kind = "postgres";
+    readonly capabilities: ReadonlySet<StorageCapability>;
+    private options;
+    private pool;
+    private transactionalClient;
+    constructor(options: PostgresAdapterOptions | string);
+    open(openOptions?: StorageOpenOptions): Promise<void>;
+    run(statement: string, parameters?: StorageParameters): Promise<StorageRunResult>;
+    get<T>(statement: string, parameters?: StorageParameters): Promise<T | null>;
+    all<T>(statement: string, parameters?: StorageParameters): Promise<T[]>;
+    exec(script: string): Promise<void>;
+    transaction<T>(fn: (trx: StorageAdapter) => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+    private getExecutor;
+}
+/**
+ * Create a PostgreSQL adapter with connection string.
+ * @param connectionString - PostgreSQL connection string
+ * @example
+ * ```typescript
+ * const db = createPostgresAdapter('postgresql://user:pass@localhost:5432/mydb');
+ * ```
+ */
+export declare function createPostgresAdapter(connectionString: string): StorageAdapter;
+/**
+ * Create a PostgreSQL adapter with configuration options.
+ * @param options - PostgreSQL adapter configuration
+ * @example
+ * ```typescript
+ * const db = createPostgresAdapter({
+ *   host: 'db.example.com',
+ *   database: 'mydb',
+ *   user: 'dbuser',
+ *   password: 'secure_password',
+ *   ssl: true
+ * });
+ * ```
+ */
+export declare function createPostgresAdapter(options: PostgresAdapterOptions): StorageAdapter;
+//# sourceMappingURL=postgresAdapter.d.ts.map

package/dist/adapters/postgresAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/postgresAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG3H;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,GAAG,CAAC,EAAE,OAAO,GAAG;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3F,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAgDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkGG;AACH,qBAAa,eAAgB,YAAW,cAAc;IACpD,SAAgB,IAAI,cAAc;IAClC,SAAgB,YAAY,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAQzD;IAEH,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,mBAAmB,CAA2B;gBAE1C,OAAO,EAAE,sBAAsB,GAAG,MAAM;IASvC,IAAI,CAAC,WAAW,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDrD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOjF,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAO5E,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAOvE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoBnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAOrB,WAAW;CAS1B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,GAAG,cAAc,CAAC;AAEhF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,cAAc,CAAC"}

package/dist/adapters/postgresAdapter.js

@@ -0,0 +1,271 @@
+import { Pool } from 'pg';
+import { normaliseParameters } from '../utils/parameterUtils';
+const isPositional = (statement) => statement.includes('?');
+const buildNamedStatement = (statement, named) => {
+    const order = [];
+    const text = statement.replace(/@([A-Za-z0-9_]+)/g, (_, name) => {
+        order.push(name);
+        return `$${order.length}`;
+    });
+    const values = order.map((key) => named[key]);
+    return { text, values };
+};
+const buildPositionalStatement = (statement, positional) => {
+    let index = 0;
+    const text = statement.replace(/\?/g, () => {
+        index += 1;
+        return `$${index}`;
+    });
+    return { text, values: positional };
+};
+const prepareStatement = (statement, parameters) => {
+    const { named, positional } = normaliseParameters(parameters);
+    if (named) {
+        return buildNamedStatement(statement, named);
+    }
+    if (positional) {
+        return buildPositionalStatement(statement, positional);
+    }
+    if (isPositional(statement)) {
+        return buildPositionalStatement(statement, []);
+    }
+    return { text: statement, values: [] };
+};
+const splitStatements = (script) => script
+    .split(';')
+    .map((part) => part.trim())
+    .filter((part) => part.length > 0);
+/**
+ * PostgreSQL adapter for production-grade SQL operations.
+ *
+ * ## Performance Characteristics
+ * - Connection pooling for efficient resource usage
+ * - Excellent concurrent access with MVCC
+ * - Optimized for complex queries and large datasets
+ * - ~10,000 queries/second with connection pooling
+ *
+ * ## Advantages
+ * - Full SQL feature set (CTEs, window functions, etc.)
+ * - Native JSON/JSONB support
+ * - Robust replication and backup options
+ * - Battle-tested in production environments
+ * - Secure remote connections with SSL/TLS
+ *
+ * ## Limitations
+ * - Requires separate server process
+ * - Network latency for remote connections
+ * - Higher resource consumption than SQLite
+ * - Configuration complexity for optimal performance
+ *
+ * ## When to Use
+ * - Production web applications
+ * - Multi-user systems
+ * - When you need advanced SQL features
+ * - Cloud deployments (AWS RDS, Heroku, Supabase, etc.)
+ * - Remote database access
+ *
+ * ## Remote Connection Examples
+ *
+ * ### Connection String (Recommended)
+ * ```typescript
+ * const db = createPostgresAdapter({
+ *   connectionString: 'postgresql://user:password@db.example.com:5432/mydb?sslmode=require'
+ * });
+ * ```
+ *
+ * ### Granular Configuration
+ * ```typescript
+ * const db = createPostgresAdapter({
+ *   host: 'db.example.com',
+ *   port: 5432,
+ *   database: 'mydb',
+ *   user: 'dbuser',
+ *   password: 'secure_password',
+ *   ssl: true,  // Enable SSL for security
+ *   max: 20,    // Connection pool size
+ *   statement_timeout: 30000  // 30 second timeout
+ * });
+ * ```
+ *
+ * ### Cloud Provider Examples
+ *
+ * #### AWS RDS
+ * ```typescript
+ * const db = createPostgresAdapter({
+ *   host: 'mydb.abc123.us-east-1.rds.amazonaws.com',
+ *   port: 5432,
+ *   database: 'postgres',
+ *   user: 'admin',
+ *   password: process.env.RDS_PASSWORD,
+ *   ssl: { rejectUnauthorized: true }
+ * });
+ * ```
+ *
+ * #### Heroku Postgres
+ * ```typescript
+ * const db = createPostgresAdapter({
+ *   connectionString: process.env.DATABASE_URL,
+ *   ssl: { rejectUnauthorized: false }  // Heroku uses self-signed certs
+ * });
+ * ```
+ *
+ * #### Supabase
+ * ```typescript
+ * const db = createPostgresAdapter({
+ *   connectionString: process.env.SUPABASE_DB_URL,
+ *   ssl: true
+ * });
+ * ```
+ *
+ * #### DigitalOcean Managed Database
+ * ```typescript
+ * const db = createPostgresAdapter({
+ *   host: 'db-postgresql-nyc3-12345.ondigitalocean.com',
+ *   port: 25060,
+ *   database: 'defaultdb',
+ *   user: 'doadmin',
+ *   password: process.env.DO_DB_PASSWORD,
+ *   ssl: { rejectUnauthorized: true, ca: process.env.DO_CA_CERT }
+ * });
+ * ```
+ *
+ * ## Graceful Degradation
+ * - Automatic reconnection on connection loss
+ * - Connection pool handles transient failures
+ * - Falls back to SQLite if PostgreSQL unavailable
+ */
+export class PostgresAdapter {
+    constructor(options) {
+        this.kind = 'postgres';
+        this.capabilities = new Set([
+            'transactions', // Full ACID transaction support
+            'locks', // Row-level and advisory locks
+            'persistence', // Data persisted to disk
+            'concurrent', // Excellent concurrent access
+            'json', // Native JSON/JSONB support
+            'arrays', // Native array data types
+            'prepared' // Prepared statements for security/performance
+        ]);
+        this.pool = null;
+        this.transactionalClient = null;
+        // Support both string and object initialization
+        if (typeof options === 'string') {
+            this.options = { connectionString: options };
+        }
+        else {
+            this.options = options;
+        }
+    }
+    async open(openOptions) {
+        if (this.pool) {
+            return;
+        }
+        // Build pool configuration
+        const poolConfig = {};
+        // Use connection string if provided
+        if (this.options.connectionString || openOptions?.connectionString) {
+            poolConfig.connectionString = openOptions?.connectionString ?? this.options.connectionString;
+        }
+        else {
+            // Build from individual options
+            poolConfig.host = this.options.host ?? 'localhost';
+            poolConfig.port = this.options.port ?? 5432;
+            poolConfig.database = this.options.database;
+            poolConfig.user = this.options.user;
+            poolConfig.password = this.options.password;
+        }
+        // Pool configuration
+        if (this.options.max !== undefined)
+            poolConfig.max = this.options.max;
+        if (this.options.min !== undefined)
+            poolConfig.min = this.options.min;
+        if (this.options.idleTimeoutMillis !== undefined) {
+            poolConfig.idleTimeoutMillis = this.options.idleTimeoutMillis;
+        }
+        if (this.options.connectionTimeoutMillis !== undefined) {
+            poolConfig.connectionTimeoutMillis = this.options.connectionTimeoutMillis;
+        }
+        if (this.options.application_name !== undefined) {
+            poolConfig.application_name = this.options.application_name;
+        }
+        if (this.options.statement_timeout !== undefined) {
+            poolConfig.statement_timeout = this.options.statement_timeout;
+        }
+        if (this.options.query_timeout !== undefined) {
+            poolConfig.query_timeout = this.options.query_timeout;
+        }
+        // SSL configuration
+        if (this.options.ssl !== undefined) {
+            poolConfig.ssl = this.options.ssl;
+        }
+        this.pool = new Pool(poolConfig);
+        // Test connection
+        const client = await this.pool.connect();
+        client.release();
+    }
+    async run(statement, parameters) {
+        const executor = await this.getExecutor();
+        const { text, values } = prepareStatement(statement, parameters);
+        const result = await executor.query(text, values);
+        return { changes: result.rowCount ?? 0, lastInsertRowid: result.rows?.[0]?.id ?? null };
+    }
+    async get(statement, parameters) {
+        const executor = await this.getExecutor();
+        const { text, values } = prepareStatement(statement, parameters);
+        const result = await executor.query(text, values);
+        return result.rows?.[0] ?? null;
+    }
+    async all(statement, parameters) {
+        const executor = await this.getExecutor();
+        const { text, values } = prepareStatement(statement, parameters);
+        const result = await executor.query(text, values);
+        return result.rows ?? [];
+    }
+    async exec(script) {
+        const executor = await this.getExecutor();
+        const statements = splitStatements(script);
+        for (const text of statements) {
+            await executor.query(text);
+        }
+    }
+    async transaction(fn) {
+        if (!this.pool) {
+            throw new Error('Postgres adapter not opened.');
+        }
+        const client = await this.pool.connect();
+        try {
+            await client.query('BEGIN');
+            this.transactionalClient = client;
+            const result = await fn(this);
+            await client.query('COMMIT');
+            return result;
+        }
+        catch (error) {
+            await client.query('ROLLBACK');
+            throw error;
+        }
+        finally {
+            this.transactionalClient = null;
+            client.release();
+        }
+    }
+    async close() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+        }
+    }
+    async getExecutor() {
+        if (this.transactionalClient) {
+            return this.transactionalClient;
+        }
+        if (!this.pool) {
+            throw new Error('Postgres adapter not opened.');
+        }
+        return this.pool;
+    }
+}
+export function createPostgresAdapter(optionsOrString) {
+    return new PostgresAdapter(optionsOrString);
+}
+//# sourceMappingURL=postgresAdapter.js.map

package/dist/adapters/postgresAdapter.js.map

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

package/dist/adapters/sqlJsAdapter.d.ts

@@ -0,0 +1,28 @@
+import type { SqlJsConfig } from 'sql.js';
+import type { StorageAdapter, StorageCapability, StorageOpenOptions, StorageParameters, StorageRunResult } from '../types';
+type SqlJsAdapterOptions = SqlJsConfig;
+/**
+ * Storage adapter backed by sql.js (WebAssembly) for environments without native SQLite bindings.
+ */
+export declare class SqlJsAdapter implements StorageAdapter {
+    private readonly adapterOptions;
+    readonly kind = "sqljs";
+    readonly capabilities: ReadonlySet<StorageCapability>;
+    private SQL;
+    private db;
+    private filePath?;
+    constructor(adapterOptions?: SqlJsAdapterOptions);
+    open(options?: StorageOpenOptions): Promise<void>;
+    run(statement: string, parameters?: StorageParameters): Promise<StorageRunResult>;
+    get<T>(statement: string, parameters?: StorageParameters): Promise<T | null>;
+    all<T>(statement: string, parameters?: StorageParameters): Promise<T[]>;
+    exec(script: string): Promise<void>;
+    transaction<T>(fn: (trx: StorageAdapter) => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+    private prepareInternal;
+    private ensureOpen;
+    private persistIfNeeded;
+}
+export declare const createSqlJsAdapter: (options?: SqlJsAdapterOptions) => StorageAdapter;
+export {};
+//# sourceMappingURL=sqlJsAdapter.d.ts.map

package/dist/adapters/sqlJsAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlJsAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/sqlJsAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,WAAW,EAA6B,MAAM,QAAQ,CAAC;AAGlF,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG3H,KAAK,mBAAmB,GAAG,WAAW,CAAC;AAUvC;;GAEG;AACH,qBAAa,YAAa,YAAW,cAAc;IAQrC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAP3C,SAAgB,IAAI,WAAW;IAC/B,SAAgB,YAAY,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAE7D,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAEG,cAAc,GAAE,mBAAwB;IAQxD,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiBjF,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5E,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAwBvE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAcnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,UAAU;YAMJ,eAAe;CAW9B;AAED,eAAO,MAAM,kBAAkB,GAAI,UAAU,mBAAmB,KAAG,cAA2C,CAAC"}