@arcote.tech/arc-adapter-db-postgres 0.3.2 → 0.3.4

package/src/postgres-adapter.ts

@@ -1,1002 +0,0 @@
-import {
-  type ArcContextAny,
-  type DatabaseAdapter,
-  type DatabaseAgnosticColumnInfo,
-  type DatabaseStoreData,
-  type DatabaseStoreSchema,
-  type DBAdapterFactory,
-  type FindOptions,
-  type ReadTransaction,
-  type ReadWriteTransaction,
-  type StoreColumn,
-  type StoreTable,
-  type WhereCondition,
-  extractDatabaseAgnosticSchema,
-} from "@arcote.tech/arc";
-
-export interface PostgreSQLDatabase {
-  exec(sql: string, params?: any[]): Promise<any>;
-  execBatch(queries: Array<{ sql: string; params?: any[] }>): Promise<any>;
-}
-
-class PostgreSQLReadTransaction implements ReadTransaction {
-  constructor(
-    protected db: PostgreSQLDatabase,
-    protected tables: Map<string, StoreTable>,
-    protected adapter?: PostgreSQLAdapter,
-  ) {}
-
-  protected hasSoftDelete(tableName: string): boolean {
-    if (this.adapter) {
-      return this.adapter.hasSoftDelete(tableName);
-    }
-    // Fallback: check if table has deleted column
-    const table = this.tables.get(tableName);
-    if (!table) return false;
-    return table.columns.some((col) => col.name === "deleted");
-  }
-
-  protected deserializeValue(value: any, column: StoreColumn): any {
-    if (value === null || value === undefined) return null;
-
-    switch (column.type.toLowerCase()) {
-      case "json":
-      case "jsonb":
-        // PostgreSQL JSON/JSONB columns should always be parsed
-        if (typeof value === "string") {
-          try {
-            return JSON.parse(value);
-          } catch {
-            return value;
-          }
-        }
-        return value; // Already parsed by PostgreSQL driver
-      case "text":
-        // For text columns, only attempt JSON parsing if it looks like JSON
-        if (
-          typeof value === "string" &&
-          (value.startsWith("{") || value.startsWith("["))
-        ) {
-          try {
-            const parsed = JSON.parse(value);
-            if (typeof parsed === "object" || Array.isArray(parsed)) {
-              return parsed;
-            }
-          } catch {
-            // Not valid JSON, return as string
-          }
-        }
-        return value;
-      case "date":
-      case "datetime":
-      case "timestamp":
-        // PostgreSQL returns Date objects directly via postgres.js driver
-        if (value instanceof Date) {
-          return value;
-        }
-        if (typeof value === "string") {
-          // If the string doesn't have timezone info, treat as UTC
-          if (
-            !value.endsWith("Z") &&
-            !value.includes("+") &&
-            !value.includes("-", 10)
-          ) {
-            return new Date(value + "Z");
-          }
-          return new Date(value);
-        }
-        return new Date(value);
-      default:
-        return value;
-    }
-  }
-
-  protected deserializeRow(row: any, table: StoreTable): any {
-    const result: any = {};
-    for (const column of table.columns) {
-      const value = row[column.name];
-      result[column.name] = this.deserializeValue(value, column);
-    }
-    return result;
-  }
-
-  protected getId(store: string, id: any) {
-    return id;
-  }
-
-  protected buildWhereClause(
-    where?: WhereCondition,
-    tableName?: string,
-  ): {
-    sql: string;
-    params: any[];
-  } {
-    const conditions: string[] = [];
-    const params: any[] = [];
-    let paramIndex = 1;
-
-    // Debug logging
-    if (where && (Array.isArray(where) || typeof where !== "object")) {
-      console.error(
-        "[buildWhereClause] Invalid where clause type:",
-        typeof where,
-        Array.isArray(where) ? "(array)" : "",
-      );
-      console.error(
-        "[buildWhereClause] where value:",
-        JSON.stringify(where, null, 2),
-      );
-      console.error("[buildWhereClause] tableName:", tableName);
-      console.trace("[buildWhereClause] Stack trace:");
-    }
-
-    // Only add deleted condition if table has soft delete enabled
-    if (tableName && this.hasSoftDelete(tableName)) {
-      conditions.push('"deleted" = $1');
-      params.push(false);
-      paramIndex = 2;
-    }
-
-    if (!where) {
-      return {
-        sql: conditions.length > 0 ? conditions.join(" AND ") : "1=1",
-        params,
-      };
-    }
-
-    Object.entries(where).forEach(([key, value]) => {
-      if (typeof value === "object" && value !== null) {
-        Object.entries(value as Record<string, unknown>).forEach(
-          ([operator, operand]) => {
-            switch (operator) {
-              case "$eq":
-              case "$ne":
-              case "$gt":
-              case "$gte":
-              case "$lt":
-              case "$lte":
-                conditions.push(
-                  `"${key}" ${this.getOperatorSymbol(operator)} $${paramIndex}`,
-                );
-                params.push(operand);
-                paramIndex++;
-                break;
-              case "$in":
-              case "$nin":
-                if (Array.isArray(operand)) {
-                  const placeholders = operand
-                    .map(() => `$${paramIndex++}`)
-                    .join(", ");
-                  conditions.push(
-                    `"${key}" ${operator === "$in" ? "IN" : "NOT IN"} (${placeholders})`,
-                  );
-                  params.push(...operand);
-                }
-                break;
-              case "$exists":
-                if (typeof operand === "boolean") {
-                  conditions.push(
-                    operand ? `"${key}" IS NOT NULL` : `"${key}" IS NULL`,
-                  );
-                }
-                break;
-            }
-          },
-        );
-      } else {
-        conditions.push(`"${key}" = $${paramIndex}`);
-        params.push(value);
-        paramIndex++;
-      }
-    });
-
-    return {
-      sql: conditions.length > 0 ? conditions.join(" AND ") : "1=1",
-      params,
-    };
-  }
-
-  protected getOperatorSymbol(operator: string): string {
-    const operators: Record<string, string> = {
-      $eq: "=",
-      $ne: "!=",
-      $gt: ">",
-      $gte: ">=",
-      $lt: "<",
-      $lte: "<=",
-    };
-    return operators[operator] || "=";
-  }
-
-  protected buildOrderByClause(
-    orderBy?: Record<string, "asc" | "desc">,
-  ): string {
-    if (!orderBy) return "";
-
-    const orderClauses = Object.entries(orderBy)
-      .map(([key, direction]) => `"${key}" ${direction.toUpperCase()}`)
-      .join(", ");
-
-    return orderClauses ? `ORDER BY ${orderClauses}` : "";
-  }
-
-  async find<T>(store: string, options: FindOptions<T>): Promise<T[]> {
-    const { where, limit, offset, orderBy } = options || {};
-    const whereClause = this.buildWhereClause(where, store);
-    const orderByClause = this.buildOrderByClause(orderBy);
-    const table = this.tables.get(store);
-
-    if (!table) {
-      throw new Error(`Store ${store} not found`);
-    }
-
-    let query = `
-      SELECT * 
-      FROM "${table.name}" 
-      WHERE ${whereClause.sql}
-      ${orderByClause}
-    `;
-
-    let params = whereClause.params;
-    let paramIndex = params.length + 1;
-
-    if (limit) {
-      query += ` LIMIT $${paramIndex}`;
-      params.push(limit);
-      paramIndex++;
-    }
-
-    if (offset) {
-      query += ` OFFSET $${paramIndex}`;
-      params.push(offset);
-    }
-
-    const rows = await this.db.exec(query, params);
-    return rows.map((row: any) => this.deserializeRow(row, table));
-  }
-}
-
-class PostgreSQLReadWriteTransaction
-  extends PostgreSQLReadTransaction
-  implements ReadWriteTransaction
-{
-  private queries: Array<{ sql: string; params?: any[] }> = [];
-
-  constructor(
-    db: PostgreSQLDatabase,
-    tables: Map<string, StoreTable>,
-    protected adapter: PostgreSQLAdapter,
-  ) {
-    super(db, tables);
-  }
-  async remove(store: string, id: any) {
-    const table = this.tables.get(store);
-    if (!table) {
-      throw new Error(`Store ${store} not found`);
-    }
-    const query = `UPDATE "${table.name}" SET "deleted" = $1, "lastUpdate" = $2 WHERE "${table.primaryKey}" = $3`;
-    this.queries.push({
-      sql: query,
-      params: [true, new Date().toISOString(), id],
-    });
-  }
-
-  async set(store: string, item: any) {
-    const table = this.tables.get(store);
-    if (!table) {
-      throw new Error(`Store ${store} not found`);
-    }
-
-    const hasVersioning = this.adapter.hasVersioning(store);
-
-    try {
-      if (hasVersioning) {
-        // For versioned tables, use a transaction with version increment
-        await this.setWithVersioning(store, item, table);
-      } else {
-        // For non-versioned tables, use simple insert
-        await this.setWithoutVersioning(store, item, table);
-      }
-    } catch (error) {
-      console.error(`[PostgreSQL] Error in set() for store "${store}":`);
-      console.error(
-        `[PostgreSQL] Item data:`,
-        JSON.stringify(
-          item,
-          (key, value) => {
-            if (value instanceof Date) {
-              return `[Date: ${value.toString()} | ISO: ${isNaN(value.getTime()) ? "Invalid Date" : value.toISOString()}]`;
-            }
-            return value;
-          },
-          2,
-        ),
-      );
-      throw error;
-    }
-  }
-
-  private async setWithoutVersioning(
-    store: string,
-    item: any,
-    table: StoreTable,
-  ) {
-    const columnNames = table.columns.map((col) => col.name);
-    const values = table.columns.map((column) => {
-      let value = item[column.name];
-      if (value === undefined && column.default !== undefined) {
-        value = column.default;
-      }
-      return this.serializeValue(value, column);
-    });
-
-    const placeholders = columnNames.map((_, i) => `$${i + 1}`).join(", ");
-    const updateColumns = columnNames
-      .filter((col) => col !== table.primaryKey)
-      .map((col) => `"${col}" = EXCLUDED."${col}"`)
-      .join(", ");
-
-    // For events table, use simple INSERT since events are typically append-only
-    if (store === "events") {
-      const simpleInsertSql = `
-        INSERT INTO "${table.name}"
-        (${columnNames.map((c) => `"${c}"`).join(", ")})
-        VALUES (${placeholders})
-      `;
-      this.queries.push({
-        sql: simpleInsertSql,
-        params: values,
-      });
-    } else {
-      const sql = `
-        INSERT INTO "${table.name}"
-        (${columnNames.map((c) => `"${c}"`).join(", ")})
-        VALUES (${placeholders})
-        ON CONFLICT ("${table.primaryKey}")
-        DO UPDATE SET ${updateColumns}
-      `;
-      this.queries.push({
-        sql: sql,
-        params: values,
-      });
-    }
-  }
-
-  private async setWithVersioning(store: string, item: any, table: StoreTable) {
-    // Filter out __version from regular columns and handle it separately
-    const regularColumns = table.columns.filter(
-      (col) => col.name !== "__version",
-    );
-    const columnNames = regularColumns.map((col) => col.name);
-    const values = regularColumns.map((column) => {
-      let value = item[column.name];
-      if (value === undefined && column.default !== undefined) {
-        value = column.default;
-      }
-      return this.serializeValue(value, column);
-    });
-
-    // Add __version column
-    columnNames.push("__version");
-    const placeholders = regularColumns.map((_, i) => `$${i + 1}`).join(", ");
-    const updateColumns = regularColumns
-      .filter((col) => col.name !== table.primaryKey)
-      .map((col) => `"${col.name}" = EXCLUDED."${col.name}"`)
-      .join(", ");
-
-    // Use a simpler approach: always increment and return the new version
-    const sql = `
-      WITH next_version AS (
-        INSERT INTO __arc_version_counters (table_name, last_version) 
-        VALUES ($${values.length + 1}, 1)
-        ON CONFLICT(table_name) 
-        DO UPDATE SET last_version = __arc_version_counters.last_version + 1
-        RETURNING last_version
-      ),
-      upsert AS (
-        INSERT INTO "${table.name}"
-        (${columnNames.map((c) => `"${c}"`).join(", ")})
-        VALUES (${placeholders}, (SELECT last_version FROM next_version))
-        ON CONFLICT ("${table.primaryKey}")
-        DO UPDATE SET ${updateColumns}${updateColumns ? ", " : ""}"__version" = (SELECT last_version FROM next_version)
-        RETURNING *
-      )
-      SELECT * FROM upsert
-    `;
-
-    this.queries.push({
-      sql: sql,
-      params: [...values, store],
-    });
-  }
-
-  async commit() {
-    if (this.queries.length === 0) {
-      return Promise.resolve();
-    }
-
-    try {
-      await this.db.execBatch(this.queries);
-      this.queries = [];
-    } catch (error) {
-      this.queries = [];
-      throw error;
-    }
-  }
-
-  private serializeValue(value: any, column: StoreColumn): any {
-    if (value === null || value === undefined) return null;
-
-    switch (column.type.toLowerCase()) {
-      case "timestamp":
-      case "datetime":
-      case "timestamptz":
-        // Handle various timestamp formats
-        if (value instanceof Date) {
-          if (isNaN(value.getTime())) {
-            console.error(
-              `[PostgreSQL] Invalid Date in column "${column.name}":`,
-              value,
-            );
-            console.error(`[PostgreSQL] Column type: ${column.type}`);
-            throw new Error(`Invalid Date value in column "${column.name}"`);
-          }
-          return value.toISOString();
-        }
-        if (typeof value === "number") {
-          // Unix timestamp (seconds or milliseconds)
-          const date = value > 1e10 ? new Date(value) : new Date(value * 1000);
-          if (isNaN(date.getTime())) {
-            console.error(
-              `[PostgreSQL] Invalid Date from number in column "${column.name}":`,
-              value,
-            );
-            throw new Error(
-              `Invalid Date value (from number) in column "${column.name}"`,
-            );
-          }
-          return date.toISOString();
-        }
-        if (typeof value === "string") {
-          // Already an ISO string or date string, validate and normalize
-          const date = new Date(value);
-          if (!isNaN(date.getTime())) {
-            return date.toISOString();
-          }
-          console.error(
-            `[PostgreSQL] Invalid Date string in column "${column.name}":`,
-            value,
-          );
-          throw new Error(
-            `Invalid Date string in column "${column.name}": "${value}"`,
-          );
-        }
-        console.error(
-          `[PostgreSQL] Unexpected date value type in column "${column.name}":`,
-          typeof value,
-          value,
-        );
-        throw new Error(
-          `Unexpected date value type in column "${column.name}": ${typeof value}`,
-        );
-      case "json":
-      case "jsonb":
-        return JSON.stringify(value);
-      default:
-        if (value instanceof Date) {
-          if (isNaN(value.getTime())) {
-            console.error(
-              `[PostgreSQL] Invalid Date in column "${column.name}" (default case):`,
-              value,
-            );
-            throw new Error(`Invalid Date value in column "${column.name}"`);
-          }
-          return value.toISOString();
-        }
-        if (Array.isArray(value) || typeof value === "object") {
-          return JSON.stringify(value);
-        }
-        return value;
-    }
-  }
-}
-
-export class PostgreSQLAdapter implements DatabaseAdapter {
-  private tables: Map<string, StoreTable> = new Map();
-  private tableSchemas: Map<string, any[]> = new Map();
-  private pendingReinitTables: Array<{
-    tableName: string;
-    reinitFn: (tableName: string, dataStorage: any) => Promise<void>;
-  }> = [];
-
-  private mapType(arcType: string, storeData?: DatabaseStoreData): string {
-    // Check for database-specific type override
-    if (storeData?.databaseType?.postgresql) {
-      return storeData.databaseType.postgresql;
-    }
-
-    switch (arcType) {
-      case "string":
-      case "stringEnum":
-        return "TEXT";
-      case "id":
-      case "customId":
-        // Use TEXT for regular string IDs, UUID only if explicitly specified
-        return storeData?.databaseType?.postgresql || "TEXT";
-      case "number":
-        return storeData?.isAutoIncrement ? "SERIAL" : "BIGINT";
-      case "boolean":
-        return "BOOLEAN";
-      case "date":
-        return "TIMESTAMPTZ";
-      case "object":
-      case "array":
-      case "record":
-        return "JSONB";
-      case "blob":
-        return "BYTEA";
-      default:
-        return "TEXT";
-    }
-  }
-
-  private buildConstraints(
-    storeData?: DatabaseStoreData,
-    skipForeignKey = false,
-  ): string[] {
-    const constraints: string[] = [];
-
-    if (storeData?.isPrimaryKey) {
-      constraints.push("PRIMARY KEY");
-    }
-    if (storeData?.isUnique) {
-      constraints.push("UNIQUE");
-    }
-    // Foreign keys are now added separately after all tables are created
-    // to avoid dependency ordering issues
-
-    return constraints;
-  }
-
-  private generateColumnSQL(
-    columnInfo: DatabaseAgnosticColumnInfo & { name: string },
-  ): string {
-    const type = this.mapType(columnInfo.type, columnInfo.storeData);
-    const constraints: string[] = [];
-
-    if (!columnInfo.storeData?.isNullable) {
-      constraints.push("NOT NULL");
-    }
-
-    constraints.push(...this.buildConstraints(columnInfo.storeData));
-
-    if (columnInfo.defaultValue !== undefined) {
-      if (type === "UUID" && columnInfo.defaultValue === "auto") {
-        constraints.push("DEFAULT gen_random_uuid()");
-      } else if (typeof columnInfo.defaultValue === "string") {
-        constraints.push(`DEFAULT '${columnInfo.defaultValue}'`);
-      } else {
-        constraints.push(`DEFAULT ${columnInfo.defaultValue}`);
-      }
-    }
-
-    return `"${columnInfo.name}" ${type} ${constraints.join(" ")}`.trim();
-  }
-
-  private generateCreateTableSQL(
-    tableName: string,
-    columns: (DatabaseAgnosticColumnInfo & { name: string })[],
-  ): { createTableSql: string; foreignKeySql: string[] } {
-    const columnDefinitions = columns.map((col) => this.generateColumnSQL(col));
-    const indexes = columns
-      .filter((col) => col.storeData?.hasIndex && !col.storeData?.isPrimaryKey)
-      .map(
-        (col) =>
-          `CREATE INDEX IF NOT EXISTS idx_${tableName}_${col.name} ON "${tableName}"("${col.name}");`,
-      );
-
-    // Collect foreign key constraints to add after table creation
-    const foreignKeySql: string[] = [];
-    for (const col of columns) {
-      if (col.storeData?.foreignKey) {
-        const { table, column, onDelete, onUpdate } = col.storeData.foreignKey;
-        let fkSql = `ALTER TABLE "${tableName}" ADD CONSTRAINT fk_${tableName}_${col.name} FOREIGN KEY ("${col.name}") REFERENCES "${table}"("${column}")`;
-        if (onDelete) fkSql += ` ON DELETE ${onDelete}`;
-        if (onUpdate) fkSql += ` ON UPDATE ${onUpdate}`;
-        foreignKeySql.push(fkSql);
-      }
-    }
-
-    let sql = `CREATE TABLE IF NOT EXISTS "${tableName}" (\n  ${columnDefinitions.join(",\n  ")}\n)`;
-
-    if (indexes.length > 0) {
-      sql += ";\n" + indexes.join("\n");
-    }
-
-    return { createTableSql: sql, foreignKeySql };
-  }
-
-  constructor(
-    private db: PostgreSQLDatabase,
-    private context: ArcContextAny,
-  ) {
-    this.context.elements.forEach((element) => {
-      if (
-        "databaseStoreSchema" in element &&
-        typeof element.databaseStoreSchema === "function"
-      ) {
-        const databaseSchema =
-          element.databaseStoreSchema() as DatabaseStoreSchema;
-
-        databaseSchema.tables.forEach((dbTable) => {
-          // Extract database-agnostic schema from ArcObject
-          const agnosticSchema = extractDatabaseAgnosticSchema(
-            dbTable.schema,
-            dbTable.name,
-          );
-
-          // Convert to database-specific columns
-          const columns = agnosticSchema.columns.map((columnInfo) => ({
-            name: columnInfo.name,
-            type: this.mapType(columnInfo.type, columnInfo.storeData),
-            constraints: this.buildConstraints(columnInfo.storeData),
-            isNullable: columnInfo.storeData?.isNullable || false,
-            defaultValue: columnInfo.defaultValue,
-            isPrimaryKey: columnInfo.storeData?.isPrimaryKey || false,
-            isAutoIncrement: columnInfo.storeData?.isAutoIncrement || false,
-            isUnique: columnInfo.storeData?.isUnique || false,
-            hasIndex: columnInfo.storeData?.hasIndex || false,
-            foreignKey: columnInfo.storeData?.foreignKey,
-          }));
-
-          this.tableSchemas.set(dbTable.name, columns);
-
-          // Convert to legacy StoreTable format for compatibility with existing transaction code
-          const legacyTable: StoreTable = {
-            name: dbTable.name,
-            primaryKey: columns.find((col) => col.isPrimaryKey)?.name || "_id",
-            columns: columns.map((col) => ({
-              name: col.name,
-              type: col.type,
-              isOptional: col.isNullable,
-              default: col.defaultValue,
-            })),
-          };
-          this.tables.set(dbTable.name, legacyTable);
-        });
-      }
-    });
-  }
-
-  private pendingForeignKeys: string[] = [];
-
-  public async initialize() {
-    // Create the version counter table first
-    await this.createVersionCounterTable();
-    // Create the table versions tracking table
-    await this.createTableVersionsTable();
-
-    const processedSchemas = new Set<DatabaseStoreSchema>();
-    const processedTables = new Set<string>();
-
-    // Clear pending foreign keys
-    this.pendingForeignKeys = [];
-
-    for (const element of this.context.elements) {
-      if (
-        "databaseStoreSchema" in element &&
-        typeof element.databaseStoreSchema === "function"
-      ) {
-        const databaseSchema =
-          element.databaseStoreSchema() as DatabaseStoreSchema;
-
-        // Skip if we've already processed this exact schema reference
-        if (processedSchemas.has(databaseSchema)) {
-          continue;
-        }
-        processedSchemas.add(databaseSchema);
-
-        for (const dbTable of databaseSchema.tables) {
-          const tableKey = dbTable.version
-            ? `${dbTable.name}_v${dbTable.version}`
-            : dbTable.name;
-
-          if (!processedTables.has(tableKey)) {
-            // Extract database-agnostic schema from ArcObject
-            const agnosticSchema = extractDatabaseAgnosticSchema(
-              dbTable.schema,
-              dbTable.name,
-            );
-
-            // Add system columns if enabled
-            let allColumns = [...agnosticSchema.columns];
-
-            if (dbTable.options?.versioning) {
-              allColumns.push({
-                name: "__version",
-                type: "number",
-                storeData: { isNullable: false, hasIndex: true },
-                defaultValue: 1,
-              });
-            }
-
-            if (dbTable.options?.softDelete) {
-              allColumns.push({
-                name: "deleted",
-                type: "boolean",
-                storeData: { isNullable: false, hasIndex: true },
-                defaultValue: false,
-              });
-            }
-
-            // Determine physical table name based on version
-            const physicalTableName = this.getPhysicalTableName(
-              dbTable.name,
-              dbTable.version,
-            );
-
-            // Check if versioned table already exists
-            if (
-              dbTable.version &&
-              (await this.checkVersionedTableExists(
-                dbTable.name,
-                dbTable.version,
-              ))
-            ) {
-              console.log(
-                `Versioned table ${physicalTableName} already exists, skipping creation`,
-              );
-            } else {
-              await this.createTableIfNotExistsNew(
-                physicalTableName,
-                allColumns,
-              );
-
-              // Register the new version if it's a versioned table
-              if (dbTable.version) {
-                await this.registerTableVersion(
-                  dbTable.name,
-                  dbTable.version,
-                  physicalTableName,
-                );
-
-                // Store reinit function for later execution
-                if (databaseSchema.reinitTable) {
-                  this.pendingReinitTables.push({
-                    tableName: physicalTableName,
-                    reinitFn: databaseSchema.reinitTable,
-                  });
-                }
-              }
-            }
-
-            // Update the legacy table mapping with the actual columns (including system columns)
-            const legacyTable: StoreTable = {
-              name: physicalTableName, // Use physical table name for actual queries
-              primaryKey:
-                allColumns.find((col) => col.storeData?.isPrimaryKey)?.name ||
-                "_id",
-              columns: allColumns.map((col) => ({
-                name: col.name,
-                type: this.mapType(col.type, col.storeData),
-                isOptional: col.storeData?.isNullable || false,
-                default: col.defaultValue,
-              })),
-            };
-            this.tables.set(dbTable.name, legacyTable); // Still use logical name as key
-
-            processedTables.add(tableKey);
-          }
-        }
-      }
-    }
-
-    // Apply all foreign key constraints after all tables are created
-    for (const fkSql of this.pendingForeignKeys) {
-      try {
-        await this.db.exec(fkSql);
-      } catch (error: any) {
-        // Ignore if constraint already exists
-        if (!error.message?.includes("already exists")) {
-          console.warn(
-            `Failed to add foreign key constraint: ${error.message}`,
-          );
-        }
-      }
-    }
-    this.pendingForeignKeys = [];
-  }
-
-  private async createTableIfNotExistsNew(
-    tableName: string,
-    columns: (DatabaseAgnosticColumnInfo & { name: string })[],
-  ) {
-    const { createTableSql, foreignKeySql } = this.generateCreateTableSQL(
-      tableName,
-      columns,
-    );
-    await this.db.exec(createTableSql);
-    // Collect foreign keys to be added after all tables are created
-    this.pendingForeignKeys.push(...foreignKeySql);
-  }
-
-  /**
-   * Create the version counter table for tracking per-table version sequences
-   */
-  private async createVersionCounterTable() {
-    const sql = `
-      CREATE TABLE IF NOT EXISTS __arc_version_counters (
-        table_name TEXT PRIMARY KEY,
-        last_version BIGINT NOT NULL DEFAULT 0
-      )
-    `;
-    await this.db.exec(sql);
-  }
-
-  /**
-   * Create the table versions tracking table for schema versioning
-   */
-  private async createTableVersionsTable() {
-    const sql = `
-      CREATE TABLE IF NOT EXISTS __arc_table_versions (
-        table_name TEXT NOT NULL,
-        version INTEGER NOT NULL,
-        physical_table_name TEXT NOT NULL,
-        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-        is_active BOOLEAN DEFAULT FALSE,
-        PRIMARY KEY (table_name, version)
-      )
-    `;
-    await this.db.exec(sql);
-  }
-
-  /**
-   * Generate physical table name with version suffix
-   */
-  private getPhysicalTableName(logicalName: string, version?: number): string {
-    return version ? `${logicalName}_v${version}` : logicalName;
-  }
-
-  /**
-   * Check if a versioned table exists
-   */
-  private async checkVersionedTableExists(
-    logicalName: string,
-    version: number,
-  ): Promise<boolean> {
-    const result = await this.db.exec(
-      "SELECT COUNT(*) as count FROM __arc_table_versions WHERE table_name = $1 AND version = $2",
-      [logicalName, version],
-    );
-    return result[0]?.count > 0;
-  }
-
-  /**
-   * Register a new table version
-   */
-  private async registerTableVersion(
-    logicalName: string,
-    version: number,
-    physicalName: string,
-  ): Promise<void> {
-    await this.db.exec(
-      "INSERT INTO __arc_table_versions (table_name, version, physical_table_name, is_active) VALUES ($1, $2, $3, $4)",
-      [logicalName, version, physicalName, true],
-    );
-  }
-
-  /**
-   * Check if a table has versioning enabled
-   */
-  public hasVersioning(tableName: string): boolean {
-    // Check if the table has a __version column
-    const table = this.tables.get(tableName);
-    if (!table) return false;
-    return table.columns.some((col) => col.name === "__version");
-  }
-
-  /**
-   * Check if a table has soft delete enabled
-   */
-  public hasSoftDelete(tableName: string): boolean {
-    // Check if the table has a deleted column
-    const table = this.tables.get(tableName);
-    if (!table) return false;
-    return table.columns.some((col) => col.name === "deleted");
-  }
-
-  /**
-   * Execute all pending reinitTable functions
-   */
-  public async executeReinitTables(dataStorage: any): Promise<void> {
-    for (const { tableName, reinitFn } of this.pendingReinitTables) {
-      try {
-        await reinitFn(tableName, dataStorage);
-        console.log(`Successfully reinitialized table: ${tableName}`);
-      } catch (error) {
-        console.error(`Failed to reinitialize table ${tableName}:`, error);
-        throw error;
-      }
-    }
-    // Clear the pending list after execution
-    this.pendingReinitTables = [];
-  }
-
-  readWriteTransaction(stores?: string[]) {
-    return new PostgreSQLReadWriteTransaction(this.db, this.tables, this);
-  }
-
-  readTransaction(stores?: string[]) {
-    return new PostgreSQLReadTransaction(this.db, this.tables, this);
-  }
-}
-
-export const createPostgreSQLAdapterFactory = (
-  db: PostgreSQLDatabase,
-): DBAdapterFactory => {
-  return async (context: ArcContextAny): Promise<DatabaseAdapter> => {
-    const adapter = new PostgreSQLAdapter(db, context);
-    await adapter.initialize();
-    return adapter;
-  };
-};
-
-/**
- * Wrapper for the 'postgres' package (postgres.js) to implement PostgreSQLDatabase interface
- */
-class PostgresJsDatabase implements PostgreSQLDatabase {
-  constructor(private sql: any) {}
-
-  async exec(sql: string, params?: any[]): Promise<any> {
-    try {
-      if (params && params.length > 0) {
-        const result = await this.sql.unsafe(sql, params);
-        return Array.from(result);
-      }
-      const result = await this.sql.unsafe(sql);
-      return Array.from(result);
-    } catch (error) {
-      console.error("PostgreSQL error:", error);
-      console.error("Failed SQL:", sql);
-      console.error("Failed params:", JSON.stringify(params, null, 2));
-      throw error;
-    }
-  }
-
-  async execBatch(
-    queries: Array<{ sql: string; params?: any[] }>,
-  ): Promise<any> {
-    return this.sql.begin(async (tx: any) => {
-      for (const query of queries) {
-        if (query.params && query.params.length > 0) {
-          await tx.unsafe(query.sql, query.params);
-        } else {
-          await tx.unsafe(query.sql);
-        }
-      }
-    });
-  }
-}
-
-import postgres from "postgres";
-
-/**
- * Create a PostgreSQL adapter factory from a connection string
- *
- * @param connectionString - PostgreSQL connection URL (e.g., "postgresql://user:pass@localhost:5432/db")
- *
- * @example
- * ```ts
- * const dbAdapterFactory = createPostgreSQLAdapterFactoryFromUrl("postgresql://user:pass@localhost:5432/db");
- * ```
- */
-export const createPostgreSQLAdapterFactoryFromUrl = (
-  connectionString: string,
-): DBAdapterFactory => {
-  const sql = postgres(connectionString, {
-    // Suppress NOTICE messages like "relation already exists, skipping"
-    onnotice: () => {},
-  });
-  const db = new PostgresJsDatabase(sql);
-  return createPostgreSQLAdapterFactory(db);
-};