joist-core 2.4.0-next.4 → 2.4.0-next.41

package/build/relations/ManyToManyCollection.d.mts

@@ -7,8 +7,8 @@ import { IdOf } from "../EntityManager.mjs";
 import { Entity } from "../Entity.mjs";
 //#region src/relations/ManyToManyCollection.d.ts
 /** An alias for creating `ManyToManyCollections`s. */
-declare function hasManyToMany<T extends Entity, U extends Entity>(): Collection<T, U>;
-declare class ManyToManyCollection<T extends Entity, U extends Entity> extends AbstractRelationImpl<T, U[]> implements Collection<T, U> {
+export declare function hasManyToMany<T extends Entity, U extends Entity>(): Collection<T, U>;
+export declare class ManyToManyCollection<T extends Entity, U extends Entity> extends AbstractRelationImpl<T, U[]> implements Collection<T, U> {
   #private;
   constructor(entity: T, field: ManyToManyField);
   /** @internal */
@@ -55,5 +55,4 @@ declare class ManyToManyCollection<T extends Entity, U extends Entity> extends A
   [RelationU]: U;
 }
 //#endregion
-export { ManyToManyCollection, hasManyToMany };
 //# sourceMappingURL=ManyToManyCollection.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ManyToManyCollection.d.mts","names":[],"sources":["../../src/relations/ManyToManyCollection.ts"],"mappings":";;;;;;;;;iBAuBgB,cAAc,UAAU,QAAQ,UAAU,WAAW,WAAW,GAAG;cAOtE,qBAAqB,UAAU,QAAQ,UAAU,gBACpD,qBAAqB,GAAG,gBACrB,WAAW,GAAG;;EAWzB,YAAY,QAAQ,GAAG,OAAO;;EAW9B,aAAa,OAAO;;EAKpB,gBAAgB,OAAO;;EAKvB,mBAAmB,OAAO;;EAK1B,sBAAsB,OAAO;;UAKrB;EAOF,KAAK;IAAQ;IAAuB;MAA+B,QAAQ,cAAc;EAqBzF,KAAK,IAAI,KAAK,KAAK,QAAQ;EAe3B,SAAS,OAAO,IAAI;EAa1B,IAAI,OAAO,GAAG;EAKd,OAAO,OAAO,GAAG;MAKb;MAIA;EAIJ;EAOA,OAAO,OAAO,qBAAqB,GAAG,IAAI,YAAY,cAAc,GAAG,oBAAoB;UAInF;MAKJ,kBAAkB;MAIlB,OAAO;EAIX,IAAI,iBAAiB;EAKrB;EAYA,YAAY,QAAQ;EAKpB;EAQM,0BAA0B;MAY5B,QAAQ;MAIR,aAAa;MAIb;MAIA;MAIA,iCAAiC;MAIjC;MAIA;MAIA;MAQA;EAIJ;GASC,YAAY;GACZ,YAAY"}
+{"version":3,"file":"ManyToManyCollection.d.mts","names":[],"sources":["../../src/relations/ManyToManyCollection.ts"],"mappings":";;;;;;;;;wBAuBgB,cAAc,UAAU,QAAQ,UAAU,WAAW,WAAW,GAAG;qBAOtE,qBAAqB,UAAU,QAAQ,UAAU,gBACpD,qBAAqB,GAAG,gBACrB,WAAW,GAAG;;EAWzB,YAAY,QAAQ,GAAG,OAAO;;EAW9B,aAAa,OAAO;;EAKpB,gBAAgB,OAAO;;EAKvB,mBAAmB,OAAO;;EAK1B,sBAAsB,OAAO;;UAKrB;EAOF,KAAK;IAAQ;IAAuB;MAA+B,QAAQ,cAAc;EAqBzF,KAAK,IAAI,KAAK,KAAK,QAAQ;EAe3B,SAAS,OAAO,IAAI;EAa1B,IAAI,OAAO,GAAG;EAKd,OAAO,OAAO,GAAG;MAKb;MAIA;EAIJ;EAOA,OAAO,OAAO,qBAAqB,GAAG,IAAI,YAAY,cAAc,GAAG,oBAAoB;UAInF;MAKJ,kBAAkB;MAIlB,OAAO;EAIX,IAAI,iBAAiB;EAKrB;EAYA,YAAY,QAAQ;EAKpB;EAQM,0BAA0B;MAY5B,QAAQ;MAIR,aAAa;MAIb;MAIA;MAIA,iCAAiC;MAIjC;MAIA;MAIA;MAQA;EAIJ;GASC,YAAY;GACZ,YAAY"}

package/build/relations/ManyToManyCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"ManyToManyCollection.js","names":["#field","#state","#getPreloaded","#loadPromise","#isCascadeDelete","#m2m","#added","#removed","#pendingSet","#loaded","#hasBeenSet"],"sources":["../../src/relations/ManyToManyCollection.ts"],"sourcesContent":["import { manyToManyBatchLoader } from \"src/batchloaders/manyToManyBatchLoader.ts\";\nimport { manyToManyFindDataLoader } from \"src/dataloaders/manyToManyFindDataLoader.ts\";\nimport {\n  type Collection,\n  type Entity,\n  type EntityMetadata,\n  type IdOf,\n  type ManyToManyField,\n  appendStack,\n  ensureNotDeleted,\n  getEmInternalApi,\n  getInstanceData,\n  getMetadata,\n  getMetadataForField,\n  toTaggedId,\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 { RelationT, RelationU } from \"src/relations/RelationSymbols.ts\";\nimport { maybeAdd, maybeRemove, remove } from \"src/utils.ts\";\n\n/** An alias for creating `ManyToManyCollections`s. */\nexport function hasManyToMany<T extends Entity, U extends Entity>(): Collection<T, U> {\n  return lazyField((entity: T, fieldName) => {\n    const m2m = getMetadata(entity).allFields[fieldName] as ManyToManyField;\n    return new ManyToManyCollection<T, U>(entity, m2m);\n  });\n}\n\nexport class ManyToManyCollection<T extends Entity, U extends Entity>\n  extends AbstractRelationImpl<T, U[]>\n  implements Collection<T, U>\n{\n  readonly #field: ManyToManyField;\n  #loadPromise: any;\n  #state: M2MState<T, U>;\n\n  // I.e. when entity = Book:\n  // fieldName == tags, because it's our collection to tags\n  // columnName = book_id, what we use as the `where book_id = us` to find our join table rows\n  // otherFieldName = books, how tags points to us\n  // otherColumnName = tag_id, how the other side finds its join table rows\n  constructor(entity: T, field: ManyToManyField) {\n    super(entity);\n    this.#field = field;\n    if (getInstanceData(entity).isOrWasNew) {\n      this.#state = new LoadedState<T, U>(this, [], false);\n    } else {\n      this.#state = new UnloadedPristineState<T, U>(this);\n    }\n  }\n\n  /** @internal */\n  percolateAdd(other: U): void {\n    (other[this.otherFieldName] as any as ManyToManyCollection<U, T>).add(this.entity, true);\n  }\n\n  /** @internal */\n  percolateRemove(other: U): void {\n    (other[this.otherFieldName] as any as ManyToManyCollection<U, T>).remove(this.entity, true);\n  }\n\n  /** @internal */\n  registerJoinRowAdd(other: U): void {\n    getEmInternalApi(this.entity.em).joinRows(this).addNew(this, this.entity, other);\n  }\n\n  /** @internal */\n  registerJoinRowRemove(other: U): void {\n    getEmInternalApi(this.entity.em).joinRows(this).addRemove(this, this.entity, other);\n  }\n\n  /** Removes pending-hard-delete or soft-deleted entities, unless explicitly asked for. */\n  private filterDeleted(entities: U[], opts?: { withDeleted?: boolean }): U[] {\n    if (opts?.withDeleted === true) return [...entities];\n    // Relations configured with `softDeletes: \"include\"` keep soft-deleted entities in `.get`/`.load`.\n    const includeSoftDeleted = this.#field.softDeletes === \"include\";\n    return entities.filter((e) => !e.isDeletedEntity && (includeSoftDeleted || !(e as any).isSoftDeletedEntity));\n  }\n\n  async load(opts: { withDeleted?: boolean; forceReload?: boolean } = {}): Promise<ReadonlyArray<U>> {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (!this.#state.isLoaded || (opts.forceReload && !this.entity.isNewEntity)) {\n      const key = `${this.columnName}=${this.entity.id}`;\n      const maybePreloaded = this.#getPreloaded();\n      if (maybePreloaded) {\n        this.#state = this.#state.applyLoad(maybePreloaded);\n      } else {\n        await (this.#loadPromise ??= manyToManyBatchLoader(this.entity.em, this).load(key))\n          .then(() => this.preload())\n          .catch(function load(err: any) {\n            throw appendStack(err, new Error());\n          })\n          .finally(() => {\n            this.#loadPromise = undefined;\n          });\n      }\n    }\n    return this.filterDeleted(this.#state.doGet(), opts) as ReadonlyArray<U>;\n  }\n\n  async find(id: IdOf<U>): Promise<U | undefined> {\n    ensureNotDeleted(this.entity, \"pending\");\n    const inMemory = this.#state.find(id);\n    if (inMemory) return inMemory;\n    if (this.#state.isLoaded) return undefined;\n    const key = `${this.columnName}=${this.entity.id},${this.otherColumnName}=${id}`;\n    const includes = await manyToManyFindDataLoader(this.entity.em, this)\n      .load(key)\n      .catch(function load(err) {\n        throw appendStack(err, new Error());\n      });\n    const taggedId = toTaggedId(this.otherMeta, id);\n    return includes ? (this.entity.em.load(taggedId) as Promise<U>) : undefined;\n  }\n\n  async includes(other: U): Promise<boolean> {\n    ensureNotDeleted(this.entity, \"pending\");\n    const inMemory = this.#state.includesInMemory(other);\n    if (inMemory !== undefined) return inMemory;\n    if (other.isNewEntity) return false;\n    const key = `${this.columnName}=${this.entity.id},${this.otherColumnName}=${other.id}`;\n    return manyToManyFindDataLoader(this.entity.em, this)\n      .load(key)\n      .catch(function includes(err) {\n        throw appendStack(err, new Error());\n      });\n  }\n\n  add(other: U, percolated = false): void {\n    ensureNotDeleted(this.entity);\n    this.#state = this.#state.add(other, percolated);\n  }\n\n  remove(other: U, percolated = false): void {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#state = this.#state.remove(other, percolated);\n  }\n\n  get isLoaded(): boolean {\n    return this.#state.isLoaded;\n  }\n\n  get isPreloaded(): boolean {\n    return !!this.#getPreloaded();\n  }\n\n  preload(): void {\n    const preloaded = this.#getPreloaded();\n    if (preloaded) {\n      this.#state = this.#state.applyLoad(preloaded);\n    }\n  }\n\n  import(other: ManyToManyCollection<T, U>, _: unknown, mapEntities: (e: U[] | undefined) => U[] | undefined): void {\n    this.#state = other.#state.import(this, mapEntities);\n  }\n\n  private doGet(): U[] {\n    ensureNotDeleted(this.entity, \"pending\");\n    return this.#state.doGet();\n  }\n\n  get getWithDeleted(): U[] {\n    return this.filterDeleted(this.doGet(), { withDeleted: true });\n  }\n\n  get get(): U[] {\n    return this.filterDeleted(this.doGet(), { withDeleted: false });\n  }\n\n  set(values: readonly U[]): void {\n    ensureNotDeleted(this.entity);\n    this.#state = this.#state.set(values);\n  }\n\n  removeAll(): void {\n    ensureNotDeleted(this.entity);\n    if (!this.#state.isLoaded) {\n      throw new Error(\"removeAll was called when not loaded\");\n    }\n    for (const other of [...this.#state.doGet()]) {\n      this.remove(other);\n    }\n  }\n\n  // impl details\n\n  setFromOpts(others: U[]): void {\n    this.#state = new LoadedState<T, U>(this, [], false);\n    others.forEach((o) => this.add(o));\n  }\n\n  maybeCascadeDelete() {\n    if (this.#isCascadeDelete) {\n      this.filterDeleted(this.#state.current({ withDeleted: true }), { withDeleted: true }).forEach((e) =>\n        this.entity.em.delete(e),\n      );\n    }\n  }\n\n  async cleanupOnEntityDeleted(): Promise<void> {\n    if (this.#isCascadeDelete) return;\n    const entities = await this.load({ withDeleted: true });\n    entities.forEach((other) => {\n      const m2m = other[this.otherFieldName] as any as ManyToManyCollection<U, T>;\n      m2m.remove(this.entity);\n    });\n    if (this.#state instanceof LoadedState) {\n      this.#state.setLoaded([]);\n    }\n  }\n\n  get meta(): EntityMetadata {\n    return getMetadataForField(getMetadata(this.entity), this.fieldName);\n  }\n\n  get otherMeta(): EntityMetadata {\n    return this.#field.otherMetadata();\n  }\n\n  get joinTableName(): string {\n    return this.#field.joinTableName;\n  }\n\n  get fieldName(): string {\n    return this.#field.fieldName;\n  }\n\n  get otherFieldName(): string & keyof U {\n    return this.#field.otherFieldName as string & keyof U;\n  }\n\n  get columnName(): string {\n    return this.#field.columnNames[0];\n  }\n\n  get otherColumnName(): string {\n    return this.#field.columnNames[1];\n  }\n\n  get hasJoinTableId(): boolean {\n    return this.#field.hasJoinTableId;\n  }\n\n  get #isCascadeDelete(): boolean {\n    return isCascadeDelete(this, this.fieldName);\n  }\n\n  get hasBeenSet(): boolean {\n    return this.#state.hasBeenSet;\n  }\n\n  toString(): string {\n    return `OneToManyCollection(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.otherMeta.type}, otherFieldName: ${this.otherFieldName})`;\n  }\n\n  #getPreloaded(): U[] | undefined {\n    if (this.entity.isNewEntity) return undefined;\n    return getEmInternalApi(this.entity.em).getPreloadedRelation<U>(this.entity.idTagged, this.fieldName);\n  }\n\n  [RelationT]: T = null!;\n  [RelationU]: U = null!;\n}\n\n/**\n * State interface for ManyToManyCollection state machine.\n *\n * State transitions:\n * ```\n * Constructor (existing entity) → UnloadedPristine\n * Constructor (new entity)      → Loaded\n *\n * UnloadedPristine + add/remove → UnloadedAddedRemoved\n * UnloadedPristine + set        → PendingSet\n * UnloadedPristine + applyLoad  → Loaded\n *\n * UnloadedAddedRemoved + set       → PendingSet\n * UnloadedAddedRemoved + applyLoad → Loaded (merges tracked adds/removes)\n *\n * PendingSet + applyLoad → Loaded (diffs pending values against DB)\n *\n * Loaded + applyLoad (forceReload) → Loaded (refreshed)\n * ```\n */\ninterface M2MState<T extends Entity, U extends Entity> {\n  /** Adds an entity; may transition UnloadedPristine → UnloadedAddedRemoved. */\n  add(other: U, percolated: boolean): M2MState<T, U>;\n  /** Removes an entity; may transition UnloadedPristine → UnloadedAddedRemoved. */\n  remove(other: U, percolated: boolean): M2MState<T, U>;\n  /** Sets the collection; transitions UnloadedPristine/UnloadedAddedRemoved → PendingSet. */\n  set(values: readonly U[]): M2MState<T, U>;\n  /** Returns the current entities; throws if not loaded (except PendingSet returns pending values). */\n  doGet(): U[];\n  /** Finds an entity by id in memory; returns undefined if not found or not tracked. */\n  find(id: IdOf<U>): U | undefined;\n  /** Checks if entity is in memory; returns undefined if async lookup needed. */\n  includesInMemory(other: U): boolean | undefined;\n  /** Applies loaded DB entities; always transitions to Loaded. */\n  applyLoad(dbEntities: U[]): LoadedState<T, U>;\n  /** Returns current entities for cascade delete (works in any state). */\n  current(opts?: { withDeleted?: boolean }): U[];\n  /** Creates a copy of this state for a different collection (used by em.clone). */\n  import(m2m: ManyToManyCollection<T, U>, mapEntities: (e: U[] | undefined) => U[] | undefined): M2MState<T, U>;\n  readonly isLoaded: boolean;\n  readonly hasBeenSet: boolean;\n}\n\n/** Initial state for existing entities - no data loaded yet. */\nclass UnloadedPristineState<T extends Entity, U extends Entity> implements M2MState<T, U> {\n  readonly isLoaded = false;\n  readonly hasBeenSet = false;\n  #m2m: ManyToManyCollection<T, U>;\n\n  constructor(m2m: ManyToManyCollection<T, U>) {\n    this.#m2m = m2m;\n  }\n\n  add(other: U, percolated: boolean): M2MState<T, U> {\n    const newState = new UnloadedAddedRemovedState<T, U>(this.#m2m, [other], []);\n    if (!percolated) {\n      this.#m2m.registerJoinRowAdd(other);\n      this.#m2m.percolateAdd(other);\n    }\n    return newState;\n  }\n\n  remove(other: U, percolated: boolean): M2MState<T, U> {\n    if (!percolated) {\n      this.#m2m.registerJoinRowRemove(other);\n      this.#m2m.percolateRemove(other);\n    }\n    return new UnloadedAddedRemovedState<T, U>(this.#m2m, [], [other]);\n  }\n\n  set(values: readonly U[]): M2MState<T, U> {\n    return new PendingSetState<T, U>(this.#m2m, [...values]);\n  }\n\n  doGet(): U[] {\n    throw new Error(`${this.#m2m.entity}.${this.#m2m.fieldName}.get was called when not loaded`);\n  }\n\n  find(_id: IdOf<U>): U | undefined {\n    return undefined;\n  }\n\n  includesInMemory(_other: U): boolean | undefined {\n    return undefined;\n  }\n\n  applyLoad(dbEntities: U[]): LoadedState<T, U> {\n    return new LoadedState<T, U>(this.#m2m, dbEntities, false);\n  }\n\n  current(_opts?: { withDeleted?: boolean }): U[] {\n    return [];\n  }\n\n  import(m2m: ManyToManyCollection<T, U>, _mapEntities: (e: U[] | undefined) => U[] | undefined): M2MState<T, U> {\n    return new UnloadedPristineState<T, U>(m2m);\n  }\n}\n\n/** State when add/remove called before load - tracks changes to merge later. */\nclass UnloadedAddedRemovedState<T extends Entity, U extends Entity> implements M2MState<T, U> {\n  readonly isLoaded = false;\n  readonly hasBeenSet = false;\n  #m2m: ManyToManyCollection<T, U>;\n  #added: U[];\n  #removed: U[];\n\n  constructor(m2m: ManyToManyCollection<T, U>, added: U[], removed: U[]) {\n    this.#m2m = m2m;\n    this.#added = added;\n    this.#removed = removed;\n  }\n\n  add(other: U, percolated: boolean): M2MState<T, U> {\n    maybeRemove(this.#removed, other);\n    if (!this.#added.includes(other)) {\n      this.#added.push(other);\n    }\n    if (!percolated) {\n      this.#m2m.registerJoinRowAdd(other);\n      this.#m2m.percolateAdd(other);\n    }\n    return this;\n  }\n\n  remove(other: U, percolated: boolean): M2MState<T, U> {\n    if (!percolated) {\n      this.#m2m.registerJoinRowRemove(other);\n      this.#m2m.percolateRemove(other);\n    }\n    maybeRemove(this.#added, other);\n    maybeAdd(this.#removed, other);\n    return this;\n  }\n\n  set(values: readonly U[]): M2MState<T, U> {\n    return new PendingSetState<T, U>(this.#m2m, [...values]);\n  }\n\n  doGet(): U[] {\n    throw new Error(`${this.#m2m.entity}.${this.#m2m.fieldName}.get was called when not loaded`);\n  }\n\n  find(id: IdOf<U>): U | undefined {\n    return this.#added.find((u) => u.id === id);\n  }\n\n  includesInMemory(other: U): boolean | undefined {\n    if (this.#added.includes(other)) return true;\n    return undefined;\n  }\n\n  applyLoad(dbEntities: U[]): LoadedState<T, U> {\n    const loaded = [...dbEntities];\n    for (const e of this.#added) {\n      if (!loaded.includes(e)) {\n        loaded.unshift(e);\n        this.#m2m.registerJoinRowAdd(e);\n      }\n    }\n    for (const e of this.#removed) {\n      remove(loaded, e);\n      this.#m2m.registerJoinRowRemove(e);\n    }\n    return new LoadedState<T, U>(this.#m2m, loaded, false);\n  }\n\n  current(_opts?: { withDeleted?: boolean }): U[] {\n    return this.#added;\n  }\n\n  import(m2m: ManyToManyCollection<T, U>, mapEntities: (e: U[] | undefined) => U[] | undefined): M2MState<T, U> {\n    const added = mapEntities(this.#added);\n    const removed = mapEntities(this.#removed);\n    return new UnloadedAddedRemovedState<T, U>(m2m, added ?? [], removed ?? []);\n  }\n}\n\n/** State when set() called before load - holds pending values to diff on load. */\nclass PendingSetState<T extends Entity, U extends Entity> implements M2MState<T, U> {\n  readonly isLoaded = false;\n  readonly hasBeenSet = true;\n  #m2m: ManyToManyCollection<T, U>;\n  #pendingSet: U[];\n\n  constructor(m2m: ManyToManyCollection<T, U>, pendingSet: U[]) {\n    this.#m2m = m2m;\n    this.#pendingSet = pendingSet;\n    getEmInternalApi(m2m.entity.em).pendingLoads.add(m2m);\n  }\n\n  add(other: U, percolated: boolean): M2MState<T, U> {\n    if (!this.#pendingSet.includes(other)) {\n      this.#pendingSet.push(other);\n    }\n    if (!percolated) {\n      this.#m2m.registerJoinRowAdd(other);\n      this.#m2m.percolateAdd(other);\n    }\n    return this;\n  }\n\n  remove(other: U, percolated: boolean): M2MState<T, U> {\n    if (!percolated) {\n      this.#m2m.registerJoinRowRemove(other);\n      this.#m2m.percolateRemove(other);\n    }\n    remove(this.#pendingSet, other);\n    return this;\n  }\n\n  set(values: readonly U[]): M2MState<T, U> {\n    this.#pendingSet = [...values];\n    return this;\n  }\n\n  doGet(): U[] {\n    return this.#pendingSet;\n  }\n\n  find(id: IdOf<U>): U | undefined {\n    return this.#pendingSet.find((u) => u.id === id);\n  }\n\n  includesInMemory(other: U): boolean | undefined {\n    return this.#pendingSet.includes(other);\n  }\n\n  applyLoad(dbEntities: U[]): LoadedState<T, U> {\n    const loaded = [...dbEntities];\n    const pending = this.#pendingSet;\n    for (const other of [...loaded]) {\n      if (!pending.includes(other)) {\n        remove(loaded, other);\n        this.#m2m.registerJoinRowRemove(other);\n        this.#m2m.percolateRemove(other);\n      }\n    }\n    for (const other of pending) {\n      if (!loaded.includes(other)) {\n        loaded.push(other);\n        this.#m2m.registerJoinRowAdd(other);\n        this.#m2m.percolateAdd(other);\n      }\n    }\n    return new LoadedState<T, U>(this.#m2m, loaded, true);\n  }\n\n  current(_opts?: { withDeleted?: boolean }): U[] {\n    return this.#pendingSet;\n  }\n\n  import(m2m: ManyToManyCollection<T, U>, mapEntities: (e: U[] | undefined) => U[] | undefined): M2MState<T, U> {\n    const pendingSet = mapEntities(this.#pendingSet);\n    return new PendingSetState<T, U>(m2m, pendingSet ?? []);\n  }\n}\n\n/** State when collection is loaded - all operations work directly on loaded array. */\nclass LoadedState<T extends Entity, U extends Entity> implements M2MState<T, U> {\n  readonly isLoaded = true;\n  #m2m: ManyToManyCollection<T, U>;\n  #loaded: U[];\n  #hasBeenSet: boolean;\n\n  constructor(m2m: ManyToManyCollection<T, U>, loaded: U[], hasBeenSet: boolean) {\n    this.#m2m = m2m;\n    this.#loaded = loaded;\n    this.#hasBeenSet = hasBeenSet;\n  }\n\n  get hasBeenSet(): boolean {\n    return this.#hasBeenSet;\n  }\n\n  add(other: U, percolated: boolean): M2MState<T, U> {\n    if (this.#loaded.includes(other)) return this;\n    this.#loaded.push(other);\n    if (!percolated) {\n      this.#m2m.registerJoinRowAdd(other);\n      this.#m2m.percolateAdd(other);\n    }\n    return this;\n  }\n\n  remove(other: U, percolated: boolean): M2MState<T, U> {\n    if (!percolated) {\n      this.#m2m.registerJoinRowRemove(other);\n      this.#m2m.percolateRemove(other);\n    }\n    remove(this.#loaded, other);\n    return this;\n  }\n\n  set(values: readonly U[]): M2MState<T, U> {\n    this.#hasBeenSet = true;\n    const loaded = new Set(this.#loaded);\n    const valuesSet = new Set(values);\n    for (const other of loaded) {\n      if (!valuesSet.has(other)) {\n        this.remove(other, false);\n      }\n    }\n    for (const other of values) {\n      if (!loaded.has(other)) {\n        this.add(other, false);\n      }\n    }\n    return this;\n  }\n\n  doGet(): U[] {\n    return this.#loaded;\n  }\n\n  find(id: IdOf<U>): U | undefined {\n    return this.#loaded.find((u) => u.id === id);\n  }\n\n  includesInMemory(other: U): boolean | undefined {\n    return this.#loaded.includes(other);\n  }\n\n  applyLoad(dbEntities: U[]): LoadedState<T, U> {\n    this.#loaded = dbEntities;\n    return this;\n  }\n\n  current(_opts?: { withDeleted?: boolean }): U[] {\n    return this.#loaded;\n  }\n\n  import(m2m: ManyToManyCollection<T, U>, mapEntities: (e: U[] | undefined) => U[] | undefined): M2MState<T, U> {\n    const loaded = mapEntities(this.#loaded);\n    return new LoadedState<T, U>(m2m, loaded ?? [], this.#hasBeenSet);\n  }\n\n  getLoaded(): U[] {\n    return this.#loaded;\n  }\n\n  setLoaded(entities: U[]): void {\n    this.#loaded = entities;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"ManyToManyCollection.js","names":[],"sources":["../../src/relations/ManyToManyCollection.ts"],"sourcesContent":["import { manyToManyBatchLoader } from \"src/batchloaders/manyToManyBatchLoader.ts\";\nimport { manyToManyFindDataLoader } from \"src/dataloaders/manyToManyFindDataLoader.ts\";\nimport {\n  type Collection,\n  type Entity,\n  type EntityMetadata,\n  type IdOf,\n  type ManyToManyField,\n  appendStack,\n  ensureNotDeleted,\n  getEmInternalApi,\n  getInstanceData,\n  getMetadata,\n  getMetadataForField,\n  toTaggedId,\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 { RelationT, RelationU } from \"src/relations/RelationSymbols.ts\";\nimport { maybeAdd, maybeRemove, remove } from \"src/utils.ts\";\n\n/** An alias for creating `ManyToManyCollections`s. */\nexport function hasManyToMany<T extends Entity, U extends Entity>(): Collection<T, U> {\n  return lazyField((entity: T, fieldName) => {\n    const m2m = getMetadata(entity).allFields[fieldName] as ManyToManyField;\n    return new ManyToManyCollection<T, U>(entity, m2m);\n  });\n}\n\nexport class ManyToManyCollection<T extends Entity, U extends Entity>\n  extends AbstractRelationImpl<T, U[]>\n  implements Collection<T, U>\n{\n  readonly #field: ManyToManyField;\n  #loadPromise: any;\n  #state: M2MState<T, U>;\n\n  // I.e. when entity = Book:\n  // fieldName == tags, because it's our collection to tags\n  // columnName = book_id, what we use as the `where book_id = us` to find our join table rows\n  // otherFieldName = books, how tags points to us\n  // otherColumnName = tag_id, how the other side finds its join table rows\n  constructor(entity: T, field: ManyToManyField) {\n    super(entity);\n    this.#field = field;\n    if (getInstanceData(entity).isOrWasNew) {\n      this.#state = new LoadedState<T, U>(this, [], false);\n    } else {\n      this.#state = new UnloadedPristineState<T, U>(this);\n    }\n  }\n\n  /** @internal */\n  percolateAdd(other: U): void {\n    (other[this.otherFieldName] as any as ManyToManyCollection<U, T>).add(this.entity, true);\n  }\n\n  /** @internal */\n  percolateRemove(other: U): void {\n    (other[this.otherFieldName] as any as ManyToManyCollection<U, T>).remove(this.entity, true);\n  }\n\n  /** @internal */\n  registerJoinRowAdd(other: U): void {\n    getEmInternalApi(this.entity.em).joinRows(this).addNew(this, this.entity, other);\n  }\n\n  /** @internal */\n  registerJoinRowRemove(other: U): void {\n    getEmInternalApi(this.entity.em).joinRows(this).addRemove(this, this.entity, other);\n  }\n\n  /** Removes pending-hard-delete or soft-deleted entities, unless explicitly asked for. */\n  private filterDeleted(entities: U[], opts?: { withDeleted?: boolean }): U[] {\n    if (opts?.withDeleted === true) return [...entities];\n    // Relations configured with `softDeletes: \"include\"` keep soft-deleted entities in `.get`/`.load`.\n    const includeSoftDeleted = this.#field.softDeletes === \"include\";\n    return entities.filter((e) => !e.isDeletedEntity && (includeSoftDeleted || !(e as any).isSoftDeletedEntity));\n  }\n\n  async load(opts: { withDeleted?: boolean; forceReload?: boolean } = {}): Promise<ReadonlyArray<U>> {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (!this.#state.isLoaded || (opts.forceReload && !this.entity.isNewEntity)) {\n      const key = `${this.columnName}=${this.entity.id}`;\n      const maybePreloaded = this.#getPreloaded();\n      if (maybePreloaded) {\n        this.#state = this.#state.applyLoad(maybePreloaded);\n      } else {\n        await (this.#loadPromise ??= manyToManyBatchLoader(this.entity.em, this).load(key))\n          .then(() => this.preload())\n          .catch(function load(err: any) {\n            throw appendStack(err, new Error());\n          })\n          .finally(() => {\n            this.#loadPromise = undefined;\n          });\n      }\n    }\n    return this.filterDeleted(this.#state.doGet(), opts) as ReadonlyArray<U>;\n  }\n\n  async find(id: IdOf<U>): Promise<U | undefined> {\n    ensureNotDeleted(this.entity, \"pending\");\n    const inMemory = this.#state.find(id);\n    if (inMemory) return inMemory;\n    if (this.#state.isLoaded) return undefined;\n    const key = `${this.columnName}=${this.entity.id},${this.otherColumnName}=${id}`;\n    const includes = await manyToManyFindDataLoader(this.entity.em, this)\n      .load(key)\n      .catch(function load(err) {\n        throw appendStack(err, new Error());\n      });\n    const taggedId = toTaggedId(this.otherMeta, id);\n    return includes ? (this.entity.em.load(taggedId) as Promise<U>) : undefined;\n  }\n\n  async includes(other: U): Promise<boolean> {\n    ensureNotDeleted(this.entity, \"pending\");\n    const inMemory = this.#state.includesInMemory(other);\n    if (inMemory !== undefined) return inMemory;\n    if (other.isNewEntity) return false;\n    const key = `${this.columnName}=${this.entity.id},${this.otherColumnName}=${other.id}`;\n    return manyToManyFindDataLoader(this.entity.em, this)\n      .load(key)\n      .catch(function includes(err) {\n        throw appendStack(err, new Error());\n      });\n  }\n\n  add(other: U, percolated = false): void {\n    ensureNotDeleted(this.entity);\n    this.#state = this.#state.add(other, percolated);\n  }\n\n  remove(other: U, percolated = false): void {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#state = this.#state.remove(other, percolated);\n  }\n\n  get isLoaded(): boolean {\n    return this.#state.isLoaded;\n  }\n\n  get isPreloaded(): boolean {\n    return !!this.#getPreloaded();\n  }\n\n  preload(): void {\n    const preloaded = this.#getPreloaded();\n    if (preloaded) {\n      this.#state = this.#state.applyLoad(preloaded);\n    }\n  }\n\n  import(other: ManyToManyCollection<T, U>, _: unknown, mapEntities: (e: U[] | undefined) => U[] | undefined): void {\n    this.#state = other.#state.import(this, mapEntities);\n  }\n\n  private doGet(): U[] {\n    ensureNotDeleted(this.entity, \"pending\");\n    return this.#state.doGet();\n  }\n\n  get getWithDeleted(): U[] {\n    return this.filterDeleted(this.doGet(), { withDeleted: true });\n  }\n\n  get get(): U[] {\n    return this.filterDeleted(this.doGet(), { withDeleted: false });\n  }\n\n  set(values: readonly U[]): void {\n    ensureNotDeleted(this.entity);\n    this.#state = this.#state.set(values);\n  }\n\n  removeAll(): void {\n    ensureNotDeleted(this.entity);\n    if (!this.#state.isLoaded) {\n      throw new Error(\"removeAll was called when not loaded\");\n    }\n    for (const other of [...this.#state.doGet()]) {\n      this.remove(other);\n    }\n  }\n\n  // impl details\n\n  setFromOpts(others: U[]): void {\n    this.#state = new LoadedState<T, U>(this, [], false);\n    others.forEach((o) => this.add(o));\n  }\n\n  maybeCascadeDelete() {\n    if (this.#isCascadeDelete) {\n      this.filterDeleted(this.#state.current({ withDeleted: true }), { withDeleted: true }).forEach((e) =>\n        this.entity.em.delete(e),\n      );\n    }\n  }\n\n  async cleanupOnEntityDeleted(): Promise<void> {\n    if (this.#isCascadeDelete) return;\n    const entities = await this.load({ withDeleted: true });\n    entities.forEach((other) => {\n      const m2m = other[this.otherFieldName] as any as ManyToManyCollection<U, T>;\n      m2m.remove(this.entity);\n    });\n    if (this.#state instanceof LoadedState) {\n      this.#state.setLoaded([]);\n    }\n  }\n\n  get meta(): EntityMetadata {\n    return getMetadataForField(getMetadata(this.entity), this.fieldName);\n  }\n\n  get otherMeta(): EntityMetadata {\n    return this.#field.otherMetadata();\n  }\n\n  get joinTableName(): string {\n    return this.#field.joinTableName;\n  }\n\n  get fieldName(): string {\n    return this.#field.fieldName;\n  }\n\n  get otherFieldName(): string & keyof U {\n    return this.#field.otherFieldName as string & keyof U;\n  }\n\n  get columnName(): string {\n    return this.#field.columnNames[0];\n  }\n\n  get otherColumnName(): string {\n    return this.#field.columnNames[1];\n  }\n\n  get hasJoinTableId(): boolean {\n    return this.#field.hasJoinTableId;\n  }\n\n  get #isCascadeDelete(): boolean {\n    return isCascadeDelete(this, this.fieldName);\n  }\n\n  get hasBeenSet(): boolean {\n    return this.#state.hasBeenSet;\n  }\n\n  toString(): string {\n    return `OneToManyCollection(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.otherMeta.type}, otherFieldName: ${this.otherFieldName})`;\n  }\n\n  #getPreloaded(): U[] | undefined {\n    if (this.entity.isNewEntity) return undefined;\n    return getEmInternalApi(this.entity.em).getPreloadedRelation<U>(this.entity.idTagged, this.fieldName);\n  }\n\n  [RelationT]: T = null!;\n  [RelationU]: U = null!;\n}\n\n/**\n * State interface for ManyToManyCollection state machine.\n *\n * State transitions:\n * ```\n * Constructor (existing entity) → UnloadedPristine\n * Constructor (new entity)      → Loaded\n *\n * UnloadedPristine + add/remove → UnloadedAddedRemoved\n * UnloadedPristine + set        → PendingSet\n * UnloadedPristine + applyLoad  → Loaded\n *\n * UnloadedAddedRemoved + set       → PendingSet\n * UnloadedAddedRemoved + applyLoad → Loaded (merges tracked adds/removes)\n *\n * PendingSet + applyLoad → Loaded (diffs pending values against DB)\n *\n * Loaded + applyLoad (forceReload) → Loaded (refreshed)\n * ```\n */\ninterface M2MState<T extends Entity, U extends Entity> {\n  /** Adds an entity; may transition UnloadedPristine → UnloadedAddedRemoved. */\n  add(other: U, percolated: boolean): M2MState<T, U>;\n  /** Removes an entity; may transition UnloadedPristine → UnloadedAddedRemoved. */\n  remove(other: U, percolated: boolean): M2MState<T, U>;\n  /** Sets the collection; transitions UnloadedPristine/UnloadedAddedRemoved → PendingSet. */\n  set(values: readonly U[]): M2MState<T, U>;\n  /** Returns the current entities; throws if not loaded (except PendingSet returns pending values). */\n  doGet(): U[];\n  /** Finds an entity by id in memory; returns undefined if not found or not tracked. */\n  find(id: IdOf<U>): U | undefined;\n  /** Checks if entity is in memory; returns undefined if async lookup needed. */\n  includesInMemory(other: U): boolean | undefined;\n  /** Applies loaded DB entities; always transitions to Loaded. */\n  applyLoad(dbEntities: U[]): LoadedState<T, U>;\n  /** Returns current entities for cascade delete (works in any state). */\n  current(opts?: { withDeleted?: boolean }): U[];\n  /** Creates a copy of this state for a different collection (used by em.clone). */\n  import(m2m: ManyToManyCollection<T, U>, mapEntities: (e: U[] | undefined) => U[] | undefined): M2MState<T, U>;\n  readonly isLoaded: boolean;\n  readonly hasBeenSet: boolean;\n}\n\n/** Initial state for existing entities - no data loaded yet. */\nclass UnloadedPristineState<T extends Entity, U extends Entity> implements M2MState<T, U> {\n  readonly isLoaded = false;\n  readonly hasBeenSet = false;\n  #m2m: ManyToManyCollection<T, U>;\n\n  constructor(m2m: ManyToManyCollection<T, U>) {\n    this.#m2m = m2m;\n  }\n\n  add(other: U, percolated: boolean): M2MState<T, U> {\n    const newState = new UnloadedAddedRemovedState<T, U>(this.#m2m, [other], []);\n    if (!percolated) {\n      this.#m2m.registerJoinRowAdd(other);\n      this.#m2m.percolateAdd(other);\n    }\n    return newState;\n  }\n\n  remove(other: U, percolated: boolean): M2MState<T, U> {\n    if (!percolated) {\n      this.#m2m.registerJoinRowRemove(other);\n      this.#m2m.percolateRemove(other);\n    }\n    return new UnloadedAddedRemovedState<T, U>(this.#m2m, [], [other]);\n  }\n\n  set(values: readonly U[]): M2MState<T, U> {\n    return new PendingSetState<T, U>(this.#m2m, [...values]);\n  }\n\n  doGet(): U[] {\n    throw new Error(`${this.#m2m.entity}.${this.#m2m.fieldName}.get was called when not loaded`);\n  }\n\n  find(_id: IdOf<U>): U | undefined {\n    return undefined;\n  }\n\n  includesInMemory(_other: U): boolean | undefined {\n    return undefined;\n  }\n\n  applyLoad(dbEntities: U[]): LoadedState<T, U> {\n    return new LoadedState<T, U>(this.#m2m, dbEntities, false);\n  }\n\n  current(_opts?: { withDeleted?: boolean }): U[] {\n    return [];\n  }\n\n  import(m2m: ManyToManyCollection<T, U>, _mapEntities: (e: U[] | undefined) => U[] | undefined): M2MState<T, U> {\n    return new UnloadedPristineState<T, U>(m2m);\n  }\n}\n\n/** State when add/remove called before load - tracks changes to merge later. */\nclass UnloadedAddedRemovedState<T extends Entity, U extends Entity> implements M2MState<T, U> {\n  readonly isLoaded = false;\n  readonly hasBeenSet = false;\n  #m2m: ManyToManyCollection<T, U>;\n  #added: U[];\n  #removed: U[];\n\n  constructor(m2m: ManyToManyCollection<T, U>, added: U[], removed: U[]) {\n    this.#m2m = m2m;\n    this.#added = added;\n    this.#removed = removed;\n  }\n\n  add(other: U, percolated: boolean): M2MState<T, U> {\n    maybeRemove(this.#removed, other);\n    if (!this.#added.includes(other)) {\n      this.#added.push(other);\n    }\n    if (!percolated) {\n      this.#m2m.registerJoinRowAdd(other);\n      this.#m2m.percolateAdd(other);\n    }\n    return this;\n  }\n\n  remove(other: U, percolated: boolean): M2MState<T, U> {\n    if (!percolated) {\n      this.#m2m.registerJoinRowRemove(other);\n      this.#m2m.percolateRemove(other);\n    }\n    maybeRemove(this.#added, other);\n    maybeAdd(this.#removed, other);\n    return this;\n  }\n\n  set(values: readonly U[]): M2MState<T, U> {\n    return new PendingSetState<T, U>(this.#m2m, [...values]);\n  }\n\n  doGet(): U[] {\n    throw new Error(`${this.#m2m.entity}.${this.#m2m.fieldName}.get was called when not loaded`);\n  }\n\n  find(id: IdOf<U>): U | undefined {\n    return this.#added.find((u) => u.id === id);\n  }\n\n  includesInMemory(other: U): boolean | undefined {\n    if (this.#added.includes(other)) return true;\n    return undefined;\n  }\n\n  applyLoad(dbEntities: U[]): LoadedState<T, U> {\n    const loaded = [...dbEntities];\n    for (const e of this.#added) {\n      if (!loaded.includes(e)) {\n        loaded.unshift(e);\n        this.#m2m.registerJoinRowAdd(e);\n      }\n    }\n    for (const e of this.#removed) {\n      remove(loaded, e);\n      this.#m2m.registerJoinRowRemove(e);\n    }\n    return new LoadedState<T, U>(this.#m2m, loaded, false);\n  }\n\n  current(_opts?: { withDeleted?: boolean }): U[] {\n    return this.#added;\n  }\n\n  import(m2m: ManyToManyCollection<T, U>, mapEntities: (e: U[] | undefined) => U[] | undefined): M2MState<T, U> {\n    const added = mapEntities(this.#added);\n    const removed = mapEntities(this.#removed);\n    return new UnloadedAddedRemovedState<T, U>(m2m, added ?? [], removed ?? []);\n  }\n}\n\n/** State when set() called before load - holds pending values to diff on load. */\nclass PendingSetState<T extends Entity, U extends Entity> implements M2MState<T, U> {\n  readonly isLoaded = false;\n  readonly hasBeenSet = true;\n  #m2m: ManyToManyCollection<T, U>;\n  #pendingSet: U[];\n\n  constructor(m2m: ManyToManyCollection<T, U>, pendingSet: U[]) {\n    this.#m2m = m2m;\n    this.#pendingSet = pendingSet;\n    getEmInternalApi(m2m.entity.em).pendingLoads.add(m2m);\n  }\n\n  add(other: U, percolated: boolean): M2MState<T, U> {\n    if (!this.#pendingSet.includes(other)) {\n      this.#pendingSet.push(other);\n    }\n    if (!percolated) {\n      this.#m2m.registerJoinRowAdd(other);\n      this.#m2m.percolateAdd(other);\n    }\n    return this;\n  }\n\n  remove(other: U, percolated: boolean): M2MState<T, U> {\n    if (!percolated) {\n      this.#m2m.registerJoinRowRemove(other);\n      this.#m2m.percolateRemove(other);\n    }\n    remove(this.#pendingSet, other);\n    return this;\n  }\n\n  set(values: readonly U[]): M2MState<T, U> {\n    this.#pendingSet = [...values];\n    return this;\n  }\n\n  doGet(): U[] {\n    return this.#pendingSet;\n  }\n\n  find(id: IdOf<U>): U | undefined {\n    return this.#pendingSet.find((u) => u.id === id);\n  }\n\n  includesInMemory(other: U): boolean | undefined {\n    return this.#pendingSet.includes(other);\n  }\n\n  applyLoad(dbEntities: U[]): LoadedState<T, U> {\n    const loaded = [...dbEntities];\n    const pending = this.#pendingSet;\n    for (const other of [...loaded]) {\n      if (!pending.includes(other)) {\n        remove(loaded, other);\n        this.#m2m.registerJoinRowRemove(other);\n        this.#m2m.percolateRemove(other);\n      }\n    }\n    for (const other of pending) {\n      if (!loaded.includes(other)) {\n        loaded.push(other);\n        this.#m2m.registerJoinRowAdd(other);\n        this.#m2m.percolateAdd(other);\n      }\n    }\n    return new LoadedState<T, U>(this.#m2m, loaded, true);\n  }\n\n  current(_opts?: { withDeleted?: boolean }): U[] {\n    return this.#pendingSet;\n  }\n\n  import(m2m: ManyToManyCollection<T, U>, mapEntities: (e: U[] | undefined) => U[] | undefined): M2MState<T, U> {\n    const pendingSet = mapEntities(this.#pendingSet);\n    return new PendingSetState<T, U>(m2m, pendingSet ?? []);\n  }\n}\n\n/** State when collection is loaded - all operations work directly on loaded array. */\nclass LoadedState<T extends Entity, U extends Entity> implements M2MState<T, U> {\n  readonly isLoaded = true;\n  #m2m: ManyToManyCollection<T, U>;\n  #loaded: U[];\n  #hasBeenSet: boolean;\n\n  constructor(m2m: ManyToManyCollection<T, U>, loaded: U[], hasBeenSet: boolean) {\n    this.#m2m = m2m;\n    this.#loaded = loaded;\n    this.#hasBeenSet = hasBeenSet;\n  }\n\n  get hasBeenSet(): boolean {\n    return this.#hasBeenSet;\n  }\n\n  add(other: U, percolated: boolean): M2MState<T, U> {\n    if (this.#loaded.includes(other)) return this;\n    this.#loaded.push(other);\n    if (!percolated) {\n      this.#m2m.registerJoinRowAdd(other);\n      this.#m2m.percolateAdd(other);\n    }\n    return this;\n  }\n\n  remove(other: U, percolated: boolean): M2MState<T, U> {\n    if (!percolated) {\n      this.#m2m.registerJoinRowRemove(other);\n      this.#m2m.percolateRemove(other);\n    }\n    remove(this.#loaded, other);\n    return this;\n  }\n\n  set(values: readonly U[]): M2MState<T, U> {\n    this.#hasBeenSet = true;\n    const loaded = new Set(this.#loaded);\n    const valuesSet = new Set(values);\n    for (const other of loaded) {\n      if (!valuesSet.has(other)) {\n        this.remove(other, false);\n      }\n    }\n    for (const other of values) {\n      if (!loaded.has(other)) {\n        this.add(other, false);\n      }\n    }\n    return this;\n  }\n\n  doGet(): U[] {\n    return this.#loaded;\n  }\n\n  find(id: IdOf<U>): U | undefined {\n    return this.#loaded.find((u) => u.id === id);\n  }\n\n  includesInMemory(other: U): boolean | undefined {\n    return this.#loaded.includes(other);\n  }\n\n  applyLoad(dbEntities: U[]): LoadedState<T, U> {\n    this.#loaded = dbEntities;\n    return this;\n  }\n\n  current(_opts?: { withDeleted?: boolean }): U[] {\n    return this.#loaded;\n  }\n\n  import(m2m: ManyToManyCollection<T, U>, mapEntities: (e: U[] | undefined) => U[] | undefined): M2MState<T, U> {\n    const loaded = mapEntities(this.#loaded);\n    return new LoadedState<T, U>(m2m, loaded ?? [], this.#hasBeenSet);\n  }\n\n  getLoaded(): U[] {\n    return this.#loaded;\n  }\n\n  setLoaded(entities: U[]): void {\n    this.#loaded = entities;\n  }\n}\n"],"mappings":"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"}

package/build/relations/ManyToManyLargeCollection.d.cts

@@ -5,8 +5,8 @@ import { IdOf } from "../EntityManager.cjs";
 import { Entity } from "../Entity.cjs";
 //#region src/relations/ManyToManyLargeCollection.d.ts
 /** An alias for creating `ManyToManyLargeCollection`s. */
-declare function hasLargeManyToMany<T extends Entity, U extends Entity>(joinTableName: string, columnName: string, otherFieldName: keyof U & string, otherColumnName: string, hasJoinTableId: boolean): LargeCollection<T, U>;
-declare class ManyToManyLargeCollection<T extends Entity, U extends Entity> implements LargeCollection<T, U> {
+export declare function hasLargeManyToMany<T extends Entity, U extends Entity>(joinTableName: string, columnName: string, otherFieldName: keyof U & string, otherColumnName: string, hasJoinTableId: boolean): LargeCollection<T, U>;
+export declare class ManyToManyLargeCollection<T extends Entity, U extends Entity> implements LargeCollection<T, U> {
   joinTableName: string;
   entity: T;
   fieldName: keyof T & string;
@@ -30,5 +30,4 @@ declare class ManyToManyLargeCollection<T extends Entity, U extends Entity> impl
   [RelationU]: U;
 }
 //#endregion
-export { ManyToManyLargeCollection, hasLargeManyToMany };
 //# sourceMappingURL=ManyToManyLargeCollection.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ManyToManyLargeCollection.d.cts","names":[],"sources":["../../src/relations/ManyToManyLargeCollection.ts"],"mappings":";;;;;;;iBAWgB,mBAAmB,UAAU,QAAQ,UAAU,QAC7D,uBACA,oBACA,sBAAsB,YACtB,yBACA,0BACC,gBAAgB,GAAG;cAiBT,0BAA0B,UAAU,QAAQ,UAAU,mBAAmB,gBAAgB,GAAG;EAO9F;EAMA,QAAQ;EACR,iBAAiB;EACjB;EACA,WAAW;EACX,sBAAsB;EACtB;EACA;UAhBD;UACA;EAER,YACS,uBAMA,QAAQ,GACR,iBAAiB,YACjB,oBACA,WAAW,gBACX,sBAAsB,YACtB,yBACA;EAGH,KAAK,IAAI,KAAK,KAAK,QAAQ;EA8B3B,SAAS,OAAO,IAAI;EAwB1B,IAAI,OAAO;EAQX,OAAO,OAAO;MAQV;MAIO,QAAQ;EAIZ;EAIP;GAEC,YAAY;GACZ,YAAY"}
+{"version":3,"file":"ManyToManyLargeCollection.d.cts","names":[],"sources":["../../src/relations/ManyToManyLargeCollection.ts"],"mappings":";;;;;;;wBAWgB,mBAAmB,UAAU,QAAQ,UAAU,QAC7D,uBACA,oBACA,sBAAsB,YACtB,yBACA,0BACC,gBAAgB,GAAG;qBAiBT,0BAA0B,UAAU,QAAQ,UAAU,mBAAmB,gBAAgB,GAAG;EAO9F;EAMA,QAAQ;EACR,iBAAiB;EACjB;EACA,WAAW;EACX,sBAAsB;EACtB;EACA;UAhBD;UACA;EAER,YACS,uBAMA,QAAQ,GACR,iBAAiB,YACjB,oBACA,WAAW,gBACX,sBAAsB,YACtB,yBACA;EAGH,KAAK,IAAI,KAAK,KAAK,QAAQ;EA8B3B,SAAS,OAAO,IAAI;EAwB1B,IAAI,OAAO;EAQX,OAAO,OAAO;MAQV;MAIO,QAAQ;EAIZ;EAIP;GAEC,YAAY;GACZ,YAAY"}

package/build/relations/ManyToManyLargeCollection.d.mts

@@ -5,8 +5,8 @@ import { IdOf } from "../EntityManager.mjs";
 import { Entity } from "../Entity.mjs";
 //#region src/relations/ManyToManyLargeCollection.d.ts
 /** An alias for creating `ManyToManyLargeCollection`s. */
-declare function hasLargeManyToMany<T extends Entity, U extends Entity>(joinTableName: string, columnName: string, otherFieldName: keyof U & string, otherColumnName: string, hasJoinTableId: boolean): LargeCollection<T, U>;
-declare class ManyToManyLargeCollection<T extends Entity, U extends Entity> implements LargeCollection<T, U> {
+export declare function hasLargeManyToMany<T extends Entity, U extends Entity>(joinTableName: string, columnName: string, otherFieldName: keyof U & string, otherColumnName: string, hasJoinTableId: boolean): LargeCollection<T, U>;
+export declare class ManyToManyLargeCollection<T extends Entity, U extends Entity> implements LargeCollection<T, U> {
   joinTableName: string;
   entity: T;
   fieldName: keyof T & string;
@@ -30,5 +30,4 @@ declare class ManyToManyLargeCollection<T extends Entity, U extends Entity> impl
   [RelationU]: U;
 }
 //#endregion
-export { ManyToManyLargeCollection, hasLargeManyToMany };
 //# sourceMappingURL=ManyToManyLargeCollection.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ManyToManyLargeCollection.d.mts","names":[],"sources":["../../src/relations/ManyToManyLargeCollection.ts"],"mappings":";;;;;;;iBAWgB,mBAAmB,UAAU,QAAQ,UAAU,QAC7D,uBACA,oBACA,sBAAsB,YACtB,yBACA,0BACC,gBAAgB,GAAG;cAiBT,0BAA0B,UAAU,QAAQ,UAAU,mBAAmB,gBAAgB,GAAG;EAO9F;EAMA,QAAQ;EACR,iBAAiB;EACjB;EACA,WAAW;EACX,sBAAsB;EACtB;EACA;UAhBD;UACA;EAER,YACS,uBAMA,QAAQ,GACR,iBAAiB,YACjB,oBACA,WAAW,gBACX,sBAAsB,YACtB,yBACA;EAGH,KAAK,IAAI,KAAK,KAAK,QAAQ;EA8B3B,SAAS,OAAO,IAAI;EAwB1B,IAAI,OAAO;EAQX,OAAO,OAAO;MAQV;MAIO,QAAQ;EAIZ;EAIP;GAEC,YAAY;GACZ,YAAY"}
+{"version":3,"file":"ManyToManyLargeCollection.d.mts","names":[],"sources":["../../src/relations/ManyToManyLargeCollection.ts"],"mappings":";;;;;;;wBAWgB,mBAAmB,UAAU,QAAQ,UAAU,QAC7D,uBACA,oBACA,sBAAsB,YACtB,yBACA,0BACC,gBAAgB,GAAG;qBAiBT,0BAA0B,UAAU,QAAQ,UAAU,mBAAmB,gBAAgB,GAAG;EAO9F;EAMA,QAAQ;EACR,iBAAiB;EACjB;EACA,WAAW;EACX,sBAAsB;EACtB;EACA;UAhBD;UACA;EAER,YACS,uBAMA,QAAQ,GACR,iBAAiB,YACjB,oBACA,WAAW,gBACX,sBAAsB,YACtB,yBACA;EAGH,KAAK,IAAI,KAAK,KAAK,QAAQ;EA8B3B,SAAS,OAAO,IAAI;EAwB1B,IAAI,OAAO;EAQX,OAAO,OAAO;MAQV;MAIO,QAAQ;EAIZ;EAIP;GAEC,YAAY;GACZ,YAAY"}

package/build/relations/ManyToOneReference.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ManyToOneReference.cjs","names":["lazyField","getMetadata","AbstractRelationImpl","#field","#state","getInstanceData","isEntity","#loadPromise","sameEntity","#setImpl","toTaggedId","setField","#percolateRemove","#percolateAdd","toIdOf","maybeResolveReferenceToId","deTagId","#hasBeenSet","ensureTagged","OneToManyCollection","OneToManyLargeCollection","OneToOneReferenceImpl","getEmInternalApi","getField","isCascadeDelete","RelationT","RelationU","ReferenceN","BaseEntity","NoIdError","#m2o","#loaded"],"sources":["../../src/relations/ManyToOneReference.ts"],"sourcesContent":["import { type Entity, isEntity } from \"src/Entity.ts\";\nimport { type IdOf, type TaggedId, getEmInternalApi, sameEntity } from \"src/EntityManager.ts\";\nimport { type EntityMetadata, type ManyToOneField, getMetadata } from \"src/EntityMetadata.ts\";\nimport { getField, setField } from \"src/fields.ts\";\nimport {\n  BaseEntity,\n  NoIdError,\n  OneToManyLargeCollection,\n  OneToOneReferenceImpl,\n  type Reference,\n  deTagId,\n  ensureNotDeleted,\n  ensureTagged,\n  fail,\n  getInstanceData,\n  maybeResolveReferenceToId,\n  toIdOf,\n  toTaggedId,\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 { OneToManyCollection } from \"src/relations/OneToManyCollection.ts\";\nimport { ReferenceN } from \"src/relations/ReferenceSymbols.ts\";\nimport { RelationT, RelationU } from \"src/relations/RelationSymbols.ts\";\nimport { maybeAdd, maybeRemove } from \"src/utils.ts\";\n\n/** An alias for creating `ManyToOneReference`s. */\nexport function hasOne<T extends Entity, U extends Entity, N extends never | undefined>(): ManyToOneReference<T, U, N> {\n  return lazyField((entity: T, fieldName) => {\n    const m2o = getMetadata(entity).allFields[fieldName] as ManyToOneField;\n    return new ManyToOneReferenceImpl<T, U, N>(entity, m2o);\n  });\n}\n\n/** Type guard utility for determining if an entity field is a ManyToOneReference. */\nexport function isManyToOneReference(maybeReference: any): maybeReference is ManyToOneReference<any, any, any> {\n  return maybeReference instanceof ManyToOneReferenceImpl;\n}\n\nexport interface ManyToOneReference<T extends Entity, U extends Entity, N extends never | undefined> extends Reference<\n  T,\n  U,\n  N\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  idUntagged: string;\n\n  idUntaggedIfSet: 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/**\n * Manages a foreign key from one entity to another, i.e. `Book.author --> Author`.\n *\n * We keep the current `author` / `author_id` value in the `__orm.data` hash, where the\n * current value could be either the (string) author id from the database, or an entity\n * `Author` that the user has set.\n *\n * Note that if our `images.author_id` column is unique, this `ManyToOneReference` will essentially\n * be half of a one-to-one relationship, but we'll keep using this `ManyToOneReference` on the \"many\"\n * side, and the other side, i.e. `Author.image` will use a `OneToOneReference` to point back to us.\n */\nexport class ManyToOneReferenceImpl<T extends Entity, U extends Entity, N extends never | undefined>\n  extends AbstractRelationImpl<T, U>\n  implements ManyToOneReference<T, U, N>\n{\n  readonly #field: ManyToOneField;\n  #state: M2OState<U, N>;\n  #loadPromise: Promise<void> | undefined;\n  #hasBeenSet = false;\n\n  constructor(entity: T, field: ManyToOneField) {\n    super(entity);\n    this.#field = field;\n    this.#state = getInstanceData(entity).isOrWasNew\n      ? new M2OLoadedState<U, N>(this, undefined)\n      : new M2OUnloadedState<U, N>(this);\n  }\n\n  async load(opts: { withDeleted?: boolean; forceReload?: boolean } = {}): Promise<U | N> {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#state = this.#state.maybeInstantLoad();\n    if (!this.#state.isLoaded || opts.forceReload) {\n      const current = this.current();\n      if (isEntity(current) || current === undefined) {\n        this.#state = new M2OLoadedState<U, N>(this, current as U | N | undefined);\n      } else {\n        await (this.#loadPromise ??= this.entity.em.load(this.otherMeta.cstr, current).then((entity) => {\n          this.#loadPromise = undefined;\n          // In extremely rare cases, someone might have called `set` while this promise was in-flight,\n          // so make sure our current value is still the same as the fetched entity.\n          if (sameEntity(entity, this.current())) {\n            this.#state = this.#state.applyLoad(entity);\n          }\n        }));\n      }\n    }\n    return this.filterDeleted(this.#state.doGet() as U | N, 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    // Even if `.load()` has not been called, `.get` will detect\n    this.#state = this.#state.maybeInstantLoad();\n    return this.#state.isLoaded;\n  }\n\n  get isPreloaded(): boolean {\n    return !!this.maybeFindEntity();\n  }\n\n  preload(): void {\n    this.#state = new M2OLoadedState<U, N>(this, this.maybeFindEntity());\n  }\n\n  private unload(): void {\n    this.#state = new M2OUnloadedState<U, N>(this);\n    this.#loadPromise = undefined;\n  }\n\n  /** Copy another em's `source` relation into our state. */\n  import(source: ManyToOneReferenceImpl<T, U, N>, findEntity: (e: U) => U): void {\n    this.#state = source.#state.import(this, findEntity);\n  }\n\n  private doGet(opts?: { withDeleted?: boolean }): U | N {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#state = this.#state.maybeInstantLoad();\n    return this.filterDeleted(this.#state.doGet() as U | N, 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  /** Returns the id of the current value. */\n  get id(): IdOf<U> {\n    return this.idMaybe || failNoId(this.entity, this.fieldName, this.current());\n  }\n\n  /** Sets the m2o to `id`, and allows accepting `undefined` (`N`) if this is a nullable relation. */\n  set id(id: IdOf<U> | N) {\n    ensureNotDeleted(this.entity, \"pending\");\n    const newId = toTaggedId(this.otherMeta, id);\n\n    const previousId = this.idTaggedMaybe;\n    const previous = this.maybeFindEntity();\n    const changed = setField(this.entity, this.fieldName, id);\n    if (!changed) {\n      return;\n    }\n\n    const loaded = newId ? (this.entity.em.getEntity(newId) as U) : undefined;\n    this.#state = loaded ? new M2OLoadedState<U, N>(this, loaded) : new M2OUnloadedState<U, N>(this);\n    this.#loadPromise = undefined;\n    this.#percolateRemove(previousId, previous);\n    this.#percolateAdd();\n  }\n\n  get idIfSet(): IdOf<U> | N | undefined {\n    return this.idMaybe || failIfNewEntity(this.entity, this.fieldName, this.current());\n  }\n\n  get idUntagged(): string {\n    return this.idUntaggedMaybe || failNoId(this.entity, this.fieldName, this.current());\n  }\n\n  get idUntaggedIfSet(): string | undefined {\n    return this.idUntaggedMaybe || failIfNewEntity(this.entity, this.fieldName, this.current());\n  }\n\n  get idMaybe(): IdOf<U> | N | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    return toIdOf(this.otherMeta, this.idTaggedMaybe);\n  }\n\n  /** Returns the tagged id of the current value, or undefined if unset or a new entity. */\n  get idTaggedMaybe(): TaggedId | undefined {\n    // Skip the deleted check so that `isPreloaded` doesn't blow up during em.refreshes/populates\n    // ensureNotDeleted(this.entity, \"pending\");\n    return maybeResolveReferenceToId(this.current());\n  }\n\n  get fieldName(): string {\n    return this.#field.fieldName;\n  }\n\n  get otherFieldName(): keyof U & string {\n    return this.#field.otherFieldName as keyof U & string;\n  }\n\n  private get idUntaggedMaybe(): string | undefined {\n    return deTagId(this.otherMeta, this.idMaybe);\n  }\n\n  #setImpl(_other: U | IdOf<U> | N): void {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#hasBeenSet = true;\n\n    // If the project is not using tagged ids, we still want it tagged internally\n    const other = ensureTagged(this.otherMeta, _other);\n    if (sameEntity(other, this.current({ withDeleted: true }))) {\n      return;\n    }\n\n    const previousId = this.idTaggedMaybe;\n    const previous = this.maybeFindEntity();\n    // Prefer to keep the id in our data hash, but if this is a new entity w/o an id, use the entity itself\n    setField(this.entity, this.fieldName, isEntity(other) ? (other?.idTaggedMaybe ?? other) : other);\n\n    // Setting to an entity | undefined => loaded, setting to an id might reverse to unloaded\n    const maybeEntity = isEntity(other) ? (other as U) : other ? this.entity.em.getEntity(other) : undefined;\n    if (maybeEntity || other === undefined) {\n      this.#state = new M2OLoadedState<U, N>(this, (maybeEntity ?? other) as U | N);\n    } else {\n      this.#state = new M2OUnloadedState<U, N>(this);\n    }\n    this.#loadPromise = undefined;\n    this.#percolateRemove(previousId, previous);\n    this.#percolateAdd();\n  }\n\n  // private impl\n\n  setFromOpts(other: U | IdOf<U> | N): 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) {\n        if (typeof current === \"string\") {\n          // We're invoked twice, once sync on em.delete, and again in em.flush when we're loaded;\n          // but even when loaded, current might still be the tagged id, but we can find the entity in the EM\n          const other = this.entity.em.getEntity(current);\n          if (other) this.entity.em.delete(other as U);\n        } else {\n          this.entity.em.delete(current as U);\n        }\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 if (o2m instanceof OneToManyLargeCollection) {\n        o2m.remove(this.entity);\n      } else if (o2m instanceof OneToOneReferenceImpl) {\n        o2m.set(undefined as any);\n      } else {\n        throw new Error(`Unhandled ${o2m}`);\n      }\n    }\n    setField(this.entity, this.fieldName, undefined);\n    this.#state = new M2OLoadedState<U, N>(this, undefined as any);\n  }\n\n  // Called on `book.author.set(...)` with our previous value, to percolate a `author.books.remove`. */\n  #percolateRemove(prevId: string | undefined, prevEntity: U | undefined) {\n    if (prevEntity) {\n      const prevRelation = this.getOtherRelation(prevEntity);\n      if (prevRelation instanceof OneToManyCollection) {\n        prevRelation.removeIfLoaded(this.entity);\n      } else if (prevRelation instanceof OneToManyLargeCollection) {\n        prevRelation.remove(this.entity);\n      } else {\n        prevRelation.set(undefined as any, { percolating: true });\n      }\n    } else if (prevId) {\n      // prevEntity is not loaded in memory, but cache it in case our other side is later loaded\n      const { em } = this.entity;\n      let map = getEmInternalApi(em).pendingPercolate.get(prevId);\n      if (!map) {\n        map = new Map();\n        getEmInternalApi(em).pendingPercolate.set(prevId, map);\n      }\n      let pending = map.get(this.otherFieldName);\n      if (!pending) {\n        pending = { adds: [], removes: [] };\n        map.set(this.otherFieldName, pending);\n      }\n      maybeAdd(pending.removes, this.entity);\n      maybeRemove(pending.adds, this.entity);\n    }\n  }\n\n  #percolateAdd() {\n    const id = this.current();\n    const other = this.maybeFindEntity();\n    if (other) {\n      // Other is already loaded in memory, immediately hook it up\n      const newRelation = this.getOtherRelation(other);\n      if (newRelation instanceof OneToManyCollection) {\n        newRelation.add(this.entity);\n      } else if (newRelation instanceof OneToManyLargeCollection) {\n        newRelation.add(this.entity);\n      } else if (newRelation) {\n        newRelation.set(this.entity, { percolating: true });\n      } else {\n        // Something is wrong, we should always have a relation, but instead\n        // of blowing up here, let this finish b/c it will probably turn into\n        // a validation error.\n      }\n    } else if (typeof id === \"string\") {\n      // Other is not loaded in memory, but cache it in case our other side is later loaded\n      const { em } = this.entity;\n      let map = getEmInternalApi(em).pendingPercolate.get(id);\n      if (!map) {\n        map = new Map();\n        getEmInternalApi(em).pendingPercolate.set(id, map);\n      }\n      let pending = map.get(this.otherFieldName);\n      if (!pending) {\n        pending = { adds: [], removes: [] };\n        map.set(this.otherFieldName, pending);\n      }\n      maybeAdd(pending.adds, this.entity);\n      maybeRemove(pending.removes, this.entity);\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  get otherMeta(): EntityMetadata<U> {\n    return this.#field.otherMetadata();\n  }\n\n  get hasBeenSet(): boolean {\n    return this.#hasBeenSet;\n  }\n\n  public toString(): string {\n    return `ManyToOneReference(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.otherMeta.type}, otherFieldName: ${this.otherFieldName}, id: ${this.idMaybe})`;\n  }\n\n  /**\n   * Removes pending-hard-delete (but not soft-deleted), unless explicitly asked for.\n   *\n   * Note that we leave soft-deleted entities b/c the call signature of a `book.author.get`\n   * very likely does not expect a soft-deleted entity to result in `undefined`.\n   *\n   * (Contrasted with `author.books.get` which is more intuitive to have soft-deleted\n   * entities filtered out, i.e. it doesn't fundamentally change the return type.)\n   */\n  private filterDeleted(entity: U | N, opts?: { withDeleted?: boolean }): U | N {\n    if (entity && (!opts || !opts.withDeleted) && entity.isDeletedEntity) {\n      return undefined!;\n    }\n    return entity;\n  }\n\n  /** Returns the other relation that points back at us, i.e. we're `book.author_id` and this is `Author.books`. */\n  private getOtherRelation(\n    other: U,\n  ): OneToManyCollection<U, T> | OneToOneReferenceImpl<U, T> | OneToManyLargeCollection<U, T> {\n    return (other as U)[this.otherFieldName] as any;\n  }\n\n  private get isCascadeDelete(): boolean {\n    return isCascadeDelete(this, this.fieldName);\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 current() first b/c a new entity won't have an id yet\n    const current = this.current();\n    if (isEntity(current)) return current as U;\n    const { idTaggedMaybe } = this;\n    return idTaggedMaybe !== undefined ? (this.entity.em.getEntity(idTaggedMaybe) as U) : undefined;\n  }\n\n  [RelationT]: T = null!;\n  [RelationU]: U = null!;\n  [ReferenceN]: N = null!;\n}\n\n/**\n * Fails when we can't return an `.id` for a reference, i.e. it's unset or a new entity.\n *\n * We strictly type `book.author.id` as `AuthorId`, even if `book.author` is nullable, to\n * avoid users calling `.id` and getting back `undefined`, but not because \"there is no\n * author\", but only because \"the assigned author doesn't have an id assigned yet\".\n *\n * To handle nullable references, set `.idIfSet`.\n *\n * Assumes being called like `return idMaybe ?? failNoId()`, i.e. if we're called we\n * know the id is not available.\n */\nexport function failNoId(entity: Entity, fieldName: string, current: string | Entity | undefined): never {\n  if (!current) fail(`Reference ${entity}.${fieldName} is unset`);\n  // Throw NoIdError, which lets ReactionsManager will handle reactive fields gracefully\n  if (current instanceof BaseEntity)\n    throw new NoIdError(`Reference ${entity}.${fieldName} is assigned to a new entity`);\n  fail(`Unreachable`);\n}\n\n/**\n * Fails when we can't return an `.idIfSet` for a reference, i.e. it's a new entity.\n *\n * Assumes being called like `return idMaybe ?? failIfNewEntity()`, i.e. if we're called we\n * know the id is not available.\n */\nexport function failIfNewEntity(entity: Entity, fieldName: string, current: string | Entity | undefined): undefined {\n  if (current instanceof BaseEntity) {\n    throw new NoIdError(`Reference ${entity}.${fieldName} is assigned to a new entity`);\n  }\n  // Since this is a `.idIfSet`, having no `current` is fine, return undefined.\n  return undefined;\n}\n\ninterface M2OState<U extends Entity, N extends never | undefined> {\n  readonly isLoaded: boolean;\n  maybeInstantLoad(): M2OState<U, N>;\n  applyLoad(loaded: U | N | undefined): M2OLoadedState<U, N>;\n  import(target: ManyToOneReferenceImpl<any, any, any>, findEntity: (e: U) => U): M2OState<U, N>;\n  doGet(): U | N | undefined;\n}\n\nclass M2OUnloadedState<U extends Entity, N extends never | undefined> implements M2OState<U, N> {\n  readonly isLoaded = false;\n  #m2o: ManyToOneReferenceImpl<any, any, any>;\n  constructor(m2o: ManyToOneReferenceImpl<any, any, any>) {\n    this.#m2o = m2o;\n  }\n  applyLoad(loaded: U | N | undefined): M2OLoadedState<U, N> {\n    return new M2OLoadedState<U, N>(this.#m2o, loaded);\n  }\n  import(target: ManyToOneReferenceImpl<any, any, any>): M2OState<U, N> {\n    return new M2OUnloadedState<U, N>(target);\n  }\n  maybeInstantLoad(): M2OState<U, N> {\n    const current = this.#m2o.current();\n    if (current === undefined || isEntity(current)) {\n      return new M2OLoadedState<U, N>(this.#m2o, current as U | undefined);\n    } else {\n      const maybeFound = this.#m2o.entity.em.getEntity(current);\n      if (maybeFound) {\n        return new M2OLoadedState<U, N>(this.#m2o, maybeFound as U);\n      }\n    }\n    return this;\n  }\n  doGet(): U | N | undefined {\n    throw new Error(`${this.#m2o.entity}.${this.#m2o.fieldName} was not loaded`);\n  }\n}\n\n/** The when loaded, with either the loaded entity or undefined. */\nclass M2OLoadedState<U extends Entity, N extends never | undefined> implements M2OState<U, N> {\n  readonly isLoaded = true;\n  #m2o: ManyToOneReferenceImpl<any, any, any>;\n  #loaded: U | N | undefined;\n  constructor(m2o: ManyToOneReferenceImpl<any, any, any>, loaded: U | N | undefined) {\n    this.#loaded = loaded;\n    this.#m2o = m2o;\n  }\n  applyLoad(loaded: U | N | undefined): M2OLoadedState<U, N> {\n    return new M2OLoadedState<U, N>(this.#m2o, loaded);\n  }\n  import(target: ManyToOneReferenceImpl<any, any, any>, findEntity: (e: U) => U): M2OState<U, N> {\n    return new M2OLoadedState<U, N>(target, isEntity(this.#loaded) ? findEntity(this.#loaded) : undefined);\n  }\n  maybeInstantLoad(): M2OState<U, N> {\n    return this;\n  }\n  doGet(): U | N | undefined {\n    return this.#loaded;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"ManyToOneReference.cjs","names":["lazyField","getMetadata","AbstractRelationImpl","getInstanceData","isEntity","sameEntity","toTaggedId","setField","toIdOf","maybeResolveReferenceToId","deTagId","ensureTagged","OneToManyCollection","OneToManyLargeCollection","OneToOneReferenceImpl","getEmInternalApi","getField","isCascadeDelete","RelationT","RelationU","ReferenceN","BaseEntity","NoIdError"],"sources":["../../src/relations/ManyToOneReference.ts"],"sourcesContent":["import { type Entity, isEntity } from \"src/Entity.ts\";\nimport { type IdOf, type TaggedId, getEmInternalApi, sameEntity } from \"src/EntityManager.ts\";\nimport { type EntityMetadata, type ManyToOneField, getMetadata } from \"src/EntityMetadata.ts\";\nimport { getField, setField } from \"src/fields.ts\";\nimport {\n  BaseEntity,\n  NoIdError,\n  OneToManyLargeCollection,\n  OneToOneReferenceImpl,\n  type Reference,\n  deTagId,\n  ensureNotDeleted,\n  ensureTagged,\n  fail,\n  getInstanceData,\n  maybeResolveReferenceToId,\n  toIdOf,\n  toTaggedId,\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 { OneToManyCollection } from \"src/relations/OneToManyCollection.ts\";\nimport { ReferenceN } from \"src/relations/ReferenceSymbols.ts\";\nimport { RelationT, RelationU } from \"src/relations/RelationSymbols.ts\";\nimport { maybeAdd, maybeRemove } from \"src/utils.ts\";\n\n/** An alias for creating `ManyToOneReference`s. */\nexport function hasOne<T extends Entity, U extends Entity, N extends never | undefined>(): ManyToOneReference<T, U, N> {\n  return lazyField((entity: T, fieldName) => {\n    const m2o = getMetadata(entity).allFields[fieldName] as ManyToOneField;\n    return new ManyToOneReferenceImpl<T, U, N>(entity, m2o);\n  });\n}\n\n/** Type guard utility for determining if an entity field is a ManyToOneReference. */\nexport function isManyToOneReference(maybeReference: any): maybeReference is ManyToOneReference<any, any, any> {\n  return maybeReference instanceof ManyToOneReferenceImpl;\n}\n\nexport interface ManyToOneReference<T extends Entity, U extends Entity, N extends never | undefined> extends Reference<\n  T,\n  U,\n  N\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  idUntagged: string;\n\n  idUntaggedIfSet: 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/**\n * Manages a foreign key from one entity to another, i.e. `Book.author --> Author`.\n *\n * We keep the current `author` / `author_id` value in the `__orm.data` hash, where the\n * current value could be either the (string) author id from the database, or an entity\n * `Author` that the user has set.\n *\n * Note that if our `images.author_id` column is unique, this `ManyToOneReference` will essentially\n * be half of a one-to-one relationship, but we'll keep using this `ManyToOneReference` on the \"many\"\n * side, and the other side, i.e. `Author.image` will use a `OneToOneReference` to point back to us.\n */\nexport class ManyToOneReferenceImpl<T extends Entity, U extends Entity, N extends never | undefined>\n  extends AbstractRelationImpl<T, U>\n  implements ManyToOneReference<T, U, N>\n{\n  readonly #field: ManyToOneField;\n  #state: M2OState<U, N>;\n  #loadPromise: Promise<void> | undefined;\n  #hasBeenSet = false;\n\n  constructor(entity: T, field: ManyToOneField) {\n    super(entity);\n    this.#field = field;\n    this.#state = getInstanceData(entity).isOrWasNew\n      ? new M2OLoadedState<U, N>(this, undefined)\n      : new M2OUnloadedState<U, N>(this);\n  }\n\n  async load(opts: { withDeleted?: boolean; forceReload?: boolean } = {}): Promise<U | N> {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#state = this.#state.maybeInstantLoad();\n    if (!this.#state.isLoaded || opts.forceReload) {\n      const current = this.current();\n      if (isEntity(current) || current === undefined) {\n        this.#state = new M2OLoadedState<U, N>(this, current as U | N | undefined);\n      } else {\n        await (this.#loadPromise ??= this.entity.em.load(this.otherMeta.cstr, current).then((entity) => {\n          this.#loadPromise = undefined;\n          // In extremely rare cases, someone might have called `set` while this promise was in-flight,\n          // so make sure our current value is still the same as the fetched entity.\n          if (sameEntity(entity, this.current())) {\n            this.#state = this.#state.applyLoad(entity);\n          }\n        }));\n      }\n    }\n    return this.filterDeleted(this.#state.doGet() as U | N, 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    // Even if `.load()` has not been called, `.get` will detect\n    this.#state = this.#state.maybeInstantLoad();\n    return this.#state.isLoaded;\n  }\n\n  get isPreloaded(): boolean {\n    return !!this.maybeFindEntity();\n  }\n\n  preload(): void {\n    this.#state = new M2OLoadedState<U, N>(this, this.maybeFindEntity());\n  }\n\n  private unload(): void {\n    this.#state = new M2OUnloadedState<U, N>(this);\n    this.#loadPromise = undefined;\n  }\n\n  /** Copy another em's `source` relation into our state. */\n  import(source: ManyToOneReferenceImpl<T, U, N>, findEntity: (e: U) => U): void {\n    this.#state = source.#state.import(this, findEntity);\n  }\n\n  private doGet(opts?: { withDeleted?: boolean }): U | N {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#state = this.#state.maybeInstantLoad();\n    return this.filterDeleted(this.#state.doGet() as U | N, 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  /** Returns the id of the current value. */\n  get id(): IdOf<U> {\n    return this.idMaybe || failNoId(this.entity, this.fieldName, this.current());\n  }\n\n  /** Sets the m2o to `id`, and allows accepting `undefined` (`N`) if this is a nullable relation. */\n  set id(id: IdOf<U> | N) {\n    ensureNotDeleted(this.entity, \"pending\");\n    const newId = toTaggedId(this.otherMeta, id);\n\n    const previousId = this.idTaggedMaybe;\n    const previous = this.maybeFindEntity();\n    const changed = setField(this.entity, this.fieldName, id);\n    if (!changed) {\n      return;\n    }\n\n    const loaded = newId ? (this.entity.em.getEntity(newId) as U) : undefined;\n    this.#state = loaded ? new M2OLoadedState<U, N>(this, loaded) : new M2OUnloadedState<U, N>(this);\n    this.#loadPromise = undefined;\n    this.#percolateRemove(previousId, previous);\n    this.#percolateAdd();\n  }\n\n  get idIfSet(): IdOf<U> | N | undefined {\n    return this.idMaybe || failIfNewEntity(this.entity, this.fieldName, this.current());\n  }\n\n  get idUntagged(): string {\n    return this.idUntaggedMaybe || failNoId(this.entity, this.fieldName, this.current());\n  }\n\n  get idUntaggedIfSet(): string | undefined {\n    return this.idUntaggedMaybe || failIfNewEntity(this.entity, this.fieldName, this.current());\n  }\n\n  get idMaybe(): IdOf<U> | N | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    return toIdOf(this.otherMeta, this.idTaggedMaybe);\n  }\n\n  /** Returns the tagged id of the current value, or undefined if unset or a new entity. */\n  get idTaggedMaybe(): TaggedId | undefined {\n    // Skip the deleted check so that `isPreloaded` doesn't blow up during em.refreshes/populates\n    // ensureNotDeleted(this.entity, \"pending\");\n    return maybeResolveReferenceToId(this.current());\n  }\n\n  get fieldName(): string {\n    return this.#field.fieldName;\n  }\n\n  get otherFieldName(): keyof U & string {\n    return this.#field.otherFieldName as keyof U & string;\n  }\n\n  private get idUntaggedMaybe(): string | undefined {\n    return deTagId(this.otherMeta, this.idMaybe);\n  }\n\n  #setImpl(_other: U | IdOf<U> | N): void {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#hasBeenSet = true;\n\n    // If the project is not using tagged ids, we still want it tagged internally\n    const other = ensureTagged(this.otherMeta, _other);\n    if (sameEntity(other, this.current({ withDeleted: true }))) {\n      return;\n    }\n\n    const previousId = this.idTaggedMaybe;\n    const previous = this.maybeFindEntity();\n    // Prefer to keep the id in our data hash, but if this is a new entity w/o an id, use the entity itself\n    setField(this.entity, this.fieldName, isEntity(other) ? (other?.idTaggedMaybe ?? other) : other);\n\n    // Setting to an entity | undefined => loaded, setting to an id might reverse to unloaded\n    const maybeEntity = isEntity(other) ? (other as U) : other ? this.entity.em.getEntity(other) : undefined;\n    if (maybeEntity || other === undefined) {\n      this.#state = new M2OLoadedState<U, N>(this, (maybeEntity ?? other) as U | N);\n    } else {\n      this.#state = new M2OUnloadedState<U, N>(this);\n    }\n    this.#loadPromise = undefined;\n    this.#percolateRemove(previousId, previous);\n    this.#percolateAdd();\n  }\n\n  // private impl\n\n  setFromOpts(other: U | IdOf<U> | N): 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) {\n        if (typeof current === \"string\") {\n          // We're invoked twice, once sync on em.delete, and again in em.flush when we're loaded;\n          // but even when loaded, current might still be the tagged id, but we can find the entity in the EM\n          const other = this.entity.em.getEntity(current);\n          if (other) this.entity.em.delete(other as U);\n        } else {\n          this.entity.em.delete(current as U);\n        }\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 if (o2m instanceof OneToManyLargeCollection) {\n        o2m.remove(this.entity);\n      } else if (o2m instanceof OneToOneReferenceImpl) {\n        o2m.set(undefined as any);\n      } else {\n        throw new Error(`Unhandled ${o2m}`);\n      }\n    }\n    setField(this.entity, this.fieldName, undefined);\n    this.#state = new M2OLoadedState<U, N>(this, undefined as any);\n  }\n\n  // Called on `book.author.set(...)` with our previous value, to percolate a `author.books.remove`. */\n  #percolateRemove(prevId: string | undefined, prevEntity: U | undefined) {\n    if (prevEntity) {\n      const prevRelation = this.getOtherRelation(prevEntity);\n      if (prevRelation instanceof OneToManyCollection) {\n        prevRelation.removeIfLoaded(this.entity);\n      } else if (prevRelation instanceof OneToManyLargeCollection) {\n        prevRelation.remove(this.entity);\n      } else {\n        prevRelation.set(undefined as any, { percolating: true });\n      }\n    } else if (prevId) {\n      // prevEntity is not loaded in memory, but cache it in case our other side is later loaded\n      const { em } = this.entity;\n      let map = getEmInternalApi(em).pendingPercolate.get(prevId);\n      if (!map) {\n        map = new Map();\n        getEmInternalApi(em).pendingPercolate.set(prevId, map);\n      }\n      let pending = map.get(this.otherFieldName);\n      if (!pending) {\n        pending = { adds: [], removes: [] };\n        map.set(this.otherFieldName, pending);\n      }\n      maybeAdd(pending.removes, this.entity);\n      maybeRemove(pending.adds, this.entity);\n    }\n  }\n\n  #percolateAdd() {\n    const id = this.current();\n    const other = this.maybeFindEntity();\n    if (other) {\n      // Other is already loaded in memory, immediately hook it up\n      const newRelation = this.getOtherRelation(other);\n      if (newRelation instanceof OneToManyCollection) {\n        newRelation.add(this.entity);\n      } else if (newRelation instanceof OneToManyLargeCollection) {\n        newRelation.add(this.entity);\n      } else if (newRelation) {\n        newRelation.set(this.entity, { percolating: true });\n      } else {\n        // Something is wrong, we should always have a relation, but instead\n        // of blowing up here, let this finish b/c it will probably turn into\n        // a validation error.\n      }\n    } else if (typeof id === \"string\") {\n      // Other is not loaded in memory, but cache it in case our other side is later loaded\n      const { em } = this.entity;\n      let map = getEmInternalApi(em).pendingPercolate.get(id);\n      if (!map) {\n        map = new Map();\n        getEmInternalApi(em).pendingPercolate.set(id, map);\n      }\n      let pending = map.get(this.otherFieldName);\n      if (!pending) {\n        pending = { adds: [], removes: [] };\n        map.set(this.otherFieldName, pending);\n      }\n      maybeAdd(pending.adds, this.entity);\n      maybeRemove(pending.removes, this.entity);\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  get otherMeta(): EntityMetadata<U> {\n    return this.#field.otherMetadata();\n  }\n\n  get hasBeenSet(): boolean {\n    return this.#hasBeenSet;\n  }\n\n  public toString(): string {\n    return `ManyToOneReference(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.otherMeta.type}, otherFieldName: ${this.otherFieldName}, id: ${this.idMaybe})`;\n  }\n\n  /**\n   * Removes pending-hard-delete (but not soft-deleted), unless explicitly asked for.\n   *\n   * Note that we leave soft-deleted entities b/c the call signature of a `book.author.get`\n   * very likely does not expect a soft-deleted entity to result in `undefined`.\n   *\n   * (Contrasted with `author.books.get` which is more intuitive to have soft-deleted\n   * entities filtered out, i.e. it doesn't fundamentally change the return type.)\n   */\n  private filterDeleted(entity: U | N, opts?: { withDeleted?: boolean }): U | N {\n    if (entity && (!opts || !opts.withDeleted) && entity.isDeletedEntity) {\n      return undefined!;\n    }\n    return entity;\n  }\n\n  /** Returns the other relation that points back at us, i.e. we're `book.author_id` and this is `Author.books`. */\n  private getOtherRelation(\n    other: U,\n  ): OneToManyCollection<U, T> | OneToOneReferenceImpl<U, T> | OneToManyLargeCollection<U, T> {\n    return (other as U)[this.otherFieldName] as any;\n  }\n\n  private get isCascadeDelete(): boolean {\n    return isCascadeDelete(this, this.fieldName);\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 current() first b/c a new entity won't have an id yet\n    const current = this.current();\n    if (isEntity(current)) return current as U;\n    const { idTaggedMaybe } = this;\n    return idTaggedMaybe !== undefined ? (this.entity.em.getEntity(idTaggedMaybe) as U) : undefined;\n  }\n\n  [RelationT]: T = null!;\n  [RelationU]: U = null!;\n  [ReferenceN]: N = null!;\n}\n\n/**\n * Fails when we can't return an `.id` for a reference, i.e. it's unset or a new entity.\n *\n * We strictly type `book.author.id` as `AuthorId`, even if `book.author` is nullable, to\n * avoid users calling `.id` and getting back `undefined`, but not because \"there is no\n * author\", but only because \"the assigned author doesn't have an id assigned yet\".\n *\n * To handle nullable references, set `.idIfSet`.\n *\n * Assumes being called like `return idMaybe ?? failNoId()`, i.e. if we're called we\n * know the id is not available.\n */\nexport function failNoId(entity: Entity, fieldName: string, current: string | Entity | undefined): never {\n  if (!current) fail(`Reference ${entity}.${fieldName} is unset`);\n  // Throw NoIdError, which lets ReactionsManager will handle reactive fields gracefully\n  if (current instanceof BaseEntity)\n    throw new NoIdError(`Reference ${entity}.${fieldName} is assigned to a new entity`);\n  fail(`Unreachable`);\n}\n\n/**\n * Fails when we can't return an `.idIfSet` for a reference, i.e. it's a new entity.\n *\n * Assumes being called like `return idMaybe ?? failIfNewEntity()`, i.e. if we're called we\n * know the id is not available.\n */\nexport function failIfNewEntity(entity: Entity, fieldName: string, current: string | Entity | undefined): undefined {\n  if (current instanceof BaseEntity) {\n    throw new NoIdError(`Reference ${entity}.${fieldName} is assigned to a new entity`);\n  }\n  // Since this is a `.idIfSet`, having no `current` is fine, return undefined.\n  return undefined;\n}\n\ninterface M2OState<U extends Entity, N extends never | undefined> {\n  readonly isLoaded: boolean;\n  maybeInstantLoad(): M2OState<U, N>;\n  applyLoad(loaded: U | N | undefined): M2OLoadedState<U, N>;\n  import(target: ManyToOneReferenceImpl<any, any, any>, findEntity: (e: U) => U): M2OState<U, N>;\n  doGet(): U | N | undefined;\n}\n\nclass M2OUnloadedState<U extends Entity, N extends never | undefined> implements M2OState<U, N> {\n  readonly isLoaded = false;\n  #m2o: ManyToOneReferenceImpl<any, any, any>;\n  constructor(m2o: ManyToOneReferenceImpl<any, any, any>) {\n    this.#m2o = m2o;\n  }\n  applyLoad(loaded: U | N | undefined): M2OLoadedState<U, N> {\n    return new M2OLoadedState<U, N>(this.#m2o, loaded);\n  }\n  import(target: ManyToOneReferenceImpl<any, any, any>): M2OState<U, N> {\n    return new M2OUnloadedState<U, N>(target);\n  }\n  maybeInstantLoad(): M2OState<U, N> {\n    const current = this.#m2o.current();\n    if (current === undefined || isEntity(current)) {\n      return new M2OLoadedState<U, N>(this.#m2o, current as U | undefined);\n    } else {\n      const maybeFound = this.#m2o.entity.em.getEntity(current);\n      if (maybeFound) {\n        return new M2OLoadedState<U, N>(this.#m2o, maybeFound as U);\n      }\n    }\n    return this;\n  }\n  doGet(): U | N | undefined {\n    throw new Error(`${this.#m2o.entity}.${this.#m2o.fieldName} was not loaded`);\n  }\n}\n\n/** The when loaded, with either the loaded entity or undefined. */\nclass M2OLoadedState<U extends Entity, N extends never | undefined> implements M2OState<U, N> {\n  readonly isLoaded = true;\n  #m2o: ManyToOneReferenceImpl<any, any, any>;\n  #loaded: U | N | undefined;\n  constructor(m2o: ManyToOneReferenceImpl<any, any, any>, loaded: U | N | undefined) {\n    this.#loaded = loaded;\n    this.#m2o = m2o;\n  }\n  applyLoad(loaded: U | N | undefined): M2OLoadedState<U, N> {\n    return new M2OLoadedState<U, N>(this.#m2o, loaded);\n  }\n  import(target: ManyToOneReferenceImpl<any, any, any>, findEntity: (e: U) => U): M2OState<U, N> {\n    return new M2OLoadedState<U, N>(target, isEntity(this.#loaded) ? findEntity(this.#loaded) : undefined);\n  }\n  maybeInstantLoad(): M2OState<U, N> {\n    return this;\n  }\n  doGet(): U | N | undefined {\n    return this.#loaded;\n  }\n}\n"],"mappings":"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"}

package/build/relations/ManyToOneReference.d.cts

@@ -8,10 +8,10 @@ import { IdOf, TaggedId } from "../EntityManager.cjs";
 import { Entity } from "../Entity.cjs";
 //#region src/relations/ManyToOneReference.d.ts
 /** An alias for creating `ManyToOneReference`s. */
-declare function hasOne<T extends Entity, U extends Entity, N extends never | undefined>(): ManyToOneReference<T, U, N>;
+export declare function hasOne<T extends Entity, U extends Entity, N extends never | undefined>(): ManyToOneReference<T, U, N>;
 /** Type guard utility for determining if an entity field is a ManyToOneReference. */
-declare function isManyToOneReference(maybeReference: any): maybeReference is ManyToOneReference<any, any, any>;
-interface ManyToOneReference<T extends Entity, U extends Entity, N extends never | undefined> extends Reference<T, U, N> {
+export declare function isManyToOneReference(maybeReference: any): maybeReference is ManyToOneReference<any, any, any>;
+export interface ManyToOneReference<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. */
@@ -34,7 +34,7 @@ interface ManyToOneReference<T extends Entity, U extends Entity, N extends never
  * be half of a one-to-one relationship, but we'll keep using this `ManyToOneReference` on the "many"
  * side, and the other side, i.e. `Author.image` will use a `OneToOneReference` to point back to us.
  */
-declare class ManyToOneReferenceImpl<T extends Entity, U extends Entity, N extends never | undefined> extends AbstractRelationImpl<T, U> implements ManyToOneReference<T, U, N> {
+export declare class ManyToOneReferenceImpl<T extends Entity, U extends Entity, N extends never | undefined> extends AbstractRelationImpl<T, U> implements ManyToOneReference<T, U, N> {
   #private;
   constructor(entity: T, field: ManyToOneField);
   load(opts?: {
@@ -108,14 +108,13 @@ declare class ManyToOneReferenceImpl<T extends Entity, U extends Entity, N exten
  * Assumes being called like `return idMaybe ?? failNoId()`, i.e. if we're called we
  * know the id is not available.
  */
-declare function failNoId(entity: Entity, fieldName: string, current: string | Entity | undefined): never;
+export declare function failNoId(entity: Entity, fieldName: string, current: string | Entity | undefined): never;
 /**
  * Fails when we can't return an `.idIfSet` for a reference, i.e. it's a new entity.
  *
  * Assumes being called like `return idMaybe ?? failIfNewEntity()`, i.e. if we're called we
  * know the id is not available.
  */
-declare function failIfNewEntity(entity: Entity, fieldName: string, current: string | Entity | undefined): undefined;
+export declare function failIfNewEntity(entity: Entity, fieldName: string, current: string | Entity | undefined): undefined;
 //#endregion
-export { ManyToOneReference, ManyToOneReferenceImpl, failIfNewEntity, failNoId, hasOne, isManyToOneReference };
 //# sourceMappingURL=ManyToOneReference.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ManyToOneReference.d.cts","names":[],"sources":["../../src/relations/ManyToOneReference.ts"],"mappings":";;;;;;;;;;iBA4BgB,OAAO,UAAU,QAAQ,UAAU,QAAQ,gCAAgC,mBAAmB,GAAG,GAAG;;iBAQpG,qBAAqB,sBAAsB,kBAAkB;UAI5D,mBAAmB,UAAU,QAAQ,UAAU,QAAQ,qCAAqC,UAC3G,GACA,GACA;;EAGA,IAAI,KAAK;;EAGT,SAAS,KAAK;;EAGd,SAAS,KAAK;EAEd;EAEA;;WAGS;;;;;;;;;;;;;cAcE,uBAAuB,UAAU,QAAQ,UAAU,QAAQ,qCAC9D,qBAAqB,GAAG,cACrB,mBAAmB,GAAG,GAAG;;EAOpC,YAAY,QAAQ,GAAG,OAAO;EAQxB,KAAK;IAAQ;IAAuB;MAA+B,QAAQ,IAAI;EAqBrF,IAAI,OAAO,IAAI;MAIX;MAIA;MAMA;EAIJ;UAIQ;;EAMR,OAAO,QAAQ,uBAAuB,GAAG,GAAG,IAAI,aAAa,GAAG,MAAM;UAI9D;MAMJ,kBAAkB,IAAI;MAItB,OAAO,IAAI;;MAKX,MAAM,KAAK;;MAKX,GAAG,IAAI,KAAK,KAAK;MAkBjB,WAAW,KAAK,KAAK;MAIrB;MAIA;MAIA,WAAW,KAAK,KAAK;;MAMrB,iBAAiB;MAMjB;MAIA,wBAAwB;cAIhB;EAiCZ,YAAY,OAAO,IAAI,KAAK,KAAK;EAIjC;EAgBM,0BAA0B;EAqFhC,QAAQ;IAAS;MAA0B,IAAI,WAAW;MAQtD,aAAa,eAAe;MAI5B;EAIG;;;;;;;;;;UAaC;;UAQA;cAMI;;;;;EAQZ,mBAAmB;GAQlB,YAAY;GACZ,YAAY;GACZ,aAAa;;;;;;;;;;;;;;iBAeA,SAAS,QAAQ,QAAQ,mBAAmB,kBAAkB;;;;;;;iBAc9D,gBAAgB,QAAQ,QAAQ,mBAAmB,kBAAkB"}
+{"version":3,"file":"ManyToOneReference.d.cts","names":[],"sources":["../../src/relations/ManyToOneReference.ts"],"mappings":";;;;;;;;;;wBA4BgB,OAAO,UAAU,QAAQ,UAAU,QAAQ,gCAAgC,mBAAmB,GAAG,GAAG;;wBAQpG,qBAAqB,sBAAsB,kBAAkB;iBAI5D,mBAAmB,UAAU,QAAQ,UAAU,QAAQ,qCAAqC,UAC3G,GACA,GACA;;EAGA,IAAI,KAAK;;EAGT,SAAS,KAAK;;EAGd,SAAS,KAAK;EAEd;EAEA;;WAGS;;;;;;;;;;;;;qBAcE,uBAAuB,UAAU,QAAQ,UAAU,QAAQ,qCAC9D,qBAAqB,GAAG,cACrB,mBAAmB,GAAG,GAAG;;EAOpC,YAAY,QAAQ,GAAG,OAAO;EAQxB,KAAK;IAAQ;IAAuB;MAA+B,QAAQ,IAAI;EAqBrF,IAAI,OAAO,IAAI;MAIX;MAIA;MAMA;EAIJ;UAIQ;;EAMR,OAAO,QAAQ,uBAAuB,GAAG,GAAG,IAAI,aAAa,GAAG,MAAM;UAI9D;MAMJ,kBAAkB,IAAI;MAItB,OAAO,IAAI;;MAKX,MAAM,KAAK;;MAKX,GAAG,IAAI,KAAK,KAAK;MAkBjB,WAAW,KAAK,KAAK;MAIrB;MAIA;MAIA,WAAW,KAAK,KAAK;;MAMrB,iBAAiB;MAMjB;MAIA,wBAAwB;cAIhB;EAiCZ,YAAY,OAAO,IAAI,KAAK,KAAK;EAIjC;EAgBM,0BAA0B;EAqFhC,QAAQ;IAAS;MAA0B,IAAI,WAAW;MAQtD,aAAa,eAAe;MAI5B;EAIG;;;;;;;;;;UAaC;;UAQA;cAMI;;;;;EAQZ,mBAAmB;GAQlB,YAAY;GACZ,YAAY;GACZ,aAAa;;;;;;;;;;;;;;wBAeA,SAAS,QAAQ,QAAQ,mBAAmB,kBAAkB;;;;;;;wBAc9D,gBAAgB,QAAQ,QAAQ,mBAAmB,kBAAkB"}

package/build/relations/ManyToOneReference.d.mts

@@ -8,10 +8,10 @@ import { IdOf, TaggedId } from "../EntityManager.mjs";
 import { Entity } from "../Entity.mjs";
 //#region src/relations/ManyToOneReference.d.ts
 /** An alias for creating `ManyToOneReference`s. */
-declare function hasOne<T extends Entity, U extends Entity, N extends never | undefined>(): ManyToOneReference<T, U, N>;
+export declare function hasOne<T extends Entity, U extends Entity, N extends never | undefined>(): ManyToOneReference<T, U, N>;
 /** Type guard utility for determining if an entity field is a ManyToOneReference. */
-declare function isManyToOneReference(maybeReference: any): maybeReference is ManyToOneReference<any, any, any>;
-interface ManyToOneReference<T extends Entity, U extends Entity, N extends never | undefined> extends Reference<T, U, N> {
+export declare function isManyToOneReference(maybeReference: any): maybeReference is ManyToOneReference<any, any, any>;
+export interface ManyToOneReference<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. */
@@ -34,7 +34,7 @@ interface ManyToOneReference<T extends Entity, U extends Entity, N extends never
  * be half of a one-to-one relationship, but we'll keep using this `ManyToOneReference` on the "many"
  * side, and the other side, i.e. `Author.image` will use a `OneToOneReference` to point back to us.
  */
-declare class ManyToOneReferenceImpl<T extends Entity, U extends Entity, N extends never | undefined> extends AbstractRelationImpl<T, U> implements ManyToOneReference<T, U, N> {
+export declare class ManyToOneReferenceImpl<T extends Entity, U extends Entity, N extends never | undefined> extends AbstractRelationImpl<T, U> implements ManyToOneReference<T, U, N> {
   #private;
   constructor(entity: T, field: ManyToOneField);
   load(opts?: {
@@ -108,14 +108,13 @@ declare class ManyToOneReferenceImpl<T extends Entity, U extends Entity, N exten
  * Assumes being called like `return idMaybe ?? failNoId()`, i.e. if we're called we
  * know the id is not available.
  */
-declare function failNoId(entity: Entity, fieldName: string, current: string | Entity | undefined): never;
+export declare function failNoId(entity: Entity, fieldName: string, current: string | Entity | undefined): never;
 /**
  * Fails when we can't return an `.idIfSet` for a reference, i.e. it's a new entity.
  *
  * Assumes being called like `return idMaybe ?? failIfNewEntity()`, i.e. if we're called we
  * know the id is not available.
  */
-declare function failIfNewEntity(entity: Entity, fieldName: string, current: string | Entity | undefined): undefined;
+export declare function failIfNewEntity(entity: Entity, fieldName: string, current: string | Entity | undefined): undefined;
 //#endregion
-export { ManyToOneReference, ManyToOneReferenceImpl, failIfNewEntity, failNoId, hasOne, isManyToOneReference };
 //# sourceMappingURL=ManyToOneReference.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ManyToOneReference.d.mts","names":[],"sources":["../../src/relations/ManyToOneReference.ts"],"mappings":";;;;;;;;;;iBA4BgB,OAAO,UAAU,QAAQ,UAAU,QAAQ,gCAAgC,mBAAmB,GAAG,GAAG;;iBAQpG,qBAAqB,sBAAsB,kBAAkB;UAI5D,mBAAmB,UAAU,QAAQ,UAAU,QAAQ,qCAAqC,UAC3G,GACA,GACA;;EAGA,IAAI,KAAK;;EAGT,SAAS,KAAK;;EAGd,SAAS,KAAK;EAEd;EAEA;;WAGS;;;;;;;;;;;;;cAcE,uBAAuB,UAAU,QAAQ,UAAU,QAAQ,qCAC9D,qBAAqB,GAAG,cACrB,mBAAmB,GAAG,GAAG;;EAOpC,YAAY,QAAQ,GAAG,OAAO;EAQxB,KAAK;IAAQ;IAAuB;MAA+B,QAAQ,IAAI;EAqBrF,IAAI,OAAO,IAAI;MAIX;MAIA;MAMA;EAIJ;UAIQ;;EAMR,OAAO,QAAQ,uBAAuB,GAAG,GAAG,IAAI,aAAa,GAAG,MAAM;UAI9D;MAMJ,kBAAkB,IAAI;MAItB,OAAO,IAAI;;MAKX,MAAM,KAAK;;MAKX,GAAG,IAAI,KAAK,KAAK;MAkBjB,WAAW,KAAK,KAAK;MAIrB;MAIA;MAIA,WAAW,KAAK,KAAK;;MAMrB,iBAAiB;MAMjB;MAIA,wBAAwB;cAIhB;EAiCZ,YAAY,OAAO,IAAI,KAAK,KAAK;EAIjC;EAgBM,0BAA0B;EAqFhC,QAAQ;IAAS;MAA0B,IAAI,WAAW;MAQtD,aAAa,eAAe;MAI5B;EAIG;;;;;;;;;;UAaC;;UAQA;cAMI;;;;;EAQZ,mBAAmB;GAQlB,YAAY;GACZ,YAAY;GACZ,aAAa;;;;;;;;;;;;;;iBAeA,SAAS,QAAQ,QAAQ,mBAAmB,kBAAkB;;;;;;;iBAc9D,gBAAgB,QAAQ,QAAQ,mBAAmB,kBAAkB"}
+{"version":3,"file":"ManyToOneReference.d.mts","names":[],"sources":["../../src/relations/ManyToOneReference.ts"],"mappings":";;;;;;;;;;wBA4BgB,OAAO,UAAU,QAAQ,UAAU,QAAQ,gCAAgC,mBAAmB,GAAG,GAAG;;wBAQpG,qBAAqB,sBAAsB,kBAAkB;iBAI5D,mBAAmB,UAAU,QAAQ,UAAU,QAAQ,qCAAqC,UAC3G,GACA,GACA;;EAGA,IAAI,KAAK;;EAGT,SAAS,KAAK;;EAGd,SAAS,KAAK;EAEd;EAEA;;WAGS;;;;;;;;;;;;;qBAcE,uBAAuB,UAAU,QAAQ,UAAU,QAAQ,qCAC9D,qBAAqB,GAAG,cACrB,mBAAmB,GAAG,GAAG;;EAOpC,YAAY,QAAQ,GAAG,OAAO;EAQxB,KAAK;IAAQ;IAAuB;MAA+B,QAAQ,IAAI;EAqBrF,IAAI,OAAO,IAAI;MAIX;MAIA;MAMA;EAIJ;UAIQ;;EAMR,OAAO,QAAQ,uBAAuB,GAAG,GAAG,IAAI,aAAa,GAAG,MAAM;UAI9D;MAMJ,kBAAkB,IAAI;MAItB,OAAO,IAAI;;MAKX,MAAM,KAAK;;MAKX,GAAG,IAAI,KAAK,KAAK;MAkBjB,WAAW,KAAK,KAAK;MAIrB;MAIA;MAIA,WAAW,KAAK,KAAK;;MAMrB,iBAAiB;MAMjB;MAIA,wBAAwB;cAIhB;EAiCZ,YAAY,OAAO,IAAI,KAAK,KAAK;EAIjC;EAgBM,0BAA0B;EAqFhC,QAAQ;IAAS;MAA0B,IAAI,WAAW;MAQtD,aAAa,eAAe;MAI5B;EAIG;;;;;;;;;;UAaC;;UAQA;cAMI;;;;;EAQZ,mBAAmB;GAQlB,YAAY;GACZ,YAAY;GACZ,aAAa;;;;;;;;;;;;;;wBAeA,SAAS,QAAQ,QAAQ,mBAAmB,kBAAkB;;;;;;;wBAc9D,gBAAgB,QAAQ,QAAQ,mBAAmB,kBAAkB"}

package/build/relations/ManyToOneReference.js.map

@@ -1 +1 @@
-{"version":3,"file":"ManyToOneReference.js","names":["#field","#state","#loadPromise","#setImpl","#percolateRemove","#percolateAdd","#hasBeenSet","#m2o","#loaded"],"sources":["../../src/relations/ManyToOneReference.ts"],"sourcesContent":["import { type Entity, isEntity } from \"src/Entity.ts\";\nimport { type IdOf, type TaggedId, getEmInternalApi, sameEntity } from \"src/EntityManager.ts\";\nimport { type EntityMetadata, type ManyToOneField, getMetadata } from \"src/EntityMetadata.ts\";\nimport { getField, setField } from \"src/fields.ts\";\nimport {\n  BaseEntity,\n  NoIdError,\n  OneToManyLargeCollection,\n  OneToOneReferenceImpl,\n  type Reference,\n  deTagId,\n  ensureNotDeleted,\n  ensureTagged,\n  fail,\n  getInstanceData,\n  maybeResolveReferenceToId,\n  toIdOf,\n  toTaggedId,\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 { OneToManyCollection } from \"src/relations/OneToManyCollection.ts\";\nimport { ReferenceN } from \"src/relations/ReferenceSymbols.ts\";\nimport { RelationT, RelationU } from \"src/relations/RelationSymbols.ts\";\nimport { maybeAdd, maybeRemove } from \"src/utils.ts\";\n\n/** An alias for creating `ManyToOneReference`s. */\nexport function hasOne<T extends Entity, U extends Entity, N extends never | undefined>(): ManyToOneReference<T, U, N> {\n  return lazyField((entity: T, fieldName) => {\n    const m2o = getMetadata(entity).allFields[fieldName] as ManyToOneField;\n    return new ManyToOneReferenceImpl<T, U, N>(entity, m2o);\n  });\n}\n\n/** Type guard utility for determining if an entity field is a ManyToOneReference. */\nexport function isManyToOneReference(maybeReference: any): maybeReference is ManyToOneReference<any, any, any> {\n  return maybeReference instanceof ManyToOneReferenceImpl;\n}\n\nexport interface ManyToOneReference<T extends Entity, U extends Entity, N extends never | undefined> extends Reference<\n  T,\n  U,\n  N\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  idUntagged: string;\n\n  idUntaggedIfSet: 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/**\n * Manages a foreign key from one entity to another, i.e. `Book.author --> Author`.\n *\n * We keep the current `author` / `author_id` value in the `__orm.data` hash, where the\n * current value could be either the (string) author id from the database, or an entity\n * `Author` that the user has set.\n *\n * Note that if our `images.author_id` column is unique, this `ManyToOneReference` will essentially\n * be half of a one-to-one relationship, but we'll keep using this `ManyToOneReference` on the \"many\"\n * side, and the other side, i.e. `Author.image` will use a `OneToOneReference` to point back to us.\n */\nexport class ManyToOneReferenceImpl<T extends Entity, U extends Entity, N extends never | undefined>\n  extends AbstractRelationImpl<T, U>\n  implements ManyToOneReference<T, U, N>\n{\n  readonly #field: ManyToOneField;\n  #state: M2OState<U, N>;\n  #loadPromise: Promise<void> | undefined;\n  #hasBeenSet = false;\n\n  constructor(entity: T, field: ManyToOneField) {\n    super(entity);\n    this.#field = field;\n    this.#state = getInstanceData(entity).isOrWasNew\n      ? new M2OLoadedState<U, N>(this, undefined)\n      : new M2OUnloadedState<U, N>(this);\n  }\n\n  async load(opts: { withDeleted?: boolean; forceReload?: boolean } = {}): Promise<U | N> {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#state = this.#state.maybeInstantLoad();\n    if (!this.#state.isLoaded || opts.forceReload) {\n      const current = this.current();\n      if (isEntity(current) || current === undefined) {\n        this.#state = new M2OLoadedState<U, N>(this, current as U | N | undefined);\n      } else {\n        await (this.#loadPromise ??= this.entity.em.load(this.otherMeta.cstr, current).then((entity) => {\n          this.#loadPromise = undefined;\n          // In extremely rare cases, someone might have called `set` while this promise was in-flight,\n          // so make sure our current value is still the same as the fetched entity.\n          if (sameEntity(entity, this.current())) {\n            this.#state = this.#state.applyLoad(entity);\n          }\n        }));\n      }\n    }\n    return this.filterDeleted(this.#state.doGet() as U | N, 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    // Even if `.load()` has not been called, `.get` will detect\n    this.#state = this.#state.maybeInstantLoad();\n    return this.#state.isLoaded;\n  }\n\n  get isPreloaded(): boolean {\n    return !!this.maybeFindEntity();\n  }\n\n  preload(): void {\n    this.#state = new M2OLoadedState<U, N>(this, this.maybeFindEntity());\n  }\n\n  private unload(): void {\n    this.#state = new M2OUnloadedState<U, N>(this);\n    this.#loadPromise = undefined;\n  }\n\n  /** Copy another em's `source` relation into our state. */\n  import(source: ManyToOneReferenceImpl<T, U, N>, findEntity: (e: U) => U): void {\n    this.#state = source.#state.import(this, findEntity);\n  }\n\n  private doGet(opts?: { withDeleted?: boolean }): U | N {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#state = this.#state.maybeInstantLoad();\n    return this.filterDeleted(this.#state.doGet() as U | N, 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  /** Returns the id of the current value. */\n  get id(): IdOf<U> {\n    return this.idMaybe || failNoId(this.entity, this.fieldName, this.current());\n  }\n\n  /** Sets the m2o to `id`, and allows accepting `undefined` (`N`) if this is a nullable relation. */\n  set id(id: IdOf<U> | N) {\n    ensureNotDeleted(this.entity, \"pending\");\n    const newId = toTaggedId(this.otherMeta, id);\n\n    const previousId = this.idTaggedMaybe;\n    const previous = this.maybeFindEntity();\n    const changed = setField(this.entity, this.fieldName, id);\n    if (!changed) {\n      return;\n    }\n\n    const loaded = newId ? (this.entity.em.getEntity(newId) as U) : undefined;\n    this.#state = loaded ? new M2OLoadedState<U, N>(this, loaded) : new M2OUnloadedState<U, N>(this);\n    this.#loadPromise = undefined;\n    this.#percolateRemove(previousId, previous);\n    this.#percolateAdd();\n  }\n\n  get idIfSet(): IdOf<U> | N | undefined {\n    return this.idMaybe || failIfNewEntity(this.entity, this.fieldName, this.current());\n  }\n\n  get idUntagged(): string {\n    return this.idUntaggedMaybe || failNoId(this.entity, this.fieldName, this.current());\n  }\n\n  get idUntaggedIfSet(): string | undefined {\n    return this.idUntaggedMaybe || failIfNewEntity(this.entity, this.fieldName, this.current());\n  }\n\n  get idMaybe(): IdOf<U> | N | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    return toIdOf(this.otherMeta, this.idTaggedMaybe);\n  }\n\n  /** Returns the tagged id of the current value, or undefined if unset or a new entity. */\n  get idTaggedMaybe(): TaggedId | undefined {\n    // Skip the deleted check so that `isPreloaded` doesn't blow up during em.refreshes/populates\n    // ensureNotDeleted(this.entity, \"pending\");\n    return maybeResolveReferenceToId(this.current());\n  }\n\n  get fieldName(): string {\n    return this.#field.fieldName;\n  }\n\n  get otherFieldName(): keyof U & string {\n    return this.#field.otherFieldName as keyof U & string;\n  }\n\n  private get idUntaggedMaybe(): string | undefined {\n    return deTagId(this.otherMeta, this.idMaybe);\n  }\n\n  #setImpl(_other: U | IdOf<U> | N): void {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#hasBeenSet = true;\n\n    // If the project is not using tagged ids, we still want it tagged internally\n    const other = ensureTagged(this.otherMeta, _other);\n    if (sameEntity(other, this.current({ withDeleted: true }))) {\n      return;\n    }\n\n    const previousId = this.idTaggedMaybe;\n    const previous = this.maybeFindEntity();\n    // Prefer to keep the id in our data hash, but if this is a new entity w/o an id, use the entity itself\n    setField(this.entity, this.fieldName, isEntity(other) ? (other?.idTaggedMaybe ?? other) : other);\n\n    // Setting to an entity | undefined => loaded, setting to an id might reverse to unloaded\n    const maybeEntity = isEntity(other) ? (other as U) : other ? this.entity.em.getEntity(other) : undefined;\n    if (maybeEntity || other === undefined) {\n      this.#state = new M2OLoadedState<U, N>(this, (maybeEntity ?? other) as U | N);\n    } else {\n      this.#state = new M2OUnloadedState<U, N>(this);\n    }\n    this.#loadPromise = undefined;\n    this.#percolateRemove(previousId, previous);\n    this.#percolateAdd();\n  }\n\n  // private impl\n\n  setFromOpts(other: U | IdOf<U> | N): 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) {\n        if (typeof current === \"string\") {\n          // We're invoked twice, once sync on em.delete, and again in em.flush when we're loaded;\n          // but even when loaded, current might still be the tagged id, but we can find the entity in the EM\n          const other = this.entity.em.getEntity(current);\n          if (other) this.entity.em.delete(other as U);\n        } else {\n          this.entity.em.delete(current as U);\n        }\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 if (o2m instanceof OneToManyLargeCollection) {\n        o2m.remove(this.entity);\n      } else if (o2m instanceof OneToOneReferenceImpl) {\n        o2m.set(undefined as any);\n      } else {\n        throw new Error(`Unhandled ${o2m}`);\n      }\n    }\n    setField(this.entity, this.fieldName, undefined);\n    this.#state = new M2OLoadedState<U, N>(this, undefined as any);\n  }\n\n  // Called on `book.author.set(...)` with our previous value, to percolate a `author.books.remove`. */\n  #percolateRemove(prevId: string | undefined, prevEntity: U | undefined) {\n    if (prevEntity) {\n      const prevRelation = this.getOtherRelation(prevEntity);\n      if (prevRelation instanceof OneToManyCollection) {\n        prevRelation.removeIfLoaded(this.entity);\n      } else if (prevRelation instanceof OneToManyLargeCollection) {\n        prevRelation.remove(this.entity);\n      } else {\n        prevRelation.set(undefined as any, { percolating: true });\n      }\n    } else if (prevId) {\n      // prevEntity is not loaded in memory, but cache it in case our other side is later loaded\n      const { em } = this.entity;\n      let map = getEmInternalApi(em).pendingPercolate.get(prevId);\n      if (!map) {\n        map = new Map();\n        getEmInternalApi(em).pendingPercolate.set(prevId, map);\n      }\n      let pending = map.get(this.otherFieldName);\n      if (!pending) {\n        pending = { adds: [], removes: [] };\n        map.set(this.otherFieldName, pending);\n      }\n      maybeAdd(pending.removes, this.entity);\n      maybeRemove(pending.adds, this.entity);\n    }\n  }\n\n  #percolateAdd() {\n    const id = this.current();\n    const other = this.maybeFindEntity();\n    if (other) {\n      // Other is already loaded in memory, immediately hook it up\n      const newRelation = this.getOtherRelation(other);\n      if (newRelation instanceof OneToManyCollection) {\n        newRelation.add(this.entity);\n      } else if (newRelation instanceof OneToManyLargeCollection) {\n        newRelation.add(this.entity);\n      } else if (newRelation) {\n        newRelation.set(this.entity, { percolating: true });\n      } else {\n        // Something is wrong, we should always have a relation, but instead\n        // of blowing up here, let this finish b/c it will probably turn into\n        // a validation error.\n      }\n    } else if (typeof id === \"string\") {\n      // Other is not loaded in memory, but cache it in case our other side is later loaded\n      const { em } = this.entity;\n      let map = getEmInternalApi(em).pendingPercolate.get(id);\n      if (!map) {\n        map = new Map();\n        getEmInternalApi(em).pendingPercolate.set(id, map);\n      }\n      let pending = map.get(this.otherFieldName);\n      if (!pending) {\n        pending = { adds: [], removes: [] };\n        map.set(this.otherFieldName, pending);\n      }\n      maybeAdd(pending.adds, this.entity);\n      maybeRemove(pending.removes, this.entity);\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  get otherMeta(): EntityMetadata<U> {\n    return this.#field.otherMetadata();\n  }\n\n  get hasBeenSet(): boolean {\n    return this.#hasBeenSet;\n  }\n\n  public toString(): string {\n    return `ManyToOneReference(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.otherMeta.type}, otherFieldName: ${this.otherFieldName}, id: ${this.idMaybe})`;\n  }\n\n  /**\n   * Removes pending-hard-delete (but not soft-deleted), unless explicitly asked for.\n   *\n   * Note that we leave soft-deleted entities b/c the call signature of a `book.author.get`\n   * very likely does not expect a soft-deleted entity to result in `undefined`.\n   *\n   * (Contrasted with `author.books.get` which is more intuitive to have soft-deleted\n   * entities filtered out, i.e. it doesn't fundamentally change the return type.)\n   */\n  private filterDeleted(entity: U | N, opts?: { withDeleted?: boolean }): U | N {\n    if (entity && (!opts || !opts.withDeleted) && entity.isDeletedEntity) {\n      return undefined!;\n    }\n    return entity;\n  }\n\n  /** Returns the other relation that points back at us, i.e. we're `book.author_id` and this is `Author.books`. */\n  private getOtherRelation(\n    other: U,\n  ): OneToManyCollection<U, T> | OneToOneReferenceImpl<U, T> | OneToManyLargeCollection<U, T> {\n    return (other as U)[this.otherFieldName] as any;\n  }\n\n  private get isCascadeDelete(): boolean {\n    return isCascadeDelete(this, this.fieldName);\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 current() first b/c a new entity won't have an id yet\n    const current = this.current();\n    if (isEntity(current)) return current as U;\n    const { idTaggedMaybe } = this;\n    return idTaggedMaybe !== undefined ? (this.entity.em.getEntity(idTaggedMaybe) as U) : undefined;\n  }\n\n  [RelationT]: T = null!;\n  [RelationU]: U = null!;\n  [ReferenceN]: N = null!;\n}\n\n/**\n * Fails when we can't return an `.id` for a reference, i.e. it's unset or a new entity.\n *\n * We strictly type `book.author.id` as `AuthorId`, even if `book.author` is nullable, to\n * avoid users calling `.id` and getting back `undefined`, but not because \"there is no\n * author\", but only because \"the assigned author doesn't have an id assigned yet\".\n *\n * To handle nullable references, set `.idIfSet`.\n *\n * Assumes being called like `return idMaybe ?? failNoId()`, i.e. if we're called we\n * know the id is not available.\n */\nexport function failNoId(entity: Entity, fieldName: string, current: string | Entity | undefined): never {\n  if (!current) fail(`Reference ${entity}.${fieldName} is unset`);\n  // Throw NoIdError, which lets ReactionsManager will handle reactive fields gracefully\n  if (current instanceof BaseEntity)\n    throw new NoIdError(`Reference ${entity}.${fieldName} is assigned to a new entity`);\n  fail(`Unreachable`);\n}\n\n/**\n * Fails when we can't return an `.idIfSet` for a reference, i.e. it's a new entity.\n *\n * Assumes being called like `return idMaybe ?? failIfNewEntity()`, i.e. if we're called we\n * know the id is not available.\n */\nexport function failIfNewEntity(entity: Entity, fieldName: string, current: string | Entity | undefined): undefined {\n  if (current instanceof BaseEntity) {\n    throw new NoIdError(`Reference ${entity}.${fieldName} is assigned to a new entity`);\n  }\n  // Since this is a `.idIfSet`, having no `current` is fine, return undefined.\n  return undefined;\n}\n\ninterface M2OState<U extends Entity, N extends never | undefined> {\n  readonly isLoaded: boolean;\n  maybeInstantLoad(): M2OState<U, N>;\n  applyLoad(loaded: U | N | undefined): M2OLoadedState<U, N>;\n  import(target: ManyToOneReferenceImpl<any, any, any>, findEntity: (e: U) => U): M2OState<U, N>;\n  doGet(): U | N | undefined;\n}\n\nclass M2OUnloadedState<U extends Entity, N extends never | undefined> implements M2OState<U, N> {\n  readonly isLoaded = false;\n  #m2o: ManyToOneReferenceImpl<any, any, any>;\n  constructor(m2o: ManyToOneReferenceImpl<any, any, any>) {\n    this.#m2o = m2o;\n  }\n  applyLoad(loaded: U | N | undefined): M2OLoadedState<U, N> {\n    return new M2OLoadedState<U, N>(this.#m2o, loaded);\n  }\n  import(target: ManyToOneReferenceImpl<any, any, any>): M2OState<U, N> {\n    return new M2OUnloadedState<U, N>(target);\n  }\n  maybeInstantLoad(): M2OState<U, N> {\n    const current = this.#m2o.current();\n    if (current === undefined || isEntity(current)) {\n      return new M2OLoadedState<U, N>(this.#m2o, current as U | undefined);\n    } else {\n      const maybeFound = this.#m2o.entity.em.getEntity(current);\n      if (maybeFound) {\n        return new M2OLoadedState<U, N>(this.#m2o, maybeFound as U);\n      }\n    }\n    return this;\n  }\n  doGet(): U | N | undefined {\n    throw new Error(`${this.#m2o.entity}.${this.#m2o.fieldName} was not loaded`);\n  }\n}\n\n/** The when loaded, with either the loaded entity or undefined. */\nclass M2OLoadedState<U extends Entity, N extends never | undefined> implements M2OState<U, N> {\n  readonly isLoaded = true;\n  #m2o: ManyToOneReferenceImpl<any, any, any>;\n  #loaded: U | N | undefined;\n  constructor(m2o: ManyToOneReferenceImpl<any, any, any>, loaded: U | N | undefined) {\n    this.#loaded = loaded;\n    this.#m2o = m2o;\n  }\n  applyLoad(loaded: U | N | undefined): M2OLoadedState<U, N> {\n    return new M2OLoadedState<U, N>(this.#m2o, loaded);\n  }\n  import(target: ManyToOneReferenceImpl<any, any, any>, findEntity: (e: U) => U): M2OState<U, N> {\n    return new M2OLoadedState<U, N>(target, isEntity(this.#loaded) ? findEntity(this.#loaded) : undefined);\n  }\n  maybeInstantLoad(): M2OState<U, N> {\n    return this;\n  }\n  doGet(): U | N | undefined {\n    return this.#loaded;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA4BA,SAAgB,SAAuG;CACrH,OAAO,WAAW,QAAW,cAAc;EACzC,MAAM,MAAM,YAAY,MAAM,CAAC,CAAC,UAAU;EAC1C,OAAO,IAAI,uBAAgC,QAAQ,GAAG;CACxD,CAAC;AACH;;AAGA,SAAgB,qBAAqB,gBAA0E;CAC7G,OAAO,0BAA0B;AACnC;;;;;;;;;;;;AAmCA,IAAa,yBAAb,cACU,qBAEV;CACE;CACA;CACA;CACA,cAAc;CAEd,YAAY,QAAW,OAAuB;EAC5C,MAAM,MAAM;EACZ,KAAKA,SAAS;EACd,KAAKC,SAAS,gBAAgB,MAAM,CAAC,CAAC,aAClC,IAAI,eAAqB,MAAM,KAAA,CAAS,IACxC,IAAI,iBAAuB,IAAI;CACrC;CAEA,MAAM,KAAK,OAAyD,CAAC,GAAmB;EACtF,iBAAiB,KAAK,QAAQ,SAAS;EACvC,KAAKA,SAAS,KAAKA,OAAO,iBAAiB;EAC3C,IAAI,CAAC,KAAKA,OAAO,YAAY,KAAK,aAAa;GAC7C,MAAM,UAAU,KAAK,QAAQ;GAC7B,IAAI,SAAS,OAAO,KAAK,YAAY,KAAA,GACnC,KAAKA,SAAS,IAAI,eAAqB,MAAM,OAA4B;QAEzE,OAAO,KAAKC,iBAAiB,KAAK,OAAO,GAAG,KAAK,KAAK,UAAU,MAAM,OAAO,CAAC,CAAC,MAAM,WAAW;IAC9F,KAAKA,eAAe,KAAA;IAGpB,IAAI,WAAW,QAAQ,KAAK,QAAQ,CAAC,GACnC,KAAKD,SAAS,KAAKA,OAAO,UAAU,MAAM;GAE9C,CAAC;EAEL;EACA,OAAO,KAAK,cAAc,KAAKA,OAAO,MAAM,GAAY,IAAI;CAC9D;CAEA,IAAI,OAAoB;EACtB,KAAKE,SAAS,KAAK;CACrB;CAEA,IAAI,QAAiB;EACnB,OAAO,KAAK,QAAQ,MAAM,KAAA;CAC5B;CAEA,IAAI,WAAoB;EAEtB,KAAKF,SAAS,KAAKA,OAAO,iBAAiB;EAC3C,OAAO,KAAKA,OAAO;CACrB;CAEA,IAAI,cAAuB;EACzB,OAAO,CAAC,CAAC,KAAK,gBAAgB;CAChC;CAEA,UAAgB;EACd,KAAKA,SAAS,IAAI,eAAqB,MAAM,KAAK,gBAAgB,CAAC;CACrE;CAEA,SAAuB;EACrB,KAAKA,SAAS,IAAI,iBAAuB,IAAI;EAC7C,KAAKC,eAAe,KAAA;CACtB;;CAGA,OAAO,QAAyC,YAA+B;EAC7E,KAAKD,SAAS,OAAOA,OAAO,OAAO,MAAM,UAAU;CACrD;CAEA,MAAc,MAAyC;EACrD,iBAAiB,KAAK,QAAQ,SAAS;EACvC,KAAKA,SAAS,KAAKA,OAAO,iBAAiB;EAC3C,OAAO,KAAK,cAAc,KAAKA,OAAO,MAAM,GAAY,IAAI;CAC9D;CAEA,IAAI,iBAAwB;EAC1B,OAAO,KAAK,MAAM,EAAE,aAAa,KAAK,CAAC;CACzC;CAEA,IAAI,MAAa;EACf,OAAO,KAAK,MAAM,EAAE,aAAa,MAAM,CAAC;CAC1C;;CAGA,IAAI,KAAc;EAChB,OAAO,KAAK,WAAW,SAAS,KAAK,QAAQ,KAAK,WAAW,KAAK,QAAQ,CAAC;CAC7E;;CAGA,IAAI,GAAG,IAAiB;EACtB,iBAAiB,KAAK,QAAQ,SAAS;EACvC,MAAM,QAAQ,WAAW,KAAK,WAAW,EAAE;EAE3C,MAAM,aAAa,KAAK;EACxB,MAAM,WAAW,KAAK,gBAAgB;EAEtC,IAAI,CADY,SAAS,KAAK,QAAQ,KAAK,WAAW,EAC3C,GACT;EAGF,MAAM,SAAS,QAAS,KAAK,OAAO,GAAG,UAAU,KAAK,IAAU,KAAA;EAChE,KAAKA,SAAS,SAAS,IAAI,eAAqB,MAAM,MAAM,IAAI,IAAI,iBAAuB,IAAI;EAC/F,KAAKC,eAAe,KAAA;EACpB,KAAKE,iBAAiB,YAAY,QAAQ;EAC1C,KAAKC,cAAc;CACrB;CAEA,IAAI,UAAmC;EACrC,OAAO,KAAK,WAAW,gBAAgB,KAAK,QAAQ,KAAK,WAAW,KAAK,QAAQ,CAAC;CACpF;CAEA,IAAI,aAAqB;EACvB,OAAO,KAAK,mBAAmB,SAAS,KAAK,QAAQ,KAAK,WAAW,KAAK,QAAQ,CAAC;CACrF;CAEA,IAAI,kBAAsC;EACxC,OAAO,KAAK,mBAAmB,gBAAgB,KAAK,QAAQ,KAAK,WAAW,KAAK,QAAQ,CAAC;CAC5F;CAEA,IAAI,UAAmC;EACrC,iBAAiB,KAAK,QAAQ,SAAS;EACvC,OAAO,OAAO,KAAK,WAAW,KAAK,aAAa;CAClD;;CAGA,IAAI,gBAAsC;EAGxC,OAAO,0BAA0B,KAAK,QAAQ,CAAC;CACjD;CAEA,IAAI,YAAoB;EACtB,OAAO,KAAKL,OAAO;CACrB;CAEA,IAAI,iBAAmC;EACrC,OAAO,KAAKA,OAAO;CACrB;CAEA,IAAY,kBAAsC;EAChD,OAAO,QAAQ,KAAK,WAAW,KAAK,OAAO;CAC7C;CAEA,SAAS,QAA+B;EACtC,iBAAiB,KAAK,QAAQ,SAAS;EACvC,KAAKM,cAAc;EAGnB,MAAM,QAAQ,aAAa,KAAK,WAAW,MAAM;EACjD,IAAI,WAAW,OAAO,KAAK,QAAQ,EAAE,aAAa,KAAK,CAAC,CAAC,GACvD;EAGF,MAAM,aAAa,KAAK;EACxB,MAAM,WAAW,KAAK,gBAAgB;EAEtC,SAAS,KAAK,QAAQ,KAAK,WAAW,SAAS,KAAK,IAAK,OAAO,iBAAiB,QAAS,KAAK;EAG/F,MAAM,cAAc,SAAS,KAAK,IAAK,QAAc,QAAQ,KAAK,OAAO,GAAG,UAAU,KAAK,IAAI,KAAA;EAC/F,IAAI,eAAe,UAAU,KAAA,GAC3B,KAAKL,SAAS,IAAI,eAAqB,MAAO,eAAe,KAAe;OAE5E,KAAKA,SAAS,IAAI,iBAAuB,IAAI;EAE/C,KAAKC,eAAe,KAAA;EACpB,KAAKE,iBAAiB,YAAY,QAAQ;EAC1C,KAAKC,cAAc;CACrB;CAIA,YAAY,OAA8B;EACxC,KAAKF,SAAS,KAAK;CACrB;CAEA,qBAA2B;EACzB,IAAI,KAAK,iBAAiB;GACxB,MAAM,UAAU,KAAK,QAAQ,EAAE,aAAa,KAAK,CAAC;GAClD,IAAI,YAAY,KAAA,GAAW;IACzB,IAAI,OAAO,YAAY,UAAU;KAG/B,MAAM,QAAQ,KAAK,OAAO,GAAG,UAAU,OAAO;KAC9C,IAAI,OAAO,KAAK,OAAO,GAAG,OAAO,KAAU;IAC7C,OACE,KAAK,OAAO,GAAG,OAAO,OAAY;GAEtC;EACF;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,eAAe,qBACjB,IAAI,OAAO,KAAK,QAAQ,EAAE,eAAe,MAAM,CAAC;QAC3C,IAAI,eAAe,0BACxB,IAAI,OAAO,KAAK,MAAM;QACjB,IAAI,eAAe,uBACxB,IAAI,IAAI,KAAA,CAAgB;QAExB,MAAM,IAAI,MAAM,aAAa,KAAK;EAEtC;EACA,SAAS,KAAK,QAAQ,KAAK,WAAW,KAAA,CAAS;EAC/C,KAAKF,SAAS,IAAI,eAAqB,MAAM,KAAA,CAAgB;CAC/D;CAGA,iBAAiB,QAA4B,YAA2B;EACtE,IAAI,YAAY;GACd,MAAM,eAAe,KAAK,iBAAiB,UAAU;GACrD,IAAI,wBAAwB,qBAC1B,aAAa,eAAe,KAAK,MAAM;QAClC,IAAI,wBAAwB,0BACjC,aAAa,OAAO,KAAK,MAAM;QAE/B,aAAa,IAAI,KAAA,GAAkB,EAAE,aAAa,KAAK,CAAC;EAE5D,OAAO,IAAI,QAAQ;GAEjB,MAAM,EAAE,OAAO,KAAK;GACpB,IAAI,MAAM,iBAAiB,EAAE,CAAC,CAAC,iBAAiB,IAAI,MAAM;GAC1D,IAAI,CAAC,KAAK;IACR,sBAAM,IAAI,IAAI;IACd,iBAAiB,EAAE,CAAC,CAAC,iBAAiB,IAAI,QAAQ,GAAG;GACvD;GACA,IAAI,UAAU,IAAI,IAAI,KAAK,cAAc;GACzC,IAAI,CAAC,SAAS;IACZ,UAAU;KAAE,MAAM,CAAC;KAAG,SAAS,CAAC;IAAE;IAClC,IAAI,IAAI,KAAK,gBAAgB,OAAO;GACtC;GACA,SAAS,QAAQ,SAAS,KAAK,MAAM;GACrC,YAAY,QAAQ,MAAM,KAAK,MAAM;EACvC;CACF;CAEA,gBAAgB;EACd,MAAM,KAAK,KAAK,QAAQ;EACxB,MAAM,QAAQ,KAAK,gBAAgB;EACnC,IAAI,OAAO;GAET,MAAM,cAAc,KAAK,iBAAiB,KAAK;GAC/C,IAAI,uBAAuB,qBACzB,YAAY,IAAI,KAAK,MAAM;QACtB,IAAI,uBAAuB,0BAChC,YAAY,IAAI,KAAK,MAAM;QACtB,IAAI,aACT,YAAY,IAAI,KAAK,QAAQ,EAAE,aAAa,KAAK,CAAC;EAMtD,OAAO,IAAI,OAAO,OAAO,UAAU;GAEjC,MAAM,EAAE,OAAO,KAAK;GACpB,IAAI,MAAM,iBAAiB,EAAE,CAAC,CAAC,iBAAiB,IAAI,EAAE;GACtD,IAAI,CAAC,KAAK;IACR,sBAAM,IAAI,IAAI;IACd,iBAAiB,EAAE,CAAC,CAAC,iBAAiB,IAAI,IAAI,GAAG;GACnD;GACA,IAAI,UAAU,IAAI,IAAI,KAAK,cAAc;GACzC,IAAI,CAAC,SAAS;IACZ,UAAU;KAAE,MAAM,CAAC;KAAG,SAAS,CAAC;IAAE;IAClC,IAAI,IAAI,KAAK,gBAAgB,OAAO;GACtC;GACA,SAAS,QAAQ,MAAM,KAAK,MAAM;GAClC,YAAY,QAAQ,SAAS,KAAK,MAAM;EAC1C;CACF;CAGA,QAAQ,MAAoD;EAC1D,MAAM,UAAU,SAAS,KAAK,QAAQ,KAAK,SAAS;EACpD,IAAI,YAAY,KAAA,KAAa,SAAS,OAAO,GAC3C,OAAO,KAAK,cAAc,SAAc,IAAI;EAE9C,OAAO;CACT;CAEA,IAAI,YAA+B;EACjC,OAAO,KAAKD,OAAO,cAAc;CACnC;CAEA,IAAI,aAAsB;EACxB,OAAO,KAAKM;CACd;CAEA,WAA0B;EACxB,OAAO,8BAA8B,KAAK,OAAO,eAAe,KAAK,UAAU,eAAe,KAAK,UAAU,KAAK,oBAAoB,KAAK,eAAe,QAAQ,KAAK,QAAQ;CACjL;;;;;;;;;;CAWA,cAAsB,QAAe,MAAyC;EAC5E,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,gBAAgB,OAAO,iBACnD;EAEF,OAAO;CACT;;CAGA,iBACE,OAC0F;EAC1F,OAAQ,MAAY,KAAK;CAC3B;CAEA,IAAY,kBAA2B;EACrC,OAAO,gBAAgB,MAAM,KAAK,SAAS;CAC7C;;;;;CAMA,kBAAiC;EAE/B,MAAM,UAAU,KAAK,QAAQ;EAC7B,IAAI,SAAS,OAAO,GAAG,OAAO;EAC9B,MAAM,EAAE,kBAAkB;EAC1B,OAAO,kBAAkB,KAAA,IAAa,KAAK,OAAO,GAAG,UAAU,aAAa,IAAU,KAAA;CACxF;CAEA,CAAC,aAAgB;CACjB,CAAC,aAAgB;CACjB,CAAC,cAAiB;AACpB;;;;;;;;;;;;;AAcA,SAAgB,SAAS,QAAgB,WAAmB,SAA6C;CACvG,IAAI,CAAC,SAAS,KAAK,aAAa,OAAO,GAAG,UAAU,UAAU;CAE9D,IAAI,mBAAmB,YACrB,MAAM,IAAI,UAAU,aAAa,OAAO,GAAG,UAAU,6BAA6B;CACpF,KAAK,aAAa;AACpB;;;;;;;AAQA,SAAgB,gBAAgB,QAAgB,WAAmB,SAAiD;CAClH,IAAI,mBAAmB,YACrB,MAAM,IAAI,UAAU,aAAa,OAAO,GAAG,UAAU,6BAA6B;AAItF;AAUA,IAAM,mBAAN,MAAM,iBAA0F;CAC9F,WAAoB;CACpB;CACA,YAAY,KAA4C;EACtD,KAAKC,OAAO;CACd;CACA,UAAU,QAAiD;EACzD,OAAO,IAAI,eAAqB,KAAKA,MAAM,MAAM;CACnD;CACA,OAAO,QAA+D;EACpE,OAAO,IAAI,iBAAuB,MAAM;CAC1C;CACA,mBAAmC;EACjC,MAAM,UAAU,KAAKA,KAAK,QAAQ;EAClC,IAAI,YAAY,KAAA,KAAa,SAAS,OAAO,GAC3C,OAAO,IAAI,eAAqB,KAAKA,MAAM,OAAwB;OAC9D;GACL,MAAM,aAAa,KAAKA,KAAK,OAAO,GAAG,UAAU,OAAO;GACxD,IAAI,YACF,OAAO,IAAI,eAAqB,KAAKA,MAAM,UAAe;EAE9D;EACA,OAAO;CACT;CACA,QAA2B;EACzB,MAAM,IAAI,MAAM,GAAG,KAAKA,KAAK,OAAO,GAAG,KAAKA,KAAK,UAAU,gBAAgB;CAC7E;AACF;;AAGA,IAAM,iBAAN,MAAM,eAAwF;CAC5F,WAAoB;CACpB;CACA;CACA,YAAY,KAA4C,QAA2B;EACjF,KAAKC,UAAU;EACf,KAAKD,OAAO;CACd;CACA,UAAU,QAAiD;EACzD,OAAO,IAAI,eAAqB,KAAKA,MAAM,MAAM;CACnD;CACA,OAAO,QAA+C,YAAyC;EAC7F,OAAO,IAAI,eAAqB,QAAQ,SAAS,KAAKC,OAAO,IAAI,WAAW,KAAKA,OAAO,IAAI,KAAA,CAAS;CACvG;CACA,mBAAmC;EACjC,OAAO;CACT;CACA,QAA2B;EACzB,OAAO,KAAKA;CACd;AACF"}
+{"version":3,"file":"ManyToOneReference.js","names":[],"sources":["../../src/relations/ManyToOneReference.ts"],"sourcesContent":["import { type Entity, isEntity } from \"src/Entity.ts\";\nimport { type IdOf, type TaggedId, getEmInternalApi, sameEntity } from \"src/EntityManager.ts\";\nimport { type EntityMetadata, type ManyToOneField, getMetadata } from \"src/EntityMetadata.ts\";\nimport { getField, setField } from \"src/fields.ts\";\nimport {\n  BaseEntity,\n  NoIdError,\n  OneToManyLargeCollection,\n  OneToOneReferenceImpl,\n  type Reference,\n  deTagId,\n  ensureNotDeleted,\n  ensureTagged,\n  fail,\n  getInstanceData,\n  maybeResolveReferenceToId,\n  toIdOf,\n  toTaggedId,\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 { OneToManyCollection } from \"src/relations/OneToManyCollection.ts\";\nimport { ReferenceN } from \"src/relations/ReferenceSymbols.ts\";\nimport { RelationT, RelationU } from \"src/relations/RelationSymbols.ts\";\nimport { maybeAdd, maybeRemove } from \"src/utils.ts\";\n\n/** An alias for creating `ManyToOneReference`s. */\nexport function hasOne<T extends Entity, U extends Entity, N extends never | undefined>(): ManyToOneReference<T, U, N> {\n  return lazyField((entity: T, fieldName) => {\n    const m2o = getMetadata(entity).allFields[fieldName] as ManyToOneField;\n    return new ManyToOneReferenceImpl<T, U, N>(entity, m2o);\n  });\n}\n\n/** Type guard utility for determining if an entity field is a ManyToOneReference. */\nexport function isManyToOneReference(maybeReference: any): maybeReference is ManyToOneReference<any, any, any> {\n  return maybeReference instanceof ManyToOneReferenceImpl;\n}\n\nexport interface ManyToOneReference<T extends Entity, U extends Entity, N extends never | undefined> extends Reference<\n  T,\n  U,\n  N\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  idUntagged: string;\n\n  idUntaggedIfSet: 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/**\n * Manages a foreign key from one entity to another, i.e. `Book.author --> Author`.\n *\n * We keep the current `author` / `author_id` value in the `__orm.data` hash, where the\n * current value could be either the (string) author id from the database, or an entity\n * `Author` that the user has set.\n *\n * Note that if our `images.author_id` column is unique, this `ManyToOneReference` will essentially\n * be half of a one-to-one relationship, but we'll keep using this `ManyToOneReference` on the \"many\"\n * side, and the other side, i.e. `Author.image` will use a `OneToOneReference` to point back to us.\n */\nexport class ManyToOneReferenceImpl<T extends Entity, U extends Entity, N extends never | undefined>\n  extends AbstractRelationImpl<T, U>\n  implements ManyToOneReference<T, U, N>\n{\n  readonly #field: ManyToOneField;\n  #state: M2OState<U, N>;\n  #loadPromise: Promise<void> | undefined;\n  #hasBeenSet = false;\n\n  constructor(entity: T, field: ManyToOneField) {\n    super(entity);\n    this.#field = field;\n    this.#state = getInstanceData(entity).isOrWasNew\n      ? new M2OLoadedState<U, N>(this, undefined)\n      : new M2OUnloadedState<U, N>(this);\n  }\n\n  async load(opts: { withDeleted?: boolean; forceReload?: boolean } = {}): Promise<U | N> {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#state = this.#state.maybeInstantLoad();\n    if (!this.#state.isLoaded || opts.forceReload) {\n      const current = this.current();\n      if (isEntity(current) || current === undefined) {\n        this.#state = new M2OLoadedState<U, N>(this, current as U | N | undefined);\n      } else {\n        await (this.#loadPromise ??= this.entity.em.load(this.otherMeta.cstr, current).then((entity) => {\n          this.#loadPromise = undefined;\n          // In extremely rare cases, someone might have called `set` while this promise was in-flight,\n          // so make sure our current value is still the same as the fetched entity.\n          if (sameEntity(entity, this.current())) {\n            this.#state = this.#state.applyLoad(entity);\n          }\n        }));\n      }\n    }\n    return this.filterDeleted(this.#state.doGet() as U | N, 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    // Even if `.load()` has not been called, `.get` will detect\n    this.#state = this.#state.maybeInstantLoad();\n    return this.#state.isLoaded;\n  }\n\n  get isPreloaded(): boolean {\n    return !!this.maybeFindEntity();\n  }\n\n  preload(): void {\n    this.#state = new M2OLoadedState<U, N>(this, this.maybeFindEntity());\n  }\n\n  private unload(): void {\n    this.#state = new M2OUnloadedState<U, N>(this);\n    this.#loadPromise = undefined;\n  }\n\n  /** Copy another em's `source` relation into our state. */\n  import(source: ManyToOneReferenceImpl<T, U, N>, findEntity: (e: U) => U): void {\n    this.#state = source.#state.import(this, findEntity);\n  }\n\n  private doGet(opts?: { withDeleted?: boolean }): U | N {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#state = this.#state.maybeInstantLoad();\n    return this.filterDeleted(this.#state.doGet() as U | N, 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  /** Returns the id of the current value. */\n  get id(): IdOf<U> {\n    return this.idMaybe || failNoId(this.entity, this.fieldName, this.current());\n  }\n\n  /** Sets the m2o to `id`, and allows accepting `undefined` (`N`) if this is a nullable relation. */\n  set id(id: IdOf<U> | N) {\n    ensureNotDeleted(this.entity, \"pending\");\n    const newId = toTaggedId(this.otherMeta, id);\n\n    const previousId = this.idTaggedMaybe;\n    const previous = this.maybeFindEntity();\n    const changed = setField(this.entity, this.fieldName, id);\n    if (!changed) {\n      return;\n    }\n\n    const loaded = newId ? (this.entity.em.getEntity(newId) as U) : undefined;\n    this.#state = loaded ? new M2OLoadedState<U, N>(this, loaded) : new M2OUnloadedState<U, N>(this);\n    this.#loadPromise = undefined;\n    this.#percolateRemove(previousId, previous);\n    this.#percolateAdd();\n  }\n\n  get idIfSet(): IdOf<U> | N | undefined {\n    return this.idMaybe || failIfNewEntity(this.entity, this.fieldName, this.current());\n  }\n\n  get idUntagged(): string {\n    return this.idUntaggedMaybe || failNoId(this.entity, this.fieldName, this.current());\n  }\n\n  get idUntaggedIfSet(): string | undefined {\n    return this.idUntaggedMaybe || failIfNewEntity(this.entity, this.fieldName, this.current());\n  }\n\n  get idMaybe(): IdOf<U> | N | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    return toIdOf(this.otherMeta, this.idTaggedMaybe);\n  }\n\n  /** Returns the tagged id of the current value, or undefined if unset or a new entity. */\n  get idTaggedMaybe(): TaggedId | undefined {\n    // Skip the deleted check so that `isPreloaded` doesn't blow up during em.refreshes/populates\n    // ensureNotDeleted(this.entity, \"pending\");\n    return maybeResolveReferenceToId(this.current());\n  }\n\n  get fieldName(): string {\n    return this.#field.fieldName;\n  }\n\n  get otherFieldName(): keyof U & string {\n    return this.#field.otherFieldName as keyof U & string;\n  }\n\n  private get idUntaggedMaybe(): string | undefined {\n    return deTagId(this.otherMeta, this.idMaybe);\n  }\n\n  #setImpl(_other: U | IdOf<U> | N): void {\n    ensureNotDeleted(this.entity, \"pending\");\n    this.#hasBeenSet = true;\n\n    // If the project is not using tagged ids, we still want it tagged internally\n    const other = ensureTagged(this.otherMeta, _other);\n    if (sameEntity(other, this.current({ withDeleted: true }))) {\n      return;\n    }\n\n    const previousId = this.idTaggedMaybe;\n    const previous = this.maybeFindEntity();\n    // Prefer to keep the id in our data hash, but if this is a new entity w/o an id, use the entity itself\n    setField(this.entity, this.fieldName, isEntity(other) ? (other?.idTaggedMaybe ?? other) : other);\n\n    // Setting to an entity | undefined => loaded, setting to an id might reverse to unloaded\n    const maybeEntity = isEntity(other) ? (other as U) : other ? this.entity.em.getEntity(other) : undefined;\n    if (maybeEntity || other === undefined) {\n      this.#state = new M2OLoadedState<U, N>(this, (maybeEntity ?? other) as U | N);\n    } else {\n      this.#state = new M2OUnloadedState<U, N>(this);\n    }\n    this.#loadPromise = undefined;\n    this.#percolateRemove(previousId, previous);\n    this.#percolateAdd();\n  }\n\n  // private impl\n\n  setFromOpts(other: U | IdOf<U> | N): 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) {\n        if (typeof current === \"string\") {\n          // We're invoked twice, once sync on em.delete, and again in em.flush when we're loaded;\n          // but even when loaded, current might still be the tagged id, but we can find the entity in the EM\n          const other = this.entity.em.getEntity(current);\n          if (other) this.entity.em.delete(other as U);\n        } else {\n          this.entity.em.delete(current as U);\n        }\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 if (o2m instanceof OneToManyLargeCollection) {\n        o2m.remove(this.entity);\n      } else if (o2m instanceof OneToOneReferenceImpl) {\n        o2m.set(undefined as any);\n      } else {\n        throw new Error(`Unhandled ${o2m}`);\n      }\n    }\n    setField(this.entity, this.fieldName, undefined);\n    this.#state = new M2OLoadedState<U, N>(this, undefined as any);\n  }\n\n  // Called on `book.author.set(...)` with our previous value, to percolate a `author.books.remove`. */\n  #percolateRemove(prevId: string | undefined, prevEntity: U | undefined) {\n    if (prevEntity) {\n      const prevRelation = this.getOtherRelation(prevEntity);\n      if (prevRelation instanceof OneToManyCollection) {\n        prevRelation.removeIfLoaded(this.entity);\n      } else if (prevRelation instanceof OneToManyLargeCollection) {\n        prevRelation.remove(this.entity);\n      } else {\n        prevRelation.set(undefined as any, { percolating: true });\n      }\n    } else if (prevId) {\n      // prevEntity is not loaded in memory, but cache it in case our other side is later loaded\n      const { em } = this.entity;\n      let map = getEmInternalApi(em).pendingPercolate.get(prevId);\n      if (!map) {\n        map = new Map();\n        getEmInternalApi(em).pendingPercolate.set(prevId, map);\n      }\n      let pending = map.get(this.otherFieldName);\n      if (!pending) {\n        pending = { adds: [], removes: [] };\n        map.set(this.otherFieldName, pending);\n      }\n      maybeAdd(pending.removes, this.entity);\n      maybeRemove(pending.adds, this.entity);\n    }\n  }\n\n  #percolateAdd() {\n    const id = this.current();\n    const other = this.maybeFindEntity();\n    if (other) {\n      // Other is already loaded in memory, immediately hook it up\n      const newRelation = this.getOtherRelation(other);\n      if (newRelation instanceof OneToManyCollection) {\n        newRelation.add(this.entity);\n      } else if (newRelation instanceof OneToManyLargeCollection) {\n        newRelation.add(this.entity);\n      } else if (newRelation) {\n        newRelation.set(this.entity, { percolating: true });\n      } else {\n        // Something is wrong, we should always have a relation, but instead\n        // of blowing up here, let this finish b/c it will probably turn into\n        // a validation error.\n      }\n    } else if (typeof id === \"string\") {\n      // Other is not loaded in memory, but cache it in case our other side is later loaded\n      const { em } = this.entity;\n      let map = getEmInternalApi(em).pendingPercolate.get(id);\n      if (!map) {\n        map = new Map();\n        getEmInternalApi(em).pendingPercolate.set(id, map);\n      }\n      let pending = map.get(this.otherFieldName);\n      if (!pending) {\n        pending = { adds: [], removes: [] };\n        map.set(this.otherFieldName, pending);\n      }\n      maybeAdd(pending.adds, this.entity);\n      maybeRemove(pending.removes, this.entity);\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  get otherMeta(): EntityMetadata<U> {\n    return this.#field.otherMetadata();\n  }\n\n  get hasBeenSet(): boolean {\n    return this.#hasBeenSet;\n  }\n\n  public toString(): string {\n    return `ManyToOneReference(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.otherMeta.type}, otherFieldName: ${this.otherFieldName}, id: ${this.idMaybe})`;\n  }\n\n  /**\n   * Removes pending-hard-delete (but not soft-deleted), unless explicitly asked for.\n   *\n   * Note that we leave soft-deleted entities b/c the call signature of a `book.author.get`\n   * very likely does not expect a soft-deleted entity to result in `undefined`.\n   *\n   * (Contrasted with `author.books.get` which is more intuitive to have soft-deleted\n   * entities filtered out, i.e. it doesn't fundamentally change the return type.)\n   */\n  private filterDeleted(entity: U | N, opts?: { withDeleted?: boolean }): U | N {\n    if (entity && (!opts || !opts.withDeleted) && entity.isDeletedEntity) {\n      return undefined!;\n    }\n    return entity;\n  }\n\n  /** Returns the other relation that points back at us, i.e. we're `book.author_id` and this is `Author.books`. */\n  private getOtherRelation(\n    other: U,\n  ): OneToManyCollection<U, T> | OneToOneReferenceImpl<U, T> | OneToManyLargeCollection<U, T> {\n    return (other as U)[this.otherFieldName] as any;\n  }\n\n  private get isCascadeDelete(): boolean {\n    return isCascadeDelete(this, this.fieldName);\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 current() first b/c a new entity won't have an id yet\n    const current = this.current();\n    if (isEntity(current)) return current as U;\n    const { idTaggedMaybe } = this;\n    return idTaggedMaybe !== undefined ? (this.entity.em.getEntity(idTaggedMaybe) as U) : undefined;\n  }\n\n  [RelationT]: T = null!;\n  [RelationU]: U = null!;\n  [ReferenceN]: N = null!;\n}\n\n/**\n * Fails when we can't return an `.id` for a reference, i.e. it's unset or a new entity.\n *\n * We strictly type `book.author.id` as `AuthorId`, even if `book.author` is nullable, to\n * avoid users calling `.id` and getting back `undefined`, but not because \"there is no\n * author\", but only because \"the assigned author doesn't have an id assigned yet\".\n *\n * To handle nullable references, set `.idIfSet`.\n *\n * Assumes being called like `return idMaybe ?? failNoId()`, i.e. if we're called we\n * know the id is not available.\n */\nexport function failNoId(entity: Entity, fieldName: string, current: string | Entity | undefined): never {\n  if (!current) fail(`Reference ${entity}.${fieldName} is unset`);\n  // Throw NoIdError, which lets ReactionsManager will handle reactive fields gracefully\n  if (current instanceof BaseEntity)\n    throw new NoIdError(`Reference ${entity}.${fieldName} is assigned to a new entity`);\n  fail(`Unreachable`);\n}\n\n/**\n * Fails when we can't return an `.idIfSet` for a reference, i.e. it's a new entity.\n *\n * Assumes being called like `return idMaybe ?? failIfNewEntity()`, i.e. if we're called we\n * know the id is not available.\n */\nexport function failIfNewEntity(entity: Entity, fieldName: string, current: string | Entity | undefined): undefined {\n  if (current instanceof BaseEntity) {\n    throw new NoIdError(`Reference ${entity}.${fieldName} is assigned to a new entity`);\n  }\n  // Since this is a `.idIfSet`, having no `current` is fine, return undefined.\n  return undefined;\n}\n\ninterface M2OState<U extends Entity, N extends never | undefined> {\n  readonly isLoaded: boolean;\n  maybeInstantLoad(): M2OState<U, N>;\n  applyLoad(loaded: U | N | undefined): M2OLoadedState<U, N>;\n  import(target: ManyToOneReferenceImpl<any, any, any>, findEntity: (e: U) => U): M2OState<U, N>;\n  doGet(): U | N | undefined;\n}\n\nclass M2OUnloadedState<U extends Entity, N extends never | undefined> implements M2OState<U, N> {\n  readonly isLoaded = false;\n  #m2o: ManyToOneReferenceImpl<any, any, any>;\n  constructor(m2o: ManyToOneReferenceImpl<any, any, any>) {\n    this.#m2o = m2o;\n  }\n  applyLoad(loaded: U | N | undefined): M2OLoadedState<U, N> {\n    return new M2OLoadedState<U, N>(this.#m2o, loaded);\n  }\n  import(target: ManyToOneReferenceImpl<any, any, any>): M2OState<U, N> {\n    return new M2OUnloadedState<U, N>(target);\n  }\n  maybeInstantLoad(): M2OState<U, N> {\n    const current = this.#m2o.current();\n    if (current === undefined || isEntity(current)) {\n      return new M2OLoadedState<U, N>(this.#m2o, current as U | undefined);\n    } else {\n      const maybeFound = this.#m2o.entity.em.getEntity(current);\n      if (maybeFound) {\n        return new M2OLoadedState<U, N>(this.#m2o, maybeFound as U);\n      }\n    }\n    return this;\n  }\n  doGet(): U | N | undefined {\n    throw new Error(`${this.#m2o.entity}.${this.#m2o.fieldName} was not loaded`);\n  }\n}\n\n/** The when loaded, with either the loaded entity or undefined. */\nclass M2OLoadedState<U extends Entity, N extends never | undefined> implements M2OState<U, N> {\n  readonly isLoaded = true;\n  #m2o: ManyToOneReferenceImpl<any, any, any>;\n  #loaded: U | N | undefined;\n  constructor(m2o: ManyToOneReferenceImpl<any, any, any>, loaded: U | N | undefined) {\n    this.#loaded = loaded;\n    this.#m2o = m2o;\n  }\n  applyLoad(loaded: U | N | undefined): M2OLoadedState<U, N> {\n    return new M2OLoadedState<U, N>(this.#m2o, loaded);\n  }\n  import(target: ManyToOneReferenceImpl<any, any, any>, findEntity: (e: U) => U): M2OState<U, N> {\n    return new M2OLoadedState<U, N>(target, isEntity(this.#loaded) ? findEntity(this.#loaded) : undefined);\n  }\n  maybeInstantLoad(): M2OState<U, N> {\n    return this;\n  }\n  doGet(): U | N | undefined {\n    return this.#loaded;\n  }\n}\n"],"mappings":"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"}