joist-core 2.3.0 → 2.4.0-next.2

package/build/relations/EnumCollection.js

@@ -1,211 +1,176 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnumCollectionImpl = void 0;
-exports.hasEnumCollection = hasEnumCollection;
-const __1 = require("../");
-const enumCollectionBatchLoader_1 = require("../batchloaders/enumCollectionBatchLoader");
-const newEntity_1 = require("../newEntity");
-const utils_1 = require("../utils");
-const AbstractRelationImpl_1 = require("./AbstractRelationImpl");
-const Relation_1 = require("./Relation");
+import { AbstractRelationImpl } from "./AbstractRelationImpl.js";
+import { RelationT, RelationU } from "./RelationSymbols.js";
+import { remove } from "../utils.js";
+import { lazyField } from "../newEntity.js";
+import { getMetadata, getMetadataForField } from "../EntityMetadata.js";
+import { ensureNotDeleted } from "../index.js";
+import { enumCollectionBatchLoader } from "../batchloaders/enumCollectionBatchLoader.js";
+import { appendStack, getEmInternalApi } from "../EntityManager.js";
+import { getInstanceData } from "../BaseEntity.js";
+//#region src/relations/EnumCollection.ts
 /** An alias for creating `EnumCollection`s. */
 function hasEnumCollection() {
-    return (0, newEntity_1.lazyField)((entity, fieldName) => {
-        const field = (0, __1.getMetadata)(entity).allFields[fieldName];
-        return new EnumCollectionImpl(entity, field);
-    });
+	return lazyField((entity, fieldName) => {
+		const field = getMetadata(entity).allFields[fieldName];
+		return new EnumCollectionImpl(entity, field);
+	});
 }
-class EnumCollectionImpl extends AbstractRelationImpl_1.AbstractRelationImpl {
-    #field;
-    #loaded;
-    #loadPromise;
-    #hasBeenSet = false;
-    /** Holds a pending `set()` when called on an unloaded collection, resolved at load. */
-    #pendingSet;
-    constructor(entity, field) {
-        super(entity);
-        this.#field = field;
-        this.#loaded = (0, __1.getInstanceData)(entity).isOrWasNew;
-    }
-    async load(opts = {}) {
-        (0, __1.ensureNotDeleted)(this.entity, "pending");
-        if (!this.#loaded || (opts.forceReload && !this.entity.isNewEntity)) {
-            if (this.#getPreloaded() !== undefined) {
-                this.#loaded = true;
-            }
-            else {
-                await (this.#loadPromise ??= (0, enumCollectionBatchLoader_1.enumCollectionBatchLoader)(this.entity.em, this).load(this.entity.idTagged))
-                    .then(() => {
-                    this.#loaded = true;
-                })
-                    .catch(function load(err) {
-                    throw (0, __1.appendStack)(err, new Error());
-                })
-                    .finally(() => {
-                    this.#loadPromise = undefined;
-                });
-            }
-            if (this.#pendingSet) {
-                const pending = this.#pendingSet;
-                this.#pendingSet = undefined;
-                this.#applySet(pending);
-            }
-        }
-        return this.get;
-    }
-    add(code) {
-        (0, __1.ensureNotDeleted)(this.entity);
-        if (this.#pendingSet) {
-            if (!this.#pendingSet.includes(code))
-                this.#pendingSet.push(code);
-            return;
-        }
-        if (this.#loaded && this.get.includes(code))
-            return;
-        this.#joinRows.addNew(this, this.entity, this.#idOf(code));
-    }
-    remove(code) {
-        (0, __1.ensureNotDeleted)(this.entity, "pending");
-        if (this.#pendingSet) {
-            (0, utils_1.remove)(this.#pendingSet, code);
-            return;
-        }
-        this.#joinRows.addRemove(this, this.entity, this.#idOf(code));
-    }
-    set(codes) {
-        (0, __1.ensureNotDeleted)(this.entity);
-        this.#hasBeenSet = true;
-        if (!this.#loaded) {
-            this.#pendingSet = [...codes];
-            (0, __1.getEmInternalApi)(this.entity.em).pendingLoads.add(this);
-            return;
-        }
-        this.#applySet(codes);
-    }
-    async includes(code) {
-        (0, __1.ensureNotDeleted)(this.entity, "pending");
-        if (this.#pendingSet)
-            return this.#pendingSet.includes(code);
-        if (this.#loaded)
-            return this.get.includes(code);
-        if (this.entity.isNewEntity)
-            return false;
-        await this.load();
-        return this.get.includes(code);
-    }
-    removeAll() {
-        (0, __1.ensureNotDeleted)(this.entity);
-        if (!this.#loaded)
-            throw new Error("removeAll was called when not loaded");
-        for (const code of [...this.get])
-            this.remove(code);
-    }
-    get get() {
-        (0, __1.ensureNotDeleted)(this.entity, "pending");
-        if (!this.#loaded) {
-            throw new Error(`${this.entity}.${this.fieldName}.get was called when not loaded`);
-        }
-        return this.#codesFor(this.entity);
-    }
-    get isLoaded() {
-        return this.#loaded;
-    }
-    get isPreloaded() {
-        return this.#getPreloaded() !== undefined;
-    }
-    preload() {
-        if (this.#getPreloaded() !== undefined)
-            this.#loaded = true;
-    }
-    setFromOpts(codes) {
-        this.#loaded = true;
-        for (const code of codes ?? [])
-            this.add(code);
-    }
-    /**
-     * Mirrors `other`'s codes into us for `em.fork`/`importEntity`.
-     *
-     * Enum codes have no entity identity to remap, and we copy them as already-persisted rows (not
-     * pending adds) so the receiving em doesn't think it has spurious inserts to flush.
-     */
-    import(other) {
-        if (!other.isLoaded)
-            return;
-        this.#loaded = true;
-        for (const code of other.get) {
-            this.#joinRows.addPreloadedRow(this, undefined, this.entity, this.#idOf(code));
-        }
-    }
-    maybeCascadeDelete() {
-        // The join table FK cascades on the db side, so there's nothing to cascade in memory.
-    }
-    async cleanupOnEntityDeleted() {
-        // The db cascade-deletes our join rows, so just drop any pending in-memory changes for us.
-        this.#joinRows.removeAllFor(this.columnName, this.entity);
-    }
-    get fieldName() {
-        return this.#field.fieldName;
-    }
-    get hasBeenSet() {
-        return this.#hasBeenSet;
-    }
-    toString() {
-        return `EnumCollection(entity: ${this.entity}, fieldName: ${this.fieldName}, enum: ${this.#field.enumDetailType.name})`;
-    }
-    #applySet(codes) {
-        const current = this.get;
-        for (const code of current)
-            if (!codes.includes(code))
-                this.remove(code);
-        for (const code of codes)
-            if (!current.includes(code))
-                this.add(code);
-    }
-    /** The current (non-deleted) codes for `entity`, sorted by enum id for a stable order. */
-    #codesFor(entity) {
-        return this.#joinRows.getOthers(this.columnName, entity)
-            .sort((a, b) => a - b)
-            .map((id) => this.#field.enumDetailType.findById(id).code);
-    }
-    #idOf(code) {
-        return this.#field.enumDetailType.getByCode(code).id;
-    }
-    #getPreloaded() {
-        if (this.entity.isNewEntity)
-            return undefined;
-        return (0, __1.getEmInternalApi)(this.entity.em).getPreloadedRelation(this.entity.idTagged, this.fieldName);
-    }
-    get #joinRows() {
-        return (0, __1.getEmInternalApi)(this.entity.em).joinRows(this);
-    }
-    // The `ManyToManyLike` surface, so JoinRows/batch loaders can use us directly. There is no
-    // `otherMeta`/`otherFieldName` because the "other" side is an enum table, not an entity.
-    get joinTableName() {
-        return this.#field.joinTableName;
-    }
-    get columnName() {
-        return this.#field.columnNames[0];
-    }
-    get otherColumnName() {
-        return this.#field.columnNames[1];
-    }
-    get meta() {
-        return (0, __1.getMetadataForField)((0, __1.getMetadata)(this.entity), this.#field.fieldName);
-    }
-    get otherEnum() {
-        return this.#field.enumDetailType;
-    }
-    get otherMeta() {
-        return undefined;
-    }
-    get otherFieldName() {
-        return undefined;
-    }
-    get hasJoinTableId() {
-        return this.#field.hasJoinTableId;
-    }
-    [Relation_1.RelationT] = null;
-    [Relation_1.RelationU] = null;
-}
-exports.EnumCollectionImpl = EnumCollectionImpl;
+var EnumCollectionImpl = class extends AbstractRelationImpl {
+	#field;
+	#loaded;
+	#loadPromise;
+	#hasBeenSet = false;
+	/** Holds a pending `set()` when called on an unloaded collection, resolved at load. */
+	#pendingSet;
+	constructor(entity, field) {
+		super(entity);
+		this.#field = field;
+		this.#loaded = getInstanceData(entity).isOrWasNew;
+	}
+	async load(opts = {}) {
+		ensureNotDeleted(this.entity, "pending");
+		if (!this.#loaded || opts.forceReload && !this.entity.isNewEntity) {
+			if (this.#getPreloaded() !== void 0) this.#loaded = true;
+			else await (this.#loadPromise ??= enumCollectionBatchLoader(this.entity.em, this).load(this.entity.idTagged)).then(() => {
+				this.#loaded = true;
+			}).catch(function load(err) {
+				throw appendStack(err, /* @__PURE__ */ new Error());
+			}).finally(() => {
+				this.#loadPromise = void 0;
+			});
+			if (this.#pendingSet) {
+				const pending = this.#pendingSet;
+				this.#pendingSet = void 0;
+				this.#applySet(pending);
+			}
+		}
+		return this.get;
+	}
+	add(code) {
+		ensureNotDeleted(this.entity);
+		if (this.#pendingSet) {
+			if (!this.#pendingSet.includes(code)) this.#pendingSet.push(code);
+			return;
+		}
+		if (this.#loaded && this.get.includes(code)) return;
+		this.#joinRows.addNew(this, this.entity, this.#idOf(code));
+	}
+	remove(code) {
+		ensureNotDeleted(this.entity, "pending");
+		if (this.#pendingSet) {
+			remove(this.#pendingSet, code);
+			return;
+		}
+		this.#joinRows.addRemove(this, this.entity, this.#idOf(code));
+	}
+	set(codes) {
+		ensureNotDeleted(this.entity);
+		this.#hasBeenSet = true;
+		if (!this.#loaded) {
+			this.#pendingSet = [...codes];
+			getEmInternalApi(this.entity.em).pendingLoads.add(this);
+			return;
+		}
+		this.#applySet(codes);
+	}
+	async includes(code) {
+		ensureNotDeleted(this.entity, "pending");
+		if (this.#pendingSet) return this.#pendingSet.includes(code);
+		if (this.#loaded) return this.get.includes(code);
+		if (this.entity.isNewEntity) return false;
+		await this.load();
+		return this.get.includes(code);
+	}
+	removeAll() {
+		ensureNotDeleted(this.entity);
+		if (!this.#loaded) throw new Error("removeAll was called when not loaded");
+		for (const code of [...this.get]) this.remove(code);
+	}
+	get get() {
+		ensureNotDeleted(this.entity, "pending");
+		if (!this.#loaded) throw new Error(`${this.entity}.${this.fieldName}.get was called when not loaded`);
+		return this.#codesFor(this.entity);
+	}
+	get isLoaded() {
+		return this.#loaded;
+	}
+	get isPreloaded() {
+		return this.#getPreloaded() !== void 0;
+	}
+	preload() {
+		if (this.#getPreloaded() !== void 0) this.#loaded = true;
+	}
+	setFromOpts(codes) {
+		this.#loaded = true;
+		for (const code of codes ?? []) this.add(code);
+	}
+	/**
+	* Mirrors `other`'s codes into us for `em.fork`/`importEntity`.
+	*
+	* Enum codes have no entity identity to remap, and we copy them as already-persisted rows (not
+	* pending adds) so the receiving em doesn't think it has spurious inserts to flush.
+	*/
+	import(other) {
+		if (!other.isLoaded) return;
+		this.#loaded = true;
+		for (const code of other.get) this.#joinRows.addPreloadedRow(this, void 0, this.entity, this.#idOf(code));
+	}
+	maybeCascadeDelete() {}
+	async cleanupOnEntityDeleted() {
+		this.#joinRows.removeAllFor(this.columnName, this.entity);
+	}
+	get fieldName() {
+		return this.#field.fieldName;
+	}
+	get hasBeenSet() {
+		return this.#hasBeenSet;
+	}
+	toString() {
+		return `EnumCollection(entity: ${this.entity}, fieldName: ${this.fieldName}, enum: ${this.#field.enumDetailType.name})`;
+	}
+	#applySet(codes) {
+		const current = this.get;
+		for (const code of current) if (!codes.includes(code)) this.remove(code);
+		for (const code of codes) if (!current.includes(code)) this.add(code);
+	}
+	/** The current (non-deleted) codes for `entity`, sorted by enum id for a stable order. */
+	#codesFor(entity) {
+		return this.#joinRows.getOthers(this.columnName, entity).sort((a, b) => a - b).map((id) => this.#field.enumDetailType.findById(id).code);
+	}
+	#idOf(code) {
+		return this.#field.enumDetailType.getByCode(code).id;
+	}
+	#getPreloaded() {
+		if (this.entity.isNewEntity) return void 0;
+		return getEmInternalApi(this.entity.em).getPreloadedRelation(this.entity.idTagged, this.fieldName);
+	}
+	get #joinRows() {
+		return getEmInternalApi(this.entity.em).joinRows(this);
+	}
+	get joinTableName() {
+		return this.#field.joinTableName;
+	}
+	get columnName() {
+		return this.#field.columnNames[0];
+	}
+	get otherColumnName() {
+		return this.#field.columnNames[1];
+	}
+	get meta() {
+		return getMetadataForField(getMetadata(this.entity), this.#field.fieldName);
+	}
+	get otherEnum() {
+		return this.#field.enumDetailType;
+	}
+	get otherMeta() {}
+	get otherFieldName() {}
+	get hasJoinTableId() {
+		return this.#field.hasJoinTableId;
+	}
+	[RelationT] = null;
+	[RelationU] = null;
+};
+//#endregion
+export { EnumCollectionImpl, hasEnumCollection };
+
 //# sourceMappingURL=EnumCollection.js.map

package/build/relations/EnumCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"EnumCollection.js","sourceRoot":"","sources":["../../src/relations/EnumCollection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"EnumCollection.js","names":["#field","#loaded","#getPreloaded","#loadPromise","#pendingSet","#applySet","#joinRows","#idOf","#hasBeenSet","#codesFor"],"sources":["../../src/relations/EnumCollection.ts"],"sourcesContent":["import { enumCollectionBatchLoader } from \"src/batchloaders/enumCollectionBatchLoader.ts\";\nimport { type EnumMetadata } from \"src/EnumMetadata.ts\";\nimport {\n  type Entity,\n  type EntityMetadata,\n  type ManyToManyEnumField,\n  type ManyToManyLike,\n  appendStack,\n  ensureNotDeleted,\n  getEmInternalApi,\n  getInstanceData,\n  getMetadata,\n  getMetadataForField,\n} from \"src/index.ts\";\nimport { lazyField } from \"src/newEntity.ts\";\nimport { AbstractRelationImpl } from \"src/relations/AbstractRelationImpl.ts\";\nimport { RelationT, RelationU } from \"src/relations/RelationSymbols.ts\";\nimport { remove } from \"src/utils.ts\";\n\n/** A nominal brand so `EnumCollection` is not structurally confused with a regular `Collection`. */\ndeclare const enumCollectionTag: unique symbol;\n\n/**\n * A collection of enum codes `E` within `T`, backed by a m2m join table to an enum \"table\".\n *\n * To the user it looks like an array of enum codes (e.g. `Color[]`), but unlike an enum-array\n * column it is lazy and so needs a load hint, like any other relation.\n */\nexport interface EnumCollection<T extends Entity, E> {\n  [enumCollectionTag]: true;\n  [RelationT]: T;\n  [RelationU]: E;\n\n  load(opts?: { forceReload?: boolean }): Promise<ReadonlyArray<E>>;\n\n  add(code: E): void;\n\n  remove(code: E): void;\n\n  /**\n   * Sets the collection to `codes`.\n   *\n   * Can be called on unloaded collections - the diff will be resolved at load or flush time.\n   */\n  set(codes: readonly E[]): void;\n\n  includes(code: E): Promise<boolean>;\n\n  readonly isLoaded: boolean;\n  readonly entity: Entity;\n  readonly hasBeenSet: boolean;\n}\n\n/** Adds a known-safe `get` accessor. */\nexport interface LoadedEnumCollection<T extends Entity, E> extends EnumCollection<T, E> {\n  get: ReadonlyArray<E>;\n\n  removeAll(): void;\n}\n\n/** An alias for creating `EnumCollection`s. */\nexport function hasEnumCollection<T extends Entity, E>(): EnumCollection<T, E> {\n  return lazyField((entity: T, fieldName) => {\n    const field = getMetadata(entity).allFields[fieldName] as ManyToManyEnumField;\n    return new EnumCollectionImpl<T, E>(entity, field);\n  });\n}\n\nexport class EnumCollectionImpl<T extends Entity, E>\n  extends AbstractRelationImpl<T, E[]>\n  implements EnumCollection<T, E>, LoadedEnumCollection<T, E>, ManyToManyLike\n{\n  readonly #field: ManyToManyEnumField;\n  #loaded: boolean;\n  #loadPromise: any;\n  #hasBeenSet = false;\n  /** Holds a pending `set()` when called on an unloaded collection, resolved at load. */\n  #pendingSet: E[] | undefined;\n\n  constructor(entity: T, field: ManyToManyEnumField) {\n    super(entity);\n    this.#field = field;\n    this.#loaded = getInstanceData(entity).isOrWasNew;\n  }\n\n  async load(opts: { forceReload?: boolean } = {}): Promise<ReadonlyArray<E>> {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (!this.#loaded || (opts.forceReload && !this.entity.isNewEntity)) {\n      if (this.#getPreloaded() !== undefined) {\n        this.#loaded = true;\n      } else {\n        await (this.#loadPromise ??= enumCollectionBatchLoader(this.entity.em, this).load(this.entity.idTagged!))\n          .then(() => {\n            this.#loaded = true;\n          })\n          .catch(function load(err: any) {\n            throw appendStack(err, new Error());\n          })\n          .finally(() => {\n            this.#loadPromise = undefined;\n          });\n      }\n      if (this.#pendingSet) {\n        const pending = this.#pendingSet;\n        this.#pendingSet = undefined;\n        this.#applySet(pending);\n      }\n    }\n    return this.get;\n  }\n\n  add(code: E): void {\n    ensureNotDeleted(this.entity);\n    if (this.#pendingSet) {\n      if (!this.#pendingSet.includes(code)) this.#pendingSet.push(code);\n      return;\n    }\n    if (this.#loaded && this.get.includes(code)) return;\n    this.#joinRows.addNew(this, this.entity, this.#idOf(code));\n  }\n\n  remove(code: E): void {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (this.#pendingSet) {\n      remove(this.#pendingSet, code);\n      return;\n    }\n    this.#joinRows.addRemove(this, this.entity, this.#idOf(code));\n  }\n\n  set(codes: readonly E[]): void {\n    ensureNotDeleted(this.entity);\n    this.#hasBeenSet = true;\n    if (!this.#loaded) {\n      this.#pendingSet = [...codes];\n      getEmInternalApi(this.entity.em).pendingLoads.add(this as any);\n      return;\n    }\n    this.#applySet(codes);\n  }\n\n  async includes(code: E): Promise<boolean> {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (this.#pendingSet) return this.#pendingSet.includes(code);\n    if (this.#loaded) return this.get.includes(code);\n    if (this.entity.isNewEntity) return false;\n    await this.load();\n    return this.get.includes(code);\n  }\n\n  removeAll(): void {\n    ensureNotDeleted(this.entity);\n    if (!this.#loaded) throw new Error(\"removeAll was called when not loaded\");\n    for (const code of [...this.get]) this.remove(code);\n  }\n\n  get get(): E[] {\n    ensureNotDeleted(this.entity, \"pending\");\n    if (!this.#loaded) {\n      throw new Error(`${this.entity}.${this.fieldName}.get was called when not loaded`);\n    }\n    return this.#codesFor(this.entity);\n  }\n\n  get isLoaded(): boolean {\n    return this.#loaded;\n  }\n\n  get isPreloaded(): boolean {\n    return this.#getPreloaded() !== undefined;\n  }\n\n  preload(): void {\n    if (this.#getPreloaded() !== undefined) this.#loaded = true;\n  }\n\n  setFromOpts(codes: E[]): void {\n    this.#loaded = true;\n    for (const code of codes ?? []) this.add(code);\n  }\n\n  /**\n   * Mirrors `other`'s codes into us for `em.fork`/`importEntity`.\n   *\n   * Enum codes have no entity identity to remap, and we copy them as already-persisted rows (not\n   * pending adds) so the receiving em doesn't think it has spurious inserts to flush.\n   */\n  import(other: EnumCollectionImpl<T, E>): void {\n    if (!other.isLoaded) return;\n    this.#loaded = true;\n    for (const code of other.get) {\n      this.#joinRows.addPreloadedRow(this, undefined, this.entity, this.#idOf(code));\n    }\n  }\n\n  maybeCascadeDelete(): void {\n    // The join table FK cascades on the db side, so there's nothing to cascade in memory.\n  }\n\n  async cleanupOnEntityDeleted(): Promise<void> {\n    // The db cascade-deletes our join rows, so just drop any pending in-memory changes for us.\n    this.#joinRows.removeAllFor(this.columnName, this.entity);\n  }\n\n  get fieldName(): string {\n    return this.#field.fieldName;\n  }\n\n  get hasBeenSet(): boolean {\n    return this.#hasBeenSet;\n  }\n\n  toString(): string {\n    return `EnumCollection(entity: ${this.entity}, fieldName: ${this.fieldName}, enum: ${this.#field.enumDetailType.name})`;\n  }\n\n  #applySet(codes: readonly E[]): void {\n    const current = this.get;\n    for (const code of current) if (!codes.includes(code)) this.remove(code);\n    for (const code of codes) if (!current.includes(code)) this.add(code);\n  }\n\n  /** The current (non-deleted) codes for `entity`, sorted by enum id for a stable order. */\n  #codesFor(entity: Entity): E[] {\n    return (this.#joinRows.getOthers(this.columnName, entity) as number[])\n      .sort((a, b) => a - b)\n      .map((id) => this.#field.enumDetailType.findById(id)!.code as E);\n  }\n\n  #idOf(code: E): number {\n    return this.#field.enumDetailType.getByCode(code).id;\n  }\n\n  #getPreloaded(): E[] | undefined {\n    if (this.entity.isNewEntity) return undefined;\n    return getEmInternalApi(this.entity.em).getPreloadedRelation<E>(this.entity.idTagged, this.fieldName);\n  }\n\n  get #joinRows() {\n    return getEmInternalApi(this.entity.em).joinRows(this);\n  }\n\n  // The `ManyToManyLike` surface, so JoinRows/batch loaders can use us directly. There is no\n  // `otherMeta`/`otherFieldName` because the \"other\" side is an enum table, not an entity.\n\n  get joinTableName(): string {\n    return this.#field.joinTableName;\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 meta(): EntityMetadata {\n    return getMetadataForField(getMetadata(this.entity), this.#field.fieldName);\n  }\n\n  get otherEnum(): EnumMetadata<any, any, number> {\n    return this.#field.enumDetailType;\n  }\n\n  get otherMeta(): undefined {\n    return undefined;\n  }\n\n  get otherFieldName(): undefined {\n    return undefined;\n  }\n\n  get hasJoinTableId(): boolean {\n    return this.#field.hasJoinTableId;\n  }\n\n  declare [enumCollectionTag]: true;\n  [RelationT]: T = null!;\n  [RelationU]: E = null!;\n}\n"],"mappings":"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"}

package/build/relations/LargeCollection.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./Relation.cjs");
+require("../EntityManager.cjs");
+require("../Entity.cjs");

package/build/relations/LargeCollection.d.cts

@@ -0,0 +1,22 @@
+import { Relation } from "./Relation.cjs";
+import { IdOf } from "../EntityManager.cjs";
+import { Entity } from "../Entity.cjs";
+//#region src/relations/LargeCollection.d.ts
+/**
+ * A large collection of `U` within `T`, where the parent has so many children
+ * that we cannot load them all at a single time.
+ *
+ * We consider this a `Relation`, but not a true `Collection` b/c it cannot be
+ * loaded.
+ */
+interface LargeCollection<T extends Entity, U extends Entity> extends Relation<T, U> {
+  /** Looks up the specific `id` without fully loading the collection. */
+  find(id: IdOf<U>): Promise<U | undefined>;
+  /** Looks up the specific `other` without fully loading the collection. */
+  includes(other: U): Promise<boolean>;
+  add(other: U): void;
+  remove(other: U): void;
+}
+//#endregion
+export { LargeCollection };
+//# sourceMappingURL=LargeCollection.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LargeCollection.d.cts","names":[],"sources":["../../src/relations/LargeCollection.ts"],"mappings":";;;;;;;;;;;UAWiB,gBAAgB,UAAU,QAAQ,UAAU,gBAAgB,SAAS,GAAG;;EAEvF,KAAK,IAAI,KAAK,KAAK,QAAQ;;EAG3B,SAAS,OAAO,IAAI;EAEpB,IAAI,OAAO;EAEX,OAAO,OAAO"}

package/build/relations/LargeCollection.d.mts

@@ -0,0 +1,22 @@
+import { Relation } from "./Relation.mjs";
+import { IdOf } from "../EntityManager.mjs";
+import { Entity } from "../Entity.mjs";
+//#region src/relations/LargeCollection.d.ts
+/**
+ * A large collection of `U` within `T`, where the parent has so many children
+ * that we cannot load them all at a single time.
+ *
+ * We consider this a `Relation`, but not a true `Collection` b/c it cannot be
+ * loaded.
+ */
+interface LargeCollection<T extends Entity, U extends Entity> extends Relation<T, U> {
+  /** Looks up the specific `id` without fully loading the collection. */
+  find(id: IdOf<U>): Promise<U | undefined>;
+  /** Looks up the specific `other` without fully loading the collection. */
+  includes(other: U): Promise<boolean>;
+  add(other: U): void;
+  remove(other: U): void;
+}
+//#endregion
+export { LargeCollection };
+//# sourceMappingURL=LargeCollection.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LargeCollection.d.mts","names":[],"sources":["../../src/relations/LargeCollection.ts"],"mappings":";;;;;;;;;;;UAWiB,gBAAgB,UAAU,QAAQ,UAAU,gBAAgB,SAAS,GAAG;;EAEvF,KAAK,IAAI,KAAK,KAAK,QAAQ;;EAG3B,SAAS,OAAO,IAAI;EAEpB,IAAI,OAAO;EAEX,OAAO,OAAO"}

package/build/relations/LargeCollection.js

@@ -1,3 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=LargeCollection.js.map
+import "./Relation.js";
+import "../EntityManager.js";
+import "../Entity.js";
+export {};

package/build/relations/LazyField.cjs

@@ -0,0 +1,140 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../batchloaders/BatchLoader.cjs");
+const require_relations_AbstractPropertyImpl = require("./AbstractPropertyImpl.cjs");
+const require_relations_PropertySymbols = require("./PropertySymbols.cjs");
+require("./hasProperty.cjs");
+const require_fields = require("../fields.cjs");
+const require_keys = require("../keys.cjs");
+const require_queries_sql_keywords = require("../queries/sql/keywords.cjs");
+const require_RowData = require("../RowData.cjs");
+const require_utils = require("../utils.cjs");
+const require_newEntity = require("../newEntity.cjs");
+const require_EntityMetadata = require("../EntityMetadata.cjs");
+require("../EntityManager.cjs");
+require("../Entity.cjs");
+const require_BaseEntity = require("../BaseEntity.cjs");
+//#region src/relations/LazyField.ts
+const lazyColumnLoadOperation = "lazy-column-load";
+/**
+* The "original value" of an unloaded lazy column: unknown, and never equal to any set value.
+*
+* Seeded into `__orm.data` by `LazyFieldImpl.set` so that setting an unloaded column (even to
+* `undefined`) always registers as a change, i.e. instead of comparing equal to the `undefined`
+* that the excluded column would otherwise read as.
+*/
+const notLoadedValue = Symbol("notLoadedValue");
+/** Creates a `LazyField` for a column that codegen has marked `lazy: true`. */
+function hasLazyField() {
+	return require_newEntity.lazyField((entity, fieldName) => new LazyFieldImpl(entity, fieldName));
+}
+var LazyFieldImpl = class extends require_relations_AbstractPropertyImpl.AbstractPropertyImpl {
+	#fieldName;
+	#loaded = false;
+	#loadPromise;
+	constructor(entity, fieldName) {
+		super(entity);
+		this.#fieldName = fieldName;
+	}
+	/** Fetches this column from the database (batched across peers) and caches it on the entity. */
+	load(opts) {
+		const { entity } = this;
+		if (opts?.forceReload) {
+			this.#loaded = false;
+			this.#loadPromise = void 0;
+		}
+		if (this.isLoaded) return Promise.resolve(this.#value);
+		const meta = require_EntityMetadata.getMetadata(entity);
+		return this.#loadPromise ??= lazyColumnBatchLoader(entity.em, meta, this.#fieldName).load(entity.idTagged).then(() => {
+			this.#loaded = true;
+			return this.#value;
+		});
+	}
+	get get() {
+		if (!this.isLoaded) throw new Error(`${this.#fieldName} has not been loaded yet, use '.load()' or an 'em.populate' hint`);
+		return this.#value;
+	}
+	/** Sets the value in memory; the column is dirtied and written on the next `em.flush`. */
+	set(value) {
+		if (this.isLoaded) require_fields.setField(this.entity, this.#fieldName, value);
+		else {
+			const { data } = require_BaseEntity.getInstanceData(this.entity);
+			data[this.#fieldName] = notLoadedValue;
+			try {
+				require_fields.setField(this.entity, this.#fieldName, value);
+			} catch (e) {
+				delete data[this.#fieldName];
+				throw e;
+			}
+		}
+		this.#loaded = true;
+	}
+	get isLoaded() {
+		if (require_BaseEntity.getInstanceData(this.entity).isOrWasNew) return true;
+		return this.#loaded;
+	}
+	/** Called after em.flush to invalidate the cached value, since the db state may have changed. */
+	resetAfterFlush() {
+		this.#loaded = false;
+		this.#loadPromise = void 0;
+	}
+	/** The domain value, which `load`/`set` keep in the entity's `__orm.data` like any other column. */
+	get #value() {
+		return require_BaseEntity.getInstanceData(this.entity).data[this.#fieldName];
+	}
+	[require_relations_PropertySymbols.PropertyT] = void 0;
+};
+/** Type guard utility for determining if an entity field is a LazyField. */
+function isLazyField(maybe) {
+	return maybe instanceof LazyFieldImpl;
+}
+/** Type guard utility for determining if an entity field is a loaded LazyField. */
+function isLoadedLazyField(maybe) {
+	return isLazyField(maybe) && maybe.isLoaded;
+}
+/** Batches `LazyField.load`s for the same column into a single `SELECT id, <column> ... WHERE id IN (...)`. */
+function lazyColumnBatchLoader(em, meta, fieldName) {
+	return em.getBatchLoader(lazyColumnLoadOperation, `${meta.tableName}-${fieldName}`, async (taggedIds) => {
+		const field = meta.allFields[fieldName];
+		const column = field.serde.columns[0];
+		const alias = require_utils.abbreviation(meta.tableName);
+		const keys = taggedIds.map((id) => require_keys.keyToNumber(meta, id));
+		const query = {
+			selects: [`${require_queries_sql_keywords.kqDot(alias, "id")} as id`, require_queries_sql_keywords.kqDot(alias, column.columnName)],
+			tables: [{
+				alias,
+				join: "primary",
+				table: meta.tableName
+			}],
+			condition: {
+				kind: "exp",
+				op: "and",
+				conditions: [{
+					kind: "column",
+					alias,
+					column: "id",
+					dbType: meta.idDbType,
+					cond: {
+						kind: "in",
+						value: keys
+					}
+				}]
+			},
+			orderBys: []
+		};
+		const rows = await em["executeFind"](meta, lazyColumnLoadOperation, query, {});
+		const rowData = new require_RowData.PojoRowData(rows);
+		for (let i = 0; i < rows.length; i++) {
+			const entity = em.findExistingInstance(require_keys.tagId(meta, rows[i].id));
+			if (entity) require_BaseEntity.getInstanceData(entity).data[fieldName] = field.serde.fromRow(rowData, i);
+		}
+	});
+}
+//#endregion
+exports.LazyFieldImpl = LazyFieldImpl;
+exports.hasLazyField = hasLazyField;
+exports.isLazyField = isLazyField;
+exports.isLoadedLazyField = isLoadedLazyField;
+exports.lazyColumnLoadOperation = lazyColumnLoadOperation;
+exports.notLoadedValue = notLoadedValue;
+
+//# sourceMappingURL=LazyField.cjs.map