sqlew 5.0.8 → 5.2.0

package/dist/adapters/postgresql-adapter.d.ts

@@ -1,36 +1,7 @@
 import type { Knex } from 'knex';
 import { BaseAdapter } from './base-adapter.js';
 import type { DatabaseConfig } from '../config/types.js';
-/**
- * PostgreSQL adapter implementation with authentication support.
- *
- * This adapter provides PostgreSQL-specific implementations for database operations,
- * integrating with the authentication layer for secure connections via SSH tunnels,
- * direct connections, or cloud IAM (AWS RDS, GCP Cloud SQL).
- *
- * **PostgreSQL-Specific Features:**
- * - RETURNING clause for insert/update/delete
- * - ON CONFLICT ... DO UPDATE for upserts
- * - jsonb_extract_path() and jsonb_build_object() for JSON operations
- * - string_agg() for string aggregation
- * - EXTRACT(EPOCH FROM ...) for Unix timestamp conversions
- * - SERIAL/BIGSERIAL for auto-increment columns
- * - Full transaction support with savepoints
- * - Common Table Expressions (CTEs) and window functions
- *
- * **Supported PostgreSQL Versions:**
- * - PostgreSQL 16+ (full feature support)
- * - PostgreSQL 12-15 (full feature support)
- * - PostgreSQL 9.5+ (basic feature support)
- *
- * **Authentication Methods:**
- * - Direct: Standard username/password authentication
- * - SSH Tunnel: Connect via SSH bastion host
- * - AWS RDS IAM: Token-based authentication for AWS RDS
- * - GCP Cloud SQL IAM: Token-based authentication for Cloud SQL
- *
- * @extends BaseAdapter
- */
+/** PostgreSQL adapter with authentication support. */
 export declare class PostgreSQLAdapter extends BaseAdapter {
     readonly supportsReturning = true;
     readonly supportsJSON = true;
@@ -40,195 +11,36 @@ export declare class PostgreSQLAdapter extends BaseAdapter {
     readonly supportsSavepoints = true;
     readonly databaseName: "postgresql";
     constructor(config: DatabaseConfig);
-    /**
-     * Returns the Knex dialect for PostgreSQL.
-     *
-     * Uses 'pg' driver which supports:
-     * - Prepared statements
-     * - Promise-based API
-     * - Connection pooling
-     * - Full Unicode support
-     *
-     * @returns {string} 'pg' dialect identifier
-     */
     getDialect(): string;
-    /**
-     * Initializes PostgreSQL-specific session settings.
-     *
-     * **Configuration Applied:**
-     * - Timezone: UTC for consistent timestamp handling
-     * - Statement timeout: 30 seconds (prevents long-running queries)
-     * - Client encoding: UTF8 for full Unicode support
-     * - Default transaction isolation: READ COMMITTED
-     *
-     * @returns {Promise<void>}
-     * @throws {Error} If database does not exist or cannot be accessed
-     */
+    /** Initializes PostgreSQL-specific session settings (UTC, timeout, UTF8). */
     initialize(): Promise<void>;
-    /**
-     * Inserts a row and returns the inserted record using RETURNING clause.
-     *
-     * PostgreSQL supports RETURNING clause natively, making this more efficient
-     * than MySQL's approach (insert + select).
-     *
-     * @template T - Record type
-     * @param {string} table - Table name
-     * @param {Partial<T>} data - Data to insert
-     * @returns {Promise<T>} Inserted record
-     * @throws {Error} If insert fails
-     */
+    /** Inserts a row and returns the inserted record using RETURNING clause. */
     insertReturning<T extends Record<string, any>>(table: string, data: Partial<T>): Promise<T>;
-    /**
-     * Upserts a row using PostgreSQL's ON CONFLICT ... DO UPDATE syntax.
-     *
-     * **Behavior:**
-     * - If row with conflicting key exists: UPDATE specified columns
-     * - If no conflict: INSERT new row
-     * - Returns number of affected rows
-     *
-     * @template T - Record type
-     * @param {string} table - Table name
-     * @param {Partial<T>} data - Data to insert/update
-     * @param {string[]} conflictColumns - Columns that define uniqueness (must have UNIQUE index)
-     * @param {string[]} [updateColumns] - Columns to update on conflict (default: all except conflict columns)
-     * @returns {Promise<number>} Affected rows (1 = insert or update)
-     * @throws {Error} If conflictColumns don't have UNIQUE constraint
-     */
+    /** Upserts a row using ON CONFLICT ... DO UPDATE. */
     upsert<T extends Record<string, any>>(table: string, data: Partial<T>, conflictColumns: string[], updateColumns?: string[]): Promise<number>;
-    /**
-     * Extracts a value from a JSONB column using jsonb_extract_path_text().
-     *
-     * **PostgreSQL JSON Path Syntax:**
-     * - Nested objects: 'address', 'city' (separate arguments)
-     * - Array access: Use jsonb_array_element() separately
-     *
-     * @param {string} column - JSONB column name
-     * @param {string} path - JSON path (e.g., 'address.city')
-     * @returns {Knex.Raw} Raw SQL expression for JSON extraction
-     */
+    /** Extracts a value from a JSONB column using jsonb_extract_path_text(). */
     jsonExtract(column: string, path: string): Knex.Raw;
-    /**
-     * Builds a JSON object from field values using jsonb_build_object().
-     *
-     * @param {Record<string, any>} fields - Object with key-value pairs
-     * @returns {Knex.Raw} Raw SQL expression for JSON object construction
-     */
+    /** Builds a JSON object using jsonb_build_object(). */
     jsonBuildObject(fields: Record<string, any>): Knex.Raw;
-    /**
-     * Returns current Unix timestamp using EXTRACT(EPOCH FROM NOW()).
-     *
-     * **Behavior:**
-     * - Returns seconds since Unix epoch (1970-01-01 00:00:00 UTC)
-     * - Always returns UTC timestamp
-     * - Returns numeric value (may have fractional seconds)
-     *
-     * @returns {Knex.Raw} Raw SQL expression for current timestamp
-     */
+    /** Returns current Unix timestamp using EXTRACT(EPOCH FROM NOW()). */
     currentTimestamp(): Knex.Raw;
-    /**
-     * Converts Unix epoch timestamp to PostgreSQL timestamp using TO_TIMESTAMP().
-     *
-     * **Behavior:**
-     * - Converts integer epoch to TIMESTAMP WITH TIME ZONE
-     * - Returns UTC timestamp
-     * - Handles NULL values
-     *
-     * @param {string} epochColumn - Column containing Unix epoch timestamp
-     * @returns {Knex.Raw} Raw SQL expression for epoch conversion
-     */
+    /** Converts Unix epoch to timestamp using TO_TIMESTAMP(). */
     fromUnixEpoch(epochColumn: string): Knex.Raw;
-    /**
-     * Converts PostgreSQL timestamp to Unix epoch using EXTRACT(EPOCH FROM ...).
-     *
-     * **Behavior:**
-     * - Converts TIMESTAMP to integer epoch
-     * - Assumes input is UTC
-     * - Handles NULL values
-     *
-     * @param {string} timestampColumn - Column containing timestamp value
-     * @returns {Knex.Raw} Raw SQL expression for timestamp conversion
-     */
+    /** Converts timestamp to Unix epoch using EXTRACT(EPOCH FROM ...). */
     toUnixEpoch(timestampColumn: string): Knex.Raw;
-    /**
-     * Concatenates string values using || operator.
-     *
-     * **Behavior:**
-     * - PostgreSQL uses || for concatenation
-     * - Returns NULL if any argument is NULL (use COALESCE to handle)
-     * - Empty strings are preserved
-     *
-     * @param {...(string | Knex.Raw)[]} values - Values to concatenate
-     * @returns {Knex.Raw} Raw SQL expression for concatenation
-     */
+    /** Concatenates string values using || operator. */
     concat(...values: Array<string | Knex.Raw>): Knex.Raw;
-    /**
-     * Aggregates strings with separator using string_agg().
-     *
-     * **Behavior:**
-     * - Concatenates values from multiple rows into single string
-     * - NULL values are skipped
-     * - No result length limit (unlike MySQL's GROUP_CONCAT)
-     *
-     * @param {string} column - Column to aggregate
-     * @param {string} [separator=','] - Separator between values
-     * @returns {Knex.Raw} Raw SQL expression for string aggregation
-     */
+    /** Aggregates strings with separator using string_agg(). */
     stringAgg(column: string, separator?: string): Knex.Raw;
-    /**
-     * Executes a callback within a database transaction.
-     *
-     * **PostgreSQL Transaction Characteristics:**
-     * - Default isolation level: READ COMMITTED
-     * - Supports nested transactions via savepoints
-     * - Automatic rollback on error
-     * - MVCC (Multi-Version Concurrency Control)
-     *
-     * @template T - Return type
-     * @param {Function} callback - Transaction callback
-     * @param {Object} [options] - Transaction options
-     * @param {string} [options.isolationLevel] - Isolation level
-     * @returns {Promise<T>} Transaction result
-     */
+    /** Executes a callback within a PostgreSQL transaction. */
     transaction<T>(callback: (trx: Knex.Transaction) => Promise<T>, options?: {
         isolationLevel?: 'serializable' | 'read committed' | 'repeatable read';
     }): Promise<T>;
-    /**
-     * Creates a savepoint within a transaction.
-     *
-     * **PostgreSQL Savepoint Behavior:**
-     * - Allows partial rollback within transaction
-     * - Savepoint names are case-sensitive
-     * - Automatically released on transaction commit
-     * - Rolled back on transaction rollback
-     *
-     * @template T - Return type
-     * @param {Knex.Transaction} trx - Parent transaction
-     * @param {Function} callback - Savepoint callback
-     * @returns {Promise<T>} Savepoint result
-     */
+    /** Creates a savepoint within a transaction. */
     savepoint<T>(trx: Knex.Transaction, callback: (sp: Knex.Transaction) => Promise<T>): Promise<T>;
-    /**
-     * Checks if a table exists in the database.
-     *
-     * Queries information_schema.tables which is the standard PostgreSQL approach
-     * for table existence checking.
-     *
-     * @param {string} tableName - Table name to check
-     * @returns {Promise<boolean>} True if table exists, false otherwise
-     */
+    /** Checks if a table exists via information_schema. */
     tableExists(tableName: string): Promise<boolean>;
-    /**
-     * Adds a serial auto-increment primary key column to a table.
-     *
-     * **PostgreSQL SERIAL Behavior:**
-     * - SERIAL = INTEGER with auto-increment (sequence)
-     * - BIGSERIAL = BIGINT with auto-increment (recommended for large tables)
-     * - Automatically creates a sequence (tablename_columnname_seq)
-     * - Primary key constraint added automatically
-     *
-     * @param {Knex.CreateTableBuilder} table - Knex table builder
-     * @param {string} [columnName='id'] - Column name (default: 'id')
-     */
+    /** Adds a serial auto-increment primary key column. */
     autoIncrementColumn(table: Knex.CreateTableBuilder, columnName?: string): void;
 }
 //# sourceMappingURL=postgresql-adapter.d.ts.map

package/dist/adapters/postgresql-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postgresql-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/postgresql-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"postgresql-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/postgresql-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,sDAAsD;AACtD,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,QAAQ,CAAC,iBAAiB,QAAQ;IAClC,QAAQ,CAAC,YAAY,QAAQ;IAC7B,QAAQ,CAAC,cAAc,QAAQ;IAC/B,QAAQ,CAAC,WAAW,QAAQ;IAC5B,QAAQ,CAAC,uBAAuB,QAAQ;IACxC,QAAQ,CAAC,kBAAkB,QAAQ;IACnC,QAAQ,CAAC,YAAY,EAAG,YAAY,CAAU;gBAElC,MAAM,EAAE,cAAc;IAIlC,UAAU,IAAI,MAAM;IAIpB,6EAA6E;IACvE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyCjC,4EAA4E;IACtE,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GACf,OAAO,CAAC,CAAC,CAAC;IAab,qDAAqD;IAC/C,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAChB,eAAe,EAAE,MAAM,EAAE,EACzB,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC;IAuBlB,4EAA4E;IAC5E,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAQnD,uDAAuD;IACvD,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG;IAiBtD,sEAAsE;IACtE,gBAAgB,IAAI,IAAI,CAAC,GAAG;IAI5B,6DAA6D;IAC7D,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAI5C,sEAAsE;IACtE,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAI9C,oDAAoD;IACpD,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG;IAMrD,4DAA4D;IAC5D,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,IAAI,CAAC,GAAG;IAI5D,2DAA2D;IACrD,WAAW,CAAC,CAAC,EACjB,QAAQ,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAC/C,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,cAAc,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;KAAE,GACnF,OAAO,CAAC,CAAC,CAAC;IAIb,gDAAgD;IAC1C,SAAS,CAAC,CAAC,EACf,GAAG,EAAE,IAAI,CAAC,WAAW,EACrB,QAAQ,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7C,OAAO,CAAC,CAAC,CAAC;IAIb,uDAAuD;IACjD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAetD,uDAAuD;IACvD,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAE,MAAa,GAAG,IAAI;CAIrF"}

package/dist/adapters/postgresql-adapter.js

@@ -1,72 +1,20 @@
 import { BaseAdapter } from './base-adapter.js';
-/**
- * PostgreSQL adapter implementation with authentication support.
- *
- * This adapter provides PostgreSQL-specific implementations for database operations,
- * integrating with the authentication layer for secure connections via SSH tunnels,
- * direct connections, or cloud IAM (AWS RDS, GCP Cloud SQL).
- *
- * **PostgreSQL-Specific Features:**
- * - RETURNING clause for insert/update/delete
- * - ON CONFLICT ... DO UPDATE for upserts
- * - jsonb_extract_path() and jsonb_build_object() for JSON operations
- * - string_agg() for string aggregation
- * - EXTRACT(EPOCH FROM ...) for Unix timestamp conversions
- * - SERIAL/BIGSERIAL for auto-increment columns
- * - Full transaction support with savepoints
- * - Common Table Expressions (CTEs) and window functions
- *
- * **Supported PostgreSQL Versions:**
- * - PostgreSQL 16+ (full feature support)
- * - PostgreSQL 12-15 (full feature support)
- * - PostgreSQL 9.5+ (basic feature support)
- *
- * **Authentication Methods:**
- * - Direct: Standard username/password authentication
- * - SSH Tunnel: Connect via SSH bastion host
- * - AWS RDS IAM: Token-based authentication for AWS RDS
- * - GCP Cloud SQL IAM: Token-based authentication for Cloud SQL
- *
- * @extends BaseAdapter
- */
+/** PostgreSQL adapter with authentication support. */
 export class PostgreSQLAdapter extends BaseAdapter {
-    // Feature detection
-    supportsReturning = true; // RETURNING clause support
-    supportsJSON = true; // Native JSON/JSONB support
-    supportsUpsert = true; // ON CONFLICT support (9.5+)
-    supportsCTE = true; // WITH clause support
-    supportsWindowFunctions = true; // Window functions support
-    supportsSavepoints = true; // Full savepoint support
+    supportsReturning = true;
+    supportsJSON = true;
+    supportsUpsert = true;
+    supportsCTE = true;
+    supportsWindowFunctions = true;
+    supportsSavepoints = true;
     databaseName = 'postgresql';
     constructor(config) {
         super(config);
     }
-    /**
-     * Returns the Knex dialect for PostgreSQL.
-     *
-     * Uses 'pg' driver which supports:
-     * - Prepared statements
-     * - Promise-based API
-     * - Connection pooling
-     * - Full Unicode support
-     *
-     * @returns {string} 'pg' dialect identifier
-     */
     getDialect() {
         return 'pg';
     }
-    /**
-     * Initializes PostgreSQL-specific session settings.
-     *
-     * **Configuration Applied:**
-     * - Timezone: UTC for consistent timestamp handling
-     * - Statement timeout: 30 seconds (prevents long-running queries)
-     * - Client encoding: UTF8 for full Unicode support
-     * - Default transaction isolation: READ COMMITTED
-     *
-     * @returns {Promise<void>}
-     * @throws {Error} If database does not exist or cannot be accessed
-     */
+    /** Initializes PostgreSQL-specific session settings (UTC, timeout, UTF8). */
     async initialize() {
         const knex = this.getKnex();
         // Validate database exists
@@ -98,21 +46,7 @@ export class PostgreSQLAdapter extends BaseAdapter {
         // Ensure UTF8 encoding
         await knex.raw("SET client_encoding = 'UTF8'");
     }
-    // ============================================================================
-    // Query Adaptations - PostgreSQL-specific implementations
-    // ============================================================================
-    /**
-     * Inserts a row and returns the inserted record using RETURNING clause.
-     *
-     * PostgreSQL supports RETURNING clause natively, making this more efficient
-     * than MySQL's approach (insert + select).
-     *
-     * @template T - Record type
-     * @param {string} table - Table name
-     * @param {Partial<T>} data - Data to insert
-     * @returns {Promise<T>} Inserted record
-     * @throws {Error} If insert fails
-     */
+    /** Inserts a row and returns the inserted record using RETURNING clause. */
     async insertReturning(table, data) {
         const knex = this.getKnex();
         // Use RETURNING * to get the complete inserted row
@@ -122,22 +56,7 @@ export class PostgreSQLAdapter extends BaseAdapter {
         }
         return result;
     }
-    /**
-     * Upserts a row using PostgreSQL's ON CONFLICT ... DO UPDATE syntax.
-     *
-     * **Behavior:**
-     * - If row with conflicting key exists: UPDATE specified columns
-     * - If no conflict: INSERT new row
-     * - Returns number of affected rows
-     *
-     * @template T - Record type
-     * @param {string} table - Table name
-     * @param {Partial<T>} data - Data to insert/update
-     * @param {string[]} conflictColumns - Columns that define uniqueness (must have UNIQUE index)
-     * @param {string[]} [updateColumns] - Columns to update on conflict (default: all except conflict columns)
-     * @returns {Promise<number>} Affected rows (1 = insert or update)
-     * @throws {Error} If conflictColumns don't have UNIQUE constraint
-     */
+    /** Upserts a row using ON CONFLICT ... DO UPDATE. */
     async upsert(table, data, conflictColumns, updateColumns) {
         const knex = this.getKnex();
         // Determine which columns to update on conflict
@@ -154,17 +73,7 @@ export class PostgreSQLAdapter extends BaseAdapter {
             .merge(updateData);
         return result.length;
     }
-    /**
-     * Extracts a value from a JSONB column using jsonb_extract_path_text().
-     *
-     * **PostgreSQL JSON Path Syntax:**
-     * - Nested objects: 'address', 'city' (separate arguments)
-     * - Array access: Use jsonb_array_element() separately
-     *
-     * @param {string} column - JSONB column name
-     * @param {string} path - JSON path (e.g., 'address.city')
-     * @returns {Knex.Raw} Raw SQL expression for JSON extraction
-     */
+    /** Extracts a value from a JSONB column using jsonb_extract_path_text(). */
     jsonExtract(column, path) {
         const knex = this.getKnex();
         // Split path by '.' and use as separate arguments
@@ -172,12 +81,7 @@ export class PostgreSQLAdapter extends BaseAdapter {
         const placeholders = ['??', ...pathParts.map(() => '?')].join(', ');
         return knex.raw(`jsonb_extract_path_text(${placeholders})`, [column, ...pathParts]);
     }
-    /**
-     * Builds a JSON object from field values using jsonb_build_object().
-     *
-     * @param {Record<string, any>} fields - Object with key-value pairs
-     * @returns {Knex.Raw} Raw SQL expression for JSON object construction
-     */
+    /** Builds a JSON object using jsonb_build_object(). */
     jsonBuildObject(fields) {
         const knex = this.getKnex();
         const keys = Object.keys(fields);
@@ -192,150 +96,47 @@ export class PostgreSQLAdapter extends BaseAdapter {
         const placeholders = args.map(() => '?').join(', ');
         return knex.raw(`jsonb_build_object(${placeholders})`, args);
     }
-    /**
-     * Returns current Unix timestamp using EXTRACT(EPOCH FROM NOW()).
-     *
-     * **Behavior:**
-     * - Returns seconds since Unix epoch (1970-01-01 00:00:00 UTC)
-     * - Always returns UTC timestamp
-     * - Returns numeric value (may have fractional seconds)
-     *
-     * @returns {Knex.Raw} Raw SQL expression for current timestamp
-     */
+    /** Returns current Unix timestamp using EXTRACT(EPOCH FROM NOW()). */
     currentTimestamp() {
         return this.getKnex().raw('EXTRACT(EPOCH FROM NOW())::INTEGER');
     }
-    /**
-     * Converts Unix epoch timestamp to PostgreSQL timestamp using TO_TIMESTAMP().
-     *
-     * **Behavior:**
-     * - Converts integer epoch to TIMESTAMP WITH TIME ZONE
-     * - Returns UTC timestamp
-     * - Handles NULL values
-     *
-     * @param {string} epochColumn - Column containing Unix epoch timestamp
-     * @returns {Knex.Raw} Raw SQL expression for epoch conversion
-     */
+    /** Converts Unix epoch to timestamp using TO_TIMESTAMP(). */
     fromUnixEpoch(epochColumn) {
         return this.getKnex().raw('TO_TIMESTAMP(??)', [epochColumn]);
     }
-    /**
-     * Converts PostgreSQL timestamp to Unix epoch using EXTRACT(EPOCH FROM ...).
-     *
-     * **Behavior:**
-     * - Converts TIMESTAMP to integer epoch
-     * - Assumes input is UTC
-     * - Handles NULL values
-     *
-     * @param {string} timestampColumn - Column containing timestamp value
-     * @returns {Knex.Raw} Raw SQL expression for timestamp conversion
-     */
+    /** Converts timestamp to Unix epoch using EXTRACT(EPOCH FROM ...). */
     toUnixEpoch(timestampColumn) {
         return this.getKnex().raw('EXTRACT(EPOCH FROM ??)::INTEGER', [timestampColumn]);
     }
-    /**
-     * Concatenates string values using || operator.
-     *
-     * **Behavior:**
-     * - PostgreSQL uses || for concatenation
-     * - Returns NULL if any argument is NULL (use COALESCE to handle)
-     * - Empty strings are preserved
-     *
-     * @param {...(string | Knex.Raw)[]} values - Values to concatenate
-     * @returns {Knex.Raw} Raw SQL expression for concatenation
-     */
+    /** Concatenates string values using || operator. */
     concat(...values) {
         const knex = this.getKnex();
         const placeholders = values.map(() => '?').join(' || ');
         return knex.raw(`(${placeholders})`, values);
     }
-    /**
-     * Aggregates strings with separator using string_agg().
-     *
-     * **Behavior:**
-     * - Concatenates values from multiple rows into single string
-     * - NULL values are skipped
-     * - No result length limit (unlike MySQL's GROUP_CONCAT)
-     *
-     * @param {string} column - Column to aggregate
-     * @param {string} [separator=','] - Separator between values
-     * @returns {Knex.Raw} Raw SQL expression for string aggregation
-     */
+    /** Aggregates strings with separator using string_agg(). */
     stringAgg(column, separator = ',') {
         return this.getKnex().raw('string_agg(??, ?)', [column, separator]);
     }
-    // ============================================================================
-    // Transaction Support
-    // ============================================================================
-    /**
-     * Executes a callback within a database transaction.
-     *
-     * **PostgreSQL Transaction Characteristics:**
-     * - Default isolation level: READ COMMITTED
-     * - Supports nested transactions via savepoints
-     * - Automatic rollback on error
-     * - MVCC (Multi-Version Concurrency Control)
-     *
-     * @template T - Return type
-     * @param {Function} callback - Transaction callback
-     * @param {Object} [options] - Transaction options
-     * @param {string} [options.isolationLevel] - Isolation level
-     * @returns {Promise<T>} Transaction result
-     */
+    /** Executes a callback within a PostgreSQL transaction. */
     async transaction(callback, options) {
-        // Delegate to BaseAdapter's implementation
         return super.transaction(callback, options);
     }
-    /**
-     * Creates a savepoint within a transaction.
-     *
-     * **PostgreSQL Savepoint Behavior:**
-     * - Allows partial rollback within transaction
-     * - Savepoint names are case-sensitive
-     * - Automatically released on transaction commit
-     * - Rolled back on transaction rollback
-     *
-     * @template T - Return type
-     * @param {Knex.Transaction} trx - Parent transaction
-     * @param {Function} callback - Savepoint callback
-     * @returns {Promise<T>} Savepoint result
-     */
+    /** Creates a savepoint within a transaction. */
     async savepoint(trx, callback) {
         return trx.savepoint(callback);
     }
-    // ============================================================================
-    // Schema Management
-    // ============================================================================
-    /**
-     * Checks if a table exists in the database.
-     *
-     * Queries information_schema.tables which is the standard PostgreSQL approach
-     * for table existence checking.
-     *
-     * @param {string} tableName - Table name to check
-     * @returns {Promise<boolean>} True if table exists, false otherwise
-     */
+    /** Checks if a table exists via information_schema. */
     async tableExists(tableName) {
         const knex = this.getKnex();
         const database = this.config.connection.database;
-        const result = await knex.raw(`SELECT table_name
-       FROM information_schema.tables
-       WHERE table_catalog = ?
+        const result = await knex.raw(`SELECT table_name
+       FROM information_schema.tables
+       WHERE table_catalog = ?
          AND table_name = ?`, [database, tableName]);
         return result.rows.length > 0;
     }
-    /**
-     * Adds a serial auto-increment primary key column to a table.
-     *
-     * **PostgreSQL SERIAL Behavior:**
-     * - SERIAL = INTEGER with auto-increment (sequence)
-     * - BIGSERIAL = BIGINT with auto-increment (recommended for large tables)
-     * - Automatically creates a sequence (tablename_columnname_seq)
-     * - Primary key constraint added automatically
-     *
-     * @param {Knex.CreateTableBuilder} table - Knex table builder
-     * @param {string} [columnName='id'] - Column name (default: 'id')
-     */
+    /** Adds a serial auto-increment primary key column. */
     autoIncrementColumn(table, columnName = 'id') {
         // Use increments() which creates SERIAL PRIMARY KEY for PostgreSQL
         table.increments(columnName);

package/dist/adapters/postgresql-adapter.js.map

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

package/dist/adapters/sqlite-adapter.d.ts

@@ -1,14 +1,7 @@
 import type { Knex } from 'knex';
 import { BaseAdapter } from './base-adapter.js';
 import type { DatabaseConfig } from '../config/types.js';
-/**
- * SQLite adapter implementation with BaseAdapter integration.
- *
- * SQLite is a file-based database that doesn't require authentication,
- * so this adapter overrides the connect() method to bypass the auth flow.
- *
- * @extends BaseAdapter
- */
+/** SQLite adapter (file-based, no authentication required). */
 export declare class SQLiteAdapter extends BaseAdapter {
     readonly supportsReturning = false;
     readonly supportsJSON = false;
@@ -17,30 +10,13 @@ export declare class SQLiteAdapter extends BaseAdapter {
     readonly supportsWindowFunctions = true;
     readonly supportsSavepoints = true;
     readonly databaseName: "sqlite";
-    /**
-     * Creates a new SQLite adapter instance.
-     *
-     * @param config - Database configuration (auth is ignored for SQLite)
-     */
     constructor(config: DatabaseConfig);
-    /**
-     * Returns the Knex dialect for SQLite.
-     */
     getDialect(): string;
-    /**
-     * Initializes SQLite-specific settings (PRAGMA configuration).
-     */
+    /** Initializes SQLite-specific settings (PRAGMA configuration). */
     initialize(): Promise<void>;
-    /**
-     * Establishes SQLite connection (overrides BaseAdapter to bypass auth).
-     *
-     * SQLite doesn't require authentication, so we create the Knex instance
-     * directly without going through the authentication provider flow.
-     */
+    /** Establishes SQLite connection (bypasses auth flow). */
     connect(config?: Knex.Config): Promise<Knex>;
-    /**
-     * Closes SQLite connection.
-     */
+    /** Closes SQLite connection with WAL checkpoint. */
     disconnect(): Promise<void>;
     insertReturning<T extends Record<string, any>>(table: string, data: Partial<T>): Promise<T>;
     upsert<T extends Record<string, any>>(table: string, data: Partial<T>, conflictColumns: string[], updateColumns?: string[]): Promise<number>;