@happyvertical/smrt-core 0.42.7 → 0.43.1

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

@@ -0,0 +1,109 @@
+import { quoteIdentifier } from "./sql-identifiers.js";
+import { foreignKeyConstraintName, renderForeignKeyConstraint, schemaDependenciesForEngine, schemaForeignKeys, schemaForeignKeysForEngine } from "./foreign-key-ddl.js";
+//#region src/schema/foreign-key-planner.ts
+/** Render the inverse of a PostgreSQL deferred ADD CONSTRAINT statement. */
+function renderDeferredForeignKeyDrop(table, foreignKey) {
+	return `ALTER TABLE ${quoteIdentifier(table)} DROP CONSTRAINT IF EXISTS ${quoteIdentifier(foreignKeyConstraintName(table, foreignKey))};`;
+}
+function stronglyConnectedComponents(names, dependencies) {
+	let nextIndex = 0;
+	const indexes = /* @__PURE__ */ new Map();
+	const lowLinks = /* @__PURE__ */ new Map();
+	const stack = [];
+	const onStack = /* @__PURE__ */ new Set();
+	const componentByName = /* @__PURE__ */ new Map();
+	let component = 0;
+	const visit = (name) => {
+		indexes.set(name, nextIndex);
+		lowLinks.set(name, nextIndex);
+		nextIndex++;
+		stack.push(name);
+		onStack.add(name);
+		for (const dependency of dependencies.get(name) || []) if (!indexes.has(dependency)) {
+			visit(dependency);
+			lowLinks.set(name, Math.min(lowLinks.get(name) ?? 0, lowLinks.get(dependency) ?? 0));
+		} else if (onStack.has(dependency)) lowLinks.set(name, Math.min(lowLinks.get(name) ?? 0, indexes.get(dependency) ?? 0));
+		if (lowLinks.get(name) !== indexes.get(name)) return;
+		while (stack.length > 0) {
+			const member = stack.pop();
+			onStack.delete(member);
+			componentByName.set(member, component);
+			if (member === name) break;
+		}
+		component++;
+	};
+	for (const name of names) if (!indexes.has(name)) visit(name);
+	return componentByName;
+}
+function omitForeignKeys(schema, omitted) {
+	if (omitted.size === 0) return schema;
+	const columns = Object.fromEntries(Object.entries(schema.columns).map(([name, definition]) => [name, omitted.has(name) ? {
+		...definition,
+		foreignKey: void 0
+	} : definition]));
+	return {
+		...schema,
+		columns,
+		foreignKeys: schemaForeignKeys(schema).filter((foreignKey) => !omitted.has(foreignKey.column))
+	};
+}
+/** Deterministically order new tables and define safe behavior for FK cycles. */
+function planForeignKeyCreation(input, engine) {
+	const byName = new Map([...input].sort((a, b) => a.tableName.localeCompare(b.tableName)).map((schema) => [schema.tableName, schema]));
+	const names = [...byName.keys()];
+	const dependencies = /* @__PURE__ */ new Map();
+	for (const [name, schema] of byName) {
+		for (const foreignKey of schemaForeignKeysForEngine(schema, engine)) renderForeignKeyConstraint(name, foreignKey);
+		dependencies.set(name, Array.from(new Set(schemaDependenciesForEngine(schema, engine).filter((target) => target !== name && byName.has(target)))).sort());
+	}
+	const components = stronglyConnectedComponents(names, dependencies);
+	const componentSizes = /* @__PURE__ */ new Map();
+	for (const id of components.values()) componentSizes.set(id, (componentSizes.get(id) || 0) + 1);
+	const isMutualCycle = (source, target) => {
+		const component = components.get(source);
+		return source !== target && component !== void 0 && component === components.get(target) && (componentSizes.get(component) || 0) > 1;
+	};
+	if (engine === "duckdb" || engine === "json") for (const [source, schema] of byName) for (const foreignKey of schemaForeignKeysForEngine(schema, engine)) {
+		if (source === foreignKey.referencesTable) throw new Error(`[DDL:${engine}] Foreign key ${source}.${foreignKey.column} is self-referential; DuckDB cannot insert self-referencing foreign keys safely.`);
+		if (foreignKey.onDelete === "CASCADE" || foreignKey.onDelete === "SET NULL") throw new Error(`[DDL:${engine}] Foreign key ${source}.${foreignKey.column} uses ON DELETE ${foreignKey.onDelete}, which DuckDB does not support. Use PostgreSQL/SQLite or keep this relationship app-side only with @crossPackageRef.`);
+		if (foreignKey.onUpdate !== void 0) throw new Error(`[DDL:${engine}] Foreign key ${source}.${foreignKey.column} uses ON UPDATE ${foreignKey.onUpdate}, which DuckDB does not support. DuckDB cannot preserve SMRT's ON UPDATE CASCADE contract; use PostgreSQL/SQLite or keep this relationship app-side only with @crossPackageRef.`);
+		if (isMutualCycle(source, foreignKey.referencesTable)) throw new Error(`[DDL:${engine}] Foreign-key cycle ${source}.${foreignKey.column} -> ${foreignKey.referencesTable}.${foreignKey.referencesColumn} cannot be created safely because DuckDB does not support ALTER TABLE ADD CONSTRAINT.`);
+	}
+	const visited = /* @__PURE__ */ new Set();
+	const visiting = /* @__PURE__ */ new Set();
+	const orderedNames = [];
+	const visit = (name) => {
+		if (visited.has(name) || visiting.has(name)) return;
+		visiting.add(name);
+		for (const dependency of dependencies.get(name) || []) visit(dependency);
+		visiting.delete(name);
+		visited.add(name);
+		orderedNames.push(name);
+	};
+	for (const name of names) visit(name);
+	const deferred = [];
+	const schemas = orderedNames.map((name) => {
+		const schema = byName.get(name);
+		if (engine !== "postgres") return schema;
+		const omitted = /* @__PURE__ */ new Set();
+		for (const foreignKey of schemaForeignKeysForEngine(schema, engine)) if (isMutualCycle(name, foreignKey.referencesTable)) {
+			omitted.add(foreignKey.column);
+			deferred.push({
+				table: name,
+				foreignKey
+			});
+		}
+		return omitForeignKeys(schema, omitted);
+	});
+	deferred.sort((a, b) => `${a.table}.${a.foreignKey.column}`.localeCompare(`${b.table}.${b.foreignKey.column}`));
+	return {
+		schemas,
+		cyclicTables: names.filter((name) => (componentSizes.get(components.get(name) ?? -1) || 0) > 1),
+		deferredConstraints: deferred,
+		deferredStatements: deferred.map(({ table, foreignKey }) => `ALTER TABLE ${quoteIdentifier(table)} ADD ${renderForeignKeyConstraint(table, foreignKey)};`)
+	};
+}
+//#endregion
+export { planForeignKeyCreation, renderDeferredForeignKeyDrop };
+
+//# sourceMappingURL=foreign-key-planner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"foreign-key-planner.js","names":[],"sources":["../../src/schema/foreign-key-planner.ts"],"sourcesContent":["import type { DatabaseEngine } from './ddl/types.js';\nimport {\n  foreignKeyConstraintName,\n  renderForeignKeyConstraint,\n  schemaDependenciesForEngine,\n  schemaForeignKeys,\n  schemaForeignKeysForEngine,\n} from './foreign-key-ddl.js';\nimport { quoteIdentifier } from './sql-identifiers.js';\nimport type { ForeignKeyDefinition, SchemaDefinition } from './types.js';\n\nexport interface ForeignKeyCreationPlan {\n  schemas: SchemaDefinition[];\n  deferredStatements: string[];\n  /** Tables participating in a multi-table strongly connected component. */\n  cyclicTables: string[];\n  /** PostgreSQL constraints omitted from CREATE TABLE and added afterward. */\n  deferredConstraints: Array<{\n    table: string;\n    foreignKey: ForeignKeyDefinition;\n  }>;\n}\n\n/** Render the inverse of a PostgreSQL deferred ADD CONSTRAINT statement. */\nexport function renderDeferredForeignKeyDrop(\n  table: string,\n  foreignKey: ForeignKeyDefinition,\n): string {\n  return `ALTER TABLE ${quoteIdentifier(table)} DROP CONSTRAINT IF EXISTS ${quoteIdentifier(\n    foreignKeyConstraintName(table, foreignKey),\n  )};`;\n}\n\nfunction stronglyConnectedComponents(\n  names: string[],\n  dependencies: Map<string, string[]>,\n): Map<string, number> {\n  let nextIndex = 0;\n  const indexes = new Map<string, number>();\n  const lowLinks = new Map<string, number>();\n  const stack: string[] = [];\n  const onStack = new Set<string>();\n  const componentByName = new Map<string, number>();\n  let component = 0;\n\n  const visit = (name: string): void => {\n    indexes.set(name, nextIndex);\n    lowLinks.set(name, nextIndex);\n    nextIndex++;\n    stack.push(name);\n    onStack.add(name);\n\n    for (const dependency of dependencies.get(name) || []) {\n      if (!indexes.has(dependency)) {\n        visit(dependency);\n        lowLinks.set(\n          name,\n          Math.min(lowLinks.get(name) ?? 0, lowLinks.get(dependency) ?? 0),\n        );\n      } else if (onStack.has(dependency)) {\n        lowLinks.set(\n          name,\n          Math.min(lowLinks.get(name) ?? 0, indexes.get(dependency) ?? 0),\n        );\n      }\n    }\n\n    if (lowLinks.get(name) !== indexes.get(name)) return;\n    while (stack.length > 0) {\n      const member = stack.pop() as string;\n      onStack.delete(member);\n      componentByName.set(member, component);\n      if (member === name) break;\n    }\n    component++;\n  };\n\n  for (const name of names) {\n    if (!indexes.has(name)) visit(name);\n  }\n  return componentByName;\n}\n\nfunction omitForeignKeys(\n  schema: SchemaDefinition,\n  omitted: Set<string>,\n): SchemaDefinition {\n  if (omitted.size === 0) return schema;\n  const columns = Object.fromEntries(\n    Object.entries(schema.columns).map(([name, definition]) => [\n      name,\n      omitted.has(name) ? { ...definition, foreignKey: undefined } : definition,\n    ]),\n  );\n  return {\n    ...schema,\n    columns,\n    foreignKeys: schemaForeignKeys(schema).filter(\n      (foreignKey) => !omitted.has(foreignKey.column),\n    ),\n  };\n}\n\n/** Deterministically order new tables and define safe behavior for FK cycles. */\nexport function planForeignKeyCreation(\n  input: readonly SchemaDefinition[],\n  engine: DatabaseEngine,\n): ForeignKeyCreationPlan {\n  const byName = new Map(\n    [...input]\n      .sort((a, b) => a.tableName.localeCompare(b.tableName))\n      .map((schema) => [schema.tableName, schema]),\n  );\n  const names = [...byName.keys()];\n  const dependencies = new Map<string, string[]>();\n  for (const [name, schema] of byName) {\n    for (const foreignKey of schemaForeignKeysForEngine(schema, engine)) {\n      // Validate externally supplied manifest actions before a dry-run can\n      // report an executable plan.\n      renderForeignKeyConstraint(name, foreignKey);\n    }\n    dependencies.set(\n      name,\n      Array.from(\n        new Set(\n          schemaDependenciesForEngine(schema, engine).filter(\n            (target) => target !== name && byName.has(target),\n          ),\n        ),\n      ).sort(),\n    );\n  }\n\n  const components = stronglyConnectedComponents(names, dependencies);\n  const componentSizes = new Map<number, number>();\n  for (const id of components.values()) {\n    componentSizes.set(id, (componentSizes.get(id) || 0) + 1);\n  }\n  const isMutualCycle = (source: string, target: string): boolean => {\n    const component = components.get(source);\n    return (\n      source !== target &&\n      component !== undefined &&\n      component === components.get(target) &&\n      (componentSizes.get(component) || 0) > 1\n    );\n  };\n\n  if (engine === 'duckdb' || engine === 'json') {\n    for (const [source, schema] of byName) {\n      for (const foreignKey of schemaForeignKeysForEngine(schema, engine)) {\n        if (source === foreignKey.referencesTable) {\n          throw new Error(\n            `[DDL:${engine}] Foreign key ${source}.${foreignKey.column} is self-referential; DuckDB cannot insert self-referencing foreign keys safely.`,\n          );\n        }\n        if (\n          foreignKey.onDelete === 'CASCADE' ||\n          foreignKey.onDelete === 'SET NULL'\n        ) {\n          throw new Error(\n            `[DDL:${engine}] Foreign key ${source}.${foreignKey.column} uses ON DELETE ${foreignKey.onDelete}, which DuckDB does not support. Use PostgreSQL/SQLite or keep this relationship app-side only with @crossPackageRef.`,\n          );\n        }\n        if (foreignKey.onUpdate !== undefined) {\n          throw new Error(\n            `[DDL:${engine}] Foreign key ${source}.${foreignKey.column} uses ON UPDATE ${foreignKey.onUpdate}, which DuckDB does not support. DuckDB cannot preserve SMRT's ON UPDATE CASCADE contract; use PostgreSQL/SQLite or keep this relationship app-side only with @crossPackageRef.`,\n          );\n        }\n        if (isMutualCycle(source, foreignKey.referencesTable)) {\n          throw new Error(\n            `[DDL:${engine}] Foreign-key cycle ${source}.${foreignKey.column} -> ${foreignKey.referencesTable}.${foreignKey.referencesColumn} cannot be created safely because DuckDB does not support ALTER TABLE ADD CONSTRAINT.`,\n          );\n        }\n      }\n    }\n  }\n\n  const visited = new Set<string>();\n  const visiting = new Set<string>();\n  const orderedNames: string[] = [];\n  const visit = (name: string): void => {\n    if (visited.has(name) || visiting.has(name)) return;\n    visiting.add(name);\n    for (const dependency of dependencies.get(name) || []) visit(dependency);\n    visiting.delete(name);\n    visited.add(name);\n    orderedNames.push(name);\n  };\n  for (const name of names) visit(name);\n\n  const deferred: Array<{ table: string; foreignKey: ForeignKeyDefinition }> =\n    [];\n  const schemas = orderedNames.map((name) => {\n    const schema = byName.get(name) as SchemaDefinition;\n    if (engine !== 'postgres') return schema;\n    const omitted = new Set<string>();\n    for (const foreignKey of schemaForeignKeysForEngine(schema, engine)) {\n      if (isMutualCycle(name, foreignKey.referencesTable)) {\n        omitted.add(foreignKey.column);\n        deferred.push({ table: name, foreignKey });\n      }\n    }\n    return omitForeignKeys(schema, omitted);\n  });\n\n  deferred.sort((a, b) =>\n    `${a.table}.${a.foreignKey.column}`.localeCompare(\n      `${b.table}.${b.foreignKey.column}`,\n    ),\n  );\n  return {\n    schemas,\n    cyclicTables: names.filter(\n      (name) => (componentSizes.get(components.get(name) ?? -1) || 0) > 1,\n    ),\n    deferredConstraints: deferred,\n    deferredStatements: deferred.map(\n      ({ table, foreignKey }) =>\n        `ALTER TABLE ${quoteIdentifier(table)} ADD ${renderForeignKeyConstraint(table, foreignKey)};`,\n    ),\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,21 @@
+import { ForeignKeyAction } from './types.js';
+/** Normalize decorator action spelling into the SQL vocabulary. */
+export declare function normalizeForeignKeyAction(value: unknown): ForeignKeyAction | undefined;
+/** Validate an externally supplied action rather than interpolating raw SQL. */
+export declare function requireForeignKeyAction(value: unknown, context: string): ForeignKeyAction;
+/**
+ * Resolve the one delete policy shared by app-side cascade and database DDL.
+ *
+ * A same-package reference that identifies the referencing row defaults to
+ * CASCADE. Tenant ids are scope markers rather than ownership edges, and all
+ * other references default to SQL NO ACTION.
+ */
+export declare function resolveForeignKeyDeleteAction(options: {
+    declared?: unknown;
+    isConflictColumn: boolean;
+    isTenantIdField: boolean;
+}): {
+    action: ForeignKeyAction;
+    declared: boolean;
+};
+//# sourceMappingURL=foreign-key-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"foreign-key-policy.d.ts","sourceRoot":"","sources":["../../src/schema/foreign-key-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AASnD,mEAAmE;AACnE,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,gBAAgB,GAAG,SAAS,CAM9B;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,GACd,gBAAgB,CAQlB;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;CAC1B,GAAG;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAelD"}

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

@@ -0,0 +1,41 @@
+//#region src/schema/foreign-key-policy.ts
+var FOREIGN_KEY_ACTIONS = /* @__PURE__ */ new Set([
+	"CASCADE",
+	"SET NULL",
+	"RESTRICT",
+	"NO ACTION"
+]);
+/** Normalize decorator action spelling into the SQL vocabulary. */
+function normalizeForeignKeyAction(value) {
+	if (typeof value !== "string") return void 0;
+	const normalized = value.trim().toUpperCase().replace(/_/g, " ");
+	return FOREIGN_KEY_ACTIONS.has(normalized) ? normalized : void 0;
+}
+/** Validate an externally supplied action rather than interpolating raw SQL. */
+function requireForeignKeyAction(value, context) {
+	const normalized = normalizeForeignKeyAction(value);
+	if (!normalized) throw new Error(`Invalid foreign-key action ${JSON.stringify(value)} for ${context}. Expected CASCADE, SET NULL, RESTRICT, or NO ACTION.`);
+	return normalized;
+}
+/**
+* Resolve the one delete policy shared by app-side cascade and database DDL.
+*
+* A same-package reference that identifies the referencing row defaults to
+* CASCADE. Tenant ids are scope markers rather than ownership edges, and all
+* other references default to SQL NO ACTION.
+*/
+function resolveForeignKeyDeleteAction(options) {
+	const declaredAction = options.declared === void 0 ? void 0 : requireForeignKeyAction(options.declared, "ON DELETE");
+	if (declaredAction) return {
+		action: declaredAction,
+		declared: true
+	};
+	return {
+		action: !options.isTenantIdField && options.isConflictColumn ? "CASCADE" : "NO ACTION",
+		declared: false
+	};
+}
+//#endregion
+export { normalizeForeignKeyAction, requireForeignKeyAction, resolveForeignKeyDeleteAction };
+
+//# sourceMappingURL=foreign-key-policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"foreign-key-policy.js","names":[],"sources":["../../src/schema/foreign-key-policy.ts"],"sourcesContent":["import type { ForeignKeyAction } from './types.js';\n\nconst FOREIGN_KEY_ACTIONS = new Set<ForeignKeyAction>([\n  'CASCADE',\n  'SET NULL',\n  'RESTRICT',\n  'NO ACTION',\n]);\n\n/** Normalize decorator action spelling into the SQL vocabulary. */\nexport function normalizeForeignKeyAction(\n  value: unknown,\n): ForeignKeyAction | undefined {\n  if (typeof value !== 'string') return undefined;\n  const normalized = value.trim().toUpperCase().replace(/_/g, ' ');\n  return FOREIGN_KEY_ACTIONS.has(normalized as ForeignKeyAction)\n    ? (normalized as ForeignKeyAction)\n    : undefined;\n}\n\n/** Validate an externally supplied action rather than interpolating raw SQL. */\nexport function requireForeignKeyAction(\n  value: unknown,\n  context: string,\n): ForeignKeyAction {\n  const normalized = normalizeForeignKeyAction(value);\n  if (!normalized) {\n    throw new Error(\n      `Invalid foreign-key action ${JSON.stringify(value)} for ${context}. Expected CASCADE, SET NULL, RESTRICT, or NO ACTION.`,\n    );\n  }\n  return normalized;\n}\n\n/**\n * Resolve the one delete policy shared by app-side cascade and database DDL.\n *\n * A same-package reference that identifies the referencing row defaults to\n * CASCADE. Tenant ids are scope markers rather than ownership edges, and all\n * other references default to SQL NO ACTION.\n */\nexport function resolveForeignKeyDeleteAction(options: {\n  declared?: unknown;\n  isConflictColumn: boolean;\n  isTenantIdField: boolean;\n}): { action: ForeignKeyAction; declared: boolean } {\n  const declaredAction =\n    options.declared === undefined\n      ? undefined\n      : requireForeignKeyAction(options.declared, 'ON DELETE');\n  if (declaredAction) {\n    return { action: declaredAction, declared: true };\n  }\n  return {\n    action:\n      !options.isTenantIdField && options.isConflictColumn\n        ? 'CASCADE'\n        : 'NO ACTION',\n    declared: false,\n  };\n}\n"],"mappings":";AAEA,IAAM,sCAAsB,IAAI,IAAsB;CACpD;CACA;CACA;CACA;AACF,CAAC;;AAGD,SAAgB,0BACd,OAC8B;CAC9B,IAAI,OAAO,UAAU,UAAU,OAAO,KAAA;CACtC,MAAM,aAAa,MAAM,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,QAAQ,MAAM,GAAG;CAC/D,OAAO,oBAAoB,IAAI,UAA8B,IACxD,aACD,KAAA;AACN;;AAGA,SAAgB,wBACd,OACA,SACkB;CAClB,MAAM,aAAa,0BAA0B,KAAK;CAClD,IAAI,CAAC,YACH,MAAM,IAAI,MACR,8BAA8B,KAAK,UAAU,KAAK,EAAE,OAAO,QAAQ,sDACrE;CAEF,OAAO;AACT;;;;;;;;AASA,SAAgB,8BAA8B,SAIM;CAClD,MAAM,iBACJ,QAAQ,aAAa,KAAA,IACjB,KAAA,IACA,wBAAwB,QAAQ,UAAU,WAAW;CAC3D,IAAI,gBACF,OAAO;EAAE,QAAQ;EAAgB,UAAU;CAAK;CAElD,OAAO;EACL,QACE,CAAC,QAAQ,mBAAmB,QAAQ,mBAChC,YACA;EACN,UAAU;CACZ;AACF"}

package/dist/schema/generator.d.ts

@@ -57,7 +57,9 @@ type SchemaGeneratorConfig = {
         };
         getDescendants(baseClassName: string): string[];
         getAllFields(className: string): Promise<Map<string, RegistryField>>;
+        getFields?(className: string): Map<string, RegistryField>;
         getSTIBase?(className: string): string | null;
+        getTableName?(className: string): string | undefined;
     };
 };
 export declare class SchemaGenerator {
@@ -71,6 +73,7 @@ export declare class SchemaGenerator {
     private shouldEmitDefault;
     private getRegistryTargetIdColumnType;
     private reconcileRegistryForeignKeyColumnTypes;
+    private applyRegistryForeignKeys;
     /**
      * Whether an existing index already leads with `leadingColumns`, in order.
      *

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

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

package/dist/schema/generator.js

@@ -1,3 +1,4 @@
+import { resolveForeignKeyDeleteAction } from "./foreign-key-policy.js";
 import { classnameToTablename } from "../utils/naming.js";
 import { formatDefaultValue, quoteIdentifier, quoteStringLiteral } from "./sql-identifiers.js";
 import { assertIdentifierFits, enforceIdentifierLimits } from "./index-utils.js";
@@ -9,6 +10,10 @@ import { createHash } from "node:crypto";
 * Schema generator for SMRT objects
 * Converts AST field definitions to database schema definitions
 */
+function getForeignKeyConstraintEngines(field) {
+	const constraint = field._meta?.constraint;
+	return typeof constraint === "object" ? [...constraint.engines] : void 0;
+}
 var SchemaGenerator = class {
 	/**
 	* Convert field type to SQL data type
@@ -67,6 +72,45 @@ var SchemaGenerator = class {
 			};
 		}
 	}
+	applyRegistryForeignKeys(columns, fields, conflictColumns, registry) {
+		const conflictSet = new Set(conflictColumns);
+		for (const [fieldName, field] of fields.entries()) {
+			if (field.type !== "foreignKey" || !field.related) continue;
+			const columnName = this.toSnakeCase(fieldName);
+			const column = columns[columnName];
+			if (!column) continue;
+			if (field._meta?.constraint === false) {
+				column.foreignKey = void 0;
+				continue;
+			}
+			const isTenantIdField = field.__tenancy?.isTenantIdField === true || field._meta?.__tenancy?.isTenantIdField === true;
+			if (isTenantIdField) {
+				column.foreignKey = void 0;
+				continue;
+			}
+			const [targetName, declaredTargetColumn] = field.related.split(".");
+			const targetBase = registry?.getSTIBase?.(targetName) || targetName;
+			const registeredTargetTable = registry?.getTableName?.(targetBase);
+			if (registry && !registeredTargetTable) {
+				column.foreignKey = void 0;
+				continue;
+			}
+			const targetColumn = declaredTargetColumn || Array.from(registry?.getFields?.(targetBase)?.entries() || []).find(([, targetField]) => targetField._meta?.primaryKey === true)?.[0] || "id";
+			const targetTable = registeredTargetTable || this.classNameToTableName(targetBase);
+			const { action } = resolveForeignKeyDeleteAction({
+				declared: field._meta?.onDelete,
+				isConflictColumn: conflictSet.has(columnName),
+				isTenantIdField
+			});
+			column.foreignKey = {
+				table: targetTable,
+				column: this.toSnakeCase(targetColumn),
+				onDelete: action,
+				onUpdate: "CASCADE",
+				...getForeignKeyConstraintEngines(field) ? { engines: getForeignKeyConstraintEngines(field) } : {}
+			};
+		}
+	}
 	/**
 	* Whether an existing index already leads with `leadingColumns`, in order.
 	*
@@ -483,7 +527,8 @@ var SchemaGenerator = class {
 			referencesTable: columnDef.foreignKey.table,
 			referencesColumn: columnDef.foreignKey.column,
 			onDelete: columnDef.foreignKey.onDelete,
-			onUpdate: columnDef.foreignKey.onUpdate
+			onUpdate: columnDef.foreignKey.onUpdate,
+			...columnDef.foreignKey.engines ? { engines: columnDef.foreignKey.engines } : {}
 		});
 		return foreignKeys;
 	}
@@ -570,14 +615,15 @@ var SchemaGenerator = class {
 				description: field._meta?.description
 			};
 			if (field._meta?.default !== void 0 && this.shouldEmitDefault(field, field._meta.default)) columnDef.defaultValue = field._meta.default;
-			if (field.type === "foreignKey") {
+			if (field.type === "foreignKey" && field._meta?.constraint !== false && field._meta?.__tenancy?.isTenantIdField !== true) {
 				const relatedName = field.related;
 				const onDeleteAction = field._meta?.onDelete;
 				if (relatedName) columnDef.foreignKey = {
 					table: this.classNameToTableName(relatedName),
 					column: "id",
 					onDelete: onDeleteAction || "CASCADE",
-					onUpdate: "CASCADE"
+					onUpdate: "CASCADE",
+					...getForeignKeyConstraintEngines(field) ? { engines: getForeignKeyConstraintEngines(field) } : {}
 				};
 			}
 			if ((field._meta?.indexed === true || field.indexed === true) && !columnDef.foreignKey && !columnDef.unique && !columnDef.primaryKey) indexedColumns.add(this.toSnakeCase(fieldName));
@@ -596,9 +642,11 @@ var SchemaGenerator = class {
 			description: "Last update timestamp"
 		};
 		this.reconcileRegistryForeignKeyColumnTypes(columns, fields, config?.registry);
+		const resolvedConflict = this.resolveConflictTarget("cti", columns, config);
+		this.applyRegistryForeignKeys(columns, fields, resolvedConflict.conflictColumns, config?.registry);
 		const indexes = [];
 		if (!hasCustomPK) {
-			const { conflictColumns, tenantColumn } = this.resolveConflictTarget("cti", columns, config);
+			const { conflictColumns, tenantColumn } = resolvedConflict;
 			if (!this.conflictColumnsArePrimaryKey(conflictColumns, columns)) indexes.push({
 				name: conflictIndexName(tableName, conflictColumns, tenantColumn),
 				columns: conflictColumns,
@@ -623,7 +671,7 @@ var SchemaGenerator = class {
 			indexes,
 			triggers: [],
 			foreignKeys: this.extractForeignKeys(columns),
-			dependencies: [],
+			dependencies: this.extractForeignKeys(columns).map((foreignKey) => foreignKey.referencesTable).filter((dependency) => dependency !== tableName),
 			version: createHash("sha256").update(JSON.stringify(columns)).digest("hex").substring(0, 8),
 			packageName: "runtime",
 			baseClass: "SmrtObject"
@@ -755,14 +803,15 @@ var SchemaGenerator = class {
 					description: field._meta?.description
 				};
 				if (field._meta?.default !== void 0 && this.shouldEmitDefault(field, field._meta.default)) columnDef.defaultValue = field._meta.default;
-				if (field.type === "foreignKey") {
+				if (field.type === "foreignKey" && field._meta?.constraint !== false && field._meta?.__tenancy?.isTenantIdField !== true) {
 					const relatedName = field.related;
 					const onDeleteAction = field._meta?.onDelete;
 					if (relatedName) columnDef.foreignKey = {
 						table: this.classNameToTableName(relatedName),
 						column: "id",
 						onDelete: onDeleteAction || "CASCADE",
-						onUpdate: "CASCADE"
+						onUpdate: "CASCADE",
+						...getForeignKeyConstraintEngines(field) ? { engines: getForeignKeyConstraintEngines(field) } : {}
 					};
 				}
 				if ((field._meta?.indexed === true || field.indexed === true) && !columnDef.foreignKey) indexedStiColumns.add(columnName);
@@ -781,9 +830,11 @@ var SchemaGenerator = class {
 			defaultValue: "current_timestamp",
 			description: "Last update timestamp"
 		};
+		const resolvedConflict = this.resolveConflictTarget("sti", columns, config);
 		for (const className of allClassNames) {
 			const classFields = await ObjectRegistry.getAllFields(className);
 			this.reconcileRegistryForeignKeyColumnTypes(columns, classFields, ObjectRegistry);
+			this.applyRegistryForeignKeys(columns, classFields, resolvedConflict.conflictColumns, ObjectRegistry);
 		}
 		const indexes = [];
 		this.emitStiConflictIndex(indexes, columns, tableName, config);
@@ -819,7 +870,7 @@ var SchemaGenerator = class {
 			indexes,
 			triggers: [],
 			foreignKeys: this.extractForeignKeys(columns),
-			dependencies: [],
+			dependencies: this.extractForeignKeys(columns).map((foreignKey) => foreignKey.referencesTable).filter((dependency) => dependency !== tableName),
 			version: createHash("sha256").update(JSON.stringify({
 				columns,
 				baseClassName,
@@ -949,8 +1000,8 @@ var SchemaGenerator = class {
 				jsonPath: idx.jsonPath
 			})),
 			triggers: [],
-			foreignKeys: [],
-			dependencies: [],
+			foreignKeys: this.extractForeignKeys(this.convertManifestColumnsToSchemaColumns(columns)),
+			dependencies: this.extractForeignKeys(this.convertManifestColumnsToSchemaColumns(columns)).map((foreignKey) => foreignKey.referencesTable).filter((dependency) => dependency !== tableName),
 			version: "",
 			packageName: ""
 		};
@@ -1046,8 +1097,8 @@ var SchemaGenerator = class {
 				jsonPath: idx.jsonPath
 			})),
 			triggers: [],
-			foreignKeys: [],
-			dependencies: [],
+			foreignKeys: this.extractForeignKeys(this.convertManifestColumnsToSchemaColumns(columns)),
+			dependencies: this.extractForeignKeys(this.convertManifestColumnsToSchemaColumns(columns)).map((foreignKey) => foreignKey.referencesTable).filter((dependency) => dependency !== tableName),
 			version: "",
 			packageName: ""
 		};
@@ -1108,7 +1159,8 @@ var SchemaGenerator = class {
 			referenceKind: col.referenceKind,
 			notNull: col.notNull,
 			unique: col.unique,
-			defaultValue: col.default
+			defaultValue: col.default,
+			foreignKey: col.foreignKey ? { ...col.foreignKey } : void 0
 		};
 		return columns;
 	}