joist-core 2.3.0 → 2.4.0-next.2

package/build/relations/PolymorphicReference.cjs

@@ -0,0 +1,210 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_relations_AbstractRelationImpl = require("./AbstractRelationImpl.cjs");
+const require_relations_RelationSymbols = require("./RelationSymbols.cjs");
+const require_relations_ReferenceSymbols = require("./ReferenceSymbols.cjs");
+const require_fields = require("../fields.cjs");
+const require_keys = require("../keys.cjs");
+const require_relations_isCascadeDelete = require("./isCascadeDelete.cjs");
+const require_relations_OneToManyCollection = require("./OneToManyCollection.cjs");
+const require_relations_ManyToOneReference = require("./ManyToOneReference.cjs");
+const require_utils = require("../utils.cjs");
+const require_newEntity = require("../newEntity.cjs");
+const require_configure = require("../configure.cjs");
+const require_EntityMetadata = require("../EntityMetadata.cjs");
+const require_index = require("../index.cjs");
+const require_EntityManager = require("../EntityManager.cjs");
+const require_Entity = require("../Entity.cjs");
+const require_BaseEntity = require("../BaseEntity.cjs");
+//#region src/relations/PolymorphicReference.ts
+function hasOnePolymorphic() {
+	return require_newEntity.lazyField((entity, fieldName) => {
+		return new PolymorphicReferenceImpl(entity, fieldName);
+	});
+}
+/** Type guard utility for determining if an entity field is a PolymorphicReference. */
+function isPolymorphicReference(maybeReference) {
+	return maybeReference instanceof PolymorphicReferenceImpl;
+}
+/**
+* Manages a set of foreign keys from one entity to another, i.e. `Comment.parent --> Book | BookReview`.
+*
+* We keep the current `parent` / `parent.id` value in the `__orm.data` hash, where the
+* current value could be either the `comments.parent_book_id` / `comments.parent_book_review_id` id (as a tagged string)
+* from the database, or an entity `Book` / `BookReview` that the user has set.
+*
+* Note that if any of our columns (eg `comments.parent_book_review_id`) is unique, this `PolymorphicReference` will
+* essentially be half of a one-to-one relationship, but we'll keep using this reference on the "owning" side; the other
+* side, i.e. `BookReview.comment` will use a `OneToOneReference` to point back to us.
+*/
+var PolymorphicReferenceImpl = class extends require_relations_AbstractRelationImpl.AbstractRelationImpl {
+	fieldName;
+	loaded;
+	_isLoaded = false;
+	field;
+	#hasBeenSet = false;
+	constructor(entity, fieldName) {
+		super(entity);
+		this.fieldName = fieldName;
+		this.field = require_EntityMetadata.getMetadata(entity).allFields[this.fieldName];
+		if (require_BaseEntity.getInstanceData(entity).isOrWasNew) this._isLoaded = true;
+	}
+	get currentComponent() {
+		const cstr = require_configure.maybeGetConstructorFromReference(this.current());
+		return this.field.components.find((c) => c.otherMetadata().cstr === cstr);
+	}
+	get isCascadeDelete() {
+		return require_relations_isCascadeDelete.isCascadeDelete(this, this.fieldName);
+	}
+	async load(opts = {}) {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		const current = this.current();
+		if (!this._isLoaded || opts.forceReload) this.loaded = require_Entity.isEntity(current) || current === void 0 ? current : await this.entity.em.load(require_configure.getConstructorFromTaggedId(current), current);
+		this._isLoaded = true;
+		return this.filterDeleted(this.loaded, opts);
+	}
+	set(other) {
+		this.setImpl(other);
+	}
+	get isSet() {
+		return this.current() !== void 0;
+	}
+	get isLoaded() {
+		return this._isLoaded;
+	}
+	/**
+	* Looks for an entity in `EntityManager`, b/c we may have it in memory even if
+	* our reference is not specifically loaded.
+	*/
+	maybeFindEntity() {
+		const { idTaggedMaybe } = this;
+		return this.loaded ?? (idTaggedMaybe !== void 0 ? this.entity.em.getEntity(idTaggedMaybe) : void 0);
+	}
+	get isPreloaded() {
+		return !!this.maybeFindEntity();
+	}
+	preload() {
+		this.loaded = this.maybeFindEntity();
+		this._isLoaded = true;
+	}
+	unload() {
+		this.loaded = void 0;
+		this._isLoaded = false;
+	}
+	import(other, findEntity) {
+		this.loaded = other.loaded ? findEntity(other.loaded) : void 0;
+		this._isLoaded = true;
+	}
+	doGet(opts) {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		if (!this._isLoaded) {
+			const existing = this.maybeFindExisting();
+			if (existing === void 0) throw new Error(`${this.entity}.${this.fieldName} was not loaded`);
+			this.loaded = existing;
+			this._isLoaded = true;
+		}
+		return this.filterDeleted(this.loaded, opts);
+	}
+	get getWithDeleted() {
+		return this.doGet({ withDeleted: true });
+	}
+	get get() {
+		return this.doGet({ withDeleted: false });
+	}
+	get id() {
+		return this.idMaybe || require_relations_ManyToOneReference.failNoId(this.entity, this.fieldName, this.current());
+	}
+	get idMaybe() {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		return require_keys.maybeResolveReferenceToId(this.current());
+	}
+	get idIfSet() {
+		return this.idMaybe || require_relations_ManyToOneReference.failIfNewEntity(this.entity, this.fieldName, this.current());
+	}
+	get idTagged() {
+		return this.idTaggedMaybe || require_relations_ManyToOneReference.failNoId(this.entity, this.fieldName, this.current());
+	}
+	get idTaggedMaybe() {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		return require_keys.maybeResolveReferenceToId(this.current());
+	}
+	get hasBeenSet() {
+		return this.#hasBeenSet;
+	}
+	setFromOpts(other) {
+		this.setImpl(other);
+	}
+	maybeCascadeDelete() {
+		if (this.isCascadeDelete) {
+			const current = this.current({ withDeleted: true });
+			if (current !== void 0 && typeof current !== "string") this.entity.em.delete(current);
+		}
+	}
+	async cleanupOnEntityDeleted() {
+		if (this.isCascadeDelete) return;
+		const current = await this.load({ withDeleted: true });
+		if (current !== void 0) {
+			const o2m = this.getOtherRelation(current);
+			if (o2m instanceof require_relations_OneToManyCollection.OneToManyCollection) o2m.remove(this.entity, { requireLoaded: false });
+			else o2m.set(void 0);
+		}
+		require_fields.setField(this.entity, this.fieldName, void 0);
+		this.loaded = void 0;
+		this._isLoaded = true;
+	}
+	setImpl(other) {
+		this.#hasBeenSet = true;
+		if (require_EntityManager.sameEntity(other, this.current({ withDeleted: true }))) return;
+		if (other !== void 0 && !this.field.components.some((c) => other instanceof c.otherMetadata().cstr || typeof other === "string" && require_configure.getConstructorFromTaggedId(other) === c.otherMetadata().cstr)) require_utils.fail(`${other} cannot be set as '${this.field.fieldName}' on ${this.entity}`);
+		const previousLoaded = this.loaded ?? this.maybeFindExisting();
+		require_index.ensureNotDeleted(this.entity, "pending");
+		if (require_Entity.isEntity(other)) {
+			const otherMeta = require_EntityMetadata.getMetadata(other);
+			const hasComponentsWithSameBaseType = otherMeta.baseType && this.field.components.some((component) => component.otherMetadata().baseType === otherMeta.baseType && !(other instanceof component.otherMetadata().cstr));
+			require_fields.setField(this.entity, this.fieldName, other.isNewEntity || hasComponentsWithSameBaseType ? other : other.idTagged);
+		} else require_fields.setField(this.entity, this.fieldName, other);
+		if (typeof other === "string") {
+			this.loaded = void 0;
+			this._isLoaded = false;
+		} else {
+			this.loaded = other;
+			this._isLoaded = true;
+		}
+		if (previousLoaded) {
+			const prevRelation = this.getOtherRelation(previousLoaded);
+			if (prevRelation instanceof require_relations_OneToManyCollection.OneToManyCollection) prevRelation.removeIfLoaded(this.entity);
+			else prevRelation.set(void 0);
+		}
+		if (other !== void 0 && require_Entity.isEntity(other)) {
+			const newRelation = this.getOtherRelation(other);
+			if (newRelation instanceof require_relations_OneToManyCollection.OneToManyCollection) newRelation.add(this.entity);
+			else newRelation.set(this.entity);
+		}
+	}
+	current(opts) {
+		const current = require_fields.getField(this.entity, this.fieldName);
+		if (current !== void 0 && require_Entity.isEntity(current)) return this.filterDeleted(current, opts);
+		return current;
+	}
+	toString() {
+		return `PolymorphicReference(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.currentComponent?.otherMetadata().type}, otherFieldName: ${this.currentComponent?.otherFieldName}, id: ${this.id})`;
+	}
+	filterDeleted(entity, opts) {
+		return opts?.withDeleted === true || entity === void 0 || !entity.isDeletedEntity ? entity : void 0;
+	}
+	/** Returns the other relation that points back at us, i.e. we're `comment.parent_book_id` and this is `Book.comments`. */
+	getOtherRelation(other) {
+		return other[this.field.components.find((c) => other instanceof c.otherMetadata().cstr)?.otherFieldName];
+	}
+	maybeFindExisting() {
+		return this.idTaggedMaybe !== void 0 ? this.entity.em.getEntity(this.idTagged) : void 0;
+	}
+	[require_relations_RelationSymbols.RelationT] = null;
+	[require_relations_RelationSymbols.RelationU] = null;
+	[require_relations_ReferenceSymbols.ReferenceN] = null;
+};
+//#endregion
+exports.PolymorphicReferenceImpl = PolymorphicReferenceImpl;
+exports.hasOnePolymorphic = hasOnePolymorphic;
+exports.isPolymorphicReference = isPolymorphicReference;
+
+//# sourceMappingURL=PolymorphicReference.cjs.map

package/build/relations/PolymorphicReference.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolymorphicReference.cjs","names":["lazyField","AbstractRelationImpl","getMetadata","getInstanceData","maybeGetConstructorFromReference","isCascadeDelete","isEntity","getConstructorFromTaggedId","failNoId","maybeResolveReferenceToId","failIfNewEntity","#hasBeenSet","OneToManyCollection","sameEntity","getField","RelationT","RelationU","ReferenceN"],"sources":["../../src/relations/PolymorphicReference.ts"],"sourcesContent":["import { maybeGetConstructorFromReference } from \"src/configure.ts\";\nimport { type Entity, isEntity } from \"src/Entity.ts\";\nimport { type IdOf, type TaggedId, sameEntity } from \"src/EntityManager.ts\";\nimport { type PolymorphicFieldComponent, getMetadata } from \"src/EntityMetadata.ts\";\nimport { getField, setField } from \"src/fields.ts\";\nimport {\n  type OneToOneReference,\n  type PolymorphicField,\n  type Reference,\n  ensureNotDeleted,\n  fail,\n  getConstructorFromTaggedId,\n  getInstanceData,\n  maybeResolveReferenceToId,\n} from \"src/index.ts\";\nimport { lazyField } from \"src/newEntity.ts\";\nimport { AbstractRelationImpl } from \"src/relations/AbstractRelationImpl.ts\";\nimport { isCascadeDelete } from \"src/relations/isCascadeDelete.ts\";\nimport { failIfNewEntity, failNoId } from \"src/relations/ManyToOneReference.ts\";\nimport { OneToManyCollection } from \"src/relations/OneToManyCollection.ts\";\nimport { ReferenceN } from \"src/relations/ReferenceSymbols.ts\";\nimport { RelationT, RelationU } from \"src/relations/RelationSymbols.ts\";\n\nexport function hasOnePolymorphic<\n  T extends Entity,\n  U extends Entity,\n  N extends never | undefined,\n>(): PolymorphicReference<T, U, N> {\n  return lazyField((entity: T, fieldName) => {\n    return new PolymorphicReferenceImpl<T, U, N>(entity, fieldName as keyof T & string);\n  });\n}\n\n/** Type guard utility for determining if an entity field is a PolymorphicReference. */\nexport function isPolymorphicReference(maybeReference: any): maybeReference is PolymorphicReference<any, any, any> {\n  return maybeReference instanceof PolymorphicReferenceImpl;\n}\n\n/**\n * A reference that can be assigned to multiple different entity types.\n *\n * I.e. a `Comment.parent` reference that can be an `Author` or `Book`.\n *\n * The `U` generic will be the type union of `Author | Book`.\n */\nexport interface PolymorphicReference<\n  T extends Entity,\n  U extends Entity,\n  N extends never | undefined,\n> extends Reference<T, U, N> {\n  /** Returns the id of the current assigned entity, or a runtime error if either 1) unset or 2) set to a new entity that doesn't have an `id` yet. */\n  id: IdOf<U>;\n\n  /** Returns the id of the current assigned entity, undefined if unset, or a runtime error if set to a new entity. */\n  idIfSet: IdOf<U> | undefined;\n\n  /** Returns the id of the current assigned entity, undefined if unset, or undefined if set to a new entity. */\n  idMaybe: IdOf<U> | undefined;\n\n  idTagged: string;\n\n  /** Returns `true` if this relation is currently set (i.e. regardless of whether it's loaded, or if it is set but the assigned entity doesn't have an id saved. */\n  readonly isSet: boolean;\n}\n\n/**\n * Manages a set of foreign keys from one entity to another, i.e. `Comment.parent --> Book | BookReview`.\n *\n * We keep the current `parent` / `parent.id` value in the `__orm.data` hash, where the\n * current value could be either the `comments.parent_book_id` / `comments.parent_book_review_id` id (as a tagged string)\n * from the database, or an entity `Book` / `BookReview` that the user has set.\n *\n * Note that if any of our columns (eg `comments.parent_book_review_id`) is unique, this `PolymorphicReference` will\n * essentially be half of a one-to-one relationship, but we'll keep using this reference on the \"owning\" side; the other\n * side, i.e. `BookReview.comment` will use a `OneToOneReference` to point back to us.\n */\nexport class PolymorphicReferenceImpl<T extends Entity, U extends Entity, N extends never | undefined>\n  extends AbstractRelationImpl<T, U>\n  implements PolymorphicReference<T, U, N>\n{\n  private loaded: U | N | undefined;\n  // We need a separate boolean to b/c loaded == undefined can still mean \"_isLoaded\" for nullable fks.\n  private _isLoaded = false;\n  private field: PolymorphicField;\n  #hasBeenSet = false;\n\n  constructor(\n    entity: T,\n    public fieldName: keyof T & string,\n  ) {\n    super(entity);\n    this.field = getMetadata(entity).allFields[this.fieldName] as PolymorphicField;\n    if (getInstanceData(entity).isOrWasNew) {\n      this._isLoaded = true;\n    }\n  }\n\n  private get currentComponent(): PolymorphicFieldComponent | N {\n    const cstr = maybeGetConstructorFromReference(this.current());\n    return this.field.components.find((c) => c.otherMetadata().cstr === cstr) as any;\n  }\n\n  private get isCascadeDelete(): boolean {\n    return isCascadeDelete(this, this.fieldName);\n  }\n\n  async load(opts: { withDeleted?: boolean; forceReload?: boolean } = {}): Promise<U | N> {\n    ensureNotDeleted(this.entity, \"pending\");\n    const current = this.current();\n    // Resolve the id to an entity\n    if (!this._isLoaded || opts.forceReload) {\n      this.loaded =\n        isEntity(current) || current === undefined\n          ? (current as U | undefined)\n          : ((await this.entity.em.load(getConstructorFromTaggedId(current), current)) as U);\n    }\n    this._isLoaded = true;\n    return this.filterDeleted(this.loaded!, opts);\n  }\n\n  set(other: U | N): void {\n    this.setImpl(other);\n  }\n\n  get isSet(): boolean {\n    return this.current() !== undefined;\n  }\n\n  get isLoaded(): boolean {\n    return this._isLoaded;\n  }\n\n  /**\n   * Looks for an entity in `EntityManager`, b/c we may have it in memory even if\n   * our reference is not specifically loaded.\n   */\n  maybeFindEntity(): U | undefined {\n    // Check this.loaded first b/c a new entity won't have an id yet\n    const { idTaggedMaybe } = this;\n    return this.loaded ?? (idTaggedMaybe !== undefined ? (this.entity.em.getEntity(idTaggedMaybe) as U) : undefined);\n  }\n\n  get isPreloaded(): boolean {\n    return !!this.maybeFindEntity();\n  }\n\n  preload(): void {\n    this.loaded = this.maybeFindEntity();\n    this._isLoaded = true;\n  }\n\n  private unload(): void {\n    this.loaded = undefined;\n    this._isLoaded = false;\n  }\n\n  import(other: PolymorphicReferenceImpl<T, U, N>, findEntity: (e: U) => U): void {\n    this.loaded = other.loaded ? findEntity(other.loaded) : undefined;\n    this._isLoaded = true;\n  }\n\n  private doGet(opts?: { withDeleted?: boolean }): U | N {\n    ensureNotDeleted(this.entity, \"pending\");\n    // This should only be callable in the type system if we've already resolved this to an instance,\n    // but, just in case we somehow got here in an unloaded state, check to see if we're already in the UoW\n    if (!this._isLoaded) {\n      const existing = this.maybeFindExisting();\n      if (existing === undefined) {\n        throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n      }\n      this.loaded = existing;\n      this._isLoaded = true;\n    }\n\n    return this.filterDeleted(this.loaded!, opts);\n  }\n\n  get getWithDeleted(): U | N {\n    return this.doGet({ withDeleted: true });\n  }\n\n  get get(): U | N {\n    return this.doGet({ withDeleted: false });\n  }\n\n  get id(): IdOf<U> {\n    return this.idMaybe || failNoId(this.entity, this.fieldName, this.current());\n  }\n\n  get idMaybe(): IdOf<U> | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    return maybeResolveReferenceToId(this.current()) as IdOf<U> | undefined;\n  }\n\n  get idIfSet(): IdOf<U> | N | undefined {\n    return this.idMaybe || failIfNewEntity(this.entity, this.fieldName, this.current());\n  }\n\n  get idTagged(): string {\n    return this.idTaggedMaybe || failNoId(this.entity, this.fieldName, this.current());\n  }\n\n  get idTaggedMaybe(): string | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    return maybeResolveReferenceToId(this.current());\n  }\n\n  get hasBeenSet() {\n    return this.#hasBeenSet;\n  }\n\n  // private impl\n\n  setFromOpts(other: U): void {\n    this.setImpl(other);\n  }\n\n  maybeCascadeDelete(): void {\n    if (this.isCascadeDelete) {\n      const current = this.current({ withDeleted: true });\n      if (current !== undefined && typeof current !== \"string\") {\n        this.entity.em.delete(current as U);\n      }\n    }\n  }\n\n  async cleanupOnEntityDeleted(): Promise<void> {\n    // if we are going to delete this relation as well, then we don't need to clean it up\n    if (this.isCascadeDelete) return;\n    const current = await this.load({ withDeleted: true });\n    if (current !== undefined) {\n      const o2m = this.getOtherRelation(current);\n      if (o2m instanceof OneToManyCollection) {\n        o2m.remove(this.entity, { requireLoaded: false });\n      } else {\n        o2m.set(undefined as any);\n      }\n    }\n    setField(this.entity, this.fieldName, undefined);\n    this.loaded = undefined as any;\n    this._isLoaded = true;\n  }\n\n  // Internal method used by PolymorphicReference\n  setImpl(other: U | N): void {\n    this.#hasBeenSet = true;\n\n    if (sameEntity(other, this.current({ withDeleted: true }))) {\n      return;\n    }\n\n    if (\n      other !== undefined &&\n      !this.field.components.some(\n        (c) =>\n          other instanceof c.otherMetadata().cstr ||\n          (typeof other === \"string\" && getConstructorFromTaggedId(other) === c.otherMetadata().cstr),\n      )\n    ) {\n      fail(`${other} cannot be set as '${this.field.fieldName}' on ${this.entity}`);\n    }\n\n    // we may not be loaded yet, but our previous entity might already be in the UoW\n    const previousLoaded = this.loaded ?? this.maybeFindExisting();\n\n    ensureNotDeleted(this.entity, \"pending\");\n\n    // Keep the entity when its tagged id cannot distinguish between sibling subtypes.\n    if (isEntity(other)) {\n      const otherMeta = getMetadata(other);\n      const hasComponentsWithSameBaseType =\n        otherMeta.baseType &&\n        this.field.components.some(\n          (component) =>\n            component.otherMetadata().baseType === otherMeta.baseType &&\n            !(other instanceof component.otherMetadata().cstr),\n        );\n      setField(\n        this.entity,\n        this.fieldName,\n        other.isNewEntity || hasComponentsWithSameBaseType ? other : other.idTagged,\n      );\n    } else {\n      setField(this.entity, this.fieldName, other);\n    }\n\n    if (typeof other === \"string\") {\n      this.loaded = undefined;\n      this._isLoaded = false;\n    } else {\n      this.loaded = other;\n      this._isLoaded = true;\n    }\n\n    // If had an existing value, remove us from its collection\n    if (previousLoaded) {\n      const prevRelation = this.getOtherRelation(previousLoaded);\n      if (prevRelation instanceof OneToManyCollection) {\n        prevRelation.removeIfLoaded(this.entity);\n      } else {\n        prevRelation.set(undefined as any);\n      }\n    }\n    if (other !== undefined && isEntity(other)) {\n      const newRelation = this.getOtherRelation(other);\n      if (newRelation instanceof OneToManyCollection) {\n        newRelation.add(this.entity);\n      } else {\n        newRelation.set(this.entity);\n      }\n    }\n  }\n\n  // We need to keep U in data[fieldName] to handle entities without an id assigned yet.\n  current(opts?: { withDeleted?: boolean }): U | TaggedId | N {\n    const current = getField(this.entity, this.fieldName);\n    if (current !== undefined && isEntity(current)) {\n      return this.filterDeleted(current as U, opts);\n    }\n    return current;\n  }\n\n  public toString(): string {\n    return `PolymorphicReference(entity: ${this.entity}, fieldName: ${\n      this.fieldName\n    }, otherType: ${this.currentComponent?.otherMetadata().type}, otherFieldName: ${\n      this.currentComponent?.otherFieldName\n    }, id: ${this.id})`;\n  }\n\n  private filterDeleted(entity: U | N, opts?: { withDeleted?: boolean }): U | N {\n    return opts?.withDeleted === true || entity === undefined || !entity.isDeletedEntity ? entity : (undefined as N);\n  }\n\n  /** Returns the other relation that points back at us, i.e. we're `comment.parent_book_id` and this is `Book.comments`. */\n  private getOtherRelation(other: U): OneToManyCollection<U, T> | OneToOneReference<U, T> {\n    const component = this.field.components.find((c) => other instanceof c.otherMetadata().cstr) as any;\n    return (other as U)[component?.otherFieldName as keyof U] as any;\n  }\n\n  private maybeFindExisting(): U | undefined {\n    return this.idTaggedMaybe !== undefined ? (this.entity.em.getEntity(this.idTagged) as U) : undefined;\n  }\n\n  [RelationT]: T = null!;\n  [RelationU]: U = null!;\n  [ReferenceN]: N = null!;\n}\n"],"mappings":"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"}

package/build/relations/PolymorphicReference.d.cts

@@ -0,0 +1,93 @@
+import { AbstractRelationImpl } from "./AbstractRelationImpl.cjs";
+import { RelationT, RelationU } from "./RelationSymbols.cjs";
+import { ReferenceN } from "./ReferenceSymbols.cjs";
+import { Reference } from "./Reference.cjs";
+import "../index.cjs";
+import { IdOf, TaggedId } from "../EntityManager.cjs";
+import { Entity } from "../Entity.cjs";
+//#region src/relations/PolymorphicReference.d.ts
+declare function hasOnePolymorphic<T extends Entity, U extends Entity, N extends never | undefined>(): PolymorphicReference<T, U, N>;
+/** Type guard utility for determining if an entity field is a PolymorphicReference. */
+declare function isPolymorphicReference(maybeReference: any): maybeReference is PolymorphicReference<any, any, any>;
+/**
+ * A reference that can be assigned to multiple different entity types.
+ *
+ * I.e. a `Comment.parent` reference that can be an `Author` or `Book`.
+ *
+ * The `U` generic will be the type union of `Author | Book`.
+ */
+interface PolymorphicReference<T extends Entity, U extends Entity, N extends never | undefined> extends Reference<T, U, N> {
+  /** Returns the id of the current assigned entity, or a runtime error if either 1) unset or 2) set to a new entity that doesn't have an `id` yet. */
+  id: IdOf<U>;
+  /** Returns the id of the current assigned entity, undefined if unset, or a runtime error if set to a new entity. */
+  idIfSet: IdOf<U> | undefined;
+  /** Returns the id of the current assigned entity, undefined if unset, or undefined if set to a new entity. */
+  idMaybe: IdOf<U> | undefined;
+  idTagged: string;
+  /** Returns `true` if this relation is currently set (i.e. regardless of whether it's loaded, or if it is set but the assigned entity doesn't have an id saved. */
+  readonly isSet: boolean;
+}
+/**
+ * Manages a set of foreign keys from one entity to another, i.e. `Comment.parent --> Book | BookReview`.
+ *
+ * We keep the current `parent` / `parent.id` value in the `__orm.data` hash, where the
+ * current value could be either the `comments.parent_book_id` / `comments.parent_book_review_id` id (as a tagged string)
+ * from the database, or an entity `Book` / `BookReview` that the user has set.
+ *
+ * Note that if any of our columns (eg `comments.parent_book_review_id`) is unique, this `PolymorphicReference` will
+ * essentially be half of a one-to-one relationship, but we'll keep using this reference on the "owning" side; the other
+ * side, i.e. `BookReview.comment` will use a `OneToOneReference` to point back to us.
+ */
+declare class PolymorphicReferenceImpl<T extends Entity, U extends Entity, N extends never | undefined> extends AbstractRelationImpl<T, U> implements PolymorphicReference<T, U, N> {
+  #private;
+  fieldName: keyof T & string;
+  private loaded;
+  private _isLoaded;
+  private field;
+  constructor(entity: T, fieldName: keyof T & string);
+  private get currentComponent();
+  private get isCascadeDelete();
+  load(opts?: {
+    withDeleted?: boolean;
+    forceReload?: boolean;
+  }): Promise<U | N>;
+  set(other: U | N): void;
+  get isSet(): boolean;
+  get isLoaded(): boolean;
+  /**
+   * Looks for an entity in `EntityManager`, b/c we may have it in memory even if
+   * our reference is not specifically loaded.
+   */
+  maybeFindEntity(): U | undefined;
+  get isPreloaded(): boolean;
+  preload(): void;
+  private unload;
+  import(other: PolymorphicReferenceImpl<T, U, N>, findEntity: (e: U) => U): void;
+  private doGet;
+  get getWithDeleted(): U | N;
+  get get(): U | N;
+  get id(): IdOf<U>;
+  get idMaybe(): IdOf<U> | undefined;
+  get idIfSet(): IdOf<U> | N | undefined;
+  get idTagged(): string;
+  get idTaggedMaybe(): string | undefined;
+  get hasBeenSet(): boolean;
+  setFromOpts(other: U): void;
+  maybeCascadeDelete(): void;
+  cleanupOnEntityDeleted(): Promise<void>;
+  setImpl(other: U | N): void;
+  current(opts?: {
+    withDeleted?: boolean;
+  }): U | TaggedId | N;
+  toString(): string;
+  private filterDeleted;
+  /** Returns the other relation that points back at us, i.e. we're `comment.parent_book_id` and this is `Book.comments`. */
+  private getOtherRelation;
+  private maybeFindExisting;
+  [RelationT]: T;
+  [RelationU]: U;
+  [ReferenceN]: N;
+}
+//#endregion
+export { PolymorphicReference, PolymorphicReferenceImpl, hasOnePolymorphic, isPolymorphicReference };
+//# sourceMappingURL=PolymorphicReference.d.cts.map

package/build/relations/PolymorphicReference.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolymorphicReference.d.cts","names":[],"sources":["../../src/relations/PolymorphicReference.ts"],"mappings":";;;;;;;;iBAuBgB,kBACd,UAAU,QACV,UAAU,QACV,gCACG,qBAAqB,GAAG,GAAG;;iBAOhB,uBAAuB,sBAAsB,kBAAkB;;;;;;;;UAW9D,qBACf,UAAU,QACV,UAAU,QACV,qCACQ,UAAU,GAAG,GAAG;;EAExB,IAAI,KAAK;;EAGT,SAAS,KAAK;;EAGd,SAAS,KAAK;EAEd;;WAGS;;;;;;;;;;;;;cAcE,yBAAyB,UAAU,QAAQ,UAAU,QAAQ,qCAChE,qBAAqB,GAAG,cACrB,qBAAqB,GAAG,GAAG;;EAU7B,iBAAiB;UARlB;UAEA;UACA;EAGR,YACE,QAAQ,GACD,iBAAiB;cASd;cAKA;EAIN,KAAK;IAAQ;IAAuB;MAA+B,QAAQ,IAAI;EAcrF,IAAI,OAAO,IAAI;MAIX;MAIA;;;;;EAQJ,mBAAmB;MAMf;EAIJ;UAKQ;EAKR,OAAO,OAAO,yBAAyB,GAAG,GAAG,IAAI,aAAa,GAAG,MAAM;UAK/D;MAgBJ,kBAAkB,IAAI;MAItB,OAAO,IAAI;MAIX,MAAM,KAAK;MAIX,WAAW,KAAK;MAKhB,WAAW,KAAK,KAAK;MAIrB;MAIA;MAKA;EAMJ,YAAY,OAAO;EAInB;EASM,0BAA0B;EAkBhC,QAAQ,OAAO,IAAI;EAsEnB,QAAQ;IAAS;MAA0B,IAAI,WAAW;EAQnD;UAQC;;UAKA;UAKA;GAIP,YAAY;GACZ,YAAY;GACZ,aAAa"}

package/build/relations/PolymorphicReference.d.mts

@@ -0,0 +1,93 @@
+import { AbstractRelationImpl } from "./AbstractRelationImpl.mjs";
+import { RelationT, RelationU } from "./RelationSymbols.mjs";
+import { ReferenceN } from "./ReferenceSymbols.mjs";
+import { Reference } from "./Reference.mjs";
+import "../index.mjs";
+import { IdOf, TaggedId } from "../EntityManager.mjs";
+import { Entity } from "../Entity.mjs";
+//#region src/relations/PolymorphicReference.d.ts
+declare function hasOnePolymorphic<T extends Entity, U extends Entity, N extends never | undefined>(): PolymorphicReference<T, U, N>;
+/** Type guard utility for determining if an entity field is a PolymorphicReference. */
+declare function isPolymorphicReference(maybeReference: any): maybeReference is PolymorphicReference<any, any, any>;
+/**
+ * A reference that can be assigned to multiple different entity types.
+ *
+ * I.e. a `Comment.parent` reference that can be an `Author` or `Book`.
+ *
+ * The `U` generic will be the type union of `Author | Book`.
+ */
+interface PolymorphicReference<T extends Entity, U extends Entity, N extends never | undefined> extends Reference<T, U, N> {
+  /** Returns the id of the current assigned entity, or a runtime error if either 1) unset or 2) set to a new entity that doesn't have an `id` yet. */
+  id: IdOf<U>;
+  /** Returns the id of the current assigned entity, undefined if unset, or a runtime error if set to a new entity. */
+  idIfSet: IdOf<U> | undefined;
+  /** Returns the id of the current assigned entity, undefined if unset, or undefined if set to a new entity. */
+  idMaybe: IdOf<U> | undefined;
+  idTagged: string;
+  /** Returns `true` if this relation is currently set (i.e. regardless of whether it's loaded, or if it is set but the assigned entity doesn't have an id saved. */
+  readonly isSet: boolean;
+}
+/**
+ * Manages a set of foreign keys from one entity to another, i.e. `Comment.parent --> Book | BookReview`.
+ *
+ * We keep the current `parent` / `parent.id` value in the `__orm.data` hash, where the
+ * current value could be either the `comments.parent_book_id` / `comments.parent_book_review_id` id (as a tagged string)
+ * from the database, or an entity `Book` / `BookReview` that the user has set.
+ *
+ * Note that if any of our columns (eg `comments.parent_book_review_id`) is unique, this `PolymorphicReference` will
+ * essentially be half of a one-to-one relationship, but we'll keep using this reference on the "owning" side; the other
+ * side, i.e. `BookReview.comment` will use a `OneToOneReference` to point back to us.
+ */
+declare class PolymorphicReferenceImpl<T extends Entity, U extends Entity, N extends never | undefined> extends AbstractRelationImpl<T, U> implements PolymorphicReference<T, U, N> {
+  #private;
+  fieldName: keyof T & string;
+  private loaded;
+  private _isLoaded;
+  private field;
+  constructor(entity: T, fieldName: keyof T & string);
+  private get currentComponent();
+  private get isCascadeDelete();
+  load(opts?: {
+    withDeleted?: boolean;
+    forceReload?: boolean;
+  }): Promise<U | N>;
+  set(other: U | N): void;
+  get isSet(): boolean;
+  get isLoaded(): boolean;
+  /**
+   * Looks for an entity in `EntityManager`, b/c we may have it in memory even if
+   * our reference is not specifically loaded.
+   */
+  maybeFindEntity(): U | undefined;
+  get isPreloaded(): boolean;
+  preload(): void;
+  private unload;
+  import(other: PolymorphicReferenceImpl<T, U, N>, findEntity: (e: U) => U): void;
+  private doGet;
+  get getWithDeleted(): U | N;
+  get get(): U | N;
+  get id(): IdOf<U>;
+  get idMaybe(): IdOf<U> | undefined;
+  get idIfSet(): IdOf<U> | N | undefined;
+  get idTagged(): string;
+  get idTaggedMaybe(): string | undefined;
+  get hasBeenSet(): boolean;
+  setFromOpts(other: U): void;
+  maybeCascadeDelete(): void;
+  cleanupOnEntityDeleted(): Promise<void>;
+  setImpl(other: U | N): void;
+  current(opts?: {
+    withDeleted?: boolean;
+  }): U | TaggedId | N;
+  toString(): string;
+  private filterDeleted;
+  /** Returns the other relation that points back at us, i.e. we're `comment.parent_book_id` and this is `Book.comments`. */
+  private getOtherRelation;
+  private maybeFindExisting;
+  [RelationT]: T;
+  [RelationU]: U;
+  [ReferenceN]: N;
+}
+//#endregion
+export { PolymorphicReference, PolymorphicReferenceImpl, hasOnePolymorphic, isPolymorphicReference };
+//# sourceMappingURL=PolymorphicReference.d.mts.map

package/build/relations/PolymorphicReference.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolymorphicReference.d.mts","names":[],"sources":["../../src/relations/PolymorphicReference.ts"],"mappings":";;;;;;;;iBAuBgB,kBACd,UAAU,QACV,UAAU,QACV,gCACG,qBAAqB,GAAG,GAAG;;iBAOhB,uBAAuB,sBAAsB,kBAAkB;;;;;;;;UAW9D,qBACf,UAAU,QACV,UAAU,QACV,qCACQ,UAAU,GAAG,GAAG;;EAExB,IAAI,KAAK;;EAGT,SAAS,KAAK;;EAGd,SAAS,KAAK;EAEd;;WAGS;;;;;;;;;;;;;cAcE,yBAAyB,UAAU,QAAQ,UAAU,QAAQ,qCAChE,qBAAqB,GAAG,cACrB,qBAAqB,GAAG,GAAG;;EAU7B,iBAAiB;UARlB;UAEA;UACA;EAGR,YACE,QAAQ,GACD,iBAAiB;cASd;cAKA;EAIN,KAAK;IAAQ;IAAuB;MAA+B,QAAQ,IAAI;EAcrF,IAAI,OAAO,IAAI;MAIX;MAIA;;;;;EAQJ,mBAAmB;MAMf;EAIJ;UAKQ;EAKR,OAAO,OAAO,yBAAyB,GAAG,GAAG,IAAI,aAAa,GAAG,MAAM;UAK/D;MAgBJ,kBAAkB,IAAI;MAItB,OAAO,IAAI;MAIX,MAAM,KAAK;MAIX,WAAW,KAAK;MAKhB,WAAW,KAAK,KAAK;MAIrB;MAIA;MAKA;EAMJ,YAAY,OAAO;EAInB;EASM,0BAA0B;EAkBhC,QAAQ,OAAO,IAAI;EAsEnB,QAAQ;IAAS;MAA0B,IAAI,WAAW;EAQnD;UAQC;;UAKA;UAKA;GAIP,YAAY;GACZ,YAAY;GACZ,aAAa"}