joist-core 2.3.0 → 2.4.0-next.10

package/build/relations/ReactiveReference.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReactiveReference.js","sourceRoot":"","sources":["../../src/relations/ReactiveReference.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ReactiveReference.js","names":["#fieldName","#otherMeta","#state","#loadPromise","#isLoaded","#isCached","#rr","#loaded"],"sources":["../../src/relations/ReactiveReference.ts"],"sourcesContent":["import { type Entity } from \"src/Entity.ts\";\nimport { type IdOf } from \"src/EntityManager.ts\";\nimport { getField, setField } from \"src/fields.ts\";\nimport {\n  type EntityMetadata,\n  type ManyToOneField,\n  type TaggedId,\n  deTagId,\n  ensureNotDeleted,\n  fail,\n  getEmInternalApi,\n  getInstanceData,\n  getMetadata,\n  isEntity,\n  isLoaded,\n  maybeResolveReferenceToId,\n  sameEntity,\n  toIdOf,\n} from \"src/index.ts\";\nimport type { IsLoadedCachable } from \"src/loading/IsLoadedCache.ts\";\nimport { lazyField } from \"src/newEntity.ts\";\nimport {\n  type MaybeReactedEntity,\n  type Reacted,\n  type ReactiveHint,\n  convertToLoadHint,\n} from \"src/reactivity/reactiveHints.ts\";\nimport { AbstractRelationImpl } from \"src/relations/AbstractRelationImpl.ts\";\nimport { isCascadeDelete } from \"src/relations/isCascadeDelete.ts\";\nimport { failIfNewEntity, failNoId } from \"src/relations/ManyToOneReference.ts\";\nimport { type Reference } from \"src/relations/Reference.ts\";\nimport { ReferenceN } from \"src/relations/ReferenceSymbols.ts\";\nimport { RelationT, RelationU } from \"src/relations/RelationSymbols.ts\";\n\nexport interface ReactiveReference<T extends Entity, U extends Entity, N extends never | undefined> extends Reference<\n  T,\n  U,\n  N\n> {\n  isLoaded: boolean;\n  isSet: boolean;\n\n  load(opts?: { withDeleted?: boolean; forceReload?: true }): Promise<U | N>;\n\n  /**\n   * Returns the as-of-last-flush previously-calculated entity.\n   *\n   * This is useful if you have to purposefully avoid using the lambda to calc the latest entity,\n   * i.e. if you're in a test and want to watch a calculated entity change from some dummy entity\n   * to the new derived entity.\n   * */\n  fieldValue: U | 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  idUntagged: string;\n\n  idUntaggedIfSet: string | undefined;\n}\n\nexport function hasReactiveReference<T extends Entity, U extends Entity, const H extends ReactiveHint<T>>(\n  hint: H,\n  fn: (entity: Reacted<T, H>) => MaybeReactedEntity<U>,\n): ReactiveReference<T, U, never>;\nexport function hasReactiveReference<T extends Entity, U extends Entity, const H extends ReactiveHint<T>>(\n  hint: H,\n  fn: (entity: Reacted<T, H>) => MaybeReactedEntity<U> | undefined,\n): ReactiveReference<T, U, undefined>;\n/** Creates a `ReactiveReference`. */\nexport function hasReactiveReference<\n  T extends Entity,\n  U extends Entity,\n  const H extends ReactiveHint<T>,\n  N extends never | undefined,\n>(hint: H, fn: (entity: Reacted<T, H>) => MaybeReactedEntity<U> | N): ReactiveReference<T, U, N> {\n  return lazyField((entity: T, fieldName) => {\n    const m2o = getMetadata(entity).allFields[fieldName] as ManyToOneField;\n    return new ReactiveReferenceImpl<T, U, H, N>(entity, m2o, hint, fn);\n  });\n}\n\n/**\n * Implements ReactiveReferences.\n *\n * This is a bit trickier than ReactiveFields, because we have to differentiate our loaded\n * between:\n *\n * - our load hint is loaded, and we can directly calculate the referenced entity, or\n * - we've fetched the calculated/stored entity from the database, but not purposefully\n *   not re-calculating it (which would require fetching the load hint, which might be\n *   expensive, and defeat the point of having our field materialized in the database)\n *\n * Further, want to support all of:\n *\n * - When loaded & `.get` has been called, we cache the value\n *\n * - If a WIP mutation happens, we invalidate `.get` *but* if we check `.isLoaded`,\n *   we can return the live/updated value, without an `await`.\n *\n * - If a WIP mutation happens, we invalidate `.isLoaded`, and if we're *no longer loaded*,\n *   we want to keep returning the stale value (as asserted by the tests), but the next\n *   `load` / `populate` should load the graph & recalculate the value.\n */\nexport class ReactiveReferenceImpl<\n  T extends Entity,\n  U extends Entity,\n  H extends ReactiveHint<T>,\n  N extends never | undefined,\n>\n  extends AbstractRelationImpl<T, U>\n  implements ReactiveReference<T, U, N>, IsLoadedCachable\n{\n  readonly #fieldName: keyof T & string;\n  readonly #otherMeta: EntityMetadata;\n  #state: RRState<U, N>;\n  // #isLoaded doesn't necessary care if we're ref-mode or full-mode, it's just\n  // whether a caller can call `.get` and not have it blow up.\n  #isLoaded: boolean | undefined = undefined;\n  #isCached: boolean = false;\n  #loadPromise: Promise<U | N> | undefined;\n\n  constructor(\n    entity: T,\n    field: ManyToOneField,\n    public reactiveHint: H,\n    private fn: (entity: Reacted<T, H>) => MaybeReactedEntity<U> | N,\n  ) {\n    super(entity);\n    // Minimizing changes until the other PR lands...\n    this.#fieldName = field.fieldName as keyof T & string;\n    this.#otherMeta = field.otherMetadata();\n    this.#state = new RRUnloadedState<U, N>(this);\n    // We can be initialized with [entity | id | undefined], and if it's entity or id, then setImpl\n    // will set loaded appropriately; but if we're initialized undefined, then mark loaded here\n    if (entity.isNewEntity) {\n      // const isLoaded = isEntity(this.current()) ? true : undefined;\n    }\n    // If the property transformer is not enabled, then the RR will not be in the relations map because they are\n    // defined in the implementation file and not the codegen file.  So we should insert ourselves regardless.\n    (getInstanceData(entity).relations ??= {})[field.fieldName] = this;\n  }\n\n  async load(opts?: { withDeleted?: boolean; forceReload?: true }): Promise<U | N> {\n    ensureNotDeleted(this.entity, \"pending\");\n    const { loadHint } = this;\n    if (!this.isLoaded || opts?.forceReload) {\n      const { em } = this.entity;\n      // Just because we're not loaded, doesn't mean we necessarily need to load our full hint.\n      // We prefer to load only our previously-calculated/materialized value, and only load the\n      // full load hint if we need recalculated.\n      const maybeDirty = opts?.forceReload || getEmInternalApi(em).rm.isMaybePendingRecalc(this.entity, this.fieldName);\n      if (maybeDirty) {\n        return (this.#loadPromise ??= em\n          .populate(this.entity, { hint: loadHint, ...opts })\n          .then(() => {\n            this.#state = this.#state.enterRecalcMode(this);\n            this.#isLoaded = true;\n            getEmInternalApi(this.entity.em).isLoadedCache.add(this);\n            // Go through `this.get` so that `setField` is called to set our latest value\n            this.#isCached = false;\n            return this.doGet(opts);\n          })\n          .finally(() => {\n            this.#loadPromise = undefined;\n          }));\n      } else {\n        // If we don't need a full recalc, just make sure we have the entity in memory\n        // ...ideally we would check `isSet` and whether the key was in the `instanceData`\n        const current = this.current();\n        if (isEntity(current) || current === undefined) {\n          this.#state = new RRRefState<U, N>(this, current as U | N | undefined);\n          this.#isLoaded = true;\n          getEmInternalApi(this.entity.em).isLoadedCache.add(this);\n          return current as U | N;\n        } else {\n          return (this.#loadPromise ??= em\n            .load(this.#otherMeta.cstr, current)\n            .then((loaded) => {\n              this.#state = new RRRefState<U, N>(this, loaded);\n              this.#isLoaded = true;\n              getEmInternalApi(this.entity.em).isLoadedCache.add(this);\n              return loaded;\n            })\n            .finally(() => {\n              this.#loadPromise = undefined;\n            }));\n        }\n      }\n    }\n    // The ReactiveField.load() always sets `#isCached = false`, but our assertion is that our\n    // IsLoadedCache/resetIsLoaded infra is good enough to \"see all invalidating mutations\",\n    // so we don't need this explicit reset.\n    // this.#isCached = false;\n    return this.doGet(opts);\n  }\n\n  get isLoaded(): boolean {\n    // If we've cached an isLoaded value, just use that, see https://github.com/joist-orm/joist-orm/issues/1166\n    if (this.#isLoaded !== undefined) return this.#isLoaded;\n    getEmInternalApi(this.entity.em).isLoadedCache.add(this);\n    // If a WIP mutation has marked our field as potentially dirty, we need to be \"full\" loaded\n    const maybeDirty = getEmInternalApi(this.entity.em).rm.isMaybePendingRecalc(this.entity, this.fieldName);\n    if (maybeDirty) {\n      // If we're dirty, only being \"full\" loaded is good enough to recalc\n      this.#state = this.#state.enterRecalcMode(this);\n      this.#isLoaded = isLoaded(this.entity, this.loadHint);\n      this.#isCached = false;\n    } else {\n      // If we've had `.load` called before, assume we're still loaded\n      this.#isLoaded = this.#state.canReturnValue;\n    }\n    return this.#isLoaded;\n  }\n\n  resetIsLoaded(): void {\n    this.#isLoaded = undefined;\n    this.#isCached = false;\n  }\n\n  private doGet(opts?: { withDeleted?: boolean }): U | N {\n    const { fn } = this;\n    ensureNotDeleted(this.entity, \"pending\");\n    // Fast pass if we've already calculated this (cache invalidation will happen on\n    // any mutation via #resetIsLoaded)..\n    if (this.#isCached) {\n      return this.filterDeleted(this.#state.doGet() as U | N, opts);\n    }\n    // Call isLoaded to probe the load hint, and get `#isLoaded` set, but still have\n    // our `if` check the raw `#isLoaded` to know if we should eval-latest or return `loaded`.\n    if (this.isLoaded && this.#state.kind === \"full\") {\n      const newValue = this.filterDeleted(fn(this.entity as any) as any, opts);\n      // It's cheap to set this every time we're called, i.e. even if it's not the\n      // official \"being called during em.flush\" update (...unless we're accessing it\n      // during the validate phase of `em.flush`, then skip it to avoid tripping up\n      // the \"cannot change entities during flush\" logic.)\n      if (!getEmInternalApi(this.entity.em).isValidating) {\n        this.setImpl(newValue);\n      }\n      this.#state = new RRFullState<U, N>(this, newValue);\n      this.#isCached = true;\n      getEmInternalApi(this.entity.em).isLoadedCache.add(this);\n    } else if (this.#state.canReturnValue) {\n      // We're either in ref mode, or in full mode but not actually fully loaded,\n      // but in theory those states only get set after `.load()` / `.preload()` / import,\n      // so we should have some stored value, even if it's not fully up-to-date.\n      this.#isCached = true;\n      getEmInternalApi(this.entity.em).isLoadedCache.add(this);\n    } else {\n      const noun = this.entity.isNewEntity ? \"derived\" : \"loaded\";\n      throw new Error(`${this.entity}.${this.fieldName} has not been ${noun} yet`);\n    }\n    return this.filterDeleted(this.#state.doGet() as U | N, opts);\n  }\n\n  get fieldValue(): U | N {\n    return getField(this.entity, this.fieldName);\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  set(_: U | N): void {\n    fail(`Cannot set ${this.entity}.${this.fieldName} ReactiveReference directly.`);\n  }\n\n  get isSet(): boolean {\n    return this.current() !== undefined;\n  }\n\n  // Internal method used by OneToManyCollection\n  setImpl(entity: U | N): void {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (sameEntity(entity, this.current({ withDeleted: true }))) {\n      return;\n    }\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(entity) ? (entity.idTaggedMaybe ?? entity) : entity);\n  }\n\n  get isPreloaded(): boolean {\n    return !!this.maybeFindEntity();\n  }\n\n  preload(): void {\n    this.#state = new RRRefState<U, N>(this, this.maybeFindEntity());\n    this.#isLoaded = true;\n    this.#isCached = true;\n  }\n\n  private unload(): void {\n    this.#state = new RRUnloadedState<U, N>(this);\n    this.#isLoaded = false;\n    this.#isCached = false;\n    this.#loadPromise = undefined;\n  }\n\n  import(other: ReactiveReferenceImpl<T, U, H, N>, findEntity: (e: U) => U): void {\n    this.#state = other.#state.import(this, findEntity);\n    this.#isLoaded = true;\n    this.#isCached = true;\n  }\n\n  /** Returns the tagged id of the current value. */\n  get idTaggedMaybe(): TaggedId | N {\n    ensureNotDeleted(this.entity, \"pending\");\n    return maybeResolveReferenceToId(this.current()) as TaggedId | N;\n  }\n\n  get id(): IdOf<U> {\n    return this.idMaybe || failNoId(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 idIfSet(): IdOf<U> | N | undefined {\n    return this.idMaybe || failIfNewEntity(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 loadHint(): any {\n    const meta = getMetadata(this.entity);\n    return (meta.config.__data.cachedReactiveLoadHints[this.fieldName] ??= convertToLoadHint(meta, this.reactiveHint));\n  }\n\n  // private impl\n\n  /** Returns the id of the current value. */\n  private get idMaybe(): IdOf<U> | undefined {\n    ensureNotDeleted(this.entity, \"pending\");\n    return toIdOf(this.otherMeta, this.idTaggedMaybe);\n  }\n\n  private get idUntaggedMaybe(): string | undefined {\n    return deTagId(this.otherMeta, this.idMaybe);\n  }\n\n  setFromOpts(_: U | IdOf<U> | N): void {\n    throw new Error(`ReactiveReference ${this.entity}.${this.fieldName} cannot be set via opts`);\n  }\n\n  maybeCascadeDelete(): void {\n    if (this.isCascadeDelete) {\n      const current = this.current({ withDeleted: true });\n      if (current !== undefined && typeof current !== \"string\") {\n        this.entity.em.delete(current as U);\n      }\n    }\n  }\n\n  async cleanupOnEntityDeleted(): Promise<void> {\n    // if we are going to delete this relation as well, then we don't need to clean it up\n    if (this.isCascadeDelete) return;\n    setField(this.entity, this.fieldName, undefined);\n    this.#state = new RRRefState<U, N>(this, undefined as N);\n    this.#isLoaded = false;\n    this.#isCached = false;\n    this.#loadPromise = undefined;\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 | string | 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 fieldName(): string {\n    return this.#fieldName;\n  }\n\n  public get otherMeta(): EntityMetadata<U> {\n    return (getMetadata(this.entity).allFields[this.#fieldName] as ManyToOneField).otherMetadata();\n  }\n\n  public get hasBeenSet(): boolean {\n    return true;\n  }\n\n  public toString(): string {\n    return `ReactiveReference(entity: ${this.entity}, hint: ${this.loadHint}, fieldName: ${this.fieldName}, otherMeta: {\n      this.otherMeta.type\n    }, id: ${this.id})`;\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  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 | N {\n    // Check this.loaded first b/c a new entity won't have an id yet\n    if (this.#state.canReturnValue) {\n      const loaded = this.#state.doGet();\n      if (loaded !== undefined) {\n        return loaded;\n      }\n    }\n    const { idTaggedMaybe } = this;\n    return idTaggedMaybe !== undefined ? (this.entity.em.getEntity(idTaggedMaybe) as U | N) : (undefined as N);\n  }\n\n  [RelationT]: T = null!;\n  [RelationU]: U = null!;\n  [ReferenceN]: N = null!;\n}\n\n/** Type guard utility for determining if an entity field is a ReactiveReference. */\nexport function isReactiveReference(maybeReactiveRef: any): maybeReactiveRef is ReactiveReference<any, any, any> {\n  return maybeReactiveRef instanceof ReactiveReferenceImpl;\n}\n\ninterface RRState<U extends Entity, N extends never | undefined> {\n  readonly kind: \"unloaded\" | \"ref\" | \"full\";\n  readonly canReturnValue: boolean;\n  doGet(): U | N | undefined;\n  /**\n   * Switches from \"materialized ref value\" semantics to \"recalc from reactive graph when available\" semantics.\n   *\n   * This is synchronous because it does not mean the load hint is fully loaded yet. It only means this\n   * reference should now behave as recalc-capable: if `isLoaded(loadHint)` later reports true, `doGet`\n   * will recalculate from `fn(...)`; otherwise we keep returning the last known/stale value until `load()`\n   * populates the graph.\n   */\n  enterRecalcMode(target: ReactiveReferenceImpl<any, any, any, any>): RRFullState<U, N>;\n  import(target: ReactiveReferenceImpl<any, any, any, any>, findEntity: (e: U) => U): RRState<U, N>;\n}\n\nclass RRUnloadedState<U extends Entity, N extends never | undefined> implements RRState<U, N> {\n  readonly kind = \"unloaded\";\n  readonly canReturnValue = false;\n  #rr: ReactiveReferenceImpl<any, any, any, any>;\n\n  constructor(rr: ReactiveReferenceImpl<any, any, any, any>) {\n    this.#rr = rr;\n  }\n\n  doGet(): U | N | undefined {\n    throw new Error(`${this.#rr.entity}.${this.#rr.fieldName} was not loaded`);\n  }\n\n  enterRecalcMode(target: ReactiveReferenceImpl<any, any, any, any>): RRFullState<U, N> {\n    return new RRFullState<U, N>(target, undefined);\n  }\n\n  import(target: ReactiveReferenceImpl<any, any, any, any>, _findEntity: (e: U) => U): RRState<U, N> {\n    return new RRUnloadedState<U, N>(target);\n  }\n}\n\nclass RRRefState<U extends Entity, N extends never | undefined> implements RRState<U, N> {\n  readonly kind = \"ref\";\n  readonly canReturnValue = true;\n  #loaded: U | N | undefined;\n\n  constructor(_rr: ReactiveReferenceImpl<any, any, any, any>, loaded: U | N | undefined) {\n    this.#loaded = loaded;\n  }\n\n  doGet(): U | N | undefined {\n    return this.#loaded;\n  }\n\n  enterRecalcMode(target: ReactiveReferenceImpl<any, any, any, any>): RRFullState<U, N> {\n    return new RRFullState<U, N>(target, this.#loaded);\n  }\n\n  import(target: ReactiveReferenceImpl<any, any, any, any>, findEntity: (e: U) => U): RRState<U, N> {\n    return new RRRefState<U, N>(target, mapReactiveReferenceEntity(this.#loaded, findEntity));\n  }\n}\n\nclass RRFullState<U extends Entity, N extends never | undefined> implements RRState<U, N> {\n  readonly kind = \"full\";\n  readonly canReturnValue = true;\n  #loaded: U | N | undefined;\n\n  constructor(_rr: ReactiveReferenceImpl<any, any, any, any>, loaded: U | N | undefined) {\n    this.#loaded = loaded;\n  }\n\n  doGet(): U | N | undefined {\n    return this.#loaded;\n  }\n\n  enterRecalcMode(_target: ReactiveReferenceImpl<any, any, any, any>): RRFullState<U, N> {\n    return this;\n  }\n\n  import(target: ReactiveReferenceImpl<any, any, any, any>, findEntity: (e: U) => U): RRState<U, N> {\n    return new RRRefState<U, N>(target, mapReactiveReferenceEntity(this.#loaded, findEntity));\n  }\n}\n\nfunction mapReactiveReferenceEntity<U extends Entity, N extends never | undefined>(\n  entity: U | N | undefined,\n  findEntity: (e: U) => U,\n): U | N | undefined {\n  return isEntity(entity) ? findEntity(entity) : entity;\n}\n"],"mappings":"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"}

package/build/relations/ReadOnlyCollection.cjs

@@ -0,0 +1,18 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./Relation.cjs");
+const require_relations_RecursiveCollection = require("./RecursiveCollection.cjs");
+require("../Entity.cjs");
+//#region src/relations/ReadOnlyCollection.ts
+/** Type guard utility for determining if an entity field is a `ReadOnlyCollection`. */
+function isReadOnlyCollection(maybeCollection) {
+	return maybeCollection instanceof require_relations_RecursiveCollection.RecursiveParentsCollectionImpl || maybeCollection instanceof require_relations_RecursiveCollection.RecursiveChildrenCollectionImpl || maybeCollection instanceof require_relations_RecursiveCollection.RecursiveM2mCollectionImpl;
+}
+/** Type guard utility for determining if an entity field is a loaded `ReadOnlyCollection`. */
+function isLoadedReadOnlyCollection(maybeCollection) {
+	return isReadOnlyCollection(maybeCollection) && maybeCollection.isLoaded;
+}
+//#endregion
+exports.isLoadedReadOnlyCollection = isLoadedReadOnlyCollection;
+exports.isReadOnlyCollection = isReadOnlyCollection;
+
+//# sourceMappingURL=ReadOnlyCollection.cjs.map

package/build/relations/ReadOnlyCollection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadOnlyCollection.cjs","names":["RecursiveParentsCollectionImpl","RecursiveChildrenCollectionImpl","RecursiveM2mCollectionImpl"],"sources":["../../src/relations/ReadOnlyCollection.ts"],"sourcesContent":["import { type Entity } from \"src/Entity.ts\";\nimport {\n  RecursiveChildrenCollectionImpl,\n  RecursiveM2mCollectionImpl,\n  RecursiveParentsCollectionImpl,\n} from \"src/relations/RecursiveCollection.ts\";\nimport { type Relation } from \"src/relations/Relation.ts\";\n\n/** A collection of `U` within `T`, either one-to-many or many-to-many. */\nexport interface ReadOnlyCollection<T extends Entity, U extends Entity> extends Relation<T, U> {\n  load(opts?: { withDeleted: boolean }): Promise<ReadonlyArray<U>>;\n\n  readonly isLoaded: boolean;\n}\n\n/** Adds a known-safe `get` accessor. */\nexport interface LoadedReadOnlyCollection<T extends Entity, U extends Entity> extends ReadOnlyCollection<T, U> {\n  get: ReadonlyArray<U>;\n\n  getWithDeleted: ReadonlyArray<U>;\n}\n\n/** Type guard utility for determining if an entity field is a `ReadOnlyCollection`. */\nexport function isReadOnlyCollection(maybeCollection: any): maybeCollection is ReadOnlyCollection<any, any> {\n  return (\n    maybeCollection instanceof RecursiveParentsCollectionImpl ||\n    maybeCollection instanceof RecursiveChildrenCollectionImpl ||\n    maybeCollection instanceof RecursiveM2mCollectionImpl\n  );\n}\n\n/** Type guard utility for determining if an entity field is a loaded `ReadOnlyCollection`. */\nexport function isLoadedReadOnlyCollection(\n  maybeCollection: any,\n): maybeCollection is ReadOnlyCollection<any, any> & LoadedReadOnlyCollection<any, any> {\n  return isReadOnlyCollection(maybeCollection) && maybeCollection.isLoaded;\n}\n"],"mappings":";;;;;;AAuBA,SAAgB,qBAAqB,iBAAuE;CAC1G,OACE,2BAA2BA,sCAAAA,kCAC3B,2BAA2BC,sCAAAA,mCAC3B,2BAA2BC,sCAAAA;AAE/B;;AAGA,SAAgB,2BACd,iBACsF;CACtF,OAAO,qBAAqB,eAAe,KAAK,gBAAgB;AAClE"}

package/build/relations/ReadOnlyCollection.d.cts

@@ -0,0 +1,22 @@
+import { Relation } from "./Relation.cjs";
+import { Entity } from "../Entity.cjs";
+//#region src/relations/ReadOnlyCollection.d.ts
+/** A collection of `U` within `T`, either one-to-many or many-to-many. */
+interface ReadOnlyCollection<T extends Entity, U extends Entity> extends Relation<T, U> {
+  load(opts?: {
+    withDeleted: boolean;
+  }): Promise<ReadonlyArray<U>>;
+  readonly isLoaded: boolean;
+}
+/** Adds a known-safe `get` accessor. */
+interface LoadedReadOnlyCollection<T extends Entity, U extends Entity> extends ReadOnlyCollection<T, U> {
+  get: ReadonlyArray<U>;
+  getWithDeleted: ReadonlyArray<U>;
+}
+/** Type guard utility for determining if an entity field is a `ReadOnlyCollection`. */
+declare function isReadOnlyCollection(maybeCollection: any): maybeCollection is ReadOnlyCollection<any, any>;
+/** Type guard utility for determining if an entity field is a loaded `ReadOnlyCollection`. */
+declare function isLoadedReadOnlyCollection(maybeCollection: any): maybeCollection is ReadOnlyCollection<any, any> & LoadedReadOnlyCollection<any, any>;
+//#endregion
+export { LoadedReadOnlyCollection, ReadOnlyCollection, isLoadedReadOnlyCollection, isReadOnlyCollection };
+//# sourceMappingURL=ReadOnlyCollection.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReadOnlyCollection.d.cts","names":[],"sources":["../../src/relations/ReadOnlyCollection.ts"],"mappings":";;;;UASiB,mBAAmB,UAAU,QAAQ,UAAU,gBAAgB,SAAS,GAAG;EAC1F,KAAK;IAAS;MAAyB,QAAQ,cAAc;WAEpD;;;UAIM,yBAAyB,UAAU,QAAQ,UAAU,gBAAgB,mBAAmB,GAAG;EAC1G,KAAK,cAAc;EAEnB,gBAAgB,cAAc;;;iBAIhB,qBAAqB,uBAAuB,mBAAmB;;iBAS/D,2BACd,uBACC,mBAAmB,+BAA+B"}

package/build/relations/ReadOnlyCollection.d.mts

@@ -0,0 +1,22 @@
+import { Relation } from "./Relation.mjs";
+import { Entity } from "../Entity.mjs";
+//#region src/relations/ReadOnlyCollection.d.ts
+/** A collection of `U` within `T`, either one-to-many or many-to-many. */
+interface ReadOnlyCollection<T extends Entity, U extends Entity> extends Relation<T, U> {
+  load(opts?: {
+    withDeleted: boolean;
+  }): Promise<ReadonlyArray<U>>;
+  readonly isLoaded: boolean;
+}
+/** Adds a known-safe `get` accessor. */
+interface LoadedReadOnlyCollection<T extends Entity, U extends Entity> extends ReadOnlyCollection<T, U> {
+  get: ReadonlyArray<U>;
+  getWithDeleted: ReadonlyArray<U>;
+}
+/** Type guard utility for determining if an entity field is a `ReadOnlyCollection`. */
+declare function isReadOnlyCollection(maybeCollection: any): maybeCollection is ReadOnlyCollection<any, any>;
+/** Type guard utility for determining if an entity field is a loaded `ReadOnlyCollection`. */
+declare function isLoadedReadOnlyCollection(maybeCollection: any): maybeCollection is ReadOnlyCollection<any, any> & LoadedReadOnlyCollection<any, any>;
+//#endregion
+export { LoadedReadOnlyCollection, ReadOnlyCollection, isLoadedReadOnlyCollection, isReadOnlyCollection };
+//# sourceMappingURL=ReadOnlyCollection.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReadOnlyCollection.d.mts","names":[],"sources":["../../src/relations/ReadOnlyCollection.ts"],"mappings":";;;;UASiB,mBAAmB,UAAU,QAAQ,UAAU,gBAAgB,SAAS,GAAG;EAC1F,KAAK;IAAS;MAAyB,QAAQ,cAAc;WAEpD;;;UAIM,yBAAyB,UAAU,QAAQ,UAAU,gBAAgB,mBAAmB,GAAG;EAC1G,KAAK,cAAc;EAEnB,gBAAgB,cAAc;;;iBAIhB,qBAAqB,uBAAuB,mBAAmB;;iBAS/D,2BACd,uBACC,mBAAmB,+BAA+B"}

package/build/relations/ReadOnlyCollection.js

@@ -1,16 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isReadOnlyCollection = isReadOnlyCollection;
-exports.isLoadedReadOnlyCollection = isLoadedReadOnlyCollection;
-const RecursiveCollection_1 = require("./RecursiveCollection");
+import "./Relation.js";
+import { RecursiveChildrenCollectionImpl, RecursiveM2mCollectionImpl, RecursiveParentsCollectionImpl } from "./RecursiveCollection.js";
+import "../Entity.js";
+//#region src/relations/ReadOnlyCollection.ts
 /** Type guard utility for determining if an entity field is a `ReadOnlyCollection`. */
 function isReadOnlyCollection(maybeCollection) {
-    return (maybeCollection instanceof RecursiveCollection_1.RecursiveParentsCollectionImpl ||
-        maybeCollection instanceof RecursiveCollection_1.RecursiveChildrenCollectionImpl ||
-        maybeCollection instanceof RecursiveCollection_1.RecursiveM2mCollectionImpl);
+	return maybeCollection instanceof RecursiveParentsCollectionImpl || maybeCollection instanceof RecursiveChildrenCollectionImpl || maybeCollection instanceof RecursiveM2mCollectionImpl;
 }
 /** Type guard utility for determining if an entity field is a loaded `ReadOnlyCollection`. */
 function isLoadedReadOnlyCollection(maybeCollection) {
-    return isReadOnlyCollection(maybeCollection) && maybeCollection.isLoaded;
+	return isReadOnlyCollection(maybeCollection) && maybeCollection.isLoaded;
 }
+//#endregion
+export { isLoadedReadOnlyCollection, isReadOnlyCollection };
+
 //# sourceMappingURL=ReadOnlyCollection.js.map

package/build/relations/ReadOnlyCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReadOnlyCollection.js","sourceRoot":"","sources":["../../src/relations/ReadOnlyCollection.ts"],"names":[],"mappings":";;AAuBA,oDAMC;AAGD,gEAIC;AAnCD,+DAI+B;AAiB/B,uFAAuF;AACvF,SAAgB,oBAAoB,CAAC,eAAoB;IACvD,OAAO,CACL,eAAe,YAAY,oDAA8B;QACzD,eAAe,YAAY,qDAA+B;QAC1D,eAAe,YAAY,gDAA0B,CACtD,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,SAAgB,0BAA0B,CACxC,eAAoB;IAEpB,OAAO,oBAAoB,CAAC,eAAe,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"ReadOnlyCollection.js","names":[],"sources":["../../src/relations/ReadOnlyCollection.ts"],"sourcesContent":["import { type Entity } from \"src/Entity.ts\";\nimport {\n  RecursiveChildrenCollectionImpl,\n  RecursiveM2mCollectionImpl,\n  RecursiveParentsCollectionImpl,\n} from \"src/relations/RecursiveCollection.ts\";\nimport { type Relation } from \"src/relations/Relation.ts\";\n\n/** A collection of `U` within `T`, either one-to-many or many-to-many. */\nexport interface ReadOnlyCollection<T extends Entity, U extends Entity> extends Relation<T, U> {\n  load(opts?: { withDeleted: boolean }): Promise<ReadonlyArray<U>>;\n\n  readonly isLoaded: boolean;\n}\n\n/** Adds a known-safe `get` accessor. */\nexport interface LoadedReadOnlyCollection<T extends Entity, U extends Entity> extends ReadOnlyCollection<T, U> {\n  get: ReadonlyArray<U>;\n\n  getWithDeleted: ReadonlyArray<U>;\n}\n\n/** Type guard utility for determining if an entity field is a `ReadOnlyCollection`. */\nexport function isReadOnlyCollection(maybeCollection: any): maybeCollection is ReadOnlyCollection<any, any> {\n  return (\n    maybeCollection instanceof RecursiveParentsCollectionImpl ||\n    maybeCollection instanceof RecursiveChildrenCollectionImpl ||\n    maybeCollection instanceof RecursiveM2mCollectionImpl\n  );\n}\n\n/** Type guard utility for determining if an entity field is a loaded `ReadOnlyCollection`. */\nexport function isLoadedReadOnlyCollection(\n  maybeCollection: any,\n): maybeCollection is ReadOnlyCollection<any, any> & LoadedReadOnlyCollection<any, any> {\n  return isReadOnlyCollection(maybeCollection) && maybeCollection.isLoaded;\n}\n"],"mappings":";;;;;AAuBA,SAAgB,qBAAqB,iBAAuE;CAC1G,OACE,2BAA2B,kCAC3B,2BAA2B,mCAC3B,2BAA2B;AAE/B;;AAGA,SAAgB,2BACd,iBACsF;CACtF,OAAO,qBAAqB,eAAe,KAAK,gBAAgB;AAClE"}

package/build/relations/RecursiveCollection.cjs

@@ -0,0 +1,386 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_relations_Collection = require("./Collection.cjs");
+const require_relations_AbstractRelationImpl = require("./AbstractRelationImpl.cjs");
+const require_relations_RelationSymbols = require("./RelationSymbols.cjs");
+const require_batchloaders_recursiveChildrenBatchLoader = require("../batchloaders/recursiveChildrenBatchLoader.cjs");
+const require_batchloaders_recursiveM2mBatchLoader = require("../batchloaders/recursiveM2mBatchLoader.cjs");
+const require_batchloaders_recursiveParentsBatchLoader = require("../batchloaders/recursiveParentsBatchLoader.cjs");
+require("./ReadOnlyCollection.cjs");
+const require_relations_RecursiveCycleError = require("./RecursiveCycleError.cjs");
+const require_relations_Reference = require("./Reference.cjs");
+const require_relations_OneToOneReference = require("./OneToOneReference.cjs");
+const require_utils = require("../utils.cjs");
+const require_newEntity = require("../newEntity.cjs");
+const require_EntityMetadata = require("../EntityMetadata.cjs");
+const require_index = require("../index.cjs");
+const require_EntityManager = require("../EntityManager.cjs");
+//#region src/relations/RecursiveCollection.ts
+/**
+* An alias for creating `RecursiveParentsCollectionImpl`s.
+*
+* I.e. for `Author.mentor` (m2o fk), we can return `Author.mentorsRecursive` recursively looking up.
+*/
+function hasRecursiveParents(m2oName, otherFieldName) {
+	return require_newEntity.lazyField((entity, fieldName) => {
+		return new RecursiveParentsCollectionImpl(entity, fieldName, m2oName, otherFieldName);
+	});
+}
+/**
+* An alias for creating `RecursiveChildrenCollectionImpl`s.
+*
+* I.e. for `Author.mentees` (o2m), we can return `Author.menteesRecursive` recursively looking down.
+*/
+function hasRecursiveChildren(o2mName, otherFieldName) {
+	return require_newEntity.lazyField((entity, fieldName) => {
+		return new RecursiveChildrenCollectionImpl(entity, fieldName, o2mName, otherFieldName);
+	});
+}
+/**
+* An alias for creating `RecursiveM2mCollectionImpl`s.
+*
+* I.e. for `User.parents` (m2m), we can return `User.parentsRecursive` recursively looking up through the m2m.
+* Or for `User.children` (m2m), we can return `User.childrenRecursive` recursively looking down.
+*/
+function hasRecursiveM2m(m2mName, otherFieldName) {
+	return require_newEntity.lazyField((entity, fieldName) => {
+		return new RecursiveM2mCollectionImpl(entity, fieldName, m2mName, otherFieldName);
+	});
+}
+/**
+* A base class for the common methods between the parent & children recursive collections.
+*
+* We could probably move some of this into AbstractRelationImpl?
+*/
+var AbstractRecursiveCollectionImpl = class extends require_relations_AbstractRelationImpl.AbstractRelationImpl {
+	get get() {
+		return this.filterDeleted(this.doGet(), { withDeleted: false });
+	}
+	get getWithDeleted() {
+		return this.filterDeleted(this.doGet(), { withDeleted: true });
+	}
+	setFromOpts() {
+		throw new Error("Method not implemented.");
+	}
+	set() {
+		throw new Error("Method not implemented.");
+	}
+	get isPreloaded() {
+		return false;
+	}
+	preload() {
+		throw new Error("Method not implemented.");
+	}
+	cleanupOnEntityDeleted() {
+		return Promise.resolve();
+	}
+	maybeCascadeDelete() {}
+	get meta() {
+		return require_EntityMetadata.getMetadata(this.entity);
+	}
+	/** Removes pending-hard-delete or soft-deleted entities, unless explicitly asked for. */
+	filterDeleted(entities, opts) {
+		return opts?.withDeleted === true ? [...entities] : entities.filter((e) => !e.isDeletedEntity && !e.isSoftDeletedEntity);
+	}
+	[require_relations_RelationSymbols.RelationT] = null;
+	[require_relations_RelationSymbols.RelationU] = null;
+};
+var RecursiveParentsCollectionImpl = class extends AbstractRecursiveCollectionImpl {
+	#fieldName;
+	#m2oName;
+	#otherFieldName;
+	#loaded = void 0;
+	#loadPromise;
+	constructor(entity, fieldName, m2oName, otherFieldName) {
+		super(entity);
+		this.#fieldName = fieldName;
+		this.#m2oName = m2oName;
+		this.#otherFieldName = otherFieldName;
+	}
+	async load(opts = {}) {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		if (!this.isLoaded || opts.forceReload) {
+			if (opts.forceReload) this.#loaded = void 0;
+			const entityToLoad = opts.forceReload ? this.entity : this.findUnloadedReference()?.entity;
+			if (entityToLoad && !entityToLoad.isNewEntity) {
+				await (this.#loadPromise ??= require_batchloaders_recursiveParentsBatchLoader.recursiveParentsBatchLoader(this.entity.em, this).load(entityToLoad).catch(function load(err) {
+					throw require_EntityManager.appendStack(err, /* @__PURE__ */ new Error());
+				}).finally(() => {
+					this.#loadPromise = void 0;
+				}));
+				const unloadedParent = this.findUnloadedReference();
+				if (unloadedParent) await require_batchloaders_recursiveParentsBatchLoader.recursiveParentsBatchLoader(this.entity.em, this).load(unloadedParent.entity).catch(function load(err) {
+					throw require_EntityManager.appendStack(err, /* @__PURE__ */ new Error());
+				});
+			}
+			this.#loaded = true;
+		}
+		return this.filterDeleted(this.doGet(), opts);
+	}
+	get isLoaded() {
+		if (this.#loaded !== void 0) return this.#loaded;
+		this.#loaded = this.findUnloadedReference() === void 0;
+		require_EntityManager.getEmInternalApi(this.entity.em).isLoadedCache.addNaive(this);
+		return this.#loaded;
+	}
+	resetIsLoaded() {
+		this.#loaded = void 0;
+	}
+	get fieldName() {
+		return this.#fieldName;
+	}
+	get m2oFieldName() {
+		return this.#m2oName;
+	}
+	get otherFieldName() {
+		return this.#otherFieldName;
+	}
+	get hasBeenSet() {
+		return false;
+	}
+	toString() {
+		return `RecursiveParentsCollectionImpl(entity: ${this.entity}, fieldName: ${this.fieldName})`;
+	}
+	doGet() {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		const unloaded = this.findUnloadedReference();
+		if (unloaded) throw new Error(this.toString() + `.get was called but ${unloaded} was not loaded`);
+		const parents = [];
+		const visited = /* @__PURE__ */ new Set();
+		for (let current = getLoadedReference(this.entity[this.#m2oName]); current !== void 0; current = getLoadedReference(current[this.#m2oName])) {
+			parents.push(current);
+			if (visited.has(current)) throw new require_relations_RecursiveCycleError.RecursiveCycleError(this, [...visited, current]);
+			visited.add(current);
+		}
+		return parents;
+	}
+	findUnloadedReference() {
+		const visited = /* @__PURE__ */ new Set();
+		for (let current = this.entity; current !== void 0; current = getLoadedReference(current[this.#m2oName])) {
+			const relation = current[this.#m2oName];
+			if (require_relations_Reference.isReference(relation) && !require_relations_Reference.isLoadedReference(relation)) return relation;
+			if (visited.has(current)) throw new require_relations_RecursiveCycleError.RecursiveCycleError(this, [...visited, current]);
+			visited.add(current);
+		}
+	}
+};
+var RecursiveChildrenCollectionImpl = class extends AbstractRecursiveCollectionImpl {
+	#fieldName;
+	#o2mName;
+	#otherFieldName;
+	#loaded = void 0;
+	#loadPromise;
+	constructor(entity, fieldName, o2mName, otherFieldName) {
+		super(entity);
+		this.#fieldName = fieldName;
+		this.#o2mName = o2mName;
+		this.#otherFieldName = otherFieldName;
+	}
+	async load(opts = {}) {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		if (!this.isLoaded || opts.forceReload) {
+			if (opts.forceReload) this.#loaded = void 0;
+			if (!this.entity.isNewEntity) await (this.#loadPromise ??= require_batchloaders_recursiveChildrenBatchLoader.recursiveChildrenBatchLoader(this.entity.em, this).load(this.entity).catch(function load(err) {
+				throw require_EntityManager.appendStack(err, /* @__PURE__ */ new Error());
+			}).finally(() => {
+				this.#loadPromise = void 0;
+			}));
+			const unloaded = this.findUnloadedCollections();
+			if (unloaded.length > 0) await Promise.all(unloaded.map((r) => r.entity[this.fieldName].load(opts)));
+			this.#loaded = true;
+		}
+		return this.filterDeleted(this.doGet(), opts);
+	}
+	get isLoaded() {
+		if (this.#loaded !== void 0) return this.#loaded;
+		this.#loaded = this.findUnloadedCollections().length === 0;
+		require_EntityManager.getEmInternalApi(this.entity.em).isLoadedCache.addNaive(this);
+		return this.#loaded;
+	}
+	resetIsLoaded() {
+		this.#loaded = void 0;
+	}
+	get fieldName() {
+		return this.#fieldName;
+	}
+	get o2mFieldName() {
+		return this.#o2mName;
+	}
+	get otherFieldName() {
+		return this.#otherFieldName;
+	}
+	get hasBeenSet() {
+		return false;
+	}
+	toString() {
+		return `RecursiveChildrenCollectionImpl(entity: ${this.entity}, fieldName: ${this.fieldName})`;
+	}
+	doGet() {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		if (!this.isLoaded) throw new Error(this.toString() + `.get was called but when not loaded`);
+		const children = [];
+		const visited = /* @__PURE__ */ new Set();
+		const todo = [{
+			relation: this.entity[this.#o2mName],
+			path: [this.entity]
+		}];
+		while (todo.length > 0) {
+			const { relation, path } = todo.pop();
+			if (visited.has(relation)) throw new require_relations_RecursiveCycleError.RecursiveCycleError(this, path);
+			visited.add(relation);
+			for (const child of getLoadedCollection(relation)) {
+				children.push(child);
+				todo.push({
+					relation: child[this.#o2mName],
+					path: [...path, child]
+				});
+			}
+		}
+		return children;
+	}
+	/** Finds any children/downstream o2m collections or o2o references. */
+	findUnloadedCollections() {
+		const visited = /* @__PURE__ */ new Set();
+		const unloaded = [];
+		const todo = [{
+			relation: this.entity[this.#o2mName],
+			path: [this.entity]
+		}];
+		while (todo.length > 0) {
+			const { relation, path } = todo.pop();
+			if (visited.has(relation)) throw new require_relations_RecursiveCycleError.RecursiveCycleError(this, path);
+			visited.add(relation);
+			if (require_relations_Collection.isCollection(relation) && !require_relations_Collection.isLoadedCollection(relation)) unloaded.push(relation);
+			else if (require_relations_OneToOneReference.isOneToOneReference(relation) && !require_relations_OneToOneReference.isLoadedOneToOneReference(relation)) unloaded.push(relation);
+			else for (const child of getLoadedCollection(relation)) todo.push({
+				relation: child[this.#o2mName],
+				path: [...path, child]
+			});
+		}
+		return unloaded;
+	}
+};
+var RecursiveM2mCollectionImpl = class extends AbstractRecursiveCollectionImpl {
+	#fieldName;
+	#m2mName;
+	#otherFieldName;
+	#loaded = void 0;
+	#loadPromise;
+	constructor(entity, fieldName, m2mName, otherFieldName) {
+		super(entity);
+		this.#fieldName = fieldName;
+		this.#m2mName = m2mName;
+		this.#otherFieldName = otherFieldName;
+	}
+	async load(opts = {}) {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		if (!this.isLoaded || opts.forceReload) {
+			if (opts.forceReload) this.#loaded = void 0;
+			if (!this.entity.isNewEntity) await (this.#loadPromise ??= require_batchloaders_recursiveM2mBatchLoader.recursiveM2mBatchLoader(this.entity.em, this).load(this.entity).catch(function load(err) {
+				throw require_EntityManager.appendStack(err, /* @__PURE__ */ new Error());
+			}).finally(() => {
+				this.#loadPromise = void 0;
+			}));
+			const unloaded = this.findUnloadedCollections();
+			if (unloaded.length > 0) await Promise.all(unloaded.map((r) => r.entity[this.fieldName].load(opts)));
+			this.#loaded = true;
+		}
+		return this.filterDeleted(this.doGet(), opts);
+	}
+	get isLoaded() {
+		if (this.#loaded !== void 0) return this.#loaded;
+		this.#loaded = this.findUnloadedCollections().length === 0;
+		require_EntityManager.getEmInternalApi(this.entity.em).isLoadedCache.addNaive(this);
+		return this.#loaded;
+	}
+	resetIsLoaded() {
+		this.#loaded = void 0;
+	}
+	get fieldName() {
+		return this.#fieldName;
+	}
+	get m2mFieldName() {
+		return this.#m2mName;
+	}
+	get otherFieldName() {
+		return this.#otherFieldName;
+	}
+	get m2mField() {
+		return this.meta.allFields[this.#m2mName];
+	}
+	get hasBeenSet() {
+		return false;
+	}
+	toString() {
+		return `RecursiveM2mCollectionImpl(entity: ${this.entity}, fieldName: ${this.fieldName})`;
+	}
+	doGet() {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		if (!this.isLoaded) throw new Error(this.toString() + `.get was called but when not loaded`);
+		const results = [];
+		const visited = /* @__PURE__ */ new Set();
+		visited.add(this.entity);
+		const todo = [{
+			entity: this.entity,
+			path: [this.entity]
+		}];
+		while (todo.length > 0) {
+			const { entity: current, path } = todo.pop();
+			for (const other of getLoadedCollection(current[this.#m2mName])) {
+				if (visited.has(other)) {
+					if (other === this.entity) throw new require_relations_RecursiveCycleError.RecursiveCycleError(this, [...path, other]);
+					continue;
+				}
+				visited.add(other);
+				results.push(other);
+				todo.push({
+					entity: other,
+					path: [...path, other]
+				});
+			}
+		}
+		return results;
+	}
+	/** Finds any m2m collections that are not yet loaded in the recursive tree. */
+	findUnloadedCollections() {
+		const visited = /* @__PURE__ */ new Set();
+		visited.add(this.entity);
+		const unloaded = [];
+		const todo = [{
+			entity: this.entity,
+			path: [this.entity]
+		}];
+		while (todo.length > 0) {
+			const { entity: current, path } = todo.pop();
+			const relation = current[this.#m2mName];
+			if (require_relations_Collection.isCollection(relation) && !require_relations_Collection.isLoadedCollection(relation)) unloaded.push(relation);
+			else for (const other of getLoadedCollection(relation)) {
+				if (visited.has(other)) {
+					if (other === this.entity) throw new require_relations_RecursiveCycleError.RecursiveCycleError(this, [...path, other]);
+					continue;
+				}
+				visited.add(other);
+				todo.push({
+					entity: other,
+					path: [...path, other]
+				});
+			}
+		}
+		return unloaded;
+	}
+};
+function getLoadedReference(relation) {
+	return require_relations_Reference.isLoadedReference(relation) ? relation.get : require_utils.fail(`${relation} was not loaded`);
+}
+function getLoadedCollection(relation) {
+	return require_relations_Collection.isLoadedCollection(relation) ? relation.get : require_relations_OneToOneReference.isLoadedOneToOneReference(relation) ? relation.get ? [relation.get] : [] : require_utils.fail(`${relation} was not loaded`);
+}
+//#endregion
+exports.RecursiveChildrenCollectionImpl = RecursiveChildrenCollectionImpl;
+exports.RecursiveCycleError = require_relations_RecursiveCycleError.RecursiveCycleError;
+exports.RecursiveM2mCollectionImpl = RecursiveM2mCollectionImpl;
+exports.RecursiveParentsCollectionImpl = RecursiveParentsCollectionImpl;
+exports.hasRecursiveChildren = hasRecursiveChildren;
+exports.hasRecursiveM2m = hasRecursiveM2m;
+exports.hasRecursiveParents = hasRecursiveParents;
+
+//# sourceMappingURL=RecursiveCollection.cjs.map