joist-core 2.3.0 → 2.4.0-next.10

package/build/upsert.js

@@ -1,288 +1,173 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.updatePartial = updatePartial;
-exports.upsert = upsert;
-const joist_utils_1 = require("joist-utils");
-const defaults_1 = require("./defaults");
-const Entity_1 = require("./Entity");
-const EntityManager_1 = require("./EntityManager");
-const EntityMetadata_1 = require("./EntityMetadata");
-const index_1 = require("./index");
-const resurrection_1 = require("./resurrection");
-const utils_1 = require("./utils");
+import { toArray } from "./utils.js";
+import { getProperties } from "./getProperties.js";
+import "./typeMap.js";
+import { getConstructorFromTaggedId } from "./configure.js";
+import { getMetadata } from "./EntityMetadata.js";
+import { setSyncDefaults } from "./defaults.js";
+import { findExistingIfUniqueBy } from "./resurrection.js";
+import { asConcreteCstr, setOpt } from "./index.js";
+import { isKey } from "./EntityManager.js";
+import { isEntity } from "./Entity.js";
+import { isPlainObject } from "joist-utils";
+//#region src/upsert.ts
 /**
- * A utility function to do partial-update style updates.
- *
- * The difference between this and `Entity.setPartial` is that we accept `DeepPartialOrNull`
- * updates, similar to `createOrUpdateUnsafe`, instead of just a flat/shallow list of opts.
- */
+* A utility function to do partial-update style updates.
+*
+* The difference between this and `Entity.setPartial` is that we accept `DeepPartialOrNull`
+* updates, similar to `createOrUpdateUnsafe`, instead of just a flat/shallow list of opts.
+*/
 async function updatePartial(entity, input) {
-    if (Object.keys(input).length === 0)
-        return;
-    const meta = (0, EntityMetadata_1.getMetadata)(entity);
-    const { em } = entity;
-    // Do a Promise.all so we .load() relations in parallel
-    await Promise.all(Object.entries(input).map(async ([key, value]) => {
-        // setPartial ==> `undefined` is a noop
-        if (value === undefined)
-            return;
-        // Watch for the `bookId` / `bookIds` aliases
-        const field = meta.allFields[key] || Object.values(meta.allFields).find((f) => f.fieldIdName === key);
-        if (!field) {
-            // Allow (ignore here) delete/remove flags that we assume the API layer (i.e. GraphQL) will have specifically
-            // allowed, i.e. this isn't the Rails form bug where users can POST in any random field they want.
-            const flagField = key === "delete" || key === "remove" || key === "op";
-            if (flagField)
-                return;
-            // Look for non-field properties like a fullName setter
-            const prop = (0, index_1.getProperties)(meta)[key];
-            if (prop) {
-                (0, index_1.setOpt)(meta, entity, key, value);
-                return;
-            }
-            else {
-                throw new Error(`Unknown field ${key}`);
-            }
-        }
-        // Don't use key b/c it might be the bookId alias
-        const name = field.fieldName;
-        if (field.kind === "poly" && value && !(0, Entity_1.isEntity)(value)) {
-            // Resolve non-entity poly values
-            if ((0, EntityManager_1.isKey)(value)) {
-                (0, index_1.setOpt)(meta, entity, name, await em.load((0, index_1.getConstructorFromTaggedId)(value), value));
-            }
-            else {
-                throw new Error(`Cannot use partial value for polymorphic field `);
-            }
-        }
-        else if (field.kind === "m2o" && value && !(0, Entity_1.isEntity)(value)) {
-            // This is a many-to-one reference
-            if ((0, EntityManager_1.isKey)(value)) {
-                (0, index_1.setOpt)(meta, entity, name, await em.load(field.otherMetadata().cstr, value));
-            }
-            else if (typeof value === "object" && value) {
-                let other;
-                if ("id" in value) {
-                    // This is a many-to-one partial update to an existing entity (they passed an id)
-                    other = await upsert(em, field.otherMetadata().cstr, value);
-                }
-                else {
-                    // This is a many-to-one partial w/o passing an id, i.e. `upsert(Author, { id: "a:1", publisher: { name: "p1" } })`
-                    if (entity.isNewEntity) {
-                        // If we're brand new, our child/other has to be brand new as well
-                        other = await upsert(em, field.otherMetadata().cstr, value);
-                    }
-                    else {
-                        // the o2o upsert hash didn't have an id, so find-or-create it
-                        other = await entity[name].load();
-                        if (other) {
-                            await updatePartial(other, value);
-                        }
-                        else {
-                            other = await upsert(em, field.otherMetadata().cstr, value);
-                        }
-                    }
-                }
-                const deleteMarker = getDeleteMarker(field, value);
-                if (deleteMarker) {
-                    em.delete(other);
-                    other = undefined;
-                }
-                (0, index_1.setOpt)(meta, entity, name, other);
-            }
-        }
-        else if (field.kind === "o2o") {
-            // ^-- o2o always need loaded to be set, so don't fall through
-            if (value === null || (0, Entity_1.isEntity)(value)) {
-                await entity[name].load();
-                (0, index_1.setOpt)(meta, entity, name, value);
-            }
-            else if ((0, EntityManager_1.isKey)(value)) {
-                const [, other] = await Promise.all([
-                    entity[name].load(),
-                    em.load(field.otherMetadata().cstr, value),
-                ]);
-                (0, index_1.setOpt)(meta, entity, name, other);
-            }
-            else if (typeof value === "object" && (0, joist_utils_1.isPlainObject)(value)) {
-                const deleteMarker = getDeleteMarker(field, value);
-                // Always load the o2o so we can set it
-                const current = await entity[name].load();
-                let other;
-                if ("id" in value) {
-                    // The o2o upsert hash was passed an id, so load it
-                    other = await upsert(em, field.otherMetadata().cstr, value);
-                }
-                else {
-                    // the o2o upsert hash didn't have an id, so find-or-create it
-                    other = current;
-                    if (other) {
-                        await updatePartial(other, value);
-                    }
-                    else {
-                        other = await upsert(em, field.otherMetadata().cstr, value);
-                    }
-                }
-                if (deleteMarker) {
-                    em.delete(other);
-                }
-                else {
-                    (0, index_1.setOpt)(meta, entity, name, other);
-                }
-            }
-            else {
-                throw new Error(`Invalid value ${value}`);
-            }
-        }
-        else if (field.kind === "o2m" || field.kind === "m2m") {
-            // Look for one-to-many/many-to-many partials
-            // `null` is handled later, and treated as `[]`, which needs the collection loaded
-            const values = (0, utils_1.toArray)(value);
-            const otherMeta = field.otherMetadata();
-            const maybeSoftDelete = otherMeta.timestampFields?.deletedAt;
-            // Incremental handling. Detect incremental mode by a meaningful `op` value--`op: undefined`/`op: null`
-            // is the natural shape of an optional field and must behave like "no op", consistent with how
-            // updatePartial treats `value === undefined` and how delete/remove are read by truthiness.
-            const anyValueHasOp = values.some((v) => v && typeof v === "object" && !(0, Entity_1.isEntity)(v) && v.op != null);
-            if (anyValueHasOp) {
-                let anyValueMissingOp = false;
-                const current = entity[name];
-                // The `op` behavior means incremental and wants to do this:
-                await Promise.all(values.map(async (value) => {
-                    const [, , op] = getCollectionMarkers(field, value);
-                    if (op === "delete") {
-                        const other = await upsert(em, otherMeta.cstr, withOwnerField(field, value, entity));
-                        // We need to check if this is a soft-deletable entity, and if so, we will soft-delete it.
-                        if (maybeSoftDelete) {
-                            const serde = otherMeta.fields[maybeSoftDelete].serde;
-                            const now = new Date();
-                            other.set({ [maybeSoftDelete]: serde.mapFromNow(now) });
-                        }
-                        else {
-                            entity.em.delete(other);
-                        }
-                    }
-                    else if (op === "remove") {
-                        const other = await upsert(em, otherMeta.cstr, withOwnerField(field, value, entity));
-                        current.remove(other);
-                    }
-                    else if (op === "include") {
-                        const other = await upsert(em, otherMeta.cstr, withOwnerField(field, value, entity));
-                        current.add(other);
-                    }
-                    else if (op === "incremental") {
-                        // This is a marker entry, just ignore it
-                    }
-                    else {
-                        // A child entered incremental mode (a sibling had a real op) but has no op of its own;
-                        // never silently skip it--flag it so the guard below throws instead of dropping the row.
-                        anyValueMissingOp = true;
-                    }
-                }));
-                if (anyValueMissingOp) {
-                    throw new Error("If any child sets the `op` key, then all children must have the `op` key.");
-                }
-                return; // return from the op-based incremental behavior
-            }
-            // Otherwise we do exhaustive sets, will still looking for `delete`/`remove` markers
-            const others = await Promise.all(values.map(async (value) => {
-                if ((0, Entity_1.isEntity)(value)) {
-                    return value;
-                }
-                else if ((0, EntityManager_1.isKey)(value)) {
-                    return em.load(field.otherMetadata().cstr, value);
-                }
-                else if (value === null || value === undefined) {
-                    return undefined;
-                }
-                else if (!(0, joist_utils_1.isPlainObject)(value)) {
-                    throw new Error(`Invalid value ${value}`);
-                }
-                else {
-                    // Look for `delete: true/false` and `remove: true/false` markers
-                    const [deleteMarker, removeMarker] = getCollectionMarkers(field, value);
-                    const other = await upsert(em, field.otherMetadata().cstr, withOwnerField(field, value, entity));
-                    if (deleteMarker) {
-                        // if (maybeSoftDelete) {
-                        //   const serde = meta.fields[maybeSoftDelete].serde as TimestampSerde<unknown>;
-                        //   const now = new Date();
-                        //   other.set({ [maybeSoftDelete]: serde.mapFromNow(now) });
-                        // } else {
-                        // }
-                        em.delete(other);
-                        return other;
-                    }
-                    else if (removeMarker) {
-                        return undefined;
-                    }
-                    else {
-                        return other;
-                    }
-                }
-            }));
-            await entity[name].load();
-            (0, index_1.setOpt)(meta, entity, name, others.filter((v) => v !== undefined));
-        }
-        else {
-            // If we get here, value should be a vanilla value that `setOpt` can handle/pass through as-is
-            (0, index_1.setOpt)(meta, entity, name, value);
-        }
-    }));
+	if (Object.keys(input).length === 0) return;
+	const meta = getMetadata(entity);
+	const { em } = entity;
+	await Promise.all(Object.entries(input).map(async ([key, value]) => {
+		if (value === void 0) return;
+		const field = meta.allFields[key] || Object.values(meta.allFields).find((f) => f.fieldIdName === key);
+		if (!field) {
+			if (key === "delete" || key === "remove" || key === "op") return;
+			if (getProperties(meta)[key]) {
+				setOpt(meta, entity, key, value);
+				return;
+			} else throw new Error(`Unknown field ${key}`);
+		}
+		const name = field.fieldName;
+		if (field.kind === "poly" && value && !isEntity(value)) {
+			if (isKey(value)) setOpt(meta, entity, name, await em.load(getConstructorFromTaggedId(value), value));
+			else throw new Error(`Cannot use partial value for polymorphic field `);
+		} else if (field.kind === "m2o" && value && !isEntity(value)) {
+			if (isKey(value)) setOpt(meta, entity, name, await em.load(field.otherMetadata().cstr, value));
+			else if (typeof value === "object" && value) {
+				let other;
+				if ("id" in value) other = await upsert(em, field.otherMetadata().cstr, value);
+				else if (entity.isNewEntity) other = await upsert(em, field.otherMetadata().cstr, value);
+				else {
+					other = await entity[name].load();
+					if (other) await updatePartial(other, value);
+					else other = await upsert(em, field.otherMetadata().cstr, value);
+				}
+				if (getDeleteMarker(field, value)) {
+					em.delete(other);
+					other = void 0;
+				}
+				setOpt(meta, entity, name, other);
+			}
+		} else if (field.kind === "o2o") {
+			if (value === null || isEntity(value)) {
+				await entity[name].load();
+				setOpt(meta, entity, name, value);
+			} else if (isKey(value)) {
+				const [, other] = await Promise.all([entity[name].load(), em.load(field.otherMetadata().cstr, value)]);
+				setOpt(meta, entity, name, other);
+			} else if (typeof value === "object" && isPlainObject(value)) {
+				const deleteMarker = getDeleteMarker(field, value);
+				const current = await entity[name].load();
+				let other;
+				if ("id" in value) other = await upsert(em, field.otherMetadata().cstr, value);
+				else {
+					other = current;
+					if (other) await updatePartial(other, value);
+					else other = await upsert(em, field.otherMetadata().cstr, value);
+				}
+				if (deleteMarker) em.delete(other);
+				else setOpt(meta, entity, name, other);
+			} else throw new Error(`Invalid value ${value}`);
+		} else if (field.kind === "o2m" || field.kind === "m2m") {
+			const values = toArray(value);
+			const otherMeta = field.otherMetadata();
+			const maybeSoftDelete = otherMeta.timestampFields?.deletedAt;
+			if (values.some((v) => v && typeof v === "object" && !isEntity(v) && v.op != null)) {
+				let anyValueMissingOp = false;
+				const current = entity[name];
+				await Promise.all(values.map(async (value) => {
+					const [, , op] = getCollectionMarkers(field, value);
+					if (op === "delete") {
+						const other = await upsert(em, otherMeta.cstr, withOwnerField(field, value, entity));
+						if (maybeSoftDelete) {
+							const serde = otherMeta.fields[maybeSoftDelete].serde;
+							const now = /* @__PURE__ */ new Date();
+							other.set({ [maybeSoftDelete]: serde.mapFromNow(now) });
+						} else entity.em.delete(other);
+					} else if (op === "remove") {
+						const other = await upsert(em, otherMeta.cstr, withOwnerField(field, value, entity));
+						current.remove(other);
+					} else if (op === "include") {
+						const other = await upsert(em, otherMeta.cstr, withOwnerField(field, value, entity));
+						current.add(other);
+					} else if (op === "incremental") {} else anyValueMissingOp = true;
+				}));
+				if (anyValueMissingOp) throw new Error("If any child sets the `op` key, then all children must have the `op` key.");
+				return;
+			}
+			const others = await Promise.all(values.map(async (value) => {
+				if (isEntity(value)) return value;
+				else if (isKey(value)) return em.load(field.otherMetadata().cstr, value);
+				else if (value === null || value === void 0) return;
+				else if (!isPlainObject(value)) throw new Error(`Invalid value ${value}`);
+				else {
+					const [deleteMarker, removeMarker] = getCollectionMarkers(field, value);
+					const other = await upsert(em, field.otherMetadata().cstr, withOwnerField(field, value, entity));
+					if (deleteMarker) {
+						em.delete(other);
+						return other;
+					} else if (removeMarker) return;
+					else return other;
+				}
+			}));
+			await entity[name].load();
+			setOpt(meta, entity, name, others.filter((v) => v !== void 0));
+		} else setOpt(meta, entity, name, value);
+	}));
 }
 /**
- * A utility function to create-or-update/upsert entities coming from a partial-update style API.
- */
+* A utility function to create-or-update/upsert entities coming from a partial-update style API.
+*/
 async function upsert(em, constructor, input) {
-    const { id, ...rest } = input;
-    const entity = id !== null && id !== undefined
-        ? await em.load(constructor, id)
-        : // Look for an existing entity we could resurrect
-            ((id === undefined ? await (0, resurrection_1.findExistingIfUniqueBy)(em, constructor, rest) : undefined) ??
-                em.createPartial((0, index_1.asConcreteCstr)(constructor), {}));
-    await updatePartial(entity, rest);
-    // Do this manually since we're not going through setOpts anymore
-    if (entity.isNewEntity) {
-        (0, defaults_1.setSyncDefaults)(entity);
-    }
-    return entity;
+	const { id, ...rest } = input;
+	const entity = id !== null && id !== void 0 ? await em.load(constructor, id) : (id === void 0 ? await findExistingIfUniqueBy(em, constructor, rest) : void 0) ?? em.createPartial(asConcreteCstr(constructor), {});
+	await updatePartial(entity, rest);
+	if (entity.isNewEntity) setSyncDefaults(entity);
+	return entity;
 }
 /**
- * Adds the o2m owner field so child resurrection can find rows whose `uniqueBy` includes their parent.
- * I.e. upserting `Author.books: [{ title: "b1" }]` should lookup `Book.uniqueBy = [["author", "title"]]`.
- */
+* Adds the o2m owner field so child resurrection can find rows whose `uniqueBy` includes their parent.
+* I.e. upserting `Author.books: [{ title: "b1" }]` should lookup `Book.uniqueBy = [["author", "title"]]`.
+*/
 function withOwnerField(field, value, owner) {
-    if (field.kind !== "o2m" || !(0, joist_utils_1.isPlainObject)(value))
-        return value;
-    const ownerField = field.otherFieldName;
-    const ownerFieldId = field.otherMetadata().allFields[ownerField]?.fieldIdName;
-    if (Object.hasOwn(value, ownerField) || (ownerFieldId && Object.hasOwn(value, ownerFieldId)))
-        return value;
-    if (ownerFieldId && !owner.isNewEntity)
-        return { ...value, [ownerFieldId]: owner.id };
-    return { ...value, [ownerField]: owner };
+	if (field.kind !== "o2m" || !isPlainObject(value)) return value;
+	const ownerField = field.otherFieldName;
+	const ownerFieldId = field.otherMetadata().allFields[ownerField]?.fieldIdName;
+	if (Object.hasOwn(value, ownerField) || ownerFieldId && Object.hasOwn(value, ownerFieldId)) return value;
+	if (ownerFieldId && !owner.isNewEntity) return {
+		...value,
+		[ownerFieldId]: owner.id
+	};
+	return {
+		...value,
+		[ownerField]: owner
+	};
 }
 function getCollectionMarkers(field, value) {
-    const allowDelete = !field.otherMetadata().fields["delete"];
-    const allowRemove = !field.otherMetadata().fields["remove"];
-    const allowOp = !field.otherMetadata().fields["op"];
-    // Look for `delete: true/false` and `remove: true/false` markers
-    const deleteMarker = allowDelete && value["delete"];
-    const removeMarker = allowRemove && value["remove"];
-    const opMarker = allowOp && value["op"];
-    // Remove the markers, regardless of true/false, before recursing into upsert to avoid unknown fields
-    if (deleteMarker !== undefined)
-        delete value.delete;
-    if (removeMarker !== undefined)
-        delete value.remove;
-    if (opMarker !== undefined)
-        delete value.op;
-    return [deleteMarker, removeMarker, opMarker];
+	const allowDelete = !field.otherMetadata().fields["delete"];
+	const allowRemove = !field.otherMetadata().fields["remove"];
+	const allowOp = !field.otherMetadata().fields["op"];
+	const deleteMarker = allowDelete && value["delete"];
+	const removeMarker = allowRemove && value["remove"];
+	const opMarker = allowOp && value["op"];
+	if (deleteMarker !== void 0) delete value.delete;
+	if (removeMarker !== void 0) delete value.remove;
+	if (opMarker !== void 0) delete value.op;
+	return [
+		deleteMarker,
+		removeMarker,
+		opMarker
+	];
 }
 function getDeleteMarker(field, value) {
-    const allowDelete = !field.otherMetadata().fields["delete"];
-    const deleteMarker = allowDelete && value["delete"];
-    if (deleteMarker !== undefined)
-        delete value.delete;
-    return deleteMarker;
+	const deleteMarker = !field.otherMetadata().fields["delete"] && value["delete"];
+	if (deleteMarker !== void 0) delete value.delete;
+	return deleteMarker;
 }
+//#endregion
+export { updatePartial, upsert };
+
 //# sourceMappingURL=upsert.js.map

package/build/upsert.js.map

@@ -1 +1 @@
-{"version":3,"file":"upsert.js","sourceRoot":"","sources":["../src/upsert.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"upsert.js","names":[],"sources":["../src/upsert.ts"],"sourcesContent":["import { isPlainObject } from \"joist-utils\";\nimport { setSyncDefaults } from \"src/defaults.ts\";\nimport { type Entity, isEntity } from \"src/Entity.ts\";\nimport { type EntityManager, type IdOf, type MaybeAbstractEntityConstructor, isKey } from \"src/EntityManager.ts\";\nimport {\n  type ManyToManyField,\n  type ManyToOneField,\n  type OneToManyField,\n  type OneToOneField,\n  getMetadata,\n} from \"src/EntityMetadata.ts\";\nimport {\n  type PartialOrNull,\n  type TimestampSerde,\n  asConcreteCstr,\n  getConstructorFromTaggedId,\n  getProperties,\n  setOpt,\n} from \"src/index.ts\";\nimport { findExistingIfUniqueBy } from \"src/resurrection.ts\";\nimport { type OptIdsOf, type OptsOf } from \"src/typeMap.ts\";\nimport { type NullOrDefinedOr, toArray } from \"src/utils.ts\";\n\n/**\n * The type for `EntityManager.createOrUpdateUnsafe` that allows \"upsert\"-ish behavior.\n *\n * I.e. `T` is an entity with an optional id (create if unset, update if set), and we recurse\n * into any relations (references or collections) to allow those relations themselves to be\n * any combination of 1) ids to existing entities, 2) entities directly, 3) null/undefined\n * with the appropriate partial-update behavior, or 4) partials.\n */\nexport type DeepPartialOrNull<T extends Entity> = { id?: IdOf<T> | null } & AllowRelationsToBeIdsOrEntitiesOrPartials<\n  PartialOrNull<OptsOf<T> & OptIdsOf<T>>\n> &\n  OptIdsOf<T>;\n\n/** Flags that allow `upsert` to delete or remove entities. */\ntype CollectionFlags = {\n  delete?: boolean | null;\n  remove?: boolean | null;\n  op?: \"remove\" | \"delete\" | \"include\" | \"incremental\";\n};\n\n/** Flag that allows `upsert` to delete. */\ntype DeleteFlag = {\n  delete?: boolean | null;\n};\n\ntype AllowRelationsToBeIdsOrEntitiesOrPartials<T> = {\n  [P in keyof T]: T[P] extends NullOrDefinedOr<infer U>\n    ? U extends Array<infer V>\n      ? V extends Entity\n        ? Array<V | (DeepPartialOrNull<V> & CollectionFlags) | IdOf<V>> | null\n        : T[P]\n      : U extends Entity\n        ? U | (DeepPartialOrNull<U> & DeleteFlag) | IdOf<U> | null\n        : T[P]\n    : T[P];\n};\n\n/**\n * A utility function to do partial-update style updates.\n *\n * The difference between this and `Entity.setPartial` is that we accept `DeepPartialOrNull`\n * updates, similar to `createOrUpdateUnsafe`, instead of just a flat/shallow list of opts.\n */\nexport async function updatePartial<T extends Entity>(entity: T, input: DeepPartialOrNull<T>): Promise<void> {\n  if (Object.keys(input).length === 0) return;\n  const meta = getMetadata(entity);\n  const { em } = entity;\n  // Do a Promise.all so we .load() relations in parallel\n  await Promise.all(\n    Object.entries(input).map(async ([key, value]) => {\n      // setPartial ==> `undefined` is a noop\n      if (value === undefined) return;\n\n      // Watch for the `bookId` / `bookIds` aliases\n      const field = meta.allFields[key] || Object.values(meta.allFields).find((f) => f.fieldIdName === key);\n\n      if (!field) {\n        // Allow (ignore here) delete/remove flags that we assume the API layer (i.e. GraphQL) will have specifically\n        // allowed, i.e. this isn't the Rails form bug where users can POST in any random field they want.\n        const flagField = key === \"delete\" || key === \"remove\" || key === \"op\";\n        if (flagField) return;\n        // Look for non-field properties like a fullName setter\n        const prop = getProperties(meta)[key];\n        if (prop) {\n          setOpt(meta, entity, key, value);\n          return;\n        } else {\n          throw new Error(`Unknown field ${key}`);\n        }\n      }\n\n      // Don't use key b/c it might be the bookId alias\n      const name = field.fieldName;\n\n      if (field.kind === \"poly\" && value && !isEntity(value)) {\n        // Resolve non-entity poly values\n        if (isKey(value)) {\n          setOpt(meta, entity, name, await em.load(getConstructorFromTaggedId(value), value));\n        } else {\n          throw new Error(`Cannot use partial value for polymorphic field `);\n        }\n      } else if (field.kind === \"m2o\" && value && !isEntity(value)) {\n        // This is a many-to-one reference\n        if (isKey(value)) {\n          setOpt(meta, entity, name, await em.load(field.otherMetadata().cstr, value));\n        } else if (typeof value === \"object\" && value) {\n          let other: any;\n          if (\"id\" in value) {\n            // This is a many-to-one partial update to an existing entity (they passed an id)\n            other = await upsert(em, field.otherMetadata().cstr, value as any);\n          } else {\n            // This is a many-to-one partial w/o passing an id, i.e. `upsert(Author, { id: \"a:1\", publisher: { name: \"p1\" } })`\n            if (entity.isNewEntity) {\n              // If we're brand new, our child/other has to be brand new as well\n              other = await upsert(em, field.otherMetadata().cstr, value);\n            } else {\n              // the o2o upsert hash didn't have an id, so find-or-create it\n              other = await (entity as any)[name].load();\n              if (other) {\n                await updatePartial(other, value);\n              } else {\n                other = await upsert(em, field.otherMetadata().cstr, value);\n              }\n            }\n          }\n          const deleteMarker = getDeleteMarker(field, value);\n          if (deleteMarker) {\n            em.delete(other);\n            other = undefined;\n          }\n          setOpt(meta, entity, name, other);\n        }\n      } else if (field.kind === \"o2o\") {\n        // ^-- o2o always need loaded to be set, so don't fall through\n        if (value === null || isEntity(value)) {\n          await (entity as any)[name].load();\n          setOpt(meta, entity, name, value);\n        } else if (isKey(value)) {\n          const [, other] = await Promise.all([\n            (entity as any)[name].load(),\n            em.load(field.otherMetadata().cstr, value),\n          ]);\n          setOpt(meta, entity, name, other);\n        } else if (typeof value === \"object\" && isPlainObject(value)) {\n          const deleteMarker = getDeleteMarker(field, value);\n          // Always load the o2o so we can set it\n          const current = await (entity as any)[name].load();\n          let other: any;\n          if (\"id\" in value) {\n            // The o2o upsert hash was passed an id, so load it\n            other = await upsert(em, field.otherMetadata().cstr, value as any);\n          } else {\n            // the o2o upsert hash didn't have an id, so find-or-create it\n            other = current;\n            if (other) {\n              await updatePartial(other, value);\n            } else {\n              other = await upsert(em, field.otherMetadata().cstr, value);\n            }\n          }\n          if (deleteMarker) {\n            em.delete(other);\n          } else {\n            setOpt(meta, entity, name, other);\n          }\n        } else {\n          throw new Error(`Invalid value ${value}`);\n        }\n      } else if (field.kind === \"o2m\" || field.kind === \"m2m\") {\n        // Look for one-to-many/many-to-many partials\n        // `null` is handled later, and treated as `[]`, which needs the collection loaded\n\n        const values = toArray(value);\n        const otherMeta = field.otherMetadata();\n        const maybeSoftDelete = otherMeta.timestampFields?.deletedAt;\n\n        // Incremental handling. Detect incremental mode by a meaningful `op` value--`op: undefined`/`op: null`\n        // is the natural shape of an optional field and must behave like \"no op\", consistent with how\n        // updatePartial treats `value === undefined` and how delete/remove are read by truthiness.\n        const anyValueHasOp = values.some((v: any) => v && typeof v === \"object\" && !isEntity(v) && v.op != null);\n        if (anyValueHasOp) {\n          let anyValueMissingOp = false;\n          const current = (entity as any)[name];\n          // The `op` behavior means incremental and wants to do this:\n          await Promise.all(\n            values.map(async (value: any) => {\n              const [, , op] = getCollectionMarkers(field, value);\n              if (op === \"delete\") {\n                const other = await upsert(em, otherMeta.cstr, withOwnerField(field, value, entity));\n                // We need to check if this is a soft-deletable entity, and if so, we will soft-delete it.\n                if (maybeSoftDelete) {\n                  const serde = otherMeta.fields[maybeSoftDelete].serde as TimestampSerde<unknown>;\n                  const now = new Date();\n                  other.set({ [maybeSoftDelete]: serde.mapFromNow(now) });\n                } else {\n                  entity.em.delete(other);\n                }\n              } else if (op === \"remove\") {\n                const other = await upsert(em, otherMeta.cstr, withOwnerField(field, value, entity));\n                current.remove(other);\n              } else if (op === \"include\") {\n                const other = await upsert(em, otherMeta.cstr, withOwnerField(field, value, entity));\n                current.add(other);\n              } else if (op === \"incremental\") {\n                // This is a marker entry, just ignore it\n              } else {\n                // A child entered incremental mode (a sibling had a real op) but has no op of its own;\n                // never silently skip it--flag it so the guard below throws instead of dropping the row.\n                anyValueMissingOp = true;\n              }\n            }),\n          );\n          if (anyValueMissingOp) {\n            throw new Error(\"If any child sets the `op` key, then all children must have the `op` key.\");\n          }\n          return; // return from the op-based incremental behavior\n        }\n\n        // Otherwise we do exhaustive sets, will still looking for `delete`/`remove` markers\n        const others = await Promise.all(\n          values.map(async (value: any) => {\n            if (isEntity(value)) {\n              return value;\n            } else if (isKey(value)) {\n              return em.load(field.otherMetadata().cstr, value);\n            } else if (value === null || value === undefined) {\n              return undefined;\n            } else if (!isPlainObject(value)) {\n              throw new Error(`Invalid value ${value}`);\n            } else {\n              // Look for `delete: true/false` and `remove: true/false` markers\n              const [deleteMarker, removeMarker] = getCollectionMarkers(field, value);\n              const other = await upsert(em, field.otherMetadata().cstr, withOwnerField(field, value, entity));\n              if (deleteMarker) {\n                // if (maybeSoftDelete) {\n                //   const serde = meta.fields[maybeSoftDelete].serde as TimestampSerde<unknown>;\n                //   const now = new Date();\n                //   other.set({ [maybeSoftDelete]: serde.mapFromNow(now) });\n                // } else {\n                // }\n                em.delete(other);\n                return other;\n              } else if (removeMarker) {\n                return undefined;\n              } else {\n                return other;\n              }\n            }\n          }),\n        );\n\n        await (entity as any)[name].load();\n        setOpt(\n          meta,\n          entity,\n          name,\n          others.filter((v) => v !== undefined),\n        );\n      } else {\n        // If we get here, value should be a vanilla value that `setOpt` can handle/pass through as-is\n        setOpt(meta, entity, name, value);\n      }\n    }),\n  );\n}\n\n/**\n * A utility function to create-or-update/upsert entities coming from a partial-update style API.\n */\nexport async function upsert<T extends Entity>(\n  em: EntityManager<any, any, any>,\n  constructor: MaybeAbstractEntityConstructor<T>,\n  input: DeepPartialOrNull<T>,\n): Promise<T> {\n  const { id, ...rest } = input;\n  const entity =\n    id !== null && id !== undefined\n      ? await em.load(constructor, id)\n      : // Look for an existing entity we could resurrect\n        ((id === undefined ? await findExistingIfUniqueBy(em, constructor, rest) : undefined) ??\n        em.createPartial(asConcreteCstr(constructor), {}));\n  await updatePartial(entity, rest as any);\n  // Do this manually since we're not going through setOpts anymore\n  if (entity.isNewEntity) {\n    setSyncDefaults(entity);\n  }\n  return entity;\n}\n\n/**\n * Adds the o2m owner field so child resurrection can find rows whose `uniqueBy` includes their parent.\n * I.e. upserting `Author.books: [{ title: \"b1\" }]` should lookup `Book.uniqueBy = [[\"author\", \"title\"]]`.\n */\nfunction withOwnerField(field: OneToManyField | ManyToManyField, value: any, owner: Entity): any {\n  if (field.kind !== \"o2m\" || !isPlainObject(value)) return value;\n  const ownerField = field.otherFieldName;\n  const ownerFieldId = field.otherMetadata().allFields[ownerField]?.fieldIdName;\n  if (Object.hasOwn(value, ownerField) || (ownerFieldId && Object.hasOwn(value, ownerFieldId))) return value;\n  if (ownerFieldId && !owner.isNewEntity) return { ...value, [ownerFieldId]: owner.id };\n  return { ...value, [ownerField]: owner };\n}\n\nfunction getCollectionMarkers(field: OneToManyField | ManyToManyField, value: any): [any, any, any] {\n  const allowDelete = !field.otherMetadata().fields[\"delete\"];\n  const allowRemove = !field.otherMetadata().fields[\"remove\"];\n  const allowOp = !field.otherMetadata().fields[\"op\"];\n\n  // Look for `delete: true/false` and `remove: true/false` markers\n  const deleteMarker: any = allowDelete && value[\"delete\"];\n  const removeMarker: any = allowRemove && value[\"remove\"];\n  const opMarker: any = allowOp && value[\"op\"];\n\n  // Remove the markers, regardless of true/false, before recursing into upsert to avoid unknown fields\n  if (deleteMarker !== undefined) delete value.delete;\n  if (removeMarker !== undefined) delete value.remove;\n  if (opMarker !== undefined) delete value.op;\n\n  return [deleteMarker, removeMarker, opMarker];\n}\nfunction getDeleteMarker(field: OneToOneField | ManyToOneField, value: any): boolean {\n  const allowDelete = !field.otherMetadata().fields[\"delete\"];\n  const deleteMarker: any = allowDelete && value[\"delete\"];\n  if (deleteMarker !== undefined) delete value.delete;\n  return deleteMarker;\n}\n"],"mappings":"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"}