@happyvertical/smrt-core 0.43.9 → 0.44.0

package/dist/registry/types.d.ts

@@ -1,4 +1,4 @@
-import { DomainKnowledgeConfig } from '@happyvertical/smrt-types';
+import { CapabilityEffect, DomainKnowledgeConfig } from '@happyvertical/smrt-types';
 import { SmrtCollection } from '../collection';
 import { CollectionCacheConfig } from '../collection-cache';
 import { FieldOptions } from '../decorators/index.js';
@@ -11,8 +11,13 @@ import { DeclaredIndexDefinition, SchemaDefinition } from '../schema/types.js';
  */
 export type SmrtObjectConstructor = new (...args: any[]) => SmrtObject;
 export type ApiHttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-/** Browser/agent-visible effect classification for a generated API action. */
-export type ToolEffect = 'read' | 'write' | 'destructive';
+/**
+ * Browser/agent-visible effect classification for a generated API action.
+ * Aliases the shared `smrt-types` contract (#2587) — see
+ * `CapabilityEffect` there for the fail-closed defaulting rule this
+ * classification is bound by.
+ */
+export type ToolEffect = CapabilityEffect;
 export interface ApiSerializerReference {
     /**
      * Module specifier to import the serializer from.

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

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

package/dist/schema/foreign-key-ddl.d.ts

@@ -21,6 +21,13 @@ export declare function renderForeignKeyOrphanRepair(tableName: string, foreignK
     uuidCastSide?: ForeignKeyUuidCastSide;
     nullable?: boolean;
 }): string;
+/**
+ * Canonical UUID text shape used by every PostgreSQL guard that has to decide
+ * whether a `text` column can be reinterpreted as `uuid`. Exported so the
+ * orphan probe, the FK provisioning guard, and the uuid convergence planner
+ * all test the same shape (#2608).
+ */
+export declare const CANONICAL_UUID_PATTERN = "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$";
 export declare function schemaForeignKeys(schema: Pick<SchemaDefinition, 'columns'> & Partial<Pick<SchemaDefinition, 'foreignKeys'>>): ForeignKeyDefinition[];
 /** Stable identity for one physical relationship, independent of allocation. */
 export declare function foreignKeyRelationshipKey(foreignKey: Pick<ForeignKeyDefinition, 'column' | 'referencesColumn' | 'referencesTable'>): string;

package/dist/schema/foreign-key-ddl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"foreign-key-ddl.d.ts","sourceRoot":"","sources":["../../src/schema/foreign-key-ddl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1E,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,GAC/B,MAAM,CAIR;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,GAC/B,MAAM,CAmBR;AAED,4EAA4E;AAC5E,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,MAAM,CAER;AAED,yDAAyD;AACzD,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,MAAM,CAER;AAED,mFAAmF;AACnF,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,EAChC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,sBAAsB,CAAC;CAClC,GACL,MAAM,CAcR;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,EAChC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACf,GACL,MAAM,CAuBR;AA2CD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC,GAC/C,oBAAoB,EAAE,CAmBxB;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,IAAI,CACd,oBAAoB,EACpB,QAAQ,GAAG,kBAAkB,GAAG,iBAAiB,CAClD,GACA,MAAM,CAMR;AAED,yEAAyE;AACzE,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC,EAChD,MAAM,EAAE,cAAc,GACrB,oBAAoB,EAAE,CAuBxB;AAED,+EAA+E;AAC/E,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,cAAc,GAAG,aAAa,CAAC,CAAC,EACjE,MAAM,EAAE,cAAc,GACrB,MAAM,EAAE,CA0BV"}
+{"version":3,"file":"foreign-key-ddl.d.ts","sourceRoot":"","sources":["../../src/schema/foreign-key-ddl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1E,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,GAC/B,MAAM,CAIR;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,GAC/B,MAAM,CAmBR;AAED,4EAA4E;AAC5E,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,MAAM,CAER;AAED,yDAAyD;AACzD,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,MAAM,CAER;AAED,mFAAmF;AACnF,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,EAChC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,sBAAsB,CAAC;CAClC,GACL,MAAM,CAcR;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,EAChC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACf,GACL,MAAM,CAuBR;AAID;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,mEAC+B,CAAC;AAsCnE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC,GAC/C,oBAAoB,EAAE,CAmBxB;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,IAAI,CACd,oBAAoB,EACpB,QAAQ,GAAG,kBAAkB,GAAG,iBAAiB,CAClD,GACA,MAAM,CAMR;AAED,yEAAyE;AACzE,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC,EAChD,MAAM,EAAE,cAAc,GACrB,oBAAoB,EAAE,CAuBxB;AAED,+EAA+E;AAC/E,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,cAAc,GAAG,aAAa,CAAC,CAAC,EACjE,MAAM,EAAE,cAAc,GACrB,MAAM,EAAE,CA0BV"}

package/dist/schema/foreign-key-ddl.js

@@ -45,6 +45,12 @@ function renderForeignKeyOrphanRepair(tableName, foreignKey, options = {}) {
 }
 var FOREIGN_KEY_CHILD_ALIAS = "smrt_fk_child";
 var FOREIGN_KEY_PARENT_ALIAS = "smrt_fk_parent";
+/**
+* Canonical UUID text shape used by every PostgreSQL guard that has to decide
+* whether a `text` column can be reinterpreted as `uuid`. Exported so the
+* orphan probe, the FK provisioning guard, and the uuid convergence planner
+* all test the same shape (#2608).
+*/
 var CANONICAL_UUID_PATTERN = "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$";
 function foreignKeyOrphanParts(tableName, foreignKey, engine = "postgres", uuidComparison = false, uuidCastSide) {
 	const childAlias = quoteIdentifier(FOREIGN_KEY_CHILD_ALIAS);
@@ -110,6 +116,6 @@ function schemaDependenciesForEngine(schema, engine) {
 	return Array.from(/* @__PURE__ */ new Set([...(schema.dependencies ?? []).filter((dependency) => !disabledTargets.has(dependency) || enabledTargets.has(dependency)), ...enabledTargets]));
 }
 //#endregion
-export { foreignKeyConstraintName, foreignKeyRelationshipKey, renderForeignKeyConstraint, renderForeignKeyConstraintComment, renderForeignKeyConstraintDrop, renderForeignKeyConstraintValidate, renderForeignKeyOrphanDetector, renderForeignKeyOrphanRepair, schemaDependenciesForEngine, schemaForeignKeys, schemaForeignKeysForEngine };
+export { CANONICAL_UUID_PATTERN, foreignKeyConstraintName, foreignKeyRelationshipKey, renderForeignKeyConstraint, renderForeignKeyConstraintComment, renderForeignKeyConstraintDrop, renderForeignKeyConstraintValidate, renderForeignKeyOrphanDetector, renderForeignKeyOrphanRepair, schemaDependenciesForEngine, schemaForeignKeys, schemaForeignKeysForEngine };
 
 //# sourceMappingURL=foreign-key-ddl.js.map

package/dist/schema/foreign-key-ddl.js.map

@@ -1 +1 @@
-{"version":3,"file":"foreign-key-ddl.js","names":[],"sources":["../../src/schema/foreign-key-ddl.ts"],"sourcesContent":["import type { DatabaseEngine } from './ddl/types.js';\nimport { requireForeignKeyAction } from './foreign-key-policy.js';\nimport { shortenIdentifier } from './index-utils.js';\nimport { quoteIdentifier, quoteStringLiteral } from './sql-identifiers.js';\nimport type { ForeignKeyDefinition, SchemaDefinition } from './types.js';\n\nexport type ForeignKeyUuidCastSide = 'child' | 'parent' | 'both' | 'none';\n\nexport function foreignKeyConstraintName(\n  tableName: string,\n  foreignKey: ForeignKeyDefinition,\n): string {\n  return shortenIdentifier(\n    `${tableName}_${foreignKey.column}_${foreignKey.referencesTable}_${foreignKey.referencesColumn}_fkey`,\n  );\n}\n\nexport function renderForeignKeyConstraint(\n  tableName: string,\n  foreignKey: ForeignKeyDefinition,\n): string {\n  const action = (value: unknown, clause: 'DELETE' | 'UPDATE') => {\n    if (value === undefined) return undefined;\n    return requireForeignKeyAction(\n      value,\n      `${tableName}.${foreignKey.column} ON ${clause}`,\n    );\n  };\n  const onDelete = action(foreignKey.onDelete, 'DELETE');\n  const onUpdate = action(foreignKey.onUpdate, 'UPDATE');\n  const name = foreignKeyConstraintName(tableName, foreignKey);\n  const parts = [\n    `CONSTRAINT ${quoteIdentifier(name)}`,\n    `FOREIGN KEY (${quoteIdentifier(foreignKey.column)})`,\n    `REFERENCES ${quoteIdentifier(foreignKey.referencesTable)} (${quoteIdentifier(foreignKey.referencesColumn)})`,\n  ];\n  if (onDelete) parts.push(`ON DELETE ${onDelete}`);\n  if (onUpdate) parts.push(`ON UPDATE ${onUpdate}`);\n  return parts.join(' ');\n}\n\n/** Render a PostgreSQL DROP CONSTRAINT statement for a catalog-owned FK. */\nexport function renderForeignKeyConstraintDrop(\n  tableName: string,\n  constraintName: string,\n): string {\n  return `ALTER TABLE ${quoteIdentifier(tableName)} DROP CONSTRAINT ${quoteIdentifier(constraintName)};`;\n}\n\n/** Render a PostgreSQL VALIDATE CONSTRAINT statement. */\nexport function renderForeignKeyConstraintValidate(\n  tableName: string,\n  constraintName: string,\n): string {\n  return `ALTER TABLE ${quoteIdentifier(tableName)} VALIDATE CONSTRAINT ${quoteIdentifier(constraintName)};`;\n}\n\n/** Render a PostgreSQL constraint comment used to identify framework ownership. */\nexport function renderForeignKeyConstraintComment(\n  tableName: string,\n  constraintName: string,\n  comment: string,\n): string {\n  return `COMMENT ON CONSTRAINT ${quoteIdentifier(constraintName)} ON ${quoteIdentifier(tableName)} IS ${quoteStringLiteral(comment)};`;\n}\n\nexport function renderForeignKeyOrphanDetector(\n  tableName: string,\n  foreignKey: ForeignKeyDefinition,\n  options: {\n    engine?: DatabaseEngine;\n    limitOne?: boolean;\n    uuidComparison?: boolean;\n    uuidCastSide?: ForeignKeyUuidCastSide;\n  } = {},\n): string {\n  const parts = foreignKeyOrphanParts(\n    tableName,\n    foreignKey,\n    options.engine,\n    options.uuidComparison,\n    options.uuidCastSide,\n  );\n  return (\n    `SELECT ${parts.childColumn} AS orphan_key FROM ${parts.childTable} ` +\n    `LEFT JOIN ${parts.parentTable} ON ${parts.joinPredicate} ` +\n    `WHERE ${parts.childColumn} IS NOT NULL AND ${parts.parentColumn} IS NULL` +\n    (options.limitOne ? ' LIMIT 1' : '')\n  );\n}\n\nexport function renderForeignKeyOrphanRepair(\n  tableName: string,\n  foreignKey: ForeignKeyDefinition,\n  options: {\n    engine?: DatabaseEngine;\n    uuidComparison?: boolean;\n    uuidCastSide?: ForeignKeyUuidCastSide;\n    nullable?: boolean;\n  } = {},\n): string {\n  const parts = foreignKeyOrphanParts(\n    tableName,\n    foreignKey,\n    options.engine,\n    options.uuidComparison,\n    options.uuidCastSide,\n  );\n  const orphanPredicate =\n    `${parts.childColumn} IS NOT NULL AND NOT EXISTS (` +\n    `SELECT 1 FROM ${parts.parentTable} WHERE ${parts.joinPredicate})`;\n  if (options.nullable === false) {\n    return (\n      `-- Manual repair required: ${quoteIdentifier(tableName)}.${quoteIdentifier(foreignKey.column)} is NOT NULL. ` +\n      `Reassign each orphaned reference to a valid ${quoteIdentifier(foreignKey.referencesTable)}.${quoteIdentifier(foreignKey.referencesColumn)} value, ` +\n      'or deliberately delete rows only after preserving any required child data.'\n    );\n  }\n  return (\n    `UPDATE ${quoteIdentifier(tableName)} AS ${parts.childAlias} ` +\n    `SET ${quoteIdentifier(foreignKey.column)} = NULL ` +\n    `WHERE ${orphanPredicate}`\n  );\n}\n\nconst FOREIGN_KEY_CHILD_ALIAS = 'smrt_fk_child';\nconst FOREIGN_KEY_PARENT_ALIAS = 'smrt_fk_parent';\nconst CANONICAL_UUID_PATTERN =\n  '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$';\n\nfunction foreignKeyOrphanParts(\n  tableName: string,\n  foreignKey: ForeignKeyDefinition,\n  engine: DatabaseEngine = 'postgres',\n  uuidComparison = false,\n  uuidCastSide?: ForeignKeyUuidCastSide,\n) {\n  const childAlias = quoteIdentifier(FOREIGN_KEY_CHILD_ALIAS);\n  const parentAlias = quoteIdentifier(FOREIGN_KEY_PARENT_ALIAS);\n  const childColumn = `${childAlias}.${quoteIdentifier(foreignKey.column)}`;\n  const parentColumn = `${parentAlias}.${quoteIdentifier(foreignKey.referencesColumn)}`;\n  const guardedUuidValue = (column: string) =>\n    `CASE WHEN ${column}::text ~* '${CANONICAL_UUID_PATTERN}' THEN ${column}::uuid ELSE NULL END`;\n  const effectiveUuidCastSide =\n    engine === 'postgres' && uuidComparison\n      ? (uuidCastSide ?? 'child')\n      : undefined;\n  const childValue =\n    effectiveUuidCastSide === 'child' || effectiveUuidCastSide === 'both'\n      ? guardedUuidValue(childColumn)\n      : childColumn;\n  const parentValue =\n    effectiveUuidCastSide === 'parent' || effectiveUuidCastSide === 'both'\n      ? guardedUuidValue(parentColumn)\n      : parentColumn;\n\n  return {\n    childAlias,\n    childColumn,\n    childTable: `${quoteIdentifier(tableName)} AS ${childAlias}`,\n    joinPredicate: `${parentValue} = ${childValue}`,\n    parentColumn,\n    parentTable: `${quoteIdentifier(foreignKey.referencesTable)} AS ${parentAlias}`,\n  };\n}\n\nexport function schemaForeignKeys(\n  schema: Pick<SchemaDefinition, 'columns'> &\n    Partial<Pick<SchemaDefinition, 'foreignKeys'>>,\n): ForeignKeyDefinition[] {\n  if (schema.foreignKeys && schema.foreignKeys.length > 0) {\n    return schema.foreignKeys;\n  }\n  return Object.entries(schema.columns).flatMap(([column, definition]) => {\n    if (!definition.foreignKey) return [];\n    return [\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\n/** Stable identity for one physical relationship, independent of allocation. */\nexport function foreignKeyRelationshipKey(\n  foreignKey: Pick<\n    ForeignKeyDefinition,\n    'column' | 'referencesColumn' | 'referencesTable'\n  >,\n): string {\n  return JSON.stringify([\n    foreignKey.column,\n    foreignKey.referencesTable,\n    foreignKey.referencesColumn,\n  ]);\n}\n\n/** Return only physical constraints explicitly enabled for an engine. */\nexport function schemaForeignKeysForEngine(\n  schema: Pick<SchemaDefinition, 'columns'> &\n    Partial<Pick<SchemaDefinition, 'foreignKeys'>>,\n  engine: DatabaseEngine,\n): ForeignKeyDefinition[] {\n  return schemaForeignKeys(schema).filter((foreignKey) => {\n    if (foreignKey.engines === undefined) return true;\n\n    const validEngines = new Set<DatabaseEngine>([\n      'postgres',\n      'sqlite',\n      'duckdb',\n      'json',\n    ]);\n    if (\n      foreignKey.engines.length === 0 ||\n      foreignKey.engines.some(\n        (declaredEngine) => !validEngines.has(declaredEngine),\n      )\n    ) {\n      throw new Error(\n        `[DDL:${engine}] Foreign key ${foreignKey.column} declares an invalid physical constraint engine allowlist. Use one or more of: postgres, sqlite, duckdb, json.`,\n      );\n    }\n\n    return foreignKey.engines.includes(engine);\n  });\n}\n\n/** Return declared schema dependencies after excluding engine-disabled FKs. */\nexport function schemaDependenciesForEngine(\n  schema: Pick<SchemaDefinition, 'columns'> &\n    Partial<Pick<SchemaDefinition, 'dependencies' | 'foreignKeys'>>,\n  engine: DatabaseEngine,\n): string[] {\n  const foreignKeys = schemaForeignKeys(schema);\n  const enabledForeignKeys = schemaForeignKeysForEngine(schema, engine);\n  const enabledKeys = new Set(\n    enabledForeignKeys.map(foreignKeyRelationshipKey),\n  );\n  const enabledTargets = new Set(\n    enabledForeignKeys.map((foreignKey) => foreignKey.referencesTable),\n  );\n  const disabledTargets = new Set(\n    foreignKeys\n      .filter(\n        (foreignKey) => !enabledKeys.has(foreignKeyRelationshipKey(foreignKey)),\n      )\n      .map((foreignKey) => foreignKey.referencesTable),\n  );\n\n  return Array.from(\n    new Set([\n      ...(schema.dependencies ?? []).filter(\n        (dependency) =>\n          !disabledTargets.has(dependency) || enabledTargets.has(dependency),\n      ),\n      ...enabledTargets,\n    ]),\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"foreign-key-ddl.js","names":[],"sources":["../../src/schema/foreign-key-ddl.ts"],"sourcesContent":["import type { DatabaseEngine } from './ddl/types.js';\nimport { requireForeignKeyAction } from './foreign-key-policy.js';\nimport { shortenIdentifier } from './index-utils.js';\nimport { quoteIdentifier, quoteStringLiteral } from './sql-identifiers.js';\nimport type { ForeignKeyDefinition, SchemaDefinition } from './types.js';\n\nexport type ForeignKeyUuidCastSide = 'child' | 'parent' | 'both' | 'none';\n\nexport function foreignKeyConstraintName(\n  tableName: string,\n  foreignKey: ForeignKeyDefinition,\n): string {\n  return shortenIdentifier(\n    `${tableName}_${foreignKey.column}_${foreignKey.referencesTable}_${foreignKey.referencesColumn}_fkey`,\n  );\n}\n\nexport function renderForeignKeyConstraint(\n  tableName: string,\n  foreignKey: ForeignKeyDefinition,\n): string {\n  const action = (value: unknown, clause: 'DELETE' | 'UPDATE') => {\n    if (value === undefined) return undefined;\n    return requireForeignKeyAction(\n      value,\n      `${tableName}.${foreignKey.column} ON ${clause}`,\n    );\n  };\n  const onDelete = action(foreignKey.onDelete, 'DELETE');\n  const onUpdate = action(foreignKey.onUpdate, 'UPDATE');\n  const name = foreignKeyConstraintName(tableName, foreignKey);\n  const parts = [\n    `CONSTRAINT ${quoteIdentifier(name)}`,\n    `FOREIGN KEY (${quoteIdentifier(foreignKey.column)})`,\n    `REFERENCES ${quoteIdentifier(foreignKey.referencesTable)} (${quoteIdentifier(foreignKey.referencesColumn)})`,\n  ];\n  if (onDelete) parts.push(`ON DELETE ${onDelete}`);\n  if (onUpdate) parts.push(`ON UPDATE ${onUpdate}`);\n  return parts.join(' ');\n}\n\n/** Render a PostgreSQL DROP CONSTRAINT statement for a catalog-owned FK. */\nexport function renderForeignKeyConstraintDrop(\n  tableName: string,\n  constraintName: string,\n): string {\n  return `ALTER TABLE ${quoteIdentifier(tableName)} DROP CONSTRAINT ${quoteIdentifier(constraintName)};`;\n}\n\n/** Render a PostgreSQL VALIDATE CONSTRAINT statement. */\nexport function renderForeignKeyConstraintValidate(\n  tableName: string,\n  constraintName: string,\n): string {\n  return `ALTER TABLE ${quoteIdentifier(tableName)} VALIDATE CONSTRAINT ${quoteIdentifier(constraintName)};`;\n}\n\n/** Render a PostgreSQL constraint comment used to identify framework ownership. */\nexport function renderForeignKeyConstraintComment(\n  tableName: string,\n  constraintName: string,\n  comment: string,\n): string {\n  return `COMMENT ON CONSTRAINT ${quoteIdentifier(constraintName)} ON ${quoteIdentifier(tableName)} IS ${quoteStringLiteral(comment)};`;\n}\n\nexport function renderForeignKeyOrphanDetector(\n  tableName: string,\n  foreignKey: ForeignKeyDefinition,\n  options: {\n    engine?: DatabaseEngine;\n    limitOne?: boolean;\n    uuidComparison?: boolean;\n    uuidCastSide?: ForeignKeyUuidCastSide;\n  } = {},\n): string {\n  const parts = foreignKeyOrphanParts(\n    tableName,\n    foreignKey,\n    options.engine,\n    options.uuidComparison,\n    options.uuidCastSide,\n  );\n  return (\n    `SELECT ${parts.childColumn} AS orphan_key FROM ${parts.childTable} ` +\n    `LEFT JOIN ${parts.parentTable} ON ${parts.joinPredicate} ` +\n    `WHERE ${parts.childColumn} IS NOT NULL AND ${parts.parentColumn} IS NULL` +\n    (options.limitOne ? ' LIMIT 1' : '')\n  );\n}\n\nexport function renderForeignKeyOrphanRepair(\n  tableName: string,\n  foreignKey: ForeignKeyDefinition,\n  options: {\n    engine?: DatabaseEngine;\n    uuidComparison?: boolean;\n    uuidCastSide?: ForeignKeyUuidCastSide;\n    nullable?: boolean;\n  } = {},\n): string {\n  const parts = foreignKeyOrphanParts(\n    tableName,\n    foreignKey,\n    options.engine,\n    options.uuidComparison,\n    options.uuidCastSide,\n  );\n  const orphanPredicate =\n    `${parts.childColumn} IS NOT NULL AND NOT EXISTS (` +\n    `SELECT 1 FROM ${parts.parentTable} WHERE ${parts.joinPredicate})`;\n  if (options.nullable === false) {\n    return (\n      `-- Manual repair required: ${quoteIdentifier(tableName)}.${quoteIdentifier(foreignKey.column)} is NOT NULL. ` +\n      `Reassign each orphaned reference to a valid ${quoteIdentifier(foreignKey.referencesTable)}.${quoteIdentifier(foreignKey.referencesColumn)} value, ` +\n      'or deliberately delete rows only after preserving any required child data.'\n    );\n  }\n  return (\n    `UPDATE ${quoteIdentifier(tableName)} AS ${parts.childAlias} ` +\n    `SET ${quoteIdentifier(foreignKey.column)} = NULL ` +\n    `WHERE ${orphanPredicate}`\n  );\n}\n\nconst FOREIGN_KEY_CHILD_ALIAS = 'smrt_fk_child';\nconst FOREIGN_KEY_PARENT_ALIAS = 'smrt_fk_parent';\n/**\n * Canonical UUID text shape used by every PostgreSQL guard that has to decide\n * whether a `text` column can be reinterpreted as `uuid`. Exported so the\n * orphan probe, the FK provisioning guard, and the uuid convergence planner\n * all test the same shape (#2608).\n */\nexport const CANONICAL_UUID_PATTERN =\n  '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$';\n\nfunction foreignKeyOrphanParts(\n  tableName: string,\n  foreignKey: ForeignKeyDefinition,\n  engine: DatabaseEngine = 'postgres',\n  uuidComparison = false,\n  uuidCastSide?: ForeignKeyUuidCastSide,\n) {\n  const childAlias = quoteIdentifier(FOREIGN_KEY_CHILD_ALIAS);\n  const parentAlias = quoteIdentifier(FOREIGN_KEY_PARENT_ALIAS);\n  const childColumn = `${childAlias}.${quoteIdentifier(foreignKey.column)}`;\n  const parentColumn = `${parentAlias}.${quoteIdentifier(foreignKey.referencesColumn)}`;\n  const guardedUuidValue = (column: string) =>\n    `CASE WHEN ${column}::text ~* '${CANONICAL_UUID_PATTERN}' THEN ${column}::uuid ELSE NULL END`;\n  const effectiveUuidCastSide =\n    engine === 'postgres' && uuidComparison\n      ? (uuidCastSide ?? 'child')\n      : undefined;\n  const childValue =\n    effectiveUuidCastSide === 'child' || effectiveUuidCastSide === 'both'\n      ? guardedUuidValue(childColumn)\n      : childColumn;\n  const parentValue =\n    effectiveUuidCastSide === 'parent' || effectiveUuidCastSide === 'both'\n      ? guardedUuidValue(parentColumn)\n      : parentColumn;\n\n  return {\n    childAlias,\n    childColumn,\n    childTable: `${quoteIdentifier(tableName)} AS ${childAlias}`,\n    joinPredicate: `${parentValue} = ${childValue}`,\n    parentColumn,\n    parentTable: `${quoteIdentifier(foreignKey.referencesTable)} AS ${parentAlias}`,\n  };\n}\n\nexport function schemaForeignKeys(\n  schema: Pick<SchemaDefinition, 'columns'> &\n    Partial<Pick<SchemaDefinition, 'foreignKeys'>>,\n): ForeignKeyDefinition[] {\n  if (schema.foreignKeys && schema.foreignKeys.length > 0) {\n    return schema.foreignKeys;\n  }\n  return Object.entries(schema.columns).flatMap(([column, definition]) => {\n    if (!definition.foreignKey) return [];\n    return [\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\n/** Stable identity for one physical relationship, independent of allocation. */\nexport function foreignKeyRelationshipKey(\n  foreignKey: Pick<\n    ForeignKeyDefinition,\n    'column' | 'referencesColumn' | 'referencesTable'\n  >,\n): string {\n  return JSON.stringify([\n    foreignKey.column,\n    foreignKey.referencesTable,\n    foreignKey.referencesColumn,\n  ]);\n}\n\n/** Return only physical constraints explicitly enabled for an engine. */\nexport function schemaForeignKeysForEngine(\n  schema: Pick<SchemaDefinition, 'columns'> &\n    Partial<Pick<SchemaDefinition, 'foreignKeys'>>,\n  engine: DatabaseEngine,\n): ForeignKeyDefinition[] {\n  return schemaForeignKeys(schema).filter((foreignKey) => {\n    if (foreignKey.engines === undefined) return true;\n\n    const validEngines = new Set<DatabaseEngine>([\n      'postgres',\n      'sqlite',\n      'duckdb',\n      'json',\n    ]);\n    if (\n      foreignKey.engines.length === 0 ||\n      foreignKey.engines.some(\n        (declaredEngine) => !validEngines.has(declaredEngine),\n      )\n    ) {\n      throw new Error(\n        `[DDL:${engine}] Foreign key ${foreignKey.column} declares an invalid physical constraint engine allowlist. Use one or more of: postgres, sqlite, duckdb, json.`,\n      );\n    }\n\n    return foreignKey.engines.includes(engine);\n  });\n}\n\n/** Return declared schema dependencies after excluding engine-disabled FKs. */\nexport function schemaDependenciesForEngine(\n  schema: Pick<SchemaDefinition, 'columns'> &\n    Partial<Pick<SchemaDefinition, 'dependencies' | 'foreignKeys'>>,\n  engine: DatabaseEngine,\n): string[] {\n  const foreignKeys = schemaForeignKeys(schema);\n  const enabledForeignKeys = schemaForeignKeysForEngine(schema, engine);\n  const enabledKeys = new Set(\n    enabledForeignKeys.map(foreignKeyRelationshipKey),\n  );\n  const enabledTargets = new Set(\n    enabledForeignKeys.map((foreignKey) => foreignKey.referencesTable),\n  );\n  const disabledTargets = new Set(\n    foreignKeys\n      .filter(\n        (foreignKey) => !enabledKeys.has(foreignKeyRelationshipKey(foreignKey)),\n      )\n      .map((foreignKey) => foreignKey.referencesTable),\n  );\n\n  return Array.from(\n    new Set([\n      ...(schema.dependencies ?? []).filter(\n        (dependency) =>\n          !disabledTargets.has(dependency) || enabledTargets.has(dependency),\n      ),\n      ...enabledTargets,\n    ]),\n  );\n}\n"],"mappings":"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"}

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

@@ -79,6 +79,21 @@ export declare class SchemaManager {
         uuidComparison?: boolean;
         uuidCastSide?: ForeignKeyUuidCastSide;
     }): Promise<void>;
+    /**
+     * Read the live physical types of one child/parent column pair.
+     *
+     * Returns `undefined` when either side cannot be introspected (adapter
+     * without `getTableSchema`, table not created yet) — callers then keep the
+     * pre-#2608 behaviour rather than guessing at a mismatch.
+     */
+    private resolveLiveForeignKeyTypes;
+    /**
+     * Classify which side of an orphan probe needs a guarded uuid cast.
+     *
+     * Only reachable with matching live types while the #2608 guard rejects
+     * every mismatch, but the classification stays correct for callers that
+     * reuse the helper with an unguarded pair.
+     */
     private resolvePostgresForeignKeyProbeOptions;
     private normalizeForeignKeyProbeType;
     /**

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;AAiBzE;;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;YAsDF,qCAAqC;IAkCnD,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;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"}

package/dist/schema/schema-manager.js

@@ -1,6 +1,7 @@
 import { foreignKeyConstraintName, renderForeignKeyConstraint, renderForeignKeyOrphanDetector, renderForeignKeyOrphanRepair } from "./foreign-key-ddl.js";
 import { detectEngine, getDDLStrategy } from "./ddl/index.js";
 import { planForeignKeyCreation } from "./foreign-key-planner.js";
+import { describeForeignKeyTypeConflict, renderUuidConvergenceRepairHint } from "./uuid-convergence.js";
 import { createLogger } from "@happyvertical/logger";
 //#region src/schema/schema-manager.ts
 /**
@@ -199,7 +200,27 @@ var SchemaManager = class {
 		}
 		const existingRows = extractRows(existing);
 		if (existingRows[0]?.convalidated === true) return;
-		const probeOptions = await this.resolvePostgresForeignKeyProbeOptions(tableName, foreignKey, options);
+		const liveTypes = await this.resolveLiveForeignKeyTypes(tableName, foreignKey);
+		if (liveTypes && liveTypes.childNormalized !== liveTypes.parentNormalized) {
+			const conflict = describeForeignKeyTypeConflict({
+				childTable: tableName,
+				childColumn: foreignKey.column,
+				childType: liveTypes.childType,
+				parentTable: foreignKey.referencesTable,
+				parentColumn: foreignKey.referencesColumn,
+				parentType: liveTypes.parentType
+			});
+			const textNodes = options.uuidComparison ? [liveTypes.childNormalized === "TEXT" ? {
+				table: tableName,
+				column: foreignKey.column
+			} : void 0, liveTypes.parentNormalized === "TEXT" ? {
+				table: foreignKey.referencesTable,
+				column: foreignKey.referencesColumn
+			} : void 0].filter((node) => node !== void 0) : [];
+			const repair = textNodes.length > 0 ? ` Suggested repair: ${renderUuidConvergenceRepairHint(textNodes).join("; ")}` : ` Align ${tableName}.${foreignKey.column} (${liveTypes.childType}) and ${foreignKey.referencesTable}.${foreignKey.referencesColumn} (${liveTypes.parentType}) on one physical type deliberately, then retry.`;
+			throw new Error(`[SchemaManager] Cannot add ${constraintName}: incompatible column types. ${conflict}. Converge the columns first, then retry.${repair}`);
+		}
+		const probeOptions = this.resolvePostgresForeignKeyProbeOptions(options, liveTypes);
 		const detector = renderForeignKeyOrphanDetector(tableName, foreignKey, {
 			engine: "postgres",
 			limitOne: true,
@@ -221,24 +242,46 @@ var SchemaManager = class {
 		if (existingRows.length === 0) await this.db.query(`ALTER TABLE ${this.quoteIdentifier(tableName)} ADD ${renderForeignKeyConstraint(tableName, foreignKey)} NOT VALID`);
 		await this.db.query(`ALTER TABLE ${this.quoteIdentifier(tableName)} VALIDATE CONSTRAINT ${this.quoteIdentifier(constraintName)}`);
 	}
-	async resolvePostgresForeignKeyProbeOptions(tableName, foreignKey, options) {
-		if (!options.uuidComparison || options.uuidCastSide) return options;
+	/**
+	* Read the live physical types of one child/parent column pair.
+	*
+	* Returns `undefined` when either side cannot be introspected (adapter
+	* without `getTableSchema`, table not created yet) — callers then keep the
+	* pre-#2608 behaviour rather than guessing at a mismatch.
+	*/
+	async resolveLiveForeignKeyTypes(tableName, foreignKey) {
 		const childSchema = await this.db.getTableSchema?.(tableName);
 		const parentSchema = foreignKey.referencesTable === tableName ? childSchema : await this.db.getTableSchema?.(foreignKey.referencesTable);
 		const childType = childSchema?.columns[foreignKey.column]?.type;
 		const parentType = parentSchema?.columns[foreignKey.referencesColumn]?.type;
-		if (!childType || !parentType) return options;
-		const childTypeNormalized = this.normalizeForeignKeyProbeType(childType);
-		const parentTypeNormalized = this.normalizeForeignKeyProbeType(parentType);
-		if (childTypeNormalized === parentTypeNormalized) return {
+		if (!childType || !parentType) return void 0;
+		return {
+			childType,
+			parentType,
+			childNormalized: this.normalizeForeignKeyProbeType(childType),
+			parentNormalized: this.normalizeForeignKeyProbeType(parentType)
+		};
+	}
+	/**
+	* Classify which side of an orphan probe needs a guarded uuid cast.
+	*
+	* Only reachable with matching live types while the #2608 guard rejects
+	* every mismatch, but the classification stays correct for callers that
+	* reuse the helper with an unguarded pair.
+	*/
+	resolvePostgresForeignKeyProbeOptions(options, liveTypes) {
+		if (!options.uuidComparison || options.uuidCastSide) return options;
+		if (!liveTypes) return options;
+		const { childNormalized, parentNormalized } = liveTypes;
+		if (childNormalized === parentNormalized) return {
 			...options,
 			uuidCastSide: "none"
 		};
-		if (childTypeNormalized === "UUID") return {
+		if (childNormalized === "UUID") return {
 			...options,
 			uuidCastSide: "parent"
 		};
-		if (parentTypeNormalized === "UUID") return {
+		if (parentNormalized === "UUID") return {
 			...options,
 			uuidCastSide: "child"
 		};

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';\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    const probeOptions = await this.resolvePostgresForeignKeyProbeOptions(\n      tableName,\n      foreignKey,\n      options,\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  private async resolvePostgresForeignKeyProbeOptions(\n    tableName: string,\n    foreignKey: ForeignKeyDefinition,\n    options: {\n      nullable?: boolean;\n      uuidComparison?: boolean;\n      uuidCastSide?: ForeignKeyUuidCastSide;\n    },\n  ): Promise<typeof options> {\n    if (!options.uuidComparison || options.uuidCastSide) return options;\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 options;\n\n    const childTypeNormalized = this.normalizeForeignKeyProbeType(childType);\n    const parentTypeNormalized = this.normalizeForeignKeyProbeType(parentType);\n    if (childTypeNormalized === parentTypeNormalized) {\n      return { ...options, uuidCastSide: 'none' };\n    }\n    if (childTypeNormalized === 'UUID') {\n      return { ...options, uuidCastSide: 'parent' };\n    }\n    if (parentTypeNormalized === '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    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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"}

package/dist/schema/types.d.ts

@@ -313,6 +313,16 @@ export interface SchemaChange {
     };
     /** Which property an `alter_column` change repairs. */
     alteration?: ColumnAlteration;
+    /**
+     * Ordering phase for changes that must run before an unrelated family of
+     * statements in the same batch. `pre_foreign_key` marks the pre-R11
+     * `text` -> `uuid` column convergence (#2608): PostgreSQL cannot implement
+     * a foreign key across mismatched physical types, so these conversions —
+     * and the advisories that replace them when convergence is refused —
+     * precede every foreign-key statement in the migration stream, including
+     * the deferred constraints emitted for newly created tables.
+     */
+    phase?: 'pre_foreign_key';
     /**
      * Present on report-only changes (`orphan_column`, `orphan_index`, and
      * `alter_column` relaxations the caller has not opted into). A change

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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"}