joist-codegen 2.3.0-next.42 → 2.3.0-next.43

package/build/inheritance.cjs

@@ -0,0 +1,213 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_utils = require("./utils.cjs");
+require("./config.cjs");
+const require_EntityDbMetadata = require("./EntityDbMetadata.cjs");
+//#region src/inheritance.ts
+function applyInheritanceUpdates(config, db) {
+	const { entities, entitiesByName } = db;
+	setClassTableInheritance(entities, entitiesByName);
+	expandSingleTableInheritance(config, entitiesByName, entities);
+	rewriteSingleTableForeignKeys(config, entities);
+	setupSubTypeSpecialization(config, entities);
+	require_EntityDbMetadata.canonicalizeOtherEntities(db);
+}
+/**
+* Looks for subtypes specializing a FK of their base type, and give them a specialized m2o.
+*
+* I.e. `SmallPublishers.group: SmallPublisherGroup`.
+*
+* This means the `publishers.group_id` FK will actually be in the `EntityDbMetadata` twice,
+* once for the base and once for the child, which is unusual, but gets the types generated
+* that we want, and then we fixup/dedupe them at runtime in `configure.ts` when creating
+* `meta.allFields`.
+*/
+function setupSubTypeSpecialization(config, entities) {
+	for (const entity of entities) if (entity.baseType) {
+		const entityConfig = config.entities[entity.name];
+		const baseConfig = config.entities[entity.baseType.name];
+		for (const rel of [...entity.baseType.manyToOnes, ...entity.baseType.oneToManys]) {
+			const { notNull } = entityConfig?.relations?.[rel.fieldName] ?? {};
+			const subType = entityConfig?.relations?.[rel.fieldName]?.subType ?? baseConfig?.relations?.[rel.fieldName]?.subType ?? baseConfig?.relations?.[rel.otherFieldName]?.subType ?? (notNull ? rel.otherEntity.name : void 0);
+			if (!subType) {} else if (subType === "self" && rel.kind === "m2o") entity.manyToOnes.push({
+				...rel,
+				...notNull ? { notNull } : {},
+				otherEntity: require_EntityDbMetadata.makeEntity(entity.name)
+			});
+			else if (subType === "self" && rel.kind === "o2m") entity.oneToManys.push({
+				...rel,
+				...notNull ? { notNull } : {},
+				otherEntity: require_EntityDbMetadata.makeEntity(entity.name)
+			});
+			else if (rel.kind === "m2o") entity.manyToOnes.push({
+				...rel,
+				...notNull ? { notNull } : {},
+				otherEntity: require_EntityDbMetadata.makeEntity(subType)
+			});
+			else if (rel.kind === "o2m") entity.oneToManys.push({
+				...rel,
+				...notNull ? { notNull } : {},
+				otherEntity: require_EntityDbMetadata.makeEntity(subType)
+			});
+		}
+		for (const field of entity.baseType?.primitives ?? []) {
+			const { notNull } = entityConfig?.fields?.[field.fieldName] ?? {};
+			if (notNull) entity.primitives.push({
+				...field,
+				notNull
+			});
+		}
+	}
+}
+/**
+* Ensure CTI base types have their inheritanceType set.
+*
+* (We automatically set `inheritanceType` for STI tables when we see their config
+* setup, see `expandSingleTableInheritance`.)
+*/
+function setClassTableInheritance(entities, entitiesByName) {
+	const ctiBaseNames = [];
+	for (const entity of entities) if (entity.baseClassName) {
+		ctiBaseNames.push(entity.baseClassName);
+		const base = entitiesByName[entity.baseClassName];
+		entity.baseType = base;
+		base.subTypes.push(entity);
+	}
+	for (const entity of entities) if (ctiBaseNames.includes(entity.name)) entity.inheritanceType = "cti";
+}
+/** Expands STI tables into multiple entities, so they get separate `SubTypeCodegen.ts` & `SubType.ts` files. */
+function expandSingleTableInheritance(config, entitiesByName, entities) {
+	for (const entity of entities) {
+		const [fieldName, stiField] = Object.entries(config.entities[entity.name]?.fields || {}).find(([, f]) => !!f.stiDiscriminator) ?? [];
+		if (fieldName && stiField && stiField.stiDiscriminator) {
+			entity.inheritanceType = "sti";
+			const enumField = entity.enums.find((e) => e.fieldName === fieldName) ?? require_utils.fail(`No enum column found for ${entity.name}.${fieldName}, which is required to use singleTableInheritance`);
+			entity.stiDiscriminatorField = enumField.fieldName;
+			const subTypes = Object.entries(stiField.stiDiscriminator);
+			const allFields = [...Object.entries(config.entities[entity.name]?.fields ?? {}), ...Object.entries(config.entities[entity.name]?.relations ?? {})];
+			const availableCodes = subTypes.map(([code]) => code);
+			const availableNames = subTypes.map(([, name]) => name);
+			const available = [...availableCodes, ...availableNames];
+			allFields.filter(([name, f]) => {
+				if (f.stiType && !available.includes(f.stiType)) require_utils.fail(`${name}.stiType '${f.stiType}' is invalid, expected one of ${available.join(", ")}`);
+			});
+			for (const [enumCode, subTypeName] of subTypes) {
+				const subTypeFields = allFields.filter(([, f]) => f.stiType === subTypeName || f.stiType === enumCode);
+				const subTypeFieldNames = subTypeFields.map(([name]) => name);
+				function maybeRequired(field) {
+					if ((subTypeFields.find(([name]) => name === field.fieldName)?.[1]).notNull) field.notNull = true;
+					return field;
+				}
+				const subEntity = {
+					name: subTypeName,
+					entity: require_EntityDbMetadata.makeEntity(subTypeName),
+					tableName: entity.tableName,
+					primaryKey: entity.primaryKey,
+					primitives: entity.primitives.filter((f) => subTypeFieldNames.includes(f.fieldName)).map(maybeRequired),
+					enums: entity.enums.filter((f) => subTypeFieldNames.includes(f.fieldName)).map(maybeRequired),
+					pgEnums: entity.pgEnums.filter((f) => subTypeFieldNames.includes(f.fieldName)).map(maybeRequired),
+					manyToOnes: entity.manyToOnes.filter((f) => subTypeFieldNames.includes(f.fieldName)).map(maybeRequired),
+					oneToManys: entity.oneToManys.filter((f) => subTypeFieldNames.includes(f.fieldName)),
+					largeOneToManys: entity.largeOneToManys.filter((f) => subTypeFieldNames.includes(f.fieldName)),
+					oneToOnes: entity.oneToOnes.filter((f) => subTypeFieldNames.includes(f.fieldName)),
+					manyToManys: entity.manyToManys.filter((f) => subTypeFieldNames.includes(f.fieldName)),
+					largeManyToManys: entity.largeManyToManys.filter((f) => subTypeFieldNames.includes(f.fieldName)),
+					manyToManyEnums: entity.manyToManyEnums.filter((f) => subTypeFieldNames.includes(f.fieldName)),
+					polymorphics: entity.polymorphics.filter((f) => subTypeFieldNames.includes(f.fieldName)),
+					tagName: entity.tagName,
+					createdAt: void 0,
+					updatedAt: void 0,
+					deletedAt: void 0,
+					baseClassName: entity.name,
+					baseType: entity,
+					subTypes: [],
+					inheritanceType: "sti",
+					stiDiscriminatorValue: (enumField.enumRows.find((r) => r.code === enumCode) ?? require_utils.fail(`No enum row found for ${entity.name}.${fieldName}.${enumCode}`)).id,
+					abstract: false,
+					nonDeferredFkOrder: entity.nonDeferredFkOrder,
+					get nonDeferredFks() {
+						return [...this.manyToOnes.filter((r) => !r.isDeferredAndDeferrable), ...this.polymorphics.flatMap((p) => p.components).filter((c) => !c.isDeferredAndDeferrable)];
+					},
+					get nonDeferredManyToManyFks() {
+						return this.manyToManys.filter((r) => !r.isDeferredAndDeferrable);
+					}
+				};
+				entity.primitives = entity.primitives.filter((f) => !subTypeFieldNames.includes(f.fieldName));
+				entity.enums = entity.enums.filter((f) => !subTypeFieldNames.includes(f.fieldName));
+				entity.pgEnums = entity.pgEnums.filter((f) => !subTypeFieldNames.includes(f.fieldName));
+				entity.manyToOnes = entity.manyToOnes.filter((f) => !subTypeFieldNames.includes(f.fieldName));
+				entity.oneToManys = entity.oneToManys.filter((f) => !subTypeFieldNames.includes(f.fieldName));
+				entity.largeOneToManys = entity.largeOneToManys.filter((f) => !subTypeFieldNames.includes(f.fieldName));
+				entity.oneToOnes = entity.oneToOnes.filter((f) => !subTypeFieldNames.includes(f.fieldName));
+				entity.manyToManys = entity.manyToManys.filter((f) => !subTypeFieldNames.includes(f.fieldName));
+				entity.largeManyToManys = entity.largeManyToManys.filter((f) => !subTypeFieldNames.includes(f.fieldName));
+				entity.manyToManyEnums = entity.manyToManyEnums.filter((f) => !subTypeFieldNames.includes(f.fieldName));
+				entity.polymorphics = entity.polymorphics.filter((f) => !subTypeFieldNames.includes(f.fieldName));
+				entity.subTypes.push(subEntity);
+				entities.push(subEntity);
+				entitiesByName[subEntity.name] = subEntity;
+			}
+		}
+	}
+}
+let stiEntities;
+function getStiEntities(entities) {
+	if (stiEntities) return stiEntities;
+	stiEntities = /* @__PURE__ */ new Map();
+	for (const entity of entities) if (entity.inheritanceType === "sti" && entity.stiDiscriminatorField) {
+		const base = entity;
+		const subTypes = entities.filter((s) => s.baseClassName === entity.name && s !== entity);
+		stiEntities.set(entity.name, {
+			base,
+			subTypes
+		});
+		for (const subType of subTypes) stiEntities.set(subType.name, {
+			base,
+			subTypes: []
+		});
+	}
+	return stiEntities;
+}
+/** Finds FKs pointing to the base table and, if configured, rewrites them to point to the sub-tables. */
+function rewriteSingleTableForeignKeys(config, entities) {
+	const stiEntities = getStiEntities(entities);
+	if (stiEntities.size === 0) return;
+	for (const entity of entities) {
+		for (const m2o of entity.manyToOnes) {
+			const target = stiEntities.get(m2o.otherEntity.name);
+			const base = target?.base.entity.name;
+			const stiType = base && config.entities[base]?.relations?.[m2o.otherFieldName]?.stiType;
+			if (target && stiType) {
+				const { subTypes } = target;
+				m2o.otherEntity = (subTypes.find((s) => s.name === stiType) ?? require_utils.fail(`Could not find STI type '${stiType}' in ${subTypes.map((s) => s.name)}`)).entity;
+			}
+		}
+		for (const poly of entity.polymorphics) for (const comp of poly.components) {
+			const target = stiEntities.get(comp.otherEntity.name);
+			const base = target?.base.entity.name;
+			const stiType = base && config.entities[base]?.relations?.[comp.otherFieldName]?.stiType;
+			if (target && stiType) {
+				const { subTypes } = target;
+				comp.otherEntity = (subTypes.find((s) => s.name === stiType) ?? require_utils.fail(`Could not find STI type '${stiType}' in ${subTypes.map((s) => s.name)}`)).entity;
+			}
+		}
+		for (const o2m of entity.oneToManys) {
+			const target = stiEntities.get(o2m.otherEntity.name);
+			if (target && target.base.inheritanceType === "sti") {
+				const otherField = target.subTypes.find((st) => !target.base.manyToOnes.some((m) => m.fieldName === o2m.otherFieldName) && st.manyToOnes.some((m) => m.fieldName === o2m.otherFieldName));
+				if (otherField) o2m.otherEntity = otherField.entity;
+			}
+		}
+		for (const m2m of entity.manyToManys) {
+			const target = stiEntities.get(m2m.otherEntity.name);
+			if (target && target.base.inheritanceType === "sti") {
+				const otherField = target.subTypes.find((st) => !target.base.manyToManys.some((m) => m.fieldName === m2m.otherFieldName) && st.manyToManys.some((m) => m.fieldName === m2m.otherFieldName));
+				if (otherField) m2m.otherEntity = otherField.entity;
+			}
+		}
+	}
+}
+//#endregion
+exports.applyInheritanceUpdates = applyInheritanceUpdates;
+exports.getStiEntities = getStiEntities;
+
+//# sourceMappingURL=inheritance.cjs.map

package/build/inheritance.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inheritance.cjs","names":["makeEntity","fail"],"sources":["../src/inheritance.ts"],"sourcesContent":["import { type Config } from \"./config.ts\";\nimport {\n  type DbMetadata,\n  type EntityDbMetadata,\n  type ManyToManyField,\n  type ManyToOneField,\n  type PolymorphicFieldComponent,\n  canonicalizeOtherEntities,\n  makeEntity,\n} from \"./EntityDbMetadata.ts\";\nimport { fail } from \"./utils.ts\";\n\nexport function applyInheritanceUpdates(config: Config, db: DbMetadata): void {\n  const { entities, entitiesByName } = db;\n  setClassTableInheritance(entities, entitiesByName);\n  expandSingleTableInheritance(config, entitiesByName, entities);\n  rewriteSingleTableForeignKeys(config, entities);\n  setupSubTypeSpecialization(config, entities);\n  // Now that all relations (incl. specialized ones) exist, collapse the duplicate `otherEntity` objects\n  canonicalizeOtherEntities(db);\n}\n\n/**\n * Looks for subtypes specializing a FK of their base type, and give them a specialized m2o.\n *\n * I.e. `SmallPublishers.group: SmallPublisherGroup`.\n *\n * This means the `publishers.group_id` FK will actually be in the `EntityDbMetadata` twice,\n * once for the base and once for the child, which is unusual, but gets the types generated\n * that we want, and then we fixup/dedupe them at runtime in `configure.ts` when creating\n * `meta.allFields`.\n */\nfunction setupSubTypeSpecialization(config: Config, entities: EntityDbMetadata[]): void {\n  for (const entity of entities) {\n    if (entity.baseType) {\n      const entityConfig = config.entities[entity.name];\n      const baseConfig = config.entities[entity.baseType.name];\n      // Look through the base's m2os & o2ms, looking for a config specialization\n      for (const rel of [...entity.baseType.manyToOnes, ...entity.baseType.oneToManys]) {\n        const { notNull } = entityConfig?.relations?.[rel.fieldName] ?? {};\n        const subType =\n          entityConfig?.relations?.[rel.fieldName]?.subType ??\n          baseConfig?.relations?.[rel.fieldName]?.subType ??\n          // Probe the otherFieldName for a `subType: \"self\"` on self-referential relations in STI tables\n          baseConfig?.relations?.[rel.otherFieldName]?.subType ??\n          // if we are only marking the relation as required and not specifying a subtype, then use the original type\n          (notNull ? rel.otherEntity.name : undefined);\n\n        if (!subType) {\n          // continue...\n        } else if (subType === \"self\" && rel.kind === \"m2o\") {\n          // Specialize `TaskNew.copiedFrom: TaskNew` & `TaskOld.copiedFrom: TaskOld`\n          entity.manyToOnes.push({ ...rel, ...(notNull ? { notNull } : {}), otherEntity: makeEntity(entity.name) });\n        } else if (subType === \"self\" && rel.kind === \"o2m\") {\n          // Specialize `TaskNew.copiedTo: TaskNew[]` & `TaskOld.copiedTo: TaskOld[]`\n          entity.oneToManys.push({ ...rel, ...(notNull ? { notNull } : {}), otherEntity: makeEntity(entity.name) });\n        } else if (rel.kind === \"m2o\") {\n          // Specialize `SmallPublisher.group: SmallPublisherGroup`\n          entity.manyToOnes.push({ ...rel, ...(notNull ? { notNull } : {}), otherEntity: makeEntity(subType) });\n        } else if (rel.kind === \"o2m\") {\n          // Specialize `SmallPublisherGroup.publishers: SmallPublisher`\n          entity.oneToManys.push({ ...rel, ...(notNull ? { notNull } : {}), otherEntity: makeEntity(subType) });\n        }\n      }\n\n      // Look through the base's primitives looking for a config specialization\n      for (const field of entity.baseType?.primitives ?? []) {\n        // the only specialization a primitive can have is nullability\n        const { notNull } = entityConfig?.fields?.[field.fieldName] ?? {};\n        if (notNull) {\n          entity.primitives.push({ ...field, notNull });\n        }\n      }\n    }\n  }\n}\n\n/**\n * Ensure CTI base types have their inheritanceType set.\n *\n * (We automatically set `inheritanceType` for STI tables when we see their config\n * setup, see `expandSingleTableInheritance`.)\n */\nfunction setClassTableInheritance(\n  entities: EntityDbMetadata[],\n  entitiesByName: Record<string, EntityDbMetadata>,\n): void {\n  const ctiBaseNames: string[] = [];\n  for (const entity of entities) {\n    if (entity.baseClassName) {\n      ctiBaseNames.push(entity.baseClassName);\n      const base = entitiesByName[entity.baseClassName];\n      entity.baseType = base;\n      base.subTypes.push(entity);\n    }\n  }\n  for (const entity of entities) {\n    if (ctiBaseNames.includes(entity.name)) entity.inheritanceType = \"cti\";\n  }\n}\n\n/** Expands STI tables into multiple entities, so they get separate `SubTypeCodegen.ts` & `SubType.ts` files. */\nfunction expandSingleTableInheritance(\n  config: Config,\n  entitiesByName: Record<string, EntityDbMetadata>,\n  entities: EntityDbMetadata[],\n): void {\n  for (const entity of entities) {\n    const [fieldName, stiField] =\n      Object.entries(config.entities[entity.name]?.fields || {}).find(([, f]) => !!f.stiDiscriminator) ?? [];\n    if (fieldName && stiField && stiField.stiDiscriminator) {\n      entity.inheritanceType = \"sti\";\n\n      // Ensure we have an enum field so that we can bake the STI discriminators into the metadata.ts file\n      const enumField =\n        entity.enums.find((e) => e.fieldName === fieldName) ??\n        fail(`No enum column found for ${entity.name}.${fieldName}, which is required to use singleTableInheritance`);\n      entity.stiDiscriminatorField = enumField.fieldName;\n\n      // Find the available discriminators/subtypes, i.e. NEW => NewTask, OLD => OldTask, etc.\n      const subTypes = Object.entries(stiField.stiDiscriminator);\n\n      const allFields = [\n        ...Object.entries(config.entities[entity.name]?.fields ?? {}),\n        ...Object.entries(config.entities[entity.name]?.relations ?? {}),\n      ];\n\n      // Make sure there aren't any typos in `stiType`s\n      const availableCodes = subTypes.map(([code]) => code);\n      const availableNames = subTypes.map(([, name]) => name);\n      const available = [...availableCodes, ...availableNames];\n      allFields.filter(([name, f]) => {\n        if (f.stiType && !available.includes(f.stiType)) {\n          fail(`${name}.stiType '${f.stiType}' is invalid, expected one of ${available.join(\", \")}`);\n        }\n      });\n\n      // Now split each subType out into its out entity\n      for (const [enumCode, subTypeName] of subTypes) {\n        // Find all the base entity's fields that belong to us\n        const subTypeFields = allFields.filter(([, f]) => f.stiType === subTypeName || f.stiType === enumCode);\n        const subTypeFieldNames = subTypeFields.map(([name]) => name);\n\n        // Make fields as required\n        function maybeRequired<T extends { notNull: boolean; fieldName: string }>(field: T): T {\n          const config = subTypeFields.find(([name]) => name === field.fieldName)?.[1]!;\n          if (config.notNull) field.notNull = true;\n          return field;\n        }\n\n        // Synthesize an entity for this STI sub-entity\n        const subEntity: EntityDbMetadata = {\n          name: subTypeName,\n          entity: makeEntity(subTypeName),\n          tableName: entity.tableName,\n          primaryKey: entity.primaryKey,\n          primitives: entity.primitives.filter((f) => subTypeFieldNames.includes(f.fieldName)).map(maybeRequired),\n          enums: entity.enums.filter((f) => subTypeFieldNames.includes(f.fieldName)).map(maybeRequired),\n          pgEnums: entity.pgEnums.filter((f) => subTypeFieldNames.includes(f.fieldName)).map(maybeRequired),\n          manyToOnes: entity.manyToOnes.filter((f) => subTypeFieldNames.includes(f.fieldName)).map(maybeRequired),\n          oneToManys: entity.oneToManys.filter((f) => subTypeFieldNames.includes(f.fieldName)),\n          largeOneToManys: entity.largeOneToManys.filter((f) => subTypeFieldNames.includes(f.fieldName)),\n          oneToOnes: entity.oneToOnes.filter((f) => subTypeFieldNames.includes(f.fieldName)),\n          manyToManys: entity.manyToManys.filter((f) => subTypeFieldNames.includes(f.fieldName)),\n          largeManyToManys: entity.largeManyToManys.filter((f) => subTypeFieldNames.includes(f.fieldName)),\n          manyToManyEnums: entity.manyToManyEnums.filter((f) => subTypeFieldNames.includes(f.fieldName)),\n          polymorphics: entity.polymorphics.filter((f) => subTypeFieldNames.includes(f.fieldName)),\n          tagName: entity.tagName,\n          createdAt: undefined,\n          updatedAt: undefined,\n          deletedAt: undefined,\n          baseClassName: entity.name,\n          baseType: entity,\n          subTypes: [],\n          inheritanceType: \"sti\",\n          stiDiscriminatorValue: (\n            enumField.enumRows.find((r) => r.code === enumCode) ??\n            fail(`No enum row found for ${entity.name}.${fieldName}.${enumCode}`)\n          ).id,\n          abstract: false,\n          nonDeferredFkOrder: entity.nonDeferredFkOrder,\n          get nonDeferredFks(): Array<ManyToOneField | PolymorphicFieldComponent> {\n            return [\n              ...this.manyToOnes.filter((r) => !r.isDeferredAndDeferrable),\n              ...this.polymorphics.flatMap((p) => p.components).filter((c) => !c.isDeferredAndDeferrable),\n            ];\n          },\n          get nonDeferredManyToManyFks(): Array<ManyToManyField> {\n            return this.manyToManys.filter((r) => !r.isDeferredAndDeferrable);\n          },\n        };\n\n        // Now strip all the subclass fields from the base class\n        entity.primitives = entity.primitives.filter((f) => !subTypeFieldNames.includes(f.fieldName));\n        entity.enums = entity.enums.filter((f) => !subTypeFieldNames.includes(f.fieldName));\n        entity.pgEnums = entity.pgEnums.filter((f) => !subTypeFieldNames.includes(f.fieldName));\n        entity.manyToOnes = entity.manyToOnes.filter((f) => !subTypeFieldNames.includes(f.fieldName));\n        entity.oneToManys = entity.oneToManys.filter((f) => !subTypeFieldNames.includes(f.fieldName));\n        entity.largeOneToManys = entity.largeOneToManys.filter((f) => !subTypeFieldNames.includes(f.fieldName));\n        entity.oneToOnes = entity.oneToOnes.filter((f) => !subTypeFieldNames.includes(f.fieldName));\n        entity.manyToManys = entity.manyToManys.filter((f) => !subTypeFieldNames.includes(f.fieldName));\n        entity.largeManyToManys = entity.largeManyToManys.filter((f) => !subTypeFieldNames.includes(f.fieldName));\n        entity.manyToManyEnums = entity.manyToManyEnums.filter((f) => !subTypeFieldNames.includes(f.fieldName));\n        entity.polymorphics = entity.polymorphics.filter((f) => !subTypeFieldNames.includes(f.fieldName));\n        entity.subTypes.push(subEntity);\n\n        entities.push(subEntity);\n        entitiesByName[subEntity.name] = subEntity;\n      }\n    }\n  }\n}\n\ntype StiEntityMap = Map<string, { base: EntityDbMetadata; subTypes: EntityDbMetadata[] }>;\nlet stiEntities: StiEntityMap;\n\nexport function getStiEntities(entities: EntityDbMetadata[]): StiEntityMap {\n  if (stiEntities) return stiEntities;\n  stiEntities = new Map();\n  for (const entity of entities) {\n    if (entity.inheritanceType === \"sti\" && entity.stiDiscriminatorField) {\n      const base = entity;\n      const subTypes = entities.filter((s) => s.baseClassName === entity.name && s !== entity);\n      stiEntities.set(entity.name, { base, subTypes });\n      // Allow looking up by subType name\n      for (const subType of subTypes) {\n        stiEntities.set(subType.name, { base, subTypes: [] });\n      }\n    }\n  }\n  return stiEntities;\n}\n\n/** Finds FKs pointing to the base table and, if configured, rewrites them to point to the sub-tables. */\nfunction rewriteSingleTableForeignKeys(config: Config, entities: EntityDbMetadata[]): void {\n  // See if we even have any STI tables\n  const stiEntities = getStiEntities(entities);\n  if (stiEntities.size === 0) return;\n  // Scan for other entities/relations that point to the STI table\n  for (const entity of entities) {\n    // m2os -- Look for `entity.task_id` FKs pointing at `Task` and, if configured, rewrite them to point at `TaskOld`\n    for (const m2o of entity.manyToOnes) {\n      const target = stiEntities.get(m2o.otherEntity.name);\n      const base = target?.base.entity.name;\n      // See if the user has pushed `Task.entities` down to a subtype\n      const stiType = base && config.entities[base]?.relations?.[m2o.otherFieldName]?.stiType;\n      if (target && stiType) {\n        const { subTypes } = target;\n        m2o.otherEntity = (\n          subTypes.find((s) => s.name === stiType) ??\n          fail(`Could not find STI type '${stiType}' in ${subTypes.map((s) => s.name)}`)\n        ).entity;\n      }\n    }\n    // polys -- Look for `entity.parent_task_id` FKs pointing at `Task` and, if configured, rewrite them to point at `TaskOld`\n    for (const poly of entity.polymorphics) {\n      for (const comp of poly.components) {\n        const target = stiEntities.get(comp.otherEntity.name);\n        const base = target?.base.entity.name;\n        // See if the user has pushed `Task.entities` down to a subtype\n        const stiType = base && config.entities[base]?.relations?.[comp.otherFieldName]?.stiType;\n        if (target && stiType) {\n          const { subTypes } = target;\n          comp.otherEntity = (\n            subTypes.find((s) => s.name === stiType) ??\n            fail(`Could not find STI type '${stiType}' in ${subTypes.map((s) => s.name)}`)\n          ).entity;\n        }\n      }\n    }\n    // o2ms -- Look for `entity.tasks` collections loading `task.entity_id`, but entity has been pushed down to `TaskOld`\n    for (const o2m of entity.oneToManys) {\n      const target = stiEntities.get(o2m.otherEntity.name);\n      if (target && target.base.inheritanceType === \"sti\") {\n        // Ensure the incoming FK is not in the base type, and find the 1st subtype (eventually N subtypes?)\n        const otherField = target.subTypes.find(\n          (st) =>\n            !target.base.manyToOnes.some((m) => m.fieldName === o2m.otherFieldName) &&\n            st.manyToOnes.some((m) => m.fieldName === o2m.otherFieldName),\n        );\n        if (otherField) {\n          o2m.otherEntity = otherField.entity;\n        }\n      }\n    }\n    // m2ms -- Look for `entity.tasks` collections loading m2m rows, but `entity` has been pushed down to `TaskOld`\n    for (const m2m of entity.manyToManys) {\n      const target = stiEntities.get(m2m.otherEntity.name);\n      if (target && target.base.inheritanceType === \"sti\") {\n        // Ensure the incoming FK is not in the base type, and find the 1st subtype (eventually N subtypes?)\n        const otherField = target.subTypes.find(\n          (st) =>\n            !target.base.manyToManys.some((m) => m.fieldName === m2m.otherFieldName) &&\n            st.manyToManys.some((m) => m.fieldName === m2m.otherFieldName),\n        );\n        if (otherField) {\n          m2m.otherEntity = otherField.entity;\n        }\n      }\n    }\n  }\n}\n"],"mappings":";;;;;AAYA,SAAgB,wBAAwB,QAAgB,IAAsB;CAC5E,MAAM,EAAE,UAAU,mBAAmB;CACrC,yBAAyB,UAAU,cAAc;CACjD,6BAA6B,QAAQ,gBAAgB,QAAQ;CAC7D,8BAA8B,QAAQ,QAAQ;CAC9C,2BAA2B,QAAQ,QAAQ;CAE3C,yBAAA,0BAA0B,EAAE;AAC9B;;;;;;;;;;;AAYA,SAAS,2BAA2B,QAAgB,UAAoC;CACtF,KAAK,MAAM,UAAU,UACnB,IAAI,OAAO,UAAU;EACnB,MAAM,eAAe,OAAO,SAAS,OAAO;EAC5C,MAAM,aAAa,OAAO,SAAS,OAAO,SAAS;EAEnD,KAAK,MAAM,OAAO,CAAC,GAAG,OAAO,SAAS,YAAY,GAAG,OAAO,SAAS,UAAU,GAAG;GAChF,MAAM,EAAE,YAAY,cAAc,YAAY,IAAI,cAAc,CAAC;GACjE,MAAM,UACJ,cAAc,YAAY,IAAI,UAAU,EAAE,WAC1C,YAAY,YAAY,IAAI,UAAU,EAAE,WAExC,YAAY,YAAY,IAAI,eAAe,EAAE,YAE5C,UAAU,IAAI,YAAY,OAAO,KAAA;GAEpC,IAAI,CAAC,SAAS,CAEd,OAAO,IAAI,YAAY,UAAU,IAAI,SAAS,OAE5C,OAAO,WAAW,KAAK;IAAE,GAAG;IAAK,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;IAAI,aAAaA,yBAAAA,WAAW,OAAO,IAAI;GAAE,CAAC;QACnG,IAAI,YAAY,UAAU,IAAI,SAAS,OAE5C,OAAO,WAAW,KAAK;IAAE,GAAG;IAAK,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;IAAI,aAAaA,yBAAAA,WAAW,OAAO,IAAI;GAAE,CAAC;QACnG,IAAI,IAAI,SAAS,OAEtB,OAAO,WAAW,KAAK;IAAE,GAAG;IAAK,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;IAAI,aAAaA,yBAAAA,WAAW,OAAO;GAAE,CAAC;QAC/F,IAAI,IAAI,SAAS,OAEtB,OAAO,WAAW,KAAK;IAAE,GAAG;IAAK,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;IAAI,aAAaA,yBAAAA,WAAW,OAAO;GAAE,CAAC;EAExG;EAGA,KAAK,MAAM,SAAS,OAAO,UAAU,cAAc,CAAC,GAAG;GAErD,MAAM,EAAE,YAAY,cAAc,SAAS,MAAM,cAAc,CAAC;GAChE,IAAI,SACF,OAAO,WAAW,KAAK;IAAE,GAAG;IAAO;GAAQ,CAAC;EAEhD;CACF;AAEJ;;;;;;;AAQA,SAAS,yBACP,UACA,gBACM;CACN,MAAM,eAAyB,CAAC;CAChC,KAAK,MAAM,UAAU,UACnB,IAAI,OAAO,eAAe;EACxB,aAAa,KAAK,OAAO,aAAa;EACtC,MAAM,OAAO,eAAe,OAAO;EACnC,OAAO,WAAW;EAClB,KAAK,SAAS,KAAK,MAAM;CAC3B;CAEF,KAAK,MAAM,UAAU,UACnB,IAAI,aAAa,SAAS,OAAO,IAAI,GAAG,OAAO,kBAAkB;AAErE;;AAGA,SAAS,6BACP,QACA,gBACA,UACM;CACN,KAAK,MAAM,UAAU,UAAU;EAC7B,MAAM,CAAC,WAAW,YAChB,OAAO,QAAQ,OAAO,SAAS,OAAO,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,gBAAgB,KAAK,CAAC;EACvG,IAAI,aAAa,YAAY,SAAS,kBAAkB;GACtD,OAAO,kBAAkB;GAGzB,MAAM,YACJ,OAAO,MAAM,MAAM,MAAM,EAAE,cAAc,SAAS,KAClDC,cAAAA,KAAK,4BAA4B,OAAO,KAAK,GAAG,UAAU,kDAAkD;GAC9G,OAAO,wBAAwB,UAAU;GAGzC,MAAM,WAAW,OAAO,QAAQ,SAAS,gBAAgB;GAEzD,MAAM,YAAY,CAChB,GAAG,OAAO,QAAQ,OAAO,SAAS,OAAO,KAAK,EAAE,UAAU,CAAC,CAAC,GAC5D,GAAG,OAAO,QAAQ,OAAO,SAAS,OAAO,KAAK,EAAE,aAAa,CAAC,CAAC,CACjE;GAGA,MAAM,iBAAiB,SAAS,KAAK,CAAC,UAAU,IAAI;GACpD,MAAM,iBAAiB,SAAS,KAAK,GAAG,UAAU,IAAI;GACtD,MAAM,YAAY,CAAC,GAAG,gBAAgB,GAAG,cAAc;GACvD,UAAU,QAAQ,CAAC,MAAM,OAAO;IAC9B,IAAI,EAAE,WAAW,CAAC,UAAU,SAAS,EAAE,OAAO,GAC5C,cAAA,KAAK,GAAG,KAAK,YAAY,EAAE,QAAQ,gCAAgC,UAAU,KAAK,IAAI,GAAG;GAE7F,CAAC;GAGD,KAAK,MAAM,CAAC,UAAU,gBAAgB,UAAU;IAE9C,MAAM,gBAAgB,UAAU,QAAQ,GAAG,OAAO,EAAE,YAAY,eAAe,EAAE,YAAY,QAAQ;IACrG,MAAM,oBAAoB,cAAc,KAAK,CAAC,UAAU,IAAI;IAG5D,SAAS,cAAiE,OAAa;KAErF,KADe,cAAc,MAAM,CAAC,UAAU,SAAS,MAAM,SAAS,CAAC,GAAG,GAAA,CAC/D,SAAS,MAAM,UAAU;KACpC,OAAO;IACT;IAGA,MAAM,YAA8B;KAClC,MAAM;KACN,QAAQD,yBAAAA,WAAW,WAAW;KAC9B,WAAW,OAAO;KAClB,YAAY,OAAO;KACnB,YAAY,OAAO,WAAW,QAAQ,MAAM,kBAAkB,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,aAAa;KACtG,OAAO,OAAO,MAAM,QAAQ,MAAM,kBAAkB,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,aAAa;KAC5F,SAAS,OAAO,QAAQ,QAAQ,MAAM,kBAAkB,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,aAAa;KAChG,YAAY,OAAO,WAAW,QAAQ,MAAM,kBAAkB,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,aAAa;KACtG,YAAY,OAAO,WAAW,QAAQ,MAAM,kBAAkB,SAAS,EAAE,SAAS,CAAC;KACnF,iBAAiB,OAAO,gBAAgB,QAAQ,MAAM,kBAAkB,SAAS,EAAE,SAAS,CAAC;KAC7F,WAAW,OAAO,UAAU,QAAQ,MAAM,kBAAkB,SAAS,EAAE,SAAS,CAAC;KACjF,aAAa,OAAO,YAAY,QAAQ,MAAM,kBAAkB,SAAS,EAAE,SAAS,CAAC;KACrF,kBAAkB,OAAO,iBAAiB,QAAQ,MAAM,kBAAkB,SAAS,EAAE,SAAS,CAAC;KAC/F,iBAAiB,OAAO,gBAAgB,QAAQ,MAAM,kBAAkB,SAAS,EAAE,SAAS,CAAC;KAC7F,cAAc,OAAO,aAAa,QAAQ,MAAM,kBAAkB,SAAS,EAAE,SAAS,CAAC;KACvF,SAAS,OAAO;KAChB,WAAW,KAAA;KACX,WAAW,KAAA;KACX,WAAW,KAAA;KACX,eAAe,OAAO;KACtB,UAAU;KACV,UAAU,CAAC;KACX,iBAAiB;KACjB,wBACE,UAAU,SAAS,MAAM,MAAM,EAAE,SAAS,QAAQ,KAClDC,cAAAA,KAAK,yBAAyB,OAAO,KAAK,GAAG,UAAU,GAAG,UAAU,EAAA,CACpE;KACF,UAAU;KACV,oBAAoB,OAAO;KAC3B,IAAI,iBAAoE;MACtE,OAAO,CACL,GAAG,KAAK,WAAW,QAAQ,MAAM,CAAC,EAAE,uBAAuB,GAC3D,GAAG,KAAK,aAAa,SAAS,MAAM,EAAE,UAAU,CAAC,CAAC,QAAQ,MAAM,CAAC,EAAE,uBAAuB,CAC5F;KACF;KACA,IAAI,2BAAmD;MACrD,OAAO,KAAK,YAAY,QAAQ,MAAM,CAAC,EAAE,uBAAuB;KAClE;IACF;IAGA,OAAO,aAAa,OAAO,WAAW,QAAQ,MAAM,CAAC,kBAAkB,SAAS,EAAE,SAAS,CAAC;IAC5F,OAAO,QAAQ,OAAO,MAAM,QAAQ,MAAM,CAAC,kBAAkB,SAAS,EAAE,SAAS,CAAC;IAClF,OAAO,UAAU,OAAO,QAAQ,QAAQ,MAAM,CAAC,kBAAkB,SAAS,EAAE,SAAS,CAAC;IACtF,OAAO,aAAa,OAAO,WAAW,QAAQ,MAAM,CAAC,kBAAkB,SAAS,EAAE,SAAS,CAAC;IAC5F,OAAO,aAAa,OAAO,WAAW,QAAQ,MAAM,CAAC,kBAAkB,SAAS,EAAE,SAAS,CAAC;IAC5F,OAAO,kBAAkB,OAAO,gBAAgB,QAAQ,MAAM,CAAC,kBAAkB,SAAS,EAAE,SAAS,CAAC;IACtG,OAAO,YAAY,OAAO,UAAU,QAAQ,MAAM,CAAC,kBAAkB,SAAS,EAAE,SAAS,CAAC;IAC1F,OAAO,cAAc,OAAO,YAAY,QAAQ,MAAM,CAAC,kBAAkB,SAAS,EAAE,SAAS,CAAC;IAC9F,OAAO,mBAAmB,OAAO,iBAAiB,QAAQ,MAAM,CAAC,kBAAkB,SAAS,EAAE,SAAS,CAAC;IACxG,OAAO,kBAAkB,OAAO,gBAAgB,QAAQ,MAAM,CAAC,kBAAkB,SAAS,EAAE,SAAS,CAAC;IACtG,OAAO,eAAe,OAAO,aAAa,QAAQ,MAAM,CAAC,kBAAkB,SAAS,EAAE,SAAS,CAAC;IAChG,OAAO,SAAS,KAAK,SAAS;IAE9B,SAAS,KAAK,SAAS;IACvB,eAAe,UAAU,QAAQ;GACnC;EACF;CACF;AACF;AAGA,IAAI;AAEJ,SAAgB,eAAe,UAA4C;CACzE,IAAI,aAAa,OAAO;CACxB,8BAAc,IAAI,IAAI;CACtB,KAAK,MAAM,UAAU,UACnB,IAAI,OAAO,oBAAoB,SAAS,OAAO,uBAAuB;EACpE,MAAM,OAAO;EACb,MAAM,WAAW,SAAS,QAAQ,MAAM,EAAE,kBAAkB,OAAO,QAAQ,MAAM,MAAM;EACvF,YAAY,IAAI,OAAO,MAAM;GAAE;GAAM;EAAS,CAAC;EAE/C,KAAK,MAAM,WAAW,UACpB,YAAY,IAAI,QAAQ,MAAM;GAAE;GAAM,UAAU,CAAC;EAAE,CAAC;CAExD;CAEF,OAAO;AACT;;AAGA,SAAS,8BAA8B,QAAgB,UAAoC;CAEzF,MAAM,cAAc,eAAe,QAAQ;CAC3C,IAAI,YAAY,SAAS,GAAG;CAE5B,KAAK,MAAM,UAAU,UAAU;EAE7B,KAAK,MAAM,OAAO,OAAO,YAAY;GACnC,MAAM,SAAS,YAAY,IAAI,IAAI,YAAY,IAAI;GACnD,MAAM,OAAO,QAAQ,KAAK,OAAO;GAEjC,MAAM,UAAU,QAAQ,OAAO,SAAS,KAAK,EAAE,YAAY,IAAI,eAAe,EAAE;GAChF,IAAI,UAAU,SAAS;IACrB,MAAM,EAAE,aAAa;IACrB,IAAI,eACF,SAAS,MAAM,MAAM,EAAE,SAAS,OAAO,KACvCA,cAAAA,KAAK,4BAA4B,QAAQ,OAAO,SAAS,KAAK,MAAM,EAAE,IAAI,GAAG,EAAA,CAC7E;GACJ;EACF;EAEA,KAAK,MAAM,QAAQ,OAAO,cACxB,KAAK,MAAM,QAAQ,KAAK,YAAY;GAClC,MAAM,SAAS,YAAY,IAAI,KAAK,YAAY,IAAI;GACpD,MAAM,OAAO,QAAQ,KAAK,OAAO;GAEjC,MAAM,UAAU,QAAQ,OAAO,SAAS,KAAK,EAAE,YAAY,KAAK,eAAe,EAAE;GACjF,IAAI,UAAU,SAAS;IACrB,MAAM,EAAE,aAAa;IACrB,KAAK,eACH,SAAS,MAAM,MAAM,EAAE,SAAS,OAAO,KACvCA,cAAAA,KAAK,4BAA4B,QAAQ,OAAO,SAAS,KAAK,MAAM,EAAE,IAAI,GAAG,EAAA,CAC7E;GACJ;EACF;EAGF,KAAK,MAAM,OAAO,OAAO,YAAY;GACnC,MAAM,SAAS,YAAY,IAAI,IAAI,YAAY,IAAI;GACnD,IAAI,UAAU,OAAO,KAAK,oBAAoB,OAAO;IAEnD,MAAM,aAAa,OAAO,SAAS,MAChC,OACC,CAAC,OAAO,KAAK,WAAW,MAAM,MAAM,EAAE,cAAc,IAAI,cAAc,KACtE,GAAG,WAAW,MAAM,MAAM,EAAE,cAAc,IAAI,cAAc,CAChE;IACA,IAAI,YACF,IAAI,cAAc,WAAW;GAEjC;EACF;EAEA,KAAK,MAAM,OAAO,OAAO,aAAa;GACpC,MAAM,SAAS,YAAY,IAAI,IAAI,YAAY,IAAI;GACnD,IAAI,UAAU,OAAO,KAAK,oBAAoB,OAAO;IAEnD,MAAM,aAAa,OAAO,SAAS,MAChC,OACC,CAAC,OAAO,KAAK,YAAY,MAAM,MAAM,EAAE,cAAc,IAAI,cAAc,KACvE,GAAG,YAAY,MAAM,MAAM,EAAE,cAAc,IAAI,cAAc,CACjE;IACA,IAAI,YACF,IAAI,cAAc,WAAW;GAEjC;EACF;CACF;AACF"}

package/build/inheritance.d.cts

@@ -0,0 +1,12 @@
+import { Config } from "./config.cjs";
+import { DbMetadata, EntityDbMetadata } from "./EntityDbMetadata.cjs";
+//#region src/inheritance.d.ts
+declare function applyInheritanceUpdates(config: Config, db: DbMetadata): void;
+type StiEntityMap = Map<string, {
+  base: EntityDbMetadata;
+  subTypes: EntityDbMetadata[];
+}>;
+declare function getStiEntities(entities: EntityDbMetadata[]): StiEntityMap;
+//#endregion
+export { applyInheritanceUpdates, getStiEntities };
+//# sourceMappingURL=inheritance.d.cts.map

package/build/inheritance.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inheritance.d.cts","names":[],"sources":["../src/inheritance.ts"],"mappings":";;;iBAYgB,wBAAwB,QAAQ,QAAQ,IAAI;KAyMvD,eAAe;EAAc,MAAM;EAAkB,UAAU;;iBAGpD,eAAe,UAAU,qBAAqB"}

package/build/inheritance.d.mts

@@ -0,0 +1,12 @@
+import { Config } from "./config.mjs";
+import { DbMetadata, EntityDbMetadata } from "./EntityDbMetadata.mjs";
+//#region src/inheritance.d.ts
+declare function applyInheritanceUpdates(config: Config, db: DbMetadata): void;
+type StiEntityMap = Map<string, {
+  base: EntityDbMetadata;
+  subTypes: EntityDbMetadata[];
+}>;
+declare function getStiEntities(entities: EntityDbMetadata[]): StiEntityMap;
+//#endregion
+export { applyInheritanceUpdates, getStiEntities };
+//# sourceMappingURL=inheritance.d.mts.map

package/build/inheritance.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inheritance.d.mts","names":[],"sources":["../src/inheritance.ts"],"mappings":";;;iBAYgB,wBAAwB,QAAQ,QAAQ,IAAI;KAyMvD,eAAe;EAAc,MAAM;EAAkB,UAAU;;iBAGpD,eAAe,UAAU,qBAAqB"}