joist-core 2.4.0-next.37 → 2.4.0-next.39

package/build/relations/OneToOneReference.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"OneToOneReference.cjs","names":["lazyField","getMetadata","AbstractRelationImpl","#field","getInstanceData","failNoId","failIfNewEntity","deTagId","oneToOneBatchLoader","appendStack","#hasBeenSet","getEmInternalApi","isReactiveReference","isCascadeDelete","RelationT","RelationU","ReferenceN"],"sources":["../../src/relations/OneToOneReference.ts"],"sourcesContent":["import { oneToOneBatchLoader } from \"src/batchloaders/oneToOneBatchLoader.ts\";\nimport { type Entity } from \"src/Entity.ts\";\nimport { type EntityMetadata } from \"src/EntityMetadata.ts\";\nimport { setField } from \"src/fields.ts\";\nimport {\n  type IdOf,\n  type LoadedReference,\n  type OneToOneField,\n  type TaggedId,\n  appendStack,\n  deTagId,\n  ensureNotDeleted,\n  getEmInternalApi,\n  getInstanceData,\n  getMetadata,\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 { type ManyToOneReference, failIfNewEntity, failNoId } from \"src/relations/ManyToOneReference.ts\";\nimport { isReactiveReference } from \"src/relations/ReactiveReference.ts\";\nimport { type Reference } from \"src/relations/Reference.ts\";\nimport { ReferenceN } from \"src/relations/ReferenceSymbols.ts\";\nimport { RelationT, RelationU } from \"src/relations/RelationSymbols.ts\";\n\nconst OneToOne = Symbol();\n\n/** An alias for creating `OneToOneReference`s. */\nexport function hasOneToOne<T extends Entity, U extends Entity>(): OneToOneReference<T, U> {\n  return lazyField((entity: T, fieldName) => {\n    const o2o = getMetadata(entity).allFields[fieldName] as OneToOneField;\n    return new OneToOneReferenceImpl<T, U>(entity, o2o);\n  });\n}\n\n/** The lazy-loaded/lookup side of a one-to-one, i.e. the side w/o the unique foreign key column. */\nexport interface OneToOneReference<T extends Entity, U extends Entity> extends Reference<T, U, undefined> {\n  // Need to differentiate OneToOneReference from Reference\n  [OneToOne]: T;\n}\n\n/** Adds a known-safe `get` accessor. */\nexport interface LoadedOneToOneReference<T extends Entity, U extends Entity> extends LoadedReference<T, U, undefined> {\n  get: U | undefined;\n\n  getWithDeleted: U | undefined;\n\n  // Once OneToOneReference is loaded, it can get a lot of the ManyToOneReference methods that\n  // are available even in an unloaded state; below is mostly a copy/paste of those.\n\n  /** Returns the id of the current assigned entity or a runtime error if it's either a) unset or b) set to a new entity that doesn't have an `id` yet. */\n  id: IdOf<U>;\n\n  idIfSet: IdOf<U> | undefined;\n\n  idUntagged: string;\n\n  idUntaggedMaybe: string | undefined;\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/** Type guard utility for determining if an entity field is a Reference. */\nexport function isOneToOneReference(maybeReference: any): maybeReference is OneToOneReference<any, any> {\n  return maybeReference instanceof OneToOneReferenceImpl;\n}\n\n/** Type guard utility for determining if an entity field is a loaded Reference. */\nexport function isLoadedOneToOneReference(\n  maybeReference: any,\n): maybeReference is Reference<any, any, any> & LoadedOneToOneReference<any, any> {\n  return isOneToOneReference(maybeReference) && maybeReference.isLoaded;\n}\n\n/**\n * Represents the \"many\" side of a one-to-one relationship.\n *\n * I.e. in a one-to-many from Book -> Reviews, there is a review.book_id that can have many books.\n *\n * This class is for when that `review.book_id` column is itself unique, i.e. like `image.book_id`, and\n * so instead of `Book.images: OneToManyCollection` we have a `Book.image: OneToOneReference`.\n *\n * This class implements `Reference` because it is essentially like \"one entity pointing/refereing to another\",\n * however because we require a `.load` call to lazily know the value of other side (unlike ManyToOneReference\n * which has it's `book_id` column immediately available in the entity `data` hash), there is some wonkiness\n * around methods like `Reference.id` that are usually callable without `load`/`populate`, that for this\n * class can actually only be called post `load`/`populate`.\n *\n * Currently we enforce this with a runtime check, which is not great, but the trade-off of implementing\n * `Reference` seemed worth the downside of a un-type-safe `.id` property.\n */\nexport class OneToOneReferenceImpl<T extends Entity, U extends Entity>\n  extends AbstractRelationImpl<T, U>\n  implements OneToOneReference<T, U>\n{\n  #field: OneToOneField;\n  private loaded: U | undefined;\n  private _isLoaded: boolean = false;\n  #hasBeenSet = false;\n\n  constructor(entity: T, field: OneToOneField) {\n    super(entity);\n    this.#field = field;\n    if (getInstanceData(entity).isOrWasNew) {\n      this._isLoaded = true;\n    }\n  }\n\n  // These are public to our internal implementation but not exposed in the Collection API\n  get fieldName(): keyof T & string {\n    return this.#field.fieldName as keyof T & string;\n  }\n\n  get otherFieldName(): keyof U & string {\n    return this.#field.otherFieldName as keyof U & string;\n  }\n\n  get id(): IdOf<U> {\n    return this.idMaybe || failNoId(this.entity, this.fieldName, this.loaded);\n  }\n\n  get idIfSet(): IdOf<U> | undefined {\n    if (this._isLoaded) {\n      return this.idMaybe || failIfNewEntity(this.entity, this.fieldName, this.loaded);\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  get idUntagged(): string {\n    return this.idUntaggedMaybe || failNoId(this.entity, this.fieldName, this.loaded);\n  }\n\n  get idUntaggedIfSet(): string | undefined {\n    return this.idUntaggedMaybe || failIfNewEntity(this.entity, this.fieldName, this.loaded);\n  }\n\n  private get idMaybe(): IdOf<U> | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (this._isLoaded) {\n      return this.loaded?.idMaybe as IdOf<U> | undefined;\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  get idTaggedMaybe(): TaggedId | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (this._isLoaded) {\n      return this.loaded?.idTaggedMaybe;\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  private get idUntaggedMaybe(): string | undefined {\n    return deTagId(this.otherMeta, this.idMaybe);\n  }\n\n  get isSet(): boolean {\n    if (this._isLoaded) {\n      return this.loaded !== undefined;\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  // opts is an internal parameter\n  async load(opts: { withDeleted?: boolean; forceReload?: boolean } = {}): Promise<U | undefined> {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (!this._isLoaded || opts.forceReload) {\n      if (!this.entity.isNewEntity) {\n        const joinLoaded = this.getPreloaded();\n        if (joinLoaded) {\n          this.loaded = joinLoaded[0];\n        } else {\n          try {\n            await oneToOneBatchLoader(this.entity.em, this).load(this.entity.idTagged);\n          } catch (err) {\n            throw appendStack(err as Error, new Error());\n          }\n          this.preload();\n        }\n      }\n      this._isLoaded = true;\n    }\n    return this.filterDeleted(this.loaded, opts);\n  }\n\n  set(other: U, opts: { percolating?: boolean } = {}): void {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#hasBeenSet = true;\n    if (other === this.loaded) {\n      this._isLoaded = true;\n      return;\n    }\n    if (this._isLoaded) {\n      if (this.loaded && !opts.percolating) {\n        this.getOtherRelation(this.loaded).set(undefined);\n      }\n    }\n    const { fieldLogger } = getEmInternalApi(this.entity.em);\n    fieldLogger.logSet(this.entity, this.fieldName, other);\n    this.loaded = other;\n    this._isLoaded = true;\n    // This will no-op and mark other dirty if necessary\n    if (other && !opts.percolating) {\n      this.getOtherRelation(other).set(this.entity);\n    }\n  }\n\n  get isLoaded(): boolean {\n    return this._isLoaded;\n  }\n\n  get isPreloaded(): boolean {\n    return !!this.getPreloaded();\n  }\n\n  preload(): void {\n    this.loaded = this.getPreloaded()?.[0];\n    this._isLoaded = true;\n  }\n\n  import(other: OneToOneReferenceImpl<T, U>, findEntity: (e: U) => U): void {\n    this.loaded = other.loaded ? findEntity(other.loaded) : undefined;\n    this._isLoaded = true;\n  }\n\n  get getWithDeleted(): U | undefined {\n    return this.filterDeleted(this.doGet(), { withDeleted: true });\n  }\n\n  get get(): U | undefined {\n    return this.filterDeleted(this.doGet(), { withDeleted: false });\n  }\n\n  get otherMeta(): EntityMetadata {\n    return this.#field.otherMetadata();\n  }\n\n  private doGet(): U | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (!this._isLoaded) {\n      // This should only be callable in the type system if we've already resolved this to an instance\n      throw new Error(\"get was called when not loaded\");\n    }\n    return this.loaded;\n  }\n\n  // internal impl\n\n  setFromOpts(other: U): void {\n    this.set(other);\n  }\n\n  maybeCascadeDelete(): void {\n    if (this.isCascadeDelete && this.loaded) {\n      this.entity.em.delete(this.loaded);\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 otherSide = this.getOtherRelation(current);\n      // Don't call `ReactiveReference.set` because it'll blow up\n      if (!isReactiveReference(otherSide)) {\n        otherSide.set(undefined as any);\n      }\n      setField(current, this.otherFieldName, undefined);\n    }\n    this.loaded = undefined as any;\n    this._isLoaded = true;\n  }\n\n  get hasBeenSet() {\n    return this.#hasBeenSet;\n  }\n\n  public toString(): string {\n    return `OneToOneReference(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.otherMeta.type}, otherFieldName: ${this.otherFieldName})`;\n  }\n\n  private filterDeleted(entity: U | undefined, opts?: { withDeleted?: boolean }): U | undefined {\n    return opts?.withDeleted === true || entity === undefined || !entity.isDeletedEntity ? entity : undefined;\n  }\n\n  /** Returns the other relation that points back at us, i.e. we're `Author.image` and this is `Image.author_id`. */\n  private getOtherRelation(other: U): ManyToOneReference<U, T, any> {\n    return (other as U)[this.otherFieldName] as any;\n  }\n\n  private getPreloaded(): U[] | undefined {\n    if (this.entity.isNewEntity) return undefined;\n    return getEmInternalApi(this.entity.em).getPreloadedRelation(this.entity.idTagged, this.fieldName);\n  }\n\n  private get isCascadeDelete(): boolean {\n    return isCascadeDelete(this, this.fieldName);\n  }\n\n  [RelationT] = null!;\n  [RelationU] = null!;\n  [ReferenceN] = null!;\n  [OneToOne] = null!;\n}\n"],"mappings":"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"}
+{"version":3,"file":"OneToOneReference.cjs","names":["lazyField","getMetadata","AbstractRelationImpl","getInstanceData","failNoId","failIfNewEntity","deTagId","oneToOneBatchLoader","appendStack","getEmInternalApi","isReactiveReference","isCascadeDelete","RelationT","RelationU","ReferenceN"],"sources":["../../src/relations/OneToOneReference.ts"],"sourcesContent":["import { oneToOneBatchLoader } from \"src/batchloaders/oneToOneBatchLoader.ts\";\nimport { type Entity } from \"src/Entity.ts\";\nimport { type EntityMetadata } from \"src/EntityMetadata.ts\";\nimport { setField } from \"src/fields.ts\";\nimport {\n  type IdOf,\n  type LoadedReference,\n  type OneToOneField,\n  type TaggedId,\n  appendStack,\n  deTagId,\n  ensureNotDeleted,\n  getEmInternalApi,\n  getInstanceData,\n  getMetadata,\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 { type ManyToOneReference, failIfNewEntity, failNoId } from \"src/relations/ManyToOneReference.ts\";\nimport { isReactiveReference } from \"src/relations/ReactiveReference.ts\";\nimport { type Reference } from \"src/relations/Reference.ts\";\nimport { ReferenceN } from \"src/relations/ReferenceSymbols.ts\";\nimport { RelationT, RelationU } from \"src/relations/RelationSymbols.ts\";\n\nconst OneToOne = Symbol();\n\n/** An alias for creating `OneToOneReference`s. */\nexport function hasOneToOne<T extends Entity, U extends Entity>(): OneToOneReference<T, U> {\n  return lazyField((entity: T, fieldName) => {\n    const o2o = getMetadata(entity).allFields[fieldName] as OneToOneField;\n    return new OneToOneReferenceImpl<T, U>(entity, o2o);\n  });\n}\n\n/** The lazy-loaded/lookup side of a one-to-one, i.e. the side w/o the unique foreign key column. */\nexport interface OneToOneReference<T extends Entity, U extends Entity> extends Reference<T, U, undefined> {\n  // Need to differentiate OneToOneReference from Reference\n  [OneToOne]: T;\n}\n\n/** Adds a known-safe `get` accessor. */\nexport interface LoadedOneToOneReference<T extends Entity, U extends Entity> extends LoadedReference<T, U, undefined> {\n  get: U | undefined;\n\n  getWithDeleted: U | undefined;\n\n  // Once OneToOneReference is loaded, it can get a lot of the ManyToOneReference methods that\n  // are available even in an unloaded state; below is mostly a copy/paste of those.\n\n  /** Returns the id of the current assigned entity or a runtime error if it's either a) unset or b) set to a new entity that doesn't have an `id` yet. */\n  id: IdOf<U>;\n\n  idIfSet: IdOf<U> | undefined;\n\n  idUntagged: string;\n\n  idUntaggedMaybe: string | undefined;\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/** Type guard utility for determining if an entity field is a Reference. */\nexport function isOneToOneReference(maybeReference: any): maybeReference is OneToOneReference<any, any> {\n  return maybeReference instanceof OneToOneReferenceImpl;\n}\n\n/** Type guard utility for determining if an entity field is a loaded Reference. */\nexport function isLoadedOneToOneReference(\n  maybeReference: any,\n): maybeReference is Reference<any, any, any> & LoadedOneToOneReference<any, any> {\n  return isOneToOneReference(maybeReference) && maybeReference.isLoaded;\n}\n\n/**\n * Represents the \"many\" side of a one-to-one relationship.\n *\n * I.e. in a one-to-many from Book -> Reviews, there is a review.book_id that can have many books.\n *\n * This class is for when that `review.book_id` column is itself unique, i.e. like `image.book_id`, and\n * so instead of `Book.images: OneToManyCollection` we have a `Book.image: OneToOneReference`.\n *\n * This class implements `Reference` because it is essentially like \"one entity pointing/refereing to another\",\n * however because we require a `.load` call to lazily know the value of other side (unlike ManyToOneReference\n * which has it's `book_id` column immediately available in the entity `data` hash), there is some wonkiness\n * around methods like `Reference.id` that are usually callable without `load`/`populate`, that for this\n * class can actually only be called post `load`/`populate`.\n *\n * Currently we enforce this with a runtime check, which is not great, but the trade-off of implementing\n * `Reference` seemed worth the downside of a un-type-safe `.id` property.\n */\nexport class OneToOneReferenceImpl<T extends Entity, U extends Entity>\n  extends AbstractRelationImpl<T, U>\n  implements OneToOneReference<T, U>\n{\n  #field: OneToOneField;\n  private loaded: U | undefined;\n  private _isLoaded: boolean = false;\n  #hasBeenSet = false;\n\n  constructor(entity: T, field: OneToOneField) {\n    super(entity);\n    this.#field = field;\n    if (getInstanceData(entity).isOrWasNew) {\n      this._isLoaded = true;\n    }\n  }\n\n  // These are public to our internal implementation but not exposed in the Collection API\n  get fieldName(): keyof T & string {\n    return this.#field.fieldName as keyof T & string;\n  }\n\n  get otherFieldName(): keyof U & string {\n    return this.#field.otherFieldName as keyof U & string;\n  }\n\n  get id(): IdOf<U> {\n    return this.idMaybe || failNoId(this.entity, this.fieldName, this.loaded);\n  }\n\n  get idIfSet(): IdOf<U> | undefined {\n    if (this._isLoaded) {\n      return this.idMaybe || failIfNewEntity(this.entity, this.fieldName, this.loaded);\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  get idUntagged(): string {\n    return this.idUntaggedMaybe || failNoId(this.entity, this.fieldName, this.loaded);\n  }\n\n  get idUntaggedIfSet(): string | undefined {\n    return this.idUntaggedMaybe || failIfNewEntity(this.entity, this.fieldName, this.loaded);\n  }\n\n  private get idMaybe(): IdOf<U> | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (this._isLoaded) {\n      return this.loaded?.idMaybe as IdOf<U> | undefined;\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  get idTaggedMaybe(): TaggedId | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (this._isLoaded) {\n      return this.loaded?.idTaggedMaybe;\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  private get idUntaggedMaybe(): string | undefined {\n    return deTagId(this.otherMeta, this.idMaybe);\n  }\n\n  get isSet(): boolean {\n    if (this._isLoaded) {\n      return this.loaded !== undefined;\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  // opts is an internal parameter\n  async load(opts: { withDeleted?: boolean; forceReload?: boolean } = {}): Promise<U | undefined> {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (!this._isLoaded || opts.forceReload) {\n      if (!this.entity.isNewEntity) {\n        const joinLoaded = this.getPreloaded();\n        if (joinLoaded) {\n          this.loaded = joinLoaded[0];\n        } else {\n          try {\n            await oneToOneBatchLoader(this.entity.em, this).load(this.entity.idTagged);\n          } catch (err) {\n            throw appendStack(err as Error, new Error());\n          }\n          this.preload();\n        }\n      }\n      this._isLoaded = true;\n    }\n    return this.filterDeleted(this.loaded, opts);\n  }\n\n  set(other: U, opts: { percolating?: boolean } = {}): void {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#hasBeenSet = true;\n    if (other === this.loaded) {\n      this._isLoaded = true;\n      return;\n    }\n    if (this._isLoaded) {\n      if (this.loaded && !opts.percolating) {\n        this.getOtherRelation(this.loaded).set(undefined);\n      }\n    }\n    const { fieldLogger } = getEmInternalApi(this.entity.em);\n    fieldLogger.logSet(this.entity, this.fieldName, other);\n    this.loaded = other;\n    this._isLoaded = true;\n    // This will no-op and mark other dirty if necessary\n    if (other && !opts.percolating) {\n      this.getOtherRelation(other).set(this.entity);\n    }\n  }\n\n  get isLoaded(): boolean {\n    return this._isLoaded;\n  }\n\n  get isPreloaded(): boolean {\n    return !!this.getPreloaded();\n  }\n\n  preload(): void {\n    this.loaded = this.getPreloaded()?.[0];\n    this._isLoaded = true;\n  }\n\n  import(other: OneToOneReferenceImpl<T, U>, findEntity: (e: U) => U): void {\n    this.loaded = other.loaded ? findEntity(other.loaded) : undefined;\n    this._isLoaded = true;\n  }\n\n  get getWithDeleted(): U | undefined {\n    return this.filterDeleted(this.doGet(), { withDeleted: true });\n  }\n\n  get get(): U | undefined {\n    return this.filterDeleted(this.doGet(), { withDeleted: false });\n  }\n\n  get otherMeta(): EntityMetadata {\n    return this.#field.otherMetadata();\n  }\n\n  private doGet(): U | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (!this._isLoaded) {\n      // This should only be callable in the type system if we've already resolved this to an instance\n      throw new Error(\"get was called when not loaded\");\n    }\n    return this.loaded;\n  }\n\n  // internal impl\n\n  setFromOpts(other: U): void {\n    this.set(other);\n  }\n\n  maybeCascadeDelete(): void {\n    if (this.isCascadeDelete && this.loaded) {\n      this.entity.em.delete(this.loaded);\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 otherSide = this.getOtherRelation(current);\n      // Don't call `ReactiveReference.set` because it'll blow up\n      if (!isReactiveReference(otherSide)) {\n        otherSide.set(undefined as any);\n      }\n      setField(current, this.otherFieldName, undefined);\n    }\n    this.loaded = undefined as any;\n    this._isLoaded = true;\n  }\n\n  get hasBeenSet() {\n    return this.#hasBeenSet;\n  }\n\n  public toString(): string {\n    return `OneToOneReference(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.otherMeta.type}, otherFieldName: ${this.otherFieldName})`;\n  }\n\n  private filterDeleted(entity: U | undefined, opts?: { withDeleted?: boolean }): U | undefined {\n    return opts?.withDeleted === true || entity === undefined || !entity.isDeletedEntity ? entity : undefined;\n  }\n\n  /** Returns the other relation that points back at us, i.e. we're `Author.image` and this is `Image.author_id`. */\n  private getOtherRelation(other: U): ManyToOneReference<U, T, any> {\n    return (other as U)[this.otherFieldName] as any;\n  }\n\n  private getPreloaded(): U[] | undefined {\n    if (this.entity.isNewEntity) return undefined;\n    return getEmInternalApi(this.entity.em).getPreloadedRelation(this.entity.idTagged, this.fieldName);\n  }\n\n  private get isCascadeDelete(): boolean {\n    return isCascadeDelete(this, this.fieldName);\n  }\n\n  [RelationT] = null!;\n  [RelationU] = null!;\n  [ReferenceN] = null!;\n  [OneToOne] = null!;\n}\n"],"mappings":"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"}

package/build/relations/OneToOneReference.d.cts

@@ -9,13 +9,13 @@ import { Entity } from "../Entity.cjs";
 //#region src/relations/OneToOneReference.d.ts
 declare const OneToOne: unique symbol;
 /** An alias for creating `OneToOneReference`s. */
-declare function hasOneToOne<T extends Entity, U extends Entity>(): OneToOneReference<T, U>;
+export declare function hasOneToOne<T extends Entity, U extends Entity>(): OneToOneReference<T, U>;
 /** The lazy-loaded/lookup side of a one-to-one, i.e. the side w/o the unique foreign key column. */
-interface OneToOneReference<T extends Entity, U extends Entity> extends Reference<T, U, undefined> {
+export interface OneToOneReference<T extends Entity, U extends Entity> extends Reference<T, U, undefined> {
   [OneToOne]: T;
 }
 /** Adds a known-safe `get` accessor. */
-interface LoadedOneToOneReference<T extends Entity, U extends Entity> extends LoadedReference<T, U, undefined> {
+export interface LoadedOneToOneReference<T extends Entity, U extends Entity> extends LoadedReference<T, U, undefined> {
   get: U | undefined;
   getWithDeleted: U | undefined;
   /** Returns the id of the current assigned entity or a runtime error if it's either a) unset or b) set to a new entity that doesn't have an `id` yet. */
@@ -27,9 +27,9 @@ interface LoadedOneToOneReference<T extends Entity, U extends Entity> extends Lo
   readonly isSet: boolean;
 }
 /** Type guard utility for determining if an entity field is a Reference. */
-declare function isOneToOneReference(maybeReference: any): maybeReference is OneToOneReference<any, any>;
+export declare function isOneToOneReference(maybeReference: any): maybeReference is OneToOneReference<any, any>;
 /** Type guard utility for determining if an entity field is a loaded Reference. */
-declare function isLoadedOneToOneReference(maybeReference: any): maybeReference is Reference<any, any, any> & LoadedOneToOneReference<any, any>;
+export declare function isLoadedOneToOneReference(maybeReference: any): maybeReference is Reference<any, any, any> & LoadedOneToOneReference<any, any>;
 /**
  * Represents the "many" side of a one-to-one relationship.
  *
@@ -47,7 +47,7 @@ declare function isLoadedOneToOneReference(maybeReference: any): maybeReference
  * Currently we enforce this with a runtime check, which is not great, but the trade-off of implementing
  * `Reference` seemed worth the downside of a un-type-safe `.id` property.
  */
-declare class OneToOneReferenceImpl<T extends Entity, U extends Entity> extends AbstractRelationImpl<T, U> implements OneToOneReference<T, U> {
+export declare class OneToOneReferenceImpl<T extends Entity, U extends Entity> extends AbstractRelationImpl<T, U> implements OneToOneReference<T, U> {
   #private;
   private loaded;
   private _isLoaded;
@@ -93,5 +93,5 @@ declare class OneToOneReferenceImpl<T extends Entity, U extends Entity> extends
   [OneToOne]: never;
 }
 //#endregion
-export { LoadedOneToOneReference, OneToOneReference, OneToOneReferenceImpl, hasOneToOne, isLoadedOneToOneReference, isOneToOneReference };
+export {};
 //# sourceMappingURL=OneToOneReference.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"OneToOneReference.d.cts","names":[],"sources":["../../src/relations/OneToOneReference.ts"],"mappings":";;;;;;;;;cAyBM;;iBAGU,YAAY,UAAU,QAAQ,UAAU,WAAW,kBAAkB,GAAG;;UAQvE,kBAAkB,UAAU,QAAQ,UAAU,gBAAgB,UAAU,GAAG;GAEzF,WAAW;;;UAIG,wBAAwB,UAAU,QAAQ,UAAU,gBAAgB,gBAAgB,GAAG;EACtG,KAAK;EAEL,gBAAgB;;EAMhB,IAAI,KAAK;EAET,SAAS,KAAK;EAEd;EAEA;;WAGS;;;iBAIK,oBAAoB,sBAAsB,kBAAkB;;iBAK5D,0BACd,sBACC,kBAAkB,2BAA2B;;;;;;;;;;;;;;;;;;cAqBnC,sBAAsB,UAAU,QAAQ,UAAU,gBACrD,qBAAqB,GAAG,cACrB,kBAAkB,GAAG;;UAGxB;UACA;EAGR,YAAY,QAAQ,GAAG,OAAO;MAS1B,mBAAmB;MAInB,wBAAwB;MAIxB,MAAM,KAAK;MAIX,WAAW,KAAK;MAOhB;MAIA;cAIQ;MAQR,iBAAiB;cAQT;MAIR;EAQE,KAAK;IAAQ;IAAuB;MAA+B,QAAQ;EAqBjF,IAAI,OAAO,GAAG;IAAQ;;MAsBlB;MAIA;EAIJ;EAKA,OAAO,OAAO,sBAAsB,GAAG,IAAI,aAAa,GAAG,MAAM;MAK7D,kBAAkB;MAIlB,OAAO;MAIP,aAAa;UAIT;EAWR,YAAY,OAAO;EAInB;EAMM,0BAA0B;MAgB5B;EAIG;UAIC;;UAKA;UAIA;cAKI;GAIX;GACA;GACA;GACA"}
+{"version":3,"file":"OneToOneReference.d.cts","names":[],"sources":["../../src/relations/OneToOneReference.ts"],"mappings":";;;;;;;;;cAyBM;;wBAGU,YAAY,UAAU,QAAQ,UAAU,WAAW,kBAAkB,GAAG;;iBAQvE,kBAAkB,UAAU,QAAQ,UAAU,gBAAgB,UAAU,GAAG;GAEzF,WAAW;;;iBAIG,wBAAwB,UAAU,QAAQ,UAAU,gBAAgB,gBAAgB,GAAG;EACtG,KAAK;EAEL,gBAAgB;;EAMhB,IAAI,KAAK;EAET,SAAS,KAAK;EAEd;EAEA;;WAGS;;;wBAIK,oBAAoB,sBAAsB,kBAAkB;;wBAK5D,0BACd,sBACC,kBAAkB,2BAA2B;;;;;;;;;;;;;;;;;;qBAqBnC,sBAAsB,UAAU,QAAQ,UAAU,gBACrD,qBAAqB,GAAG,cACrB,kBAAkB,GAAG;;UAGxB;UACA;EAGR,YAAY,QAAQ,GAAG,OAAO;MAS1B,mBAAmB;MAInB,wBAAwB;MAIxB,MAAM,KAAK;MAIX,WAAW,KAAK;MAOhB;MAIA;cAIQ;MAQR,iBAAiB;cAQT;MAIR;EAQE,KAAK;IAAQ;IAAuB;MAA+B,QAAQ;EAqBjF,IAAI,OAAO,GAAG;IAAQ;;MAsBlB;MAIA;EAIJ;EAKA,OAAO,OAAO,sBAAsB,GAAG,IAAI,aAAa,GAAG,MAAM;MAK7D,kBAAkB;MAIlB,OAAO;MAIP,aAAa;UAIT;EAWR,YAAY,OAAO;EAInB;EAMM,0BAA0B;MAgB5B;EAIG;UAIC;;UAKA;UAIA;cAKI;GAIX;GACA;GACA;GACA"}

package/build/relations/OneToOneReference.d.mts

@@ -9,13 +9,13 @@ import { Entity } from "../Entity.mjs";
 //#region src/relations/OneToOneReference.d.ts
 declare const OneToOne: unique symbol;
 /** An alias for creating `OneToOneReference`s. */
-declare function hasOneToOne<T extends Entity, U extends Entity>(): OneToOneReference<T, U>;
+export declare function hasOneToOne<T extends Entity, U extends Entity>(): OneToOneReference<T, U>;
 /** The lazy-loaded/lookup side of a one-to-one, i.e. the side w/o the unique foreign key column. */
-interface OneToOneReference<T extends Entity, U extends Entity> extends Reference<T, U, undefined> {
+export interface OneToOneReference<T extends Entity, U extends Entity> extends Reference<T, U, undefined> {
   [OneToOne]: T;
 }
 /** Adds a known-safe `get` accessor. */
-interface LoadedOneToOneReference<T extends Entity, U extends Entity> extends LoadedReference<T, U, undefined> {
+export interface LoadedOneToOneReference<T extends Entity, U extends Entity> extends LoadedReference<T, U, undefined> {
   get: U | undefined;
   getWithDeleted: U | undefined;
   /** Returns the id of the current assigned entity or a runtime error if it's either a) unset or b) set to a new entity that doesn't have an `id` yet. */
@@ -27,9 +27,9 @@ interface LoadedOneToOneReference<T extends Entity, U extends Entity> extends Lo
   readonly isSet: boolean;
 }
 /** Type guard utility for determining if an entity field is a Reference. */
-declare function isOneToOneReference(maybeReference: any): maybeReference is OneToOneReference<any, any>;
+export declare function isOneToOneReference(maybeReference: any): maybeReference is OneToOneReference<any, any>;
 /** Type guard utility for determining if an entity field is a loaded Reference. */
-declare function isLoadedOneToOneReference(maybeReference: any): maybeReference is Reference<any, any, any> & LoadedOneToOneReference<any, any>;
+export declare function isLoadedOneToOneReference(maybeReference: any): maybeReference is Reference<any, any, any> & LoadedOneToOneReference<any, any>;
 /**
  * Represents the "many" side of a one-to-one relationship.
  *
@@ -47,7 +47,7 @@ declare function isLoadedOneToOneReference(maybeReference: any): maybeReference
  * Currently we enforce this with a runtime check, which is not great, but the trade-off of implementing
  * `Reference` seemed worth the downside of a un-type-safe `.id` property.
  */
-declare class OneToOneReferenceImpl<T extends Entity, U extends Entity> extends AbstractRelationImpl<T, U> implements OneToOneReference<T, U> {
+export declare class OneToOneReferenceImpl<T extends Entity, U extends Entity> extends AbstractRelationImpl<T, U> implements OneToOneReference<T, U> {
   #private;
   private loaded;
   private _isLoaded;
@@ -93,5 +93,5 @@ declare class OneToOneReferenceImpl<T extends Entity, U extends Entity> extends
   [OneToOne]: never;
 }
 //#endregion
-export { LoadedOneToOneReference, OneToOneReference, OneToOneReferenceImpl, hasOneToOne, isLoadedOneToOneReference, isOneToOneReference };
+export {};
 //# sourceMappingURL=OneToOneReference.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"OneToOneReference.d.mts","names":[],"sources":["../../src/relations/OneToOneReference.ts"],"mappings":";;;;;;;;;cAyBM;;iBAGU,YAAY,UAAU,QAAQ,UAAU,WAAW,kBAAkB,GAAG;;UAQvE,kBAAkB,UAAU,QAAQ,UAAU,gBAAgB,UAAU,GAAG;GAEzF,WAAW;;;UAIG,wBAAwB,UAAU,QAAQ,UAAU,gBAAgB,gBAAgB,GAAG;EACtG,KAAK;EAEL,gBAAgB;;EAMhB,IAAI,KAAK;EAET,SAAS,KAAK;EAEd;EAEA;;WAGS;;;iBAIK,oBAAoB,sBAAsB,kBAAkB;;iBAK5D,0BACd,sBACC,kBAAkB,2BAA2B;;;;;;;;;;;;;;;;;;cAqBnC,sBAAsB,UAAU,QAAQ,UAAU,gBACrD,qBAAqB,GAAG,cACrB,kBAAkB,GAAG;;UAGxB;UACA;EAGR,YAAY,QAAQ,GAAG,OAAO;MAS1B,mBAAmB;MAInB,wBAAwB;MAIxB,MAAM,KAAK;MAIX,WAAW,KAAK;MAOhB;MAIA;cAIQ;MAQR,iBAAiB;cAQT;MAIR;EAQE,KAAK;IAAQ;IAAuB;MAA+B,QAAQ;EAqBjF,IAAI,OAAO,GAAG;IAAQ;;MAsBlB;MAIA;EAIJ;EAKA,OAAO,OAAO,sBAAsB,GAAG,IAAI,aAAa,GAAG,MAAM;MAK7D,kBAAkB;MAIlB,OAAO;MAIP,aAAa;UAIT;EAWR,YAAY,OAAO;EAInB;EAMM,0BAA0B;MAgB5B;EAIG;UAIC;;UAKA;UAIA;cAKI;GAIX;GACA;GACA;GACA"}
+{"version":3,"file":"OneToOneReference.d.mts","names":[],"sources":["../../src/relations/OneToOneReference.ts"],"mappings":";;;;;;;;;cAyBM;;wBAGU,YAAY,UAAU,QAAQ,UAAU,WAAW,kBAAkB,GAAG;;iBAQvE,kBAAkB,UAAU,QAAQ,UAAU,gBAAgB,UAAU,GAAG;GAEzF,WAAW;;;iBAIG,wBAAwB,UAAU,QAAQ,UAAU,gBAAgB,gBAAgB,GAAG;EACtG,KAAK;EAEL,gBAAgB;;EAMhB,IAAI,KAAK;EAET,SAAS,KAAK;EAEd;EAEA;;WAGS;;;wBAIK,oBAAoB,sBAAsB,kBAAkB;;wBAK5D,0BACd,sBACC,kBAAkB,2BAA2B;;;;;;;;;;;;;;;;;;qBAqBnC,sBAAsB,UAAU,QAAQ,UAAU,gBACrD,qBAAqB,GAAG,cACrB,kBAAkB,GAAG;;UAGxB;UACA;EAGR,YAAY,QAAQ,GAAG,OAAO;MAS1B,mBAAmB;MAInB,wBAAwB;MAIxB,MAAM,KAAK;MAIX,WAAW,KAAK;MAOhB;MAIA;cAIQ;MAQR,iBAAiB;cAQT;MAIR;EAQE,KAAK;IAAQ;IAAuB;MAA+B,QAAQ;EAqBjF,IAAI,OAAO,GAAG;IAAQ;;MAsBlB;MAIA;EAIJ;EAKA,OAAO,OAAO,sBAAsB,GAAG,IAAI,aAAa,GAAG,MAAM;MAK7D,kBAAkB;MAIlB,OAAO;MAIP,aAAa;UAIT;EAWR,YAAY,OAAO;EAInB;EAMM,0BAA0B;MAgB5B;EAIG;UAIC;;UAKA;UAIA;cAKI;GAIX;GACA;GACA;GACA"}

package/build/relations/OneToOneReference.js.map

@@ -1 +1 @@
-{"version":3,"file":"OneToOneReference.js","names":["#field","#hasBeenSet"],"sources":["../../src/relations/OneToOneReference.ts"],"sourcesContent":["import { oneToOneBatchLoader } from \"src/batchloaders/oneToOneBatchLoader.ts\";\nimport { type Entity } from \"src/Entity.ts\";\nimport { type EntityMetadata } from \"src/EntityMetadata.ts\";\nimport { setField } from \"src/fields.ts\";\nimport {\n  type IdOf,\n  type LoadedReference,\n  type OneToOneField,\n  type TaggedId,\n  appendStack,\n  deTagId,\n  ensureNotDeleted,\n  getEmInternalApi,\n  getInstanceData,\n  getMetadata,\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 { type ManyToOneReference, failIfNewEntity, failNoId } from \"src/relations/ManyToOneReference.ts\";\nimport { isReactiveReference } from \"src/relations/ReactiveReference.ts\";\nimport { type Reference } from \"src/relations/Reference.ts\";\nimport { ReferenceN } from \"src/relations/ReferenceSymbols.ts\";\nimport { RelationT, RelationU } from \"src/relations/RelationSymbols.ts\";\n\nconst OneToOne = Symbol();\n\n/** An alias for creating `OneToOneReference`s. */\nexport function hasOneToOne<T extends Entity, U extends Entity>(): OneToOneReference<T, U> {\n  return lazyField((entity: T, fieldName) => {\n    const o2o = getMetadata(entity).allFields[fieldName] as OneToOneField;\n    return new OneToOneReferenceImpl<T, U>(entity, o2o);\n  });\n}\n\n/** The lazy-loaded/lookup side of a one-to-one, i.e. the side w/o the unique foreign key column. */\nexport interface OneToOneReference<T extends Entity, U extends Entity> extends Reference<T, U, undefined> {\n  // Need to differentiate OneToOneReference from Reference\n  [OneToOne]: T;\n}\n\n/** Adds a known-safe `get` accessor. */\nexport interface LoadedOneToOneReference<T extends Entity, U extends Entity> extends LoadedReference<T, U, undefined> {\n  get: U | undefined;\n\n  getWithDeleted: U | undefined;\n\n  // Once OneToOneReference is loaded, it can get a lot of the ManyToOneReference methods that\n  // are available even in an unloaded state; below is mostly a copy/paste of those.\n\n  /** Returns the id of the current assigned entity or a runtime error if it's either a) unset or b) set to a new entity that doesn't have an `id` yet. */\n  id: IdOf<U>;\n\n  idIfSet: IdOf<U> | undefined;\n\n  idUntagged: string;\n\n  idUntaggedMaybe: string | undefined;\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/** Type guard utility for determining if an entity field is a Reference. */\nexport function isOneToOneReference(maybeReference: any): maybeReference is OneToOneReference<any, any> {\n  return maybeReference instanceof OneToOneReferenceImpl;\n}\n\n/** Type guard utility for determining if an entity field is a loaded Reference. */\nexport function isLoadedOneToOneReference(\n  maybeReference: any,\n): maybeReference is Reference<any, any, any> & LoadedOneToOneReference<any, any> {\n  return isOneToOneReference(maybeReference) && maybeReference.isLoaded;\n}\n\n/**\n * Represents the \"many\" side of a one-to-one relationship.\n *\n * I.e. in a one-to-many from Book -> Reviews, there is a review.book_id that can have many books.\n *\n * This class is for when that `review.book_id` column is itself unique, i.e. like `image.book_id`, and\n * so instead of `Book.images: OneToManyCollection` we have a `Book.image: OneToOneReference`.\n *\n * This class implements `Reference` because it is essentially like \"one entity pointing/refereing to another\",\n * however because we require a `.load` call to lazily know the value of other side (unlike ManyToOneReference\n * which has it's `book_id` column immediately available in the entity `data` hash), there is some wonkiness\n * around methods like `Reference.id` that are usually callable without `load`/`populate`, that for this\n * class can actually only be called post `load`/`populate`.\n *\n * Currently we enforce this with a runtime check, which is not great, but the trade-off of implementing\n * `Reference` seemed worth the downside of a un-type-safe `.id` property.\n */\nexport class OneToOneReferenceImpl<T extends Entity, U extends Entity>\n  extends AbstractRelationImpl<T, U>\n  implements OneToOneReference<T, U>\n{\n  #field: OneToOneField;\n  private loaded: U | undefined;\n  private _isLoaded: boolean = false;\n  #hasBeenSet = false;\n\n  constructor(entity: T, field: OneToOneField) {\n    super(entity);\n    this.#field = field;\n    if (getInstanceData(entity).isOrWasNew) {\n      this._isLoaded = true;\n    }\n  }\n\n  // These are public to our internal implementation but not exposed in the Collection API\n  get fieldName(): keyof T & string {\n    return this.#field.fieldName as keyof T & string;\n  }\n\n  get otherFieldName(): keyof U & string {\n    return this.#field.otherFieldName as keyof U & string;\n  }\n\n  get id(): IdOf<U> {\n    return this.idMaybe || failNoId(this.entity, this.fieldName, this.loaded);\n  }\n\n  get idIfSet(): IdOf<U> | undefined {\n    if (this._isLoaded) {\n      return this.idMaybe || failIfNewEntity(this.entity, this.fieldName, this.loaded);\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  get idUntagged(): string {\n    return this.idUntaggedMaybe || failNoId(this.entity, this.fieldName, this.loaded);\n  }\n\n  get idUntaggedIfSet(): string | undefined {\n    return this.idUntaggedMaybe || failIfNewEntity(this.entity, this.fieldName, this.loaded);\n  }\n\n  private get idMaybe(): IdOf<U> | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (this._isLoaded) {\n      return this.loaded?.idMaybe as IdOf<U> | undefined;\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  get idTaggedMaybe(): TaggedId | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (this._isLoaded) {\n      return this.loaded?.idTaggedMaybe;\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  private get idUntaggedMaybe(): string | undefined {\n    return deTagId(this.otherMeta, this.idMaybe);\n  }\n\n  get isSet(): boolean {\n    if (this._isLoaded) {\n      return this.loaded !== undefined;\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  // opts is an internal parameter\n  async load(opts: { withDeleted?: boolean; forceReload?: boolean } = {}): Promise<U | undefined> {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (!this._isLoaded || opts.forceReload) {\n      if (!this.entity.isNewEntity) {\n        const joinLoaded = this.getPreloaded();\n        if (joinLoaded) {\n          this.loaded = joinLoaded[0];\n        } else {\n          try {\n            await oneToOneBatchLoader(this.entity.em, this).load(this.entity.idTagged);\n          } catch (err) {\n            throw appendStack(err as Error, new Error());\n          }\n          this.preload();\n        }\n      }\n      this._isLoaded = true;\n    }\n    return this.filterDeleted(this.loaded, opts);\n  }\n\n  set(other: U, opts: { percolating?: boolean } = {}): void {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#hasBeenSet = true;\n    if (other === this.loaded) {\n      this._isLoaded = true;\n      return;\n    }\n    if (this._isLoaded) {\n      if (this.loaded && !opts.percolating) {\n        this.getOtherRelation(this.loaded).set(undefined);\n      }\n    }\n    const { fieldLogger } = getEmInternalApi(this.entity.em);\n    fieldLogger.logSet(this.entity, this.fieldName, other);\n    this.loaded = other;\n    this._isLoaded = true;\n    // This will no-op and mark other dirty if necessary\n    if (other && !opts.percolating) {\n      this.getOtherRelation(other).set(this.entity);\n    }\n  }\n\n  get isLoaded(): boolean {\n    return this._isLoaded;\n  }\n\n  get isPreloaded(): boolean {\n    return !!this.getPreloaded();\n  }\n\n  preload(): void {\n    this.loaded = this.getPreloaded()?.[0];\n    this._isLoaded = true;\n  }\n\n  import(other: OneToOneReferenceImpl<T, U>, findEntity: (e: U) => U): void {\n    this.loaded = other.loaded ? findEntity(other.loaded) : undefined;\n    this._isLoaded = true;\n  }\n\n  get getWithDeleted(): U | undefined {\n    return this.filterDeleted(this.doGet(), { withDeleted: true });\n  }\n\n  get get(): U | undefined {\n    return this.filterDeleted(this.doGet(), { withDeleted: false });\n  }\n\n  get otherMeta(): EntityMetadata {\n    return this.#field.otherMetadata();\n  }\n\n  private doGet(): U | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (!this._isLoaded) {\n      // This should only be callable in the type system if we've already resolved this to an instance\n      throw new Error(\"get was called when not loaded\");\n    }\n    return this.loaded;\n  }\n\n  // internal impl\n\n  setFromOpts(other: U): void {\n    this.set(other);\n  }\n\n  maybeCascadeDelete(): void {\n    if (this.isCascadeDelete && this.loaded) {\n      this.entity.em.delete(this.loaded);\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 otherSide = this.getOtherRelation(current);\n      // Don't call `ReactiveReference.set` because it'll blow up\n      if (!isReactiveReference(otherSide)) {\n        otherSide.set(undefined as any);\n      }\n      setField(current, this.otherFieldName, undefined);\n    }\n    this.loaded = undefined as any;\n    this._isLoaded = true;\n  }\n\n  get hasBeenSet() {\n    return this.#hasBeenSet;\n  }\n\n  public toString(): string {\n    return `OneToOneReference(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.otherMeta.type}, otherFieldName: ${this.otherFieldName})`;\n  }\n\n  private filterDeleted(entity: U | undefined, opts?: { withDeleted?: boolean }): U | undefined {\n    return opts?.withDeleted === true || entity === undefined || !entity.isDeletedEntity ? entity : undefined;\n  }\n\n  /** Returns the other relation that points back at us, i.e. we're `Author.image` and this is `Image.author_id`. */\n  private getOtherRelation(other: U): ManyToOneReference<U, T, any> {\n    return (other as U)[this.otherFieldName] as any;\n  }\n\n  private getPreloaded(): U[] | undefined {\n    if (this.entity.isNewEntity) return undefined;\n    return getEmInternalApi(this.entity.em).getPreloadedRelation(this.entity.idTagged, this.fieldName);\n  }\n\n  private get isCascadeDelete(): boolean {\n    return isCascadeDelete(this, this.fieldName);\n  }\n\n  [RelationT] = null!;\n  [RelationU] = null!;\n  [ReferenceN] = null!;\n  [OneToOne] = null!;\n}\n"],"mappings":"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"}
+{"version":3,"file":"OneToOneReference.js","names":[],"sources":["../../src/relations/OneToOneReference.ts"],"sourcesContent":["import { oneToOneBatchLoader } from \"src/batchloaders/oneToOneBatchLoader.ts\";\nimport { type Entity } from \"src/Entity.ts\";\nimport { type EntityMetadata } from \"src/EntityMetadata.ts\";\nimport { setField } from \"src/fields.ts\";\nimport {\n  type IdOf,\n  type LoadedReference,\n  type OneToOneField,\n  type TaggedId,\n  appendStack,\n  deTagId,\n  ensureNotDeleted,\n  getEmInternalApi,\n  getInstanceData,\n  getMetadata,\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 { type ManyToOneReference, failIfNewEntity, failNoId } from \"src/relations/ManyToOneReference.ts\";\nimport { isReactiveReference } from \"src/relations/ReactiveReference.ts\";\nimport { type Reference } from \"src/relations/Reference.ts\";\nimport { ReferenceN } from \"src/relations/ReferenceSymbols.ts\";\nimport { RelationT, RelationU } from \"src/relations/RelationSymbols.ts\";\n\nconst OneToOne = Symbol();\n\n/** An alias for creating `OneToOneReference`s. */\nexport function hasOneToOne<T extends Entity, U extends Entity>(): OneToOneReference<T, U> {\n  return lazyField((entity: T, fieldName) => {\n    const o2o = getMetadata(entity).allFields[fieldName] as OneToOneField;\n    return new OneToOneReferenceImpl<T, U>(entity, o2o);\n  });\n}\n\n/** The lazy-loaded/lookup side of a one-to-one, i.e. the side w/o the unique foreign key column. */\nexport interface OneToOneReference<T extends Entity, U extends Entity> extends Reference<T, U, undefined> {\n  // Need to differentiate OneToOneReference from Reference\n  [OneToOne]: T;\n}\n\n/** Adds a known-safe `get` accessor. */\nexport interface LoadedOneToOneReference<T extends Entity, U extends Entity> extends LoadedReference<T, U, undefined> {\n  get: U | undefined;\n\n  getWithDeleted: U | undefined;\n\n  // Once OneToOneReference is loaded, it can get a lot of the ManyToOneReference methods that\n  // are available even in an unloaded state; below is mostly a copy/paste of those.\n\n  /** Returns the id of the current assigned entity or a runtime error if it's either a) unset or b) set to a new entity that doesn't have an `id` yet. */\n  id: IdOf<U>;\n\n  idIfSet: IdOf<U> | undefined;\n\n  idUntagged: string;\n\n  idUntaggedMaybe: string | undefined;\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/** Type guard utility for determining if an entity field is a Reference. */\nexport function isOneToOneReference(maybeReference: any): maybeReference is OneToOneReference<any, any> {\n  return maybeReference instanceof OneToOneReferenceImpl;\n}\n\n/** Type guard utility for determining if an entity field is a loaded Reference. */\nexport function isLoadedOneToOneReference(\n  maybeReference: any,\n): maybeReference is Reference<any, any, any> & LoadedOneToOneReference<any, any> {\n  return isOneToOneReference(maybeReference) && maybeReference.isLoaded;\n}\n\n/**\n * Represents the \"many\" side of a one-to-one relationship.\n *\n * I.e. in a one-to-many from Book -> Reviews, there is a review.book_id that can have many books.\n *\n * This class is for when that `review.book_id` column is itself unique, i.e. like `image.book_id`, and\n * so instead of `Book.images: OneToManyCollection` we have a `Book.image: OneToOneReference`.\n *\n * This class implements `Reference` because it is essentially like \"one entity pointing/refereing to another\",\n * however because we require a `.load` call to lazily know the value of other side (unlike ManyToOneReference\n * which has it's `book_id` column immediately available in the entity `data` hash), there is some wonkiness\n * around methods like `Reference.id` that are usually callable without `load`/`populate`, that for this\n * class can actually only be called post `load`/`populate`.\n *\n * Currently we enforce this with a runtime check, which is not great, but the trade-off of implementing\n * `Reference` seemed worth the downside of a un-type-safe `.id` property.\n */\nexport class OneToOneReferenceImpl<T extends Entity, U extends Entity>\n  extends AbstractRelationImpl<T, U>\n  implements OneToOneReference<T, U>\n{\n  #field: OneToOneField;\n  private loaded: U | undefined;\n  private _isLoaded: boolean = false;\n  #hasBeenSet = false;\n\n  constructor(entity: T, field: OneToOneField) {\n    super(entity);\n    this.#field = field;\n    if (getInstanceData(entity).isOrWasNew) {\n      this._isLoaded = true;\n    }\n  }\n\n  // These are public to our internal implementation but not exposed in the Collection API\n  get fieldName(): keyof T & string {\n    return this.#field.fieldName as keyof T & string;\n  }\n\n  get otherFieldName(): keyof U & string {\n    return this.#field.otherFieldName as keyof U & string;\n  }\n\n  get id(): IdOf<U> {\n    return this.idMaybe || failNoId(this.entity, this.fieldName, this.loaded);\n  }\n\n  get idIfSet(): IdOf<U> | undefined {\n    if (this._isLoaded) {\n      return this.idMaybe || failIfNewEntity(this.entity, this.fieldName, this.loaded);\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  get idUntagged(): string {\n    return this.idUntaggedMaybe || failNoId(this.entity, this.fieldName, this.loaded);\n  }\n\n  get idUntaggedIfSet(): string | undefined {\n    return this.idUntaggedMaybe || failIfNewEntity(this.entity, this.fieldName, this.loaded);\n  }\n\n  private get idMaybe(): IdOf<U> | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (this._isLoaded) {\n      return this.loaded?.idMaybe as IdOf<U> | undefined;\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  get idTaggedMaybe(): TaggedId | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (this._isLoaded) {\n      return this.loaded?.idTaggedMaybe;\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  private get idUntaggedMaybe(): string | undefined {\n    return deTagId(this.otherMeta, this.idMaybe);\n  }\n\n  get isSet(): boolean {\n    if (this._isLoaded) {\n      return this.loaded !== undefined;\n    }\n    throw new Error(`${this.entity}.${this.fieldName} was not loaded`);\n  }\n\n  // opts is an internal parameter\n  async load(opts: { withDeleted?: boolean; forceReload?: boolean } = {}): Promise<U | undefined> {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (!this._isLoaded || opts.forceReload) {\n      if (!this.entity.isNewEntity) {\n        const joinLoaded = this.getPreloaded();\n        if (joinLoaded) {\n          this.loaded = joinLoaded[0];\n        } else {\n          try {\n            await oneToOneBatchLoader(this.entity.em, this).load(this.entity.idTagged);\n          } catch (err) {\n            throw appendStack(err as Error, new Error());\n          }\n          this.preload();\n        }\n      }\n      this._isLoaded = true;\n    }\n    return this.filterDeleted(this.loaded, opts);\n  }\n\n  set(other: U, opts: { percolating?: boolean } = {}): void {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#hasBeenSet = true;\n    if (other === this.loaded) {\n      this._isLoaded = true;\n      return;\n    }\n    if (this._isLoaded) {\n      if (this.loaded && !opts.percolating) {\n        this.getOtherRelation(this.loaded).set(undefined);\n      }\n    }\n    const { fieldLogger } = getEmInternalApi(this.entity.em);\n    fieldLogger.logSet(this.entity, this.fieldName, other);\n    this.loaded = other;\n    this._isLoaded = true;\n    // This will no-op and mark other dirty if necessary\n    if (other && !opts.percolating) {\n      this.getOtherRelation(other).set(this.entity);\n    }\n  }\n\n  get isLoaded(): boolean {\n    return this._isLoaded;\n  }\n\n  get isPreloaded(): boolean {\n    return !!this.getPreloaded();\n  }\n\n  preload(): void {\n    this.loaded = this.getPreloaded()?.[0];\n    this._isLoaded = true;\n  }\n\n  import(other: OneToOneReferenceImpl<T, U>, findEntity: (e: U) => U): void {\n    this.loaded = other.loaded ? findEntity(other.loaded) : undefined;\n    this._isLoaded = true;\n  }\n\n  get getWithDeleted(): U | undefined {\n    return this.filterDeleted(this.doGet(), { withDeleted: true });\n  }\n\n  get get(): U | undefined {\n    return this.filterDeleted(this.doGet(), { withDeleted: false });\n  }\n\n  get otherMeta(): EntityMetadata {\n    return this.#field.otherMetadata();\n  }\n\n  private doGet(): U | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (!this._isLoaded) {\n      // This should only be callable in the type system if we've already resolved this to an instance\n      throw new Error(\"get was called when not loaded\");\n    }\n    return this.loaded;\n  }\n\n  // internal impl\n\n  setFromOpts(other: U): void {\n    this.set(other);\n  }\n\n  maybeCascadeDelete(): void {\n    if (this.isCascadeDelete && this.loaded) {\n      this.entity.em.delete(this.loaded);\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 otherSide = this.getOtherRelation(current);\n      // Don't call `ReactiveReference.set` because it'll blow up\n      if (!isReactiveReference(otherSide)) {\n        otherSide.set(undefined as any);\n      }\n      setField(current, this.otherFieldName, undefined);\n    }\n    this.loaded = undefined as any;\n    this._isLoaded = true;\n  }\n\n  get hasBeenSet() {\n    return this.#hasBeenSet;\n  }\n\n  public toString(): string {\n    return `OneToOneReference(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.otherMeta.type}, otherFieldName: ${this.otherFieldName})`;\n  }\n\n  private filterDeleted(entity: U | undefined, opts?: { withDeleted?: boolean }): U | undefined {\n    return opts?.withDeleted === true || entity === undefined || !entity.isDeletedEntity ? entity : undefined;\n  }\n\n  /** Returns the other relation that points back at us, i.e. we're `Author.image` and this is `Image.author_id`. */\n  private getOtherRelation(other: U): ManyToOneReference<U, T, any> {\n    return (other as U)[this.otherFieldName] as any;\n  }\n\n  private getPreloaded(): U[] | undefined {\n    if (this.entity.isNewEntity) return undefined;\n    return getEmInternalApi(this.entity.em).getPreloadedRelation(this.entity.idTagged, this.fieldName);\n  }\n\n  private get isCascadeDelete(): boolean {\n    return isCascadeDelete(this, this.fieldName);\n  }\n\n  [RelationT] = null!;\n  [RelationU] = null!;\n  [ReferenceN] = null!;\n  [OneToOne] = null!;\n}\n"],"mappings":"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"}

package/build/relations/PolymorphicReference.cjs.map

@@ -1 +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":";;;;;;;;;;;;;;;;;;AAuBA,SAAgB,oBAImB;CACjC,OAAOA,kBAAAA,WAAW,QAAW,cAAc;EACzC,OAAO,IAAI,yBAAkC,QAAQ,SAA6B;CACpF,CAAC;AACH;;AAGA,SAAgB,uBAAuB,gBAA4E;CACjH,OAAO,0BAA0B;AACnC;;;;;;;;;;;;AAwCA,IAAa,2BAAb,cACUC,uCAAAA,qBAEV;CASW;CART;CAEA,YAAoB;CACpB;CACA,cAAc;CAEd,YACE,QACA,WACA;EACA,MAAM,MAAM;EAFL,KAAA,YAAA;EAGP,KAAK,QAAQC,uBAAAA,YAAY,MAAM,CAAC,CAAC,UAAU,KAAK;EAChD,IAAIC,mBAAAA,gBAAgB,MAAM,CAAC,CAAC,YAC1B,KAAK,YAAY;CAErB;CAEA,IAAY,mBAAkD;EAC5D,MAAM,OAAOC,kBAAAA,iCAAiC,KAAK,QAAQ,CAAC;EAC5D,OAAO,KAAK,MAAM,WAAW,MAAM,MAAM,EAAE,cAAc,CAAC,CAAC,SAAS,IAAI;CAC1E;CAEA,IAAY,kBAA2B;EACrC,OAAOC,kCAAAA,gBAAgB,MAAM,KAAK,SAAS;CAC7C;CAEA,MAAM,KAAK,OAAyD,CAAC,GAAmB;EACtF,cAAA,iBAAiB,KAAK,QAAQ,SAAS;EACvC,MAAM,UAAU,KAAK,QAAQ;EAE7B,IAAI,CAAC,KAAK,aAAa,KAAK,aAC1B,KAAK,SACHC,eAAAA,SAAS,OAAO,KAAK,YAAY,KAAA,IAC5B,UACC,MAAM,KAAK,OAAO,GAAG,KAAKC,kBAAAA,2BAA2B,OAAO,GAAG,OAAO;EAEhF,KAAK,YAAY;EACjB,OAAO,KAAK,cAAc,KAAK,QAAS,IAAI;CAC9C;CAEA,IAAI,OAAoB;EACtB,KAAK,QAAQ,KAAK;CACpB;CAEA,IAAI,QAAiB;EACnB,OAAO,KAAK,QAAQ,MAAM,KAAA;CAC5B;CAEA,IAAI,WAAoB;EACtB,OAAO,KAAK;CACd;;;;;CAMA,kBAAiC;EAE/B,MAAM,EAAE,kBAAkB;EAC1B,OAAO,KAAK,WAAW,kBAAkB,KAAA,IAAa,KAAK,OAAO,GAAG,UAAU,aAAa,IAAU,KAAA;CACxG;CAEA,IAAI,cAAuB;EACzB,OAAO,CAAC,CAAC,KAAK,gBAAgB;CAChC;CAEA,UAAgB;EACd,KAAK,SAAS,KAAK,gBAAgB;EACnC,KAAK,YAAY;CACnB;CAEA,SAAuB;EACrB,KAAK,SAAS,KAAA;EACd,KAAK,YAAY;CACnB;CAEA,OAAO,OAA0C,YAA+B;EAC9E,KAAK,SAAS,MAAM,SAAS,WAAW,MAAM,MAAM,IAAI,KAAA;EACxD,KAAK,YAAY;CACnB;CAEA,MAAc,MAAyC;EACrD,cAAA,iBAAiB,KAAK,QAAQ,SAAS;EAGvC,IAAI,CAAC,KAAK,WAAW;GACnB,MAAM,WAAW,KAAK,kBAAkB;GACxC,IAAI,aAAa,KAAA,GACf,MAAM,IAAI,MAAM,GAAG,KAAK,OAAO,GAAG,KAAK,UAAU,gBAAgB;GAEnE,KAAK,SAAS;GACd,KAAK,YAAY;EACnB;EAEA,OAAO,KAAK,cAAc,KAAK,QAAS,IAAI;CAC9C;CAEA,IAAI,iBAAwB;EAC1B,OAAO,KAAK,MAAM,EAAE,aAAa,KAAK,CAAC;CACzC;CAEA,IAAI,MAAa;EACf,OAAO,KAAK,MAAM,EAAE,aAAa,MAAM,CAAC;CAC1C;CAEA,IAAI,KAAc;EAChB,OAAO,KAAK,WAAWC,qCAAAA,SAAS,KAAK,QAAQ,KAAK,WAAW,KAAK,QAAQ,CAAC;CAC7E;CAEA,IAAI,UAA+B;EACjC,cAAA,iBAAiB,KAAK,QAAQ,SAAS;EACvC,OAAOC,aAAAA,0BAA0B,KAAK,QAAQ,CAAC;CACjD;CAEA,IAAI,UAAmC;EACrC,OAAO,KAAK,WAAWC,qCAAAA,gBAAgB,KAAK,QAAQ,KAAK,WAAW,KAAK,QAAQ,CAAC;CACpF;CAEA,IAAI,WAAmB;EACrB,OAAO,KAAK,iBAAiBF,qCAAAA,SAAS,KAAK,QAAQ,KAAK,WAAW,KAAK,QAAQ,CAAC;CACnF;CAEA,IAAI,gBAAoC;EACtC,cAAA,iBAAiB,KAAK,QAAQ,SAAS;EACvC,OAAOC,aAAAA,0BAA0B,KAAK,QAAQ,CAAC;CACjD;CAEA,IAAI,aAAa;EACf,OAAO,KAAKE;CACd;CAIA,YAAY,OAAgB;EAC1B,KAAK,QAAQ,KAAK;CACpB;CAEA,qBAA2B;EACzB,IAAI,KAAK,iBAAiB;GACxB,MAAM,UAAU,KAAK,QAAQ,EAAE,aAAa,KAAK,CAAC;GAClD,IAAI,YAAY,KAAA,KAAa,OAAO,YAAY,UAC9C,KAAK,OAAO,GAAG,OAAO,OAAY;EAEtC;CACF;CAEA,MAAM,yBAAwC;EAE5C,IAAI,KAAK,iBAAiB;EAC1B,MAAM,UAAU,MAAM,KAAK,KAAK,EAAE,aAAa,KAAK,CAAC;EACrD,IAAI,YAAY,KAAA,GAAW;GACzB,MAAM,MAAM,KAAK,iBAAiB,OAAO;GACzC,IAAI,eAAeC,sCAAAA,qBACjB,IAAI,OAAO,KAAK,QAAQ,EAAE,eAAe,MAAM,CAAC;QAEhD,IAAI,IAAI,KAAA,CAAgB;EAE5B;EACA,eAAA,SAAS,KAAK,QAAQ,KAAK,WAAW,KAAA,CAAS;EAC/C,KAAK,SAAS,KAAA;EACd,KAAK,YAAY;CACnB;CAGA,QAAQ,OAAoB;EAC1B,KAAKD,cAAc;EAEnB,IAAIE,sBAAAA,WAAW,OAAO,KAAK,QAAQ,EAAE,aAAa,KAAK,CAAC,CAAC,GACvD;EAGF,IACE,UAAU,KAAA,KACV,CAAC,KAAK,MAAM,WAAW,MACpB,MACC,iBAAiB,EAAE,cAAc,CAAC,CAAC,QAClC,OAAO,UAAU,YAAYN,kBAAAA,2BAA2B,KAAK,MAAM,EAAE,cAAc,CAAC,CAAC,IAC1F,GAEA,cAAA,KAAK,GAAG,MAAM,qBAAqB,KAAK,MAAM,UAAU,OAAO,KAAK,QAAQ;EAI9E,MAAM,iBAAiB,KAAK,UAAU,KAAK,kBAAkB;EAE7D,cAAA,iBAAiB,KAAK,QAAQ,SAAS;EAGvC,IAAID,eAAAA,SAAS,KAAK,GAAG;GACnB,MAAM,YAAYJ,uBAAAA,YAAY,KAAK;GACnC,MAAM,gCACJ,UAAU,YACV,KAAK,MAAM,WAAW,MACnB,cACC,UAAU,cAAc,CAAC,CAAC,aAAa,UAAU,YACjD,EAAE,iBAAiB,UAAU,cAAc,CAAC,CAAC,KACjD;GACF,eAAA,SACE,KAAK,QACL,KAAK,WACL,MAAM,eAAe,gCAAgC,QAAQ,MAAM,QACrE;EACF,OACE,eAAA,SAAS,KAAK,QAAQ,KAAK,WAAW,KAAK;EAG7C,IAAI,OAAO,UAAU,UAAU;GAC7B,KAAK,SAAS,KAAA;GACd,KAAK,YAAY;EACnB,OAAO;GACL,KAAK,SAAS;GACd,KAAK,YAAY;EACnB;EAGA,IAAI,gBAAgB;GAClB,MAAM,eAAe,KAAK,iBAAiB,cAAc;GACzD,IAAI,wBAAwBU,sCAAAA,qBAC1B,aAAa,eAAe,KAAK,MAAM;QAEvC,aAAa,IAAI,KAAA,CAAgB;EAErC;EACA,IAAI,UAAU,KAAA,KAAaN,eAAAA,SAAS,KAAK,GAAG;GAC1C,MAAM,cAAc,KAAK,iBAAiB,KAAK;GAC/C,IAAI,uBAAuBM,sCAAAA,qBACzB,YAAY,IAAI,KAAK,MAAM;QAE3B,YAAY,IAAI,KAAK,MAAM;EAE/B;CACF;CAGA,QAAQ,MAAoD;EAC1D,MAAM,UAAUE,eAAAA,SAAS,KAAK,QAAQ,KAAK,SAAS;EACpD,IAAI,YAAY,KAAA,KAAaR,eAAAA,SAAS,OAAO,GAC3C,OAAO,KAAK,cAAc,SAAc,IAAI;EAE9C,OAAO;CACT;CAEA,WAA0B;EACxB,OAAO,gCAAgC,KAAK,OAAO,eACjD,KAAK,UACN,eAAe,KAAK,kBAAkB,cAAc,CAAC,CAAC,KAAK,oBAC1D,KAAK,kBAAkB,eACxB,QAAQ,KAAK,GAAG;CACnB;CAEA,cAAsB,QAAe,MAAyC;EAC5E,OAAO,MAAM,gBAAgB,QAAQ,WAAW,KAAA,KAAa,CAAC,OAAO,kBAAkB,SAAU,KAAA;CACnG;;CAGA,iBAAyB,OAA+D;EAEtF,OAAQ,MADU,KAAK,MAAM,WAAW,MAAM,MAAM,iBAAiB,EAAE,cAAc,CAAC,CAAC,IAC3D,CAAC,EAAE;CACjC;CAEA,oBAA2C;EACzC,OAAO,KAAK,kBAAkB,KAAA,IAAa,KAAK,OAAO,GAAG,UAAU,KAAK,QAAQ,IAAU,KAAA;CAC7F;CAEA,CAACS,kCAAAA,aAAgB;CACjB,CAACC,kCAAAA,aAAgB;CACjB,CAACC,mCAAAA,cAAiB;AACpB"}
+{"version":3,"file":"PolymorphicReference.cjs","names":["lazyField","AbstractRelationImpl","getMetadata","getInstanceData","maybeGetConstructorFromReference","isCascadeDelete","isEntity","getConstructorFromTaggedId","failNoId","maybeResolveReferenceToId","failIfNewEntity","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

@@ -6,9 +6,9 @@ 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>;
+export 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>;
+export declare function isPolymorphicReference(maybeReference: any): maybeReference is PolymorphicReference<any, any, any>;
 /**
  * A reference that can be assigned to multiple different entity types.
  *
@@ -16,7 +16,7 @@ declare function isPolymorphicReference(maybeReference: any): maybeReference is
  *
  * 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> {
+export 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. */
@@ -38,7 +38,7 @@ interface PolymorphicReference<T extends Entity, U extends Entity, N extends nev
  * 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> {
+export 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;
@@ -89,5 +89,4 @@ declare class PolymorphicReferenceImpl<T extends Entity, U extends Entity, N ext
   [ReferenceN]: N;
 }
 //#endregion
-export { PolymorphicReference, PolymorphicReferenceImpl, hasOnePolymorphic, isPolymorphicReference };
 //# sourceMappingURL=PolymorphicReference.d.cts.map

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

@@ -1 +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"}
+{"version":3,"file":"PolymorphicReference.d.cts","names":[],"sources":["../../src/relations/PolymorphicReference.ts"],"mappings":";;;;;;;;wBAuBgB,kBACd,UAAU,QACV,UAAU,QACV,gCACG,qBAAqB,GAAG,GAAG;;wBAOhB,uBAAuB,sBAAsB,kBAAkB;;;;;;;;iBAW9D,qBACf,UAAU,QACV,UAAU,QACV,qCACQ,UAAU,GAAG,GAAG;;EAExB,IAAI,KAAK;;EAGT,SAAS,KAAK;;EAGd,SAAS,KAAK;EAEd;;WAGS;;;;;;;;;;;;;qBAcE,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

@@ -6,9 +6,9 @@ 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>;
+export 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>;
+export declare function isPolymorphicReference(maybeReference: any): maybeReference is PolymorphicReference<any, any, any>;
 /**
  * A reference that can be assigned to multiple different entity types.
  *
@@ -16,7 +16,7 @@ declare function isPolymorphicReference(maybeReference: any): maybeReference is
  *
  * 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> {
+export 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. */
@@ -38,7 +38,7 @@ interface PolymorphicReference<T extends Entity, U extends Entity, N extends nev
  * 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> {
+export 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;
@@ -89,5 +89,4 @@ declare class PolymorphicReferenceImpl<T extends Entity, U extends Entity, N ext
   [ReferenceN]: N;
 }
 //#endregion
-export { PolymorphicReference, PolymorphicReferenceImpl, hasOnePolymorphic, isPolymorphicReference };
 //# sourceMappingURL=PolymorphicReference.d.mts.map

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

@@ -1 +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"}
+{"version":3,"file":"PolymorphicReference.d.mts","names":[],"sources":["../../src/relations/PolymorphicReference.ts"],"mappings":";;;;;;;;wBAuBgB,kBACd,UAAU,QACV,UAAU,QACV,gCACG,qBAAqB,GAAG,GAAG;;wBAOhB,uBAAuB,sBAAsB,kBAAkB;;;;;;;;iBAW9D,qBACf,UAAU,QACV,UAAU,QACV,qCACQ,UAAU,GAAG,GAAG;;EAExB,IAAI,KAAK;;EAGT,SAAS,KAAK;;EAGd,SAAS,KAAK;EAEd;;WAGS;;;;;;;;;;;;;qBAcE,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.js.map

@@ -1 +1 @@
-{"version":3,"file":"PolymorphicReference.js","names":["#hasBeenSet"],"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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"}
+{"version":3,"file":"PolymorphicReference.js","names":[],"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/PropertySymbols.d.cts

@@ -1,5 +1,4 @@
 //#region src/relations/PropertySymbols.d.ts
-declare const PropertyT: unique symbol;
+export declare const PropertyT: unique symbol;
 //#endregion
-export { PropertyT };
 //# sourceMappingURL=PropertySymbols.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PropertySymbols.d.cts","names":[],"sources":["../../src/relations/PropertySymbols.ts"],"mappings":";cAAa"}
+{"version":3,"file":"PropertySymbols.d.cts","names":[],"sources":["../../src/relations/PropertySymbols.ts"],"mappings":";qBAAa"}

package/build/relations/PropertySymbols.d.mts

@@ -1,5 +1,4 @@
 //#region src/relations/PropertySymbols.d.ts
-declare const PropertyT: unique symbol;
+export declare const PropertyT: unique symbol;
 //#endregion
-export { PropertyT };
 //# sourceMappingURL=PropertySymbols.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PropertySymbols.d.mts","names":[],"sources":["../../src/relations/PropertySymbols.ts"],"mappings":";cAAa"}
+{"version":3,"file":"PropertySymbols.d.mts","names":[],"sources":["../../src/relations/PropertySymbols.ts"],"mappings":";qBAAa"}