@happyvertical/smrt-core 0.49.3 → 0.49.5

package/dist/schema/manifest-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest-schema.js","names":[],"sources":["../../src/schema/manifest-schema.ts"],"sourcesContent":["/**\n * Manifest schema → structured `SchemaDefinition` helpers (#2358).\n *\n * A manifest's `schema.ddl` string is an engine-neutral CREATE TABLE preview:\n * it carries no indexes and no per-engine type mapping, so nothing that needs\n * an executable schema may treat it as authoritative. Every consumer that\n * reads raw manifest JSON — `SchemaAggregator`, `createIsolatedTestDbFromManifest`\n * in `@happyvertical/smrt-vitest`, third-party tooling — should collect the\n * structured `columns` / `indexes` through this module and render them with\n * `getDDLStrategy(engine)`, exactly as `db:migrate` does.\n *\n * The cached `ddl` string is used only when a manifest object exposes no\n * structured columns at all (hand-authored or pre-structured manifests); that\n * legacy path keeps working but is not engine-complete.\n *\n * Keep this module light — type-only imports plus the DDL strategies and the\n * logger — so it can be re-exported from lightweight entry points without\n * pulling the registry/collection module graph in by itself.\n */\n\nimport { createLogger } from '@happyvertical/logger';\nimport { getDDLStrategy } from './ddl/index.js';\nimport {\n  findCreateTableBodyRange,\n  getSQLDefinitionComparisonKey,\n  getSQLDefinitionIdentifier,\n  isSQLTableConstraintDefinition,\n  materializeManifestDDLForEngine,\n  tokenizeSQLDDLBody,\n} from './ddl/materialize-manifest.js';\nimport type { DatabaseEngine, EngineSpecificDDL } from './ddl/types.js';\nimport { quoteIdentifier } from './sql-identifiers.js';\nimport type {\n  ColumnDefinition,\n  IndexDefinition,\n  SchemaDefinition,\n  SQLDataType,\n} from './types.js';\n\nconst logger = createLogger({ level: 'info' });\n\n/**\n * Column shape as it appears in raw manifest JSON. `ManifestColumnDefinition`\n * spells the default `default`; registry-side `ColumnDefinition` spells it\n * `defaultValue`. Hand-authored manifests use either.\n */\nexport interface ManifestColumnLike {\n  type: string;\n  primaryKey?: boolean;\n  referenceKind?: ColumnDefinition['referenceKind'];\n  notNull?: boolean;\n  unique?: boolean;\n  default?: unknown;\n  defaultValue?: unknown;\n  foreignKey?: ColumnDefinition['foreignKey'];\n  check?: string;\n}\n\n/** Index shape as it appears in raw manifest JSON. */\nexport interface ManifestIndexLike {\n  name: string;\n  columns?: string[];\n  unique?: boolean;\n  where?: string;\n  jsonPath?: IndexDefinition['jsonPath'];\n}\n\n/** The subset of a manifest object's `schema` this module reads. */\nexport interface ManifestSchemaLike {\n  tableName: string;\n  ddl?: string;\n  columns?: Record<string, ManifestColumnLike>;\n  indexes?: ManifestIndexLike[];\n  version?: string;\n}\n\n/**\n * Convert one raw manifest column map into structured `ColumnDefinition`s.\n * Picks known fields only, so stray manifest keys never leak into DDL.\n */\nexport function manifestColumnsToDefinitions(\n  columns: Record<string, ManifestColumnLike> | undefined,\n): Record<string, ColumnDefinition> {\n  const result: Record<string, ColumnDefinition> = {};\n  for (const [name, column] of Object.entries(columns || {})) {\n    if (!column || typeof column.type !== 'string') continue;\n    const definition: ColumnDefinition = {\n      type: column.type as SQLDataType,\n    };\n    if (column.primaryKey !== undefined)\n      definition.primaryKey = column.primaryKey;\n    if (column.referenceKind !== undefined)\n      definition.referenceKind = column.referenceKind;\n    if (column.notNull !== undefined) definition.notNull = column.notNull;\n    if (column.unique !== undefined) definition.unique = column.unique;\n    const defaultValue =\n      column.defaultValue !== undefined ? column.defaultValue : column.default;\n    if (defaultValue !== undefined) definition.defaultValue = defaultValue;\n    if (column.foreignKey) definition.foreignKey = { ...column.foreignKey };\n    if (column.check) definition.check = column.check;\n    result[name] = definition;\n  }\n  return result;\n}\n\n/**\n * Convert raw manifest indexes into structured `IndexDefinition`s, keeping\n * `where` (partial) and `jsonPath` (expression) targets — the two fields the\n * retired string-based renderers dropped.\n */\nexport function manifestIndexesToDefinitions(\n  indexes: ManifestIndexLike[] | undefined,\n): IndexDefinition[] {\n  const result: IndexDefinition[] = [];\n  for (const index of indexes || []) {\n    if (!index?.name) continue;\n    const definition: IndexDefinition = {\n      name: index.name,\n      columns: Array.isArray(index.columns) ? [...index.columns] : [],\n    };\n    if (index.unique !== undefined) definition.unique = index.unique;\n    if (index.where) definition.where = index.where;\n    if (index.jsonPath?.column && index.jsonPath.path) {\n      definition.jsonPath = { ...index.jsonPath };\n    }\n    result.push(definition);\n  }\n  return result;\n}\n\n/**\n * Convert one manifest object's `schema` into a `SchemaDefinition`.\n *\n * The cached `ddl` string is carried along (non-authoritative) so callers can\n * fall back to it when the manifest exposes no structured columns.\n */\nexport function manifestSchemaToDefinition(\n  schema: ManifestSchemaLike,\n): SchemaDefinition {\n  const columns = manifestColumnsToDefinitions(schema.columns);\n  const foreignKeys = Object.entries(columns).flatMap(([column, definition]) =>\n    definition.foreignKey\n      ? [\n          {\n            column,\n            referencesTable: definition.foreignKey.table,\n            referencesColumn: definition.foreignKey.column,\n            onDelete: definition.foreignKey.onDelete,\n            onUpdate: definition.foreignKey.onUpdate,\n            ...(definition.foreignKey.engines\n              ? { engines: definition.foreignKey.engines }\n              : {}),\n          },\n        ]\n      : [],\n  );\n  return {\n    tableName: schema.tableName,\n    ddl: schema.ddl,\n    columns,\n    indexes: manifestIndexesToDefinitions(schema.indexes),\n    triggers: [],\n    foreignKeys,\n    dependencies: foreignKeys\n      .map((foreignKey) => foreignKey.referencesTable)\n      .filter((dependency) => dependency !== schema.tableName),\n    version: schema.version ?? '',\n  };\n}\n\n/**\n * One physical table collected from one or more manifest objects (STI\n * subclasses share a table and each contributes columns and indexes).\n */\nexport interface CollectedManifestTable {\n  tableName: string;\n  /**\n   * Structured union of every contributor: columns first-wins by name,\n   * indexes deduplicated by name.\n   */\n  definition: SchemaDefinition;\n  /**\n   * `true` when every contributor exposed structured columns, i.e. the whole\n   * table is rendered by a DDL strategy. `false` means at least one\n   * contributor carried only a cached `ddl` string: the CREATE TABLE is then\n   * the strategy render of the structured contributors (if any) merged with\n   * the cached strings of the column-less ones. The decision is per table,\n   * not per contributor.\n   */\n  structured: boolean;\n  /**\n   * The contributors' cached `ddl` strings merged column-wise (legacy path).\n   * Empty when no contributor carried a `ddl`.\n   */\n  legacyDdl: string;\n  /** `<package>:<ClassName>` labels of the contributors, in encounter order. */\n  sources: string[];\n}\n\n/**\n * Deterministic STI merge of two structured definitions: existing columns\n * win, new columns are appended, indexes are deduplicated by name.\n */\nexport function mergeSchemaDefinitionInto(\n  target: SchemaDefinition,\n  incoming: SchemaDefinition,\n): void {\n  for (const [name, column] of Object.entries(incoming.columns)) {\n    if (!(name in target.columns)) {\n      target.columns[name] = column;\n    }\n  }\n  const indexNames = new Set(target.indexes.map((index) => index.name));\n  for (const index of incoming.indexes) {\n    if (!indexNames.has(index.name)) {\n      indexNames.add(index.name);\n      target.indexes.push(index);\n    }\n  }\n  const foreignKeyKeys = new Set(\n    target.foreignKeys.map(\n      (foreignKey) =>\n        `${foreignKey.column}\\0${foreignKey.referencesTable}\\0${foreignKey.referencesColumn}`,\n    ),\n  );\n  for (const foreignKey of incoming.foreignKeys) {\n    const key = `${foreignKey.column}\\0${foreignKey.referencesTable}\\0${foreignKey.referencesColumn}`;\n    if (!foreignKeyKeys.has(key)) {\n      foreignKeyKeys.add(key);\n      target.foreignKeys.push(foreignKey);\n    }\n  }\n  target.dependencies = Array.from(\n    new Set([...target.dependencies, ...incoming.dependencies]),\n  ).sort();\n}\n\n/**\n * Collect manifest schemas into physical tables.\n *\n * Accepts the `schema` entries of manifest objects (any package, any manifest)\n * in encounter order and groups them by `tableName`, merging STI contributors\n * structurally. Objects without a `schema`/`tableName` are skipped by the\n * caller; objects with neither columns nor `ddl` are ignored here.\n */\nexport function collectManifestTables(\n  entries: Iterable<{ schema: ManifestSchemaLike; source: string }>,\n): Map<string, CollectedManifestTable> {\n  const tables = new Map<string, CollectedManifestTable>();\n  // Structured contributors whose cached ddl declares table constraints. Only\n  // a fully structured table drops them (a mixed table re-merges the string),\n  // so the warning is decided after collection.\n  const constraintCarriers = new Map<\n    string,\n    Array<{ source: string; constraints: string[] }>\n  >();\n\n  for (const { schema, source } of entries) {\n    if (!schema?.tableName) continue;\n    const definition = manifestSchemaToDefinition(schema);\n    const hasColumns = Object.keys(definition.columns).length > 0;\n    const ddl = typeof schema.ddl === 'string' ? schema.ddl : '';\n    if (!hasColumns && !ddl.trim()) continue;\n\n    if (hasColumns && ddl.trim()) {\n      const constraints = cachedDdlTableConstraints(ddl);\n      if (constraints.length > 0) {\n        const carriers = constraintCarriers.get(schema.tableName) ?? [];\n        carriers.push({ source, constraints });\n        constraintCarriers.set(schema.tableName, carriers);\n      }\n    }\n\n    const existing = tables.get(schema.tableName);\n    if (!existing) {\n      tables.set(schema.tableName, {\n        tableName: schema.tableName,\n        definition,\n        structured: hasColumns,\n        legacyDdl: ddl,\n        sources: [source],\n      });\n      continue;\n    }\n\n    mergeSchemaDefinitionInto(existing.definition, definition);\n    existing.structured = existing.structured && hasColumns;\n    existing.legacyDdl = existing.legacyDdl\n      ? ddl\n        ? mergeManifestDDL(existing.legacyDdl, ddl)\n        : existing.legacyDdl\n      : ddl;\n    existing.sources.push(source);\n  }\n\n  for (const [tableName, carriers] of constraintCarriers) {\n    if (!tables.get(tableName)?.structured) continue;\n    for (const { source, constraints } of carriers) {\n      warnAboutDroppedTableConstraints(tableName, source, constraints);\n    }\n  }\n\n  return tables;\n}\n\n/**\n * Render a collected table for one engine.\n *\n * Structured tables go through the engine strategy for the CREATE TABLE\n * (per-engine types, inline UNIQUE where the engine needs it) and for every\n * index (partial `WHERE`, JSON-path expressions, engine-specific syntax).\n * Tables with a column-less contributor keep that contributor's cached `ddl`\n * string, made minimally safe with `materializeManifestDDLForEngine`, merged\n * on top of the strategy render of any structured contributors — so a\n * structured STI base never loses its engine typing to a hand-authored\n * subclass, and the subclass's extra columns and table constraints survive.\n * Indexes always render through the strategy — the string never carried them.\n */\nexport function renderCollectedManifestTable(\n  table: CollectedManifestTable,\n  engine: DatabaseEngine,\n): EngineSpecificDDL {\n  const strategy = getDDLStrategy(engine);\n  const hasColumns = Object.keys(table.definition.columns).length > 0;\n  let createTable: string;\n  if (table.structured) {\n    createTable = strategy.generateCreateTable(table.definition);\n  } else if (hasColumns) {\n    createTable = mergeManifestDDL(\n      strategy.generateCreateTable(table.definition),\n      materializeManifestDDLForEngine(table.legacyDdl, engine),\n    );\n  } else {\n    createTable = materializeManifestDDLForEngine(table.legacyDdl, engine);\n  }\n\n  // Engines that need UNIQUE inline for ON CONFLICT (DuckDB, JSON) get it\n  // from `generateCreateTable` on the structured path and skip those indexes\n  // in `generateIndexes`. A cached string never carried them, so a table with\n  // a column-less contributor would lose its uniqueness entirely; append the\n  // missing constraints as table elements (deduplicated against any the\n  // string already declares).\n  if (!table.structured && strategy.requiresInlineUnique()) {\n    const uniqueElements = table.definition.indexes\n      .filter(\n        (index) =>\n          index.unique &&\n          !index.where &&\n          !index.jsonPath &&\n          index.columns.length > 0,\n      )\n      .map(\n        (index) =>\n          `UNIQUE(${index.columns.map((column) => quoteIdentifier(column)).join(', ')})`,\n      );\n    // Hand-authored strings may spell the same constraint without quotes\n    // (`UNIQUE(tenant_id)`); compare quote- and whitespace-insensitively so\n    // the synthesized element is not added beside it.\n    const declared = new Set(\n      cachedDdlTableConstraints(createTable).map(normalizeTableElement),\n    );\n    const missing = uniqueElements.filter(\n      (element) => !declared.has(normalizeTableElement(element)),\n    );\n    if (missing.length > 0) {\n      createTable = mergeManifestDDL(\n        createTable,\n        `CREATE TABLE ${quoteIdentifier(table.tableName)} (\\n  ${missing.join(',\\n  ')}\\n)`,\n      );\n    }\n  }\n\n  return {\n    createTable,\n    indexes: strategy.generateIndexes(table.definition),\n    triggers: strategy.generateTriggers(table.definition),\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Legacy cached-DDL string merge (column-less manifests only)\n// ---------------------------------------------------------------------------\n\nfunction parseDefinitionsFromDDL(ddl: string): {\n  columns: Map<string, string>;\n  tableElements: string[];\n} {\n  const columns = new Map<string, string>();\n  const tableElements: string[] = [];\n  const bodyRange = findCreateTableBodyRange(ddl);\n  if (!bodyRange) return { columns, tableElements };\n  const [bodyStart, bodyEnd] = bodyRange;\n\n  const segments = tokenizeSQLDDLBody(ddl.slice(bodyStart + 1, bodyEnd));\n\n  for (const segment of segments) {\n    const identifier = getSQLDefinitionIdentifier(segment);\n    if (!identifier) continue;\n    if (isSQLTableConstraintDefinition(segment)) {\n      tableElements.push(segment);\n      continue;\n    }\n\n    columns.set(identifier.name, segment);\n  }\n\n  return { columns, tableElements };\n}\n\n/**\n * Table-level constraints (`UNIQUE(...)`, `CHECK (...)`, `CONSTRAINT ...`,\n * ...) declared in a cached CREATE TABLE string. Structured `columns` cannot\n * represent them, so a structured render drops them — exactly as `db:migrate`\n * does. Exposed so callers can warn instead of losing them silently.\n *\n * @internal\n */\nexport function cachedDdlTableConstraints(ddl: string): string[] {\n  return parseDefinitionsFromDDL(ddl).tableElements;\n}\n\n/** Quote/whitespace/case-insensitive key for a table constraint element. */\nfunction normalizeTableElement(element: string): string {\n  return element.replace(/\"/g, '').replace(/\\s+/g, '').toLowerCase();\n}\n\nconst warnedDroppedConstraints = new Set<string>();\n\n/**\n * Warn once per process per table+source when a structured contributor's\n * cached `ddl` declares table constraints that the structured render cannot\n * carry. The structured schema is authoritative: a constraint that lives only\n * in the string never reaches `db:migrate` either, so rendering it here would\n * recreate the test/production drift #2358 removes.\n */\nfunction warnAboutDroppedTableConstraints(\n  tableName: string,\n  source: string,\n  constraints: string[],\n): void {\n  const key = `${tableName}\\0${source}`;\n  if (warnedDroppedConstraints.has(key)) return;\n  warnedDroppedConstraints.add(key);\n  logger.warn(\n    `[manifest-schema] ${source}: cached ddl for table \"${tableName}\" declares ` +\n      `${constraints.length} table constraint(s) that structured columns cannot ` +\n      `carry (${constraints.join('; ')}). They are not rendered — the ` +\n      `structured schema is authoritative (#2358). Declare uniqueness through ` +\n      `indexes/conflictColumns or a column-level constraint instead.`,\n  );\n}\n\n/**\n * Merge two cached CREATE TABLE strings for the same table (STI subclasses):\n * the union of columns, existing definitions winning, new columns inserted\n * before any trailing table constraints, missing table constraints appended.\n *\n * Only the legacy column-less manifest path uses this; structured manifests\n * merge through `mergeSchemaDefinitionInto`.\n */\nfunction mergeManifestDDL(existingDDL: string, newDDL: string): string {\n  const existingDefinitions = parseDefinitionsFromDDL(existingDDL);\n  const newDefinitions = parseDefinitionsFromDDL(newDDL);\n\n  const missingCols: string[] = [];\n  for (const [name, def] of newDefinitions.columns) {\n    if (!existingDefinitions.columns.has(name)) {\n      missingCols.push(def);\n    }\n  }\n\n  const existingTableElements = new Set(\n    existingDefinitions.tableElements.map(getSQLDefinitionComparisonKey),\n  );\n  const missingTableElements = newDefinitions.tableElements.filter(\n    (definition) =>\n      !existingTableElements.has(getSQLDefinitionComparisonKey(definition)),\n  );\n\n  if (missingCols.length === 0 && missingTableElements.length === 0) {\n    return existingDDL;\n  }\n\n  const bodyRange = findCreateTableBodyRange(existingDDL);\n  if (!bodyRange) return existingDDL;\n  const [bodyStart, bodyEnd] = bodyRange;\n  const prefix = existingDDL.slice(0, bodyStart + 1);\n  const body = existingDDL.slice(bodyStart + 1, bodyEnd);\n  const suffix = existingDDL.slice(bodyEnd);\n  const segments = tokenizeSQLDDLBody(body);\n  const firstConstraintIndex = segments.findIndex((segment) =>\n    isSQLTableConstraintDefinition(segment),\n  );\n  const insertionIndex =\n    firstConstraintIndex === -1 ? segments.length : firstConstraintIndex;\n  const mergedSegments = [\n    ...segments.slice(0, insertionIndex),\n    ...missingCols,\n    ...segments.slice(insertionIndex),\n    ...missingTableElements,\n  ];\n\n  return `${prefix}\\n${mergedSegments.map((segment) => `  ${segment}`).join(',\\n')}\\n${suffix}`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"manifest-schema.js","names":[],"sources":["../../src/schema/manifest-schema.ts"],"sourcesContent":["/**\n * Manifest schema → structured `SchemaDefinition` helpers (#2358).\n *\n * A manifest's `schema.ddl` string is an engine-neutral CREATE TABLE preview:\n * it carries no indexes and no per-engine type mapping, so nothing that needs\n * an executable schema may treat it as authoritative. Every consumer that\n * reads raw manifest JSON — `SchemaAggregator`, `createIsolatedTestDbFromManifest`\n * in `@happyvertical/smrt-vitest`, third-party tooling — should collect the\n * structured `columns` / `indexes` through this module and render them with\n * `getDDLStrategy(engine)`, exactly as `db:migrate` does.\n *\n * The cached `ddl` string is used only when a manifest object exposes no\n * structured columns at all (hand-authored or pre-structured manifests); that\n * legacy path keeps working but is not engine-complete.\n *\n * Keep this module light — type-only imports plus the DDL strategies and the\n * logger — so it can be re-exported from lightweight entry points without\n * pulling the registry/collection module graph in by itself.\n */\n\nimport { createLogger } from '@happyvertical/logger';\nimport { getDDLStrategy } from './ddl/index.js';\nimport {\n  findCreateTableBodyRange,\n  getSQLDefinitionComparisonKey,\n  getSQLDefinitionIdentifier,\n  isSQLTableConstraintDefinition,\n  materializeManifestDDLForEngine,\n  tokenizeSQLDDLBody,\n} from './ddl/materialize-manifest.js';\nimport type { DatabaseEngine, EngineSpecificDDL } from './ddl/types.js';\nimport { quoteIdentifier } from './sql-identifiers.js';\nimport type {\n  ColumnDefinition,\n  IndexDefinition,\n  SchemaDefinition,\n  SQLDataType,\n} from './types.js';\n\nconst logger = createLogger({ level: 'info' });\n\n/**\n * Column shape as it appears in raw manifest JSON. `ManifestColumnDefinition`\n * spells the default `default`; registry-side `ColumnDefinition` spells it\n * `defaultValue`. Hand-authored manifests use either.\n */\nexport interface ManifestColumnLike {\n  type: string;\n  primaryKey?: boolean;\n  referenceKind?: ColumnDefinition['referenceKind'];\n  notNull?: boolean;\n  unique?: boolean;\n  default?: unknown;\n  defaultValue?: unknown;\n  foreignKey?: ColumnDefinition['foreignKey'];\n  check?: string;\n}\n\n/** Index shape as it appears in raw manifest JSON. */\nexport interface ManifestIndexLike {\n  name: string;\n  columns?: string[];\n  unique?: boolean;\n  nullsNotDistinct?: boolean;\n  where?: string;\n  jsonPath?: IndexDefinition['jsonPath'];\n}\n\n/** The subset of a manifest object's `schema` this module reads. */\nexport interface ManifestSchemaLike {\n  tableName: string;\n  ddl?: string;\n  columns?: Record<string, ManifestColumnLike>;\n  indexes?: ManifestIndexLike[];\n  version?: string;\n}\n\n/**\n * Convert one raw manifest column map into structured `ColumnDefinition`s.\n * Picks known fields only, so stray manifest keys never leak into DDL.\n */\nexport function manifestColumnsToDefinitions(\n  columns: Record<string, ManifestColumnLike> | undefined,\n): Record<string, ColumnDefinition> {\n  const result: Record<string, ColumnDefinition> = {};\n  for (const [name, column] of Object.entries(columns || {})) {\n    if (!column || typeof column.type !== 'string') continue;\n    const definition: ColumnDefinition = {\n      type: column.type as SQLDataType,\n    };\n    if (column.primaryKey !== undefined)\n      definition.primaryKey = column.primaryKey;\n    if (column.referenceKind !== undefined)\n      definition.referenceKind = column.referenceKind;\n    if (column.notNull !== undefined) definition.notNull = column.notNull;\n    if (column.unique !== undefined) definition.unique = column.unique;\n    const defaultValue =\n      column.defaultValue !== undefined ? column.defaultValue : column.default;\n    if (defaultValue !== undefined) definition.defaultValue = defaultValue;\n    if (column.foreignKey) definition.foreignKey = { ...column.foreignKey };\n    if (column.check) definition.check = column.check;\n    result[name] = definition;\n  }\n  return result;\n}\n\n/**\n * Convert raw manifest indexes into structured `IndexDefinition`s, keeping\n * `where` (partial) and `jsonPath` (expression) targets — the two fields the\n * retired string-based renderers dropped.\n */\nexport function manifestIndexesToDefinitions(\n  indexes: ManifestIndexLike[] | undefined,\n): IndexDefinition[] {\n  const result: IndexDefinition[] = [];\n  for (const index of indexes || []) {\n    if (!index?.name) continue;\n    const definition: IndexDefinition = {\n      name: index.name,\n      columns: Array.isArray(index.columns) ? [...index.columns] : [],\n    };\n    if (index.unique !== undefined) definition.unique = index.unique;\n    if (index.nullsNotDistinct !== undefined)\n      definition.nullsNotDistinct = index.nullsNotDistinct;\n    if (index.where) definition.where = index.where;\n    if (index.jsonPath?.column && index.jsonPath.path) {\n      definition.jsonPath = { ...index.jsonPath };\n    }\n    result.push(definition);\n  }\n  return result;\n}\n\n/**\n * Convert one manifest object's `schema` into a `SchemaDefinition`.\n *\n * The cached `ddl` string is carried along (non-authoritative) so callers can\n * fall back to it when the manifest exposes no structured columns.\n */\nexport function manifestSchemaToDefinition(\n  schema: ManifestSchemaLike,\n): SchemaDefinition {\n  const columns = manifestColumnsToDefinitions(schema.columns);\n  const foreignKeys = Object.entries(columns).flatMap(([column, definition]) =>\n    definition.foreignKey\n      ? [\n          {\n            column,\n            referencesTable: definition.foreignKey.table,\n            referencesColumn: definition.foreignKey.column,\n            onDelete: definition.foreignKey.onDelete,\n            onUpdate: definition.foreignKey.onUpdate,\n            ...(definition.foreignKey.engines\n              ? { engines: definition.foreignKey.engines }\n              : {}),\n          },\n        ]\n      : [],\n  );\n  return {\n    tableName: schema.tableName,\n    ddl: schema.ddl,\n    columns,\n    indexes: manifestIndexesToDefinitions(schema.indexes),\n    triggers: [],\n    foreignKeys,\n    dependencies: foreignKeys\n      .map((foreignKey) => foreignKey.referencesTable)\n      .filter((dependency) => dependency !== schema.tableName),\n    version: schema.version ?? '',\n  };\n}\n\n/**\n * One physical table collected from one or more manifest objects (STI\n * subclasses share a table and each contributes columns and indexes).\n */\nexport interface CollectedManifestTable {\n  tableName: string;\n  /**\n   * Structured union of every contributor: columns first-wins by name,\n   * indexes reconciled by name with conflicting definitions rejected.\n   */\n  definition: SchemaDefinition;\n  /**\n   * `true` when every contributor exposed structured columns, i.e. the whole\n   * table is rendered by a DDL strategy. `false` means at least one\n   * contributor carried only a cached `ddl` string: the CREATE TABLE is then\n   * the strategy render of the structured contributors (if any) merged with\n   * the cached strings of the column-less ones. The decision is per table,\n   * not per contributor.\n   */\n  structured: boolean;\n  /**\n   * The contributors' cached `ddl` strings merged column-wise (legacy path).\n   * Empty when no contributor carried a `ddl`.\n   */\n  legacyDdl: string;\n  /** `<package>:<ClassName>` labels of the contributors, in encounter order. */\n  sources: string[];\n}\n\n/**\n * Deterministic STI merge of two structured definitions: existing columns\n * win, new columns are appended, indexes are deduplicated by name.\n */\nexport function mergeSchemaDefinitionInto(\n  target: SchemaDefinition,\n  incoming: SchemaDefinition,\n): void {\n  for (const [name, column] of Object.entries(incoming.columns)) {\n    if (!(name in target.columns)) {\n      target.columns[name] = column;\n    }\n  }\n  const indexes = new Map(target.indexes.map((index) => [index.name, index]));\n  for (const index of incoming.indexes) {\n    const existing = indexes.get(index.name);\n    if (!existing) {\n      const copy = { ...index };\n      indexes.set(index.name, copy);\n      target.indexes.push(copy);\n      continue;\n    }\n    if (\n      JSON.stringify(existing.columns) !== JSON.stringify(index.columns) ||\n      Boolean(existing.unique) !== Boolean(index.unique) ||\n      (existing.where || '') !== (index.where || '') ||\n      existing.jsonPath?.column !== index.jsonPath?.column ||\n      existing.jsonPath?.path !== index.jsonPath?.path ||\n      (existing.nullsNotDistinct !== undefined &&\n        index.nullsNotDistinct !== undefined &&\n        existing.nullsNotDistinct !== index.nullsNotDistinct)\n    ) {\n      throw new Error(\n        `Conflicting manifest index definitions for ${target.tableName}.${index.name}; regenerate all contributing package manifests before provisioning.`,\n      );\n    }\n    if (index.nullsNotDistinct !== undefined)\n      existing.nullsNotDistinct = index.nullsNotDistinct;\n  }\n  const foreignKeyKeys = new Set(\n    target.foreignKeys.map(\n      (foreignKey) =>\n        `${foreignKey.column}\\0${foreignKey.referencesTable}\\0${foreignKey.referencesColumn}`,\n    ),\n  );\n  for (const foreignKey of incoming.foreignKeys) {\n    const key = `${foreignKey.column}\\0${foreignKey.referencesTable}\\0${foreignKey.referencesColumn}`;\n    if (!foreignKeyKeys.has(key)) {\n      foreignKeyKeys.add(key);\n      target.foreignKeys.push(foreignKey);\n    }\n  }\n  target.dependencies = Array.from(\n    new Set([...target.dependencies, ...incoming.dependencies]),\n  ).sort();\n}\n\n/**\n * Collect manifest schemas into physical tables.\n *\n * Accepts the `schema` entries of manifest objects (any package, any manifest)\n * in encounter order and groups them by `tableName`, merging STI contributors\n * structurally. Objects without a `schema`/`tableName` are skipped by the\n * caller; objects with neither columns nor `ddl` are ignored here.\n */\nexport function collectManifestTables(\n  entries: Iterable<{ schema: ManifestSchemaLike; source: string }>,\n): Map<string, CollectedManifestTable> {\n  const tables = new Map<string, CollectedManifestTable>();\n  // Structured contributors whose cached ddl declares table constraints. Only\n  // a fully structured table drops them (a mixed table re-merges the string),\n  // so the warning is decided after collection.\n  const constraintCarriers = new Map<\n    string,\n    Array<{ source: string; constraints: string[] }>\n  >();\n\n  for (const { schema, source } of entries) {\n    if (!schema?.tableName) continue;\n    const definition = manifestSchemaToDefinition(schema);\n    const hasColumns = Object.keys(definition.columns).length > 0;\n    const ddl = typeof schema.ddl === 'string' ? schema.ddl : '';\n    if (!hasColumns && !ddl.trim()) continue;\n\n    if (hasColumns && ddl.trim()) {\n      const constraints = cachedDdlTableConstraints(ddl);\n      if (constraints.length > 0) {\n        const carriers = constraintCarriers.get(schema.tableName) ?? [];\n        carriers.push({ source, constraints });\n        constraintCarriers.set(schema.tableName, carriers);\n      }\n    }\n\n    const existing = tables.get(schema.tableName);\n    if (!existing) {\n      tables.set(schema.tableName, {\n        tableName: schema.tableName,\n        definition,\n        structured: hasColumns,\n        legacyDdl: ddl,\n        sources: [source],\n      });\n      continue;\n    }\n\n    mergeSchemaDefinitionInto(existing.definition, definition);\n    existing.structured = existing.structured && hasColumns;\n    existing.legacyDdl = existing.legacyDdl\n      ? ddl\n        ? mergeManifestDDL(existing.legacyDdl, ddl)\n        : existing.legacyDdl\n      : ddl;\n    existing.sources.push(source);\n  }\n\n  for (const [tableName, carriers] of constraintCarriers) {\n    if (!tables.get(tableName)?.structured) continue;\n    for (const { source, constraints } of carriers) {\n      warnAboutDroppedTableConstraints(tableName, source, constraints);\n    }\n  }\n\n  return tables;\n}\n\n/**\n * Render a collected table for one engine.\n *\n * Structured tables go through the engine strategy for the CREATE TABLE\n * (per-engine types, inline UNIQUE where the engine needs it) and for every\n * index (partial `WHERE`, JSON-path expressions, engine-specific syntax).\n * Tables with a column-less contributor keep that contributor's cached `ddl`\n * string, made minimally safe with `materializeManifestDDLForEngine`, merged\n * on top of the strategy render of any structured contributors — so a\n * structured STI base never loses its engine typing to a hand-authored\n * subclass, and the subclass's extra columns and table constraints survive.\n * Indexes always render through the strategy — the string never carried them.\n */\nexport function renderCollectedManifestTable(\n  table: CollectedManifestTable,\n  engine: DatabaseEngine,\n): EngineSpecificDDL {\n  const strategy = getDDLStrategy(engine);\n  const hasColumns = Object.keys(table.definition.columns).length > 0;\n  let createTable: string;\n  if (table.structured) {\n    createTable = strategy.generateCreateTable(table.definition);\n  } else if (hasColumns) {\n    createTable = mergeManifestDDL(\n      strategy.generateCreateTable(table.definition),\n      materializeManifestDDLForEngine(table.legacyDdl, engine),\n    );\n  } else {\n    createTable = materializeManifestDDLForEngine(table.legacyDdl, engine);\n  }\n\n  // Engines that need UNIQUE inline for ON CONFLICT (DuckDB, JSON) get it\n  // from `generateCreateTable` on the structured path and skip those indexes\n  // in `generateIndexes`. A cached string never carried them, so a table with\n  // a column-less contributor would lose its uniqueness entirely; append the\n  // missing constraints as table elements (deduplicated against any the\n  // string already declares).\n  if (!table.structured && strategy.requiresInlineUnique()) {\n    const uniqueElements = table.definition.indexes\n      .filter(\n        (index) =>\n          index.unique &&\n          !index.where &&\n          !index.jsonPath &&\n          index.columns.length > 0,\n      )\n      .map(\n        (index) =>\n          `UNIQUE(${index.columns.map((column) => quoteIdentifier(column)).join(', ')})`,\n      );\n    // Hand-authored strings may spell the same constraint without quotes\n    // (`UNIQUE(tenant_id)`); compare quote- and whitespace-insensitively so\n    // the synthesized element is not added beside it.\n    const declared = new Set(\n      cachedDdlTableConstraints(createTable).map(normalizeTableElement),\n    );\n    const missing = uniqueElements.filter(\n      (element) => !declared.has(normalizeTableElement(element)),\n    );\n    if (missing.length > 0) {\n      createTable = mergeManifestDDL(\n        createTable,\n        `CREATE TABLE ${quoteIdentifier(table.tableName)} (\\n  ${missing.join(',\\n  ')}\\n)`,\n      );\n    }\n  }\n\n  return {\n    createTable,\n    indexes: strategy.generateIndexes(table.definition),\n    triggers: strategy.generateTriggers(table.definition),\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Legacy cached-DDL string merge (column-less manifests only)\n// ---------------------------------------------------------------------------\n\nfunction parseDefinitionsFromDDL(ddl: string): {\n  columns: Map<string, string>;\n  tableElements: string[];\n} {\n  const columns = new Map<string, string>();\n  const tableElements: string[] = [];\n  const bodyRange = findCreateTableBodyRange(ddl);\n  if (!bodyRange) return { columns, tableElements };\n  const [bodyStart, bodyEnd] = bodyRange;\n\n  const segments = tokenizeSQLDDLBody(ddl.slice(bodyStart + 1, bodyEnd));\n\n  for (const segment of segments) {\n    const identifier = getSQLDefinitionIdentifier(segment);\n    if (!identifier) continue;\n    if (isSQLTableConstraintDefinition(segment)) {\n      tableElements.push(segment);\n      continue;\n    }\n\n    columns.set(identifier.name, segment);\n  }\n\n  return { columns, tableElements };\n}\n\n/**\n * Table-level constraints (`UNIQUE(...)`, `CHECK (...)`, `CONSTRAINT ...`,\n * ...) declared in a cached CREATE TABLE string. Structured `columns` cannot\n * represent them, so a structured render drops them — exactly as `db:migrate`\n * does. Exposed so callers can warn instead of losing them silently.\n *\n * @internal\n */\nexport function cachedDdlTableConstraints(ddl: string): string[] {\n  return parseDefinitionsFromDDL(ddl).tableElements;\n}\n\n/** Quote/whitespace/case-insensitive key for a table constraint element. */\nfunction normalizeTableElement(element: string): string {\n  return element.replace(/\"/g, '').replace(/\\s+/g, '').toLowerCase();\n}\n\nconst warnedDroppedConstraints = new Set<string>();\n\n/**\n * Warn once per process per table+source when a structured contributor's\n * cached `ddl` declares table constraints that the structured render cannot\n * carry. The structured schema is authoritative: a constraint that lives only\n * in the string never reaches `db:migrate` either, so rendering it here would\n * recreate the test/production drift #2358 removes.\n */\nfunction warnAboutDroppedTableConstraints(\n  tableName: string,\n  source: string,\n  constraints: string[],\n): void {\n  const key = `${tableName}\\0${source}`;\n  if (warnedDroppedConstraints.has(key)) return;\n  warnedDroppedConstraints.add(key);\n  logger.warn(\n    `[manifest-schema] ${source}: cached ddl for table \"${tableName}\" declares ` +\n      `${constraints.length} table constraint(s) that structured columns cannot ` +\n      `carry (${constraints.join('; ')}). They are not rendered — the ` +\n      `structured schema is authoritative (#2358). Declare uniqueness through ` +\n      `indexes/conflictColumns or a column-level constraint instead.`,\n  );\n}\n\n/**\n * Merge two cached CREATE TABLE strings for the same table (STI subclasses):\n * the union of columns, existing definitions winning, new columns inserted\n * before any trailing table constraints, missing table constraints appended.\n *\n * Only the legacy column-less manifest path uses this; structured manifests\n * merge through `mergeSchemaDefinitionInto`.\n */\nfunction mergeManifestDDL(existingDDL: string, newDDL: string): string {\n  const existingDefinitions = parseDefinitionsFromDDL(existingDDL);\n  const newDefinitions = parseDefinitionsFromDDL(newDDL);\n\n  const missingCols: string[] = [];\n  for (const [name, def] of newDefinitions.columns) {\n    if (!existingDefinitions.columns.has(name)) {\n      missingCols.push(def);\n    }\n  }\n\n  const existingTableElements = new Set(\n    existingDefinitions.tableElements.map(getSQLDefinitionComparisonKey),\n  );\n  const missingTableElements = newDefinitions.tableElements.filter(\n    (definition) =>\n      !existingTableElements.has(getSQLDefinitionComparisonKey(definition)),\n  );\n\n  if (missingCols.length === 0 && missingTableElements.length === 0) {\n    return existingDDL;\n  }\n\n  const bodyRange = findCreateTableBodyRange(existingDDL);\n  if (!bodyRange) return existingDDL;\n  const [bodyStart, bodyEnd] = bodyRange;\n  const prefix = existingDDL.slice(0, bodyStart + 1);\n  const body = existingDDL.slice(bodyStart + 1, bodyEnd);\n  const suffix = existingDDL.slice(bodyEnd);\n  const segments = tokenizeSQLDDLBody(body);\n  const firstConstraintIndex = segments.findIndex((segment) =>\n    isSQLTableConstraintDefinition(segment),\n  );\n  const insertionIndex =\n    firstConstraintIndex === -1 ? segments.length : firstConstraintIndex;\n  const mergedSegments = [\n    ...segments.slice(0, insertionIndex),\n    ...missingCols,\n    ...segments.slice(insertionIndex),\n    ...missingTableElements,\n  ];\n\n  return `${prefix}\\n${mergedSegments.map((segment) => `  ${segment}`).join(',\\n')}\\n${suffix}`;\n}\n"],"mappings":"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"}

package/dist/schema/schema-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-manager.d.ts","sourceRoot":"","sources":["../../src/schema/schema-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,iBAAiB,EAEvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,sBAAsB,EAK5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAqBzE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAuB;IAGtC,OAAO,CAAC,MAAM,CAAkC;gBAEpC,EAAE,EAAE,iBAAiB,EAAE,OAAO,GAAE,oBAAyB;IAkBrE;;;;;;;OAOG;IACG,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmH1D;;;;;;;;;OASG;YACW,kBAAkB;IAwChC;;;;;;;;;;;;;OAaG;YACW,iBAAiB;IAqE/B,OAAO,CAAC,eAAe;IAIvB;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9D;;;;;;OAMG;IACG,wBAAwB,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,EAChC,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,YAAY,CAAC,EAAE,sBAAsB,CAAC;KAClC,GACL,OAAO,CAAC,IAAI,CAAC;IAuGhB;;;;;;OAMG;YACW,0BAA0B;IA4BxC;;;;;;OAMG;IACH,OAAO,CAAC,qCAAqC;IA0B7C,OAAO,CAAC,4BAA4B;IAOpC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB;IASxD;;OAEG;IACH,SAAS,IAAI,cAAc;CAG5B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,iBAAiB,EACrB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CAEf"}
+{"version":3,"file":"schema-manager.d.ts","sourceRoot":"","sources":["../../src/schema/schema-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,iBAAiB,EAEvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,sBAAsB,EAK5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAqBzE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAuB;IAGtC,OAAO,CAAC,MAAM,CAAkC;gBAEpC,EAAE,EAAE,iBAAiB,EAAE,OAAO,GAAE,oBAAyB;IAkBrE;;;;;;;OAOG;IACG,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqH1D;;;;;;;;;OASG;YACW,kBAAkB;IAwChC;;;;;;;;;;;;;OAaG;YACW,iBAAiB;IAqE/B,OAAO,CAAC,eAAe;IAIvB;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9D;;;;;;OAMG;IACG,wBAAwB,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,EAChC,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,YAAY,CAAC,EAAE,sBAAsB,CAAC;KAClC,GACL,OAAO,CAAC,IAAI,CAAC;IAuGhB;;;;;;OAMG;YACW,0BAA0B;IA4BxC;;;;;;OAMG;IACH,OAAO,CAAC,qCAAqC;IA0B7C,OAAO,CAAC,4BAA4B;IAOpC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB;IASxD;;OAEG;IACH,SAAS,IAAI,cAAc;CAG5B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,iBAAiB,EACrB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CAEf"}

package/dist/schema/schema-manager.js

@@ -66,7 +66,7 @@ var SchemaManager = class {
 			triggers: strategy.generateTriggers(schema)
 		};
 		const dbWithSync = this.db;
-		if (dbWithSync.syncSchema) {
+		if (dbWithSync.syncSchema && this.engine !== "postgres") {
 			const fullSchema = [
 				ddl.createTable,
 				...ddl.indexes,

package/dist/schema/schema-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-manager.js","names":[],"sources":["../../src/schema/schema-manager.ts"],"sourcesContent":["/**\n * Schema Manager - Direct DDL Execution for SMRT\n *\n * SMRT handles ALL database maintenance directly.\n * SDK SQL remains a pure query/CRUD layer.\n *\n * This module replaces the use of SDK's syncSchema() with direct DDL execution\n * using engine-specific DDL strategies.\n */\n\nimport { createLogger } from '@happyvertical/logger';\nimport type { DatabaseInterface } from '@happyvertical/sql';\nimport {\n  type DatabaseEngine,\n  detectEngine,\n  type EngineSpecificDDL,\n  getDDLStrategy,\n} from './ddl/index.js';\nimport {\n  type ForeignKeyUuidCastSide,\n  foreignKeyConstraintName,\n  renderForeignKeyConstraint,\n  renderForeignKeyOrphanDetector,\n  renderForeignKeyOrphanRepair,\n} from './foreign-key-ddl.js';\nimport { planForeignKeyCreation } from './foreign-key-planner.js';\nimport type { ForeignKeyDefinition, SchemaDefinition } from './types.js';\nimport {\n  describeForeignKeyTypeConflict,\n  renderUuidConvergenceRepairHint,\n} from './uuid-convergence.js';\n\n/**\n * Normalize a `db.query` result into an array of rows.\n *\n * Adapters return either a bare row array or a `{ rows }` envelope. This\n * mirrors the prior inline `Array.isArray(result) ? result : result?.rows ?? []`\n * narrowing while keeping the row shape typed for callers.\n */\nfunction extractRows<Row>(result: unknown): Row[] {\n  if (Array.isArray(result)) {\n    return result as Row[];\n  }\n  const rows = (result as { rows?: unknown } | null | undefined)?.rows;\n  return Array.isArray(rows) ? (rows as Row[]) : [];\n}\n\n/**\n * Schema Manager Options\n */\nexport interface SchemaManagerOptions {\n  /** Force engine type (overrides auto-detection) */\n  engine?: DatabaseEngine;\n  /** Whether to skip triggers (useful for DuckDB-backed JSON) */\n  skipTriggers?: boolean;\n  /** Log DDL statements before execution */\n  debug?: boolean;\n}\n\n/**\n * Schema Manager\n *\n * Handles direct DDL execution for database schema management.\n * Replaces SDK's syncSchema() with SMRT-controlled schema creation.\n */\nexport class SchemaManager {\n  private db: DatabaseInterface;\n  private engine: DatabaseEngine;\n  private options: SchemaManagerOptions;\n  // Per-instance logger: the `debug` option must actually emit debug traces, so\n  // the level follows it (a fixed level: 'info' would filter every debug call).\n  private logger: ReturnType<typeof createLogger>;\n\n  constructor(db: DatabaseInterface, options: SchemaManagerOptions = {}) {\n    this.db = db;\n    this.options = options;\n    this.logger = createLogger({ level: options.debug ? 'debug' : 'info' });\n\n    // Detect or use provided engine\n    if (options.engine) {\n      this.engine = options.engine;\n    } else if ((db as { exportTable?: unknown }).exportTable) {\n      // JSON adapter detected (has unique exportTable method)\n      // JSON adapter uses DuckDB internally, but native UUID values do not\n      // round-trip through the SDK row objects as canonical UUID strings.\n      this.engine = 'json';\n    } else {\n      this.engine = detectEngine(db.url);\n    }\n  }\n\n  /**\n   * Ensure a table exists with the correct schema\n   *\n   * If table doesn't exist, creates it with DDL from the engine-specific strategy.\n   * If table exists but is missing columns, adds them via ALTER TABLE ADD COLUMN.\n   *\n   * @param schema - The schema definition\n   */\n  async ensureTable(schema: SchemaDefinition): Promise<void> {\n    const { tableName } = schema;\n\n    // Check if table already exists\n    const exists = await this.db.tableExists(tableName);\n    if (exists) {\n      // Table exists — check for missing columns and add them\n      // This handles the case where a table was created with a partial schema\n      // (e.g., base SmrtObject fields only) and needs additional columns\n      await this.addMissingColumns(tableName, schema);\n\n      if (this.options.debug) {\n        this.logger.debug(\n          `[SchemaManager] Table \"${tableName}\" already exists, checked for missing columns`,\n        );\n      }\n      return;\n    }\n\n    // Generate DDL using engine-specific strategy\n    const strategy = getDDLStrategy(this.engine);\n    const ddl: EngineSpecificDDL = {\n      createTable: strategy.generateCreateTable(schema),\n      indexes: strategy.generateIndexes(schema),\n      triggers: strategy.generateTriggers(schema),\n    };\n\n    // Prefer adapter's syncSchema if available (handles adapter-specific transformations)\n    // This is critical for JSON adapter which needs to convert UNIQUE indexes to\n    // inline constraints for DuckDB compatibility\n    // Adapters that support direct DDL sync expose an optional `syncSchema`\n    // method beyond the base `DatabaseInterface`; narrow to it here so both the\n    // capability check and the call preserve `this.db` as the receiver.\n    const dbWithSync = this.db as DatabaseInterface & {\n      syncSchema?: (schema: string) => Promise<void>;\n    };\n    if (dbWithSync.syncSchema) {\n      // Combine DDL into single schema string for adapter's syncSchema\n      const fullSchema = [\n        ddl.createTable,\n        ...ddl.indexes,\n        ...(this.options.skipTriggers ? [] : ddl.triggers),\n      ].join(';\\n');\n\n      if (this.options.debug) {\n        this.logger.debug(\n          `[SchemaManager] Using adapter syncSchema for \"${tableName}\"`,\n          { fullSchema },\n        );\n      }\n\n      try {\n        await dbWithSync.syncSchema(fullSchema);\n\n        // FIX #735: Verify table was actually created\n        // Some adapters (notably PostgreSQL) may silently fail to create tables\n        // when syncSchema returns without error but doesn't execute the DDL\n        const createdSuccessfully = await this.db.tableExists(tableName);\n        if (createdSuccessfully) {\n          if (this.options.debug) {\n            this.logger.debug(\n              `[SchemaManager] Table \"${tableName}\" created via adapter syncSchema`,\n            );\n          }\n          return;\n        }\n\n        // Table wasn't created - fall through to direct DDL execution\n        this.logger.warn(\n          `[SchemaManager] syncSchema returned but table \"${tableName}\" doesn't exist, falling back to direct DDL`,\n        );\n      } catch (syncError) {\n        // syncSchema failed - fall through to direct DDL execution\n        this.logger.warn(\n          `[SchemaManager] syncSchema failed for \"${tableName}\", falling back to direct DDL`,\n          { error: syncError },\n        );\n      }\n    }\n\n    // Fallback: Execute DDL directly (for adapters without syncSchema)\n    if (this.options.debug) {\n      this.logger.debug(\n        `[SchemaManager] Creating table \"${tableName}\" for ${this.engine} (direct DDL)`,\n        { createTable: ddl.createTable },\n      );\n    }\n\n    await this.db.query(ddl.createTable);\n\n    // Execute indexes\n    for (const indexSQL of ddl.indexes) {\n      if (this.options.debug) {\n        this.logger.debug(`[SchemaManager] Creating index`, { indexSQL });\n      }\n      await this.db.query(indexSQL);\n    }\n\n    // Execute triggers (unless skipped)\n    if (!this.options.skipTriggers) {\n      for (const triggerSQL of ddl.triggers) {\n        if (this.options.debug) {\n          this.logger.debug(`[SchemaManager] Creating trigger`, { triggerSQL });\n        }\n        await this.db.query(triggerSQL);\n      }\n    }\n\n    if (this.options.debug) {\n      this.logger.debug(\n        `[SchemaManager] Table \"${tableName}\" created successfully`,\n      );\n    }\n  }\n\n  /**\n   * Get existing column names from a database table\n   *\n   * Uses engine-appropriate introspection:\n   * - SQLite/DuckDB: PRAGMA table_info\n   * - PostgreSQL: pg_catalog.pg_attribute for the exact search-path relation\n   *\n   * @param tableName - Name of the table to inspect\n   * @returns Set of existing column names with catalog identifier case preserved\n   */\n  private async getExistingColumns(tableName: string): Promise<Set<string>> {\n    const columns = new Set<string>();\n\n    try {\n      if (this.engine === 'postgres') {\n        const result = await this.db.query(\n          `SELECT attribute.attname AS column_name\n           FROM pg_attribute AS attribute\n           WHERE attribute.attrelid = to_regclass(format('%I', $1::text))\n             AND attribute.attnum > 0\n             AND NOT attribute.attisdropped`,\n          tableName,\n        );\n        const rows = extractRows<{ column_name: string }>(result);\n        for (const row of rows) {\n          columns.add(row.column_name);\n        }\n      } else {\n        // SQLite and DuckDB use PRAGMA\n        const result = await this.db.query(\n          `PRAGMA table_info(${this.quoteIdentifier(tableName)})`,\n        );\n        const rows = extractRows<{ name: string }>(result);\n        for (const row of rows) {\n          columns.add(row.name);\n        }\n      }\n    } catch (error) {\n      // If introspection fails, return empty set (no columns will be added)\n      if (this.options.debug) {\n        this.logger.warn(\n          `[SchemaManager] Failed to introspect columns for \"${tableName}\"`,\n          { error },\n        );\n      }\n    }\n\n    return columns;\n  }\n\n  /**\n   * Add missing columns to an existing table via ALTER TABLE ADD COLUMN\n   *\n   * Compares the schema's expected columns against the table's actual columns\n   * and adds any that are missing. This handles the race condition where a table\n   * is created with base fields by one code path, then a later code path needs\n   * additional columns from a more complete schema.\n   *\n   * SQLite limitation: ALTER TABLE ADD COLUMN cannot add NOT NULL columns\n   * without a DEFAULT value. We relax NOT NULL for such columns.\n   *\n   * @param tableName - Name of the existing table\n   * @param schema - The full schema definition with expected columns\n   */\n  private async addMissingColumns(\n    tableName: string,\n    schema: SchemaDefinition,\n  ): Promise<void> {\n    if (!schema.columns || Object.keys(schema.columns).length === 0) {\n      return;\n    }\n\n    const existingColumns = await this.getExistingColumns(tableName);\n    if (existingColumns.size === 0) {\n      // Introspection failed or returned no columns — skip to avoid errors\n      return;\n    }\n\n    const strategy = getDDLStrategy(this.engine);\n    let addedCount = 0;\n\n    for (const [colName, colDef] of Object.entries(schema.columns)) {\n      if (existingColumns.has(colName)) {\n        continue; // Column already exists\n      }\n\n      // SQLite limitation: ALTER TABLE ADD COLUMN cannot have NOT NULL\n      // without a DEFAULT value. Relax NOT NULL for such columns.\n      const safeDef = { ...colDef };\n      if (\n        safeDef.notNull &&\n        safeDef.defaultValue === undefined &&\n        !safeDef.primaryKey\n      ) {\n        safeDef.notNull = false;\n      }\n\n      // Cannot add PRIMARY KEY columns via ALTER TABLE\n      if (safeDef.primaryKey) {\n        continue;\n      }\n\n      const colSQL = strategy.generateColumnDefinition(colName, safeDef);\n      const alterSQL = `ALTER TABLE ${this.quoteIdentifier(tableName)} ADD COLUMN ${colSQL}`;\n\n      try {\n        await this.db.query(alterSQL);\n        addedCount++;\n\n        if (this.options.debug) {\n          this.logger.debug(\n            `[SchemaManager] Added column \"${colName}\" to \"${tableName}\"`,\n          );\n        }\n      } catch (error) {\n        // Column might already exist (race condition) or other issue\n        // Log and continue — don't fail the entire operation\n        if (this.options.debug) {\n          this.logger.warn(\n            `[SchemaManager] Failed to add column \"${colName}\" to \"${tableName}\"`,\n            { error },\n          );\n        }\n      }\n    }\n\n    if (addedCount > 0 && this.options.debug) {\n      this.logger.debug(\n        `[SchemaManager] Added ${addedCount} missing column(s) to \"${tableName}\"`,\n      );\n    }\n  }\n\n  private quoteIdentifier(name: string): string {\n    return `\"${name.replace(/\"/g, '\"\"')}\"`;\n  }\n\n  /**\n   * Create multiple tables with dependency ordering\n   *\n   * @param schemas - Array of schema definitions\n   */\n  async ensureTables(schemas: SchemaDefinition[]): Promise<void> {\n    const plan = planForeignKeyCreation(schemas, this.engine);\n    const schemasByTable = new Map(\n      schemas.map((schema) => [schema.tableName, schema]),\n    );\n\n    for (const schema of plan.schemas) {\n      await this.ensureTable(schema);\n    }\n    for (const { table, foreignKey } of plan.deferredConstraints) {\n      const source = schemasByTable.get(table);\n      const target = schemasByTable.get(foreignKey.referencesTable);\n      await this.ensurePostgresForeignKey(table, foreignKey, {\n        nullable: source?.columns[foreignKey.column]?.notNull !== true,\n        uuidComparison:\n          source?.columns[foreignKey.column]?.type === 'UUID' &&\n          target?.columns[foreignKey.referencesColumn]?.type === 'UUID',\n      });\n    }\n  }\n\n  /**\n   * Safely add or validate one PostgreSQL foreign key.\n   *\n   * Existing rows are probed with the canonical exact-column orphan detector\n   * before an absent constraint is added as NOT VALID and then explicitly\n   * validated. Existing NOT VALID constraints follow the same preflight.\n   */\n  async ensurePostgresForeignKey(\n    tableName: string,\n    foreignKey: ForeignKeyDefinition,\n    options: {\n      nullable?: boolean;\n      uuidComparison?: boolean;\n      uuidCastSide?: ForeignKeyUuidCastSide;\n    } = {},\n  ): Promise<void> {\n    const constraintName = foreignKeyConstraintName(tableName, foreignKey);\n    let existing: unknown;\n    try {\n      existing = await this.db.query(\n        `SELECT constraint_row.convalidated FROM pg_constraint AS constraint_row JOIN pg_class AS table_row ON table_row.oid = constraint_row.conrelid JOIN pg_namespace AS namespace_row ON namespace_row.oid = table_row.relnamespace WHERE table_row.relname = $1 AND namespace_row.nspname = current_schema() AND constraint_row.conname = $2 AND constraint_row.contype = 'f' LIMIT 1`,\n        [tableName, constraintName],\n      );\n    } catch (error) {\n      throw new Error(\n        `[SchemaManager] Cannot verify deferred foreign key ${constraintName}; refusing an unsafe duplicate/add attempt: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error },\n      );\n    }\n    const existingRows = extractRows<{ convalidated?: boolean }>(existing);\n    if (existingRows[0]?.convalidated === true) return;\n\n    // #2608: PostgreSQL cannot implement a FOREIGN KEY whose child and parent\n    // columns have different physical types — FK DDL admits no cast — so the\n    // ADD CONSTRAINT below would fail with SQLSTATE 42804 and abort every\n    // later statement in the batch. Fail closed *before* the orphan probe:\n    // across mismatched types a probe answers a question about casted values,\n    // not about the constraint we are refusing to add, and it must be re-run\n    // after the columns converge anyway.\n    const liveTypes = await this.resolveLiveForeignKeyTypes(\n      tableName,\n      foreignKey,\n    );\n    if (liveTypes && liveTypes.childNormalized !== liveTypes.parentNormalized) {\n      const conflict = describeForeignKeyTypeConflict({\n        childTable: tableName,\n        childColumn: foreignKey.column,\n        childType: liveTypes.childType,\n        parentTable: foreignKey.referencesTable,\n        parentColumn: foreignKey.referencesColumn,\n        parentType: liveTypes.parentType,\n      });\n      // The uuid convergence is only the right repair for a relationship the\n      // manifest declares UUID on both sides (`options.uuidComparison`) and\n      // whose live drift is actually a legacy `text` column. Any other\n      // incompatible pair reaches this guard too, and a `USING …::uuid` hint\n      // there would be wrong — name the two live types instead.\n      const textNodes = options.uuidComparison\n        ? [\n            liveTypes.childNormalized === 'TEXT'\n              ? { table: tableName, column: foreignKey.column }\n              : undefined,\n            liveTypes.parentNormalized === 'TEXT'\n              ? {\n                  table: foreignKey.referencesTable,\n                  column: foreignKey.referencesColumn,\n                }\n              : undefined,\n          ].filter((node) => node !== undefined)\n        : [];\n      const repair =\n        textNodes.length > 0\n          ? ` Suggested repair: ${renderUuidConvergenceRepairHint(textNodes).join('; ')}`\n          : ` Align ${tableName}.${foreignKey.column} (${liveTypes.childType}) and ` +\n            `${foreignKey.referencesTable}.${foreignKey.referencesColumn} (${liveTypes.parentType}) ` +\n            'on one physical type deliberately, then retry.';\n      throw new Error(\n        `[SchemaManager] Cannot add ${constraintName}: incompatible column types. ` +\n          `${conflict}. Converge the columns first, then retry.${repair}`,\n      );\n    }\n\n    const probeOptions = this.resolvePostgresForeignKeyProbeOptions(\n      options,\n      liveTypes,\n    );\n\n    const detector = renderForeignKeyOrphanDetector(tableName, foreignKey, {\n      engine: 'postgres',\n      limitOne: true,\n      uuidComparison: probeOptions.uuidComparison,\n      uuidCastSide: probeOptions.uuidCastSide,\n    });\n    let orphanResult: unknown;\n    try {\n      orphanResult = await this.db.query(detector);\n    } catch (error) {\n      throw new Error(\n        `[SchemaManager] Cannot probe ${tableName}.${foreignKey.column} for orphan rows; refusing to add ${constraintName}. Run the detector manually: ${detector}`,\n        { cause: error },\n      );\n    }\n    if (extractRows(orphanResult).length > 0) {\n      throw new Error(\n        `[SchemaManager] Cannot add ${constraintName}: existing rows do not match ${foreignKey.referencesTable}.${foreignKey.referencesColumn}. Repair them, then retry. Suggested repair: ${renderForeignKeyOrphanRepair(tableName, foreignKey, { engine: 'postgres', nullable: probeOptions.nullable, uuidComparison: probeOptions.uuidComparison, uuidCastSide: probeOptions.uuidCastSide })}`,\n      );\n    }\n\n    if (existingRows.length === 0) {\n      await this.db.query(\n        `ALTER TABLE ${this.quoteIdentifier(tableName)} ADD ${renderForeignKeyConstraint(tableName, foreignKey)} NOT VALID`,\n      );\n    }\n    await this.db.query(\n      `ALTER TABLE ${this.quoteIdentifier(tableName)} VALIDATE CONSTRAINT ${this.quoteIdentifier(constraintName)}`,\n    );\n  }\n\n  /**\n   * Read the live physical types of one child/parent column pair.\n   *\n   * Returns `undefined` when either side cannot be introspected (adapter\n   * without `getTableSchema`, table not created yet) — callers then keep the\n   * pre-#2608 behaviour rather than guessing at a mismatch.\n   */\n  private async resolveLiveForeignKeyTypes(\n    tableName: string,\n    foreignKey: ForeignKeyDefinition,\n  ): Promise<\n    | {\n        childType: string;\n        parentType: string;\n        childNormalized: string;\n        parentNormalized: string;\n      }\n    | undefined\n  > {\n    const childSchema = await this.db.getTableSchema?.(tableName);\n    const parentSchema =\n      foreignKey.referencesTable === tableName\n        ? childSchema\n        : await this.db.getTableSchema?.(foreignKey.referencesTable);\n    const childType = childSchema?.columns[foreignKey.column]?.type;\n    const parentType = parentSchema?.columns[foreignKey.referencesColumn]?.type;\n    if (!childType || !parentType) return undefined;\n    return {\n      childType,\n      parentType,\n      childNormalized: this.normalizeForeignKeyProbeType(childType),\n      parentNormalized: this.normalizeForeignKeyProbeType(parentType),\n    };\n  }\n\n  /**\n   * Classify which side of an orphan probe needs a guarded uuid cast.\n   *\n   * Only reachable with matching live types while the #2608 guard rejects\n   * every mismatch, but the classification stays correct for callers that\n   * reuse the helper with an unguarded pair.\n   */\n  private resolvePostgresForeignKeyProbeOptions(\n    options: {\n      nullable?: boolean;\n      uuidComparison?: boolean;\n      uuidCastSide?: ForeignKeyUuidCastSide;\n    },\n    liveTypes?: Awaited<\n      ReturnType<SchemaManager['resolveLiveForeignKeyTypes']>\n    >,\n  ): typeof options {\n    if (!options.uuidComparison || options.uuidCastSide) return options;\n    if (!liveTypes) return options;\n\n    const { childNormalized, parentNormalized } = liveTypes;\n    if (childNormalized === parentNormalized) {\n      return { ...options, uuidCastSide: 'none' };\n    }\n    if (childNormalized === 'UUID') {\n      return { ...options, uuidCastSide: 'parent' };\n    }\n    if (parentNormalized === 'UUID') {\n      return { ...options, uuidCastSide: 'child' };\n    }\n    return { ...options, uuidCastSide: 'both' };\n  }\n\n  private normalizeForeignKeyProbeType(type: string): string {\n    const upper = type.toUpperCase().trim();\n    if (/^UUID$/i.test(upper)) return 'UUID';\n    if (/^(TEXT|CLOB|STRING|VARCHAR|CHAR)/i.test(upper)) return 'TEXT';\n    return upper;\n  }\n\n  /**\n   * Generate DDL without executing (useful for debugging/preview)\n   *\n   * @param schema - The schema definition\n   * @returns Engine-specific DDL\n   */\n  generateDDL(schema: SchemaDefinition): EngineSpecificDDL {\n    const strategy = getDDLStrategy(this.engine);\n    return {\n      createTable: strategy.generateCreateTable(schema),\n      indexes: strategy.generateIndexes(schema),\n      triggers: strategy.generateTriggers(schema),\n    };\n  }\n\n  /**\n   * Get the detected/configured database engine\n   */\n  getEngine(): DatabaseEngine {\n    return this.engine;\n  }\n}\n\n/**\n * Create a SchemaManager instance\n *\n * @param db - Database interface\n * @param options - Optional configuration\n * @returns SchemaManager instance\n */\nexport function createSchemaManager(\n  db: DatabaseInterface,\n  options?: SchemaManagerOptions,\n): SchemaManager {\n  return new SchemaManager(db, options);\n}\n"],"mappings":"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"}
+{"version":3,"file":"schema-manager.js","names":[],"sources":["../../src/schema/schema-manager.ts"],"sourcesContent":["/**\n * Schema Manager - Direct DDL Execution for SMRT\n *\n * SMRT handles ALL database maintenance directly.\n * SDK SQL remains a pure query/CRUD layer.\n *\n * This module replaces the use of SDK's syncSchema() with direct DDL execution\n * using engine-specific DDL strategies.\n */\n\nimport { createLogger } from '@happyvertical/logger';\nimport type { DatabaseInterface } from '@happyvertical/sql';\nimport {\n  type DatabaseEngine,\n  detectEngine,\n  type EngineSpecificDDL,\n  getDDLStrategy,\n} from './ddl/index.js';\nimport {\n  type ForeignKeyUuidCastSide,\n  foreignKeyConstraintName,\n  renderForeignKeyConstraint,\n  renderForeignKeyOrphanDetector,\n  renderForeignKeyOrphanRepair,\n} from './foreign-key-ddl.js';\nimport { planForeignKeyCreation } from './foreign-key-planner.js';\nimport type { ForeignKeyDefinition, SchemaDefinition } from './types.js';\nimport {\n  describeForeignKeyTypeConflict,\n  renderUuidConvergenceRepairHint,\n} from './uuid-convergence.js';\n\n/**\n * Normalize a `db.query` result into an array of rows.\n *\n * Adapters return either a bare row array or a `{ rows }` envelope. This\n * mirrors the prior inline `Array.isArray(result) ? result : result?.rows ?? []`\n * narrowing while keeping the row shape typed for callers.\n */\nfunction extractRows<Row>(result: unknown): Row[] {\n  if (Array.isArray(result)) {\n    return result as Row[];\n  }\n  const rows = (result as { rows?: unknown } | null | undefined)?.rows;\n  return Array.isArray(rows) ? (rows as Row[]) : [];\n}\n\n/**\n * Schema Manager Options\n */\nexport interface SchemaManagerOptions {\n  /** Force engine type (overrides auto-detection) */\n  engine?: DatabaseEngine;\n  /** Whether to skip triggers (useful for DuckDB-backed JSON) */\n  skipTriggers?: boolean;\n  /** Log DDL statements before execution */\n  debug?: boolean;\n}\n\n/**\n * Schema Manager\n *\n * Handles direct DDL execution for database schema management.\n * Replaces SDK's syncSchema() with SMRT-controlled schema creation.\n */\nexport class SchemaManager {\n  private db: DatabaseInterface;\n  private engine: DatabaseEngine;\n  private options: SchemaManagerOptions;\n  // Per-instance logger: the `debug` option must actually emit debug traces, so\n  // the level follows it (a fixed level: 'info' would filter every debug call).\n  private logger: ReturnType<typeof createLogger>;\n\n  constructor(db: DatabaseInterface, options: SchemaManagerOptions = {}) {\n    this.db = db;\n    this.options = options;\n    this.logger = createLogger({ level: options.debug ? 'debug' : 'info' });\n\n    // Detect or use provided engine\n    if (options.engine) {\n      this.engine = options.engine;\n    } else if ((db as { exportTable?: unknown }).exportTable) {\n      // JSON adapter detected (has unique exportTable method)\n      // JSON adapter uses DuckDB internally, but native UUID values do not\n      // round-trip through the SDK row objects as canonical UUID strings.\n      this.engine = 'json';\n    } else {\n      this.engine = detectEngine(db.url);\n    }\n  }\n\n  /**\n   * Ensure a table exists with the correct schema\n   *\n   * If table doesn't exist, creates it with DDL from the engine-specific strategy.\n   * If table exists but is missing columns, adds them via ALTER TABLE ADD COLUMN.\n   *\n   * @param schema - The schema definition\n   */\n  async ensureTable(schema: SchemaDefinition): Promise<void> {\n    const { tableName } = schema;\n\n    // Check if table already exists\n    const exists = await this.db.tableExists(tableName);\n    if (exists) {\n      // Table exists — check for missing columns and add them\n      // This handles the case where a table was created with a partial schema\n      // (e.g., base SmrtObject fields only) and needs additional columns\n      await this.addMissingColumns(tableName, schema);\n\n      if (this.options.debug) {\n        this.logger.debug(\n          `[SchemaManager] Table \"${tableName}\" already exists, checked for missing columns`,\n        );\n      }\n      return;\n    }\n\n    // Generate DDL using engine-specific strategy\n    const strategy = getDDLStrategy(this.engine);\n    const ddl: EngineSpecificDDL = {\n      createTable: strategy.generateCreateTable(schema),\n      indexes: strategy.generateIndexes(schema),\n      triggers: strategy.generateTriggers(schema),\n    };\n\n    // Prefer adapter's syncSchema if available (handles adapter-specific transformations)\n    // This is critical for JSON adapter which needs to convert UNIQUE indexes to\n    // inline constraints for DuckDB compatibility\n    // Adapters that support direct DDL sync expose an optional `syncSchema`\n    // method beyond the base `DatabaseInterface`; narrow to it here so both the\n    // capability check and the call preserve `this.db` as the receiver.\n    const dbWithSync = this.db as DatabaseInterface & {\n      syncSchema?: (schema: string) => Promise<void>;\n    };\n    // PostgreSQL schema blocks must remain intact: the SDK syncSchema splitter\n    // separates on semicolons inside version-gated DO blocks (#2834).\n    if (dbWithSync.syncSchema && this.engine !== 'postgres') {\n      // Combine DDL into single schema string for adapter's syncSchema\n      const fullSchema = [\n        ddl.createTable,\n        ...ddl.indexes,\n        ...(this.options.skipTriggers ? [] : ddl.triggers),\n      ].join(';\\n');\n\n      if (this.options.debug) {\n        this.logger.debug(\n          `[SchemaManager] Using adapter syncSchema for \"${tableName}\"`,\n          { fullSchema },\n        );\n      }\n\n      try {\n        await dbWithSync.syncSchema(fullSchema);\n\n        // FIX #735: Verify table was actually created\n        // Some adapters (notably PostgreSQL) may silently fail to create tables\n        // when syncSchema returns without error but doesn't execute the DDL\n        const createdSuccessfully = await this.db.tableExists(tableName);\n        if (createdSuccessfully) {\n          if (this.options.debug) {\n            this.logger.debug(\n              `[SchemaManager] Table \"${tableName}\" created via adapter syncSchema`,\n            );\n          }\n          return;\n        }\n\n        // Table wasn't created - fall through to direct DDL execution\n        this.logger.warn(\n          `[SchemaManager] syncSchema returned but table \"${tableName}\" doesn't exist, falling back to direct DDL`,\n        );\n      } catch (syncError) {\n        // syncSchema failed - fall through to direct DDL execution\n        this.logger.warn(\n          `[SchemaManager] syncSchema failed for \"${tableName}\", falling back to direct DDL`,\n          { error: syncError },\n        );\n      }\n    }\n\n    // Fallback: Execute DDL directly (for adapters without syncSchema)\n    if (this.options.debug) {\n      this.logger.debug(\n        `[SchemaManager] Creating table \"${tableName}\" for ${this.engine} (direct DDL)`,\n        { createTable: ddl.createTable },\n      );\n    }\n\n    await this.db.query(ddl.createTable);\n\n    // Execute indexes\n    for (const indexSQL of ddl.indexes) {\n      if (this.options.debug) {\n        this.logger.debug(`[SchemaManager] Creating index`, { indexSQL });\n      }\n      await this.db.query(indexSQL);\n    }\n\n    // Execute triggers (unless skipped)\n    if (!this.options.skipTriggers) {\n      for (const triggerSQL of ddl.triggers) {\n        if (this.options.debug) {\n          this.logger.debug(`[SchemaManager] Creating trigger`, { triggerSQL });\n        }\n        await this.db.query(triggerSQL);\n      }\n    }\n\n    if (this.options.debug) {\n      this.logger.debug(\n        `[SchemaManager] Table \"${tableName}\" created successfully`,\n      );\n    }\n  }\n\n  /**\n   * Get existing column names from a database table\n   *\n   * Uses engine-appropriate introspection:\n   * - SQLite/DuckDB: PRAGMA table_info\n   * - PostgreSQL: pg_catalog.pg_attribute for the exact search-path relation\n   *\n   * @param tableName - Name of the table to inspect\n   * @returns Set of existing column names with catalog identifier case preserved\n   */\n  private async getExistingColumns(tableName: string): Promise<Set<string>> {\n    const columns = new Set<string>();\n\n    try {\n      if (this.engine === 'postgres') {\n        const result = await this.db.query(\n          `SELECT attribute.attname AS column_name\n           FROM pg_attribute AS attribute\n           WHERE attribute.attrelid = to_regclass(format('%I', $1::text))\n             AND attribute.attnum > 0\n             AND NOT attribute.attisdropped`,\n          tableName,\n        );\n        const rows = extractRows<{ column_name: string }>(result);\n        for (const row of rows) {\n          columns.add(row.column_name);\n        }\n      } else {\n        // SQLite and DuckDB use PRAGMA\n        const result = await this.db.query(\n          `PRAGMA table_info(${this.quoteIdentifier(tableName)})`,\n        );\n        const rows = extractRows<{ name: string }>(result);\n        for (const row of rows) {\n          columns.add(row.name);\n        }\n      }\n    } catch (error) {\n      // If introspection fails, return empty set (no columns will be added)\n      if (this.options.debug) {\n        this.logger.warn(\n          `[SchemaManager] Failed to introspect columns for \"${tableName}\"`,\n          { error },\n        );\n      }\n    }\n\n    return columns;\n  }\n\n  /**\n   * Add missing columns to an existing table via ALTER TABLE ADD COLUMN\n   *\n   * Compares the schema's expected columns against the table's actual columns\n   * and adds any that are missing. This handles the race condition where a table\n   * is created with base fields by one code path, then a later code path needs\n   * additional columns from a more complete schema.\n   *\n   * SQLite limitation: ALTER TABLE ADD COLUMN cannot add NOT NULL columns\n   * without a DEFAULT value. We relax NOT NULL for such columns.\n   *\n   * @param tableName - Name of the existing table\n   * @param schema - The full schema definition with expected columns\n   */\n  private async addMissingColumns(\n    tableName: string,\n    schema: SchemaDefinition,\n  ): Promise<void> {\n    if (!schema.columns || Object.keys(schema.columns).length === 0) {\n      return;\n    }\n\n    const existingColumns = await this.getExistingColumns(tableName);\n    if (existingColumns.size === 0) {\n      // Introspection failed or returned no columns — skip to avoid errors\n      return;\n    }\n\n    const strategy = getDDLStrategy(this.engine);\n    let addedCount = 0;\n\n    for (const [colName, colDef] of Object.entries(schema.columns)) {\n      if (existingColumns.has(colName)) {\n        continue; // Column already exists\n      }\n\n      // SQLite limitation: ALTER TABLE ADD COLUMN cannot have NOT NULL\n      // without a DEFAULT value. Relax NOT NULL for such columns.\n      const safeDef = { ...colDef };\n      if (\n        safeDef.notNull &&\n        safeDef.defaultValue === undefined &&\n        !safeDef.primaryKey\n      ) {\n        safeDef.notNull = false;\n      }\n\n      // Cannot add PRIMARY KEY columns via ALTER TABLE\n      if (safeDef.primaryKey) {\n        continue;\n      }\n\n      const colSQL = strategy.generateColumnDefinition(colName, safeDef);\n      const alterSQL = `ALTER TABLE ${this.quoteIdentifier(tableName)} ADD COLUMN ${colSQL}`;\n\n      try {\n        await this.db.query(alterSQL);\n        addedCount++;\n\n        if (this.options.debug) {\n          this.logger.debug(\n            `[SchemaManager] Added column \"${colName}\" to \"${tableName}\"`,\n          );\n        }\n      } catch (error) {\n        // Column might already exist (race condition) or other issue\n        // Log and continue — don't fail the entire operation\n        if (this.options.debug) {\n          this.logger.warn(\n            `[SchemaManager] Failed to add column \"${colName}\" to \"${tableName}\"`,\n            { error },\n          );\n        }\n      }\n    }\n\n    if (addedCount > 0 && this.options.debug) {\n      this.logger.debug(\n        `[SchemaManager] Added ${addedCount} missing column(s) to \"${tableName}\"`,\n      );\n    }\n  }\n\n  private quoteIdentifier(name: string): string {\n    return `\"${name.replace(/\"/g, '\"\"')}\"`;\n  }\n\n  /**\n   * Create multiple tables with dependency ordering\n   *\n   * @param schemas - Array of schema definitions\n   */\n  async ensureTables(schemas: SchemaDefinition[]): Promise<void> {\n    const plan = planForeignKeyCreation(schemas, this.engine);\n    const schemasByTable = new Map(\n      schemas.map((schema) => [schema.tableName, schema]),\n    );\n\n    for (const schema of plan.schemas) {\n      await this.ensureTable(schema);\n    }\n    for (const { table, foreignKey } of plan.deferredConstraints) {\n      const source = schemasByTable.get(table);\n      const target = schemasByTable.get(foreignKey.referencesTable);\n      await this.ensurePostgresForeignKey(table, foreignKey, {\n        nullable: source?.columns[foreignKey.column]?.notNull !== true,\n        uuidComparison:\n          source?.columns[foreignKey.column]?.type === 'UUID' &&\n          target?.columns[foreignKey.referencesColumn]?.type === 'UUID',\n      });\n    }\n  }\n\n  /**\n   * Safely add or validate one PostgreSQL foreign key.\n   *\n   * Existing rows are probed with the canonical exact-column orphan detector\n   * before an absent constraint is added as NOT VALID and then explicitly\n   * validated. Existing NOT VALID constraints follow the same preflight.\n   */\n  async ensurePostgresForeignKey(\n    tableName: string,\n    foreignKey: ForeignKeyDefinition,\n    options: {\n      nullable?: boolean;\n      uuidComparison?: boolean;\n      uuidCastSide?: ForeignKeyUuidCastSide;\n    } = {},\n  ): Promise<void> {\n    const constraintName = foreignKeyConstraintName(tableName, foreignKey);\n    let existing: unknown;\n    try {\n      existing = await this.db.query(\n        `SELECT constraint_row.convalidated FROM pg_constraint AS constraint_row JOIN pg_class AS table_row ON table_row.oid = constraint_row.conrelid JOIN pg_namespace AS namespace_row ON namespace_row.oid = table_row.relnamespace WHERE table_row.relname = $1 AND namespace_row.nspname = current_schema() AND constraint_row.conname = $2 AND constraint_row.contype = 'f' LIMIT 1`,\n        [tableName, constraintName],\n      );\n    } catch (error) {\n      throw new Error(\n        `[SchemaManager] Cannot verify deferred foreign key ${constraintName}; refusing an unsafe duplicate/add attempt: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error },\n      );\n    }\n    const existingRows = extractRows<{ convalidated?: boolean }>(existing);\n    if (existingRows[0]?.convalidated === true) return;\n\n    // #2608: PostgreSQL cannot implement a FOREIGN KEY whose child and parent\n    // columns have different physical types — FK DDL admits no cast — so the\n    // ADD CONSTRAINT below would fail with SQLSTATE 42804 and abort every\n    // later statement in the batch. Fail closed *before* the orphan probe:\n    // across mismatched types a probe answers a question about casted values,\n    // not about the constraint we are refusing to add, and it must be re-run\n    // after the columns converge anyway.\n    const liveTypes = await this.resolveLiveForeignKeyTypes(\n      tableName,\n      foreignKey,\n    );\n    if (liveTypes && liveTypes.childNormalized !== liveTypes.parentNormalized) {\n      const conflict = describeForeignKeyTypeConflict({\n        childTable: tableName,\n        childColumn: foreignKey.column,\n        childType: liveTypes.childType,\n        parentTable: foreignKey.referencesTable,\n        parentColumn: foreignKey.referencesColumn,\n        parentType: liveTypes.parentType,\n      });\n      // The uuid convergence is only the right repair for a relationship the\n      // manifest declares UUID on both sides (`options.uuidComparison`) and\n      // whose live drift is actually a legacy `text` column. Any other\n      // incompatible pair reaches this guard too, and a `USING …::uuid` hint\n      // there would be wrong — name the two live types instead.\n      const textNodes = options.uuidComparison\n        ? [\n            liveTypes.childNormalized === 'TEXT'\n              ? { table: tableName, column: foreignKey.column }\n              : undefined,\n            liveTypes.parentNormalized === 'TEXT'\n              ? {\n                  table: foreignKey.referencesTable,\n                  column: foreignKey.referencesColumn,\n                }\n              : undefined,\n          ].filter((node) => node !== undefined)\n        : [];\n      const repair =\n        textNodes.length > 0\n          ? ` Suggested repair: ${renderUuidConvergenceRepairHint(textNodes).join('; ')}`\n          : ` Align ${tableName}.${foreignKey.column} (${liveTypes.childType}) and ` +\n            `${foreignKey.referencesTable}.${foreignKey.referencesColumn} (${liveTypes.parentType}) ` +\n            'on one physical type deliberately, then retry.';\n      throw new Error(\n        `[SchemaManager] Cannot add ${constraintName}: incompatible column types. ` +\n          `${conflict}. Converge the columns first, then retry.${repair}`,\n      );\n    }\n\n    const probeOptions = this.resolvePostgresForeignKeyProbeOptions(\n      options,\n      liveTypes,\n    );\n\n    const detector = renderForeignKeyOrphanDetector(tableName, foreignKey, {\n      engine: 'postgres',\n      limitOne: true,\n      uuidComparison: probeOptions.uuidComparison,\n      uuidCastSide: probeOptions.uuidCastSide,\n    });\n    let orphanResult: unknown;\n    try {\n      orphanResult = await this.db.query(detector);\n    } catch (error) {\n      throw new Error(\n        `[SchemaManager] Cannot probe ${tableName}.${foreignKey.column} for orphan rows; refusing to add ${constraintName}. Run the detector manually: ${detector}`,\n        { cause: error },\n      );\n    }\n    if (extractRows(orphanResult).length > 0) {\n      throw new Error(\n        `[SchemaManager] Cannot add ${constraintName}: existing rows do not match ${foreignKey.referencesTable}.${foreignKey.referencesColumn}. Repair them, then retry. Suggested repair: ${renderForeignKeyOrphanRepair(tableName, foreignKey, { engine: 'postgres', nullable: probeOptions.nullable, uuidComparison: probeOptions.uuidComparison, uuidCastSide: probeOptions.uuidCastSide })}`,\n      );\n    }\n\n    if (existingRows.length === 0) {\n      await this.db.query(\n        `ALTER TABLE ${this.quoteIdentifier(tableName)} ADD ${renderForeignKeyConstraint(tableName, foreignKey)} NOT VALID`,\n      );\n    }\n    await this.db.query(\n      `ALTER TABLE ${this.quoteIdentifier(tableName)} VALIDATE CONSTRAINT ${this.quoteIdentifier(constraintName)}`,\n    );\n  }\n\n  /**\n   * Read the live physical types of one child/parent column pair.\n   *\n   * Returns `undefined` when either side cannot be introspected (adapter\n   * without `getTableSchema`, table not created yet) — callers then keep the\n   * pre-#2608 behaviour rather than guessing at a mismatch.\n   */\n  private async resolveLiveForeignKeyTypes(\n    tableName: string,\n    foreignKey: ForeignKeyDefinition,\n  ): Promise<\n    | {\n        childType: string;\n        parentType: string;\n        childNormalized: string;\n        parentNormalized: string;\n      }\n    | undefined\n  > {\n    const childSchema = await this.db.getTableSchema?.(tableName);\n    const parentSchema =\n      foreignKey.referencesTable === tableName\n        ? childSchema\n        : await this.db.getTableSchema?.(foreignKey.referencesTable);\n    const childType = childSchema?.columns[foreignKey.column]?.type;\n    const parentType = parentSchema?.columns[foreignKey.referencesColumn]?.type;\n    if (!childType || !parentType) return undefined;\n    return {\n      childType,\n      parentType,\n      childNormalized: this.normalizeForeignKeyProbeType(childType),\n      parentNormalized: this.normalizeForeignKeyProbeType(parentType),\n    };\n  }\n\n  /**\n   * Classify which side of an orphan probe needs a guarded uuid cast.\n   *\n   * Only reachable with matching live types while the #2608 guard rejects\n   * every mismatch, but the classification stays correct for callers that\n   * reuse the helper with an unguarded pair.\n   */\n  private resolvePostgresForeignKeyProbeOptions(\n    options: {\n      nullable?: boolean;\n      uuidComparison?: boolean;\n      uuidCastSide?: ForeignKeyUuidCastSide;\n    },\n    liveTypes?: Awaited<\n      ReturnType<SchemaManager['resolveLiveForeignKeyTypes']>\n    >,\n  ): typeof options {\n    if (!options.uuidComparison || options.uuidCastSide) return options;\n    if (!liveTypes) return options;\n\n    const { childNormalized, parentNormalized } = liveTypes;\n    if (childNormalized === parentNormalized) {\n      return { ...options, uuidCastSide: 'none' };\n    }\n    if (childNormalized === 'UUID') {\n      return { ...options, uuidCastSide: 'parent' };\n    }\n    if (parentNormalized === 'UUID') {\n      return { ...options, uuidCastSide: 'child' };\n    }\n    return { ...options, uuidCastSide: 'both' };\n  }\n\n  private normalizeForeignKeyProbeType(type: string): string {\n    const upper = type.toUpperCase().trim();\n    if (/^UUID$/i.test(upper)) return 'UUID';\n    if (/^(TEXT|CLOB|STRING|VARCHAR|CHAR)/i.test(upper)) return 'TEXT';\n    return upper;\n  }\n\n  /**\n   * Generate DDL without executing (useful for debugging/preview)\n   *\n   * @param schema - The schema definition\n   * @returns Engine-specific DDL\n   */\n  generateDDL(schema: SchemaDefinition): EngineSpecificDDL {\n    const strategy = getDDLStrategy(this.engine);\n    return {\n      createTable: strategy.generateCreateTable(schema),\n      indexes: strategy.generateIndexes(schema),\n      triggers: strategy.generateTriggers(schema),\n    };\n  }\n\n  /**\n   * Get the detected/configured database engine\n   */\n  getEngine(): DatabaseEngine {\n    return this.engine;\n  }\n}\n\n/**\n * Create a SchemaManager instance\n *\n * @param db - Database interface\n * @param options - Optional configuration\n * @returns SchemaManager instance\n */\nexport function createSchemaManager(\n  db: DatabaseInterface,\n  options?: SchemaManagerOptions,\n): SchemaManager {\n  return new SchemaManager(db, options);\n}\n"],"mappings":"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"}

package/dist/schema/types.d.ts

@@ -31,6 +31,8 @@ export interface IndexDefinition {
     name: string;
     columns: string[];
     unique?: boolean;
+    /** SMRT-owned nullable upsert identity; PostgreSQL 15+ uses NULLS NOT DISTINCT. */
+    nullsNotDistinct?: boolean;
     where?: string;
     description?: string;
     /**

package/dist/schema/types.d.ts.map

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

package/dist/scripts/browser-plain-json-regression.mjs

@@ -0,0 +1,85 @@
+import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { createServer } from 'node:http';
+import { tmpdir } from 'node:os';
+import { dirname, extname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { chromium } from 'playwright-core';
+import { build } from 'vite';
+
+const packageDir = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const workDir = await mkdtemp(resolve(tmpdir(), 'smrt-core-browser-plain-json-'));
+const outputDir = resolve(workDir, 'dist');
+const entry = resolve(workDir, 'entry.ts');
+const contentTypes = { '.js': 'text/javascript', '.map': 'application/json' };
+
+try {
+  await writeFile(
+    entry,
+    `Object.defineProperty(JSON, 'isRawJSON', { configurable: true, value: undefined });
+const { getBoxedPrimitiveKind, isRawJSON } = await import(${JSON.stringify(resolve(packageDir, 'src/plain-json.ts'))});
+const foreign = window.frames[0];
+const values = [
+  new foreign.Boolean(true),
+  new foreign.Number(3),
+  new foreign.String('text'),
+  Object(1n),
+];
+const kinds = values.map(getBoxedPrimitiveKind);
+if (JSON.stringify(kinds) !== JSON.stringify(['boolean', 'number', 'string', 'bigint'])) throw new Error('boxed primitive brands were not preserved');
+const tagged = new Number(1);
+Object.defineProperty(tagged, Symbol.toStringTag, { get() { throw new Error('tag getter must not run'); } });
+if (getBoxedPrimitiveKind(tagged) !== 'number') throw new Error('brand probe observed Symbol.toStringTag');
+if (isRawJSON({ rawJSON: '1' })) throw new Error('JSON.isRawJSON fallback must be false when unavailable');
+if (typeof process !== 'undefined') throw new Error('browser probe unexpectedly has process');
+if (typeof JSON.isRawJSON !== 'undefined') throw new Error('browser probe unexpectedly has JSON.isRawJSON');
+document.body.textContent = 'browser plain-json regression passed';
+`,
+  );
+  await build({
+    configFile: false,
+    logLevel: 'error',
+    build: {
+      outDir: outputDir,
+      rollupOptions: { input: entry, output: { entryFileNames: 'entry.js' } },
+      target: 'es2022',
+    },
+  });
+  const server = createServer(async (request, response) => {
+    const pathname = new URL(request.url ?? '/', 'http://localhost').pathname;
+    if (pathname === '/') {
+      response.writeHead(200, { 'content-type': 'text/html' });
+      response.end('<iframe></iframe><script type="module" src="/entry.js"></script>');
+      return;
+    }
+    const file = resolve(outputDir, `.${pathname}`);
+    if (!file.startsWith(`${outputDir}/`)) return response.writeHead(403).end();
+    try {
+      const content = await readFile(file);
+      response.writeHead(200, { 'content-type': contentTypes[extname(file)] ?? 'application/octet-stream' });
+      response.end(content);
+    } catch {
+      response.writeHead(404).end();
+    }
+  });
+  await new Promise((done) => server.listen(0, '127.0.0.1', done));
+  const { port } = server.address();
+  let browser;
+  try {
+    browser = await chromium.launch({ executablePath: chromium.executablePath() });
+    const page = await browser.newPage();
+    const errors = [];
+    page.on('pageerror', (error) => errors.push(error.stack ?? error.message));
+    await page.goto(`http://127.0.0.1:${port}`);
+    await page.waitForFunction(
+      () => document.body.textContent?.includes('passed'),
+      undefined,
+      { timeout: 5_000 },
+    ).catch(() => { throw new Error(errors.join('\n') || 'browser probe did not complete'); });
+    console.log('browser plain-json regression passed');
+  } finally {
+    await browser?.close();
+    await new Promise((done) => server.close(done));
+  }
+} finally {
+  await rm(workDir, { force: true, recursive: true });
+}