@warlock.js/cascade 4.0.174 → 4.1.2

package/esm/drivers/postgres/postgres-driver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-driver.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/drivers/postgres/postgres-driver.ts"],"sourcesContent":["/**\r\n * PostgreSQL Driver\r\n *\r\n * Main driver implementation for PostgreSQL database operations.\r\n * Implements the DriverContract interface to provide a unified API\r\n * for CRUD operations, transactions, and query building.\r\n *\r\n * Uses the `pg` package for database connectivity with connection pooling.\r\n *\r\n * @module cascade/drivers/postgres\r\n */\r\n\r\nimport { colors } from \"@mongez/copper\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { databaseTransactionContext } from \"../../context/database-transaction-context\";\r\nimport type {\r\n  CreateDatabaseOptions,\r\n  DriverContract,\r\n  DriverEventListener,\r\n  DriverTransactionContract,\r\n  DropDatabaseOptions,\r\n  InsertResult,\r\n  TransactionContext,\r\n  UpdateOperations,\r\n  UpdateResult,\r\n} from \"../../contracts/database-driver.contract\";\r\nimport type { DriverBlueprintContract } from \"../../contracts/driver-blueprint.contract\";\r\nimport type { MigrationDriverContract } from \"../../contracts/migration-driver.contract\";\r\nimport type { QueryBuilderContract } from \"../../contracts/query-builder.contract\";\r\nimport type { SyncAdapterContract } from \"../../contracts/sync-adapter.contract\";\r\nimport { TransactionRollbackError } from \"../../errors/transaction-rollback.error\";\r\nimport { SQLSerializer } from \"../../migration/sql-serializer\";\r\nimport { SqlDatabaseDirtyTracker } from \"../../sql-database-dirty-tracker\";\r\nimport type { ModelDefaults } from \"../../types\";\r\nimport { DatabaseDriver } from \"../../utils/connect-to-database\";\r\nimport { isValidDateValue } from \"../../utils/is-valid-date-value\";\r\nimport { PostgresBlueprint } from \"./postgres-blueprint\";\r\nimport { PostgresDialect } from \"./postgres-dialect\";\r\nimport { PostgresMigrationDriver } from \"./postgres-migration-driver\";\r\nimport { PostgresQueryBuilder } from \"./postgres-query-builder\";\r\nimport { PostgresSQLSerializer } from \"./postgres-sql-serializer\";\r\nimport { PostgresSyncAdapter } from \"./postgres-sync-adapter\";\r\nimport type { PostgresPoolConfig, PostgresQueryResult, PostgresTransactionOptions } from \"./types\";\r\n\r\n/**\r\n * Lazily loaded pg module types.\r\n */\r\ntype PgPool = import(\"pg\").Pool;\r\ntype PgPoolClient = import(\"pg\").PoolClient;\r\ntype PgPoolConfig = import(\"pg\").PoolConfig;\r\n\r\n/**\r\n * Cached pg module reference.\r\n */\r\nlet pgModule: typeof import(\"pg\") | undefined;\r\n\r\n/**\r\n * Lazily load the pg package.\r\n *\r\n * @returns The pg module\r\n * @throws Error if pg is not installed\r\n */\r\nasync function loadPg(): Promise<typeof import(\"pg\")> {\r\n  if (pgModule) {\r\n    return pgModule;\r\n  }\r\n\r\n  try {\r\n    pgModule = await import(\"pg\");\r\n    return pgModule;\r\n  } catch {\r\n    throw new Error(\r\n      'The \"pg\" package is required for PostgreSQL support. ' + \"Please install it: npm install pg\",\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * PostgreSQL database driver implementing the Cascade DriverContract.\r\n *\r\n * Provides connection pooling, CRUD operations, transactions, and\r\n * integration with Cascade's query builder and migration systems.\r\n *\r\n * @example\r\n * ```typescript\r\n * const driver = new PostgresDriver({\r\n *   host: 'localhost',\r\n *   port: 5432,\r\n *   database: 'myapp',\r\n *   user: 'postgres',\r\n *   password: 'secret'\r\n * });\r\n *\r\n * await driver.connect();\r\n *\r\n * // Insert a document\r\n * const result = await driver.insert('users', { name: 'Alice', email: 'alice@example.com' });\r\n *\r\n * // Query using the query builder\r\n * const users = await driver.queryBuilder('users')\r\n *   .where('name', 'Alice')\r\n *   .get();\r\n *\r\n * await driver.disconnect();\r\n * ```\r\n */\r\nexport class PostgresDriver implements DriverContract {\r\n  /**\r\n   * Driver name identifier.\r\n   */\r\n  public readonly name = \"postgres\" as DatabaseDriver;\r\n\r\n  /**\r\n   * SQL dialect for PostgreSQL-specific syntax.\r\n   */\r\n  public readonly dialect = new PostgresDialect();\r\n\r\n  /**\r\n   * PostgreSQL driver model defaults.\r\n   *\r\n   * PostgreSQL follows SQL conventions:\r\n   * - snake_case naming for columns (created_at, updated_at, deleted_at)\r\n   * - Native AUTO_INCREMENT for IDs (no manual generation)\r\n   * - Timestamps enabled by default\r\n   * - Permanent delete strategy (hard deletes)\r\n   */\r\n  public readonly modelDefaults: Partial<ModelDefaults> = {\r\n    namingConvention: \"snake_case\",\r\n    createdAtColumn: \"created_at\",\r\n    updatedAtColumn: \"updated_at\",\r\n    deletedAtColumn: \"deleted_at\",\r\n    timestamps: true,\r\n    autoGenerateId: false, // PostgreSQL uses SERIAL/BIGSERIAL\r\n    strictMode: \"fail\",\r\n    deleteStrategy: \"permanent\",\r\n  };\r\n\r\n  /**\r\n   * Connection pool instance.\r\n   */\r\n  private _pool: PgPool | undefined;\r\n\r\n  /**\r\n   * Event listeners for driver lifecycle events.\r\n   */\r\n  private readonly _eventListeners = new Map<string, Set<DriverEventListener>>();\r\n\r\n  /**\r\n   * Whether the driver is currently connected.\r\n   */\r\n  private _isConnected = false;\r\n\r\n  /**\r\n   * Blueprint instance (lazy-loaded).\r\n   */\r\n  private _blueprint: DriverBlueprintContract | undefined;\r\n\r\n  /**\r\n   * Migration driver instance (lazy-loaded).\r\n   */\r\n  private _migrationDriver: MigrationDriverContract | undefined;\r\n\r\n  /**\r\n   * Sync adapter instance (lazy-loaded).\r\n   */\r\n  private _syncAdapter: SyncAdapterContract | undefined;\r\n\r\n  /**\r\n   * Create a new PostgreSQL driver instance.\r\n   *\r\n   * @param config - PostgreSQL connection configuration\r\n   */\r\n  public constructor(private readonly config: PostgresPoolConfig) {}\r\n\r\n  /**\r\n   * Get the connection pool instance.\r\n   *\r\n   * @throws Error if not connected\r\n   */\r\n  public get pool(): PgPool {\r\n    if (!this._pool) {\r\n      throw new Error(\"PostgreSQL driver is not connected. Call connect() first.\");\r\n    }\r\n    return this._pool;\r\n  }\r\n\r\n  /**\r\n   * Get database native client\r\n   */\r\n  public getClient<Client = PgPool>(): Client {\r\n    return this.pool as Client;\r\n  }\r\n\r\n  /**\r\n   * Check if the driver is currently connected.\r\n   */\r\n  public get isConnected(): boolean {\r\n    return this._isConnected;\r\n  }\r\n\r\n  /**\r\n   * Get the driver blueprint (information schema).\r\n   */\r\n  public get blueprint(): DriverBlueprintContract {\r\n    if (!this._blueprint) {\r\n      this._blueprint = new PostgresBlueprint(this);\r\n    }\r\n    return this._blueprint;\r\n  }\r\n\r\n  /**\r\n   * Establish connection to the PostgreSQL database.\r\n   *\r\n   * Creates a connection pool with the configured options.\r\n   * Emits 'connected' event on successful connection.\r\n   */\r\n  public async connect(): Promise<void> {\r\n    if (this._isConnected) {\r\n      return;\r\n    }\r\n\r\n    const pg = await loadPg();\r\n\r\n    try {\r\n      const poolConfig: PgPoolConfig = {\r\n        host: this.config.host ?? \"localhost\",\r\n        port: this.config.port ?? 5432,\r\n        database: this.config.database,\r\n        user: this.config.user,\r\n        password: this.config.password,\r\n        connectionString: this.config.connectionString,\r\n        max: this.config.max ?? 10,\r\n        min: this.config.min ?? 0,\r\n        idleTimeoutMillis: this.config.idleTimeoutMillis ?? 30000,\r\n        connectionTimeoutMillis: this.config.connectionTimeoutMillis ?? 2000,\r\n        application_name: this.config.application_name ?? \"cascade\",\r\n        ssl: this.config.ssl,\r\n      };\r\n\r\n      log.info(\r\n        \"database.postgres\",\r\n        \"connection\",\r\n        `Connecting to database ${colors.bold(colors.yellowBright(this.config.database))}`,\r\n      );\r\n\r\n      this._pool = new pg.Pool(poolConfig);\r\n\r\n      // Test the connection\r\n      const client = await this._pool.connect();\r\n      client.release();\r\n\r\n      log.success(\r\n        \"database.postgres\",\r\n        \"connection\",\r\n        `Connected to database ${colors.bold(colors.yellowBright(this.config.database))}`,\r\n      );\r\n\r\n      this._isConnected = true;\r\n      this.emit(\"connected\");\r\n    } catch (error) {\r\n      log.error(\"database.postgres\", \"connection\", \"Failed to connect to database\");\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Close the database connection pool.\r\n   *\r\n   * Waits for all active queries to complete before closing.\r\n   * Emits 'disconnected' event on successful disconnection.\r\n   */\r\n  public async disconnect(): Promise<void> {\r\n    if (!this._isConnected || !this._pool) {\r\n      return;\r\n    }\r\n\r\n    await this._pool.end();\r\n    this._pool = undefined;\r\n    this._isConnected = false;\r\n    this.emit(\"disconnected\");\r\n  }\r\n\r\n  /**\r\n   * Register an event listener for driver lifecycle events.\r\n   *\r\n   * @param event - Event name ('connected', 'disconnected', etc.)\r\n   * @param listener - Callback function to invoke\r\n   */\r\n  public on(event: string, listener: DriverEventListener): void {\r\n    if (!this._eventListeners.has(event)) {\r\n      this._eventListeners.set(event, new Set());\r\n    }\r\n\r\n    this._eventListeners.get(event)!.add(listener);\r\n  }\r\n\r\n  /**\r\n   * Serialize data for storage in PostgreSQL.\r\n   *\r\n   * Handles Date objects, BigInt, and other JavaScript types\r\n   * that need special handling for PostgreSQL storage.\r\n   *\r\n   * @param data - The data object to serialize\r\n   * @returns Serialized data ready for PostgreSQL\r\n   */\r\n  public serialize(data: Record<string, unknown>): Record<string, unknown> {\r\n    const serialized: Record<string, unknown> = {};\r\n\r\n    for (const [key, value] of Object.entries(data)) {\r\n      if (value === undefined) {\r\n        continue; // Skip undefined values\r\n      }\r\n\r\n      if (value instanceof Date) {\r\n        serialized[key] = value.toISOString();\r\n      } else if (typeof value === \"bigint\") {\r\n        serialized[key] = value.toString();\r\n      } else if (typeof value === \"object\" && value !== null && !Array.isArray(value)) {\r\n        // Nested objects will be stored as JSONB\r\n        serialized[key] = value;\r\n      } else if (\r\n        Array.isArray(value) &&\r\n        value.length > 0 &&\r\n        value.every((v) => typeof v === \"number\")\r\n      ) {\r\n        // pgvector columns expect the literal '[n1,n2,...]' format.\r\n        // If we pass a raw JS number[] the pg driver serializes it as a\r\n        // PostgreSQL array '{n1,n2,...}' which the vector type rejects.\r\n        serialized[key] = `[${value.join(\",\")}]`;\r\n      } else {\r\n        serialized[key] = value;\r\n      }\r\n    }\r\n\r\n    return serialized;\r\n  }\r\n\r\n  /**\r\n   * Get the dirty tracker for this driver.\r\n   */\r\n  public getDirtyTracker(data: Record<string, unknown>): SqlDatabaseDirtyTracker {\r\n    return new SqlDatabaseDirtyTracker(data);\r\n  }\r\n\r\n  /**\r\n   * Deserialize data retrieved from PostgreSQL.\r\n   *\r\n   * Converts PostgreSQL types back to JavaScript equivalents.\r\n   *\r\n   * @param data - The data object from PostgreSQL\r\n   * @returns Deserialized JavaScript object\r\n   */\r\n  public deserialize(data: Record<string, unknown>): Record<string, unknown> {\r\n    // PostgreSQL pg driver handles most type conversions automatically\r\n    // Special handling can be added here if needed\r\n    for (const [key, value] of Object.entries(data)) {\r\n      // Only re-inflate strings — pg already returns Date objects from DB reads\r\n      if (typeof value !== \"string\") continue;\r\n\r\n      if (isValidDateValue(value)) {\r\n        data[key] = new Date(value);\r\n        continue;\r\n      }\r\n\r\n      // pgvector columns are returned as '[n1,n2,...]' strings.\r\n      // charCodeAt is faster than startsWith/endsWith — no string allocation.\r\n      // '[' = 91, ']' = 93\r\n      if (value.charCodeAt(0) === 91 && value.charCodeAt(value.length - 1) === 93) {\r\n        const parts = value.slice(1, -1).split(\",\");\r\n        const nums = new Array<number>(parts.length);\r\n        let isNumericVector = parts.length > 0;\r\n\r\n        for (let i = 0; i < parts.length; i++) {\r\n          const n = +parts[i]; // unary + is the fastest string-to-number coercion\r\n          if (!Number.isFinite(n)) {\r\n            isNumericVector = false;\r\n            break; // early-exit — not a numeric vector, leave value untouched\r\n          }\r\n          nums[i] = n;\r\n        }\r\n\r\n        if (isNumericVector) {\r\n          data[key] = nums;\r\n        }\r\n      }\r\n    }\r\n\r\n    return data;\r\n  }\r\n\r\n  /**\r\n   * Insert a single row into a table.\r\n   *\r\n   * Uses INSERT ... RETURNING to get the inserted row with generated values.\r\n   *\r\n   * @param table - Target table name\r\n   * @param document - Data to insert\r\n   * @param options - Optional insertion options\r\n   * @returns The inserted document\r\n   */\r\n  public async insert(\r\n    table: string,\r\n    document: Record<string, unknown>,\r\n    _options?: Record<string, unknown>,\r\n  ): Promise<InsertResult> {\r\n    const serialized = this.serialize(document);\r\n\r\n    // Filter out id if null/undefined to let PostgreSQL SERIAL auto-generate\r\n    const filteredData = Object.fromEntries(\r\n      Object.entries(serialized).filter(([key, value]) => {\r\n        // Exclude id if null/undefined (let SERIAL handle it)\r\n        if (key === \"id\" && (value === null || value === undefined)) {\r\n          return false;\r\n        }\r\n        return true;\r\n      }),\r\n    );\r\n\r\n    const columns = Object.keys(filteredData);\r\n    const values = Object.values(filteredData);\r\n\r\n    if (columns.length === 0) {\r\n      throw new Error(\"Cannot insert empty document\");\r\n    }\r\n\r\n    const quotedColumns = columns.map((c) => this.dialect.quoteIdentifier(c)).join(\", \");\r\n    const placeholders = columns.map((_, i) => this.dialect.placeholder(i + 1)).join(\", \");\r\n    const quotedTable = this.dialect.quoteIdentifier(table);\r\n\r\n    const sql = `INSERT INTO ${quotedTable} (${quotedColumns}) VALUES (${placeholders}) RETURNING *`;\r\n\r\n    const result = await this.query<Record<string, unknown>>(sql, values);\r\n\r\n    return {\r\n      document: result.rows[0],\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Insert multiple rows into a table.\r\n   *\r\n   * Uses a single INSERT statement with multiple value sets for efficiency.\r\n   *\r\n   * @param table - Target table name\r\n   * @param documents - Array of documents to insert\r\n   * @param options - Optional insertion options\r\n   * @returns Array of inserted documents\r\n   */\r\n  public async insertMany(\r\n    table: string,\r\n    documents: Record<string, unknown>[],\r\n    _options?: Record<string, unknown>,\r\n  ): Promise<InsertResult[]> {\r\n    if (documents.length === 0) {\r\n      return [];\r\n    }\r\n\r\n    // Get all unique columns across all documents\r\n    const allColumns = new Set<string>();\r\n    for (const doc of documents) {\r\n      const serialized = this.serialize(doc);\r\n      Object.keys(serialized).forEach((key) => allColumns.add(key));\r\n    }\r\n    const columns = Array.from(allColumns);\r\n\r\n    const quotedColumns = columns.map((c) => this.dialect.quoteIdentifier(c)).join(\", \");\r\n    const quotedTable = this.dialect.quoteIdentifier(table);\r\n\r\n    // Build value sets and params\r\n    const valueSets: string[] = [];\r\n    const params: unknown[] = [];\r\n    let paramIndex = 1;\r\n\r\n    for (const doc of documents) {\r\n      const serialized = this.serialize(doc);\r\n      const rowPlaceholders: string[] = [];\r\n\r\n      for (const col of columns) {\r\n        if (col in serialized) {\r\n          rowPlaceholders.push(this.dialect.placeholder(paramIndex++));\r\n          params.push(serialized[col]);\r\n        } else {\r\n          rowPlaceholders.push(\"DEFAULT\");\r\n        }\r\n      }\r\n\r\n      valueSets.push(`(${rowPlaceholders.join(\", \")})`);\r\n    }\r\n\r\n    const sql = `INSERT INTO ${quotedTable} (${quotedColumns}) VALUES ${valueSets.join(\", \")} RETURNING *`;\r\n\r\n    const result = await this.query<Record<string, unknown>>(sql, params);\r\n\r\n    return result.rows as unknown as InsertResult[];\r\n  }\r\n\r\n  /**\r\n   * Update a single row matching the filter.\r\n   *\r\n   * @param table - Target table name\r\n   * @param filter - Filter conditions\r\n   * @param update - Update operations ($set, $unset, $inc)\r\n   * @param options - Optional update options\r\n   * @returns Update result with modified count\r\n   */\r\n  public async update(\r\n    table: string,\r\n    filter: Record<string, unknown>,\r\n    update: UpdateOperations,\r\n    _options?: Record<string, unknown>,\r\n  ): Promise<UpdateResult> {\r\n    const { sql, params } = this.buildUpdateQuery(table, filter, update, 1);\r\n    try {\r\n      const result = await this.query(sql, params);\r\n\r\n      return {\r\n        modifiedCount: result.rowCount ?? 0,\r\n      };\r\n    } catch (error) {\r\n      console.log(\"PG Query Error in:\", sql, params);\r\n\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Find one and update a single row matching the filter and return the updated row\r\n   * @param table - Target table name\r\n   * @param filter - Filter conditions\r\n   * @param update - Update operations ($set, $unset, $inc)\r\n   * @param options - Optional update options\r\n   * @returns The updated row or null\r\n   */\r\n  public async findOneAndUpdate<T = unknown>(\r\n    table: string,\r\n    filter: Record<string, unknown>,\r\n    update: UpdateOperations,\r\n    _options?: Record<string, unknown>,\r\n  ): Promise<T | null> {\r\n    const { sql, params } = this.buildUpdateQuery(table, filter, update, 1);\r\n    // Add RETURNING * to get the updated row back\r\n    const sqlWithReturning = `${sql} RETURNING *`;\r\n    const result = await this.query<T>(sqlWithReturning, params);\r\n    return result.rows[0] ?? null;\r\n  }\r\n\r\n  /**\r\n   * Update multiple rows matching the filter.\r\n   *\r\n   * @param table - Target table name\r\n   * @param filter - Filter conditions\r\n   * @param update - Update operations\r\n   * @param options - Optional update options\r\n   * @returns Update result with modified count\r\n   */\r\n  public async updateMany(\r\n    table: string,\r\n    filter: Record<string, unknown>,\r\n    update: UpdateOperations,\r\n    _options?: Record<string, unknown>,\r\n  ): Promise<UpdateResult> {\r\n    const { sql, params } = this.buildUpdateQuery(table, filter, update);\r\n\r\n    const result = await this.query(sql, params);\r\n\r\n    return {\r\n      modifiedCount: result.rowCount ?? 0,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Replace a document matching the filter.\r\n   *\r\n   * Completely replaces the document (not a partial update).\r\n   *\r\n   * @param table - Target table name\r\n   * @param filter - Filter conditions\r\n   * @param document - New document data\r\n   * @param options - Optional options\r\n   * @returns The replaced document or null\r\n   */\r\n  public async replace<T = unknown>(\r\n    table: string,\r\n    filter: Record<string, unknown>,\r\n    document: Record<string, unknown>,\r\n    _options?: Record<string, unknown>,\r\n  ): Promise<T | null> {\r\n    const serialized = this.serialize(document);\r\n    const columns = Object.keys(serialized);\r\n    const values = Object.values(serialized);\r\n\r\n    const quotedTable = this.dialect.quoteIdentifier(table);\r\n    const setClauses = columns\r\n      .map((col, i) => `${this.dialect.quoteIdentifier(col)} = ${this.dialect.placeholder(i + 1)}`)\r\n      .join(\", \");\r\n\r\n    const { whereClause, whereParams } = this.buildWhereClause(filter, columns.length + 1);\r\n\r\n    const sql = `UPDATE ${quotedTable} SET ${setClauses} ${whereClause} RETURNING *`;\r\n    const params = [...values, ...whereParams];\r\n\r\n    const result = await this.query<T>(sql, params);\r\n\r\n    return result.rows[0] ?? null;\r\n  }\r\n\r\n  /**\r\n   * Upsert (insert or update) a single row.\r\n   *\r\n   * Uses PostgreSQL's INSERT ... ON CONFLICT ... DO UPDATE syntax.\r\n   *\r\n   * @param table - Target table name\r\n   * @param filter - Filter conditions to find existing row (used for conflict detection)\r\n   * @param document - Document data to insert or update\r\n   * @param options - Upsert options (conflictColumns for conflict target)\r\n   * @returns The upserted row\r\n   */\r\n  public async upsert<T = unknown>(\r\n    table: string,\r\n    filter: Record<string, unknown>,\r\n    document: Record<string, unknown>,\r\n    options?: Record<string, unknown>,\r\n  ): Promise<T> {\r\n    const serialized = this.serialize(document);\r\n    const columns = Object.keys(serialized);\r\n    const values = Object.values(serialized);\r\n\r\n    if (columns.length === 0) {\r\n      throw new Error(\"Cannot upsert empty document\");\r\n    }\r\n\r\n    const quotedTable = this.dialect.quoteIdentifier(table);\r\n    const quotedColumns = columns.map((c) => this.dialect.quoteIdentifier(c)).join(\", \");\r\n    const placeholders = columns.map((_, i) => this.dialect.placeholder(i + 1)).join(\", \");\r\n\r\n    // Determine conflict columns from options or filter\r\n    const conflictColumns = (options?.conflictColumns as string[]) ?? Object.keys(filter);\r\n    if (conflictColumns.length === 0) {\r\n      throw new Error(\"Upsert requires conflictColumns option or filter with columns\");\r\n    }\r\n\r\n    const quotedConflictColumns = conflictColumns\r\n      .map((c) => this.dialect.quoteIdentifier(c))\r\n      .join(\", \");\r\n\r\n    // Build UPDATE clause for ON CONFLICT\r\n    // Update all columns except the conflict columns (they stay the same)\r\n    const updateColumns = columns.filter((col) => !conflictColumns.includes(col));\r\n    const setClauses = updateColumns\r\n      .map((col, i) => {\r\n        const valueIndex = columns.indexOf(col) + 1;\r\n        return `${this.dialect.quoteIdentifier(col)} = ${this.dialect.placeholder(valueIndex)}`;\r\n      })\r\n      .join(\", \");\r\n\r\n    // If there are no columns to update (all columns are conflict columns), use EXCLUDED\r\n    const updateClause =\r\n      setClauses.length > 0\r\n        ? setClauses\r\n        : columns\r\n            .map(\r\n              (col) =>\r\n                `${this.dialect.quoteIdentifier(col)} = EXCLUDED.${this.dialect.quoteIdentifier(col)}`,\r\n            )\r\n            .join(\", \");\r\n\r\n    const sql = `INSERT INTO ${quotedTable} (${quotedColumns}) VALUES (${placeholders}) ON CONFLICT (${quotedConflictColumns}) DO UPDATE SET ${updateClause} RETURNING *`;\r\n\r\n    const result = await this.query<T>(sql, values);\r\n\r\n    return result.rows[0]! as T;\r\n  }\r\n\r\n  /**\r\n   * Find one and delete a single row matching the filter and return the deleted row.\r\n   *\r\n   * @param table - Target table name\r\n   * @param filter - Filter conditions\r\n   * @param options - Optional delete options\r\n   * @returns The deleted row or null\r\n   */\r\n  public async findOneAndDelete<T = unknown>(\r\n    table: string,\r\n    filter: Record<string, unknown>,\r\n    _options?: Record<string, unknown>,\r\n  ): Promise<T | null> {\r\n    const quotedTable = this.dialect.quoteIdentifier(table);\r\n    const { whereClause, whereParams } = this.buildWhereClause(filter, 1);\r\n\r\n    // Use ctid for single row deletion with RETURNING\r\n    const sql = `DELETE FROM ${quotedTable} WHERE ctid IN (SELECT ctid FROM ${quotedTable} ${whereClause} LIMIT 1) RETURNING *`;\r\n\r\n    const result = await this.query<T>(sql, whereParams);\r\n\r\n    return result.rows[0] ? (result.rows[0] as T) : null;\r\n  }\r\n\r\n  /**\r\n   * Delete a single row matching the filter.\r\n   *\r\n   * @param table - Target table name\r\n   * @param filter - Filter conditions\r\n   * @param options - Optional options\r\n   * @returns Number of deleted rows (0 or 1)\r\n   */\r\n  public async delete(\r\n    table: string,\r\n    filter?: Record<string, unknown>,\r\n    _options?: Record<string, unknown>,\r\n  ): Promise<number> {\r\n    const quotedTable = this.dialect.quoteIdentifier(table);\r\n    const { whereClause, whereParams } = this.buildWhereClause(filter ?? {}, 1);\r\n\r\n    // Use ctid for single row deletion\r\n    const sql = `DELETE FROM ${quotedTable} WHERE ctid IN (SELECT ctid FROM ${quotedTable} ${whereClause} LIMIT 1)`;\r\n\r\n    const result = await this.query(sql, whereParams);\r\n\r\n    return result.rowCount ?? 0;\r\n  }\r\n\r\n  /**\r\n   * Delete multiple rows matching the filter.\r\n   *\r\n   * @param table - Target table name\r\n   * @param filter - Filter conditions\r\n   * @param options - Optional options\r\n   * @returns Number of deleted rows\r\n   */\r\n  public async deleteMany(\r\n    table: string,\r\n    filter?: Record<string, unknown>,\r\n    _options?: Record<string, unknown>,\r\n  ): Promise<number> {\r\n    const quotedTable = this.dialect.quoteIdentifier(table);\r\n    const { whereClause, whereParams } = this.buildWhereClause(filter ?? {}, 1);\r\n\r\n    const sql = `DELETE FROM ${quotedTable} ${whereClause}`;\r\n\r\n    const result = await this.query(sql, whereParams);\r\n\r\n    return result.rowCount ?? 0;\r\n  }\r\n\r\n  /**\r\n   * Truncate a table (remove all rows).\r\n   *\r\n   * Uses TRUNCATE TABLE for fast deletion with RESTART IDENTITY.\r\n   *\r\n   * @param table - Target table name\r\n   * @param options - Optional options\r\n   * @param options.cascade - If true, automatically truncate all tables with foreign key references (use with caution)\r\n   * @returns Number of deleted rows (always 0 for TRUNCATE)\r\n   */\r\n  public async truncateTable(table: string, options?: { cascade?: boolean }): Promise<number> {\r\n    const quotedTable = this.dialect.quoteIdentifier(table);\r\n    const cascadeClause = options?.cascade ? \" CASCADE\" : \"\";\r\n    await this.query(`TRUNCATE TABLE ${quotedTable} RESTART IDENTITY${cascadeClause}`);\r\n    return 0; // TRUNCATE doesn't return row count\r\n  }\r\n\r\n  /**\r\n   * Get a query builder for the specified table.\r\n   *\r\n   * @param table - Target table name\r\n   * @returns Query builder instance\r\n   */\r\n  public queryBuilder<T = unknown>(table: string): QueryBuilderContract<T> {\r\n    return new PostgresQueryBuilder<T>(table) as unknown as QueryBuilderContract<T>;\r\n  }\r\n\r\n  /**\r\n   * Begin a new database transaction.\r\n   *\r\n   * Acquires a client from the pool and starts a transaction.\r\n   * The client is stored in AsyncLocalStorage for automatic\r\n   * participation by subsequent queries.\r\n   *\r\n   * @param options - Optional transaction options\r\n   * @returns Transaction contract with commit/rollback methods\r\n   */\r\n  public async beginTransaction(\r\n    options?: PostgresTransactionOptions,\r\n  ): Promise<DriverTransactionContract<PgPoolClient>> {\r\n    const client = await this.pool.connect();\r\n\r\n    let beginSql = \"BEGIN\";\r\n    if (options?.isolationLevel) {\r\n      beginSql += ` ISOLATION LEVEL ${options.isolationLevel.toUpperCase()}`;\r\n    }\r\n    if (options?.readOnly) {\r\n      beginSql += \" READ ONLY\";\r\n    }\r\n    if (options?.deferrable) {\r\n      beginSql += \" DEFERRABLE\";\r\n    }\r\n\r\n    await client.query(beginSql);\r\n\r\n    return {\r\n      context: client,\r\n      commit: async () => {\r\n        await client.query(\"COMMIT\");\r\n        client.release();\r\n      },\r\n      rollback: async () => {\r\n        await client.query(\"ROLLBACK\");\r\n        client.release();\r\n      },\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Execute a function within a transaction scope (recommended pattern).\r\n   *\r\n   * Automatically commits on success, rolls back on any error, and guarantees\r\n   * resource cleanup. This is the recommended way to use transactions.\r\n   *\r\n   * @param fn - Async function to execute within transaction\r\n   * @param options - Transaction options (isolation level, read-only, etc.)\r\n   * @returns The return value of the callback function\r\n   * @throws {Error} If transaction fails or is explicitly rolled back\r\n   */\r\n  public async transaction<T>(\r\n    fn: (ctx: TransactionContext) => Promise<T>,\r\n    options?: Record<string, unknown>,\r\n  ): Promise<T> {\r\n    // Prevent nested transaction() calls\r\n    if (databaseTransactionContext.hasActiveTransaction()) {\r\n      // throw new Error(\r\n      //   \"Nested transaction() calls are not supported. \" +\r\n      //     \"Use beginTransaction() with savepoints for advanced transaction patterns.\",\r\n      // );\r\n    }\r\n\r\n    const tx = await this.beginTransaction(options);\r\n\r\n    // Set transaction context for queries within callback\r\n    databaseTransactionContext.enter({ session: tx.context });\r\n\r\n    try {\r\n      // Create transaction context with rollback method\r\n      const ctx: TransactionContext = {\r\n        rollback(reason?: string): never {\r\n          throw new TransactionRollbackError(reason);\r\n        },\r\n      };\r\n\r\n      // Execute callback\r\n      const result = await fn(ctx);\r\n\r\n      // Auto-commit on success\r\n      await tx.commit();\r\n\r\n      return result;\r\n    } catch (error) {\r\n      // Auto-rollback on any error (including explicit rollback)\r\n      await tx.rollback();\r\n      log.error(\r\n        `database.postgress`,\r\n        \"transaction\",\r\n        \"Transaction operation failed, rolled back everything\",\r\n      );\r\n      throw error;\r\n    } finally {\r\n      // Guaranteed cleanup\r\n      databaseTransactionContext.exit();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Perform an atomic update operation.\r\n   *\r\n   * Builds and executes an UPDATE query for the given filter and operations.\r\n   *\r\n   * @param table - Target table name\r\n   * @param filter - Filter conditions\r\n   * @param operations - Update operations\r\n   * @param options - Optional options\r\n   * @returns Update result\r\n   */\r\n  public async atomic(\r\n    table: string,\r\n    filter: Record<string, unknown>,\r\n    operations: UpdateOperations,\r\n    _options?: Record<string, unknown>,\r\n  ): Promise<UpdateResult> {\r\n    const { sql, params } = this.buildUpdateQuery(table, filter, operations, 1);\r\n\r\n    const result = await this.query(sql, params);\r\n\r\n    return {\r\n      modifiedCount: result.rowCount ?? 0,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Get the sync adapter for bulk denormalized updates.\r\n   *\r\n   * @returns Sync adapter instance\r\n   */\r\n  public syncAdapter(): SyncAdapterContract {\r\n    if (!this._syncAdapter) {\r\n      this._syncAdapter = new PostgresSyncAdapter(this);\r\n    }\r\n    return this._syncAdapter;\r\n  }\r\n\r\n  /**\r\n   * Get the migration driver for schema operations.\r\n   *\r\n   * @returns Migration driver instance\r\n   */\r\n  public migrationDriver(): MigrationDriverContract {\r\n    if (!this._migrationDriver) {\r\n      this._migrationDriver = new PostgresMigrationDriver(this);\r\n    }\r\n\r\n    return this._migrationDriver;\r\n  }\r\n\r\n  /**\r\n   * Return a SQL serializer for this driver's dialect.\r\n   * Used by Migration.toSQL() to convert pending operations to SQL strings.\r\n   */\r\n  public getSQLSerializer(): SQLSerializer {\r\n    return new PostgresSQLSerializer(this.dialect);\r\n  }\r\n\r\n  /**\r\n   * Execute a raw SQL query.\r\n   *\r\n   * Automatically uses the transaction client if one is active.\r\n   *\r\n   * @param sql - SQL query string\r\n   * @param params - Query parameters\r\n   * @returns Query result\r\n   */\r\n  public async query<T = Record<string, unknown>>(\r\n    sql: string,\r\n    params: unknown[] = [],\r\n  ): Promise<PostgresQueryResult<T>> {\r\n    // Check for active transaction client\r\n    const txClient = databaseTransactionContext.getSession() as PgPoolClient | undefined;\r\n\r\n    const startTime = this.config.logging ? performance.now() : 0;\r\n\r\n    let paramsString = \"\";\r\n    if (this.config.logging && params.length > 0) {\r\n      paramsString = JSON.stringify(params);\r\n      if (paramsString.length > 300) {\r\n        paramsString = paramsString.substring(0, 300) + \"...\";\r\n      }\r\n      paramsString = ` | Params: ${paramsString}`;\r\n    }\r\n\r\n    try {\r\n      let result;\r\n      if (this.config.logging) {\r\n        log.info({\r\n          module: \"database.postgres\",\r\n          action: \"query.executing\",\r\n          message: `${sql}${paramsString}`,\r\n          context: { params, sql },\r\n        });\r\n      }\r\n      if (txClient) {\r\n        result = await txClient.query(sql, params);\r\n      } else {\r\n        result = await this.pool.query(sql, params);\r\n      }\r\n\r\n      if (this.config.logging) {\r\n        const duration = (performance.now() - startTime).toFixed(2);\r\n        log.success({\r\n          module: \"database.postgres\",\r\n          action: \"query.executed\",\r\n          message: `[${duration}ms] ${sql}${paramsString}`,\r\n          context: { params, sql, duration },\r\n        });\r\n      }\r\n\r\n      return result as PostgresQueryResult<T>;\r\n    } catch (error) {\r\n      if (this.config.logging) {\r\n        const duration = (performance.now() - startTime).toFixed(2);\r\n        log.error({\r\n          module: \"database.postgres\",\r\n          action: \"query.error\",\r\n          message: `[${duration}ms] ${sql}${paramsString}`,\r\n          context: {\r\n            sql,\r\n            params,\r\n            error: error instanceof Error ? error.message : String(error),\r\n          },\r\n        });\r\n      }\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Emit an event to all registered listeners.\r\n   *\r\n   * @param event - Event name\r\n   * @param args - Event arguments\r\n   */\r\n  private emit(event: string, ...args: unknown[]): void {\r\n    const listeners = this._eventListeners.get(event);\r\n    if (listeners) {\r\n      for (const listener of listeners) {\r\n        listener(...args);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Build a simple WHERE clause from a filter object.\r\n   *\r\n   * @param filter - Filter conditions\r\n   * @param startParamIndex - Starting parameter index\r\n   * @returns Object with WHERE clause string and parameters\r\n   */\r\n  private buildWhereClause(\r\n    filter: Record<string, unknown>,\r\n    startParamIndex: number,\r\n  ): { whereClause: string; whereParams: unknown[] } {\r\n    const conditions: string[] = [];\r\n    const params: unknown[] = [];\r\n    let paramIndex = startParamIndex;\r\n\r\n    for (const [key, value] of Object.entries(filter)) {\r\n      const quotedKey = this.dialect.quoteIdentifier(key);\r\n\r\n      if (value === null) {\r\n        conditions.push(`${quotedKey} IS NULL`);\r\n      } else {\r\n        conditions.push(`${quotedKey} = ${this.dialect.placeholder(paramIndex++)}`);\r\n        params.push(value);\r\n      }\r\n    }\r\n\r\n    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(\" AND \")}` : \"\";\r\n\r\n    return { whereClause, whereParams: params };\r\n  }\r\n\r\n  /**\r\n   * Build an UPDATE query from update operations.\r\n   *\r\n   * @param table - Target table name\r\n   * @param filter - Filter conditions\r\n   * @param update - Update operations\r\n   * @param limit - Optional limit (for single row update)\r\n   * @returns Object with SQL and parameters\r\n   */\r\n  private buildUpdateQuery(\r\n    table: string,\r\n    filter: Record<string, unknown>,\r\n    update: UpdateOperations,\r\n    limit?: number,\r\n  ): { sql: string; params: unknown[] } {\r\n    const setClauses: string[] = [];\r\n    const params: unknown[] = [];\r\n    let paramIndex = 1;\r\n\r\n    // Handle $set\r\n    if (update.$set) {\r\n      for (const [key, value] of Object.entries(update.$set)) {\r\n        setClauses.push(\r\n          `${this.dialect.quoteIdentifier(key)} = ${this.dialect.placeholder(paramIndex++)}`,\r\n        );\r\n        params.push(value);\r\n      }\r\n    }\r\n\r\n    // Handle $unset (set to NULL)\r\n    if (update.$unset) {\r\n      for (const key of Object.keys(update.$unset)) {\r\n        setClauses.push(`${this.dialect.quoteIdentifier(key)} = NULL`);\r\n      }\r\n    }\r\n\r\n    // Handle $inc\r\n    if (update.$inc) {\r\n      for (const [key, amount] of Object.entries(update.$inc)) {\r\n        const quotedKey = this.dialect.quoteIdentifier(key);\r\n        setClauses.push(\r\n          `${quotedKey} = COALESCE(${quotedKey}, 0) + ${this.dialect.placeholder(paramIndex++)}`,\r\n        );\r\n        params.push(amount);\r\n      }\r\n    }\r\n\r\n    // Handle $dec\r\n    if (update.$dec) {\r\n      for (const [key, amount] of Object.entries(update.$dec)) {\r\n        const quotedKey = this.dialect.quoteIdentifier(key);\r\n        setClauses.push(\r\n          `${quotedKey} = COALESCE(${quotedKey}, 0) - ${this.dialect.placeholder(paramIndex++)}`,\r\n        );\r\n        params.push(amount);\r\n      }\r\n    }\r\n\r\n    if (setClauses.length === 0) {\r\n      throw new Error(\"No update operations specified\");\r\n    }\r\n\r\n    const quotedTable = this.dialect.quoteIdentifier(table);\r\n    const { whereClause, whereParams } = this.buildWhereClause(filter, paramIndex);\r\n    params.push(...whereParams);\r\n\r\n    let sql = `UPDATE ${quotedTable} SET ${setClauses.join(\", \")} ${whereClause}`;\r\n\r\n    // For single row update, use ctid subquery\r\n    if (limit === 1 && whereClause) {\r\n      sql = `UPDATE ${quotedTable} SET ${setClauses.join(\", \")} WHERE ctid IN (SELECT ctid FROM ${quotedTable} ${whereClause} LIMIT 1)`;\r\n    }\r\n\r\n    return { sql, params };\r\n  }\r\n\r\n  // ============================================================\r\n  // Database Lifecycle Operations\r\n  // ============================================================\r\n\r\n  /**\r\n   * Create a new database.\r\n   *\r\n   * Note: This requires connecting to a system database (like 'postgres')\r\n   * since you cannot create a database while connected to it.\r\n   *\r\n   * @param name - Database name to create\r\n   * @param options - Creation options (encoding, template, etc.)\r\n   * @returns true if created, false if already exists\r\n   */\r\n  public async createDatabase(name: string, options?: CreateDatabaseOptions): Promise<boolean> {\r\n    // Check if database already exists\r\n    if (await this.databaseExists(name)) {\r\n      return false;\r\n    }\r\n\r\n    // Build CREATE DATABASE statement\r\n    const quotedName = this.dialect.quoteIdentifier(name);\r\n    let sql = `CREATE DATABASE ${quotedName}`;\r\n\r\n    const withClauses: string[] = [];\r\n\r\n    if (options?.encoding) {\r\n      withClauses.push(`ENCODING = '${options.encoding}'`);\r\n    }\r\n    if (options?.template) {\r\n      withClauses.push(`TEMPLATE = ${this.dialect.quoteIdentifier(options.template)}`);\r\n    }\r\n    if (options?.locale) {\r\n      withClauses.push(`LC_COLLATE = '${options.locale}'`);\r\n      withClauses.push(`LC_CTYPE = '${options.locale}'`);\r\n    }\r\n    if (options?.owner) {\r\n      withClauses.push(`OWNER = ${this.dialect.quoteIdentifier(options.owner)}`);\r\n    }\r\n\r\n    if (withClauses.length > 0) {\r\n      sql += ` WITH ${withClauses.join(\" \")}`;\r\n    }\r\n\r\n    try {\r\n      await this.query(sql);\r\n      log.success(\"database\", \"lifecycle\", `Created database ${name}`);\r\n      return true;\r\n    } catch (error) {\r\n      log.error(\"database\", \"lifecycle\", `Failed to create database ${name}: ${error}`);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Drop a database.\r\n   *\r\n   * @param name - Database name to drop\r\n   * @param options - Drop options\r\n   * @returns true if dropped, false if didn't exist\r\n   */\r\n  public async dropDatabase(name: string, options?: DropDatabaseOptions): Promise<boolean> {\r\n    // Check if database exists first (if ifExists option not set)\r\n    if (!options?.ifExists && !(await this.databaseExists(name))) {\r\n      return false;\r\n    }\r\n\r\n    const quotedName = this.dialect.quoteIdentifier(name);\r\n    let sql = \"DROP DATABASE\";\r\n\r\n    if (options?.ifExists) {\r\n      sql += \" IF EXISTS\";\r\n    }\r\n\r\n    sql += ` ${quotedName}`;\r\n\r\n    // PostgreSQL 13+ supports WITH (FORCE) to terminate active connections\r\n    if (options?.force) {\r\n      sql += \" WITH (FORCE)\";\r\n    }\r\n\r\n    try {\r\n      await this.query(sql);\r\n      log.success(\"database\", \"lifecycle\", `Dropped database ${name}`);\r\n      return true;\r\n    } catch (error) {\r\n      log.error(\"database\", \"lifecycle\", `Failed to drop database ${name}: ${error}`);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Check if a database exists.\r\n   *\r\n   * @param name - Database name to check\r\n   * @returns true if database exists\r\n   */\r\n  public async databaseExists(name: string): Promise<boolean> {\r\n    const result = await this.query<{ exists: boolean }>(\r\n      `SELECT EXISTS(SELECT 1 FROM pg_database WHERE datname = $1) as exists`,\r\n      [name],\r\n    );\r\n\r\n    return result.rows[0]?.exists ?? false;\r\n  }\r\n\r\n  /**\r\n   * List all databases.\r\n   *\r\n   * @returns Array of database names\r\n   */\r\n  public async listDatabases(): Promise<string[]> {\r\n    const result = await this.query<{ datname: string }>(\r\n      `SELECT datname FROM pg_database WHERE datistemplate = false ORDER BY datname`,\r\n    );\r\n\r\n    return result.rows.map((row) => row.datname);\r\n  }\r\n\r\n  // ============================================================\r\n  // Table Management Operations\r\n  // ============================================================\r\n\r\n  /**\r\n   * Drop a table.\r\n   *\r\n   * @param name - Table name to drop\r\n   * @throws Error if table doesn't exist\r\n   */\r\n  public async dropTable(name: string): Promise<void> {\r\n    const quotedName = this.dialect.quoteIdentifier(name);\r\n    await this.query(`DROP TABLE ${quotedName}`);\r\n    log.success(\"database\", \"table\", `Dropped table ${name}`);\r\n  }\r\n\r\n  /**\r\n   * Drop a table if it exists.\r\n   *\r\n   * @param name - Table name to drop\r\n   */\r\n  public async dropTableIfExists(name: string): Promise<void> {\r\n    const quotedName = this.dialect.quoteIdentifier(name);\r\n    await this.query(`DROP TABLE IF EXISTS ${quotedName}`);\r\n  }\r\n\r\n  /**\r\n   * Drop all tables in the current database.\r\n   *\r\n   * Uses CASCADE to handle foreign key dependencies.\r\n   * Useful for `migrate:fresh` command.\r\n   */\r\n  public async dropAllTables(): Promise<void> {\r\n    // Get all tables from blueprint\r\n    const tables = await this.blueprint.listTables();\r\n\r\n    if (tables.length === 0) {\r\n      return;\r\n    }\r\n\r\n    // Drop all tables with CASCADE to handle foreign keys\r\n    for (const table of tables) {\r\n      const quotedName = this.dialect.quoteIdentifier(table);\r\n      await this.query(`DROP TABLE IF EXISTS ${quotedName} CASCADE`);\r\n    }\r\n\r\n    log.success(\"database\", \"table\", `Dropped ${tables.length} tables`);\r\n  }\r\n}\r\n"],"mappings":"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"}

package/esm/drivers/postgres/postgres-migration-driver.d.mts

@@ -0,0 +1,393 @@
+import { MigrationDefaults } from "../../types.mjs";
+import { TableIndexInformation } from "../../contracts/driver-blueprint.contract.mjs";
+import { ColumnDefinition, ForeignKeyDefinition, FullTextIndexOptions, GeoIndexOptions, IndexDefinition, MigrationDriverContract, VectorIndexOptions } from "../../contracts/migration-driver.contract.mjs";
+import { PostgresDriver } from "./postgres-driver.mjs";
+
+//#region ../../@warlock.js/cascade/src/drivers/postgres/postgres-migration-driver.d.ts
+/**
+ * PostgreSQL Migration Driver.
+ *
+ * Handles database schema operations for PostgreSQL including:
+ * - Table creation and deletion
+ * - Column management
+ * - Index creation (B-tree, GIN, GiST, etc.)
+ * - Constraint management (foreign keys, unique, etc.)
+ *
+ * @example
+ * ```typescript
+ * const migrationDriver = driver.migrationDriver();
+ *
+ * // Create a table
+ * await migrationDriver.createTable('users');
+ *
+ * // Add columns
+ * await migrationDriver.addColumn('users', {
+ *   name: 'email',
+ *   type: 'string',
+ *   length: 255,
+ *   nullable: false
+ * });
+ *
+ * // Create unique index
+ * await migrationDriver.createUniqueIndex('users', ['email']);
+ * ```
+ */
+declare class PostgresMigrationDriver implements MigrationDriverContract {
+  readonly driver: PostgresDriver;
+  /**
+   * Active transaction client (if any).
+   */
+  private get transactionClient();
+  /**
+   * Create a new migration driver.
+   *
+   * @param driver - The PostgreSQL driver instance
+   */
+  constructor(driver: PostgresDriver);
+  /**
+   * Create a new table with a default id column.
+   *
+   * @param table - Table name
+   */
+  createTable(table: string): Promise<void>;
+  /**
+   * Create table if it doesn't exist.
+   *
+   * @param table - Table name
+   */
+  createTableIfNotExists(table: string): Promise<void>;
+  /**
+   * Drop an existing table.
+   *
+   * @param table - Table name
+   */
+  dropTable(table: string): Promise<void>;
+  /**
+   * Drop table if it exists.
+   *
+   * @param table - Table name
+   */
+  dropTableIfExists(table: string): Promise<void>;
+  /**
+   * Rename a table.
+   *
+   * @param from - Current table name
+   * @param to - New table name
+   */
+  renameTable(from: string, to: string): Promise<void>;
+  /**
+   * Truncate a table — remove all rows efficiently.
+   *
+   * @param table - Table name
+   */
+  truncateTable(table: string): Promise<void>;
+  /**
+   * Check if a table exists.
+   *
+   * @param table - Table name
+   * @returns Whether the table exists
+   */
+  tableExists(table: string): Promise<boolean>;
+  /**
+   * List all columns in a table.
+   *
+   * @param table - Table name
+   * @returns Array of column definitions
+   */
+  listColumns(table: string): Promise<ColumnDefinition[]>;
+  /**
+   * List all tables in the current database.
+   *
+   * @returns Array of table names
+   */
+  listTables(): Promise<string[]>;
+  /**
+   * Ensure the migrations tracking table exists.
+   *
+   * Creates the table with proper schema if it doesn't exist.
+   *
+   * @param tableName - Name of the migrations table
+   */
+  ensureMigrationsTable(tableName: string): Promise<void>;
+  /**
+   * Add a column to an existing table.
+   *
+   * @param table - Table name
+   * @param column - Column definition
+   */
+  addColumn(table: string, column: ColumnDefinition): Promise<void>;
+  /**
+   * Drop a column from a table.
+   *
+   * @param table - Table name
+   * @param column - Column name
+   */
+  dropColumn(table: string, column: string): Promise<void>;
+  /**
+   * Drop multiple columns from a table.
+   *
+   * @param table - Table name
+   * @param columns - Column names
+   */
+  dropColumns(table: string, columns: string[]): Promise<void>;
+  /**
+   * Rename a column.
+   *
+   * @param table - Table name
+   * @param from - Current column name
+   * @param to - New column name
+   */
+  renameColumn(table: string, from: string, to: string): Promise<void>;
+  /**
+   * Modify an existing column.
+   *
+   * @param table - Table name
+   * @param column - New column definition
+   */
+  modifyColumn(table: string, column: ColumnDefinition): Promise<void>;
+  /**
+   * Create standard timestamp columns (created_at, updated_at).
+   *
+   * PostgreSQL implementation creates TIMESTAMPTZ columns with NOW() defaults.
+   *
+   * @param table - Table name
+   */
+  createTimestampColumns(table: string): Promise<void>;
+  /**
+   * Create an index on one or more columns.
+   *
+   * Supports:
+   * - Regular column indexes
+   * - Expression-based indexes (e.g., `lower(email)`)
+   * - Covering indexes (INCLUDE clause)
+   * - Concurrent index creation (CONCURRENTLY keyword)
+   *
+   * @param table - Table name
+   * @param index - Index definition
+   */
+  createIndex(table: string, index: IndexDefinition): Promise<void>;
+  /**
+   * Drop an index.
+   *
+   * @param table - Table name
+   * @param indexNameOrColumns - Index name or columns
+   */
+  dropIndex(table: string, indexNameOrColumns: string | string[]): Promise<void>;
+  /**
+   * Create a unique index.
+   *
+   * @param table - Table name
+   * @param columns - Columns to include
+   * @param name - Optional index name
+   */
+  createUniqueIndex(table: string, columns: string[], name?: string): Promise<void>;
+  /**
+   * Drop a unique index.
+   *
+   * @param table - Table name
+   * @param columns - Columns in the index
+   */
+  dropUniqueIndex(table: string, columns: string[]): Promise<void>;
+  /**
+   * Create a full-text search index using GIN.
+   *
+   * @param table - Table name
+   * @param columns - Columns to index
+   * @param options - Full-text options
+   */
+  createFullTextIndex(table: string, columns: string[], options?: FullTextIndexOptions): Promise<void>;
+  /**
+   * Drop a full-text search index.
+   *
+   * @param table - Table name
+   * @param name - Index name
+   */
+  dropFullTextIndex(table: string, name: string): Promise<void>;
+  /**
+   * Create a geo-spatial index using GiST.
+   *
+   * @param table - Table name
+   * @param column - Geo column
+   * @param options - Geo index options
+   */
+  createGeoIndex(table: string, column: string, options?: GeoIndexOptions): Promise<void>;
+  /**
+   * Drop a geo-spatial index.
+   *
+   * @param table - Table name
+   * @param column - Geo column
+   */
+  dropGeoIndex(table: string, column: string): Promise<void>;
+  /**
+   * Create a vector search index (requires pgvector extension).
+   *
+   * @param table - Table name
+   * @param column - Vector column
+   * @param options - Vector index options
+   */
+  createVectorIndex(table: string, column: string, options: VectorIndexOptions): Promise<void>;
+  /**
+   * Drop a vector search index.
+   *
+   * @param table - Table name
+   * @param column - Vector column
+   */
+  dropVectorIndex(table: string, column: string): Promise<void>;
+  /**
+   * Create a TTL index (not natively supported in PostgreSQL).
+   *
+   * Note: PostgreSQL doesn't have native TTL indexes like MongoDB.
+   * This creates a partial index and requires a scheduled job for cleanup.
+   *
+   * @param table - Table name
+   * @param column - Date column
+   * @param expireAfterSeconds - Expiration time in seconds
+   */
+  createTTLIndex(table: string, column: string, expireAfterSeconds: number): Promise<void>;
+  /**
+   * Drop a TTL index.
+   *
+   * @param table - Table name
+   * @param column - Column with TTL index
+   */
+  dropTTLIndex(table: string, column: string): Promise<void>;
+  /**
+   * List all indexes on a table.
+   *
+   * @param table - Table name
+   * @returns Array of index metadata
+   */
+  listIndexes(table: string): Promise<TableIndexInformation[]>;
+  /**
+   * Check if a PostgreSQL extension is available on the database server.
+   *
+   * @param extension - Extension name (e.g., "vector")
+   */
+  isExtensionAvailable(extension: string): Promise<boolean>;
+  /**
+   * Get the official documentation or installation URL for a PostgreSQL extension.
+   *
+   * @param extension - Extension name
+   */
+  getExtensionDocsUrl(extension: string): string | undefined;
+  /**
+   * Add a foreign key constraint.
+   *
+   * @param table - Table name
+   * @param foreignKey - Foreign key definition
+   */
+  addForeignKey(table: string, foreignKey: ForeignKeyDefinition): Promise<void>;
+  /**
+   * Drop a foreign key constraint.
+   *
+   * @param table - Table name
+   * @param name - Constraint name
+   */
+  dropForeignKey(table: string, name: string): Promise<void>;
+  /**
+   * Add a primary key constraint.
+   *
+   * @param table - Table name
+   * @param columns - Primary key columns
+   */
+  addPrimaryKey(table: string, columns: string[]): Promise<void>;
+  /**
+   * Drop the primary key constraint.
+   *
+   * @param table - Table name
+   */
+  dropPrimaryKey(table: string): Promise<void>;
+  /**
+   * Add a CHECK constraint.
+   *
+   * @param table - Table name
+   * @param name - Constraint name
+   * @param expression - SQL CHECK expression
+   */
+  addCheck(table: string, name: string, expression: string): Promise<void>;
+  /**
+   * Drop a CHECK constraint.
+   *
+   * @param table - Table name
+   * @param name - Constraint name
+   */
+  dropCheck(table: string, name: string): Promise<void>;
+  /**
+   * Set schema validation (no-op for PostgreSQL).
+   *
+   * PostgreSQL uses column constraints instead.
+   */
+  setSchemaValidation(_table: string, _schema: object): Promise<void>;
+  /**
+   * Remove schema validation (no-op for PostgreSQL).
+   */
+  removeSchemaValidation(_table: string): Promise<void>;
+  /**
+   * Begin a transaction.
+   */
+  beginTransaction(): Promise<void>;
+  /**
+   * Commit the current transaction.
+   */
+  commit(): Promise<void>;
+  /**
+   * Rollback the current transaction.
+   */
+  rollback(): Promise<void>;
+  /**
+   * Whether transactions are supported.
+   */
+  supportsTransactions(): boolean;
+  /**
+   * Get the default transactional behavior for PostgreSQL.
+   *
+   * PostgreSQL supports transactional DDL operations, so migrations
+   * are wrapped in transactions by default for atomicity and safety.
+   *
+   * @returns true (PostgreSQL DDL is transactional)
+   */
+  getDefaultTransactional(): boolean;
+  /**
+   * Get the default UUID generation expression for PostgreSQL.
+   *
+   * Resolution order:
+   * 1. `migrationDefaults.uuidExpression` → raw expression (escape hatch)
+   * 2. `migrationDefaults.uuidStrategy` → mapped to PG function
+   * 3. Fallback → `gen_random_uuid()` (v4, PG 13+)
+   *
+   * @param migrationDefaults - Optional overrides from DataSource config
+   * @returns PostgreSQL SQL expression for UUID generation
+   *
+   * @example
+   * ```typescript
+   * driver.getUuidDefault(); // "gen_random_uuid()"
+   * driver.getUuidDefault({ uuidStrategy: "v7" }); // "uuidv7()"
+   * driver.getUuidDefault({ uuidExpression: "uuid_generate_v1mc()" }); // "uuid_generate_v1mc()"
+   * ```
+   */
+  getUuidDefault(migrationDefaults?: MigrationDefaults): string;
+  /**
+   * Execute raw operations with direct driver access.
+   *
+   * @param callback - Callback receiving the driver
+   */
+  raw<T>(callback: (connection: unknown) => Promise<T>): Promise<T>;
+  /**
+   * Execute a SQL statement.
+   *
+   * @param sql - SQL to execute
+   * @param params - Query parameters
+   */
+  private execute;
+  /**
+   * Map foreign key action to PostgreSQL syntax.
+   */
+  private mapForeignKeyAction;
+  /**
+   * Map PostgreSQL data type to ColumnType.
+   */
+  private mapPostgresTypeToColumnType;
+}
+//#endregion
+export { PostgresMigrationDriver };
+//# sourceMappingURL=postgres-migration-driver.d.mts.map

package/esm/drivers/postgres/postgres-migration-driver.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-migration-driver.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/drivers/postgres/postgres-migration-driver.ts"],"mappings":"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"}