@happyvertical/smrt-core 0.49.3 → 0.49.5

package/dist/registry/schema-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-builder.js","names":[],"sources":["../../src/registry/schema-builder.ts"],"sourcesContent":["/**\n * Schema building logic for the SMRT ObjectRegistry.\n *\n * Extracted from registry.ts as part of issue #1006.\n */\n\nimport { ObjectRegistry } from '../registry';\nimport type { FieldDefinition } from '../scanner/types.js';\nimport { conflictIndexName } from '../schema/conflict-target.js';\nimport { getDDLStrategy } from '../schema/ddl/index.js';\nimport type { DatabaseEngine } from '../schema/ddl/types.js';\nimport {\n  renderForeignKeyConstraint,\n  schemaForeignKeys,\n} from '../schema/foreign-key-ddl.js';\nimport {\n  requireForeignKeyAction,\n  resolveForeignKeyDeleteAction,\n} from '../schema/foreign-key-policy.js';\nimport { shortenIdentifier } from '../schema/index-utils.js';\nimport {\n  formatDefaultValue as formatDefaultValueShared,\n  quoteIdentifier,\n} from '../schema/sql-identifiers.js';\nimport type {\n  ColumnDefinition,\n  IndexDefinition,\n  SchemaDefinition,\n  SQLDataType,\n} from '../schema/types.js';\nimport { classnameToTablename, toSnakeCase } from '../utils';\nimport {\n  type CollectionRegistrationLookup,\n  isCollectionRegistration,\n} from './collection-resolution';\nimport { isFrameworkBaseClass } from './framework-base-classes';\nimport { readFieldAttribute } from './manifest-field-merge';\nimport { findClass } from './name-resolver';\nimport { getClasses, getCollectionTableNames } from './shared-state';\nimport type { RegisteredClass } from './types';\n\ntype ForeignKeyAction = NonNullable<\n  NonNullable<ColumnDefinition['foreignKey']>['onDelete']\n>;\n\nconst collectionRegistrationLookup: CollectionRegistrationLookup = {\n  findClass,\n  findClassInPackage: (packageName, className) =>\n    ObjectRegistry.getClassInPackage(packageName, className),\n  getInheritanceChain: (className) =>\n    ObjectRegistry.getInheritanceChain(className),\n};\n\nfunction applyDecoratorSqlTypeOverrides(\n  className: string,\n  columns: Record<string, ColumnDefinition>,\n): Record<string, ColumnDefinition> {\n  const decorators = ObjectRegistry.getFieldDecorators(className);\n  if (!decorators.size) {\n    return columns;\n  }\n\n  for (const [fieldName, options] of decorators) {\n    if (!options?.sqlType) {\n      continue;\n    }\n\n    const columnName = toSnakeCase(fieldName);\n    const existing = columns[columnName];\n    if (!existing) {\n      continue;\n    }\n\n    const referenceKind = getReferenceKind(options as FieldDefinition);\n    columns[columnName] = {\n      ...existing,\n      type: String(options.sqlType).toUpperCase() as SQLDataType,\n      ...(referenceKind ? { referenceKind } : {}),\n    };\n  }\n\n  return columns;\n}\n\nfunction mergeRuntimeFieldColumns(\n  className: string,\n  schemaColumns: Record<string, ColumnDefinition> | undefined,\n  fields: Map<string, FieldDefinition>,\n  options?: FieldsToColumnsOptions,\n): Record<string, ColumnDefinition> {\n  const columnsToUse = { ...(schemaColumns || {}) };\n\n  if (fields.size > 0) {\n    const fieldColumns = fieldsToColumns(fields, options);\n    for (const [columnName, columnDef] of Object.entries(fieldColumns)) {\n      if (!columnsToUse[columnName]) {\n        columnsToUse[columnName] = columnDef;\n      }\n    }\n\n    for (const [fieldName, fieldDef] of fields) {\n      const columnName = toSnakeCase(fieldName);\n      const existing = columnsToUse[columnName];\n      if (!existing) {\n        continue;\n      }\n\n      const sqlType =\n        fieldDef._meta?.sqlType ||\n        (fieldDef as unknown as { sqlType?: string }).sqlType;\n      const referenceKind = getReferenceKind(fieldDef);\n      columnsToUse[columnName] = {\n        ...existing,\n        ...(sqlType\n          ? { type: String(sqlType).toUpperCase() as SQLDataType }\n          : {}),\n        ...(referenceKind ? { referenceKind } : {}),\n      };\n    }\n  }\n\n  applyDecoratorSqlTypeOverrides(className, columnsToUse);\n  return columnsToUse;\n}\n\nfunction getReferenceKind(\n  fieldDef: FieldDefinition,\n): ColumnDefinition['referenceKind'] | undefined {\n  if (\n    (\n      fieldDef as unknown as {\n        __tenancy?: { isTenantIdField?: boolean };\n      }\n    ).__tenancy?.isTenantIdField ||\n    fieldDef._meta?.__tenancy?.isTenantIdField\n  ) {\n    return 'tenantId';\n  }\n\n  if (fieldDef.type === 'foreignKey') {\n    return 'foreignKey';\n  }\n\n  if (fieldDef.type === 'crossPackageRef') {\n    return 'crossPackageRef';\n  }\n\n  return undefined;\n}\n\nfunction shouldEmitDefault(\n  fieldDef: FieldDefinition,\n  sqlType: SQLDataType,\n  defaultValue: unknown,\n) {\n  return !(\n    getReferenceKind(fieldDef) === 'tenantId' &&\n    sqlType === 'UUID' &&\n    defaultValue === ''\n  );\n}\n\n/**\n * Fallback base columns for a table whose contributing class carries no\n * manifest columns.\n *\n * These mirror what the manifest schema generators emit for the same table\n * (`generateSchemaFromManifest` / `generateSTISchemaFromManifest`), so a table\n * assembled from runtime field metadata alone has the same NOT NULL and\n * DEFAULT shape as one assembled from a manifest. Divergence here is what made\n * the merged table shape depend on which class registered first (#2372).\n */\nfunction createBaseColumns(\n  registered: {\n    config?: { idType?: 'uuid' | 'text' };\n  },\n  isSTI: boolean,\n): Record<string, ColumnDefinition> {\n  const baseColumns: Record<string, ColumnDefinition> = {\n    id: {\n      type: registered.config?.idType === 'text' ? 'TEXT' : 'UUID',\n      primaryKey: true,\n      notNull: true,\n      referenceKind: 'id',\n    },\n    slug: { type: 'TEXT', notNull: true },\n    context: { type: 'TEXT', notNull: true, defaultValue: '' },\n    created_at: {\n      type: 'TIMESTAMP',\n      notNull: true,\n      defaultValue: 'current_timestamp',\n    },\n    updated_at: {\n      type: 'TIMESTAMP',\n      notNull: true,\n      defaultValue: 'current_timestamp',\n    },\n  };\n\n  // STI tables also carry the discriminator and the meta payload column\n  // (issue #690: db:diff needs them to detect schema changes).\n  if (isSTI) {\n    baseColumns._meta_type = { type: 'TEXT', notNull: true };\n    baseColumns._meta_data = { type: 'JSON', notNull: false };\n  }\n\n  return baseColumns;\n}\n\n/**\n * Get cached schema definition for a registered class\n *\n * @param name - Name of the registered class\n * @returns Schema definition or undefined if not found\n * @example\n * ```typescript\n * const schema = getSchema('Product');\n * console.log(schema.tableName); // 'products'\n * console.log(schema.ddl);       // 'CREATE TABLE...'\n * ```\n */\nexport function getSchema(name: string): SchemaDefinition | undefined {\n  // Issue #951: Use findClass for multi-strategy lookup\n  const registered = findClass(name);\n  return registered?.schema;\n}\n\n/**\n * Get SQL DDL statement for a registered class\n *\n * @param name - Name of the registered class\n * Cached manifest DDL contains abstract types and is not safe to execute on\n * PostgreSQL. New executable paths must pass a target engine. Omitting it is\n * retained for backward compatibility with consumers that only inspect the\n * legacy engine-neutral manifest string.\n *\n * @param engine - Database engine that will execute the DDL\n * @returns Engine-specific SQL DDL, or the legacy cached DDL when omitted\n * @example\n * ```typescript\n * const ddl = ObjectRegistry.getSchemaDDL('Product', 'postgres');\n * await db.query(ddl);\n * ```\n */\nexport function getSchemaDDL(\n  name: string,\n  engine?: DatabaseEngine,\n): string | undefined {\n  const schema = getSchema(name);\n  if (!schema) return undefined;\n  if (engine && Object.keys(schema.columns).length === 0) {\n    throw new Error(\n      `Cannot materialize schema '${name}' for ${engine}: the manifest has no structured columns`,\n    );\n  }\n  return engine\n    ? getDDLStrategy(engine).generateCreateTable(schema)\n    : schema.ddl;\n}\n\n/**\n * Get table name for a registered class\n *\n * @param name - Name of the registered class\n * @returns Table name or undefined if not found\n * @example\n * ```typescript\n * const tableName = getTableName('Product');\n * console.log(tableName); // 'products'\n * ```\n */\nexport function getTableName(name: string): string | undefined {\n  // Check if this is a collection class - collections have their own tableName mapping\n  const collectionTableName = getCollectionTableNames().get(name);\n  if (collectionTableName) {\n    return collectionTableName;\n  }\n\n  // For STI classes, return the STI base class's table name.\n  // R5-canon: `getSTIBase` returns the qualified name; resolve `name`\n  // (which may be simple) to its registration's qualified form for the\n  // comparison.\n  const stiBase = ObjectRegistry.getSTIBase(name);\n  const registered = ObjectRegistry.getClass(name);\n  const qualifiedName = registered?.qualifiedName ?? registered?.name ?? name;\n  if (stiBase && stiBase !== qualifiedName) {\n    return getSchema(stiBase)?.tableName;\n  }\n  return getSchema(name)?.tableName;\n}\n\nfunction withConflictIndex(\n  tableName: string,\n  columns: Record<string, ColumnDefinition>,\n  indexes: IndexDefinition[],\n  conflictColumns: string[],\n): IndexDefinition[] {\n  if (\n    conflictColumns.length === 0 ||\n    !conflictColumns.every((column) => columns[column])\n  ) {\n    return indexes;\n  }\n\n  // `ON CONFLICT (id)` binds to the primary-key constraint itself; a second\n  // unique index over the primary key column set adds nothing (#2359, A5).\n  // Kept in step with SchemaGenerator.conflictColumnsArePrimaryKey().\n  const primaryKeyColumns = Object.entries(columns)\n    .filter(([, column]) => column.primaryKey === true)\n    .map(([name]) => name);\n  if (\n    primaryKeyColumns.length > 0 &&\n    primaryKeyColumns.length === conflictColumns.length &&\n    primaryKeyColumns.every((column) => conflictColumns.includes(column))\n  ) {\n    return indexes;\n  }\n\n  const hasConflictIndex = indexes.some(\n    (index) =>\n      index.unique === true &&\n      !index.where &&\n      !index.jsonPath &&\n      index.columns.length === conflictColumns.length &&\n      index.columns.every((column) => conflictColumns.includes(column)),\n  );\n  if (hasConflictIndex) return indexes;\n\n  // Same stable naming as SchemaGenerator (`schema/conflict-target.ts`), so\n  // a manifest built before the runtime learned the tenant-aware default\n  // (#2360) has its stale `<table>_slug_context_idx` REPLACED in place here\n  // — the differ then swaps the live index by name — instead of a second,\n  // suffixed unique index being appended beside the old global one.\n  const tenantColumn = Object.entries(columns).find(\n    ([, column]) => column.referenceKind === 'tenantId',\n  )?.[0];\n  // The composed name can exceed PostgreSQL's 63-byte limit on a long table.\n  // Shortening here (rather than inside conflictIndexName) keeps the generator\n  // paths, which run enforceIdentifierLimits() over their whole index list,\n  // and this migrate leg agreeing on the final name (#2374).\n  const name = shortenIdentifier(\n    conflictIndexName(tableName, conflictColumns, tenantColumn),\n  );\n  const conflictIndex: IndexDefinition = {\n    name,\n    columns: conflictColumns,\n    unique: true,\n  };\n  if (indexes.some((index) => index.name === name)) {\n    return indexes.map((index) =>\n      index.name === name ? conflictIndex : index,\n    );\n  }\n  return [...indexes, conflictIndex];\n}\n\n/**\n * A registered class that contributes columns to one physical table.\n *\n * For a single-table-inheritance hierarchy every class in the hierarchy is a\n * contributor to the same table.\n */\ninterface TableContributor {\n  registered: RegisteredClass;\n  simpleName: string;\n  qualifiedName: string;\n  isSTI: boolean;\n  /** True when this class is the STI base that owns the table. */\n  isSTIBase: boolean;\n  /** Inheritance depth; ancestors sort before descendants. */\n  depth: number;\n  /** Conflict-column lookup key (the STI base for STI members). */\n  conflictKey: string;\n}\n\n/**\n * A merged physical table assembled from every class that contributes to it.\n */\ninterface MergedTableSchema {\n  tableName: string;\n  columns: Record<string, ColumnDefinition>;\n  indexes: IndexDefinition[];\n  ddl: string;\n  isSTI: boolean;\n  conflictColumns: string[];\n}\n\nfunction applyContributorForeignKeys(\n  tableSchema: MergedTableSchema,\n  contributor: TableContributor,\n): void {\n  const conflictColumns = new Set(tableSchema.conflictColumns);\n  for (const [fieldName, field] of contributor.registered.fields) {\n    if (field.type !== 'foreignKey' || !field.related) continue;\n    const columnName = toSnakeCase(fieldName);\n    const column = tableSchema.columns[columnName];\n    if (!column) continue;\n    if (\n      field._meta?.__tenancy?.isTenantIdField === true ||\n      (\n        field as FieldDefinition & {\n          __tenancy?: { isTenantIdField?: boolean };\n        }\n      ).__tenancy?.isTenantIdField === true\n    ) {\n      column.foreignKey = undefined;\n      continue;\n    }\n    const [legacyTargetName, declaredTargetColumn] = field.related.split('.');\n    const resolvedTarget = ObjectRegistry.resolveRelationshipTarget(\n      contributor.qualifiedName,\n      fieldName,\n    );\n    if (resolvedTarget === null) {\n      throw new Error(\n        `Cannot resolve foreign key ${contributor.qualifiedName}.${fieldName}: target constructor is unregistered or the target name is ambiguous`,\n      );\n    }\n    const targetName = resolvedTarget ?? legacyTargetName;\n    const targetBase = ObjectRegistry.getSTIBase(targetName) || targetName;\n    const registeredTarget = ObjectRegistry.getClass(targetBase);\n    const targetColumn =\n      declaredTargetColumn ||\n      Array.from(ObjectRegistry.getFields(targetBase).entries()).find(\n        ([, targetField]) => targetField._meta?.primaryKey === true,\n      )?.[0] ||\n      'id';\n    if (registeredTarget && !field._meta?.sqlType) {\n      const targetColumnName = toSnakeCase(targetColumn);\n      const targetColumnType =\n        registeredTarget.schema?.columns?.[targetColumnName]?.type ||\n        (targetColumnName === 'id'\n          ? registeredTarget.config.idType === 'text'\n            ? 'TEXT'\n            : 'UUID'\n          : undefined);\n      if (targetColumnType) {\n        column.type = targetColumnType;\n      }\n    }\n    if (field._meta?.constraint === false) {\n      column.foreignKey = undefined;\n      continue;\n    }\n    // A manifest may carry explicit actions that predate or differ from the\n    // runtime decorator defaults. Merging runtime fields must not erase them.\n    // The fallback produced from runtime fields, however, must be replaced so\n    // conflict columns receive the same default CASCADE as app-side cleanup.\n    const manifestForeignKey =\n      contributor.registered.schema?.columns?.[columnName]?.foreignKey;\n    if (manifestForeignKey) {\n      column.foreignKey = manifestForeignKey;\n      continue;\n    }\n    // A decorator-only runtime field has no authoritative physical target\n    // until that target is registered. Scanner-produced manifests clear this\n    // shape too; only an explicit manifest FK above may survive unloaded\n    // runtime classes (the manifest-authority contract from #1120).\n    if (!registeredTarget) {\n      column.foreignKey = undefined;\n      continue;\n    }\n    const targetTable =\n      ObjectRegistry.getTableName(targetBase) ||\n      classnameToTablename(targetBase);\n    const { action } = resolveForeignKeyDeleteAction({\n      declared: field._meta?.onDelete,\n      isConflictColumn: conflictColumns.has(columnName),\n      isTenantIdField: false,\n    });\n    column.foreignKey = {\n      table: targetTable,\n      column: toSnakeCase(targetColumn),\n      onDelete: action,\n      onUpdate: 'CASCADE',\n      ...(typeof field._meta?.constraint === 'object'\n        ? { engines: [...field._meta.constraint.engines] }\n        : {}),\n    };\n  }\n}\n\n/**\n * Resolve the physical table a registered class writes to.\n *\n * STI subclasses are folded onto their base's table. Returns `undefined` when\n * the class has no table (for example an unresolvable manifest stub).\n *\n * R5-canon: STI lookups use the qualified key so a colliding simple name in\n * another package cannot yield the wrong table strategy or STI base and move\n * this class's columns under that other package's table.\n */\nfunction resolveContributorTable(\n  registered: RegisteredClass,\n  fallbackName: string,\n): { tableName: string; contributor: TableContributor } | undefined {\n  const simpleName = registered.name || fallbackName;\n  const qualifiedName = registered.qualifiedName ?? simpleName;\n\n  // STI subclasses loaded from external manifests can arrive with a null\n  // tableName; registerFromManifest() then derives one from the class name.\n  // Adopt the STI base's tableName instead so the subclass lands on the\n  // shared table (issue #703).\n  if (!registered.schema?.tableName && registered.extends) {\n    if (ObjectRegistry.getTableStrategy(qualifiedName) === 'sti') {\n      const stiBaseName = ObjectRegistry.getSTIBase(qualifiedName);\n      if (stiBaseName && stiBaseName !== qualifiedName) {\n        const stiBaseClass = findClass(stiBaseName);\n        if (stiBaseClass?.schema?.tableName) {\n          if (!registered.schema) {\n            registered.schema = {\n              tableName: '',\n              ddl: '',\n              columns: {},\n              indexes: [],\n              triggers: [],\n              foreignKeys: [],\n              dependencies: [],\n              version: '',\n            };\n          }\n          registered.schema.tableName = stiBaseClass.schema.tableName;\n        }\n      }\n    }\n  }\n\n  if (!registered.schema?.tableName) {\n    return undefined;\n  }\n\n  let tableName = registered.schema.tableName;\n  const tableStrategy = ObjectRegistry.getTableStrategy(qualifiedName);\n  const isSTI = tableStrategy === 'sti';\n  let isSTIBase = isSTI;\n  let conflictKey = qualifiedName;\n\n  if (isSTI) {\n    const stiBaseName = ObjectRegistry.getSTIBase(qualifiedName);\n    if (stiBaseName) {\n      conflictKey = stiBaseName;\n      if (stiBaseName !== qualifiedName) {\n        isSTIBase = false;\n        // STI subclasses serialize to the base class's table even when they\n        // carry a tableName of their own (issue #693).\n        const stiBaseClass = findClass(stiBaseName);\n        if (stiBaseClass?.schema?.tableName) {\n          tableName = stiBaseClass.schema.tableName;\n        }\n      }\n    }\n  }\n\n  return {\n    tableName,\n    contributor: {\n      registered,\n      simpleName,\n      qualifiedName,\n      isSTI,\n      isSTIBase,\n      depth: ObjectRegistry.getInheritanceChain(qualifiedName).length,\n      conflictKey,\n    },\n  };\n}\n\n/**\n * Order the classes that share one table deterministically.\n *\n * The first contributor seeds the table: it supplies the base columns, the\n * `idType`, the conflict columns and the cached DDL, and its columns win every\n * merge conflict. Registration order must not decide that, or the same\n * hierarchy yields a different table shape depending on which class a manifest\n * happens to list first — child-first dropped NOT NULL and DEFAULT from the\n * base columns (#2372).\n *\n * Order: the STI base first, then ancestors before descendants, then by\n * qualified name so the result is a total order.\n */\nfunction sortTableContributors(contributors: TableContributor[]) {\n  return [...contributors].sort((a, b) => {\n    if (a.isSTIBase !== b.isSTIBase) {\n      return a.isSTIBase ? -1 : 1;\n    }\n    if (a.depth !== b.depth) {\n      return a.depth - b.depth;\n    }\n    return a.qualifiedName.localeCompare(b.qualifiedName);\n  });\n}\n\n/**\n * Assemble every physical table from the classes that contribute to it.\n *\n * Shared by {@link getAllSchemas} and {@link getAllSchemasAsDefinitions} so\n * both produce the same merged shape. The result depends only on what is\n * registered, never on the order it was registered in.\n */\nfunction buildMergedTableSchemas(): Record<string, MergedTableSchema> {\n  // Pass 1: group contributing classes by physical table.\n  const contributorsByTable = new Map<string, TableContributor[]>();\n\n  for (const [className, registered] of getClasses()) {\n    // Collection classes have no table of their own; their schemas carry\n    // collection properties (loaded, options, ...) rather than columns.\n    if (\n      isCollectionRegistration(\n        className,\n        registered,\n        collectionRegistrationLookup,\n      )\n    ) {\n      continue;\n    }\n\n    // Framework abstract base classes (SmrtObject, SmrtClass, ...) are\n    // scaffolding, not resources — they produce no table (#2642).\n    if (isFrameworkBaseClass(registered.name, registered.packageName)) {\n      continue;\n    }\n\n    const resolved = resolveContributorTable(registered, className);\n    if (!resolved) {\n      continue;\n    }\n\n    const existing = contributorsByTable.get(resolved.tableName);\n    if (existing) {\n      existing.push(resolved.contributor);\n    } else {\n      contributorsByTable.set(resolved.tableName, [resolved.contributor]);\n    }\n  }\n\n  // Pass 2: merge each table's contributors in deterministic order.\n  const tableSchemas: Record<string, MergedTableSchema> = {};\n\n  for (const [tableName, contributors] of contributorsByTable) {\n    for (const contributor of sortTableContributors(contributors)) {\n      const { registered, simpleName, isSTI } = contributor;\n      const conflictColumns = ObjectRegistry.getConflictColumns(\n        contributor.conflictKey,\n      );\n\n      // The manifest schema stays authoritative for the columns it defines.\n      // Runtime field metadata backfills columns the manifest never had (for\n      // example tenantScoped injections) and applies explicit sqlType\n      // overrides, without erasing richer manifest metadata.\n      const columnsToUse = mergeRuntimeFieldColumns(\n        simpleName,\n        registered.schema?.columns,\n        registered.fields,\n        { stiUnionColumns: isSTI, conflictColumns },\n      );\n\n      let tableSchema = tableSchemas[tableName];\n      if (!tableSchema) {\n        tableSchema = {\n          tableName,\n          columns: {\n            ...createBaseColumns(registered, isSTI),\n            ...columnsToUse,\n          },\n          indexes: [],\n          ddl: registered.schema?.ddl || '',\n          isSTI,\n          conflictColumns,\n        };\n        tableSchemas[tableName] = tableSchema;\n      } else {\n        // Another class sharing this table (STI): add only columns the\n        // seeding contributor did not already define.\n        for (const [colName, colDef] of Object.entries(columnsToUse)) {\n          if (!tableSchema.columns[colName]) {\n            tableSchema.columns[colName] = colDef;\n          }\n        }\n      }\n\n      applyContributorForeignKeys(tableSchema, contributor);\n\n      // Merge indexes, keeping the first definition of each name.\n      const schemaIndexes = registered.schema?.indexes;\n      if (schemaIndexes && schemaIndexes.length > 0) {\n        const existingNames = new Set(\n          tableSchema.indexes.map((index) => index.name),\n        );\n        for (const index of schemaIndexes) {\n          // Legacy string-format indexes carry no columns and cannot be merged.\n          if (typeof index === 'string') {\n            continue;\n          }\n          if (!existingNames.has(index.name)) {\n            tableSchema.indexes.push(index);\n            existingNames.add(index.name);\n          }\n        }\n      }\n    }\n  }\n\n  return tableSchemas;\n}\n\n/**\n * Get all pre-generated schemas for explicit adapter bootstrap paths.\n *\n * Returns schemas in SDK SchemaProvider format for all registered classes.\n * Tooling and test helpers can pass these to `getDatabase()` when they want\n * to bootstrap schema before runtime. Core runtime no longer does this\n * implicitly.\n *\n * @returns Record of table names to schema definitions\n * @example\n * ```typescript\n * const schemas = ObjectRegistry.getAllSchemas('json');\n * const db = await getDatabase({ type: 'json', url: './data', schemas });\n * ```\n */\nexport function getAllSchemas(\n  engine?: DatabaseEngine,\n): Record<string, { tableName: string; ddl: string; indexes?: string[] }> {\n  // Step 1: Assemble every table from its contributing classes. The merge is\n  // deterministic, so the shape does not depend on registration order (#2372).\n  const tableSchemas = buildMergedTableSchemas();\n\n  // Step 2: Convert to output format, regenerating DDL for merged schemas\n  const schemas: Record<\n    string,\n    { tableName: string; ddl: string; indexes?: string[] }\n  > = {};\n\n  for (const [tableName, tableSchema] of Object.entries(tableSchemas)) {\n    const engineIndexes = engine\n      ? withConflictIndex(\n          tableName,\n          tableSchema.columns,\n          tableSchema.indexes,\n          tableSchema.conflictColumns,\n        )\n      : tableSchema.indexes;\n    const mergedSchema: SchemaDefinition = {\n      tableName,\n      ddl: tableSchema.ddl,\n      columns: tableSchema.columns,\n      indexes: engineIndexes,\n      triggers: [],\n      foreignKeys: [],\n      version: '',\n      dependencies: [],\n    };\n    mergedSchema.foreignKeys = schemaForeignKeys(mergedSchema);\n    mergedSchema.dependencies = mergedSchema.foreignKeys\n      .map((foreignKey) => foreignKey.referencesTable)\n      .filter((dependency) => dependency !== tableName);\n\n    // Generate DDL from merged columns (or use original DDL if columns are empty)\n    let ddl: string;\n    if (Object.keys(tableSchema.columns).length === 0 && tableSchema.ddl) {\n      if (engine) {\n        throw new Error(\n          `Cannot materialize schema '${tableName}' for ${engine}: the manifest has no structured columns`,\n        );\n      }\n      // Preserve legacy inspection of cached engine-neutral DDL. Executable\n      // target-engine paths fail above rather than returning unsafe SQL.\n      ddl = tableSchema.ddl;\n    } else if (Object.keys(tableSchema.columns).length === 0) {\n      // Skip schemas with no columns and no original DDL\n      continue;\n    } else if (engine) {\n      // Target-engine materialization must route the complete structured\n      // schema through its strategy. In particular, DuckDB/JSON require\n      // UNIQUE constraints inline for ON CONFLICT, and every strategy owns\n      // CHECK/default/index-expression rendering.\n      ddl = getDDLStrategy(engine).generateCreateTable(mergedSchema);\n    } else {\n      ddl = generateDDLFromColumns(\n        tableName,\n        tableSchema.columns,\n        tableSchema.isSTI,\n      );\n    }\n\n    // Convert index definitions to SQL strings for SDK compatibility\n    let indexSQL: string[] | undefined;\n    if (engineIndexes.length > 0) {\n      indexSQL = engine\n        ? getDDLStrategy(engine).generateIndexes(mergedSchema)\n        : engineIndexes.map((idx) => {\n            const indexType = idx.unique ? 'UNIQUE INDEX' : 'INDEX';\n            const columnList = idx.columns\n              .map((col) => quoteIdentifier(col))\n              .join(', ');\n            return `CREATE ${indexType} IF NOT EXISTS ${quoteIdentifier(\n              idx.name,\n            )} ON ${quoteIdentifier(tableName)} (${columnList});`;\n          });\n    }\n\n    schemas[tableName] = {\n      tableName,\n      ddl,\n      indexes: indexSQL,\n    };\n  }\n\n  return schemas;\n}\n\n/**\n * Get all registered schemas as SchemaDefinition objects\n *\n * Similar to getAllSchemas(), but returns SchemaDefinition format suitable\n * for use with SchemaComparer (migrations/differ.ts).\n *\n * Key difference: Indexes are kept as IndexDefinition objects instead of\n * being converted to SQL strings.\n *\n * @returns Map of tableName to SchemaDefinition\n */\nexport function getAllSchemasAsDefinitions(): Record<string, SchemaDefinition> {\n  // Step 1: Assemble every table from its contributing classes. The merge is\n  // deterministic, so the shape does not depend on registration order (#2372).\n  const tableSchemas = buildMergedTableSchemas();\n\n  // Step 2: Convert to SchemaDefinition format\n  const schemas: Record<string, SchemaDefinition> = {};\n\n  for (const [tableName, tableSchema] of Object.entries(tableSchemas)) {\n    if (Object.keys(tableSchema.columns).length === 0) {\n      continue;\n    }\n\n    // Generate DDL from columns\n    const ddl = generateDDLFromColumns(\n      tableName,\n      tableSchema.columns,\n      tableSchema.isSTI,\n    );\n    const foreignKeys = schemaForeignKeys({\n      columns: tableSchema.columns,\n      foreignKeys: [],\n    });\n\n    schemas[tableName] = {\n      tableName,\n      ddl,\n      columns: tableSchema.columns,\n      indexes: withConflictIndex(\n        tableName,\n        tableSchema.columns,\n        tableSchema.indexes,\n        tableSchema.conflictColumns,\n      ),\n      triggers: [],\n      foreignKeys,\n      version: '',\n      dependencies: foreignKeys\n        .map((foreignKey) => foreignKey.referencesTable)\n        .filter((dependency) => dependency !== tableName),\n    };\n  }\n\n  return schemas;\n}\n\n/**\n * Generate DDL CREATE TABLE statement from columns\n *\n * Used internally by getAllSchemas() to regenerate DDL after merging\n * columns from multiple STI subtypes that share the same table.\n *\n * @param tableName - Name of the table\n * @param columns - Column definitions\n * @returns DDL CREATE TABLE statement\n */\nexport function generateDDLFromColumns(\n  tableName: string,\n  columns: Record<string, ColumnDefinition>,\n  isSTI = false,\n  engine?: DatabaseEngine,\n): string {\n  let sql = `CREATE TABLE IF NOT EXISTS ${quoteIdentifier(tableName)} (\\n`;\n\n  const columnLines: string[] = [];\n  for (const [columnName, columnDef] of Object.entries(columns)) {\n    const parts: string[] = [];\n\n    // Column name and type\n    const strategy = engine ? getDDLStrategy(engine) : undefined;\n    const columnType = strategy\n      ? strategy.mapType(columnDef.type)\n      : columnDef.type;\n    parts.push(`  ${quoteIdentifier(columnName)} ${columnType}`);\n\n    // Primary key\n    if (columnDef.primaryKey) {\n      parts.push('PRIMARY KEY');\n    }\n\n    // Not null constraint\n    if (columnDef.notNull) {\n      parts.push('NOT NULL');\n    }\n\n    // Unique constraint (skip if primary key already implies uniqueness)\n    if (columnDef.unique && !columnDef.primaryKey) {\n      parts.push('UNIQUE');\n    }\n\n    // Default value\n    if (columnDef.defaultValue !== undefined) {\n      const defaultSQL = strategy\n        ? strategy.formatDefaultValue(columnDef.defaultValue, columnDef.type)\n        : formatDefaultValue(columnDef.defaultValue, columnDef.type);\n      parts.push(`DEFAULT ${defaultSQL}`);\n    }\n\n    columnLines.push(parts.join(' '));\n  }\n  for (const foreignKey of schemaForeignKeys({ columns, foreignKeys: [] })) {\n    columnLines.push(`  ${renderForeignKeyConstraint(tableName, foreignKey)}`);\n  }\n\n  sql += columnLines.join(',\\n');\n\n  // Add UNIQUE constraint for UPSERT operations\n  // For STI tables: UNIQUE(slug, context, _meta_type) - different types can have same slug+context\n  // For non-STI tables: UNIQUE(slug, context)\n  if (columns.slug && columns.context) {\n    if (isSTI && columns._meta_type) {\n      sql += ',\\n  UNIQUE(slug, context, _meta_type)';\n    } else {\n      sql += ',\\n  UNIQUE(slug, context)';\n    }\n  }\n\n  sql += '\\n);';\n\n  return sql;\n}\n\n/**\n * Format default value for SQL DDL.\n *\n * Thin wrapper over the shared, injection-safe formatter\n * (`schema/sql-identifiers.ts`) so the registry schema-builder uses the same\n * rules as the DDL strategies and schema generator: an allowlist of SQL\n * keyword/function defaults (not \"contains `(`\"), type-driven literal quoting,\n * and no folding of a literal string `\"null\"` into the SQL NULL keyword.\n *\n * @param value - Default value\n * @param type - Column SQL type\n * @returns Formatted SQL default value\n */\nexport function formatDefaultValue(value: unknown, type: string): string {\n  return formatDefaultValueShared(value, type);\n}\n\n/**\n * Options for {@link fieldsToColumns}.\n */\nexport interface FieldsToColumnsOptions {\n  /**\n   * Shape the columns for a single-table-inheritance table.\n   *\n   * An STI table holds the union of every subtype's fields, so a column that\n   * only one subtype declares must stay nullable — rows of sibling subtypes\n   * never populate it. This matches `generateSTISchemaFromManifest`, which\n   * emits `notNull: false` for every non-system column on an STI table.\n   * Declared defaults are still emitted.\n   */\n  stiUnionColumns?: boolean;\n  /**\n   * Physical column names that form the table's natural conflict key.\n   * Undeclared delete actions on foreign-key members use the shared CASCADE\n   * default, matching app-side relationship cleanup.\n   */\n  conflictColumns?: readonly string[];\n}\n\n/**\n * Convert a Map of field definitions to column definitions\n *\n * Used by getAllSchemas() to generate columns from fields when a class\n * has no pre-generated schema (e.g., STI subclasses registered from manifest).\n *\n * `required`, `default`, and `description` are read from either the top level\n * or `_meta`: registry-sourced fields normalize them into `_meta`, so reading\n * only the top level dropped NOT NULL and DEFAULT for every such field\n * (#2372).\n *\n * @param fields - Map of field name to field definition\n * @param options - Table-shape options (see {@link FieldsToColumnsOptions})\n * @returns Record of column name to column definition\n * @private\n */\nexport function fieldsToColumns(\n  fields: Map<string, FieldDefinition>,\n  options?: FieldsToColumnsOptions,\n): Record<string, ColumnDefinition> {\n  const columns: Record<string, ColumnDefinition> = {};\n  const conflictColumns = new Set(\n    (options?.conflictColumns ?? []).map((column) => toSnakeCase(column)),\n  );\n\n  for (const [fieldName, fieldDef] of fields) {\n    // Skip id, timestamps - they're on the base table\n    if (\n      fieldName === 'id' ||\n      fieldName === 'created_at' ||\n      fieldName === 'updated_at' ||\n      fieldName === 'slug' ||\n      fieldName === 'context'\n    ) {\n      continue;\n    }\n\n    // Skip transient fields (non-persisted)\n    if (fieldDef.transient || fieldDef._meta?.transient) {\n      continue;\n    }\n\n    // Skip relationship fields that don't create columns\n    // oneToMany and manyToMany are relationship metadata, not actual database columns\n    if (fieldDef.type === 'oneToMany' || fieldDef.type === 'manyToMany') {\n      continue;\n    }\n\n    // Skip meta fields - they're stored in _meta_data JSONB column\n    if (fieldDef.type === 'meta') {\n      continue;\n    }\n\n    // Map field type to SQL type\n    const sqlType =\n      fieldDef._meta?.sqlType ||\n      (fieldDef.type === 'crossPackageRef' &&\n      (fieldDef._meta?.idType === 'text' ||\n        (fieldDef as unknown as { idType?: string }).idType === 'text')\n        ? 'TEXT'\n        : mapFieldTypeToSQL(fieldDef.type));\n    const normalizedSqlType = String(sqlType).toUpperCase() as SQLDataType;\n    const referenceKind = getReferenceKind(fieldDef);\n\n    const required = readFieldAttribute(fieldDef, 'required');\n    const defaultValue = readFieldAttribute(fieldDef, 'default');\n    const description = readFieldAttribute(fieldDef, 'description');\n\n    const column: ColumnDefinition = {\n      type: normalizedSqlType,\n      referenceKind,\n      notNull: options?.stiUnionColumns\n        ? false\n        : fieldDef._meta?.nullable\n          ? false\n          : Boolean(required),\n      unique: fieldDef._meta?.unique || false,\n      description: description as string | undefined,\n    };\n\n    // Handle default values\n    if (\n      defaultValue !== undefined &&\n      shouldEmitDefault(fieldDef, normalizedSqlType, defaultValue)\n    ) {\n      column.defaultValue = defaultValue;\n    }\n\n    // Handle foreign keys\n    if (\n      fieldDef.type === 'foreignKey' &&\n      fieldDef.related &&\n      fieldDef._meta?.constraint !== false &&\n      fieldDef._meta?.__tenancy?.isTenantIdField !== true &&\n      !(\n        fieldDef as FieldDefinition & {\n          __tenancy?: { isTenantIdField?: boolean };\n        }\n      ).__tenancy?.isTenantIdField\n    ) {\n      const [table, columnName = 'id'] = fieldDef.related.split('.');\n      const fieldMeta = fieldDef._meta as\n        | {\n            onDelete?: ForeignKeyAction;\n            onUpdate?: ForeignKeyAction;\n          }\n        | undefined;\n      column.foreignKey = {\n        table: classnameToTablename(table),\n        column: columnName,\n        onDelete: resolveForeignKeyDeleteAction({\n          declared: fieldMeta?.onDelete,\n          isConflictColumn: conflictColumns.has(toSnakeCase(fieldName)),\n          isTenantIdField: false,\n        }).action,\n        onUpdate:\n          fieldMeta?.onUpdate === undefined\n            ? 'CASCADE'\n            : requireForeignKeyAction(\n                fieldMeta.onUpdate,\n                `${fieldName} ON UPDATE`,\n              ),\n        ...(typeof fieldDef._meta?.constraint === 'object'\n          ? { engines: [...fieldDef._meta.constraint.engines] }\n          : {}),\n      };\n    }\n\n    // Use snake_case for column names\n    columns[toSnakeCase(fieldName)] = column;\n  }\n\n  return columns;\n}\n\n/**\n * Map field type to SQL data type\n * @private\n */\nexport function mapFieldTypeToSQL(\n  fieldType: FieldDefinition['type'],\n): SQLDataType {\n  switch (fieldType) {\n    case 'text':\n      return 'TEXT';\n    case 'integer':\n      return 'INTEGER';\n    case 'decimal':\n      return 'REAL';\n    case 'boolean':\n      return 'BOOLEAN';\n    case 'datetime':\n      return 'TIMESTAMP';\n    case 'json':\n      return 'JSON';\n    case 'foreignKey':\n      return 'UUID';\n    case 'crossPackageRef':\n      return 'UUID';\n    default:\n      return 'TEXT';\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"schema-builder.js","names":[],"sources":["../../src/registry/schema-builder.ts"],"sourcesContent":["/**\n * Schema building logic for the SMRT ObjectRegistry.\n *\n * Extracted from registry.ts as part of issue #1006.\n */\n\nimport { ObjectRegistry } from '../registry';\nimport type { FieldDefinition } from '../scanner/types.js';\nimport {\n  conflictIndexName,\n  nullableConflictIdentity,\n} from '../schema/conflict-target.js';\nimport { getDDLStrategy } from '../schema/ddl/index.js';\nimport type { DatabaseEngine } from '../schema/ddl/types.js';\nimport {\n  renderForeignKeyConstraint,\n  schemaForeignKeys,\n} from '../schema/foreign-key-ddl.js';\nimport {\n  requireForeignKeyAction,\n  resolveForeignKeyDeleteAction,\n} from '../schema/foreign-key-policy.js';\nimport { shortenIdentifier } from '../schema/index-utils.js';\nimport {\n  formatDefaultValue as formatDefaultValueShared,\n  quoteIdentifier,\n} from '../schema/sql-identifiers.js';\nimport type {\n  ColumnDefinition,\n  IndexDefinition,\n  SchemaDefinition,\n  SQLDataType,\n} from '../schema/types.js';\nimport { classnameToTablename, toSnakeCase } from '../utils';\nimport {\n  type CollectionRegistrationLookup,\n  isCollectionRegistration,\n} from './collection-resolution';\nimport { isFrameworkBaseClass } from './framework-base-classes';\nimport { readFieldAttribute } from './manifest-field-merge';\nimport { findClass } from './name-resolver';\nimport { getClasses, getCollectionTableNames } from './shared-state';\nimport type { RegisteredClass } from './types';\n\ntype ForeignKeyAction = NonNullable<\n  NonNullable<ColumnDefinition['foreignKey']>['onDelete']\n>;\n\nconst collectionRegistrationLookup: CollectionRegistrationLookup = {\n  findClass,\n  findClassInPackage: (packageName, className) =>\n    ObjectRegistry.getClassInPackage(packageName, className),\n  getInheritanceChain: (className) =>\n    ObjectRegistry.getInheritanceChain(className),\n};\n\nfunction applyDecoratorSqlTypeOverrides(\n  className: string,\n  columns: Record<string, ColumnDefinition>,\n): Record<string, ColumnDefinition> {\n  const decorators = ObjectRegistry.getFieldDecorators(className);\n  if (!decorators.size) {\n    return columns;\n  }\n\n  for (const [fieldName, options] of decorators) {\n    if (!options?.sqlType) {\n      continue;\n    }\n\n    const columnName = toSnakeCase(fieldName);\n    const existing = columns[columnName];\n    if (!existing) {\n      continue;\n    }\n\n    const referenceKind = getReferenceKind(options as FieldDefinition);\n    columns[columnName] = {\n      ...existing,\n      type: String(options.sqlType).toUpperCase() as SQLDataType,\n      ...(referenceKind ? { referenceKind } : {}),\n    };\n  }\n\n  return columns;\n}\n\nfunction mergeRuntimeFieldColumns(\n  className: string,\n  schemaColumns: Record<string, ColumnDefinition> | undefined,\n  fields: Map<string, FieldDefinition>,\n  options?: FieldsToColumnsOptions,\n): Record<string, ColumnDefinition> {\n  const columnsToUse = { ...(schemaColumns || {}) };\n\n  if (fields.size > 0) {\n    const fieldColumns = fieldsToColumns(fields, options);\n    for (const [columnName, columnDef] of Object.entries(fieldColumns)) {\n      if (!columnsToUse[columnName]) {\n        columnsToUse[columnName] = columnDef;\n      }\n    }\n\n    for (const [fieldName, fieldDef] of fields) {\n      const columnName = toSnakeCase(fieldName);\n      const existing = columnsToUse[columnName];\n      if (!existing) {\n        continue;\n      }\n\n      const sqlType =\n        fieldDef._meta?.sqlType ||\n        (fieldDef as unknown as { sqlType?: string }).sqlType;\n      const referenceKind = getReferenceKind(fieldDef);\n      columnsToUse[columnName] = {\n        ...existing,\n        ...(sqlType\n          ? { type: String(sqlType).toUpperCase() as SQLDataType }\n          : {}),\n        ...(referenceKind ? { referenceKind } : {}),\n      };\n    }\n  }\n\n  applyDecoratorSqlTypeOverrides(className, columnsToUse);\n  return columnsToUse;\n}\n\nfunction getReferenceKind(\n  fieldDef: FieldDefinition,\n): ColumnDefinition['referenceKind'] | undefined {\n  if (\n    (\n      fieldDef as unknown as {\n        __tenancy?: { isTenantIdField?: boolean };\n      }\n    ).__tenancy?.isTenantIdField ||\n    fieldDef._meta?.__tenancy?.isTenantIdField\n  ) {\n    return 'tenantId';\n  }\n\n  if (fieldDef.type === 'foreignKey') {\n    return 'foreignKey';\n  }\n\n  if (fieldDef.type === 'crossPackageRef') {\n    return 'crossPackageRef';\n  }\n\n  return undefined;\n}\n\nfunction shouldEmitDefault(\n  fieldDef: FieldDefinition,\n  sqlType: SQLDataType,\n  defaultValue: unknown,\n) {\n  return !(\n    getReferenceKind(fieldDef) === 'tenantId' &&\n    sqlType === 'UUID' &&\n    defaultValue === ''\n  );\n}\n\n/**\n * Fallback base columns for a table whose contributing class carries no\n * manifest columns.\n *\n * These mirror what the manifest schema generators emit for the same table\n * (`generateSchemaFromManifest` / `generateSTISchemaFromManifest`), so a table\n * assembled from runtime field metadata alone has the same NOT NULL and\n * DEFAULT shape as one assembled from a manifest. Divergence here is what made\n * the merged table shape depend on which class registered first (#2372).\n */\nfunction createBaseColumns(\n  registered: {\n    config?: { idType?: 'uuid' | 'text' };\n  },\n  isSTI: boolean,\n): Record<string, ColumnDefinition> {\n  const baseColumns: Record<string, ColumnDefinition> = {\n    id: {\n      type: registered.config?.idType === 'text' ? 'TEXT' : 'UUID',\n      primaryKey: true,\n      notNull: true,\n      referenceKind: 'id',\n    },\n    slug: { type: 'TEXT', notNull: true },\n    context: { type: 'TEXT', notNull: true, defaultValue: '' },\n    created_at: {\n      type: 'TIMESTAMP',\n      notNull: true,\n      defaultValue: 'current_timestamp',\n    },\n    updated_at: {\n      type: 'TIMESTAMP',\n      notNull: true,\n      defaultValue: 'current_timestamp',\n    },\n  };\n\n  // STI tables also carry the discriminator and the meta payload column\n  // (issue #690: db:diff needs them to detect schema changes).\n  if (isSTI) {\n    baseColumns._meta_type = { type: 'TEXT', notNull: true };\n    baseColumns._meta_data = { type: 'JSON', notNull: false };\n  }\n\n  return baseColumns;\n}\n\n/**\n * Get cached schema definition for a registered class\n *\n * @param name - Name of the registered class\n * @returns Schema definition or undefined if not found\n * @example\n * ```typescript\n * const schema = getSchema('Product');\n * console.log(schema.tableName); // 'products'\n * console.log(schema.ddl);       // 'CREATE TABLE...'\n * ```\n */\nexport function getSchema(name: string): SchemaDefinition | undefined {\n  // Issue #951: Use findClass for multi-strategy lookup\n  const registered = findClass(name);\n  return registered?.schema;\n}\n\n/**\n * Get SQL DDL statement for a registered class\n *\n * @param name - Name of the registered class\n * Cached manifest DDL contains abstract types and is not safe to execute on\n * PostgreSQL. New executable paths must pass a target engine. Omitting it is\n * retained for backward compatibility with consumers that only inspect the\n * legacy engine-neutral manifest string.\n *\n * @param engine - Database engine that will execute the DDL\n * @returns Engine-specific SQL DDL, or the legacy cached DDL when omitted\n * @example\n * ```typescript\n * const ddl = ObjectRegistry.getSchemaDDL('Product', 'postgres');\n * await db.query(ddl);\n * ```\n */\nexport function getSchemaDDL(\n  name: string,\n  engine?: DatabaseEngine,\n): string | undefined {\n  const schema = getSchema(name);\n  if (!schema) return undefined;\n  if (engine && Object.keys(schema.columns).length === 0) {\n    throw new Error(\n      `Cannot materialize schema '${name}' for ${engine}: the manifest has no structured columns`,\n    );\n  }\n  return engine\n    ? getDDLStrategy(engine).generateCreateTable(schema)\n    : schema.ddl;\n}\n\n/**\n * Get table name for a registered class\n *\n * @param name - Name of the registered class\n * @returns Table name or undefined if not found\n * @example\n * ```typescript\n * const tableName = getTableName('Product');\n * console.log(tableName); // 'products'\n * ```\n */\nexport function getTableName(name: string): string | undefined {\n  // Check if this is a collection class - collections have their own tableName mapping\n  const collectionTableName = getCollectionTableNames().get(name);\n  if (collectionTableName) {\n    return collectionTableName;\n  }\n\n  // For STI classes, return the STI base class's table name.\n  // R5-canon: `getSTIBase` returns the qualified name; resolve `name`\n  // (which may be simple) to its registration's qualified form for the\n  // comparison.\n  const stiBase = ObjectRegistry.getSTIBase(name);\n  const registered = ObjectRegistry.getClass(name);\n  const qualifiedName = registered?.qualifiedName ?? registered?.name ?? name;\n  if (stiBase && stiBase !== qualifiedName) {\n    return getSchema(stiBase)?.tableName;\n  }\n  return getSchema(name)?.tableName;\n}\n\nfunction withConflictIndex(\n  tableName: string,\n  columns: Record<string, ColumnDefinition>,\n  indexes: IndexDefinition[],\n  conflictColumns: string[],\n): IndexDefinition[] {\n  if (\n    conflictColumns.length === 0 ||\n    !conflictColumns.every((column) => columns[column])\n  ) {\n    return indexes;\n  }\n\n  // `ON CONFLICT (id)` binds to the primary-key constraint itself; a second\n  // unique index over the primary key column set adds nothing (#2359, A5).\n  // Kept in step with SchemaGenerator.conflictColumnsArePrimaryKey().\n  const primaryKeyColumns = Object.entries(columns)\n    .filter(([, column]) => column.primaryKey === true)\n    .map(([name]) => name);\n  if (\n    primaryKeyColumns.length > 0 &&\n    primaryKeyColumns.length === conflictColumns.length &&\n    primaryKeyColumns.every((column) => conflictColumns.includes(column))\n  ) {\n    return indexes;\n  }\n\n  // Same stable naming as SchemaGenerator (`schema/conflict-target.ts`), so\n  // a manifest built before the runtime learned the tenant-aware default\n  // (#2360) has its stale `<table>_slug_context_idx` REPLACED in place here\n  // — the differ then swaps the live index by name — instead of a second,\n  // suffixed unique index being appended beside the old global one.\n  const tenantColumn = Object.entries(columns).find(\n    ([, column]) => column.referenceKind === 'tenantId',\n  )?.[0];\n  // The composed name can exceed PostgreSQL's 63-byte limit on a long table.\n  // Shortening here (rather than inside conflictIndexName) keeps the generator\n  // paths, which run enforceIdentifierLimits() over their whole index list,\n  // and this migrate leg agreeing on the final name (#2374).\n  const name = shortenIdentifier(\n    conflictIndexName(tableName, conflictColumns, tenantColumn),\n  );\n  const canonical = indexes.find((index) => index.name === name);\n  if (\n    !canonical &&\n    indexes.some(\n      (index) =>\n        index.unique === true &&\n        !index.where &&\n        !index.jsonPath &&\n        index.columns.length === conflictColumns.length &&\n        index.columns.every((column) => conflictColumns.includes(column)),\n    )\n  ) {\n    // A user-owned equivalent unique index is not permission to change its NULL semantics.\n    return indexes;\n  }\n  const conflictIndex: IndexDefinition = {\n    name,\n    columns: conflictColumns,\n    unique: true,\n    ...(nullableConflictIdentity(conflictColumns, columns)\n      ? { nullsNotDistinct: true }\n      : {}),\n  };\n  if (indexes.some((index) => index.name === name)) {\n    return indexes.map((index) =>\n      index.name === name ? conflictIndex : index,\n    );\n  }\n  return [...indexes, conflictIndex];\n}\n\n/**\n * A registered class that contributes columns to one physical table.\n *\n * For a single-table-inheritance hierarchy every class in the hierarchy is a\n * contributor to the same table.\n */\ninterface TableContributor {\n  registered: RegisteredClass;\n  simpleName: string;\n  qualifiedName: string;\n  isSTI: boolean;\n  /** True when this class is the STI base that owns the table. */\n  isSTIBase: boolean;\n  /** Inheritance depth; ancestors sort before descendants. */\n  depth: number;\n  /** Conflict-column lookup key (the STI base for STI members). */\n  conflictKey: string;\n}\n\n/**\n * A merged physical table assembled from every class that contributes to it.\n */\ninterface MergedTableSchema {\n  tableName: string;\n  columns: Record<string, ColumnDefinition>;\n  indexes: IndexDefinition[];\n  ddl: string;\n  isSTI: boolean;\n  conflictColumns: string[];\n}\n\nfunction applyContributorForeignKeys(\n  tableSchema: MergedTableSchema,\n  contributor: TableContributor,\n): void {\n  const conflictColumns = new Set(tableSchema.conflictColumns);\n  for (const [fieldName, field] of contributor.registered.fields) {\n    if (field.type !== 'foreignKey' || !field.related) continue;\n    const columnName = toSnakeCase(fieldName);\n    const column = tableSchema.columns[columnName];\n    if (!column) continue;\n    if (\n      field._meta?.__tenancy?.isTenantIdField === true ||\n      (\n        field as FieldDefinition & {\n          __tenancy?: { isTenantIdField?: boolean };\n        }\n      ).__tenancy?.isTenantIdField === true\n    ) {\n      column.foreignKey = undefined;\n      continue;\n    }\n    const [legacyTargetName, declaredTargetColumn] = field.related.split('.');\n    const resolvedTarget = ObjectRegistry.resolveRelationshipTarget(\n      contributor.qualifiedName,\n      fieldName,\n    );\n    if (resolvedTarget === null) {\n      throw new Error(\n        `Cannot resolve foreign key ${contributor.qualifiedName}.${fieldName}: target constructor is unregistered or the target name is ambiguous`,\n      );\n    }\n    const targetName = resolvedTarget ?? legacyTargetName;\n    const targetBase = ObjectRegistry.getSTIBase(targetName) || targetName;\n    const registeredTarget = ObjectRegistry.getClass(targetBase);\n    const targetColumn =\n      declaredTargetColumn ||\n      Array.from(ObjectRegistry.getFields(targetBase).entries()).find(\n        ([, targetField]) => targetField._meta?.primaryKey === true,\n      )?.[0] ||\n      'id';\n    if (registeredTarget && !field._meta?.sqlType) {\n      const targetColumnName = toSnakeCase(targetColumn);\n      const targetColumnType =\n        registeredTarget.schema?.columns?.[targetColumnName]?.type ||\n        (targetColumnName === 'id'\n          ? registeredTarget.config.idType === 'text'\n            ? 'TEXT'\n            : 'UUID'\n          : undefined);\n      if (targetColumnType) {\n        column.type = targetColumnType;\n      }\n    }\n    if (field._meta?.constraint === false) {\n      column.foreignKey = undefined;\n      continue;\n    }\n    // A manifest may carry explicit actions that predate or differ from the\n    // runtime decorator defaults. Merging runtime fields must not erase them.\n    // The fallback produced from runtime fields, however, must be replaced so\n    // conflict columns receive the same default CASCADE as app-side cleanup.\n    const manifestForeignKey =\n      contributor.registered.schema?.columns?.[columnName]?.foreignKey;\n    if (manifestForeignKey) {\n      column.foreignKey = manifestForeignKey;\n      continue;\n    }\n    // A decorator-only runtime field has no authoritative physical target\n    // until that target is registered. Scanner-produced manifests clear this\n    // shape too; only an explicit manifest FK above may survive unloaded\n    // runtime classes (the manifest-authority contract from #1120).\n    if (!registeredTarget) {\n      column.foreignKey = undefined;\n      continue;\n    }\n    const targetTable =\n      ObjectRegistry.getTableName(targetBase) ||\n      classnameToTablename(targetBase);\n    const { action } = resolveForeignKeyDeleteAction({\n      declared: field._meta?.onDelete,\n      isConflictColumn: conflictColumns.has(columnName),\n      isTenantIdField: false,\n    });\n    column.foreignKey = {\n      table: targetTable,\n      column: toSnakeCase(targetColumn),\n      onDelete: action,\n      onUpdate: 'CASCADE',\n      ...(typeof field._meta?.constraint === 'object'\n        ? { engines: [...field._meta.constraint.engines] }\n        : {}),\n    };\n  }\n}\n\n/**\n * Resolve the physical table a registered class writes to.\n *\n * STI subclasses are folded onto their base's table. Returns `undefined` when\n * the class has no table (for example an unresolvable manifest stub).\n *\n * R5-canon: STI lookups use the qualified key so a colliding simple name in\n * another package cannot yield the wrong table strategy or STI base and move\n * this class's columns under that other package's table.\n */\nfunction resolveContributorTable(\n  registered: RegisteredClass,\n  fallbackName: string,\n): { tableName: string; contributor: TableContributor } | undefined {\n  const simpleName = registered.name || fallbackName;\n  const qualifiedName = registered.qualifiedName ?? simpleName;\n\n  // STI subclasses loaded from external manifests can arrive with a null\n  // tableName; registerFromManifest() then derives one from the class name.\n  // Adopt the STI base's tableName instead so the subclass lands on the\n  // shared table (issue #703).\n  if (!registered.schema?.tableName && registered.extends) {\n    if (ObjectRegistry.getTableStrategy(qualifiedName) === 'sti') {\n      const stiBaseName = ObjectRegistry.getSTIBase(qualifiedName);\n      if (stiBaseName && stiBaseName !== qualifiedName) {\n        const stiBaseClass = findClass(stiBaseName);\n        if (stiBaseClass?.schema?.tableName) {\n          if (!registered.schema) {\n            registered.schema = {\n              tableName: '',\n              ddl: '',\n              columns: {},\n              indexes: [],\n              triggers: [],\n              foreignKeys: [],\n              dependencies: [],\n              version: '',\n            };\n          }\n          registered.schema.tableName = stiBaseClass.schema.tableName;\n        }\n      }\n    }\n  }\n\n  if (!registered.schema?.tableName) {\n    return undefined;\n  }\n\n  let tableName = registered.schema.tableName;\n  const tableStrategy = ObjectRegistry.getTableStrategy(qualifiedName);\n  const isSTI = tableStrategy === 'sti';\n  let isSTIBase = isSTI;\n  let conflictKey = qualifiedName;\n\n  if (isSTI) {\n    const stiBaseName = ObjectRegistry.getSTIBase(qualifiedName);\n    if (stiBaseName) {\n      conflictKey = stiBaseName;\n      if (stiBaseName !== qualifiedName) {\n        isSTIBase = false;\n        // STI subclasses serialize to the base class's table even when they\n        // carry a tableName of their own (issue #693).\n        const stiBaseClass = findClass(stiBaseName);\n        if (stiBaseClass?.schema?.tableName) {\n          tableName = stiBaseClass.schema.tableName;\n        }\n      }\n    }\n  }\n\n  return {\n    tableName,\n    contributor: {\n      registered,\n      simpleName,\n      qualifiedName,\n      isSTI,\n      isSTIBase,\n      depth: ObjectRegistry.getInheritanceChain(qualifiedName).length,\n      conflictKey,\n    },\n  };\n}\n\n/**\n * Order the classes that share one table deterministically.\n *\n * The first contributor seeds the table: it supplies the base columns, the\n * `idType`, the conflict columns and the cached DDL, and its columns win every\n * merge conflict. Registration order must not decide that, or the same\n * hierarchy yields a different table shape depending on which class a manifest\n * happens to list first — child-first dropped NOT NULL and DEFAULT from the\n * base columns (#2372).\n *\n * Order: the STI base first, then ancestors before descendants, then by\n * qualified name so the result is a total order.\n */\nfunction sortTableContributors(contributors: TableContributor[]) {\n  return [...contributors].sort((a, b) => {\n    if (a.isSTIBase !== b.isSTIBase) {\n      return a.isSTIBase ? -1 : 1;\n    }\n    if (a.depth !== b.depth) {\n      return a.depth - b.depth;\n    }\n    return a.qualifiedName.localeCompare(b.qualifiedName);\n  });\n}\n\n/**\n * Assemble every physical table from the classes that contribute to it.\n *\n * Shared by {@link getAllSchemas} and {@link getAllSchemasAsDefinitions} so\n * both produce the same merged shape. The result depends only on what is\n * registered, never on the order it was registered in.\n */\nfunction buildMergedTableSchemas(): Record<string, MergedTableSchema> {\n  // Pass 1: group contributing classes by physical table.\n  const contributorsByTable = new Map<string, TableContributor[]>();\n\n  for (const [className, registered] of getClasses()) {\n    // Collection classes have no table of their own; their schemas carry\n    // collection properties (loaded, options, ...) rather than columns.\n    if (\n      isCollectionRegistration(\n        className,\n        registered,\n        collectionRegistrationLookup,\n      )\n    ) {\n      continue;\n    }\n\n    // Framework abstract base classes (SmrtObject, SmrtClass, ...) are\n    // scaffolding, not resources — they produce no table (#2642).\n    if (isFrameworkBaseClass(registered.name, registered.packageName)) {\n      continue;\n    }\n\n    const resolved = resolveContributorTable(registered, className);\n    if (!resolved) {\n      continue;\n    }\n\n    const existing = contributorsByTable.get(resolved.tableName);\n    if (existing) {\n      existing.push(resolved.contributor);\n    } else {\n      contributorsByTable.set(resolved.tableName, [resolved.contributor]);\n    }\n  }\n\n  // Pass 2: merge each table's contributors in deterministic order.\n  const tableSchemas: Record<string, MergedTableSchema> = {};\n\n  for (const [tableName, contributors] of contributorsByTable) {\n    for (const contributor of sortTableContributors(contributors)) {\n      const { registered, simpleName, isSTI } = contributor;\n      const conflictColumns = ObjectRegistry.getConflictColumns(\n        contributor.conflictKey,\n      );\n\n      // The manifest schema stays authoritative for the columns it defines.\n      // Runtime field metadata backfills columns the manifest never had (for\n      // example tenantScoped injections) and applies explicit sqlType\n      // overrides, without erasing richer manifest metadata.\n      const columnsToUse = mergeRuntimeFieldColumns(\n        simpleName,\n        registered.schema?.columns,\n        registered.fields,\n        { stiUnionColumns: isSTI, conflictColumns },\n      );\n\n      let tableSchema = tableSchemas[tableName];\n      if (!tableSchema) {\n        tableSchema = {\n          tableName,\n          columns: {\n            ...createBaseColumns(registered, isSTI),\n            ...columnsToUse,\n          },\n          indexes: [],\n          ddl: registered.schema?.ddl || '',\n          isSTI,\n          conflictColumns,\n        };\n        tableSchemas[tableName] = tableSchema;\n      } else {\n        // Another class sharing this table (STI): add only columns the\n        // seeding contributor did not already define.\n        for (const [colName, colDef] of Object.entries(columnsToUse)) {\n          if (!tableSchema.columns[colName]) {\n            tableSchema.columns[colName] = colDef;\n          }\n        }\n      }\n\n      applyContributorForeignKeys(tableSchema, contributor);\n\n      // Merge indexes, keeping the first definition of each name.\n      const schemaIndexes = registered.schema?.indexes;\n      if (schemaIndexes && schemaIndexes.length > 0) {\n        const existingNames = new Set(\n          tableSchema.indexes.map((index) => index.name),\n        );\n        for (const index of schemaIndexes) {\n          // Legacy string-format indexes carry no columns and cannot be merged.\n          if (typeof index === 'string') {\n            continue;\n          }\n          if (!existingNames.has(index.name)) {\n            tableSchema.indexes.push(index);\n            existingNames.add(index.name);\n          }\n        }\n      }\n    }\n  }\n\n  return tableSchemas;\n}\n\n/**\n * Get all pre-generated schemas for explicit adapter bootstrap paths.\n *\n * Returns schemas in SDK SchemaProvider format for all registered classes.\n * Tooling and test helpers can pass these to `getDatabase()` when they want\n * to bootstrap schema before runtime. Core runtime no longer does this\n * implicitly.\n *\n * @returns Record of table names to schema definitions\n * @example\n * ```typescript\n * const schemas = ObjectRegistry.getAllSchemas('json');\n * const db = await getDatabase({ type: 'json', url: './data', schemas });\n * ```\n */\nexport function getAllSchemas(\n  engine?: DatabaseEngine,\n): Record<string, { tableName: string; ddl: string; indexes?: string[] }> {\n  // Step 1: Assemble every table from its contributing classes. The merge is\n  // deterministic, so the shape does not depend on registration order (#2372).\n  const tableSchemas = buildMergedTableSchemas();\n\n  // Step 2: Convert to output format, regenerating DDL for merged schemas\n  const schemas: Record<\n    string,\n    { tableName: string; ddl: string; indexes?: string[] }\n  > = {};\n\n  for (const [tableName, tableSchema] of Object.entries(tableSchemas)) {\n    const engineIndexes = engine\n      ? withConflictIndex(\n          tableName,\n          tableSchema.columns,\n          tableSchema.indexes,\n          tableSchema.conflictColumns,\n        )\n      : tableSchema.indexes;\n    const mergedSchema: SchemaDefinition = {\n      tableName,\n      ddl: tableSchema.ddl,\n      columns: tableSchema.columns,\n      indexes: engineIndexes,\n      triggers: [],\n      foreignKeys: [],\n      version: '',\n      dependencies: [],\n    };\n    mergedSchema.foreignKeys = schemaForeignKeys(mergedSchema);\n    mergedSchema.dependencies = mergedSchema.foreignKeys\n      .map((foreignKey) => foreignKey.referencesTable)\n      .filter((dependency) => dependency !== tableName);\n\n    // Generate DDL from merged columns (or use original DDL if columns are empty)\n    let ddl: string;\n    if (Object.keys(tableSchema.columns).length === 0 && tableSchema.ddl) {\n      if (engine) {\n        throw new Error(\n          `Cannot materialize schema '${tableName}' for ${engine}: the manifest has no structured columns`,\n        );\n      }\n      // Preserve legacy inspection of cached engine-neutral DDL. Executable\n      // target-engine paths fail above rather than returning unsafe SQL.\n      ddl = tableSchema.ddl;\n    } else if (Object.keys(tableSchema.columns).length === 0) {\n      // Skip schemas with no columns and no original DDL\n      continue;\n    } else if (engine) {\n      // Target-engine materialization must route the complete structured\n      // schema through its strategy. In particular, DuckDB/JSON require\n      // UNIQUE constraints inline for ON CONFLICT, and every strategy owns\n      // CHECK/default/index-expression rendering.\n      ddl = getDDLStrategy(engine).generateCreateTable(mergedSchema);\n    } else {\n      ddl = generateDDLFromColumns(\n        tableName,\n        tableSchema.columns,\n        tableSchema.isSTI,\n      );\n    }\n\n    // Convert index definitions to SQL strings for SDK compatibility\n    let indexSQL: string[] | undefined;\n    if (engineIndexes.length > 0) {\n      indexSQL = engine\n        ? getDDLStrategy(engine).generateIndexes(mergedSchema)\n        : engineIndexes.map((idx) => {\n            const indexType = idx.unique ? 'UNIQUE INDEX' : 'INDEX';\n            const columnList = idx.columns\n              .map((col) => quoteIdentifier(col))\n              .join(', ');\n            return `CREATE ${indexType} IF NOT EXISTS ${quoteIdentifier(\n              idx.name,\n            )} ON ${quoteIdentifier(tableName)} (${columnList});`;\n          });\n    }\n\n    schemas[tableName] = {\n      tableName,\n      ddl,\n      indexes: indexSQL,\n    };\n  }\n\n  return schemas;\n}\n\n/**\n * Get all registered schemas as SchemaDefinition objects\n *\n * Similar to getAllSchemas(), but returns SchemaDefinition format suitable\n * for use with SchemaComparer (migrations/differ.ts).\n *\n * Key difference: Indexes are kept as IndexDefinition objects instead of\n * being converted to SQL strings.\n *\n * @returns Map of tableName to SchemaDefinition\n */\nexport function getAllSchemasAsDefinitions(): Record<string, SchemaDefinition> {\n  // Step 1: Assemble every table from its contributing classes. The merge is\n  // deterministic, so the shape does not depend on registration order (#2372).\n  const tableSchemas = buildMergedTableSchemas();\n\n  // Step 2: Convert to SchemaDefinition format\n  const schemas: Record<string, SchemaDefinition> = {};\n\n  for (const [tableName, tableSchema] of Object.entries(tableSchemas)) {\n    if (Object.keys(tableSchema.columns).length === 0) {\n      continue;\n    }\n\n    // Generate DDL from columns\n    const ddl = generateDDLFromColumns(\n      tableName,\n      tableSchema.columns,\n      tableSchema.isSTI,\n    );\n    const foreignKeys = schemaForeignKeys({\n      columns: tableSchema.columns,\n      foreignKeys: [],\n    });\n\n    schemas[tableName] = {\n      tableName,\n      ddl,\n      columns: tableSchema.columns,\n      indexes: withConflictIndex(\n        tableName,\n        tableSchema.columns,\n        tableSchema.indexes,\n        tableSchema.conflictColumns,\n      ),\n      triggers: [],\n      foreignKeys,\n      version: '',\n      dependencies: foreignKeys\n        .map((foreignKey) => foreignKey.referencesTable)\n        .filter((dependency) => dependency !== tableName),\n    };\n  }\n\n  return schemas;\n}\n\n/**\n * Generate DDL CREATE TABLE statement from columns\n *\n * Used internally by getAllSchemas() to regenerate DDL after merging\n * columns from multiple STI subtypes that share the same table.\n *\n * @param tableName - Name of the table\n * @param columns - Column definitions\n * @returns DDL CREATE TABLE statement\n */\nexport function generateDDLFromColumns(\n  tableName: string,\n  columns: Record<string, ColumnDefinition>,\n  isSTI = false,\n  engine?: DatabaseEngine,\n): string {\n  let sql = `CREATE TABLE IF NOT EXISTS ${quoteIdentifier(tableName)} (\\n`;\n\n  const columnLines: string[] = [];\n  for (const [columnName, columnDef] of Object.entries(columns)) {\n    const parts: string[] = [];\n\n    // Column name and type\n    const strategy = engine ? getDDLStrategy(engine) : undefined;\n    const columnType = strategy\n      ? strategy.mapType(columnDef.type)\n      : columnDef.type;\n    parts.push(`  ${quoteIdentifier(columnName)} ${columnType}`);\n\n    // Primary key\n    if (columnDef.primaryKey) {\n      parts.push('PRIMARY KEY');\n    }\n\n    // Not null constraint\n    if (columnDef.notNull) {\n      parts.push('NOT NULL');\n    }\n\n    // Unique constraint (skip if primary key already implies uniqueness)\n    if (columnDef.unique && !columnDef.primaryKey) {\n      parts.push('UNIQUE');\n    }\n\n    // Default value\n    if (columnDef.defaultValue !== undefined) {\n      const defaultSQL = strategy\n        ? strategy.formatDefaultValue(columnDef.defaultValue, columnDef.type)\n        : formatDefaultValue(columnDef.defaultValue, columnDef.type);\n      parts.push(`DEFAULT ${defaultSQL}`);\n    }\n\n    columnLines.push(parts.join(' '));\n  }\n  for (const foreignKey of schemaForeignKeys({ columns, foreignKeys: [] })) {\n    columnLines.push(`  ${renderForeignKeyConstraint(tableName, foreignKey)}`);\n  }\n\n  sql += columnLines.join(',\\n');\n\n  // Add UNIQUE constraint for UPSERT operations\n  // For STI tables: UNIQUE(slug, context, _meta_type) - different types can have same slug+context\n  // For non-STI tables: UNIQUE(slug, context)\n  if (columns.slug && columns.context) {\n    if (isSTI && columns._meta_type) {\n      sql += ',\\n  UNIQUE(slug, context, _meta_type)';\n    } else {\n      sql += ',\\n  UNIQUE(slug, context)';\n    }\n  }\n\n  sql += '\\n);';\n\n  return sql;\n}\n\n/**\n * Format default value for SQL DDL.\n *\n * Thin wrapper over the shared, injection-safe formatter\n * (`schema/sql-identifiers.ts`) so the registry schema-builder uses the same\n * rules as the DDL strategies and schema generator: an allowlist of SQL\n * keyword/function defaults (not \"contains `(`\"), type-driven literal quoting,\n * and no folding of a literal string `\"null\"` into the SQL NULL keyword.\n *\n * @param value - Default value\n * @param type - Column SQL type\n * @returns Formatted SQL default value\n */\nexport function formatDefaultValue(value: unknown, type: string): string {\n  return formatDefaultValueShared(value, type);\n}\n\n/**\n * Options for {@link fieldsToColumns}.\n */\nexport interface FieldsToColumnsOptions {\n  /**\n   * Shape the columns for a single-table-inheritance table.\n   *\n   * An STI table holds the union of every subtype's fields, so a column that\n   * only one subtype declares must stay nullable — rows of sibling subtypes\n   * never populate it. This matches `generateSTISchemaFromManifest`, which\n   * emits `notNull: false` for every non-system column on an STI table.\n   * Declared defaults are still emitted.\n   */\n  stiUnionColumns?: boolean;\n  /**\n   * Physical column names that form the table's natural conflict key.\n   * Undeclared delete actions on foreign-key members use the shared CASCADE\n   * default, matching app-side relationship cleanup.\n   */\n  conflictColumns?: readonly string[];\n}\n\n/**\n * Convert a Map of field definitions to column definitions\n *\n * Used by getAllSchemas() to generate columns from fields when a class\n * has no pre-generated schema (e.g., STI subclasses registered from manifest).\n *\n * `required`, `default`, and `description` are read from either the top level\n * or `_meta`: registry-sourced fields normalize them into `_meta`, so reading\n * only the top level dropped NOT NULL and DEFAULT for every such field\n * (#2372).\n *\n * @param fields - Map of field name to field definition\n * @param options - Table-shape options (see {@link FieldsToColumnsOptions})\n * @returns Record of column name to column definition\n * @private\n */\nexport function fieldsToColumns(\n  fields: Map<string, FieldDefinition>,\n  options?: FieldsToColumnsOptions,\n): Record<string, ColumnDefinition> {\n  const columns: Record<string, ColumnDefinition> = {};\n  const conflictColumns = new Set(\n    (options?.conflictColumns ?? []).map((column) => toSnakeCase(column)),\n  );\n\n  for (const [fieldName, fieldDef] of fields) {\n    // Skip id, timestamps - they're on the base table\n    if (\n      fieldName === 'id' ||\n      fieldName === 'created_at' ||\n      fieldName === 'updated_at' ||\n      fieldName === 'slug' ||\n      fieldName === 'context'\n    ) {\n      continue;\n    }\n\n    // Skip transient fields (non-persisted)\n    if (fieldDef.transient || fieldDef._meta?.transient) {\n      continue;\n    }\n\n    // Skip relationship fields that don't create columns\n    // oneToMany and manyToMany are relationship metadata, not actual database columns\n    if (fieldDef.type === 'oneToMany' || fieldDef.type === 'manyToMany') {\n      continue;\n    }\n\n    // Skip meta fields - they're stored in _meta_data JSONB column\n    if (fieldDef.type === 'meta') {\n      continue;\n    }\n\n    // Map field type to SQL type\n    const sqlType =\n      fieldDef._meta?.sqlType ||\n      (fieldDef.type === 'crossPackageRef' &&\n      (fieldDef._meta?.idType === 'text' ||\n        (fieldDef as unknown as { idType?: string }).idType === 'text')\n        ? 'TEXT'\n        : mapFieldTypeToSQL(fieldDef.type));\n    const normalizedSqlType = String(sqlType).toUpperCase() as SQLDataType;\n    const referenceKind = getReferenceKind(fieldDef);\n\n    const required = readFieldAttribute(fieldDef, 'required');\n    const defaultValue = readFieldAttribute(fieldDef, 'default');\n    const description = readFieldAttribute(fieldDef, 'description');\n\n    const column: ColumnDefinition = {\n      type: normalizedSqlType,\n      referenceKind,\n      notNull: options?.stiUnionColumns\n        ? false\n        : fieldDef._meta?.nullable\n          ? false\n          : Boolean(required),\n      unique: fieldDef._meta?.unique || false,\n      description: description as string | undefined,\n    };\n\n    // Handle default values\n    if (\n      defaultValue !== undefined &&\n      shouldEmitDefault(fieldDef, normalizedSqlType, defaultValue)\n    ) {\n      column.defaultValue = defaultValue;\n    }\n\n    // Handle foreign keys\n    if (\n      fieldDef.type === 'foreignKey' &&\n      fieldDef.related &&\n      fieldDef._meta?.constraint !== false &&\n      fieldDef._meta?.__tenancy?.isTenantIdField !== true &&\n      !(\n        fieldDef as FieldDefinition & {\n          __tenancy?: { isTenantIdField?: boolean };\n        }\n      ).__tenancy?.isTenantIdField\n    ) {\n      const [table, columnName = 'id'] = fieldDef.related.split('.');\n      const fieldMeta = fieldDef._meta as\n        | {\n            onDelete?: ForeignKeyAction;\n            onUpdate?: ForeignKeyAction;\n          }\n        | undefined;\n      column.foreignKey = {\n        table: classnameToTablename(table),\n        column: columnName,\n        onDelete: resolveForeignKeyDeleteAction({\n          declared: fieldMeta?.onDelete,\n          isConflictColumn: conflictColumns.has(toSnakeCase(fieldName)),\n          isTenantIdField: false,\n        }).action,\n        onUpdate:\n          fieldMeta?.onUpdate === undefined\n            ? 'CASCADE'\n            : requireForeignKeyAction(\n                fieldMeta.onUpdate,\n                `${fieldName} ON UPDATE`,\n              ),\n        ...(typeof fieldDef._meta?.constraint === 'object'\n          ? { engines: [...fieldDef._meta.constraint.engines] }\n          : {}),\n      };\n    }\n\n    // Use snake_case for column names\n    columns[toSnakeCase(fieldName)] = column;\n  }\n\n  return columns;\n}\n\n/**\n * Map field type to SQL data type\n * @private\n */\nexport function mapFieldTypeToSQL(\n  fieldType: FieldDefinition['type'],\n): SQLDataType {\n  switch (fieldType) {\n    case 'text':\n      return 'TEXT';\n    case 'integer':\n      return 'INTEGER';\n    case 'decimal':\n      return 'REAL';\n    case 'boolean':\n      return 'BOOLEAN';\n    case 'datetime':\n      return 'TIMESTAMP';\n    case 'json':\n      return 'JSON';\n    case 'foreignKey':\n      return 'UUID';\n    case 'crossPackageRef':\n      return 'UUID';\n    default:\n      return 'TEXT';\n  }\n}\n"],"mappings":"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"}

package/dist/registry/validator.d.ts

@@ -1,5 +1,6 @@
 import { FieldDefinition } from '../scanner/types.js';
 import { ValidatorFunction } from './types';
+export declare function isBatchSafeValidator(validator: ValidatorFunction): boolean;
 /**
  * Compile validation functions from field definitions.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/registry/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAiBjD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GACnC,iBAAiB,EAAE,CAwKrB"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/registry/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAKjD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAE1E;AAiBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GACnC,iBAAiB,EAAE,CA6KrB"}

package/dist/registry/validator.js

@@ -1,4 +1,8 @@
 //#region src/registry/validator.ts
+var batchSafeValidators = /* @__PURE__ */ new WeakSet();
+function isBatchSafeValidator(validator) {
+	return batchSafeValidators.has(validator);
+}
 /**
 * Read a runtime field value off a SmrtObject instance by dynamic field name.
 *
@@ -25,6 +29,7 @@ function readInstanceField(instance, fieldName) {
 */
 function compileValidators(className, fields) {
 	const validators = [];
+	let custom = false;
 	for (const [fieldName, field] of fields) {
 		const options = field._meta ?? {};
 		if (options.transient || field.transient) continue;
@@ -70,6 +75,7 @@ function compileValidators(className, fields) {
 		}
 		const customValidate = options.validate;
 		if (typeof customValidate === "function") {
+			custom = true;
 			const validateFn = customValidate;
 			const customMessage = typeof options.customMessage === "string" ? options.customMessage : void 0;
 			validators.push(async (instance) => {
@@ -87,9 +93,10 @@ function compileValidators(className, fields) {
 			});
 		}
 	}
+	if (!custom) for (const validator of validators) batchSafeValidators.add(validator);
 	return validators;
 }
 //#endregion
-export { compileValidators };
+export { compileValidators, isBatchSafeValidator };
 
 //# sourceMappingURL=validator.js.map

package/dist/registry/validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"validator.js","names":[],"sources":["../../src/registry/validator.ts"],"sourcesContent":["/**\n * Validator module for the SMRT ObjectRegistry.\n *\n * Compiles validation functions from field definitions for runtime use.\n *\n * Extracted from registry.ts as part of issue #1006.\n * @see https://github.com/happyvertical/smrt/issues/1006\n */\n\nimport type { SmrtObject } from '../object';\nimport type { FieldDefinition, FieldMeta } from '../scanner/types.js';\nimport type { ValidatorFunction } from './types';\n\n/**\n * Read a runtime field value off a SmrtObject instance by dynamic field name.\n *\n * Compiled validators index the instance by `fieldName` (a manifest-driven\n * string), but `SmrtObject` has no string index signature, so a direct\n * `instance[fieldName]` is an implicit-`any` access (TS7053). This single\n * documented view casts through `unknown` to a `Record<string, unknown>` so the\n * dynamic read is typed `unknown` (not `any`) while preserving exact runtime\n * behavior. Routing every validator's field read through here keeps the cast in\n * one place instead of scattering it across each closure.\n */\nfunction readInstanceField(instance: SmrtObject, fieldName: string): unknown {\n  return (instance as unknown as Record<string, unknown>)[fieldName];\n}\n\n/**\n * Compile validation functions from field definitions.\n *\n * Extracts validation rules from field options and compiles them into\n * efficient validation functions that can be executed at runtime.\n *\n * @param className - Name of the class being validated\n * @param fields - Map of field definitions\n * @returns Array of compiled validation functions\n */\nexport function compileValidators(\n  className: string,\n  fields: Map<string, FieldDefinition>,\n): ValidatorFunction[] {\n  const validators: ValidatorFunction[] = [];\n\n  for (const [fieldName, field] of fields) {\n    const options: FieldMeta = field._meta ?? {};\n\n    // Skip transient fields (they're not persisted, so no validation needed)\n    if (options.transient || field.transient) {\n      continue;\n    }\n\n    // Required field validator. Check both the `_meta` bag and the top-level\n    // `field.required` (some registration paths, e.g. tenantScoped injection,\n    // set the top-level flag) — mirrors the `transient` check above.\n    if (options.required || field.required) {\n      validators.push(async (instance) => {\n        const value = readInstanceField(instance, fieldName);\n        if (value === null || value === undefined || value === '') {\n          const ValidationError = await import('../errors').then(\n            (m) => m.ValidationError,\n          );\n          return ValidationError.requiredField(fieldName, className);\n        }\n        return null;\n      });\n    }\n\n    // Numeric range validators. The scanner's `FieldDefinition['type']` union\n    // does not list `'number'`, but external/legacy manifests can still carry\n    // it, so widen the comparison to a string check rather than dropping it.\n    const fieldType: string = field.type;\n    if (\n      fieldType === 'integer' ||\n      fieldType === 'decimal' ||\n      fieldType === 'number'\n    ) {\n      const { min, max } = options;\n      if (min !== undefined) {\n        validators.push(async (instance) => {\n          // Numeric-field branch: the runtime value is treated as a number for\n          // the range comparison (JS coercion semantics preserved — the cast is\n          // erased, so the runtime read/compare is unchanged).\n          const value = readInstanceField(instance, fieldName) as number;\n          if (value !== null && value !== undefined && value < min) {\n            const ValidationError = await import('../errors').then(\n              (m) => m.ValidationError,\n            );\n            return ValidationError.rangeError(fieldName, value, min, max);\n          }\n          return null;\n        });\n      }\n\n      if (max !== undefined) {\n        validators.push(async (instance) => {\n          // See the `min` branch: numeric-field value typed as `number` for the\n          // range comparison; runtime behavior is unchanged.\n          const value = readInstanceField(instance, fieldName) as number;\n          if (value !== null && value !== undefined && value > max) {\n            const ValidationError = await import('../errors').then(\n              (m) => m.ValidationError,\n            );\n            return ValidationError.rangeError(fieldName, value, min, max);\n          }\n          return null;\n        });\n      }\n    }\n\n    // String length validators\n    if (fieldType === 'text') {\n      const { minLength, maxLength, pattern } = options;\n      if (minLength !== undefined) {\n        validators.push(async (instance) => {\n          const value = readInstanceField(instance, fieldName);\n          if (value && typeof value === 'string' && value.length < minLength) {\n            const ValidationError = await import('../errors').then(\n              (m) => m.ValidationError,\n            );\n            return ValidationError.invalidValue(\n              fieldName,\n              value,\n              `string with minimum length ${minLength}`,\n            );\n          }\n          return null;\n        });\n      }\n\n      if (maxLength !== undefined) {\n        validators.push(async (instance) => {\n          const value = readInstanceField(instance, fieldName);\n          if (value && typeof value === 'string' && value.length > maxLength) {\n            const ValidationError = await import('../errors').then(\n              (m) => m.ValidationError,\n            );\n            return ValidationError.invalidValue(\n              fieldName,\n              value,\n              `string with maximum length ${maxLength}`,\n            );\n          }\n          return null;\n        });\n      }\n\n      // Pattern validator (regex). `FieldMeta.pattern` is `unknown` (a string\n      // source, a `RegExp`, or an opaque `{}` from a JSON-collapsed manifest);\n      // only string/RegExp sources can build a usable regex.\n      if (typeof pattern === 'string' || pattern instanceof RegExp) {\n        const regex = new RegExp(pattern);\n        validators.push(async (instance) => {\n          const value = readInstanceField(instance, fieldName);\n          if (value && typeof value === 'string' && !regex.test(value)) {\n            const ValidationError = await import('../errors').then(\n              (m) => m.ValidationError,\n            );\n            return ValidationError.invalidValue(\n              fieldName,\n              value,\n              `string matching pattern ${String(pattern)}`,\n            );\n          }\n          return null;\n        });\n      }\n    }\n\n    // Custom validator function. `validate`/`customMessage` arrive through the\n    // open `FieldMeta` index signature as `unknown`; narrow to the callable and\n    // string shapes the validator relies on.\n    const customValidate = options.validate;\n    if (typeof customValidate === 'function') {\n      const validateFn = customValidate as (\n        value: unknown,\n      ) => boolean | Promise<boolean>;\n      const customMessage =\n        typeof options.customMessage === 'string'\n          ? options.customMessage\n          : undefined;\n      validators.push(async (instance) => {\n        const value = readInstanceField(instance, fieldName);\n        try {\n          const isValid = await validateFn(value);\n          if (!isValid) {\n            const ValidationError = await import('../errors').then(\n              (m) => m.ValidationError,\n            );\n            const message =\n              customMessage || `Field ${fieldName} failed custom validation`;\n            return ValidationError.invalidValue(fieldName, value, message);\n          }\n        } catch (error) {\n          const ValidationError = await import('../errors').then(\n            (m) => m.ValidationError,\n          );\n          return ValidationError.invalidValue(\n            fieldName,\n            value,\n            `custom validation error: ${error instanceof Error ? error.message : String(error)}`,\n          );\n        }\n        return null;\n      });\n    }\n  }\n\n  return validators;\n}\n"],"mappings":"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"}
+{"version":3,"file":"validator.js","names":[],"sources":["../../src/registry/validator.ts"],"sourcesContent":["/**\n * Validator module for the SMRT ObjectRegistry.\n *\n * Compiles validation functions from field definitions for runtime use.\n *\n * Extracted from registry.ts as part of issue #1006.\n * @see https://github.com/happyvertical/smrt/issues/1006\n */\n\nimport type { SmrtObject } from '../object';\nimport type { FieldDefinition, FieldMeta } from '../scanner/types.js';\nimport type { ValidatorFunction } from './types';\n\n// Function identity, not a name or inferred source text, proves that the owning\n// compiler generated these validators without user callbacks.\nconst batchSafeValidators = new WeakSet<ValidatorFunction>();\nexport function isBatchSafeValidator(validator: ValidatorFunction): boolean {\n  return batchSafeValidators.has(validator);\n}\n\n/**\n * Read a runtime field value off a SmrtObject instance by dynamic field name.\n *\n * Compiled validators index the instance by `fieldName` (a manifest-driven\n * string), but `SmrtObject` has no string index signature, so a direct\n * `instance[fieldName]` is an implicit-`any` access (TS7053). This single\n * documented view casts through `unknown` to a `Record<string, unknown>` so the\n * dynamic read is typed `unknown` (not `any`) while preserving exact runtime\n * behavior. Routing every validator's field read through here keeps the cast in\n * one place instead of scattering it across each closure.\n */\nfunction readInstanceField(instance: SmrtObject, fieldName: string): unknown {\n  return (instance as unknown as Record<string, unknown>)[fieldName];\n}\n\n/**\n * Compile validation functions from field definitions.\n *\n * Extracts validation rules from field options and compiles them into\n * efficient validation functions that can be executed at runtime.\n *\n * @param className - Name of the class being validated\n * @param fields - Map of field definitions\n * @returns Array of compiled validation functions\n */\nexport function compileValidators(\n  className: string,\n  fields: Map<string, FieldDefinition>,\n): ValidatorFunction[] {\n  const validators: ValidatorFunction[] = [];\n  let custom = false;\n\n  for (const [fieldName, field] of fields) {\n    const options: FieldMeta = field._meta ?? {};\n\n    // Skip transient fields (they're not persisted, so no validation needed)\n    if (options.transient || field.transient) {\n      continue;\n    }\n\n    // Required field validator. Check both the `_meta` bag and the top-level\n    // `field.required` (some registration paths, e.g. tenantScoped injection,\n    // set the top-level flag) — mirrors the `transient` check above.\n    if (options.required || field.required) {\n      validators.push(async (instance) => {\n        const value = readInstanceField(instance, fieldName);\n        if (value === null || value === undefined || value === '') {\n          const ValidationError = await import('../errors').then(\n            (m) => m.ValidationError,\n          );\n          return ValidationError.requiredField(fieldName, className);\n        }\n        return null;\n      });\n    }\n\n    // Numeric range validators. The scanner's `FieldDefinition['type']` union\n    // does not list `'number'`, but external/legacy manifests can still carry\n    // it, so widen the comparison to a string check rather than dropping it.\n    const fieldType: string = field.type;\n    if (\n      fieldType === 'integer' ||\n      fieldType === 'decimal' ||\n      fieldType === 'number'\n    ) {\n      const { min, max } = options;\n      if (min !== undefined) {\n        validators.push(async (instance) => {\n          // Numeric-field branch: the runtime value is treated as a number for\n          // the range comparison (JS coercion semantics preserved — the cast is\n          // erased, so the runtime read/compare is unchanged).\n          const value = readInstanceField(instance, fieldName) as number;\n          if (value !== null && value !== undefined && value < min) {\n            const ValidationError = await import('../errors').then(\n              (m) => m.ValidationError,\n            );\n            return ValidationError.rangeError(fieldName, value, min, max);\n          }\n          return null;\n        });\n      }\n\n      if (max !== undefined) {\n        validators.push(async (instance) => {\n          // See the `min` branch: numeric-field value typed as `number` for the\n          // range comparison; runtime behavior is unchanged.\n          const value = readInstanceField(instance, fieldName) as number;\n          if (value !== null && value !== undefined && value > max) {\n            const ValidationError = await import('../errors').then(\n              (m) => m.ValidationError,\n            );\n            return ValidationError.rangeError(fieldName, value, min, max);\n          }\n          return null;\n        });\n      }\n    }\n\n    // String length validators\n    if (fieldType === 'text') {\n      const { minLength, maxLength, pattern } = options;\n      if (minLength !== undefined) {\n        validators.push(async (instance) => {\n          const value = readInstanceField(instance, fieldName);\n          if (value && typeof value === 'string' && value.length < minLength) {\n            const ValidationError = await import('../errors').then(\n              (m) => m.ValidationError,\n            );\n            return ValidationError.invalidValue(\n              fieldName,\n              value,\n              `string with minimum length ${minLength}`,\n            );\n          }\n          return null;\n        });\n      }\n\n      if (maxLength !== undefined) {\n        validators.push(async (instance) => {\n          const value = readInstanceField(instance, fieldName);\n          if (value && typeof value === 'string' && value.length > maxLength) {\n            const ValidationError = await import('../errors').then(\n              (m) => m.ValidationError,\n            );\n            return ValidationError.invalidValue(\n              fieldName,\n              value,\n              `string with maximum length ${maxLength}`,\n            );\n          }\n          return null;\n        });\n      }\n\n      // Pattern validator (regex). `FieldMeta.pattern` is `unknown` (a string\n      // source, a `RegExp`, or an opaque `{}` from a JSON-collapsed manifest);\n      // only string/RegExp sources can build a usable regex.\n      if (typeof pattern === 'string' || pattern instanceof RegExp) {\n        const regex = new RegExp(pattern);\n        validators.push(async (instance) => {\n          const value = readInstanceField(instance, fieldName);\n          if (value && typeof value === 'string' && !regex.test(value)) {\n            const ValidationError = await import('../errors').then(\n              (m) => m.ValidationError,\n            );\n            return ValidationError.invalidValue(\n              fieldName,\n              value,\n              `string matching pattern ${String(pattern)}`,\n            );\n          }\n          return null;\n        });\n      }\n    }\n\n    // Custom validator function. `validate`/`customMessage` arrive through the\n    // open `FieldMeta` index signature as `unknown`; narrow to the callable and\n    // string shapes the validator relies on.\n    const customValidate = options.validate;\n    if (typeof customValidate === 'function') {\n      custom = true;\n      const validateFn = customValidate as (\n        value: unknown,\n      ) => boolean | Promise<boolean>;\n      const customMessage =\n        typeof options.customMessage === 'string'\n          ? options.customMessage\n          : undefined;\n      validators.push(async (instance) => {\n        const value = readInstanceField(instance, fieldName);\n        try {\n          const isValid = await validateFn(value);\n          if (!isValid) {\n            const ValidationError = await import('../errors').then(\n              (m) => m.ValidationError,\n            );\n            const message =\n              customMessage || `Field ${fieldName} failed custom validation`;\n            return ValidationError.invalidValue(fieldName, value, message);\n          }\n        } catch (error) {\n          const ValidationError = await import('../errors').then(\n            (m) => m.ValidationError,\n          );\n          return ValidationError.invalidValue(\n            fieldName,\n            value,\n            `custom validation error: ${error instanceof Error ? error.message : String(error)}`,\n          );\n        }\n        return null;\n      });\n    }\n  }\n\n  if (!custom) {\n    for (const validator of validators) batchSafeValidators.add(validator);\n  }\n  return validators;\n}\n"],"mappings":";AAeA,IAAM,sCAAsB,IAAI,QAA2B;AAC3D,SAAgB,qBAAqB,WAAuC;CAC1E,OAAO,oBAAoB,IAAI,SAAS;AAC1C;;;;;;;;;;;;AAaA,SAAS,kBAAkB,UAAsB,WAA4B;CAC3E,OAAQ,SAAgD;AAC1D;;;;;;;;;;;AAYA,SAAgB,kBACd,WACA,QACqB;CACrB,MAAM,aAAkC,CAAC;CACzC,IAAI,SAAS;CAEb,KAAK,MAAM,CAAC,WAAW,UAAU,QAAQ;EACvC,MAAM,UAAqB,MAAM,SAAS,CAAC;EAG3C,IAAI,QAAQ,aAAa,MAAM,WAC7B;EAMF,IAAI,QAAQ,YAAY,MAAM,UAC5B,WAAW,KAAK,OAAO,aAAa;GAClC,MAAM,QAAQ,kBAAkB,UAAU,SAAS;GACnD,IAAI,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,IAIrD,QAAO,MAHuB,OAAO,eAAY,CAAC,MAC/C,MAAM,EAAE,eACX,EAAA,CACuB,cAAc,WAAW,SAAS;GAE3D,OAAO;EACT,CAAC;EAMH,MAAM,YAAoB,MAAM;EAChC,IACE,cAAc,aACd,cAAc,aACd,cAAc,UACd;GACA,MAAM,EAAE,KAAK,QAAQ;GACrB,IAAI,QAAQ,KAAA,GACV,WAAW,KAAK,OAAO,aAAa;IAIlC,MAAM,QAAQ,kBAAkB,UAAU,SAAS;IACnD,IAAI,UAAU,QAAQ,UAAU,KAAA,KAAa,QAAQ,KAInD,QAAO,MAHuB,OAAO,eAAY,CAAC,MAC/C,MAAM,EAAE,eACX,EAAA,CACuB,WAAW,WAAW,OAAO,KAAK,GAAG;IAE9D,OAAO;GACT,CAAC;GAGH,IAAI,QAAQ,KAAA,GACV,WAAW,KAAK,OAAO,aAAa;IAGlC,MAAM,QAAQ,kBAAkB,UAAU,SAAS;IACnD,IAAI,UAAU,QAAQ,UAAU,KAAA,KAAa,QAAQ,KAInD,QAAO,MAHuB,OAAO,eAAY,CAAC,MAC/C,MAAM,EAAE,eACX,EAAA,CACuB,WAAW,WAAW,OAAO,KAAK,GAAG;IAE9D,OAAO;GACT,CAAC;EAEL;EAGA,IAAI,cAAc,QAAQ;GACxB,MAAM,EAAE,WAAW,WAAW,YAAY;GAC1C,IAAI,cAAc,KAAA,GAChB,WAAW,KAAK,OAAO,aAAa;IAClC,MAAM,QAAQ,kBAAkB,UAAU,SAAS;IACnD,IAAI,SAAS,OAAO,UAAU,YAAY,MAAM,SAAS,WAIvD,QAAO,MAHuB,OAAO,eAAY,CAAC,MAC/C,MAAM,EAAE,eACX,EAAA,CACuB,aACrB,WACA,OACA,8BAA8B,WAChC;IAEF,OAAO;GACT,CAAC;GAGH,IAAI,cAAc,KAAA,GAChB,WAAW,KAAK,OAAO,aAAa;IAClC,MAAM,QAAQ,kBAAkB,UAAU,SAAS;IACnD,IAAI,SAAS,OAAO,UAAU,YAAY,MAAM,SAAS,WAIvD,QAAO,MAHuB,OAAO,eAAY,CAAC,MAC/C,MAAM,EAAE,eACX,EAAA,CACuB,aACrB,WACA,OACA,8BAA8B,WAChC;IAEF,OAAO;GACT,CAAC;GAMH,IAAI,OAAO,YAAY,YAAY,mBAAmB,QAAQ;IAC5D,MAAM,QAAQ,IAAI,OAAO,OAAO;IAChC,WAAW,KAAK,OAAO,aAAa;KAClC,MAAM,QAAQ,kBAAkB,UAAU,SAAS;KACnD,IAAI,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,KAAK,KAAK,GAIzD,QAAO,MAHuB,OAAO,eAAY,CAAC,MAC/C,MAAM,EAAE,eACX,EAAA,CACuB,aACrB,WACA,OACA,2BAA2B,OAAO,OAAO,GAC3C;KAEF,OAAO;IACT,CAAC;GACH;EACF;EAKA,MAAM,iBAAiB,QAAQ;EAC/B,IAAI,OAAO,mBAAmB,YAAY;GACxC,SAAS;GACT,MAAM,aAAa;GAGnB,MAAM,gBACJ,OAAO,QAAQ,kBAAkB,WAC7B,QAAQ,gBACR,KAAA;GACN,WAAW,KAAK,OAAO,aAAa;IAClC,MAAM,QAAQ,kBAAkB,UAAU,SAAS;IACnD,IAAI;KAEF,IAAI,CAAC,MADiB,WAAW,KAAK,GACxB;MACZ,MAAM,kBAAkB,MAAM,OAAO,eAAY,CAAC,MAC/C,MAAM,EAAE,eACX;MACA,MAAM,UACJ,iBAAiB,SAAS,UAAU;MACtC,OAAO,gBAAgB,aAAa,WAAW,OAAO,OAAO;KAC/D;IACF,SAAS,OAAO;KAId,QAAO,MAHuB,OAAO,eAAY,CAAC,MAC/C,MAAM,EAAE,eACX,EAAA,CACuB,aACrB,WACA,OACA,4BAA4B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACnF;IACF;IACA,OAAO;GACT,CAAC;EACH;CACF;CAEA,IAAI,CAAC,QACH,KAAK,MAAM,aAAa,YAAY,oBAAoB,IAAI,SAAS;CAEvE,OAAO;AACT"}

package/dist/registry.js

@@ -13,10 +13,10 @@ import { findClass, findClassesByName, getAllClasses, getCanonicalClassName, get
 import { getAllFields, getAllMethods, getInheritanceChain, mergeFieldConfigs } from "./registry/inheritance-resolver.js";
 import { resolveCollectionCacheConfig } from "./registry/cache-config.js";
 import { defaultConflictColumns, resolveTenantColumn } from "./schema/conflict-target.js";
+import { compileValidators } from "./registry/validator.js";
 import "./utils.js";
 import { isFrameworkBaseClass } from "./registry/framework-base-classes.js";
 import { createFieldFromManifest, manifestFieldDiffers, mergeManifestField } from "./registry/manifest-field-merge.js";
-import { compileValidators } from "./registry/validator.js";
 import { ensureTenantScopedField, invalidateInheritanceEntries, register, registerCollection, registerFromManifest } from "./registry/class-registration.js";
 import { getEmbeddingClasses, getEmbeddingConfig, getProjectEmbeddingConfig, hasEmbeddings, resolveEmbeddingConfig } from "./registry/embedding-manager.js";
 import { getDependencyGraph, getRelationshipMap, resolveRelationshipTarget } from "./registry/relationship-graph.js";

package/dist/scanner/manifest-generator.d.ts.map

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

package/dist/scanner/manifest-generator.js

@@ -369,7 +369,13 @@ var ManifestGenerator = class {
 	generateSchemas(manifest) {
 		const generator = new SchemaGenerator();
 		const aggregatedManifest = this.createAggregatedManifest(manifest);
+		const schemaClasses = new Map(Object.values(aggregatedManifest.objects).map((obj) => [obj.className, obj]));
+		for (const obj of Object.values(manifest.objects)) schemaClasses.set(obj.className, obj);
 		for (const [name, obj] of Object.entries(manifest.objects)) {
+			if (this.extendsCollection(obj, schemaClasses)) {
+				delete obj.schema;
+				continue;
+			}
 			if (FRAMEWORK_ABSTRACT_BASE_NAMES.has(obj.className)) continue;
 			const tableName = obj.decoratorConfig?.tableName || this.classNameToTableName(obj.className);
 			if (obj.decoratorConfig?.tableStrategy === "sti" || this.isSTIChildClass(obj, manifest)) {
@@ -387,6 +393,20 @@ var ManifestGenerator = class {
 			}
 		}
 		this.resolveSamePackageForeignKeyColumnTypes(manifest, generator);
+		for (const obj of Object.values(manifest.objects)) {
+			if (!this.extendsCollection(obj, schemaClasses)) continue;
+			let current = obj;
+			const visited = /* @__PURE__ */ new Set();
+			while (current && !visited.has(current)) {
+				visited.add(current);
+				const item = this.findItemClass(current, aggregatedManifest, schemaClasses);
+				if (item?.schema && !this.extendsCollection(item, schemaClasses)) {
+					obj.schema = structuredClone(item.schema);
+					break;
+				}
+				current = current.extends ? schemaClasses.get(current.extends) : void 0;
+			}
+		}
 	}
 	normalizeReportObjects(manifest) {
 		for (const obj of Object.values(manifest.objects)) {
@@ -551,6 +571,7 @@ var ManifestGenerator = class {
 				name: index.name,
 				columns: index.columns,
 				unique: index.unique,
+				...index.nullsNotDistinct ? { nullsNotDistinct: true } : {},
 				where: index.where,
 				jsonPath: index.jsonPath
 			})),