@happyvertical/smrt-core 0.42.7 → 0.43.0

package/dist/schema/types.d.ts

@@ -18,12 +18,13 @@ export interface ColumnDefinition {
     foreignKey?: {
         table: string;
         column: string;
-        onDelete?: 'CASCADE' | 'SET NULL' | 'RESTRICT';
-        onUpdate?: 'CASCADE' | 'SET NULL' | 'RESTRICT';
+        onDelete?: ForeignKeyAction;
+        onUpdate?: ForeignKeyAction;
     };
     check?: string;
     description?: string;
 }
+export type ForeignKeyAction = 'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION';
 export interface IndexDefinition {
     name: string;
     columns: string[];
@@ -92,8 +93,8 @@ export interface ForeignKeyDefinition {
     column: string;
     referencesTable: string;
     referencesColumn: string;
-    onDelete?: 'CASCADE' | 'SET NULL' | 'RESTRICT';
-    onUpdate?: 'CASCADE' | 'SET NULL' | 'RESTRICT';
+    onDelete?: ForeignKeyAction;
+    onUpdate?: ForeignKeyAction;
 }
 export interface SchemaDefinition {
     tableName: string;
@@ -284,7 +285,7 @@ export interface SchemaChangeAdvisory {
  */
 export interface SchemaChange {
     /** Type of change */
-    type: 'add_table' | 'drop_table' | 'add_column' | 'drop_column' | 'alter_column' | 'orphan_column' | 'add_index' | 'drop_index' | 'orphan_index' | 'type_mismatch' | 'type_upgrade';
+    type: 'add_table' | 'drop_table' | 'add_column' | 'drop_column' | 'alter_column' | 'orphan_column' | 'add_index' | 'add_foreign_key' | 'drop_index' | 'orphan_index' | 'type_mismatch' | 'type_upgrade';
     /** Affected table name */
     table: string;
     /** Column or index name (if applicable) */
@@ -293,6 +294,8 @@ export interface SchemaChange {
     column?: ColumnDefinition;
     /** Index definition (for add_index) */
     index?: IndexDefinition;
+    /** Foreign-key definition (for add_foreign_key). */
+    foreignKey?: ForeignKeyDefinition;
     /**
      * For type mismatches/upgrades: expected vs actual type. For
      * `alter_column`: the expected vs actual constraint rendering (e.g.

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/schema/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/schema/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EACL,+BAA+B,EAC/B,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,KAAK,sBAAsB,EAC3B,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,4BAA4B,EAC5B,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAMlC,SAAS,EAAE;IAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACxE,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EAC7C,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAO,mBAkJ1C;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAyEf"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/schema/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD,OAAO,EACL,+BAA+B,EAC/B,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,KAAK,sBAAsB,EAC3B,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,4BAA4B,EAC5B,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAMlC,SAAS,EAAE;IAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACxE,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EAC7C,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAO,mBAkJ1C;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA+Ff"}

package/dist/schema/utils.js

@@ -1,4 +1,5 @@
 import { MAX_IDENTIFIER_BYTES, assertIdentifierFits, identifierByteLength, isJsonPathIndex, isStiSubtypeUniqueIndex, renderIndexTarget, shortenIdentifier } from "./index-utils.js";
+import { schemaForeignKeys } from "./foreign-key-ddl.js";
 import { tableNameFromClass } from "../utils.js";
 import { ObjectRegistry } from "../registry.js";
 import { SchemaManager } from "./schema-manager.js";
@@ -97,7 +98,19 @@ async function ensureSchema(db, className) {
 	}
 	if (!schemaDefinition?.tableName) throw new Error(`No schema definition found for class '${className}'. Run the manifest generation/build step before preparing schema.`);
 	const effectiveSchemaDefinition = ObjectRegistry.getAllSchemasAsDefinitions()[schemaDefinition.tableName] ?? schemaDefinition;
-	await new SchemaManager(db, { skipTriggers: typeof db.exportTable === "function" }).ensureTable(effectiveSchemaDefinition);
+	const allSchemas = ObjectRegistry.getAllSchemasAsDefinitions();
+	const required = /* @__PURE__ */ new Map();
+	const collect = (schema) => {
+		if (required.has(schema.tableName)) return;
+		required.set(schema.tableName, schema);
+		const dependencies = /* @__PURE__ */ new Set([...schema.dependencies, ...schemaForeignKeys(schema).map((foreignKey) => foreignKey.referencesTable)]);
+		for (const dependency of dependencies) {
+			const dependencySchema = allSchemas[dependency];
+			if (dependencySchema) collect(dependencySchema);
+		}
+	};
+	collect(effectiveSchemaDefinition);
+	await new SchemaManager(db, { skipTriggers: typeof db.exportTable === "function" }).ensureTables([...required.values()]);
 }
 //#endregion
 export { MAX_IDENTIFIER_BYTES, assertIdentifierFits, collectManifestTables, ensureSchema, generateSchema, identifierByteLength, isJsonPathIndex, isStiSubtypeUniqueIndex, manifestColumnsToDefinitions, manifestIndexesToDefinitions, manifestSchemaToDefinition, materializeManifestDDLForEngine, mergeSchemaDefinitionInto, renderCollectedManifestTable, renderIndexTarget, shortenIdentifier, tokenizeSQLDDLBody };

package/dist/schema/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../../src/schema/utils.ts"],"sourcesContent":["/**\n * Schema generation utilities - Node.js only\n *\n * These functions use SchemaGenerator which depends on node:crypto.\n * Separated from main utils.ts to prevent bundling in browser builds.\n *\n * SMRT handles ALL database maintenance directly.\n * SDK SQL remains a pure query/CRUD layer.\n */\n\nimport type { DatabaseInterface } from '@happyvertical/sql';\nimport type { SmrtObject } from '../object.js';\nimport { ObjectRegistry } from '../registry.js';\nimport type { FieldDefinition } from '../scanner/types.js';\nimport { tableNameFromClass } from '../utils.js';\nimport type { DatabaseEngine } from './ddl/types.js';\nimport { SchemaManager } from './schema-manager.js';\n\nexport {\n  materializeManifestDDLForEngine,\n  tokenizeSQLDDLBody,\n} from './ddl/materialize-manifest.js';\n// Index-rendering helpers live in a separate file to avoid pulling the\n// heavyweight registry/collection module graph into the DDL strategies.\nexport {\n  assertIdentifierFits,\n  identifierByteLength,\n  isJsonPathIndex,\n  isStiSubtypeUniqueIndex,\n  MAX_IDENTIFIER_BYTES,\n  renderIndexTarget,\n  shortenIdentifier,\n} from './index-utils.js';\n// Structured manifest → executable DDL helpers (#2358). Re-exported here for\n// `@happyvertical/smrt-vitest`, which already imports this subpath.\nexport {\n  type CollectedManifestTable,\n  collectManifestTables,\n  type ManifestColumnLike,\n  type ManifestIndexLike,\n  type ManifestSchemaLike,\n  manifestColumnsToDefinitions,\n  manifestIndexesToDefinitions,\n  manifestSchemaToDefinition,\n  mergeSchemaDefinitionInto,\n  renderCollectedManifestTable,\n} from './manifest-schema.js';\n\n/**\n * Generates a complete database schema SQL statement for a class\n *\n * This is a thin wrapper around SchemaGenerator that provides the\n * single source of truth for schema generation. Uses ObjectRegistry\n * cached fields from AST manifest for consistent schema generation.\n *\n * **Note**: Uses dynamic import for SchemaGenerator to avoid bundling\n * Node.js-only code (node:crypto) in browser builds.\n *\n * @param ClassType - Class constructor to generate schema for\n * @param providedFields - Optional fields map (used during registration)\n * @returns SQL schema creation statement with CREATE TABLE and CREATE INDEX statements\n */\nexport async function generateSchema(\n  // Accepts any SmrtObject constructor: the registry-stored `typeof SmrtObject`\n  // as well as collection item classes whose construct signature is narrower\n  // than the full static surface. Only `.name` and the construct identity are\n  // used here. `never[]` keeps the construct signature contravariantly\n  // compatible with constructors that declare their own argument shapes.\n  ClassType: { new (...args: never[]): SmrtObject; readonly name: string },\n  providedFields?: Map<string, FieldDefinition>,\n  options: { engine?: DatabaseEngine } = {},\n) {\n  const className = ClassType.name;\n  const tableName = tableNameFromClass(ClassType);\n\n  // For external packages, ensure manifest is loaded before proceeding\n  if (!providedFields || providedFields.size === 0) {\n    await ObjectRegistry.ensureManifestLoaded(className);\n  }\n\n  // Use provided fields if available AND non-empty (during registration), otherwise get from registry\n  // NEW: Use getAllFields() to include inherited fields from parent classes\n  const cachedFields =\n    providedFields && providedFields.size > 0\n      ? providedFields\n      : await ObjectRegistry.getAllFields(className);\n\n  // Throw error if no fields found\n  if (cachedFields.size === 0) {\n    // Detect if running in test environment\n    const testGlobals = globalThis as {\n      describe?: unknown;\n      it?: unknown;\n    };\n    const isTestEnv =\n      process.env.NODE_ENV === 'test' ||\n      process.env.VITEST === 'true' ||\n      typeof testGlobals.describe !== 'undefined' ||\n      typeof testGlobals.it !== 'undefined';\n\n    const testHint = isTestEnv\n      ? `\\n\\n⚠️  Are you using 'smrt test'? ` +\n        `Tests require manifest generation.\\n` +\n        `   ✅ Use: smrt test\\n` +\n        `   ❌ NOT:  npx vitest\\n`\n      : '';\n\n    // Check if class is actually registered (decorator ran but no fields loaded)\n    const isRegistered = ObjectRegistry.hasClass(className);\n\n    if (isRegistered) {\n      // Class registered but no fields - manifest problem\n      throw new Error(\n        `No field metadata found for class '${className}'. ` +\n          `The class is registered (decorator ran) but has no field definitions. ` +\n          `This usually means the manifest file is missing or stale.` +\n          testHint,\n      );\n    } else {\n      // Class not registered - decorator never ran\n      throw new Error(\n        `Cannot generate schema for unregistered class '${className}'. ` +\n          `Ensure the class is decorated with @smrt() for schema generation to work. ` +\n          `Runtime introspection has been removed per issue #131.` +\n          testHint,\n      );\n    }\n  }\n\n  // Check if class uses STI strategy\n  const tableStrategy = ObjectRegistry.getTableStrategy(className);\n\n  // Dynamic import SchemaGenerator (Node.js-only, uses node:crypto)\n  // This prevents bundling it into browser builds\n  const { SchemaGenerator } = await import('./generator.js');\n  const generator = new SchemaGenerator();\n  const registeredClass = ObjectRegistry.getClass(className);\n  // Every key the generator reads from `@smrt()` config must be listed here:\n  // this bag is rebuilt by hand rather than passed through, so an unlisted\n  // option is silently unreachable at runtime while still appearing in the\n  // manifest. `indexes` (#2357) was exactly that. `conflictColumns` is the\n  // RESOLVED conflict target, not the raw decorator option: for a\n  // tenant-scoped class with no explicit `conflictColumns` the registry\n  // derives `[tenant_id, ...natural key]` (#2360), and `save()` upserts on\n  // exactly that, so the unique index generated here must match it.\n  const runtimeSchemaConfig = registeredClass?.config\n    ? {\n        conflictColumns: ObjectRegistry.getConflictColumns(className),\n        idType: registeredClass.config.idType,\n        indexes: registeredClass.config.indexes,\n        registry: ObjectRegistry,\n      }\n    : undefined;\n\n  let schemaDefinition: Awaited<\n    ReturnType<\n      InstanceType<typeof SchemaGenerator>['generateSchemaFromRegistry']\n    >\n  >;\n\n  if (tableStrategy === 'sti') {\n    // STI: Generate shared table for base class\n    const stiBase = ObjectRegistry.getSTIBase(className);\n\n    if (!stiBase) {\n      throw new Error(\n        `STI strategy detected for '${className}' but no STI base class found. ` +\n          `This should not happen - please report this bug.`,\n      );\n    }\n\n    // Only generate schema for the base class (not for children).\n    // R5-canon: `getSTIBase` returns the qualified name; compare against\n    // the qualified form of this class so an STI base isn't\n    // mis-classified as a subclass and skipped.\n    const qualifiedClassName =\n      registeredClass?.qualifiedName ?? registeredClass?.name ?? className;\n    if (qualifiedClassName === stiBase || className === stiBase) {\n      // This is the base class - generate STI schema\n      schemaDefinition = await generator.generateSTISchemaFromRegistry(\n        className,\n        tableName,\n        cachedFields,\n        runtimeSchemaConfig,\n      );\n    } else {\n      // This is a child class - return null or empty schema\n      // The base class schema already includes all fields\n      // Child classes don't need their own tables\n      return ''; // Empty SQL - table already created by base class\n    }\n  } else {\n    // CTI: Generate separate table for each class\n    schemaDefinition = generator.generateSchemaFromRegistry(\n      className,\n      tableName,\n      cachedFields,\n      runtimeSchemaConfig,\n    );\n  }\n\n  // Store the full schema definition in the registry\n  // This is critical for:\n  // - STI tables where descendants have additional columns (issue #427)\n  // - Per-engine DDL generation via SchemaManager\n  if (registeredClass) {\n    // Store the full SchemaDefinition for SchemaManager to use\n    registeredClass.schema = schemaDefinition;\n    // Also store generated DDL for backward compatibility\n    registeredClass.schema.ddl = generator.generateSQL(\n      schemaDefinition,\n      'sqlite',\n    );\n  }\n\n  return generator.generateSQL(schemaDefinition, options.engine);\n}\n\n/**\n * Ensure schema exists for a registered class.\n *\n * This compatibility helper is kept for tooling flows such as CLI commands that\n * explicitly prepare schema ahead of runtime. Core runtime no longer calls this\n * automatically.\n *\n * @deprecated Prefer explicit migration/bootstrap tooling. Runtime verifies\n * schema and fails fast when tables are missing.\n */\nexport async function ensureSchema(\n  db: DatabaseInterface,\n  className: string,\n): Promise<void> {\n  const registered = ObjectRegistry.getClass(className);\n  if (!registered) {\n    throw new Error(\n      `Cannot ensure schema for unregistered class '${className}'. ` +\n        `Ensure the class is decorated with @smrt() and registered in the ObjectRegistry.`,\n    );\n  }\n\n  const tableStrategy = ObjectRegistry.getTableStrategy(className);\n  if (tableStrategy === 'sti') {\n    const stiBase = ObjectRegistry.getSTIBase(className);\n    // R5-canon: `getSTIBase` returns the qualified name. Compare\n    // against the qualified form of `className` so an STI base isn't\n    // mis-classified as a child and recursed on. Falls back to a\n    // simple-name compare for classes without a package context.\n    const qualifiedClassName =\n      registered.qualifiedName ?? registered.name ?? className;\n    if (stiBase && stiBase !== qualifiedClassName && stiBase !== className) {\n      await ensureSchema(db, stiBase);\n      return;\n    }\n  }\n\n  let schemaDefinition = ObjectRegistry.getSchema(className);\n  if (tableStrategy === 'sti') {\n    const tableName = ObjectRegistry.getTableName(className);\n    if (tableName) {\n      const mergedSchema =\n        ObjectRegistry.getAllSchemasAsDefinitions()[tableName];\n      if (mergedSchema) {\n        schemaDefinition = mergedSchema;\n      }\n    }\n  }\n\n  if (!schemaDefinition?.tableName) {\n    const providedFields =\n      registered.fields.size > 0 ? registered.fields : undefined;\n    await generateSchema(registered.constructor, providedFields);\n    schemaDefinition = ObjectRegistry.getSchema(className);\n\n    if (tableStrategy === 'sti') {\n      const tableName = ObjectRegistry.getTableName(className);\n      if (tableName) {\n        const mergedSchema =\n          ObjectRegistry.getAllSchemasAsDefinitions()[tableName];\n        if (mergedSchema) {\n          schemaDefinition = mergedSchema;\n        }\n      }\n    }\n  }\n\n  if (!schemaDefinition?.tableName) {\n    throw new Error(\n      `No schema definition found for class '${className}'. ` +\n        `Run the manifest generation/build step before preparing schema.`,\n    );\n  }\n\n  // Use the merged table definition for shared tables (especially STI).\n  // Per-class schema metadata can reflect only the current class, while\n  // the database table must include columns from all classes sharing it.\n  const mergedSchemaDefinition =\n    ObjectRegistry.getAllSchemasAsDefinitions()[schemaDefinition.tableName];\n  const effectiveSchemaDefinition = mergedSchemaDefinition ?? schemaDefinition;\n\n  const schemaManager = new SchemaManager(db, {\n    skipTriggers:\n      typeof (db as { exportTable?: unknown }).exportTable === 'function',\n  });\n  await schemaManager.ensureTable(effectiveSchemaDefinition);\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/schema/utils.ts"],"sourcesContent":["/**\n * Schema generation utilities - Node.js only\n *\n * These functions use SchemaGenerator which depends on node:crypto.\n * Separated from main utils.ts to prevent bundling in browser builds.\n *\n * SMRT handles ALL database maintenance directly.\n * SDK SQL remains a pure query/CRUD layer.\n */\n\nimport type { DatabaseInterface } from '@happyvertical/sql';\nimport type { SmrtObject } from '../object.js';\nimport { ObjectRegistry } from '../registry.js';\nimport type { FieldDefinition } from '../scanner/types.js';\nimport { tableNameFromClass } from '../utils.js';\nimport type { DatabaseEngine } from './ddl/types.js';\nimport { schemaForeignKeys } from './foreign-key-ddl.js';\nimport { SchemaManager } from './schema-manager.js';\n\nexport {\n  materializeManifestDDLForEngine,\n  tokenizeSQLDDLBody,\n} from './ddl/materialize-manifest.js';\n// Index-rendering helpers live in a separate file to avoid pulling the\n// heavyweight registry/collection module graph into the DDL strategies.\nexport {\n  assertIdentifierFits,\n  identifierByteLength,\n  isJsonPathIndex,\n  isStiSubtypeUniqueIndex,\n  MAX_IDENTIFIER_BYTES,\n  renderIndexTarget,\n  shortenIdentifier,\n} from './index-utils.js';\n// Structured manifest → executable DDL helpers (#2358). Re-exported here for\n// `@happyvertical/smrt-vitest`, which already imports this subpath.\nexport {\n  type CollectedManifestTable,\n  collectManifestTables,\n  type ManifestColumnLike,\n  type ManifestIndexLike,\n  type ManifestSchemaLike,\n  manifestColumnsToDefinitions,\n  manifestIndexesToDefinitions,\n  manifestSchemaToDefinition,\n  mergeSchemaDefinitionInto,\n  renderCollectedManifestTable,\n} from './manifest-schema.js';\n\n/**\n * Generates a complete database schema SQL statement for a class\n *\n * This is a thin wrapper around SchemaGenerator that provides the\n * single source of truth for schema generation. Uses ObjectRegistry\n * cached fields from AST manifest for consistent schema generation.\n *\n * **Note**: Uses dynamic import for SchemaGenerator to avoid bundling\n * Node.js-only code (node:crypto) in browser builds.\n *\n * @param ClassType - Class constructor to generate schema for\n * @param providedFields - Optional fields map (used during registration)\n * @returns SQL schema creation statement with CREATE TABLE and CREATE INDEX statements\n */\nexport async function generateSchema(\n  // Accepts any SmrtObject constructor: the registry-stored `typeof SmrtObject`\n  // as well as collection item classes whose construct signature is narrower\n  // than the full static surface. Only `.name` and the construct identity are\n  // used here. `never[]` keeps the construct signature contravariantly\n  // compatible with constructors that declare their own argument shapes.\n  ClassType: { new (...args: never[]): SmrtObject; readonly name: string },\n  providedFields?: Map<string, FieldDefinition>,\n  options: { engine?: DatabaseEngine } = {},\n) {\n  const className = ClassType.name;\n  const tableName = tableNameFromClass(ClassType);\n\n  // For external packages, ensure manifest is loaded before proceeding\n  if (!providedFields || providedFields.size === 0) {\n    await ObjectRegistry.ensureManifestLoaded(className);\n  }\n\n  // Use provided fields if available AND non-empty (during registration), otherwise get from registry\n  // NEW: Use getAllFields() to include inherited fields from parent classes\n  const cachedFields =\n    providedFields && providedFields.size > 0\n      ? providedFields\n      : await ObjectRegistry.getAllFields(className);\n\n  // Throw error if no fields found\n  if (cachedFields.size === 0) {\n    // Detect if running in test environment\n    const testGlobals = globalThis as {\n      describe?: unknown;\n      it?: unknown;\n    };\n    const isTestEnv =\n      process.env.NODE_ENV === 'test' ||\n      process.env.VITEST === 'true' ||\n      typeof testGlobals.describe !== 'undefined' ||\n      typeof testGlobals.it !== 'undefined';\n\n    const testHint = isTestEnv\n      ? `\\n\\n⚠️  Are you using 'smrt test'? ` +\n        `Tests require manifest generation.\\n` +\n        `   ✅ Use: smrt test\\n` +\n        `   ❌ NOT:  npx vitest\\n`\n      : '';\n\n    // Check if class is actually registered (decorator ran but no fields loaded)\n    const isRegistered = ObjectRegistry.hasClass(className);\n\n    if (isRegistered) {\n      // Class registered but no fields - manifest problem\n      throw new Error(\n        `No field metadata found for class '${className}'. ` +\n          `The class is registered (decorator ran) but has no field definitions. ` +\n          `This usually means the manifest file is missing or stale.` +\n          testHint,\n      );\n    } else {\n      // Class not registered - decorator never ran\n      throw new Error(\n        `Cannot generate schema for unregistered class '${className}'. ` +\n          `Ensure the class is decorated with @smrt() for schema generation to work. ` +\n          `Runtime introspection has been removed per issue #131.` +\n          testHint,\n      );\n    }\n  }\n\n  // Check if class uses STI strategy\n  const tableStrategy = ObjectRegistry.getTableStrategy(className);\n\n  // Dynamic import SchemaGenerator (Node.js-only, uses node:crypto)\n  // This prevents bundling it into browser builds\n  const { SchemaGenerator } = await import('./generator.js');\n  const generator = new SchemaGenerator();\n  const registeredClass = ObjectRegistry.getClass(className);\n  // Every key the generator reads from `@smrt()` config must be listed here:\n  // this bag is rebuilt by hand rather than passed through, so an unlisted\n  // option is silently unreachable at runtime while still appearing in the\n  // manifest. `indexes` (#2357) was exactly that. `conflictColumns` is the\n  // RESOLVED conflict target, not the raw decorator option: for a\n  // tenant-scoped class with no explicit `conflictColumns` the registry\n  // derives `[tenant_id, ...natural key]` (#2360), and `save()` upserts on\n  // exactly that, so the unique index generated here must match it.\n  const runtimeSchemaConfig = registeredClass?.config\n    ? {\n        conflictColumns: ObjectRegistry.getConflictColumns(className),\n        idType: registeredClass.config.idType,\n        indexes: registeredClass.config.indexes,\n        registry: ObjectRegistry,\n      }\n    : undefined;\n\n  let schemaDefinition: Awaited<\n    ReturnType<\n      InstanceType<typeof SchemaGenerator>['generateSchemaFromRegistry']\n    >\n  >;\n\n  if (tableStrategy === 'sti') {\n    // STI: Generate shared table for base class\n    const stiBase = ObjectRegistry.getSTIBase(className);\n\n    if (!stiBase) {\n      throw new Error(\n        `STI strategy detected for '${className}' but no STI base class found. ` +\n          `This should not happen - please report this bug.`,\n      );\n    }\n\n    // Only generate schema for the base class (not for children).\n    // R5-canon: `getSTIBase` returns the qualified name; compare against\n    // the qualified form of this class so an STI base isn't\n    // mis-classified as a subclass and skipped.\n    const qualifiedClassName =\n      registeredClass?.qualifiedName ?? registeredClass?.name ?? className;\n    if (qualifiedClassName === stiBase || className === stiBase) {\n      // This is the base class - generate STI schema\n      schemaDefinition = await generator.generateSTISchemaFromRegistry(\n        className,\n        tableName,\n        cachedFields,\n        runtimeSchemaConfig,\n      );\n    } else {\n      // This is a child class - return null or empty schema\n      // The base class schema already includes all fields\n      // Child classes don't need their own tables\n      return ''; // Empty SQL - table already created by base class\n    }\n  } else {\n    // CTI: Generate separate table for each class\n    schemaDefinition = generator.generateSchemaFromRegistry(\n      className,\n      tableName,\n      cachedFields,\n      runtimeSchemaConfig,\n    );\n  }\n\n  // Store the full schema definition in the registry\n  // This is critical for:\n  // - STI tables where descendants have additional columns (issue #427)\n  // - Per-engine DDL generation via SchemaManager\n  if (registeredClass) {\n    // Store the full SchemaDefinition for SchemaManager to use\n    registeredClass.schema = schemaDefinition;\n    // Also store generated DDL for backward compatibility\n    registeredClass.schema.ddl = generator.generateSQL(\n      schemaDefinition,\n      'sqlite',\n    );\n  }\n\n  return generator.generateSQL(schemaDefinition, options.engine);\n}\n\n/**\n * Ensure schema exists for a registered class.\n *\n * This compatibility helper is kept for tooling flows such as CLI commands that\n * explicitly prepare schema ahead of runtime. Core runtime no longer calls this\n * automatically.\n *\n * @deprecated Prefer explicit migration/bootstrap tooling. Runtime verifies\n * schema and fails fast when tables are missing.\n */\nexport async function ensureSchema(\n  db: DatabaseInterface,\n  className: string,\n): Promise<void> {\n  const registered = ObjectRegistry.getClass(className);\n  if (!registered) {\n    throw new Error(\n      `Cannot ensure schema for unregistered class '${className}'. ` +\n        `Ensure the class is decorated with @smrt() and registered in the ObjectRegistry.`,\n    );\n  }\n\n  const tableStrategy = ObjectRegistry.getTableStrategy(className);\n  if (tableStrategy === 'sti') {\n    const stiBase = ObjectRegistry.getSTIBase(className);\n    // R5-canon: `getSTIBase` returns the qualified name. Compare\n    // against the qualified form of `className` so an STI base isn't\n    // mis-classified as a child and recursed on. Falls back to a\n    // simple-name compare for classes without a package context.\n    const qualifiedClassName =\n      registered.qualifiedName ?? registered.name ?? className;\n    if (stiBase && stiBase !== qualifiedClassName && stiBase !== className) {\n      await ensureSchema(db, stiBase);\n      return;\n    }\n  }\n\n  let schemaDefinition = ObjectRegistry.getSchema(className);\n  if (tableStrategy === 'sti') {\n    const tableName = ObjectRegistry.getTableName(className);\n    if (tableName) {\n      const mergedSchema =\n        ObjectRegistry.getAllSchemasAsDefinitions()[tableName];\n      if (mergedSchema) {\n        schemaDefinition = mergedSchema;\n      }\n    }\n  }\n\n  if (!schemaDefinition?.tableName) {\n    const providedFields =\n      registered.fields.size > 0 ? registered.fields : undefined;\n    await generateSchema(registered.constructor, providedFields);\n    schemaDefinition = ObjectRegistry.getSchema(className);\n\n    if (tableStrategy === 'sti') {\n      const tableName = ObjectRegistry.getTableName(className);\n      if (tableName) {\n        const mergedSchema =\n          ObjectRegistry.getAllSchemasAsDefinitions()[tableName];\n        if (mergedSchema) {\n          schemaDefinition = mergedSchema;\n        }\n      }\n    }\n  }\n\n  if (!schemaDefinition?.tableName) {\n    throw new Error(\n      `No schema definition found for class '${className}'. ` +\n        `Run the manifest generation/build step before preparing schema.`,\n    );\n  }\n\n  // Use the merged table definition for shared tables (especially STI).\n  // Per-class schema metadata can reflect only the current class, while\n  // the database table must include columns from all classes sharing it.\n  const mergedSchemaDefinition =\n    ObjectRegistry.getAllSchemasAsDefinitions()[schemaDefinition.tableName];\n  const effectiveSchemaDefinition = mergedSchemaDefinition ?? schemaDefinition;\n\n  // A single requested class can be part of a mutual FK cycle. Build the\n  // complete registered dependency closure and let SchemaManager plan it as\n  // one unit; creating the requested table alone would leave the first\n  // PostgreSQL CREATE referencing a table that does not exist (#2413).\n  const allSchemas = ObjectRegistry.getAllSchemasAsDefinitions();\n  const required = new Map<string, typeof effectiveSchemaDefinition>();\n  const collect = (schema: typeof effectiveSchemaDefinition): void => {\n    if (required.has(schema.tableName)) return;\n    required.set(schema.tableName, schema);\n    const dependencies = new Set([\n      ...schema.dependencies,\n      ...schemaForeignKeys(schema).map(\n        (foreignKey) => foreignKey.referencesTable,\n      ),\n    ]);\n    for (const dependency of dependencies) {\n      const dependencySchema = allSchemas[dependency];\n      if (dependencySchema) collect(dependencySchema);\n    }\n  };\n  collect(effectiveSchemaDefinition);\n\n  const schemaManager = new SchemaManager(db, {\n    skipTriggers:\n      typeof (db as { exportTable?: unknown }).exportTable === 'function',\n  });\n  await schemaManager.ensureTables([...required.values()]);\n}\n"],"mappings":"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"}

package/dist/schema.js

@@ -1,3 +1,5 @@
+import { normalizeForeignKeyAction, resolveForeignKeyDeleteAction } from "./schema/foreign-key-policy.js";
+import { foreignKeyConstraintName, renderForeignKeyConstraint, schemaForeignKeys } from "./schema/foreign-key-ddl.js";
 import { BaseDDLStrategy } from "./schema/ddl/base-strategy.js";
 import { DuckDBStrategy } from "./schema/ddl/duckdb-strategy.js";
 import { JsonDuckDBStrategy } from "./schema/ddl/json-duckdb-strategy.js";
@@ -6,10 +8,11 @@ import { SQLiteStrategy } from "./schema/ddl/sqlite-strategy.js";
 import { detectEngine, generateDDLForEngine, generateMultiEngineDDL, getAllStrategies, getDDLStrategy } from "./schema/ddl/index.js";
 import { SYSTEM_TABLE_NAMES, getSystemTableShapes, parseTableShapes } from "./schema/system-table-shapes.js";
 import { SchemaGenerator } from "./schema/generator.js";
+import { planForeignKeyCreation } from "./schema/foreign-key-planner.js";
 import { SchemaManager, createSchemaManager } from "./schema/schema-manager.js";
 import { collectManifestTables, manifestColumnsToDefinitions, manifestIndexesToDefinitions, manifestSchemaToDefinition, mergeSchemaDefinitionInto, renderCollectedManifestTable } from "./schema/manifest-schema.js";
 import { LiveSchemaParityError, checkLiveSchemaParity, normalizeSqlType, parseIndexDefColumns } from "./schema/live-parity.js";
 import { SchemaCodeGenerator } from "./schema/code-generator.js";
 import { SchemaAggregator } from "./schema/schema-aggregator.js";
 import "./schema/index.js";
-export { BaseDDLStrategy, DuckDBStrategy, JsonDuckDBStrategy, LiveSchemaParityError, PostgresStrategy, SQLiteStrategy, SYSTEM_TABLE_NAMES, SchemaAggregator, SchemaCodeGenerator, SchemaGenerator, SchemaManager, checkLiveSchemaParity, collectManifestTables, createSchemaManager, detectEngine, generateDDLForEngine, generateMultiEngineDDL, getAllStrategies, getDDLStrategy, getSystemTableShapes, manifestColumnsToDefinitions, manifestIndexesToDefinitions, manifestSchemaToDefinition, mergeSchemaDefinitionInto, normalizeSqlType, parseIndexDefColumns, parseTableShapes, renderCollectedManifestTable };
+export { BaseDDLStrategy, DuckDBStrategy, JsonDuckDBStrategy, LiveSchemaParityError, PostgresStrategy, SQLiteStrategy, SYSTEM_TABLE_NAMES, SchemaAggregator, SchemaCodeGenerator, SchemaGenerator, SchemaManager, checkLiveSchemaParity, collectManifestTables, createSchemaManager, detectEngine, foreignKeyConstraintName, generateDDLForEngine, generateMultiEngineDDL, getAllStrategies, getDDLStrategy, getSystemTableShapes, manifestColumnsToDefinitions, manifestIndexesToDefinitions, manifestSchemaToDefinition, mergeSchemaDefinitionInto, normalizeForeignKeyAction, normalizeSqlType, parseIndexDefColumns, parseTableShapes, planForeignKeyCreation, renderCollectedManifestTable, renderForeignKeyConstraint, resolveForeignKeyDeleteAction, schemaForeignKeys };