joist-core 2.3.0 → 2.4.0-next.2

package/build/relations/ManyToManyCollection.cjs

@@ -0,0 +1,421 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_relations_AbstractRelationImpl = require("./AbstractRelationImpl.cjs");
+const require_relations_RelationSymbols = require("./RelationSymbols.cjs");
+const require_keys = require("../keys.cjs");
+const require_batchloaders_manyToManyBatchLoader = require("../batchloaders/manyToManyBatchLoader.cjs");
+const require_dataloaders_manyToManyFindDataLoader = require("../dataloaders/manyToManyFindDataLoader.cjs");
+const require_relations_isCascadeDelete = require("./isCascadeDelete.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");
+const require_BaseEntity = require("../BaseEntity.cjs");
+//#region src/relations/ManyToManyCollection.ts
+/** An alias for creating `ManyToManyCollections`s. */
+function hasManyToMany() {
+	return require_newEntity.lazyField((entity, fieldName) => {
+		const m2m = require_EntityMetadata.getMetadata(entity).allFields[fieldName];
+		return new ManyToManyCollection(entity, m2m);
+	});
+}
+var ManyToManyCollection = class extends require_relations_AbstractRelationImpl.AbstractRelationImpl {
+	#field;
+	#loadPromise;
+	#state;
+	constructor(entity, field) {
+		super(entity);
+		this.#field = field;
+		if (require_BaseEntity.getInstanceData(entity).isOrWasNew) this.#state = new LoadedState(this, [], false);
+		else this.#state = new UnloadedPristineState(this);
+	}
+	/** @internal */
+	percolateAdd(other) {
+		other[this.otherFieldName].add(this.entity, true);
+	}
+	/** @internal */
+	percolateRemove(other) {
+		other[this.otherFieldName].remove(this.entity, true);
+	}
+	/** @internal */
+	registerJoinRowAdd(other) {
+		require_EntityManager.getEmInternalApi(this.entity.em).joinRows(this).addNew(this, this.entity, other);
+	}
+	/** @internal */
+	registerJoinRowRemove(other) {
+		require_EntityManager.getEmInternalApi(this.entity.em).joinRows(this).addRemove(this, this.entity, other);
+	}
+	/** Removes pending-hard-delete or soft-deleted entities, unless explicitly asked for. */
+	filterDeleted(entities, opts) {
+		if (opts?.withDeleted === true) return [...entities];
+		const includeSoftDeleted = this.#field.softDeletes === "include";
+		return entities.filter((e) => !e.isDeletedEntity && (includeSoftDeleted || !e.isSoftDeletedEntity));
+	}
+	async load(opts = {}) {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		if (!this.#state.isLoaded || opts.forceReload && !this.entity.isNewEntity) {
+			const key = `${this.columnName}=${this.entity.id}`;
+			const maybePreloaded = this.#getPreloaded();
+			if (maybePreloaded) this.#state = this.#state.applyLoad(maybePreloaded);
+			else await (this.#loadPromise ??= require_batchloaders_manyToManyBatchLoader.manyToManyBatchLoader(this.entity.em, this).load(key)).then(() => this.preload()).catch(function load(err) {
+				throw require_EntityManager.appendStack(err, /* @__PURE__ */ new Error());
+			}).finally(() => {
+				this.#loadPromise = void 0;
+			});
+		}
+		return this.filterDeleted(this.#state.doGet(), opts);
+	}
+	async find(id) {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		const inMemory = this.#state.find(id);
+		if (inMemory) return inMemory;
+		if (this.#state.isLoaded) return void 0;
+		const key = `${this.columnName}=${this.entity.id},${this.otherColumnName}=${id}`;
+		const includes = await require_dataloaders_manyToManyFindDataLoader.manyToManyFindDataLoader(this.entity.em, this).load(key).catch(function load(err) {
+			throw require_EntityManager.appendStack(err, /* @__PURE__ */ new Error());
+		});
+		const taggedId = require_keys.toTaggedId(this.otherMeta, id);
+		return includes ? this.entity.em.load(taggedId) : void 0;
+	}
+	async includes(other) {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		const inMemory = this.#state.includesInMemory(other);
+		if (inMemory !== void 0) return inMemory;
+		if (other.isNewEntity) return false;
+		const key = `${this.columnName}=${this.entity.id},${this.otherColumnName}=${other.id}`;
+		return require_dataloaders_manyToManyFindDataLoader.manyToManyFindDataLoader(this.entity.em, this).load(key).catch(function includes(err) {
+			throw require_EntityManager.appendStack(err, /* @__PURE__ */ new Error());
+		});
+	}
+	add(other, percolated = false) {
+		require_index.ensureNotDeleted(this.entity);
+		this.#state = this.#state.add(other, percolated);
+	}
+	remove(other, percolated = false) {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		this.#state = this.#state.remove(other, percolated);
+	}
+	get isLoaded() {
+		return this.#state.isLoaded;
+	}
+	get isPreloaded() {
+		return !!this.#getPreloaded();
+	}
+	preload() {
+		const preloaded = this.#getPreloaded();
+		if (preloaded) this.#state = this.#state.applyLoad(preloaded);
+	}
+	import(other, _, mapEntities) {
+		this.#state = other.#state.import(this, mapEntities);
+	}
+	doGet() {
+		require_index.ensureNotDeleted(this.entity, "pending");
+		return this.#state.doGet();
+	}
+	get getWithDeleted() {
+		return this.filterDeleted(this.doGet(), { withDeleted: true });
+	}
+	get get() {
+		return this.filterDeleted(this.doGet(), { withDeleted: false });
+	}
+	set(values) {
+		require_index.ensureNotDeleted(this.entity);
+		this.#state = this.#state.set(values);
+	}
+	removeAll() {
+		require_index.ensureNotDeleted(this.entity);
+		if (!this.#state.isLoaded) throw new Error("removeAll was called when not loaded");
+		for (const other of [...this.#state.doGet()]) this.remove(other);
+	}
+	setFromOpts(others) {
+		this.#state = new LoadedState(this, [], false);
+		others.forEach((o) => this.add(o));
+	}
+	maybeCascadeDelete() {
+		if (this.#isCascadeDelete) this.filterDeleted(this.#state.current({ withDeleted: true }), { withDeleted: true }).forEach((e) => this.entity.em.delete(e));
+	}
+	async cleanupOnEntityDeleted() {
+		if (this.#isCascadeDelete) return;
+		(await this.load({ withDeleted: true })).forEach((other) => {
+			other[this.otherFieldName].remove(this.entity);
+		});
+		if (this.#state instanceof LoadedState) this.#state.setLoaded([]);
+	}
+	get meta() {
+		return require_EntityMetadata.getMetadataForField(require_EntityMetadata.getMetadata(this.entity), this.fieldName);
+	}
+	get otherMeta() {
+		return this.#field.otherMetadata();
+	}
+	get joinTableName() {
+		return this.#field.joinTableName;
+	}
+	get fieldName() {
+		return this.#field.fieldName;
+	}
+	get otherFieldName() {
+		return this.#field.otherFieldName;
+	}
+	get columnName() {
+		return this.#field.columnNames[0];
+	}
+	get otherColumnName() {
+		return this.#field.columnNames[1];
+	}
+	get hasJoinTableId() {
+		return this.#field.hasJoinTableId;
+	}
+	get #isCascadeDelete() {
+		return require_relations_isCascadeDelete.isCascadeDelete(this, this.fieldName);
+	}
+	get hasBeenSet() {
+		return this.#state.hasBeenSet;
+	}
+	toString() {
+		return `OneToManyCollection(entity: ${this.entity}, fieldName: ${this.fieldName}, otherType: ${this.otherMeta.type}, otherFieldName: ${this.otherFieldName})`;
+	}
+	#getPreloaded() {
+		if (this.entity.isNewEntity) return void 0;
+		return require_EntityManager.getEmInternalApi(this.entity.em).getPreloadedRelation(this.entity.idTagged, this.fieldName);
+	}
+	[require_relations_RelationSymbols.RelationT] = null;
+	[require_relations_RelationSymbols.RelationU] = null;
+};
+/** Initial state for existing entities - no data loaded yet. */
+var UnloadedPristineState = class UnloadedPristineState {
+	isLoaded = false;
+	hasBeenSet = false;
+	#m2m;
+	constructor(m2m) {
+		this.#m2m = m2m;
+	}
+	add(other, percolated) {
+		const newState = new UnloadedAddedRemovedState(this.#m2m, [other], []);
+		if (!percolated) {
+			this.#m2m.registerJoinRowAdd(other);
+			this.#m2m.percolateAdd(other);
+		}
+		return newState;
+	}
+	remove(other, percolated) {
+		if (!percolated) {
+			this.#m2m.registerJoinRowRemove(other);
+			this.#m2m.percolateRemove(other);
+		}
+		return new UnloadedAddedRemovedState(this.#m2m, [], [other]);
+	}
+	set(values) {
+		return new PendingSetState(this.#m2m, [...values]);
+	}
+	doGet() {
+		throw new Error(`${this.#m2m.entity}.${this.#m2m.fieldName}.get was called when not loaded`);
+	}
+	find(_id) {}
+	includesInMemory(_other) {}
+	applyLoad(dbEntities) {
+		return new LoadedState(this.#m2m, dbEntities, false);
+	}
+	current(_opts) {
+		return [];
+	}
+	import(m2m, _mapEntities) {
+		return new UnloadedPristineState(m2m);
+	}
+};
+/** State when add/remove called before load - tracks changes to merge later. */
+var UnloadedAddedRemovedState = class UnloadedAddedRemovedState {
+	isLoaded = false;
+	hasBeenSet = false;
+	#m2m;
+	#added;
+	#removed;
+	constructor(m2m, added, removed) {
+		this.#m2m = m2m;
+		this.#added = added;
+		this.#removed = removed;
+	}
+	add(other, percolated) {
+		require_utils.maybeRemove(this.#removed, other);
+		if (!this.#added.includes(other)) this.#added.push(other);
+		if (!percolated) {
+			this.#m2m.registerJoinRowAdd(other);
+			this.#m2m.percolateAdd(other);
+		}
+		return this;
+	}
+	remove(other, percolated) {
+		if (!percolated) {
+			this.#m2m.registerJoinRowRemove(other);
+			this.#m2m.percolateRemove(other);
+		}
+		require_utils.maybeRemove(this.#added, other);
+		require_utils.maybeAdd(this.#removed, other);
+		return this;
+	}
+	set(values) {
+		return new PendingSetState(this.#m2m, [...values]);
+	}
+	doGet() {
+		throw new Error(`${this.#m2m.entity}.${this.#m2m.fieldName}.get was called when not loaded`);
+	}
+	find(id) {
+		return this.#added.find((u) => u.id === id);
+	}
+	includesInMemory(other) {
+		if (this.#added.includes(other)) return true;
+	}
+	applyLoad(dbEntities) {
+		const loaded = [...dbEntities];
+		for (const e of this.#added) if (!loaded.includes(e)) {
+			loaded.unshift(e);
+			this.#m2m.registerJoinRowAdd(e);
+		}
+		for (const e of this.#removed) {
+			require_utils.remove(loaded, e);
+			this.#m2m.registerJoinRowRemove(e);
+		}
+		return new LoadedState(this.#m2m, loaded, false);
+	}
+	current(_opts) {
+		return this.#added;
+	}
+	import(m2m, mapEntities) {
+		const added = mapEntities(this.#added);
+		const removed = mapEntities(this.#removed);
+		return new UnloadedAddedRemovedState(m2m, added ?? [], removed ?? []);
+	}
+};
+/** State when set() called before load - holds pending values to diff on load. */
+var PendingSetState = class PendingSetState {
+	isLoaded = false;
+	hasBeenSet = true;
+	#m2m;
+	#pendingSet;
+	constructor(m2m, pendingSet) {
+		this.#m2m = m2m;
+		this.#pendingSet = pendingSet;
+		require_EntityManager.getEmInternalApi(m2m.entity.em).pendingLoads.add(m2m);
+	}
+	add(other, percolated) {
+		if (!this.#pendingSet.includes(other)) this.#pendingSet.push(other);
+		if (!percolated) {
+			this.#m2m.registerJoinRowAdd(other);
+			this.#m2m.percolateAdd(other);
+		}
+		return this;
+	}
+	remove(other, percolated) {
+		if (!percolated) {
+			this.#m2m.registerJoinRowRemove(other);
+			this.#m2m.percolateRemove(other);
+		}
+		require_utils.remove(this.#pendingSet, other);
+		return this;
+	}
+	set(values) {
+		this.#pendingSet = [...values];
+		return this;
+	}
+	doGet() {
+		return this.#pendingSet;
+	}
+	find(id) {
+		return this.#pendingSet.find((u) => u.id === id);
+	}
+	includesInMemory(other) {
+		return this.#pendingSet.includes(other);
+	}
+	applyLoad(dbEntities) {
+		const loaded = [...dbEntities];
+		const pending = this.#pendingSet;
+		for (const other of [...loaded]) if (!pending.includes(other)) {
+			require_utils.remove(loaded, other);
+			this.#m2m.registerJoinRowRemove(other);
+			this.#m2m.percolateRemove(other);
+		}
+		for (const other of pending) if (!loaded.includes(other)) {
+			loaded.push(other);
+			this.#m2m.registerJoinRowAdd(other);
+			this.#m2m.percolateAdd(other);
+		}
+		return new LoadedState(this.#m2m, loaded, true);
+	}
+	current(_opts) {
+		return this.#pendingSet;
+	}
+	import(m2m, mapEntities) {
+		const pendingSet = mapEntities(this.#pendingSet);
+		return new PendingSetState(m2m, pendingSet ?? []);
+	}
+};
+/** State when collection is loaded - all operations work directly on loaded array. */
+var LoadedState = class LoadedState {
+	isLoaded = true;
+	#m2m;
+	#loaded;
+	#hasBeenSet;
+	constructor(m2m, loaded, hasBeenSet) {
+		this.#m2m = m2m;
+		this.#loaded = loaded;
+		this.#hasBeenSet = hasBeenSet;
+	}
+	get hasBeenSet() {
+		return this.#hasBeenSet;
+	}
+	add(other, percolated) {
+		if (this.#loaded.includes(other)) return this;
+		this.#loaded.push(other);
+		if (!percolated) {
+			this.#m2m.registerJoinRowAdd(other);
+			this.#m2m.percolateAdd(other);
+		}
+		return this;
+	}
+	remove(other, percolated) {
+		if (!percolated) {
+			this.#m2m.registerJoinRowRemove(other);
+			this.#m2m.percolateRemove(other);
+		}
+		require_utils.remove(this.#loaded, other);
+		return this;
+	}
+	set(values) {
+		this.#hasBeenSet = true;
+		const loaded = new Set(this.#loaded);
+		const valuesSet = new Set(values);
+		for (const other of loaded) if (!valuesSet.has(other)) this.remove(other, false);
+		for (const other of values) if (!loaded.has(other)) this.add(other, false);
+		return this;
+	}
+	doGet() {
+		return this.#loaded;
+	}
+	find(id) {
+		return this.#loaded.find((u) => u.id === id);
+	}
+	includesInMemory(other) {
+		return this.#loaded.includes(other);
+	}
+	applyLoad(dbEntities) {
+		this.#loaded = dbEntities;
+		return this;
+	}
+	current(_opts) {
+		return this.#loaded;
+	}
+	import(m2m, mapEntities) {
+		const loaded = mapEntities(this.#loaded);
+		return new LoadedState(m2m, loaded ?? [], this.#hasBeenSet);
+	}
+	getLoaded() {
+		return this.#loaded;
+	}
+	setLoaded(entities) {
+		this.#loaded = entities;
+	}
+};
+//#endregion
+exports.ManyToManyCollection = ManyToManyCollection;
+exports.hasManyToMany = hasManyToMany;
+
+//# sourceMappingURL=ManyToManyCollection.cjs.map

package/build/relations/ManyToManyCollection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManyToManyCollection.cjs","names":["lazyField","getMetadata","AbstractRelationImpl","#field","getInstanceData","#state","#getPreloaded","#loadPromise","manyToManyBatchLoader","appendStack","manyToManyFindDataLoader","toTaggedId","#isCascadeDelete","getMetadataForField","isCascadeDelete","getEmInternalApi","RelationT","RelationU","#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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"}

package/build/relations/ManyToManyCollection.d.cts

@@ -0,0 +1,59 @@
+import { Collection } from "./Collection.cjs";
+import { AbstractRelationImpl } from "./AbstractRelationImpl.cjs";
+import { RelationT, RelationU } from "./RelationSymbols.cjs";
+import { EntityMetadata, ManyToManyField } from "../EntityMetadata.cjs";
+import "../index.cjs";
+import { IdOf } from "../EntityManager.cjs";
+import { Entity } from "../Entity.cjs";
+//#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> {
+  #private;
+  constructor(entity: T, field: ManyToManyField);
+  /** @internal */
+  percolateAdd(other: U): void;
+  /** @internal */
+  percolateRemove(other: U): void;
+  /** @internal */
+  registerJoinRowAdd(other: U): void;
+  /** @internal */
+  registerJoinRowRemove(other: U): void;
+  /** Removes pending-hard-delete or soft-deleted entities, unless explicitly asked for. */
+  private filterDeleted;
+  load(opts?: {
+    withDeleted?: boolean;
+    forceReload?: boolean;
+  }): Promise<ReadonlyArray<U>>;
+  find(id: IdOf<U>): Promise<U | undefined>;
+  includes(other: U): Promise<boolean>;
+  add(other: U, percolated?: boolean): void;
+  remove(other: U, percolated?: boolean): void;
+  get isLoaded(): boolean;
+  get isPreloaded(): boolean;
+  preload(): void;
+  import(other: ManyToManyCollection<T, U>, _: unknown, mapEntities: (e: U[] | undefined) => U[] | undefined): void;
+  private doGet;
+  get getWithDeleted(): U[];
+  get get(): U[];
+  set(values: readonly U[]): void;
+  removeAll(): void;
+  setFromOpts(others: U[]): void;
+  maybeCascadeDelete(): void;
+  cleanupOnEntityDeleted(): Promise<void>;
+  get meta(): EntityMetadata;
+  get otherMeta(): EntityMetadata;
+  get joinTableName(): string;
+  get fieldName(): string;
+  get otherFieldName(): string & keyof U;
+  get columnName(): string;
+  get otherColumnName(): string;
+  get hasJoinTableId(): boolean;
+  get hasBeenSet(): boolean;
+  toString(): string;
+  [RelationT]: T;
+  [RelationU]: U;
+}
+//#endregion
+export { ManyToManyCollection, hasManyToMany };
+//# sourceMappingURL=ManyToManyCollection.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ManyToManyCollection.d.cts","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"}

package/build/relations/ManyToManyCollection.d.mts

@@ -0,0 +1,59 @@
+import { Collection } from "./Collection.mjs";
+import { AbstractRelationImpl } from "./AbstractRelationImpl.mjs";
+import { RelationT, RelationU } from "./RelationSymbols.mjs";
+import { EntityMetadata, ManyToManyField } from "../EntityMetadata.mjs";
+import "../index.mjs";
+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> {
+  #private;
+  constructor(entity: T, field: ManyToManyField);
+  /** @internal */
+  percolateAdd(other: U): void;
+  /** @internal */
+  percolateRemove(other: U): void;
+  /** @internal */
+  registerJoinRowAdd(other: U): void;
+  /** @internal */
+  registerJoinRowRemove(other: U): void;
+  /** Removes pending-hard-delete or soft-deleted entities, unless explicitly asked for. */
+  private filterDeleted;
+  load(opts?: {
+    withDeleted?: boolean;
+    forceReload?: boolean;
+  }): Promise<ReadonlyArray<U>>;
+  find(id: IdOf<U>): Promise<U | undefined>;
+  includes(other: U): Promise<boolean>;
+  add(other: U, percolated?: boolean): void;
+  remove(other: U, percolated?: boolean): void;
+  get isLoaded(): boolean;
+  get isPreloaded(): boolean;
+  preload(): void;
+  import(other: ManyToManyCollection<T, U>, _: unknown, mapEntities: (e: U[] | undefined) => U[] | undefined): void;
+  private doGet;
+  get getWithDeleted(): U[];
+  get get(): U[];
+  set(values: readonly U[]): void;
+  removeAll(): void;
+  setFromOpts(others: U[]): void;
+  maybeCascadeDelete(): void;
+  cleanupOnEntityDeleted(): Promise<void>;
+  get meta(): EntityMetadata;
+  get otherMeta(): EntityMetadata;
+  get joinTableName(): string;
+  get fieldName(): string;
+  get otherFieldName(): string & keyof U;
+  get columnName(): string;
+  get otherColumnName(): string;
+  get hasJoinTableId(): boolean;
+  get hasBeenSet(): boolean;
+  toString(): string;
+  [RelationT]: T;
+  [RelationU]: U;
+}
+//#endregion
+export { ManyToManyCollection, hasManyToMany };
+//# sourceMappingURL=ManyToManyCollection.d.mts.map

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

@@ -0,0 +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"}