@happyvertical/smrt-core 0.47.1 → 0.48.0

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

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

package/dist/migrations/generator.js

@@ -230,7 +230,8 @@ ${downStatementsStr}
 				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"})`);
+			case "rename_data_pending":
+				up.push(`-- ${change.advisory?.severity === "warning" ? "WARNING" : "NOTE"}: ${change.type === "orphan_column" ? "Orphan column" : change.type === "orphan_index" ? "Orphan unique constraint" : "Rename data pending"} ${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;

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 { createLogger } from '@happyvertical/logger';\nimport { getDDLStrategy } from '../schema/ddl/index.js';\nimport { materializeManifestDDLForEngine } from '../schema/ddl/materialize-manifest.js';\nimport {\n  planForeignKeyCreation,\n  renderDeferredForeignKeyDrop,\n} from '../schema/foreign-key-planner.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    const addedTableDownStatements: 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    const tablePlan = planForeignKeyCreation(diff.added_tables, this.engine);\n    for (const schema of tablePlan.schemas) {\n      upStatements.push(this.generateCreateTable(schema));\n      upStatements.push(...this.generateTableIndexes(schema));\n      upStatements.push(...this.generateTableTriggers(schema));\n    }\n    upStatements.push(...tablePlan.deferredStatements);\n    if (this.includeDown || options.includeDown) {\n      if (this.engine === 'sqlite' && tablePlan.cyclicTables.length > 0) {\n        // SQLite cannot drop either side of a populated mutual FK cycle with\n        // immediate checks. Defer checks until the transaction commits, after\n        // every member has been removed.\n        addedTableDownStatements.push('PRAGMA defer_foreign_keys = ON');\n      }\n      // PostgreSQL mutual cycles are made acyclic first; every table can then\n      // be dropped in the exact reverse of the parent-first creation order.\n      addedTableDownStatements.push(\n        ...[...tablePlan.deferredConstraints]\n          .reverse()\n          .map(({ table, foreignKey }) =>\n            renderDeferredForeignKeyDrop(table, foreignKey),\n          ),\n      );\n      addedTableDownStatements.push(\n        ...[...tablePlan.schemas]\n          .reverse()\n          .map((schema) => 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    // Changes are applied after table creation, so undo them before removing\n    // the new tables they may reference. The table block is itself already\n    // ordered as deferred-constraint drops followed by child-first drops.\n    downStatements.push(...addedTableDownStatements);\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 'add_foreign_key':\n        if (sqlStatements.length > 0) {\n          up.push(...sqlStatements);\n        } else if (change.advisory) {\n          up.push(\n            `-- ${change.advisory.severity === 'warning' ? 'WARNING' : 'NOTE'}: Foreign-key constraint ${change.table}.${change.name ?? 'unknown'}`,\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        }\n        // Constraint rollback is intentionally manual: names on older live\n        // databases may not match the deterministic current generator name.\n        break;\n\n      case 'drop_foreign_key':\n        if (sqlStatements.length > 0) {\n          up.push(...sqlStatements);\n        } else if (change.advisory) {\n          up.push(\n            `-- ${change.advisory.severity === 'warning' ? 'WARNING' : 'NOTE'}: Foreign-key constraint ${change.table}.${change.name ?? 'unknown'}`,\n          );\n          up.push(`-- ${change.advisory.message}`);\n        }\n        // Re-adding a removed constraint requires a fresh orphan check and is\n        // therefore intentionally not generated as an automatic rollback.\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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"}
+{"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 {\n  planForeignKeyCreation,\n  renderDeferredForeignKeyDrop,\n} from '../schema/foreign-key-planner.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    const addedTableDownStatements: 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    const tablePlan = planForeignKeyCreation(diff.added_tables, this.engine);\n    for (const schema of tablePlan.schemas) {\n      upStatements.push(this.generateCreateTable(schema));\n      upStatements.push(...this.generateTableIndexes(schema));\n      upStatements.push(...this.generateTableTriggers(schema));\n    }\n    upStatements.push(...tablePlan.deferredStatements);\n    if (this.includeDown || options.includeDown) {\n      if (this.engine === 'sqlite' && tablePlan.cyclicTables.length > 0) {\n        // SQLite cannot drop either side of a populated mutual FK cycle with\n        // immediate checks. Defer checks until the transaction commits, after\n        // every member has been removed.\n        addedTableDownStatements.push('PRAGMA defer_foreign_keys = ON');\n      }\n      // PostgreSQL mutual cycles are made acyclic first; every table can then\n      // be dropped in the exact reverse of the parent-first creation order.\n      addedTableDownStatements.push(\n        ...[...tablePlan.deferredConstraints]\n          .reverse()\n          .map(({ table, foreignKey }) =>\n            renderDeferredForeignKeyDrop(table, foreignKey),\n          ),\n      );\n      addedTableDownStatements.push(\n        ...[...tablePlan.schemas]\n          .reverse()\n          .map((schema) => 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    // Changes are applied after table creation, so undo them before removing\n    // the new tables they may reference. The table block is itself already\n    // ordered as deferred-constraint drops followed by child-first drops.\n    downStatements.push(...addedTableDownStatements);\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 'add_foreign_key':\n        if (sqlStatements.length > 0) {\n          up.push(...sqlStatements);\n        } else if (change.advisory) {\n          up.push(\n            `-- ${change.advisory.severity === 'warning' ? 'WARNING' : 'NOTE'}: Foreign-key constraint ${change.table}.${change.name ?? 'unknown'}`,\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        }\n        // Constraint rollback is intentionally manual: names on older live\n        // databases may not match the deterministic current generator name.\n        break;\n\n      case 'drop_foreign_key':\n        if (sqlStatements.length > 0) {\n          up.push(...sqlStatements);\n        } else if (change.advisory) {\n          up.push(\n            `-- ${change.advisory.severity === 'warning' ? 'WARNING' : 'NOTE'}: Foreign-key constraint ${change.table}.${change.name ?? 'unknown'}`,\n          );\n          up.push(`-- ${change.advisory.message}`);\n        }\n        // Re-adding a removed constraint requires a fresh orphan check and is\n        // therefore intentionally not generated as an automatic rollback.\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      case 'rename_data_pending':\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'}: ${\n            change.type === 'orphan_column'\n              ? 'Orphan column'\n              : change.type === 'orphan_index'\n                ? 'Orphan unique constraint'\n                : 'Rename data pending'\n          } ${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/prebuild/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prebuild/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAQ5D,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACvC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAkCf;AA2ZD;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAkBf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prebuild/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAW5D,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACvC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAkCf;AA4aD;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/prebuild/index.js

@@ -1,4 +1,4 @@
-import { selectWebCollectionEntries } from "../vite-plugin/web-collections.js";
+import { compareText, selectWebCollectionEntries } from "../vite-plugin/web-collections.js";
 import { renderApiClientCrudType, renderApiClientCustomMethodParameters, selectApiClientEntries } from "../vite-plugin/api-client-entries.js";
 import * as fs from "node:fs";
 import * as path from "node:path";
@@ -25,7 +25,8 @@ async function generateDeclarations(options) {
 */
 async function generateObjectTypeDeclarations(manifest, outDir) {
 	const interfaces = [];
-	for (const [_objectName, objectMeta] of Object.entries(manifest.objects)) {
+	const sortedObjectEntries = Object.entries(manifest.objects).sort(([leftKey, left], [rightKey, right]) => compareText(left.qualifiedName || leftKey, right.qualifiedName || rightKey) || compareText(leftKey, rightKey));
+	for (const [_objectName, objectMeta] of sortedObjectEntries) {
 		const fields = objectMeta.fields || {};
 		const propertyLines = [];
 		propertyLines.push("  id?: string;");
@@ -191,7 +192,7 @@ declare module '@smrt/mcp' {
  * Auto-generated types module declaration
  */
 declare module '@smrt/types' {
-${Object.values(manifest.objects).map((obj) => `  export type ${obj.className}Data = import('./smrt-objects').${obj.className}Data;`).join("\n")}
+${Object.entries(manifest.objects).sort(([leftKey, left], [rightKey, right]) => compareText(left.qualifiedName || leftKey, right.qualifiedName || rightKey) || compareText(leftKey, rightKey)).map(([, obj]) => `  export type ${obj.className}Data = import('./smrt-objects').${obj.className}Data;`).join("\n")}
 
   export interface Request {
     params: Record<string, string>;

package/dist/prebuild/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/prebuild/index.ts"],"sourcesContent":["/**\n * Pre-build utilities for generating TypeScript declarations\n * Solves virtual module resolution by creating physical .d.ts files\n */\n\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport type { SmartObjectManifest } from '../scanner/types';\nimport {\n  renderApiClientCrudType,\n  renderApiClientCustomMethodParameters,\n  selectApiClientEntries,\n} from '../vite-plugin/api-client-entries.js';\nimport { selectWebCollectionEntries } from '../vite-plugin/web-collections.js';\n\nexport interface PrebuildOptions {\n  /** Path to manifest file or manifest object */\n  manifest: string | SmartObjectManifest;\n  /** Output directory for generated types */\n  outDir: string;\n  /** Include virtual module declarations */\n  includeVirtualModules?: boolean;\n  /** Include object type definitions */\n  includeObjectTypes?: boolean;\n  /** Project root path for resolving relative paths */\n  projectRoot?: string;\n}\n\n/**\n * Generate TypeScript declaration files from SMRT manifest\n */\nexport async function generateDeclarations(\n  options: PrebuildOptions,\n): Promise<void> {\n  const {\n    manifest: manifestInput,\n    outDir,\n    includeVirtualModules = true,\n    includeObjectTypes = true,\n    projectRoot = process.cwd(),\n  } = options;\n\n  // Load manifest\n  const manifest: SmartObjectManifest =\n    typeof manifestInput === 'string'\n      ? JSON.parse(fs.readFileSync(manifestInput, 'utf-8'))\n      : manifestInput;\n\n  // Ensure output directory exists\n  const fullOutDir = path.isAbsolute(outDir)\n    ? outDir\n    : path.join(projectRoot, outDir);\n  fs.mkdirSync(fullOutDir, { recursive: true });\n\n  console.log(`[smrt:prebuild] Generating declarations to ${fullOutDir}`);\n\n  if (includeObjectTypes) {\n    await generateObjectTypeDeclarations(manifest, fullOutDir);\n  }\n\n  if (includeVirtualModules) {\n    await generateVirtualModuleDeclarations(manifest, fullOutDir);\n  }\n\n  console.log(\n    `[smrt:prebuild] Generated declarations for ${Object.keys(manifest.objects).length} SMRT objects`,\n  );\n}\n\n/**\n * Generate TypeScript interfaces for SMRT objects\n */\nasync function generateObjectTypeDeclarations(\n  manifest: SmartObjectManifest,\n  outDir: string,\n): Promise<void> {\n  const interfaces: string[] = [];\n\n  // Generate interfaces for each discovered SMRT object\n  for (const [_objectName, objectMeta] of Object.entries(manifest.objects)) {\n    const fields = objectMeta.fields || {};\n    const propertyLines: string[] = [];\n\n    // Add standard SmrtObject properties\n    propertyLines.push('  id?: string;');\n    propertyLines.push('  created_at?: string;');\n    propertyLines.push('  updated_at?: string;');\n\n    // Add object-specific properties\n    for (const [fieldName, fieldDef] of Object.entries(fields)) {\n      const type = mapFieldTypeToTypeScript(fieldDef.type);\n      const optional = !fieldDef.required ? '?' : '';\n      propertyLines.push(`  ${fieldName}${optional}: ${type};`);\n    }\n\n    const interfaceDef = `export interface ${objectMeta.className}Data {\n${propertyLines.join('\\n')}\n}`;\n    interfaces.push(interfaceDef);\n  }\n\n  // Write object types file\n  const objectTypesContent = `/**\n * Auto-generated TypeScript interfaces for SMRT objects\n * Generated at build time from @smrt() decorated classes\n *\n * DO NOT EDIT THIS FILE MANUALLY\n */\n\n${interfaces.join('\\n\\n')}\n`;\n\n  fs.writeFileSync(path.join(outDir, 'smrt-objects.d.ts'), objectTypesContent);\n}\n\n/**\n * Generate virtual module declarations\n */\nasync function generateVirtualModuleDeclarations(\n  manifest: SmartObjectManifest,\n  outDir: string,\n): Promise<void> {\n  // Generate manifest module declaration\n  const manifestDeclaration = `/**\n * Auto-generated manifest module declaration\n */\ndeclare module '@smrt/manifest' {\n  export interface SmrtObjectField {\n    type: string;\n    required?: boolean;\n    default?: any;\n  }\n\n  export interface SmrtObjectMethod {\n    name: string;\n    parameters: Array<{\n      name: string;\n      type: string;\n      optional?: boolean;\n      default?: any;\n    }>;\n    returnType: string;\n    async: boolean;\n    isStatic: boolean;\n    isPublic: boolean;\n  }\n\n  export interface SmrtObjectDefinition {\n    name: string;\n    className: string;\n    collection: string;\n    filePath: string;\n    fields: Record<string, SmrtObjectField>;\n    methods: Record<string, SmrtObjectMethod>;\n    decoratorConfig: any;\n    extends?: string;\n  }\n\n  export interface SmrtManifest {\n    version: string;\n    timestamp: number;\n    objects: Record<string, SmrtObjectDefinition>;\n  }\n\n  export const manifest: SmrtManifest;\n  export default manifest;\n}`;\n\n  // Generate client module declaration\n  const apiClientInterface = selectApiClientEntries(manifest)\n    .map(({ clientKey, dataInterfaceName, crudMethods, customMethods }) => {\n      const overriddenMethods = customMethods.map(({ name }) => name);\n      const crudType = renderApiClientCrudType(\n        dataInterfaceName,\n        crudMethods,\n        overriddenMethods,\n      );\n      const customSignatures = customMethods\n        .map(\n          (method) =>\n            `      ${method.name}(${renderApiClientCustomMethodParameters(\n              method,\n              mapFieldTypeToTypeScript,\n            )}): Promise<any>;`,\n        )\n        .join('\\n');\n\n      if (customSignatures) {\n        const intersection = crudType ? `${crudType} & ` : '';\n        return `    ${JSON.stringify(clientKey)}: ${intersection}{\\n${customSignatures}\\n    };`;\n      }\n\n      return `    ${JSON.stringify(clientKey)}: ${crudType ?? 'Record<string, never>'};`;\n    })\n    .join('\\n');\n\n  // Wire-shape policy (#1797): the server returns BARE JSON — a bare array for\n  // list/search, a bare object for get/create/update — with snake_case field\n  // names (created_at, updated_at). These physical declarations share client\n  // entry selection and method-signature rendering with the Vite declaration.\n  // Fetchers reject on non-2xx with a SmrtClientError (#1796).\n  const clientDeclaration = `/**\n * Auto-generated API client module declaration\n */\ndeclare module '@smrt/client' {\n  /** Structured custom-action failure nested under an API error body's \\`error\\` key. */\n  export interface SmrtClientFailure {\n    ok: false;\n    code: string;\n    message: string;\n    status?: number;\n  }\n\n  /** Shape of a JSON error body carried by a rejected request (SmrtClientError.body). */\n  export interface ApiError {\n    error?: string | SmrtClientFailure;\n    message?: string;\n  }\n\n  /** Typed error thrown by every fetcher on a non-2xx response (#1796). */\n  export interface SmrtClientError extends Error {\n    name: 'SmrtClientError';\n    status: number;\n    /** Machine-readable code from a structured custom-action failure, when present. */\n    code?: string;\n    body?: ApiError | string;\n  }\n\n  export interface CrudOperations<T = any> {\n    list(params?: Record<string, any>): Promise<T[]>;\n    get(id: string): Promise<T>;\n    create(data: Partial<T>): Promise<T>;\n    update(id: string, data: Partial<T>): Promise<T>;\n    delete(id: string): Promise<boolean>;\n    search(query: string): Promise<T[]>;\n  }\n\n  export interface ApiClient {\n${apiClientInterface}\n  }\n\n  export function createClient(basePath?: string): ApiClient;\n  export default createClient;\n}`;\n\n  // Generate routes module declaration\n  const routesDeclaration = `/**\n * Auto-generated routes module declaration\n */\ndeclare module '@smrt/routes' {\n  export interface RouteApp {\n    get(path: string, handler: (req: any, res: any) => void): void;\n    post(path: string, handler: (req: any, res: any) => void): void;\n    put(path: string, handler: (req: any, res: any) => void): void;\n    delete(path: string, handler: (req: any, res: any) => void): void;\n  }\n\n  export function setupRoutes(app: RouteApp): void;\n  export default setupRoutes;\n}`;\n\n  // Generate MCP module declaration\n  const mcpDeclaration = `/**\n * Auto-generated MCP module declaration\n */\ndeclare module '@smrt/mcp' {\n  export interface McpTool {\n    name: string;\n    description: string;\n    inputSchema: {\n      type: string;\n      properties: Record<string, any>;\n      required?: string[];\n    };\n  }\n\n  export const tools: McpTool[];\n  export function createMCPServer(): {\n    name: string;\n    version: string;\n    tools: McpTool[]\n  };\n  export default createMCPServer;\n}`;\n\n  // Generate types module declaration with object imports\n  const objectImports = Object.values(manifest.objects)\n    .map(\n      (obj) =>\n        `  export type ${obj.className}Data = import('./smrt-objects').${obj.className}Data;`,\n    )\n    .join('\\n');\n\n  const typesDeclaration = `/**\n * Auto-generated types module declaration\n */\ndeclare module '@smrt/types' {\n${objectImports}\n\n  export interface Request {\n    params: Record<string, string>;\n    query: Record<string, any>;\n    json(): Promise<any>;\n  }\n\n  export interface Response {\n    json(data: any, init?: { status?: number }): Response;\n    status(code: number): Response;\n  }\n}`;\n\n  // Generate web collection-definition module declaration (#1761). Selection\n  // shares selectWebCollectionEntries with the vite-plugin runtime module and\n  // its virt-web d.ts, so this `tsc`-only consumer declaration cannot drift\n  // from the emitted values.\n  const webCollectionEntries = selectWebCollectionEntries(manifest)\n    .map(\n      ({ collection, obj }) =>\n        `    ${JSON.stringify(collection)}: SmrtWebCollectionDefinition<import('./smrt-objects').${obj.className}Data>;`,\n    )\n    .join('\\n');\n\n  const webDeclaration = `/**\n * Auto-generated web collection-definition module declaration (#1761)\n */\ndeclare module '@smrt/web' {\n  export type SmrtWebFieldType =\n    | 'text'\n    | 'decimal'\n    | 'boolean'\n    | 'integer'\n    | 'datetime'\n    | 'json'\n    | 'foreignKey'\n    | 'crossPackageRef';\n\n  /** Static \\`@field({ ui })\\` hints (#2046) — the field-policy rail seed. */\n  export interface SmrtWebFieldUIHints {\n    basic?: boolean;\n    group?: string;\n    order?: number;\n    locked?: boolean;\n  }\n\n  export interface SmrtWebFieldDefinition {\n    type: SmrtWebFieldType;\n    required?: boolean;\n    nullable?: boolean;\n    default?: unknown;\n    /** Developer-authored \\`@field({ description })\\` (#2046) — end-user help seed. */\n    description?: string;\n    /** Static \\`@field({ ui })\\` hints (#2046). */\n    ui?: SmrtWebFieldUIHints;\n  }\n\n  export type SmrtWebRelationshipKind =\n    | 'foreignKey'\n    | 'crossPackageRef'\n    | 'oneToMany'\n    | 'manyToMany';\n\n  /**\n   * A manifest-derived edge to a sibling REST collection. Mutating this\n   * collection invalidates the caches of the collections named by these edges\n   * (#1761 relationship-derived invalidation).\n   */\n  export interface SmrtWebRelationship {\n    field: string;\n    kind: SmrtWebRelationshipKind;\n    relatedCollection: string;\n  }\n\n  export interface WebToolRouteDescriptor {\n    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';\n    scope: 'item' | 'collection';\n    path: string[];\n    parameterAliases?: Record<string, string>;\n    optionsBag?: boolean;\n  }\n\n  /** A WebMCP/MCP tool descriptor for one collection action (#1812). */\n  export interface WebToolDescriptor {\n    action: string;\n    name: string;\n    description: string;\n    inputSchema: Record<string, unknown>;\n    readOnly: boolean;\n    effect: 'read' | 'write' | 'destructive';\n    idempotent: boolean;\n    openWorld: boolean;\n    route?: WebToolRouteDescriptor;\n  }\n\n  /** Canonical data-only definition for one generated browser tool. */\n  export interface WebMcpToolDefinition extends WebToolDescriptor {\n    collection: string;\n    objectRef: string;\n    className: string;\n    endpoint: string;\n    idField: string;\n    idType: 'uuid' | 'text';\n    route: WebToolRouteDescriptor;\n    relationships: SmrtWebRelationship[];\n  }\n\n  export interface SmrtWebCollectionDefinition<TData = Record<string, unknown>> {\n    name: string;\n    /** Canonical qualified model identity (\\`@package/name:ClassName\\`) for policy APIs. */\n    objectRef: string;\n    className: string;\n    endpoint: string;\n    idField: string;\n    actions: string[];\n    fields: Record<string, SmrtWebFieldDefinition>;\n    /** Manifest-derived relationship edges to sibling REST collections. */\n    relationships: SmrtWebRelationship[];\n    /** WebMCP/MCP tool descriptors for the exposed actions (#1812). */\n    toolDescriptors: WebToolDescriptor[];\n    /** Phantom row-type carrier for inference — never present at runtime. */\n    _row?: TData;\n  }\n\n  export interface SmrtWebCollectionDefinitions {\n${webCollectionEntries}\n  }\n\n  export const collectionDefinitions: SmrtWebCollectionDefinitions;\n  /** Every API-backed WebMCP tool, independent of list materialization. */\n  export const webMcpToolDefinitions: readonly WebMcpToolDefinition[];\n  export function getCollectionDefinition<\n    K extends keyof SmrtWebCollectionDefinitions,\n  >(name: K): SmrtWebCollectionDefinitions[K];\n  /**\n   * Build-time web-collection shape digest (#1764). A deterministic,\n   * replica-stable hash of the emitted collection definitions; a change means\n   * old persisted client rows may mis-hydrate. Consumers fold it into the\n   * durable persistence namespace and the version-awareness updateAvailable\n   * contract signal.\n   */\n  export const manifestHash: string;\n  export default collectionDefinitions;\n}`;\n\n  // Write all virtual module declarations\n  fs.writeFileSync(\n    path.join(outDir, 'smrt-manifest.d.ts'),\n    manifestDeclaration,\n  );\n  fs.writeFileSync(path.join(outDir, 'smrt-client.d.ts'), clientDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-routes.d.ts'), routesDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-mcp.d.ts'), mcpDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-types.d.ts'), typesDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-web.d.ts'), webDeclaration);\n}\n\n/**\n * Map SMRT field types to TypeScript types\n */\nfunction mapFieldTypeToTypeScript(smrtType: string): string {\n  switch (smrtType) {\n    case 'text':\n      return 'string';\n    case 'decimal':\n    case 'integer':\n      return 'number';\n    case 'boolean':\n      return 'boolean';\n    case 'datetime':\n      return 'string | Date';\n    case 'json':\n      return 'any';\n    case 'foreignKey':\n      return 'string';\n    default:\n      return 'any';\n  }\n}\n\n/**\n * CLI command for generating declarations\n */\nexport async function generateDeclarationsFromCLI(\n  args: string[],\n): Promise<void> {\n  const manifestPath = args[0];\n  const outDir = args[1] || 'src/types/generated';\n\n  if (!manifestPath) {\n    console.error('Usage: generate-declarations <manifest-path> [output-dir]');\n    process.exit(1);\n  }\n\n  if (!fs.existsSync(manifestPath)) {\n    console.error(`Manifest file not found: ${manifestPath}`);\n    process.exit(1);\n  }\n\n  await generateDeclarations({\n    manifest: manifestPath,\n    outDir,\n  });\n}\n"],"mappings":";;;;;;;;;;;;AA+BA,eAAsB,qBACpB,SACe;CACf,MAAM,EACJ,UAAU,eACV,QACA,wBAAwB,MACxB,qBAAqB,MACrB,cAAc,QAAQ,IAAI,MACxB;CAGJ,MAAM,WACJ,OAAO,kBAAkB,WACrB,KAAK,MAAM,GAAG,aAAa,eAAe,OAAO,CAAC,IAClD;CAGN,MAAM,aAAa,KAAK,WAAW,MAAM,IACrC,SACA,KAAK,KAAK,aAAa,MAAM;CACjC,GAAG,UAAU,YAAY,EAAE,WAAW,KAAK,CAAC;CAE5C,QAAQ,IAAI,8CAA8C,YAAY;CAEtE,IAAI,oBACF,MAAM,+BAA+B,UAAU,UAAU;CAG3D,IAAI,uBACF,MAAM,kCAAkC,UAAU,UAAU;CAG9D,QAAQ,IACN,8CAA8C,OAAO,KAAK,SAAS,OAAO,CAAC,CAAC,OAAO,cACrF;AACF;;;;AAKA,eAAe,+BACb,UACA,QACe;CACf,MAAM,aAAuB,CAAC;CAG9B,KAAK,MAAM,CAAC,aAAa,eAAe,OAAO,QAAQ,SAAS,OAAO,GAAG;EACxE,MAAM,SAAS,WAAW,UAAU,CAAC;EACrC,MAAM,gBAA0B,CAAC;EAGjC,cAAc,KAAK,gBAAgB;EACnC,cAAc,KAAK,wBAAwB;EAC3C,cAAc,KAAK,wBAAwB;EAG3C,KAAK,MAAM,CAAC,WAAW,aAAa,OAAO,QAAQ,MAAM,GAAG;GAC1D,MAAM,OAAO,yBAAyB,SAAS,IAAI;GACnD,MAAM,WAAW,CAAC,SAAS,WAAW,MAAM;GAC5C,cAAc,KAAK,KAAK,YAAY,SAAS,IAAI,KAAK,EAAE;EAC1D;EAEA,MAAM,eAAe,oBAAoB,WAAW,UAAU;EAChE,cAAc,KAAK,IAAI,EAAE;;EAEvB,WAAW,KAAK,YAAY;CAC9B;CAGA,MAAM,qBAAqB;;;;;;;EAO3B,WAAW,KAAK,MAAM,EAAE;;CAGxB,GAAG,cAAc,KAAK,KAAK,QAAQ,mBAAmB,GAAG,kBAAkB;AAC7E;;;;AAKA,eAAe,kCACb,UACA,QACe;CAEf,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8E5B,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAhCC,uBAAuB,QAAQ,CAAC,CACxD,KAAK,EAAE,WAAW,mBAAmB,aAAa,oBAAoB;EAErE,MAAM,WAAW,wBACf,mBACA,aAHwB,cAAc,KAAK,EAAE,WAAW,IAIxD,CACF;EACA,MAAM,mBAAmB,cACtB,KACE,WACC,SAAS,OAAO,KAAK,GAAG,sCACtB,QACA,wBACF,EAAE,iBACN,CAAC,CACA,KAAK,IAAI;EAEZ,IAAI,kBAAkB;GACpB,MAAM,eAAe,WAAW,GAAG,SAAS,OAAO;GACnD,OAAO,OAAO,KAAK,UAAU,SAAS,EAAE,IAAI,aAAa,KAAK,iBAAiB;EACjF;EAEA,OAAO,OAAO,KAAK,UAAU,SAAS,EAAE,IAAI,YAAY,wBAAwB;CAClF,CAAC,CAAC,CACD,KAAK,IA4CR,EAAmB;;;;;;CAQnB,MAAM,oBAAoB;;;;;;;;;;;;;;CAgB1B,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;CA+BvB,MAAM,mBAAmB;;;;EAPH,OAAO,OAAO,SAAS,OAAO,CAAC,CAClD,KACE,QACC,iBAAiB,IAAI,UAAU,kCAAkC,IAAI,UAAU,MACnF,CAAC,CACA,KAAK,IAMR,EAAc;;;;;;;;;;;;;CAyBd,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAPM,2BAA2B,QAAQ,CAAC,CAC9D,KACE,EAAE,YAAY,UACb,OAAO,KAAK,UAAU,UAAU,EAAE,yDAAyD,IAAI,UAAU,OAC7G,CAAC,CACA,KAAK,IAuGR,EAAqB;;;;;;;;;;;;;;;;;;;CAqBrB,GAAG,cACD,KAAK,KAAK,QAAQ,oBAAoB,GACtC,mBACF;CACA,GAAG,cAAc,KAAK,KAAK,QAAQ,kBAAkB,GAAG,iBAAiB;CACzE,GAAG,cAAc,KAAK,KAAK,QAAQ,kBAAkB,GAAG,iBAAiB;CACzE,GAAG,cAAc,KAAK,KAAK,QAAQ,eAAe,GAAG,cAAc;CACnE,GAAG,cAAc,KAAK,KAAK,QAAQ,iBAAiB,GAAG,gBAAgB;CACvE,GAAG,cAAc,KAAK,KAAK,QAAQ,eAAe,GAAG,cAAc;AACrE;;;;AAKA,SAAS,yBAAyB,UAA0B;CAC1D,QAAQ,UAAR;EACE,KAAK,QACH,OAAO;EACT,KAAK;EACL,KAAK,WACH,OAAO;EACT,KAAK,WACH,OAAO;EACT,KAAK,YACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,cACH,OAAO;EACT,SACE,OAAO;CACX;AACF;;;;AAKA,eAAsB,4BACpB,MACe;CACf,MAAM,eAAe,KAAK;CAC1B,MAAM,SAAS,KAAK,MAAM;CAE1B,IAAI,CAAC,cAAc;EACjB,QAAQ,MAAM,2DAA2D;EACzE,QAAQ,KAAK,CAAC;CAChB;CAEA,IAAI,CAAC,GAAG,WAAW,YAAY,GAAG;EAChC,QAAQ,MAAM,4BAA4B,cAAc;EACxD,QAAQ,KAAK,CAAC;CAChB;CAEA,MAAM,qBAAqB;EACzB,UAAU;EACV;CACF,CAAC;AACH"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/prebuild/index.ts"],"sourcesContent":["/**\n * Pre-build utilities for generating TypeScript declarations\n * Solves virtual module resolution by creating physical .d.ts files\n */\n\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport type { SmartObjectManifest } from '../scanner/types';\nimport {\n  renderApiClientCrudType,\n  renderApiClientCustomMethodParameters,\n  selectApiClientEntries,\n} from '../vite-plugin/api-client-entries.js';\nimport {\n  compareText,\n  selectWebCollectionEntries,\n} from '../vite-plugin/web-collections.js';\n\nexport interface PrebuildOptions {\n  /** Path to manifest file or manifest object */\n  manifest: string | SmartObjectManifest;\n  /** Output directory for generated types */\n  outDir: string;\n  /** Include virtual module declarations */\n  includeVirtualModules?: boolean;\n  /** Include object type definitions */\n  includeObjectTypes?: boolean;\n  /** Project root path for resolving relative paths */\n  projectRoot?: string;\n}\n\n/**\n * Generate TypeScript declaration files from SMRT manifest\n */\nexport async function generateDeclarations(\n  options: PrebuildOptions,\n): Promise<void> {\n  const {\n    manifest: manifestInput,\n    outDir,\n    includeVirtualModules = true,\n    includeObjectTypes = true,\n    projectRoot = process.cwd(),\n  } = options;\n\n  // Load manifest\n  const manifest: SmartObjectManifest =\n    typeof manifestInput === 'string'\n      ? JSON.parse(fs.readFileSync(manifestInput, 'utf-8'))\n      : manifestInput;\n\n  // Ensure output directory exists\n  const fullOutDir = path.isAbsolute(outDir)\n    ? outDir\n    : path.join(projectRoot, outDir);\n  fs.mkdirSync(fullOutDir, { recursive: true });\n\n  console.log(`[smrt:prebuild] Generating declarations to ${fullOutDir}`);\n\n  if (includeObjectTypes) {\n    await generateObjectTypeDeclarations(manifest, fullOutDir);\n  }\n\n  if (includeVirtualModules) {\n    await generateVirtualModuleDeclarations(manifest, fullOutDir);\n  }\n\n  console.log(\n    `[smrt:prebuild] Generated declarations for ${Object.keys(manifest.objects).length} SMRT objects`,\n  );\n}\n\n/**\n * Generate TypeScript interfaces for SMRT objects\n */\nasync function generateObjectTypeDeclarations(\n  manifest: SmartObjectManifest,\n  outDir: string,\n): Promise<void> {\n  const interfaces: string[] = [];\n\n  // Generate interfaces for each discovered SMRT object. Manifest key order\n  // follows scan/discovery order, which is not stable across runs (#2749),\n  // so sort deterministically before emitting.\n  const sortedObjectEntries = Object.entries(manifest.objects).sort(\n    ([leftKey, left], [rightKey, right]) =>\n      compareText(\n        left.qualifiedName || leftKey,\n        right.qualifiedName || rightKey,\n      ) || compareText(leftKey, rightKey),\n  );\n  for (const [_objectName, objectMeta] of sortedObjectEntries) {\n    const fields = objectMeta.fields || {};\n    const propertyLines: string[] = [];\n\n    // Add standard SmrtObject properties\n    propertyLines.push('  id?: string;');\n    propertyLines.push('  created_at?: string;');\n    propertyLines.push('  updated_at?: string;');\n\n    // Add object-specific properties\n    for (const [fieldName, fieldDef] of Object.entries(fields)) {\n      const type = mapFieldTypeToTypeScript(fieldDef.type);\n      const optional = !fieldDef.required ? '?' : '';\n      propertyLines.push(`  ${fieldName}${optional}: ${type};`);\n    }\n\n    const interfaceDef = `export interface ${objectMeta.className}Data {\n${propertyLines.join('\\n')}\n}`;\n    interfaces.push(interfaceDef);\n  }\n\n  // Write object types file\n  const objectTypesContent = `/**\n * Auto-generated TypeScript interfaces for SMRT objects\n * Generated at build time from @smrt() decorated classes\n *\n * DO NOT EDIT THIS FILE MANUALLY\n */\n\n${interfaces.join('\\n\\n')}\n`;\n\n  fs.writeFileSync(path.join(outDir, 'smrt-objects.d.ts'), objectTypesContent);\n}\n\n/**\n * Generate virtual module declarations\n */\nasync function generateVirtualModuleDeclarations(\n  manifest: SmartObjectManifest,\n  outDir: string,\n): Promise<void> {\n  // Generate manifest module declaration\n  const manifestDeclaration = `/**\n * Auto-generated manifest module declaration\n */\ndeclare module '@smrt/manifest' {\n  export interface SmrtObjectField {\n    type: string;\n    required?: boolean;\n    default?: any;\n  }\n\n  export interface SmrtObjectMethod {\n    name: string;\n    parameters: Array<{\n      name: string;\n      type: string;\n      optional?: boolean;\n      default?: any;\n    }>;\n    returnType: string;\n    async: boolean;\n    isStatic: boolean;\n    isPublic: boolean;\n  }\n\n  export interface SmrtObjectDefinition {\n    name: string;\n    className: string;\n    collection: string;\n    filePath: string;\n    fields: Record<string, SmrtObjectField>;\n    methods: Record<string, SmrtObjectMethod>;\n    decoratorConfig: any;\n    extends?: string;\n  }\n\n  export interface SmrtManifest {\n    version: string;\n    timestamp: number;\n    objects: Record<string, SmrtObjectDefinition>;\n  }\n\n  export const manifest: SmrtManifest;\n  export default manifest;\n}`;\n\n  // Generate client module declaration\n  const apiClientInterface = selectApiClientEntries(manifest)\n    .map(({ clientKey, dataInterfaceName, crudMethods, customMethods }) => {\n      const overriddenMethods = customMethods.map(({ name }) => name);\n      const crudType = renderApiClientCrudType(\n        dataInterfaceName,\n        crudMethods,\n        overriddenMethods,\n      );\n      const customSignatures = customMethods\n        .map(\n          (method) =>\n            `      ${method.name}(${renderApiClientCustomMethodParameters(\n              method,\n              mapFieldTypeToTypeScript,\n            )}): Promise<any>;`,\n        )\n        .join('\\n');\n\n      if (customSignatures) {\n        const intersection = crudType ? `${crudType} & ` : '';\n        return `    ${JSON.stringify(clientKey)}: ${intersection}{\\n${customSignatures}\\n    };`;\n      }\n\n      return `    ${JSON.stringify(clientKey)}: ${crudType ?? 'Record<string, never>'};`;\n    })\n    .join('\\n');\n\n  // Wire-shape policy (#1797): the server returns BARE JSON — a bare array for\n  // list/search, a bare object for get/create/update — with snake_case field\n  // names (created_at, updated_at). These physical declarations share client\n  // entry selection and method-signature rendering with the Vite declaration.\n  // Fetchers reject on non-2xx with a SmrtClientError (#1796).\n  const clientDeclaration = `/**\n * Auto-generated API client module declaration\n */\ndeclare module '@smrt/client' {\n  /** Structured custom-action failure nested under an API error body's \\`error\\` key. */\n  export interface SmrtClientFailure {\n    ok: false;\n    code: string;\n    message: string;\n    status?: number;\n  }\n\n  /** Shape of a JSON error body carried by a rejected request (SmrtClientError.body). */\n  export interface ApiError {\n    error?: string | SmrtClientFailure;\n    message?: string;\n  }\n\n  /** Typed error thrown by every fetcher on a non-2xx response (#1796). */\n  export interface SmrtClientError extends Error {\n    name: 'SmrtClientError';\n    status: number;\n    /** Machine-readable code from a structured custom-action failure, when present. */\n    code?: string;\n    body?: ApiError | string;\n  }\n\n  export interface CrudOperations<T = any> {\n    list(params?: Record<string, any>): Promise<T[]>;\n    get(id: string): Promise<T>;\n    create(data: Partial<T>): Promise<T>;\n    update(id: string, data: Partial<T>): Promise<T>;\n    delete(id: string): Promise<boolean>;\n    search(query: string): Promise<T[]>;\n  }\n\n  export interface ApiClient {\n${apiClientInterface}\n  }\n\n  export function createClient(basePath?: string): ApiClient;\n  export default createClient;\n}`;\n\n  // Generate routes module declaration\n  const routesDeclaration = `/**\n * Auto-generated routes module declaration\n */\ndeclare module '@smrt/routes' {\n  export interface RouteApp {\n    get(path: string, handler: (req: any, res: any) => void): void;\n    post(path: string, handler: (req: any, res: any) => void): void;\n    put(path: string, handler: (req: any, res: any) => void): void;\n    delete(path: string, handler: (req: any, res: any) => void): void;\n  }\n\n  export function setupRoutes(app: RouteApp): void;\n  export default setupRoutes;\n}`;\n\n  // Generate MCP module declaration\n  const mcpDeclaration = `/**\n * Auto-generated MCP module declaration\n */\ndeclare module '@smrt/mcp' {\n  export interface McpTool {\n    name: string;\n    description: string;\n    inputSchema: {\n      type: string;\n      properties: Record<string, any>;\n      required?: string[];\n    };\n  }\n\n  export const tools: McpTool[];\n  export function createMCPServer(): {\n    name: string;\n    version: string;\n    tools: McpTool[]\n  };\n  export default createMCPServer;\n}`;\n\n  // Generate types module declaration with object imports. Sorted for the\n  // same reason as generateObjectTypeDeclarations (#2749).\n  const objectImports = Object.entries(manifest.objects)\n    .sort(\n      ([leftKey, left], [rightKey, right]) =>\n        compareText(\n          left.qualifiedName || leftKey,\n          right.qualifiedName || rightKey,\n        ) || compareText(leftKey, rightKey),\n    )\n    .map(\n      ([, obj]) =>\n        `  export type ${obj.className}Data = import('./smrt-objects').${obj.className}Data;`,\n    )\n    .join('\\n');\n\n  const typesDeclaration = `/**\n * Auto-generated types module declaration\n */\ndeclare module '@smrt/types' {\n${objectImports}\n\n  export interface Request {\n    params: Record<string, string>;\n    query: Record<string, any>;\n    json(): Promise<any>;\n  }\n\n  export interface Response {\n    json(data: any, init?: { status?: number }): Response;\n    status(code: number): Response;\n  }\n}`;\n\n  // Generate web collection-definition module declaration (#1761). Selection\n  // shares selectWebCollectionEntries with the vite-plugin runtime module and\n  // its virt-web d.ts, so this `tsc`-only consumer declaration cannot drift\n  // from the emitted values.\n  const webCollectionEntries = selectWebCollectionEntries(manifest)\n    .map(\n      ({ collection, obj }) =>\n        `    ${JSON.stringify(collection)}: SmrtWebCollectionDefinition<import('./smrt-objects').${obj.className}Data>;`,\n    )\n    .join('\\n');\n\n  const webDeclaration = `/**\n * Auto-generated web collection-definition module declaration (#1761)\n */\ndeclare module '@smrt/web' {\n  export type SmrtWebFieldType =\n    | 'text'\n    | 'decimal'\n    | 'boolean'\n    | 'integer'\n    | 'datetime'\n    | 'json'\n    | 'foreignKey'\n    | 'crossPackageRef';\n\n  /** Static \\`@field({ ui })\\` hints (#2046) — the field-policy rail seed. */\n  export interface SmrtWebFieldUIHints {\n    basic?: boolean;\n    group?: string;\n    order?: number;\n    locked?: boolean;\n  }\n\n  export interface SmrtWebFieldDefinition {\n    type: SmrtWebFieldType;\n    required?: boolean;\n    nullable?: boolean;\n    default?: unknown;\n    /** Developer-authored \\`@field({ description })\\` (#2046) — end-user help seed. */\n    description?: string;\n    /** Static \\`@field({ ui })\\` hints (#2046). */\n    ui?: SmrtWebFieldUIHints;\n  }\n\n  export type SmrtWebRelationshipKind =\n    | 'foreignKey'\n    | 'crossPackageRef'\n    | 'oneToMany'\n    | 'manyToMany';\n\n  /**\n   * A manifest-derived edge to a sibling REST collection. Mutating this\n   * collection invalidates the caches of the collections named by these edges\n   * (#1761 relationship-derived invalidation).\n   */\n  export interface SmrtWebRelationship {\n    field: string;\n    kind: SmrtWebRelationshipKind;\n    relatedCollection: string;\n  }\n\n  export interface WebToolRouteDescriptor {\n    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';\n    scope: 'item' | 'collection';\n    path: string[];\n    parameterAliases?: Record<string, string>;\n    optionsBag?: boolean;\n  }\n\n  /** A WebMCP/MCP tool descriptor for one collection action (#1812). */\n  export interface WebToolDescriptor {\n    action: string;\n    name: string;\n    description: string;\n    inputSchema: Record<string, unknown>;\n    readOnly: boolean;\n    effect: 'read' | 'write' | 'destructive';\n    idempotent: boolean;\n    openWorld: boolean;\n    route?: WebToolRouteDescriptor;\n  }\n\n  /** Canonical data-only definition for one generated browser tool. */\n  export interface WebMcpToolDefinition extends WebToolDescriptor {\n    collection: string;\n    objectRef: string;\n    className: string;\n    endpoint: string;\n    idField: string;\n    idType: 'uuid' | 'text';\n    route: WebToolRouteDescriptor;\n    relationships: SmrtWebRelationship[];\n  }\n\n  export interface SmrtWebCollectionDefinition<TData = Record<string, unknown>> {\n    name: string;\n    /** Canonical qualified model identity (\\`@package/name:ClassName\\`) for policy APIs. */\n    objectRef: string;\n    className: string;\n    endpoint: string;\n    idField: string;\n    actions: string[];\n    fields: Record<string, SmrtWebFieldDefinition>;\n    /** Manifest-derived relationship edges to sibling REST collections. */\n    relationships: SmrtWebRelationship[];\n    /** WebMCP/MCP tool descriptors for the exposed actions (#1812). */\n    toolDescriptors: WebToolDescriptor[];\n    /** Phantom row-type carrier for inference — never present at runtime. */\n    _row?: TData;\n  }\n\n  export interface SmrtWebCollectionDefinitions {\n${webCollectionEntries}\n  }\n\n  export const collectionDefinitions: SmrtWebCollectionDefinitions;\n  /** Every API-backed WebMCP tool, independent of list materialization. */\n  export const webMcpToolDefinitions: readonly WebMcpToolDefinition[];\n  export function getCollectionDefinition<\n    K extends keyof SmrtWebCollectionDefinitions,\n  >(name: K): SmrtWebCollectionDefinitions[K];\n  /**\n   * Build-time web-collection shape digest (#1764). A deterministic,\n   * replica-stable hash of the emitted collection definitions; a change means\n   * old persisted client rows may mis-hydrate. Consumers fold it into the\n   * durable persistence namespace and the version-awareness updateAvailable\n   * contract signal.\n   */\n  export const manifestHash: string;\n  export default collectionDefinitions;\n}`;\n\n  // Write all virtual module declarations\n  fs.writeFileSync(\n    path.join(outDir, 'smrt-manifest.d.ts'),\n    manifestDeclaration,\n  );\n  fs.writeFileSync(path.join(outDir, 'smrt-client.d.ts'), clientDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-routes.d.ts'), routesDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-mcp.d.ts'), mcpDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-types.d.ts'), typesDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-web.d.ts'), webDeclaration);\n}\n\n/**\n * Map SMRT field types to TypeScript types\n */\nfunction mapFieldTypeToTypeScript(smrtType: string): string {\n  switch (smrtType) {\n    case 'text':\n      return 'string';\n    case 'decimal':\n    case 'integer':\n      return 'number';\n    case 'boolean':\n      return 'boolean';\n    case 'datetime':\n      return 'string | Date';\n    case 'json':\n      return 'any';\n    case 'foreignKey':\n      return 'string';\n    default:\n      return 'any';\n  }\n}\n\n/**\n * CLI command for generating declarations\n */\nexport async function generateDeclarationsFromCLI(\n  args: string[],\n): Promise<void> {\n  const manifestPath = args[0];\n  const outDir = args[1] || 'src/types/generated';\n\n  if (!manifestPath) {\n    console.error('Usage: generate-declarations <manifest-path> [output-dir]');\n    process.exit(1);\n  }\n\n  if (!fs.existsSync(manifestPath)) {\n    console.error(`Manifest file not found: ${manifestPath}`);\n    process.exit(1);\n  }\n\n  await generateDeclarations({\n    manifest: manifestPath,\n    outDir,\n  });\n}\n"],"mappings":"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"}

package/dist/registry/class-registration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"class-registration.d.ts","sourceRoot":"","sources":["../../src/registry/class-registration.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAKV,qBAAqB,EAGtB,MAAM,qBAAqB,CAAC;AAqC7B,OAAO,KAAK,EACV,eAAe,EAEf,iBAAiB,EAElB,MAAM,YAAY,CAAC;AA0dpB,wBAAgB,QAAQ,CACtB,IAAI,EAAE,OAAO,UAAU,EACvB,MAAM,GAAE,iBAAsB,GAC7B,IAAI,CAmvBN;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAMlB,qBAAqB,EAAE,WAAW,CAAC,eAAe,CAAC,uBAAuB,CAAC,CAAC,GAC3E,IAAI,CAeN;AA6LD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,eAAe,EACzB,gBAAgB,CAAC,EAAE;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,IAAI,CA2CN;AA0ID,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,qBAAqB,EAChC,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CA4QN"}
+{"version":3,"file":"class-registration.d.ts","sourceRoot":"","sources":["../../src/registry/class-registration.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAKV,qBAAqB,EAGtB,MAAM,qBAAqB,CAAC;AAsC7B,OAAO,KAAK,EACV,eAAe,EAEf,iBAAiB,EAElB,MAAM,YAAY,CAAC;AA0dpB,wBAAgB,QAAQ,CACtB,IAAI,EAAE,OAAO,UAAU,EACvB,MAAM,GAAE,iBAAsB,GAC7B,IAAI,CAqwBN;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAMlB,qBAAqB,EAAE,WAAW,CAAC,eAAe,CAAC,uBAAuB,CAAC,CAAC,GAC3E,IAAI,CAeN;AA6LD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,eAAe,EACzB,gBAAgB,CAAC,EAAE;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,IAAI,CA2CN;AA0ID,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,qBAAqB,EAChC,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CA4QN"}

package/dist/registry/class-registration.js

@@ -9,6 +9,7 @@ import { discoverManifestSync, discoverSTISiblingsSync, getPackageName, lookupIn
 import { tableNameFromClass } from "../utils.js";
 import { SmrtObject } from "../object.js";
 import { decideCollisionPolicy } from "./collision-policy.js";
+import { isFrameworkBaseClass } from "./framework-base-classes.js";
 import { createFieldFromManifest, mergeManifestField } from "./manifest-field-merge.js";
 import { compileValidators } from "./validator.js";
 //#region src/registry/class-registration.ts
@@ -482,7 +483,8 @@ function register(ctor, config = {}) {
 	if (inheritanceChain.length > 1) {
 		const parentName = inheritanceChain[inheritanceChain.length - 2];
 		const parentEntry = findClass(parentName);
-		if (parentEntry) {
+		const parentIsFrameworkBase = parentEntry !== void 0 && isFrameworkBaseClass(parentEntry.name, parentEntry.packageName);
+		if (parentEntry && !parentIsFrameworkBase) {
 			const parentStrategy = parentEntry.config?.tableStrategy || "default";
 			const childStrategy = config.tableStrategy;
 			if (childStrategy !== void 0 && parentStrategy !== childStrategy) throw ConfigurationError.incompatibleStrategy(name, childStrategy, parentName, parentStrategy);