sqlew 3.7.4 → 3.8.1

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

@@ -4,8 +4,30 @@ import type { DatabaseConfig } from '../config/types.js';
 /**
  * PostgreSQL adapter implementation with authentication support.
  *
- * This adapter will be fully implemented in Phase 3 of the multi-RDBMS migration.
- * Currently throws "not implemented" errors for all operations.
+ * 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
  */
@@ -18,25 +40,195 @@ 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
+     */
     initialize(): Promise<void>;
-    connect(config?: Knex.Config): Promise<Knex>;
-    disconnect(): Promise<void>;
-    getKnex(): Knex;
+    /**
+     * 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
+     */
     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
+     */
     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
+     */
     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
+     */
     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
+     */
     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
+     */
     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
+     */
     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
+     */
     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
+     */
     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
+     */
     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
+     */
     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
+     */
     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')
+     */
     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":"AAEA,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;AAIzD;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAEhD,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;IAId,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,IAAI,IAAI;IAIT,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;IAIP,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;IAIlB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAInD,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG;IAItD,gBAAgB,IAAI,IAAI,CAAC,GAAG;IAI5B,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAI5C,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAI9C,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG;IAIrD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAIjD,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;IAIP,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;IAIP,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;CAG/E"}
+{"version":3,"file":"postgresql-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/postgresql-adapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/postgresql-adapter.js

@@ -1,80 +1,344 @@
-// src/adapters/postgresql-adapter.ts
-import knexLib from 'knex';
 import { BaseAdapter } from './base-adapter.js';
-const { knex } = knexLib;
 /**
  * PostgreSQL adapter implementation with authentication support.
  *
- * This adapter will be fully implemented in Phase 3 of the multi-RDBMS migration.
- * Currently throws "not implemented" errors for all operations.
+ * 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
  */
 export class PostgreSQLAdapter extends BaseAdapter {
     // Feature detection
-    supportsReturning = true;
-    supportsJSON = true;
-    supportsUpsert = true;
-    supportsCTE = true;
-    supportsWindowFunctions = true;
-    supportsSavepoints = true;
+    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
     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
+     */
     async initialize() {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
-    }
-    async connect(config) {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
-    }
-    async disconnect() {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
-    }
-    getKnex() {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+        const knex = this.getKnex();
+        // Validate database exists
+        const dbName = this.config.connection?.database;
+        if (!dbName) {
+            throw new Error('PostgreSQL adapter requires database name in configuration');
+        }
+        try {
+            // Check if we can access the database
+            const result = await knex.raw('SELECT current_database() as db');
+            const currentDb = result.rows?.[0]?.db;
+            if (!currentDb || currentDb !== dbName) {
+                throw new Error(`Database '${dbName}' does not exist or cannot be accessed. ` +
+                    `Please create it manually: CREATE DATABASE ${dbName} ENCODING 'UTF8';`);
+            }
+        }
+        catch (error) {
+            if (error.code === '3D000') {
+                // INVALID CATALOG NAME
+                throw new Error(`Database '${dbName}' does not exist. ` +
+                    `Please create it manually before connecting.`);
+            }
+            throw error;
+        }
+        // Set timezone to UTC for consistent timestamp handling
+        await knex.raw("SET timezone = 'UTC'");
+        // Set statement timeout to prevent long-running queries
+        await knex.raw('SET statement_timeout = 30000'); // 30 seconds
+        // 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
+     */
     async insertReturning(table, data) {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+        const knex = this.getKnex();
+        // Use RETURNING * to get the complete inserted row
+        const [result] = await knex(table).insert(data).returning('*');
+        if (!result) {
+            throw new Error(`Failed to insert row into ${table}`);
+        }
+        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
+     */
     async upsert(table, data, conflictColumns, updateColumns) {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+        const knex = this.getKnex();
+        // Determine which columns to update on conflict
+        const columnsToUpdate = updateColumns || Object.keys(data).filter(key => !conflictColumns.includes(key));
+        // Build update data for DO UPDATE SET clause
+        const updateData = columnsToUpdate.reduce((acc, col) => {
+            acc[col] = data[col];
+            return acc;
+        }, {});
+        // Use Knex's onConflict() which generates ON CONFLICT ... DO UPDATE for PostgreSQL
+        const result = await knex(table)
+            .insert(data)
+            .onConflict(conflictColumns)
+            .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
+     */
     jsonExtract(column, path) {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+        const knex = this.getKnex();
+        // Split path by '.' and use as separate arguments
+        const pathParts = path.replace(/^\$\.?/, '').split('.');
+        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
+     */
     jsonBuildObject(fields) {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+        const knex = this.getKnex();
+        const keys = Object.keys(fields);
+        const values = Object.values(fields);
+        // Build arguments array: [key1, value1, key2, value2, ...]
+        const args = [];
+        keys.forEach((key, i) => {
+            args.push(key);
+            args.push(values[i]);
+        });
+        // Create placeholders for jsonb_build_object(?, ?, ?, ?, ...)
+        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
+     */
     currentTimestamp() {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+        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
+     */
     fromUnixEpoch(epochColumn) {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+        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
+     */
     toUnixEpoch(timestampColumn) {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+        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
+     */
     concat(...values) {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+        const knex = this.getKnex();
+        const placeholders = values.map(() => '?').join(' || ');
+        return knex.raw(`(${placeholders})`, values);
     }
-    stringAgg(column, separator) {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+    /**
+     * 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
+     */
+    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
+     */
     async transaction(callback, options) {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+        // 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
+     */
     async savepoint(trx, callback) {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+        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
+     */
     async tableExists(tableName) {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+        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 = ?
+         AND table_name = ?`, [database, tableName]);
+        return result.rows.length > 0;
     }
-    autoIncrementColumn(table, columnName) {
-        throw new Error('PostgreSQL adapter not implemented yet. Planned for Phase 3.');
+    /**
+     * 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')
+     */
+    autoIncrementColumn(table, columnName = 'id') {
+        // Use increments() which creates SERIAL PRIMARY KEY for PostgreSQL
+        table.increments(columnName);
     }
 }
 //# sourceMappingURL=postgresql-adapter.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"postgresql-adapter.js","sourceRoot":"","sources":["../../src/adapters/postgresql-adapter.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,OAAO,MAAM,MAAM,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAChD,oBAAoB;IACX,iBAAiB,GAAG,IAAI,CAAC;IACzB,YAAY,GAAG,IAAI,CAAC;IACpB,cAAc,GAAG,IAAI,CAAC;IACtB,WAAW,GAAG,IAAI,CAAC;IACnB,uBAAuB,GAAG,IAAI,CAAC;IAC/B,kBAAkB,GAAG,IAAI,CAAC;IAC1B,YAAY,GAAG,YAAqB,CAAC;IAE9C,YAAY,MAAsB;QAChC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAoB;QAChC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,OAAO;QACL,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,KAAa,EACb,IAAgB;QAEhB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAa,EACb,IAAgB,EAChB,eAAyB,EACzB,aAAwB;QAExB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,WAAW,CAAC,MAAc,EAAE,IAAY;QACtC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,eAAe,CAAC,MAA2B;QACzC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,gBAAgB;QACd,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,aAAa,CAAC,WAAmB;QAC/B,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,WAAW,CAAC,eAAuB;QACjC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,CAAC,GAAG,MAAgC;QACxC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,SAAS,CAAC,MAAc,EAAE,SAAkB;QAC1C,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,WAAW,CACf,QAA+C,EAC/C,OAAoF;QAEpF,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,SAAS,CACb,GAAqB,EACrB,QAA8C;QAE9C,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB;QACjC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,mBAAmB,CAAC,KAA8B,EAAE,UAAmB;QACrE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;CACF"}
+{"version":3,"file":"postgresql-adapter.js","sourceRoot":"","sources":["../../src/adapters/postgresql-adapter.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * CLI for sqlew - Standalone query commands for mcp-sqlew
- * Provides quick terminal access to decisions, messages, files, and activity logs
+ * Provides quick terminal access to decisions, messages, and files
  */
 export {};
 //# sourceMappingURL=cli.d.ts.map