@happyvertical/smrt-core 0.40.69 → 0.41.0

package/dist/migrations/generator.js

@@ -1,8 +1,10 @@
 import { renderIndexTarget } from "../schema/index-utils.js";
 import { getDDLStrategy } from "../schema/ddl/index.js";
 import { materializeManifestDDLForEngine } from "../schema/ddl/materialize-manifest.js";
+import { cachedDdlTableConstraints } from "../schema/manifest-schema.js";
 import "../schema/utils.js";
 import { computeChecksum } from "./checksum.js";
+import { createLogger } from "@happyvertical/logger";
 //#region src/migrations/generator.ts
 /**
 * Migration Generator
@@ -10,6 +12,7 @@ import { computeChecksum } from "./checksum.js";
 * Generates migration files from schema diffs.
 * Supports both SQL and TypeScript formats.
 */
+var logger = createLogger({ level: "info" });
 /**
 * MigrationGenerator class for creating migration files
 */
@@ -24,7 +27,7 @@ var MigrationGenerator = class {
 		this.format = options.format || "sql";
 		this.includeDown = options.includeDown ?? true;
 		this.packageName = options.packageName;
-		this.materializeStructuredSchema = options.materializeStructuredSchema ?? false;
+		this.materializeStructuredSchema = options.materializeStructuredSchema ?? true;
 	}
 	/**
 	* Generate a migration from a schema diff
@@ -34,6 +37,8 @@ var MigrationGenerator = class {
 		const downStatements = [];
 		for (const schema of diff.added_tables) {
 			upStatements.push(this.generateCreateTable(schema));
+			upStatements.push(...this.generateTableIndexes(schema));
+			upStatements.push(...this.generateTableTriggers(schema));
 			if (this.includeDown || options.includeDown) downStatements.push(this.generateDropTable(schema.tableName));
 		}
 		for (const change of diff.changes) {
@@ -90,11 +95,11 @@ var MigrationGenerator = class {
 		lines.push("");
 		lines.push("-- @up");
 		if (upStatements.length === 0) lines.push("-- Add your UP statements here");
-		else for (const stmt of upStatements) lines.push(`${stmt};`);
+		else for (const stmt of upStatements) lines.push(this.terminateStatement(stmt));
 		lines.push("");
 		lines.push("-- @down");
 		if (downStatements.length === 0) lines.push("-- Add your DOWN statements here");
-		else for (const stmt of downStatements) lines.push(`${stmt};`);
+		else for (const stmt of downStatements) lines.push(this.terminateStatement(stmt));
 		lines.push("");
 		return lines.join("\n");
 	}
@@ -134,9 +139,27 @@ ${downStatementsStr}
 	generateCreateTable(schema) {
 		if (Object.keys(schema.columns).length === 0 && schema.ddl?.trim()) return materializeManifestDDLForEngine(schema.ddl, this.engine);
 		if (!this.materializeStructuredSchema && schema.ddl?.trim()) return materializeManifestDDLForEngine(schema.ddl, this.engine);
+		if (schema.ddl?.trim()) {
+			const constraints = cachedDdlTableConstraints(schema.ddl);
+			if (constraints.length > 0) logger.warn(`[MigrationGenerator] cached ddl for table "${schema.tableName}" declares ${constraints.length} table constraint(s) that structured columns cannot carry (${constraints.join("; ")}); the structured schema is authoritative and they are not rendered (#2358).`);
+		}
 		return getDDLStrategy(this.engine).generateCreateTable(schema);
 	}
 	/**
+	* Generate the CREATE INDEX statements for a new table through the engine
+	* strategy (partial `WHERE`, JSON-path targets, inline-UNIQUE engines).
+	*/
+	generateTableIndexes(schema) {
+		return getDDLStrategy(this.engine).generateIndexes(schema);
+	}
+	/**
+	* Generate the CREATE TRIGGER statements for a new table (engines without
+	* trigger support return none).
+	*/
+	generateTableTriggers(schema) {
+		return getDDLStrategy(this.engine).generateTriggers(schema);
+	}
+	/**
 	* Generate DROP TABLE SQL
 	*/
 	generateDropTable(tableName) {
@@ -177,6 +200,16 @@ ${downStatementsStr}
 				up.push(`-- Expected: ${change.mismatch?.expected}, Actual: ${change.mismatch?.actual}`);
 				up.push(`-- Manual migration required`);
 				break;
+			case "alter_column":
+				if (change.advisory && sqlStatements.length === 0) break;
+				for (const sql of sqlStatements) up.push(sql);
+				break;
+			case "orphan_column":
+			case "orphan_index":
+				up.push(`-- ${change.advisory?.severity === "warning" ? "WARNING" : "NOTE"}: ${change.type === "orphan_column" ? "Orphan column" : "Orphan unique constraint"} ${change.table}.${change.name} (${change.mismatch?.actual ?? "unknown shape"})`);
+				if (change.advisory?.message) up.push(`-- ${change.advisory.message}`);
+				for (const suggestion of change.advisory?.suggestedSql ?? []) up.push(`-- suggested: ${suggestion}`);
+				break;
 			default: break;
 		}
 		return {
@@ -206,8 +239,9 @@ ${downStatementsStr}
 	generateAddIndex(tableName, index) {
 		const uniqueStr = index.unique ? "UNIQUE " : "";
 		const target = renderIndexTarget(index, this.engine);
-		if (this.engine === "postgres") return `CREATE ${uniqueStr}INDEX CONCURRENTLY IF NOT EXISTS ${this.quoteIdentifier(index.name)} ON ${this.quoteIdentifier(tableName)} (${target})`;
-		return `CREATE ${uniqueStr}INDEX IF NOT EXISTS ${this.quoteIdentifier(index.name)} ON ${this.quoteIdentifier(tableName)} (${target})`;
+		const whereClause = this.engine !== "duckdb" && index.where ? ` WHERE ${index.where}` : "";
+		if (this.engine === "postgres") return `CREATE ${uniqueStr}INDEX CONCURRENTLY IF NOT EXISTS ${this.quoteIdentifier(index.name)} ON ${this.quoteIdentifier(tableName)} (${target})${whereClause}`;
+		return `CREATE ${uniqueStr}INDEX IF NOT EXISTS ${this.quoteIdentifier(index.name)} ON ${this.quoteIdentifier(tableName)} (${target})${whereClause}`;
 	}
 	/**
 	* Generate DROP INDEX SQL
@@ -233,6 +267,16 @@ ${downStatementsStr}
 		return String(value);
 	}
 	/**
+	* Terminate a statement with exactly one `;` for the SQL file format.
+	*
+	* Strategy-rendered statements (`generateCreateTable`, `generateIndexes`,
+	* `generateTriggers`) already end with `;`, while differ-produced ALTERs do
+	* not — appending unconditionally wrote `;;` (#2406 review).
+	*/
+	terminateStatement(stmt) {
+		return stmt.trimEnd().endsWith(";") ? stmt : `${stmt};`;
+	}
+	/**
 	* Escape template literal content
 	*/
 	escapeTemplate(str) {

package/dist/migrations/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","names":[],"sources":["../../src/migrations/generator.ts"],"sourcesContent":["/**\n * Migration Generator\n *\n * Generates migration files from schema diffs.\n * Supports both SQL and TypeScript formats.\n */\n\nimport { getDDLStrategy } from '../schema/ddl/index.js';\nimport { materializeManifestDDLForEngine } from '../schema/ddl/materialize-manifest.js';\nimport type {\n  MigrationDefinition,\n  SchemaChange,\n  SchemaDefinition,\n  SchemaDiff,\n} from '../schema/types.js';\nimport { renderIndexTarget } from '../schema/utils.js';\nimport { computeChecksum } from './checksum.js';\nimport type { DatabaseEngine } from './types.js';\n\n/**\n * Options for migration generation\n */\nexport interface GenerateMigrationOptions {\n  /** Migration name (without sequence number) */\n  name: string;\n  /** Output format */\n  format?: 'sql' | 'typescript';\n  /** Database engine for engine-specific SQL */\n  engine?: DatabaseEngine;\n  /** Include generated DOWN statements */\n  includeDown?: boolean;\n  /** Package name for metadata */\n  packageName?: string;\n  /** Description for the migration */\n  description?: string;\n}\n\n/**\n * Result of migration generation\n */\nexport interface GeneratedMigration {\n  /** Full migration ID (e.g., '0001_add_users') */\n  id: string;\n  /** Filename (e.g., '0001_add_users.sql') */\n  filename: string;\n  /** File content */\n  content: string;\n  /** UP SQL statements */\n  up: string[];\n  /** DOWN SQL statements (if includeDown is true) */\n  down: string[];\n  /** Checksum of the migration */\n  checksum: string;\n}\n\n/**\n * MigrationGenerator class for creating migration files\n */\nexport class MigrationGenerator {\n  private engine: DatabaseEngine;\n  private format: 'sql' | 'typescript';\n  private includeDown: boolean;\n  private packageName?: string;\n  private materializeStructuredSchema: boolean;\n\n  constructor(\n    options: {\n      engine?: DatabaseEngine;\n      format?: 'sql' | 'typescript';\n      includeDown?: boolean;\n      packageName?: string;\n      /**\n       * Ignore cached manifest DDL and materialize structured columns for the\n       * selected engine. Framework-owned executable paths should enable this;\n       * the default preserves the published custom-DDL contract while still\n       * materializing bare PostgreSQL TIMESTAMP columns as TIMESTAMPTZ.\n       */\n      materializeStructuredSchema?: boolean;\n    } = {},\n  ) {\n    this.engine = options.engine || 'sqlite';\n    this.format = options.format || 'sql';\n    this.includeDown = options.includeDown ?? true;\n    this.packageName = options.packageName;\n    this.materializeStructuredSchema =\n      options.materializeStructuredSchema ?? false;\n  }\n\n  /**\n   * Generate a migration from a schema diff\n   */\n  generateFromDiff(\n    diff: SchemaDiff,\n    options: GenerateMigrationOptions,\n  ): GeneratedMigration {\n    const upStatements: string[] = [];\n    const downStatements: string[] = [];\n\n    // Handle new tables\n    for (const schema of diff.added_tables) {\n      upStatements.push(this.generateCreateTable(schema));\n      if (this.includeDown || options.includeDown) {\n        downStatements.push(this.generateDropTable(schema.tableName));\n      }\n    }\n\n    // Handle column and index changes\n    for (const change of diff.changes) {\n      const { up, down } = this.generateChangeSQL(change);\n      upStatements.push(...up);\n      if ((this.includeDown || options.includeDown) && down.length > 0) {\n        downStatements.push(...down);\n      }\n    }\n\n    // Handle dropped tables (already in SQL form if present)\n    for (const tableName of diff.dropped_tables) {\n      upStatements.push(this.generateDropTable(tableName));\n      // No automatic DOWN for drops - too dangerous\n    }\n\n    return this.generateMigration(upStatements, downStatements, options);\n  }\n\n  /**\n   * Generate a migration from explicit SQL statements\n   */\n  generateFromSQL(\n    upStatements: string[],\n    downStatements: string[],\n    options: GenerateMigrationOptions,\n  ): GeneratedMigration {\n    return this.generateMigration(upStatements, downStatements, options);\n  }\n\n  /**\n   * Generate an empty migration template\n   */\n  generateEmpty(options: GenerateMigrationOptions): GeneratedMigration {\n    return this.generateMigration([], [], options);\n  }\n\n  /**\n   * Core migration generation logic\n   */\n  private generateMigration(\n    upStatements: string[],\n    downStatements: string[],\n    options: GenerateMigrationOptions,\n  ): GeneratedMigration {\n    const id = options.name;\n    const description = options.description || `Migration: ${options.name}`;\n    const format = options.format || this.format;\n    const filename = `${id}.${format === 'sql' ? 'sql' : 'ts'}`;\n    const checksum = computeChecksum(upStatements);\n\n    let content: string;\n    if (format === 'sql') {\n      content = this.generateSQLFile(\n        id,\n        description,\n        upStatements,\n        downStatements,\n      );\n    } else {\n      content = this.generateTypeScriptFile(\n        id,\n        description,\n        upStatements,\n        downStatements,\n      );\n    }\n\n    return {\n      id,\n      filename,\n      content,\n      up: upStatements,\n      down: downStatements,\n      checksum,\n    };\n  }\n\n  /**\n   * Generate SQL migration file content\n   */\n  private generateSQLFile(\n    id: string,\n    description: string,\n    upStatements: string[],\n    downStatements: string[],\n  ): string {\n    const lines: string[] = [\n      `-- @id: ${id}`,\n      `-- @description: ${description}`,\n      `-- @generated: ${new Date().toISOString()}`,\n    ];\n\n    if (this.packageName) {\n      lines.push(`-- @package: ${this.packageName}`);\n    }\n\n    lines.push('');\n    lines.push('-- @up');\n\n    if (upStatements.length === 0) {\n      lines.push('-- Add your UP statements here');\n    } else {\n      for (const stmt of upStatements) {\n        lines.push(`${stmt};`);\n      }\n    }\n\n    lines.push('');\n    lines.push('-- @down');\n\n    if (downStatements.length === 0) {\n      lines.push('-- Add your DOWN statements here');\n    } else {\n      for (const stmt of downStatements) {\n        lines.push(`${stmt};`);\n      }\n    }\n\n    lines.push('');\n    return lines.join('\\n');\n  }\n\n  /**\n   * Generate TypeScript migration file content\n   */\n  private generateTypeScriptFile(\n    id: string,\n    description: string,\n    upStatements: string[],\n    downStatements: string[],\n  ): string {\n    const upStatementsStr =\n      upStatements.length > 0\n        ? upStatements\n            .map((s) => `      await db.query(\\`${this.escapeTemplate(s)}\\`);`)\n            .join('\\n')\n        : '      // Add your UP statements here';\n\n    const downStatementsStr =\n      downStatements.length > 0\n        ? downStatements\n            .map((s) => `      await db.query(\\`${this.escapeTemplate(s)}\\`);`)\n            .join('\\n')\n        : '      // Add your DOWN statements here';\n\n    return `/**\n * Migration: ${id}\n * ${description}\n *\n * Generated: ${new Date().toISOString()}\n */\n\nimport type { Migration } from '@happyvertical/smrt-core';\n\nexport default {\n  id: '${id}',\n  description: '${description.replace(/'/g, \"\\\\'\")}',\n  version: '1.0.0',\n\n  up: async (db) => {\n${upStatementsStr}\n  },\n\n  down: async (db) => {\n${downStatementsStr}\n  },\n} satisfies Migration;\n`;\n  }\n\n  /**\n   * Generate CREATE TABLE SQL from schema definition\n   */\n  private generateCreateTable(schema: SchemaDefinition): string {\n    if (Object.keys(schema.columns).length === 0 && schema.ddl?.trim()) {\n      // Structured materialization cannot preserve constraints or vendor SQL\n      // when an older/custom manifest exposes only executable DDL. Retain the\n      // only valid representation even when materialization was requested.\n      return materializeManifestDDLForEngine(schema.ddl, this.engine);\n    }\n\n    if (!this.materializeStructuredSchema && schema.ddl?.trim()) {\n      // Preserve the documented custom-DDL contract by default, including\n      // table-level constraints that structured ColumnDefinition cannot\n      // represent. Engine-aware framework callers explicitly opt into the\n      // structured materialization path below.\n      return materializeManifestDDLForEngine(schema.ddl, this.engine);\n    }\n\n    // The manifest's pre-generated `ddl` is deliberately engine-neutral and\n    // may contain abstract TIMESTAMP/JSON/UUID types. Always materialize the\n    // structured columns through the selected engine strategy; executing the\n    // cached string on PostgreSQL would otherwise bypass TIMESTAMPTZ and lose\n    // JavaScript Date offsets (#2069). This matches the migration orchestrator\n    // and also prevents JSON/REAL/UUID drift after a create.\n    return getDDLStrategy(this.engine).generateCreateTable(schema);\n  }\n\n  /**\n   * Generate DROP TABLE SQL\n   */\n  private generateDropTable(tableName: string): string {\n    return `DROP TABLE IF EXISTS ${this.quoteIdentifier(tableName)}`;\n  }\n\n  /**\n   * Generate SQL for a schema change\n   */\n  private generateChangeSQL(change: SchemaChange): {\n    up: string[];\n    down: string[];\n  } {\n    const up: string[] = [];\n    const down: string[] = [];\n    const sqlStatements =\n      change.sqlStatements ?? (change.sql ? [change.sql] : []);\n\n    switch (change.type) {\n      case 'add_column':\n        if (sqlStatements.length > 0) {\n          up.push(...sqlStatements);\n        } else if (change.column && change.name) {\n          up.push(\n            this.generateAddColumn(change.table, change.name, change.column),\n          );\n        }\n        if (change.name) {\n          down.push(this.generateDropColumn(change.table, change.name));\n        }\n        break;\n\n      case 'drop_column':\n        if (sqlStatements.length > 0) {\n          up.push(...sqlStatements);\n        } else if (change.name) {\n          up.push(this.generateDropColumn(change.table, change.name));\n        }\n        // No automatic DOWN for drops\n        break;\n\n      case 'add_index':\n        if (sqlStatements.length > 0) {\n          up.push(...sqlStatements);\n        } else if (change.index) {\n          up.push(this.generateAddIndex(change.table, change.index));\n        }\n        if (change.name) {\n          down.push(this.generateDropIndex(change.name));\n        }\n        break;\n\n      case 'drop_index':\n        if (change.name) {\n          up.push(this.generateDropIndex(change.name));\n        }\n        // No automatic DOWN for index drops\n        break;\n\n      case 'type_upgrade':\n        // Type upgrades are safe conversions that SMRT can handle automatically\n        // The SQL is generated by the differ based on engine-specific requirements\n        if (sqlStatements.length > 0) {\n          for (const sql of sqlStatements) {\n            // Skip comment-only SQL (indicates a no-op migration)\n            if (!sql.startsWith('--')) {\n              up.push(sql);\n            }\n          }\n        }\n        // No automatic DOWN for type changes - could lose data\n        break;\n\n      case 'type_mismatch':\n        // Type mismatches require manual intervention\n        up.push(`-- WARNING: Type mismatch for ${change.table}.${change.name}`);\n        up.push(\n          `-- Expected: ${change.mismatch?.expected}, Actual: ${change.mismatch?.actual}`,\n        );\n        up.push(`-- Manual migration required`);\n        break;\n\n      default:\n        // Unknown change type\n        break;\n    }\n\n    return { up, down };\n  }\n\n  /**\n   * Generate ADD COLUMN SQL\n   */\n  private generateAddColumn(\n    tableName: string,\n    colName: string,\n    colDef: import('../schema/types.js').ColumnDefinition,\n  ): string {\n    const parts: string[] = [this.quoteIdentifier(colName), colDef.type];\n\n    if (colDef.notNull) {\n      parts.push('NOT NULL');\n    }\n    if (colDef.unique) {\n      parts.push('UNIQUE');\n    }\n    if (colDef.defaultValue !== undefined) {\n      parts.push(`DEFAULT ${this.formatDefaultValue(colDef.defaultValue)}`);\n    }\n\n    return `ALTER TABLE ${this.quoteIdentifier(tableName)} ADD COLUMN ${parts.join(' ')}`;\n  }\n\n  /**\n   * Generate DROP COLUMN SQL\n   */\n  private generateDropColumn(tableName: string, colName: string): string {\n    return `ALTER TABLE ${this.quoteIdentifier(tableName)} DROP COLUMN ${this.quoteIdentifier(colName)}`;\n  }\n\n  /**\n   * Generate ADD INDEX SQL\n   */\n  private generateAddIndex(\n    tableName: string,\n    index: import('../schema/types.js').IndexDefinition,\n  ): string {\n    const uniqueStr = index.unique ? 'UNIQUE ' : '';\n    const target = renderIndexTarget(index, this.engine);\n\n    if (this.engine === 'postgres') {\n      // PostgreSQL: use CONCURRENTLY for production safety\n      return `CREATE ${uniqueStr}INDEX CONCURRENTLY IF NOT EXISTS ${this.quoteIdentifier(index.name)} ON ${this.quoteIdentifier(tableName)} (${target})`;\n    }\n\n    return `CREATE ${uniqueStr}INDEX IF NOT EXISTS ${this.quoteIdentifier(index.name)} ON ${this.quoteIdentifier(tableName)} (${target})`;\n  }\n\n  /**\n   * Generate DROP INDEX SQL\n   */\n  private generateDropIndex(indexName: string): string {\n    if (this.engine === 'postgres') {\n      return `DROP INDEX CONCURRENTLY IF EXISTS ${this.quoteIdentifier(indexName)}`;\n    }\n    return `DROP INDEX IF EXISTS ${this.quoteIdentifier(indexName)}`;\n  }\n\n  /**\n   * Quote a SQL identifier\n   */\n  private quoteIdentifier(name: string): string {\n    return `\"${name.replace(/\"/g, '\"\"')}\"`;\n  }\n\n  /**\n   * Format a default value for SQL\n   */\n  private formatDefaultValue(value: unknown): string {\n    if (value === null) return 'NULL';\n    if (typeof value === 'string') return `'${value.replace(/'/g, \"''\")}'`;\n    if (typeof value === 'boolean') return value ? '1' : '0';\n    if (typeof value === 'number') return String(value);\n    return String(value);\n  }\n\n  /**\n   * Escape template literal content\n   */\n  private escapeTemplate(str: string): string {\n    return str.replace(/`/g, '\\\\`').replace(/\\$/g, '\\\\$');\n  }\n}\n\n/**\n * Generate a migration definition from UP and DOWN statements\n */\nexport function createMigrationDefinition(\n  id: string,\n  upStatements: string[],\n  downStatements: string[] = [],\n  options: {\n    description?: string;\n    version?: string;\n    packageName?: string;\n    sourceFile?: string;\n  } = {},\n): MigrationDefinition {\n  return {\n    id,\n    description: options.description || `Migration: ${id}`,\n    version: options.version || '1.0.0',\n    up: upStatements,\n    down: downStatements,\n    package_name: options.packageName,\n    source_file: options.sourceFile,\n  };\n}\n\n/**\n * Generate a sequence number for a new migration\n */\nexport function generateMigrationSequence(existingIds: string[]): string {\n  const sequences = existingIds\n    .map((id) => {\n      const match = id.match(/^(\\d+)_/);\n      return match ? parseInt(match[1], 10) : 0;\n    })\n    .filter((n) => !Number.isNaN(n));\n\n  const maxSequence = sequences.length > 0 ? Math.max(...sequences) : 0;\n  return String(maxSequence + 1).padStart(4, '0');\n}\n\n/**\n * Generate a timestamp-based migration ID\n */\nexport function generateMigrationTimestamp(): string {\n  const now = new Date();\n  return [\n    now.getFullYear(),\n    String(now.getMonth() + 1).padStart(2, '0'),\n    String(now.getDate()).padStart(2, '0'),\n    String(now.getHours()).padStart(2, '0'),\n    String(now.getMinutes()).padStart(2, '0'),\n    String(now.getSeconds()).padStart(2, '0'),\n  ].join('');\n}\n"],"mappings":"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"}
+{"version":3,"file":"generator.js","names":[],"sources":["../../src/migrations/generator.ts"],"sourcesContent":["/**\n * Migration Generator\n *\n * Generates migration files from schema diffs.\n * Supports both SQL and TypeScript formats.\n */\n\nimport { createLogger } from '@happyvertical/logger';\nimport { getDDLStrategy } from '../schema/ddl/index.js';\nimport { materializeManifestDDLForEngine } from '../schema/ddl/materialize-manifest.js';\nimport { cachedDdlTableConstraints } from '../schema/manifest-schema.js';\nimport type {\n  MigrationDefinition,\n  SchemaChange,\n  SchemaDefinition,\n  SchemaDiff,\n} from '../schema/types.js';\nimport { renderIndexTarget } from '../schema/utils.js';\nimport { computeChecksum } from './checksum.js';\nimport type { DatabaseEngine } from './types.js';\n\nconst logger = createLogger({ level: 'info' });\n\n/**\n * Options for migration generation\n */\nexport interface GenerateMigrationOptions {\n  /** Migration name (without sequence number) */\n  name: string;\n  /** Output format */\n  format?: 'sql' | 'typescript';\n  /** Database engine for engine-specific SQL */\n  engine?: DatabaseEngine;\n  /** Include generated DOWN statements */\n  includeDown?: boolean;\n  /** Package name for metadata */\n  packageName?: string;\n  /** Description for the migration */\n  description?: string;\n}\n\n/**\n * Result of migration generation\n */\nexport interface GeneratedMigration {\n  /** Full migration ID (e.g., '0001_add_users') */\n  id: string;\n  /** Filename (e.g., '0001_add_users.sql') */\n  filename: string;\n  /** File content */\n  content: string;\n  /** UP SQL statements */\n  up: string[];\n  /** DOWN SQL statements (if includeDown is true) */\n  down: string[];\n  /** Checksum of the migration */\n  checksum: string;\n}\n\n/**\n * MigrationGenerator class for creating migration files\n */\nexport class MigrationGenerator {\n  private engine: DatabaseEngine;\n  private format: 'sql' | 'typescript';\n  private includeDown: boolean;\n  private packageName?: string;\n  private materializeStructuredSchema: boolean;\n\n  constructor(\n    options: {\n      engine?: DatabaseEngine;\n      format?: 'sql' | 'typescript';\n      includeDown?: boolean;\n      packageName?: string;\n      /**\n       * Render new tables from their structured columns through the engine's\n       * DDL strategy (default, `true`) — the same renderer `db:migrate` uses,\n       * so column types, indexes and triggers match what the differ expects\n       * on the next run.\n       *\n       * @deprecated Passing `false` re-enables the retired cached-`ddl` string\n       * path for the CREATE TABLE only (#2358): it emits the manifest's\n       * engine-neutral CREATE TABLE with only bare PostgreSQL `TIMESTAMP`\n       * rewritten, so `REAL`/`JSON` drift on PostgreSQL. The table's indexes\n       * and triggers are still rendered through the engine strategy either\n       * way — the flag never suppresses them. Schemas that expose no\n       * structured columns always fall back to their cached `ddl` regardless\n       * of this flag.\n       */\n      materializeStructuredSchema?: boolean;\n    } = {},\n  ) {\n    this.engine = options.engine || 'sqlite';\n    this.format = options.format || 'sql';\n    this.includeDown = options.includeDown ?? true;\n    this.packageName = options.packageName;\n    this.materializeStructuredSchema =\n      options.materializeStructuredSchema ?? true;\n  }\n\n  /**\n   * Generate a migration from a schema diff\n   */\n  generateFromDiff(\n    diff: SchemaDiff,\n    options: GenerateMigrationOptions,\n  ): GeneratedMigration {\n    const upStatements: string[] = [];\n    const downStatements: string[] = [];\n\n    // Handle new tables: CREATE TABLE plus the table's indexes and triggers,\n    // exactly as the migration orchestrator emits them (#2358). The differ\n    // only produces `add_index` changes for tables that already exist, so\n    // there is no double emission against `diff.changes`.\n    for (const schema of diff.added_tables) {\n      upStatements.push(this.generateCreateTable(schema));\n      upStatements.push(...this.generateTableIndexes(schema));\n      upStatements.push(...this.generateTableTriggers(schema));\n      if (this.includeDown || options.includeDown) {\n        downStatements.push(this.generateDropTable(schema.tableName));\n      }\n    }\n\n    // Handle column and index changes\n    for (const change of diff.changes) {\n      const { up, down } = this.generateChangeSQL(change);\n      upStatements.push(...up);\n      if ((this.includeDown || options.includeDown) && down.length > 0) {\n        downStatements.push(...down);\n      }\n    }\n\n    // Handle dropped tables (already in SQL form if present)\n    for (const tableName of diff.dropped_tables) {\n      upStatements.push(this.generateDropTable(tableName));\n      // No automatic DOWN for drops - too dangerous\n    }\n\n    return this.generateMigration(upStatements, downStatements, options);\n  }\n\n  /**\n   * Generate a migration from explicit SQL statements\n   */\n  generateFromSQL(\n    upStatements: string[],\n    downStatements: string[],\n    options: GenerateMigrationOptions,\n  ): GeneratedMigration {\n    return this.generateMigration(upStatements, downStatements, options);\n  }\n\n  /**\n   * Generate an empty migration template\n   */\n  generateEmpty(options: GenerateMigrationOptions): GeneratedMigration {\n    return this.generateMigration([], [], options);\n  }\n\n  /**\n   * Core migration generation logic\n   */\n  private generateMigration(\n    upStatements: string[],\n    downStatements: string[],\n    options: GenerateMigrationOptions,\n  ): GeneratedMigration {\n    const id = options.name;\n    const description = options.description || `Migration: ${options.name}`;\n    const format = options.format || this.format;\n    const filename = `${id}.${format === 'sql' ? 'sql' : 'ts'}`;\n    const checksum = computeChecksum(upStatements);\n\n    let content: string;\n    if (format === 'sql') {\n      content = this.generateSQLFile(\n        id,\n        description,\n        upStatements,\n        downStatements,\n      );\n    } else {\n      content = this.generateTypeScriptFile(\n        id,\n        description,\n        upStatements,\n        downStatements,\n      );\n    }\n\n    return {\n      id,\n      filename,\n      content,\n      up: upStatements,\n      down: downStatements,\n      checksum,\n    };\n  }\n\n  /**\n   * Generate SQL migration file content\n   */\n  private generateSQLFile(\n    id: string,\n    description: string,\n    upStatements: string[],\n    downStatements: string[],\n  ): string {\n    const lines: string[] = [\n      `-- @id: ${id}`,\n      `-- @description: ${description}`,\n      `-- @generated: ${new Date().toISOString()}`,\n    ];\n\n    if (this.packageName) {\n      lines.push(`-- @package: ${this.packageName}`);\n    }\n\n    lines.push('');\n    lines.push('-- @up');\n\n    if (upStatements.length === 0) {\n      lines.push('-- Add your UP statements here');\n    } else {\n      for (const stmt of upStatements) {\n        lines.push(this.terminateStatement(stmt));\n      }\n    }\n\n    lines.push('');\n    lines.push('-- @down');\n\n    if (downStatements.length === 0) {\n      lines.push('-- Add your DOWN statements here');\n    } else {\n      for (const stmt of downStatements) {\n        lines.push(this.terminateStatement(stmt));\n      }\n    }\n\n    lines.push('');\n    return lines.join('\\n');\n  }\n\n  /**\n   * Generate TypeScript migration file content\n   */\n  private generateTypeScriptFile(\n    id: string,\n    description: string,\n    upStatements: string[],\n    downStatements: string[],\n  ): string {\n    const upStatementsStr =\n      upStatements.length > 0\n        ? upStatements\n            .map((s) => `      await db.query(\\`${this.escapeTemplate(s)}\\`);`)\n            .join('\\n')\n        : '      // Add your UP statements here';\n\n    const downStatementsStr =\n      downStatements.length > 0\n        ? downStatements\n            .map((s) => `      await db.query(\\`${this.escapeTemplate(s)}\\`);`)\n            .join('\\n')\n        : '      // Add your DOWN statements here';\n\n    return `/**\n * Migration: ${id}\n * ${description}\n *\n * Generated: ${new Date().toISOString()}\n */\n\nimport type { Migration } from '@happyvertical/smrt-core';\n\nexport default {\n  id: '${id}',\n  description: '${description.replace(/'/g, \"\\\\'\")}',\n  version: '1.0.0',\n\n  up: async (db) => {\n${upStatementsStr}\n  },\n\n  down: async (db) => {\n${downStatementsStr}\n  },\n} satisfies Migration;\n`;\n  }\n\n  /**\n   * Generate CREATE TABLE SQL from schema definition\n   */\n  private generateCreateTable(schema: SchemaDefinition): string {\n    if (Object.keys(schema.columns).length === 0 && schema.ddl?.trim()) {\n      // Structured materialization cannot preserve constraints or vendor SQL\n      // when an older/custom manifest exposes only executable DDL. Retain the\n      // only valid representation even when materialization was requested.\n      return materializeManifestDDLForEngine(schema.ddl, this.engine);\n    }\n\n    if (!this.materializeStructuredSchema && schema.ddl?.trim()) {\n      // Deprecated opt-out (#2358): the cached string is engine-neutral and\n      // index-less; only bare PostgreSQL TIMESTAMP is rewritten.\n      return materializeManifestDDLForEngine(schema.ddl, this.engine);\n    }\n\n    // The manifest's pre-generated `ddl` is deliberately engine-neutral and\n    // may contain abstract TIMESTAMP/JSON/UUID types. Materialize the\n    // structured columns through the selected engine strategy; executing the\n    // cached string on PostgreSQL would otherwise bypass TIMESTAMPTZ and lose\n    // JavaScript Date offsets (#2069). This matches the migration orchestrator\n    // and also prevents JSON/REAL/UUID drift after a create.\n    if (schema.ddl?.trim()) {\n      // Table-level constraints that live only in a hand-authored cached\n      // string cannot be represented structurally and are dropped — as\n      // `db:migrate` already drops them. Say so instead of losing them\n      // silently (#2358).\n      const constraints = cachedDdlTableConstraints(schema.ddl);\n      if (constraints.length > 0) {\n        logger.warn(\n          `[MigrationGenerator] cached ddl for table \"${schema.tableName}\" declares ` +\n            `${constraints.length} table constraint(s) that structured columns cannot ` +\n            `carry (${constraints.join('; ')}); the structured schema is authoritative ` +\n            `and they are not rendered (#2358).`,\n        );\n      }\n    }\n    return getDDLStrategy(this.engine).generateCreateTable(schema);\n  }\n\n  /**\n   * Generate the CREATE INDEX statements for a new table through the engine\n   * strategy (partial `WHERE`, JSON-path targets, inline-UNIQUE engines).\n   */\n  private generateTableIndexes(schema: SchemaDefinition): string[] {\n    return getDDLStrategy(this.engine).generateIndexes(schema);\n  }\n\n  /**\n   * Generate the CREATE TRIGGER statements for a new table (engines without\n   * trigger support return none).\n   */\n  private generateTableTriggers(schema: SchemaDefinition): string[] {\n    return getDDLStrategy(this.engine).generateTriggers(schema);\n  }\n\n  /**\n   * Generate DROP TABLE SQL\n   */\n  private generateDropTable(tableName: string): string {\n    return `DROP TABLE IF EXISTS ${this.quoteIdentifier(tableName)}`;\n  }\n\n  /**\n   * Generate SQL for a schema change\n   */\n  private generateChangeSQL(change: SchemaChange): {\n    up: string[];\n    down: string[];\n  } {\n    const up: string[] = [];\n    const down: string[] = [];\n    const sqlStatements =\n      change.sqlStatements ?? (change.sql ? [change.sql] : []);\n\n    switch (change.type) {\n      case 'add_column':\n        if (sqlStatements.length > 0) {\n          up.push(...sqlStatements);\n        } else if (change.column && change.name) {\n          up.push(\n            this.generateAddColumn(change.table, change.name, change.column),\n          );\n        }\n        if (change.name) {\n          down.push(this.generateDropColumn(change.table, change.name));\n        }\n        break;\n\n      case 'drop_column':\n        if (sqlStatements.length > 0) {\n          up.push(...sqlStatements);\n        } else if (change.name) {\n          up.push(this.generateDropColumn(change.table, change.name));\n        }\n        // No automatic DOWN for drops\n        break;\n\n      case 'add_index':\n        if (sqlStatements.length > 0) {\n          up.push(...sqlStatements);\n        } else if (change.index) {\n          up.push(this.generateAddIndex(change.table, change.index));\n        }\n        if (change.name) {\n          down.push(this.generateDropIndex(change.name));\n        }\n        break;\n\n      case 'drop_index':\n        if (change.name) {\n          up.push(this.generateDropIndex(change.name));\n        }\n        // No automatic DOWN for index drops\n        break;\n\n      case 'type_upgrade':\n        // Type upgrades are safe conversions that SMRT can handle automatically\n        // The SQL is generated by the differ based on engine-specific requirements\n        if (sqlStatements.length > 0) {\n          for (const sql of sqlStatements) {\n            // Skip comment-only SQL (indicates a no-op migration)\n            if (!sql.startsWith('--')) {\n              up.push(sql);\n            }\n          }\n        }\n        // No automatic DOWN for type changes - could lose data\n        break;\n\n      case 'type_mismatch':\n        // Type mismatches require manual intervention\n        up.push(`-- WARNING: Type mismatch for ${change.table}.${change.name}`);\n        up.push(\n          `-- Expected: ${change.mismatch?.expected}, Actual: ${change.mismatch?.actual}`,\n        );\n        up.push(`-- Manual migration required`);\n        break;\n\n      case 'alter_column':\n        // Nullability/default repairs (#2369). Executable statements come\n        // from the differ (backfill + ALTER COLUMN); comment-only SQL marks\n        // an in-place limitation (SQLite) and is surfaced as a note. Report-\n        // only advisories (relaxations not opted into) are not emitted.\n        if (change.advisory && sqlStatements.length === 0) {\n          break;\n        }\n        for (const sql of sqlStatements) {\n          up.push(sql);\n        }\n        // No automatic DOWN: the previous nullability/default is not\n        // captured with enough fidelity to restore it safely.\n        break;\n\n      case 'orphan_column':\n      case 'orphan_index':\n        // Report-only: surface the advisory as comments so a generated\n        // migration file documents the drift without acting on it.\n        up.push(\n          `-- ${change.advisory?.severity === 'warning' ? 'WARNING' : 'NOTE'}: ${change.type === 'orphan_column' ? 'Orphan column' : 'Orphan unique constraint'} ${change.table}.${change.name} (${change.mismatch?.actual ?? 'unknown shape'})`,\n        );\n        if (change.advisory?.message) {\n          up.push(`-- ${change.advisory.message}`);\n        }\n        for (const suggestion of change.advisory?.suggestedSql ?? []) {\n          up.push(`-- suggested: ${suggestion}`);\n        }\n        break;\n\n      default:\n        // Unknown change type\n        break;\n    }\n\n    return { up, down };\n  }\n\n  /**\n   * Generate ADD COLUMN SQL\n   */\n  private generateAddColumn(\n    tableName: string,\n    colName: string,\n    colDef: import('../schema/types.js').ColumnDefinition,\n  ): string {\n    const parts: string[] = [this.quoteIdentifier(colName), colDef.type];\n\n    if (colDef.notNull) {\n      parts.push('NOT NULL');\n    }\n    if (colDef.unique) {\n      parts.push('UNIQUE');\n    }\n    if (colDef.defaultValue !== undefined) {\n      parts.push(`DEFAULT ${this.formatDefaultValue(colDef.defaultValue)}`);\n    }\n\n    return `ALTER TABLE ${this.quoteIdentifier(tableName)} ADD COLUMN ${parts.join(' ')}`;\n  }\n\n  /**\n   * Generate DROP COLUMN SQL\n   */\n  private generateDropColumn(tableName: string, colName: string): string {\n    return `ALTER TABLE ${this.quoteIdentifier(tableName)} DROP COLUMN ${this.quoteIdentifier(colName)}`;\n  }\n\n  /**\n   * Generate ADD INDEX SQL\n   */\n  private generateAddIndex(\n    tableName: string,\n    index: import('../schema/types.js').IndexDefinition,\n  ): string {\n    const uniqueStr = index.unique ? 'UNIQUE ' : '';\n    const target = renderIndexTarget(index, this.engine);\n    // Partial-index predicate. DuckDB (and the JSON adapter backed by it)\n    // rejects partial indexes, so the declaration degrades to a full index\n    // there — matching the differ and the DuckDB DDL strategy.\n    const whereClause =\n      this.engine !== 'duckdb' && index.where ? ` WHERE ${index.where}` : '';\n\n    if (this.engine === 'postgres') {\n      // PostgreSQL: use CONCURRENTLY for production safety\n      return `CREATE ${uniqueStr}INDEX CONCURRENTLY IF NOT EXISTS ${this.quoteIdentifier(index.name)} ON ${this.quoteIdentifier(tableName)} (${target})${whereClause}`;\n    }\n\n    return `CREATE ${uniqueStr}INDEX IF NOT EXISTS ${this.quoteIdentifier(index.name)} ON ${this.quoteIdentifier(tableName)} (${target})${whereClause}`;\n  }\n\n  /**\n   * Generate DROP INDEX SQL\n   */\n  private generateDropIndex(indexName: string): string {\n    if (this.engine === 'postgres') {\n      return `DROP INDEX CONCURRENTLY IF EXISTS ${this.quoteIdentifier(indexName)}`;\n    }\n    return `DROP INDEX IF EXISTS ${this.quoteIdentifier(indexName)}`;\n  }\n\n  /**\n   * Quote a SQL identifier\n   */\n  private quoteIdentifier(name: string): string {\n    return `\"${name.replace(/\"/g, '\"\"')}\"`;\n  }\n\n  /**\n   * Format a default value for SQL\n   */\n  private formatDefaultValue(value: unknown): string {\n    if (value === null) return 'NULL';\n    if (typeof value === 'string') return `'${value.replace(/'/g, \"''\")}'`;\n    if (typeof value === 'boolean') return value ? '1' : '0';\n    if (typeof value === 'number') return String(value);\n    return String(value);\n  }\n\n  /**\n   * Terminate a statement with exactly one `;` for the SQL file format.\n   *\n   * Strategy-rendered statements (`generateCreateTable`, `generateIndexes`,\n   * `generateTriggers`) already end with `;`, while differ-produced ALTERs do\n   * not — appending unconditionally wrote `;;` (#2406 review).\n   */\n  private terminateStatement(stmt: string): string {\n    return stmt.trimEnd().endsWith(';') ? stmt : `${stmt};`;\n  }\n\n  /**\n   * Escape template literal content\n   */\n  private escapeTemplate(str: string): string {\n    return str.replace(/`/g, '\\\\`').replace(/\\$/g, '\\\\$');\n  }\n}\n\n/**\n * Generate a migration definition from UP and DOWN statements\n */\nexport function createMigrationDefinition(\n  id: string,\n  upStatements: string[],\n  downStatements: string[] = [],\n  options: {\n    description?: string;\n    version?: string;\n    packageName?: string;\n    sourceFile?: string;\n  } = {},\n): MigrationDefinition {\n  return {\n    id,\n    description: options.description || `Migration: ${id}`,\n    version: options.version || '1.0.0',\n    up: upStatements,\n    down: downStatements,\n    package_name: options.packageName,\n    source_file: options.sourceFile,\n  };\n}\n\n/**\n * Generate a sequence number for a new migration\n */\nexport function generateMigrationSequence(existingIds: string[]): string {\n  const sequences = existingIds\n    .map((id) => {\n      const match = id.match(/^(\\d+)_/);\n      return match ? parseInt(match[1], 10) : 0;\n    })\n    .filter((n) => !Number.isNaN(n));\n\n  const maxSequence = sequences.length > 0 ? Math.max(...sequences) : 0;\n  return String(maxSequence + 1).padStart(4, '0');\n}\n\n/**\n * Generate a timestamp-based migration ID\n */\nexport function generateMigrationTimestamp(): string {\n  const now = new Date();\n  return [\n    now.getFullYear(),\n    String(now.getMonth() + 1).padStart(2, '0'),\n    String(now.getDate()).padStart(2, '0'),\n    String(now.getHours()).padStart(2, '0'),\n    String(now.getMinutes()).padStart(2, '0'),\n    String(now.getSeconds()).padStart(2, '0'),\n  ].join('');\n}\n"],"mappings":"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"}

package/dist/migrations/index.d.ts

@@ -11,10 +11,12 @@
 export { type BackfillRecord, BackfillTableUnavailableError, BackfillTracker, type BackfillTrackerOptions, } from './backfill-tracker.js';
 export { computeChecksum, normalizeSQL, shortChecksum, verifyChecksum, } from './checksum.js';
 export type { DiffOptions } from './differ.js';
-export { generateSchemaDiff, getSQLFromDiff, hasActionableChanges, SchemaComparer, } from './differ.js';
+export { canonicalizeDefault, generateSchemaDiff, getSQLFromDiff, hasActionableChanges, isAdvisoryOnlyChange, isInfoOnlyChange, isManualOrAdvisoryChange, SchemaComparer, uniqueColumnIndexName, } from './differ.js';
 export type { GeneratedMigration, GenerateMigrationOptions, } from './generator.js';
 export { createMigrationDefinition, generateMigrationSequence, generateMigrationTimestamp, MigrationGenerator, } from './generator.js';
+export { buildMinorUnitsStatements, type MinorUnitsColumnReport, type MinorUnitsColumnState, type MinorUnitsOptions, MinorUnitsPreflightError, type MinorUnitsPreflightResult, type MinorUnitsProblemRow, type MinorUnitsRescaleOptions, type MinorUnitsRescaleResult, type MoneyColumnTarget, preflightMinorUnitsRescale, rescaleMoneyColumnsToMinorUnits, } from './minor-units.js';
 export { getPendingSchemaStatements, type MigrateSmrtSchemasOptions, type MigrateSmrtSchemasResult, migrateSmrtSchemas, type PendingSchemaStatementsResult, } from './orchestrate.js';
-export { MigrationTracker, planPostgresStatements } from './tracker.js';
+export { type BuildSqliteRebuildStatementsInput, buildSqliteRebuildStatements, isSqliteRebuildPlaceholder, type PlanSqliteTableRebuildsOptions, planSqliteTableRebuilds, rewriteSqliteCreateTable, SQLITE_REBUILD_TABLE_PREFIX, type SqliteTableRebuildPlan, sqliteRebuildPlaceholderSql, } from './sqlite-rebuild.js';
+export { buildConcurrentIndexPlan, extractCreatedIndexName, MigrationTracker, parsePostgresTimeoutMs, planPostgresStatements, } from './tracker.js';
 export type { ApplyMigrationsOptions, ColumnDefinitionWithName, ColumnInfo, DatabaseEngine, DatabaseInterface, DataMigration, DataMigrationResult, DataMigrationStatement, DriftReport, ForeignKeyInfo, IndexDefinition, IndexInfo, MigrationDefinition, MigrationMode, MigrationResult, MigrationStatus, MigrationsConfig, MigrationTrackerOptions, ParsedMigrationFile, ParseMigrationOptions, RollbackOptions, SchemaChange, SchemaDiff, SchemaMigrationRecord, StiDiscriminatorMigration, TableSchemaInfo, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,KAAK,cAAc,EACnB,6BAA6B,EAC7B,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,0BAA0B,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,KAAK,6BAA6B,GACnC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGxE,YAAY,EACV,sBAAsB,EACtB,wBAAwB,EACxB,UAAU,EACV,cAAc,EACd,iBAAiB,EAEjB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,eAAe,EACf,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,eAAe,EAEf,eAAe,EACf,gBAAgB,EAEhB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,yBAAyB,EACzB,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,KAAK,cAAc,EACnB,6BAA6B,EAC7B,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,0BAA0B,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,KAAK,6BAA6B,GACnC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,KAAK,iCAAiC,EACtC,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,8BAA8B,EACnC,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,sBAAsB,EAC3B,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,sBAAsB,EACtB,wBAAwB,EACxB,UAAU,EACV,cAAc,EACd,iBAAiB,EAEjB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,eAAe,EACf,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,eAAe,EAEf,eAAe,EACf,gBAAgB,EAEhB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,yBAAyB,EACzB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/migrations/index.js

@@ -1,7 +1,10 @@
-import { SchemaComparer, generateSchemaDiff, getSQLFromDiff, hasActionableChanges } from "./differ.js";
+import { parsePostgresTimeoutMs } from "../postgres-timeouts.js";
+import { SQLITE_REBUILD_TABLE_PREFIX, buildSqliteRebuildStatements, isSqliteRebuildPlaceholder, planSqliteTableRebuilds, rewriteSqliteCreateTable, sqliteRebuildPlaceholderSql } from "./sqlite-rebuild.js";
+import { SchemaComparer, canonicalizeDefault, generateSchemaDiff, getSQLFromDiff, hasActionableChanges, isAdvisoryOnlyChange, isInfoOnlyChange, isManualOrAdvisoryChange, uniqueColumnIndexName } from "./differ.js";
 import { BackfillTableUnavailableError, BackfillTracker } from "./backfill-tracker.js";
 import { computeChecksum, normalizeSQL, shortChecksum, verifyChecksum } from "./checksum.js";
 import { MigrationGenerator, createMigrationDefinition, generateMigrationSequence, generateMigrationTimestamp } from "./generator.js";
-import { MigrationTracker, planPostgresStatements } from "./tracker.js";
+import { MinorUnitsPreflightError, buildMinorUnitsStatements, preflightMinorUnitsRescale, rescaleMoneyColumnsToMinorUnits } from "./minor-units.js";
+import { MigrationTracker, buildConcurrentIndexPlan, extractCreatedIndexName, planPostgresStatements } from "./tracker.js";
 import { getPendingSchemaStatements, migrateSmrtSchemas } from "./orchestrate.js";
-export { BackfillTableUnavailableError, BackfillTracker, MigrationGenerator, MigrationTracker, SchemaComparer, computeChecksum, createMigrationDefinition, generateMigrationSequence, generateMigrationTimestamp, generateSchemaDiff, getPendingSchemaStatements, getSQLFromDiff, hasActionableChanges, migrateSmrtSchemas, normalizeSQL, planPostgresStatements, shortChecksum, verifyChecksum };
+export { BackfillTableUnavailableError, BackfillTracker, MigrationGenerator, MigrationTracker, MinorUnitsPreflightError, SQLITE_REBUILD_TABLE_PREFIX, SchemaComparer, buildConcurrentIndexPlan, buildMinorUnitsStatements, buildSqliteRebuildStatements, canonicalizeDefault, computeChecksum, createMigrationDefinition, extractCreatedIndexName, generateMigrationSequence, generateMigrationTimestamp, generateSchemaDiff, getPendingSchemaStatements, getSQLFromDiff, hasActionableChanges, isAdvisoryOnlyChange, isInfoOnlyChange, isManualOrAdvisoryChange, isSqliteRebuildPlaceholder, migrateSmrtSchemas, normalizeSQL, parsePostgresTimeoutMs, planPostgresStatements, planSqliteTableRebuilds, preflightMinorUnitsRescale, rescaleMoneyColumnsToMinorUnits, rewriteSqliteCreateTable, shortChecksum, sqliteRebuildPlaceholderSql, uniqueColumnIndexName, verifyChecksum };

package/dist/migrations/minor-units.d.ts

@@ -0,0 +1,162 @@
+import { DatabaseInterface } from './types.js';
+/** A table and the money columns on it that must move to minor units. */
+export interface MoneyColumnTarget {
+    /** Physical table name, e.g. `payments`. */
+    table: string;
+    /** Physical column names, e.g. `['amount', 'native_amount']`. */
+    columns: string[];
+}
+/** What the preflight found about one column. */
+export type MinorUnitsColumnState = 
+/** Floating-point today: needs converting. */
+'pending'
+/** Already an integer column: nothing to do. */
+ | 'converted'
+/** Table or column absent (package not installed, older schema). */
+ | 'missing';
+/** One row that cannot be converted without losing information. */
+export interface MinorUnitsProblemRow {
+    /** Primary key, when the table has an `id` column. */
+    id: string | null;
+    /** The stored major-unit value. */
+    value: number;
+    /** `value * scale`, before rounding. */
+    scaled: number;
+}
+/** Preflight findings for a single column. */
+export interface MinorUnitsColumnReport {
+    table: string;
+    column: string;
+    state: MinorUnitsColumnState;
+    /** Declared column type as the database reports it, when resolvable. */
+    declaredType: string | null;
+    /** Non-null values inspected. `0` unless `state` is `pending`. */
+    inspectedRows: number;
+    /** Values whose scaled form is not a whole number — rounding loses money. */
+    nonIntegral: MinorUnitsProblemRow[];
+    /** Values whose scaled form falls outside PostgreSQL `int4`. */
+    overflow: MinorUnitsProblemRow[];
+}
+/** Result of {@link preflightMinorUnitsRescale}. */
+export interface MinorUnitsPreflightResult {
+    engine: string;
+    scale: number;
+    columns: MinorUnitsColumnReport[];
+    /** Columns still holding floating-point major units. */
+    pendingColumns: number;
+    /** Columns already integer. */
+    convertedColumns: number;
+    /** Columns whose table/column does not exist. */
+    missingColumns: number;
+    /** Total rows that would be rounded. */
+    nonIntegralRows: number;
+    /** Total rows that would overflow `int4`. */
+    overflowRows: number;
+    /** No row would lose information. */
+    ok: boolean;
+    /** Human-readable report, suitable for pasting into a migration log or PR. */
+    summary: string;
+}
+/** Options shared by the preflight and the rescale. */
+export interface MinorUnitsOptions {
+    /** Minor units per major unit. Default `100` (cents). */
+    scale?: number;
+    /** Engine hint for adapters whose URL does not identify the engine. */
+    engineHint?: string;
+    /** Problem rows recorded per column before truncating. Default `20`. */
+    maxProblemRows?: number;
+}
+/** Options for {@link rescaleMoneyColumnsToMinorUnits}. */
+export interface MinorUnitsRescaleOptions extends MinorUnitsOptions {
+    /**
+     * Stable marker name recorded in `_smrt_backfills`, e.g.
+     * `@happyvertical/smrt-commerce:money-minor-units:v1`.
+     *
+     * This is what makes the migration idempotent on SQLite, where the rescale
+     * is an `UPDATE` no column type can distinguish from an unconverted table.
+     */
+    backfillName: string;
+    /** Package recorded alongside the marker. */
+    packageName?: string;
+    /**
+     * Convert even when the preflight found rows that would be rounded or
+     * overflow. Off by default: silently rounding a half-cent away is exactly
+     * the failure this migration exists to prevent.
+     */
+    force?: boolean;
+}
+/** Result of {@link rescaleMoneyColumnsToMinorUnits}. */
+export interface MinorUnitsRescaleResult {
+    /** `false` when the backfill marker was already present. */
+    ran: boolean;
+    engine: string;
+    scale: number;
+    /** The preflight that gated the run. */
+    preflight: MinorUnitsPreflightResult;
+    /** Columns whose values were rescaled. */
+    rescaledColumns: Array<{
+        table: string;
+        column: string;
+    }>;
+    /** Statements executed, in order — useful for logs and tests. */
+    statements: string[];
+    /**
+     * Columns whose values are now minor units but whose *declared* type is
+     * still floating-point. Only ever populated on SQLite, which cannot alter a
+     * column type in place; clearing it needs the table-rebuild path (#2370).
+     */
+    declaredTypeChangePending: Array<{
+        table: string;
+        column: string;
+    }>;
+}
+/**
+ * A money-losing preflight finding blocked the conversion.
+ *
+ * Carries the full preflight so a caller can print the summary, fix the data,
+ * and retry rather than re-deriving what went wrong.
+ */
+export declare class MinorUnitsPreflightError extends Error {
+    readonly preflight: MinorUnitsPreflightResult;
+    constructor(preflight: MinorUnitsPreflightResult);
+}
+/**
+ * The statements that convert one column, for one engine.
+ *
+ * Exported so the emitted DDL can be asserted without a live PostgreSQL or
+ * DuckDB connection; each owning package's `test:postgres` lane then proves the
+ * same SQL runs against a real server.
+ *
+ * @param engine - `postgres`, `duckdb`, or anything SQLite-shaped.
+ * @param table - Physical table name.
+ * @param column - Physical column name.
+ * @param scale - Minor units per major unit.
+ * @returns Statements in execution order.
+ */
+export declare function buildMinorUnitsStatements(engine: string, table: string, column: string, scale: number): string[];
+/**
+ * Report what {@link rescaleMoneyColumnsToMinorUnits} would do, without
+ * writing anything.
+ *
+ * @param db - Root database handle.
+ * @param targets - Tables and money columns owned by the calling package.
+ * @param options - Scale, engine hint, problem-row cap.
+ * @returns Per-column state plus the rows that would lose information.
+ */
+export declare function preflightMinorUnitsRescale(db: DatabaseInterface, targets: MoneyColumnTarget[], options?: MinorUnitsOptions): Promise<MinorUnitsPreflightResult>;
+/**
+ * Convert floating-point major-unit money columns to integer minor units.
+ *
+ * Idempotent: the run is wrapped in a {@link BackfillTracker} marker, so a
+ * second call is a no-op even on SQLite where the column type cannot record
+ * that the conversion already happened.
+ *
+ * @param db - Root database handle (must support `query`).
+ * @param targets - Tables and money columns owned by the calling package.
+ * @param options - Marker name, scale, and whether to convert despite
+ *   information-losing rows.
+ * @throws {MinorUnitsPreflightError} when the preflight found rows that would
+ *   be rounded or overflow and `force` was not set.
+ */
+export declare function rescaleMoneyColumnsToMinorUnits(db: DatabaseInterface, targets: MoneyColumnTarget[], options: MinorUnitsRescaleOptions): Promise<MinorUnitsRescaleResult>;
+//# sourceMappingURL=minor-units.d.ts.map

package/dist/migrations/minor-units.d.ts.map

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