joist-core 2.3.0 → 2.4.0-next.2

package/build/relations/isCascadeDelete.js

@@ -0,0 +1,10 @@
+import { getBaseAndSelfMetas, getMetadata } from "../EntityMetadata.js";
+//#region src/relations/isCascadeDelete.ts
+/** Returns whether this relation is configured for cascade deletion on the entity or a base type. */
+function isCascadeDelete(relation, fieldName) {
+	return getBaseAndSelfMetas(getMetadata(relation.entity)).some((meta) => meta.config.__data.cascadeDeleteFields.includes(fieldName));
+}
+//#endregion
+export { isCascadeDelete };
+
+//# sourceMappingURL=isCascadeDelete.js.map

package/build/relations/isCascadeDelete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isCascadeDelete.js","names":[],"sources":["../../src/relations/isCascadeDelete.ts"],"sourcesContent":["import { getBaseAndSelfMetas, getMetadata } from \"src/EntityMetadata.ts\";\nimport type { AbstractRelationImpl } from \"src/relations/AbstractRelationImpl.ts\";\n\n// Keep metadata imports out of AbstractRelationImpl so query imports cannot evaluate a relation\n// subclass before its base class has initialized.\n/** Returns whether this relation is configured for cascade deletion on the entity or a base type. */\nexport function isCascadeDelete(relation: AbstractRelationImpl<any, any>, fieldName: string): boolean {\n  return getBaseAndSelfMetas(getMetadata(relation.entity)).some((meta) =>\n    meta.config.__data.cascadeDeleteFields.includes(fieldName as any),\n  );\n}\n"],"mappings":";;;AAMA,SAAgB,gBAAgB,UAA0C,WAA4B;CACpG,OAAO,oBAAoB,YAAY,SAAS,MAAM,CAAC,CAAC,CAAC,MAAM,SAC7D,KAAK,OAAO,OAAO,oBAAoB,SAAS,SAAgB,CAClE;AACF"}

package/build/resurrection.cjs

@@ -0,0 +1,74 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_fields = require("./fields.cjs");
+const require_EntityMetadata = require("./EntityMetadata.cjs");
+const require_EntityManager = require("./EntityManager.cjs");
+const require_Entity = require("./Entity.cjs");
+//#region src/resurrection.ts
+/** Clears the soft-delete marker so a matched entity is updated instead of recreated. */
+function resurrectIfSoftDeleted(entity) {
+	const deletedAt = require_EntityMetadata.getBaseMeta(require_EntityMetadata.getMetadata(entity)).timestampFields?.deletedAt;
+	if (deletedAt && entity.isSoftDeletedEntity) require_fields.setField(entity, deletedAt, void 0);
+}
+/**
+* Finds an existing entity when the input fully covers one configured `uniqueBy` candidate.
+* I.e. with `uniqueBy = [["email"], ["author", "title"]]`, `{ email }` or `{ authorId, title }` can lookup an existing row.
+*/
+async function findExistingIfUniqueBy(em, constructor, input) {
+	const meta = require_EntityMetadata.getMetadata(constructor);
+	const candidates = getUniqueByCandidates(meta, input);
+	for (const where of candidates) {
+		const inMemory = onlySoftDeleted(em.filterEntities(constructor, where));
+		if (inMemory.length > 1) throw new require_EntityManager.TooManyError(`Found more than one existing ${meta.type} with ${whereAsString(where)}`);
+		else if (inMemory.length === 1) {
+			resurrectIfSoftDeleted(inMemory[0]);
+			return inMemory[0];
+		}
+		if (Object.values(where).some((value) => require_Entity.isEntity(value) && value.isNewEntity)) continue;
+		const entities = onlySoftDeleted(await em.find(constructor, where, { softDeletes: "include" }));
+		if (entities.length > 1) throw new require_EntityManager.TooManyError(`Found more than one existing ${meta.type} with ${whereAsString(where)}`);
+		else if (entities.length === 1) {
+			resurrectIfSoftDeleted(entities[0]);
+			return entities[0];
+		}
+	}
+}
+/** Returns soft-deleted entities that are safe for upsert to resurrect. */
+function onlySoftDeleted(entities) {
+	return entities.filter((entity) => !entity.isDeletedEntity && entity.isSoftDeletedEntity);
+}
+/** Builds pushdown-safe where clauses from configured identity fields. */
+function getUniqueByCandidates(meta, input) {
+	return (meta.uniqueBy ?? require_EntityMetadata.getBaseMeta(meta).uniqueBy ?? []).flatMap((fields) => {
+		const where = {};
+		for (const fieldName of fields) {
+			const field = meta.allFields[fieldName];
+			if (!field || !isQueryableIdentityField(field)) return [];
+			const value = getIdentityValue(field, input);
+			if (value === void 0 || value === null) return [];
+			where[field.fieldName] = value;
+		}
+		return [where];
+	});
+}
+/** Returns the identity value from the input. */
+function getIdentityValue(field, input) {
+	if (Object.hasOwn(input, field.fieldName)) return normalizeIdentityValue(input[field.fieldName]);
+	if (field.fieldIdName && Object.hasOwn(input, field.fieldIdName)) return normalizeIdentityValue(input[field.fieldIdName]);
+}
+/** Returns raw ids from relation inputs, i.e. `{ publisher: { id: "p:1" } }` becomes `{ publisher: "p:1" }`. */
+function normalizeIdentityValue(value) {
+	if (!require_Entity.isEntity(value) && value && typeof value === "object" && Object.hasOwn(value, "id")) return value.id;
+	return value;
+}
+/** Returns true if Joist can push this identity field into a flat find clause. */
+function isQueryableIdentityField(field) {
+	return field.kind === "primitive" || field.kind === "enum" || field.kind === "m2o" || field.kind === "poly";
+}
+function whereAsString(where) {
+	return Object.entries(where).map(([key, value]) => `${key}=${value}`).join(", ");
+}
+//#endregion
+exports.findExistingIfUniqueBy = findExistingIfUniqueBy;
+exports.resurrectIfSoftDeleted = resurrectIfSoftDeleted;
+
+//# sourceMappingURL=resurrection.cjs.map

package/build/resurrection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resurrection.cjs","names":["getBaseMeta","getMetadata","TooManyError","isEntity"],"sources":["../src/resurrection.ts"],"sourcesContent":["import { type Entity, isEntity } from \"src/Entity.ts\";\nimport { type EntityManager, type MaybeAbstractEntityConstructor, TooManyError } from \"src/EntityManager.ts\";\nimport { type EntityMetadata, type Field, getBaseMeta, getMetadata } from \"src/EntityMetadata.ts\";\nimport { setField } from \"src/fields.ts\";\n\n/** Clears the soft-delete marker so a matched entity is updated instead of recreated. */\nexport function resurrectIfSoftDeleted(entity: Entity): void {\n  const deletedAt = getBaseMeta(getMetadata(entity)).timestampFields?.deletedAt;\n  if (deletedAt && (entity as any).isSoftDeletedEntity) {\n    setField(entity, deletedAt, undefined);\n  }\n}\n\n/**\n * Finds an existing entity when the input fully covers one configured `uniqueBy` candidate.\n * I.e. with `uniqueBy = [[\"email\"], [\"author\", \"title\"]]`, `{ email }` or `{ authorId, title }` can lookup an existing row.\n */\nexport async function findExistingIfUniqueBy<T extends Entity>(\n  em: EntityManager<any, any, any>,\n  constructor: MaybeAbstractEntityConstructor<T>,\n  input: object,\n): Promise<T | undefined> {\n  const meta = getMetadata(constructor);\n  const candidates = getUniqueByCandidates(meta, input);\n  for (const where of candidates) {\n    const inMemory = onlySoftDeleted(em.filterEntities(constructor as any, where as any) as T[]);\n    if (inMemory.length > 1) {\n      throw new TooManyError(`Found more than one existing ${meta.type} with ${whereAsString(where)}`);\n    } else if (inMemory.length === 1) {\n      resurrectIfSoftDeleted(inMemory[0]);\n      return inMemory[0];\n    }\n\n    // I.e. `{ publisher: newPublisherEntity }` cannot already exist in the database, so skip the `em.find`.\n    const hasNewEntityParam = Object.values(where).some((value) => isEntity(value) && value.isNewEntity);\n    if (hasNewEntityParam) continue;\n\n    const entities = onlySoftDeleted(await (em as any).find(constructor, where, { softDeletes: \"include\" })) as T[];\n    if (entities.length > 1) {\n      throw new TooManyError(`Found more than one existing ${meta.type} with ${whereAsString(where)}`);\n    } else if (entities.length === 1) {\n      resurrectIfSoftDeleted(entities[0]);\n      return entities[0];\n    }\n  }\n  return undefined;\n}\n\n/** Returns soft-deleted entities that are safe for upsert to resurrect. */\nfunction onlySoftDeleted<T extends Entity>(entities: T[]): T[] {\n  return entities.filter(\n    (entity) => !entity.isDeletedEntity && (entity as T & { isSoftDeletedEntity?: boolean }).isSoftDeletedEntity,\n  );\n}\n\n/** Builds pushdown-safe where clauses from configured identity fields. */\nfunction getUniqueByCandidates(meta: EntityMetadata, input: object): object[] {\n  return (meta.uniqueBy ?? getBaseMeta(meta).uniqueBy ?? []).flatMap((fields) => {\n    const where: Record<string, unknown> = {};\n    for (const fieldName of fields) {\n      const field = meta.allFields[fieldName];\n      if (!field || !isQueryableIdentityField(field)) return [];\n      const value = getIdentityValue(field, input);\n      if (value === undefined || value === null) return [];\n      where[field.fieldName] = value;\n    }\n    return [where];\n  });\n}\n\n/** Returns the identity value from the input. */\nfunction getIdentityValue(field: Field, input: object): unknown {\n  if (Object.hasOwn(input, field.fieldName)) {\n    return normalizeIdentityValue((input as Record<string, unknown>)[field.fieldName]);\n  }\n  if (field.fieldIdName && Object.hasOwn(input, field.fieldIdName)) {\n    return normalizeIdentityValue((input as Record<string, unknown>)[field.fieldIdName]);\n  }\n  return undefined;\n}\n\n/** Returns raw ids from relation inputs, i.e. `{ publisher: { id: \"p:1\" } }` becomes `{ publisher: \"p:1\" }`. */\nfunction normalizeIdentityValue(value: unknown): unknown {\n  if (!isEntity(value) && value && typeof value === \"object\" && Object.hasOwn(value, \"id\")) {\n    return (value as { id?: unknown }).id;\n  }\n  return value;\n}\n\n/** Returns true if Joist can push this identity field into a flat find clause. */\nfunction isQueryableIdentityField(field: Field): boolean {\n  return field.kind === \"primitive\" || field.kind === \"enum\" || field.kind === \"m2o\" || field.kind === \"poly\";\n}\n\nfunction whereAsString(where: object): string {\n  return Object.entries(where)\n    .map(([key, value]) => `${key}=${value}`)\n    .join(\", \");\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,uBAAuB,QAAsB;CAC3D,MAAM,YAAYA,uBAAAA,YAAYC,uBAAAA,YAAY,MAAM,CAAC,CAAC,CAAC,iBAAiB;CACpE,IAAI,aAAc,OAAe,qBAC/B,eAAA,SAAS,QAAQ,WAAW,KAAA,CAAS;AAEzC;;;;;AAMA,eAAsB,uBACpB,IACA,aACA,OACwB;CACxB,MAAM,OAAOA,uBAAAA,YAAY,WAAW;CACpC,MAAM,aAAa,sBAAsB,MAAM,KAAK;CACpD,KAAK,MAAM,SAAS,YAAY;EAC9B,MAAM,WAAW,gBAAgB,GAAG,eAAe,aAAoB,KAAY,CAAQ;EAC3F,IAAI,SAAS,SAAS,GACpB,MAAM,IAAIC,sBAAAA,aAAa,gCAAgC,KAAK,KAAK,QAAQ,cAAc,KAAK,GAAG;OAC1F,IAAI,SAAS,WAAW,GAAG;GAChC,uBAAuB,SAAS,EAAE;GAClC,OAAO,SAAS;EAClB;EAIA,IAD0B,OAAO,OAAO,KAAK,CAAC,CAAC,MAAM,UAAUC,eAAAA,SAAS,KAAK,KAAK,MAAM,WACpE,GAAG;EAEvB,MAAM,WAAW,gBAAgB,MAAO,GAAW,KAAK,aAAa,OAAO,EAAE,aAAa,UAAU,CAAC,CAAC;EACvG,IAAI,SAAS,SAAS,GACpB,MAAM,IAAID,sBAAAA,aAAa,gCAAgC,KAAK,KAAK,QAAQ,cAAc,KAAK,GAAG;OAC1F,IAAI,SAAS,WAAW,GAAG;GAChC,uBAAuB,SAAS,EAAE;GAClC,OAAO,SAAS;EAClB;CACF;AAEF;;AAGA,SAAS,gBAAkC,UAAoB;CAC7D,OAAO,SAAS,QACb,WAAW,CAAC,OAAO,mBAAoB,OAAiD,mBAC3F;AACF;;AAGA,SAAS,sBAAsB,MAAsB,OAAyB;CAC5E,QAAQ,KAAK,YAAYF,uBAAAA,YAAY,IAAI,CAAC,CAAC,YAAY,CAAC,EAAA,CAAG,SAAS,WAAW;EAC7E,MAAM,QAAiC,CAAC;EACxC,KAAK,MAAM,aAAa,QAAQ;GAC9B,MAAM,QAAQ,KAAK,UAAU;GAC7B,IAAI,CAAC,SAAS,CAAC,yBAAyB,KAAK,GAAG,OAAO,CAAC;GACxD,MAAM,QAAQ,iBAAiB,OAAO,KAAK;GAC3C,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO,CAAC;GACnD,MAAM,MAAM,aAAa;EAC3B;EACA,OAAO,CAAC,KAAK;CACf,CAAC;AACH;;AAGA,SAAS,iBAAiB,OAAc,OAAwB;CAC9D,IAAI,OAAO,OAAO,OAAO,MAAM,SAAS,GACtC,OAAO,uBAAwB,MAAkC,MAAM,UAAU;CAEnF,IAAI,MAAM,eAAe,OAAO,OAAO,OAAO,MAAM,WAAW,GAC7D,OAAO,uBAAwB,MAAkC,MAAM,YAAY;AAGvF;;AAGA,SAAS,uBAAuB,OAAyB;CACvD,IAAI,CAACG,eAAAA,SAAS,KAAK,KAAK,SAAS,OAAO,UAAU,YAAY,OAAO,OAAO,OAAO,IAAI,GACrF,OAAQ,MAA2B;CAErC,OAAO;AACT;;AAGA,SAAS,yBAAyB,OAAuB;CACvD,OAAO,MAAM,SAAS,eAAe,MAAM,SAAS,UAAU,MAAM,SAAS,SAAS,MAAM,SAAS;AACvG;AAEA,SAAS,cAAc,OAAuB;CAC5C,OAAO,OAAO,QAAQ,KAAK,CAAC,CACzB,KAAK,CAAC,KAAK,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,CACxC,KAAK,IAAI;AACd"}

package/build/resurrection.d.cts

@@ -0,0 +1,13 @@
+import { EntityManager, MaybeAbstractEntityConstructor } from "./EntityManager.cjs";
+import { Entity } from "./Entity.cjs";
+//#region src/resurrection.d.ts
+/** Clears the soft-delete marker so a matched entity is updated instead of recreated. */
+declare function resurrectIfSoftDeleted(entity: Entity): void;
+/**
+ * Finds an existing entity when the input fully covers one configured `uniqueBy` candidate.
+ * I.e. with `uniqueBy = [["email"], ["author", "title"]]`, `{ email }` or `{ authorId, title }` can lookup an existing row.
+ */
+declare function findExistingIfUniqueBy<T extends Entity>(em: EntityManager<any, any, any>, constructor: MaybeAbstractEntityConstructor<T>, input: object): Promise<T | undefined>;
+//#endregion
+export { findExistingIfUniqueBy, resurrectIfSoftDeleted };
+//# sourceMappingURL=resurrection.d.cts.map

package/build/resurrection.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resurrection.d.cts","names":[],"sources":["../src/resurrection.ts"],"mappings":";;;;iBAMgB,uBAAuB,QAAQ;;;;;iBAWzB,uBAAuB,UAAU,QACrD,IAAI,8BACJ,aAAa,+BAA+B,IAC5C,gBACC,QAAQ"}

package/build/resurrection.d.mts

@@ -0,0 +1,13 @@
+import { EntityManager, MaybeAbstractEntityConstructor } from "./EntityManager.mjs";
+import { Entity } from "./Entity.mjs";
+//#region src/resurrection.d.ts
+/** Clears the soft-delete marker so a matched entity is updated instead of recreated. */
+declare function resurrectIfSoftDeleted(entity: Entity): void;
+/**
+ * Finds an existing entity when the input fully covers one configured `uniqueBy` candidate.
+ * I.e. with `uniqueBy = [["email"], ["author", "title"]]`, `{ email }` or `{ authorId, title }` can lookup an existing row.
+ */
+declare function findExistingIfUniqueBy<T extends Entity>(em: EntityManager<any, any, any>, constructor: MaybeAbstractEntityConstructor<T>, input: object): Promise<T | undefined>;
+//#endregion
+export { findExistingIfUniqueBy, resurrectIfSoftDeleted };
+//# sourceMappingURL=resurrection.d.mts.map

package/build/resurrection.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resurrection.d.mts","names":[],"sources":["../src/resurrection.ts"],"mappings":";;;;iBAMgB,uBAAuB,QAAQ;;;;;iBAWzB,uBAAuB,UAAU,QACrD,IAAI,8BACJ,aAAa,+BAA+B,IAC5C,gBACC,QAAQ"}

package/build/resurrection.js

@@ -1,93 +1,72 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resurrectIfSoftDeleted = resurrectIfSoftDeleted;
-exports.findExistingIfUniqueBy = findExistingIfUniqueBy;
-const Entity_1 = require("./Entity");
-const EntityManager_1 = require("./EntityManager");
-const EntityMetadata_1 = require("./EntityMetadata");
-const fields_1 = require("./fields");
+import { setField } from "./fields.js";
+import { getBaseMeta, getMetadata } from "./EntityMetadata.js";
+import { TooManyError } from "./EntityManager.js";
+import { isEntity } from "./Entity.js";
+//#region src/resurrection.ts
 /** Clears the soft-delete marker so a matched entity is updated instead of recreated. */
 function resurrectIfSoftDeleted(entity) {
-    const deletedAt = (0, EntityMetadata_1.getBaseMeta)((0, EntityMetadata_1.getMetadata)(entity)).timestampFields?.deletedAt;
-    if (deletedAt && entity.isSoftDeletedEntity) {
-        (0, fields_1.setField)(entity, deletedAt, undefined);
-    }
+	const deletedAt = getBaseMeta(getMetadata(entity)).timestampFields?.deletedAt;
+	if (deletedAt && entity.isSoftDeletedEntity) setField(entity, deletedAt, void 0);
 }
 /**
- * Finds an existing entity when the input fully covers one configured `uniqueBy` candidate.
- * I.e. with `uniqueBy = [["email"], ["author", "title"]]`, `{ email }` or `{ authorId, title }` can lookup an existing row.
- */
+* Finds an existing entity when the input fully covers one configured `uniqueBy` candidate.
+* I.e. with `uniqueBy = [["email"], ["author", "title"]]`, `{ email }` or `{ authorId, title }` can lookup an existing row.
+*/
 async function findExistingIfUniqueBy(em, constructor, input) {
-    const meta = (0, EntityMetadata_1.getMetadata)(constructor);
-    const candidates = getUniqueByCandidates(meta, input);
-    for (const where of candidates) {
-        const inMemory = onlySoftDeleted(em.filterEntities(constructor, where));
-        if (inMemory.length > 1) {
-            throw new EntityManager_1.TooManyError(`Found more than one existing ${meta.type} with ${whereAsString(where)}`);
-        }
-        else if (inMemory.length === 1) {
-            resurrectIfSoftDeleted(inMemory[0]);
-            return inMemory[0];
-        }
-        // I.e. `{ publisher: newPublisherEntity }` cannot already exist in the database, so skip the `em.find`.
-        const hasNewEntityParam = Object.values(where).some((value) => (0, Entity_1.isEntity)(value) && value.isNewEntity);
-        if (hasNewEntityParam)
-            continue;
-        const entities = onlySoftDeleted(await em.find(constructor, where, { softDeletes: "include" }));
-        if (entities.length > 1) {
-            throw new EntityManager_1.TooManyError(`Found more than one existing ${meta.type} with ${whereAsString(where)}`);
-        }
-        else if (entities.length === 1) {
-            resurrectIfSoftDeleted(entities[0]);
-            return entities[0];
-        }
-    }
-    return undefined;
+	const meta = getMetadata(constructor);
+	const candidates = getUniqueByCandidates(meta, input);
+	for (const where of candidates) {
+		const inMemory = onlySoftDeleted(em.filterEntities(constructor, where));
+		if (inMemory.length > 1) throw new TooManyError(`Found more than one existing ${meta.type} with ${whereAsString(where)}`);
+		else if (inMemory.length === 1) {
+			resurrectIfSoftDeleted(inMemory[0]);
+			return inMemory[0];
+		}
+		if (Object.values(where).some((value) => isEntity(value) && value.isNewEntity)) continue;
+		const entities = onlySoftDeleted(await em.find(constructor, where, { softDeletes: "include" }));
+		if (entities.length > 1) throw new TooManyError(`Found more than one existing ${meta.type} with ${whereAsString(where)}`);
+		else if (entities.length === 1) {
+			resurrectIfSoftDeleted(entities[0]);
+			return entities[0];
+		}
+	}
 }
 /** Returns soft-deleted entities that are safe for upsert to resurrect. */
 function onlySoftDeleted(entities) {
-    return entities.filter((entity) => !entity.isDeletedEntity && entity.isSoftDeletedEntity);
+	return entities.filter((entity) => !entity.isDeletedEntity && entity.isSoftDeletedEntity);
 }
 /** Builds pushdown-safe where clauses from configured identity fields. */
 function getUniqueByCandidates(meta, input) {
-    return (meta.uniqueBy ?? (0, EntityMetadata_1.getBaseMeta)(meta).uniqueBy ?? []).flatMap((fields) => {
-        const where = {};
-        for (const fieldName of fields) {
-            const field = meta.allFields[fieldName];
-            if (!field || !isQueryableIdentityField(field))
-                return [];
-            const value = getIdentityValue(field, input);
-            if (value === undefined || value === null)
-                return [];
-            where[field.fieldName] = value;
-        }
-        return [where];
-    });
+	return (meta.uniqueBy ?? getBaseMeta(meta).uniqueBy ?? []).flatMap((fields) => {
+		const where = {};
+		for (const fieldName of fields) {
+			const field = meta.allFields[fieldName];
+			if (!field || !isQueryableIdentityField(field)) return [];
+			const value = getIdentityValue(field, input);
+			if (value === void 0 || value === null) return [];
+			where[field.fieldName] = value;
+		}
+		return [where];
+	});
 }
 /** Returns the identity value from the input. */
 function getIdentityValue(field, input) {
-    if (Object.hasOwn(input, field.fieldName)) {
-        return normalizeIdentityValue(input[field.fieldName]);
-    }
-    if (field.fieldIdName && Object.hasOwn(input, field.fieldIdName)) {
-        return normalizeIdentityValue(input[field.fieldIdName]);
-    }
-    return undefined;
+	if (Object.hasOwn(input, field.fieldName)) return normalizeIdentityValue(input[field.fieldName]);
+	if (field.fieldIdName && Object.hasOwn(input, field.fieldIdName)) return normalizeIdentityValue(input[field.fieldIdName]);
 }
 /** Returns raw ids from relation inputs, i.e. `{ publisher: { id: "p:1" } }` becomes `{ publisher: "p:1" }`. */
 function normalizeIdentityValue(value) {
-    if (!(0, Entity_1.isEntity)(value) && value && typeof value === "object" && Object.hasOwn(value, "id")) {
-        return value.id;
-    }
-    return value;
+	if (!isEntity(value) && value && typeof value === "object" && Object.hasOwn(value, "id")) return value.id;
+	return value;
 }
 /** Returns true if Joist can push this identity field into a flat find clause. */
 function isQueryableIdentityField(field) {
-    return field.kind === "primitive" || field.kind === "enum" || field.kind === "m2o" || field.kind === "poly";
+	return field.kind === "primitive" || field.kind === "enum" || field.kind === "m2o" || field.kind === "poly";
 }
 function whereAsString(where) {
-    return Object.entries(where)
-        .map(([key, value]) => `${key}=${value}`)
-        .join(", ");
+	return Object.entries(where).map(([key, value]) => `${key}=${value}`).join(", ");
 }
+//#endregion
+export { findExistingIfUniqueBy, resurrectIfSoftDeleted };
+
 //# sourceMappingURL=resurrection.js.map

package/build/resurrection.js.map

@@ -1 +1 @@
-{"version":3,"file":"resurrection.js","sourceRoot":"","sources":["../src/resurrection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resurrection.js","names":[],"sources":["../src/resurrection.ts"],"sourcesContent":["import { type Entity, isEntity } from \"src/Entity.ts\";\nimport { type EntityManager, type MaybeAbstractEntityConstructor, TooManyError } from \"src/EntityManager.ts\";\nimport { type EntityMetadata, type Field, getBaseMeta, getMetadata } from \"src/EntityMetadata.ts\";\nimport { setField } from \"src/fields.ts\";\n\n/** Clears the soft-delete marker so a matched entity is updated instead of recreated. */\nexport function resurrectIfSoftDeleted(entity: Entity): void {\n  const deletedAt = getBaseMeta(getMetadata(entity)).timestampFields?.deletedAt;\n  if (deletedAt && (entity as any).isSoftDeletedEntity) {\n    setField(entity, deletedAt, undefined);\n  }\n}\n\n/**\n * Finds an existing entity when the input fully covers one configured `uniqueBy` candidate.\n * I.e. with `uniqueBy = [[\"email\"], [\"author\", \"title\"]]`, `{ email }` or `{ authorId, title }` can lookup an existing row.\n */\nexport async function findExistingIfUniqueBy<T extends Entity>(\n  em: EntityManager<any, any, any>,\n  constructor: MaybeAbstractEntityConstructor<T>,\n  input: object,\n): Promise<T | undefined> {\n  const meta = getMetadata(constructor);\n  const candidates = getUniqueByCandidates(meta, input);\n  for (const where of candidates) {\n    const inMemory = onlySoftDeleted(em.filterEntities(constructor as any, where as any) as T[]);\n    if (inMemory.length > 1) {\n      throw new TooManyError(`Found more than one existing ${meta.type} with ${whereAsString(where)}`);\n    } else if (inMemory.length === 1) {\n      resurrectIfSoftDeleted(inMemory[0]);\n      return inMemory[0];\n    }\n\n    // I.e. `{ publisher: newPublisherEntity }` cannot already exist in the database, so skip the `em.find`.\n    const hasNewEntityParam = Object.values(where).some((value) => isEntity(value) && value.isNewEntity);\n    if (hasNewEntityParam) continue;\n\n    const entities = onlySoftDeleted(await (em as any).find(constructor, where, { softDeletes: \"include\" })) as T[];\n    if (entities.length > 1) {\n      throw new TooManyError(`Found more than one existing ${meta.type} with ${whereAsString(where)}`);\n    } else if (entities.length === 1) {\n      resurrectIfSoftDeleted(entities[0]);\n      return entities[0];\n    }\n  }\n  return undefined;\n}\n\n/** Returns soft-deleted entities that are safe for upsert to resurrect. */\nfunction onlySoftDeleted<T extends Entity>(entities: T[]): T[] {\n  return entities.filter(\n    (entity) => !entity.isDeletedEntity && (entity as T & { isSoftDeletedEntity?: boolean }).isSoftDeletedEntity,\n  );\n}\n\n/** Builds pushdown-safe where clauses from configured identity fields. */\nfunction getUniqueByCandidates(meta: EntityMetadata, input: object): object[] {\n  return (meta.uniqueBy ?? getBaseMeta(meta).uniqueBy ?? []).flatMap((fields) => {\n    const where: Record<string, unknown> = {};\n    for (const fieldName of fields) {\n      const field = meta.allFields[fieldName];\n      if (!field || !isQueryableIdentityField(field)) return [];\n      const value = getIdentityValue(field, input);\n      if (value === undefined || value === null) return [];\n      where[field.fieldName] = value;\n    }\n    return [where];\n  });\n}\n\n/** Returns the identity value from the input. */\nfunction getIdentityValue(field: Field, input: object): unknown {\n  if (Object.hasOwn(input, field.fieldName)) {\n    return normalizeIdentityValue((input as Record<string, unknown>)[field.fieldName]);\n  }\n  if (field.fieldIdName && Object.hasOwn(input, field.fieldIdName)) {\n    return normalizeIdentityValue((input as Record<string, unknown>)[field.fieldIdName]);\n  }\n  return undefined;\n}\n\n/** Returns raw ids from relation inputs, i.e. `{ publisher: { id: \"p:1\" } }` becomes `{ publisher: \"p:1\" }`. */\nfunction normalizeIdentityValue(value: unknown): unknown {\n  if (!isEntity(value) && value && typeof value === \"object\" && Object.hasOwn(value, \"id\")) {\n    return (value as { id?: unknown }).id;\n  }\n  return value;\n}\n\n/** Returns true if Joist can push this identity field into a flat find clause. */\nfunction isQueryableIdentityField(field: Field): boolean {\n  return field.kind === \"primitive\" || field.kind === \"enum\" || field.kind === \"m2o\" || field.kind === \"poly\";\n}\n\nfunction whereAsString(where: object): string {\n  return Object.entries(where)\n    .map(([key, value]) => `${key}=${value}`)\n    .join(\", \");\n}\n"],"mappings":";;;;;;AAMA,SAAgB,uBAAuB,QAAsB;CAC3D,MAAM,YAAY,YAAY,YAAY,MAAM,CAAC,CAAC,CAAC,iBAAiB;CACpE,IAAI,aAAc,OAAe,qBAC/B,SAAS,QAAQ,WAAW,KAAA,CAAS;AAEzC;;;;;AAMA,eAAsB,uBACpB,IACA,aACA,OACwB;CACxB,MAAM,OAAO,YAAY,WAAW;CACpC,MAAM,aAAa,sBAAsB,MAAM,KAAK;CACpD,KAAK,MAAM,SAAS,YAAY;EAC9B,MAAM,WAAW,gBAAgB,GAAG,eAAe,aAAoB,KAAY,CAAQ;EAC3F,IAAI,SAAS,SAAS,GACpB,MAAM,IAAI,aAAa,gCAAgC,KAAK,KAAK,QAAQ,cAAc,KAAK,GAAG;OAC1F,IAAI,SAAS,WAAW,GAAG;GAChC,uBAAuB,SAAS,EAAE;GAClC,OAAO,SAAS;EAClB;EAIA,IAD0B,OAAO,OAAO,KAAK,CAAC,CAAC,MAAM,UAAU,SAAS,KAAK,KAAK,MAAM,WACpE,GAAG;EAEvB,MAAM,WAAW,gBAAgB,MAAO,GAAW,KAAK,aAAa,OAAO,EAAE,aAAa,UAAU,CAAC,CAAC;EACvG,IAAI,SAAS,SAAS,GACpB,MAAM,IAAI,aAAa,gCAAgC,KAAK,KAAK,QAAQ,cAAc,KAAK,GAAG;OAC1F,IAAI,SAAS,WAAW,GAAG;GAChC,uBAAuB,SAAS,EAAE;GAClC,OAAO,SAAS;EAClB;CACF;AAEF;;AAGA,SAAS,gBAAkC,UAAoB;CAC7D,OAAO,SAAS,QACb,WAAW,CAAC,OAAO,mBAAoB,OAAiD,mBAC3F;AACF;;AAGA,SAAS,sBAAsB,MAAsB,OAAyB;CAC5E,QAAQ,KAAK,YAAY,YAAY,IAAI,CAAC,CAAC,YAAY,CAAC,EAAA,CAAG,SAAS,WAAW;EAC7E,MAAM,QAAiC,CAAC;EACxC,KAAK,MAAM,aAAa,QAAQ;GAC9B,MAAM,QAAQ,KAAK,UAAU;GAC7B,IAAI,CAAC,SAAS,CAAC,yBAAyB,KAAK,GAAG,OAAO,CAAC;GACxD,MAAM,QAAQ,iBAAiB,OAAO,KAAK;GAC3C,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO,CAAC;GACnD,MAAM,MAAM,aAAa;EAC3B;EACA,OAAO,CAAC,KAAK;CACf,CAAC;AACH;;AAGA,SAAS,iBAAiB,OAAc,OAAwB;CAC9D,IAAI,OAAO,OAAO,OAAO,MAAM,SAAS,GACtC,OAAO,uBAAwB,MAAkC,MAAM,UAAU;CAEnF,IAAI,MAAM,eAAe,OAAO,OAAO,OAAO,MAAM,WAAW,GAC7D,OAAO,uBAAwB,MAAkC,MAAM,YAAY;AAGvF;;AAGA,SAAS,uBAAuB,OAAyB;CACvD,IAAI,CAAC,SAAS,KAAK,KAAK,SAAS,OAAO,UAAU,YAAY,OAAO,OAAO,OAAO,IAAI,GACrF,OAAQ,MAA2B;CAErC,OAAO;AACT;;AAGA,SAAS,yBAAyB,OAAuB;CACvD,OAAO,MAAM,SAAS,eAAe,MAAM,SAAS,UAAU,MAAM,SAAS,SAAS,MAAM,SAAS;AACvG;AAEA,SAAS,cAAc,OAAuB;CAC5C,OAAO,OAAO,QAAQ,KAAK,CAAC,CACzB,KAAK,CAAC,KAAK,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,CACxC,KAAK,IAAI;AACd"}

package/build/rules.cjs

@@ -0,0 +1,227 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_fields = require("./fields.cjs");
+const require_relations_Reference = require("./relations/Reference.cjs");
+const require_relations_AsyncReactiveField = require("./relations/AsyncReactiveField.cjs");
+require("./relations/index.cjs");
+const require_utils = require("./utils.cjs");
+require("./typeMap.cjs");
+require("./changes.cjs");
+const require_EntityManager = require("./EntityManager.cjs");
+require("./Entity.cjs");
+//#region src/rules.ts
+let ValidationCode = /* @__PURE__ */ function(ValidationCode) {
+	ValidationCode["required"] = "required";
+	ValidationCode["cannotBeUpdated"] = "not-updatable";
+	ValidationCode["cannotBeChanged"] = "not-changeable";
+	ValidationCode["numeric"] = "not-numeric";
+	ValidationCode["minValue"] = "under-min";
+	ValidationCode["maxValue"] = "over-max";
+	return ValidationCode;
+}({});
+function errorMessage(errors) {
+	if (errors.length === 1) return `Validation error: ${errors[0].entity.toString()} ${errors[0].message}`;
+	else {
+		const message = [...require_utils.groupBy(errors, (e) => e.entity.toString()).entries()].map(([entityToString, errors]) => `${entityToString} ${errors.map((e) => e.message).join(", ")}`).join(", ");
+		return `Validation errors (${errors.length}): ${message}`;
+	}
+}
+var ValidationErrors = class extends Error {
+	errors;
+	toJSON;
+	constructor(messageOrErrors) {
+		super(typeof messageOrErrors === "string" ? messageOrErrors : errorMessage(messageOrErrors));
+		this.errors = typeof messageOrErrors === "string" ? [{ message: messageOrErrors }] : messageOrErrors;
+		this.toJSON = () => `ValidationErrors: ${this.message}`;
+	}
+};
+function ruleWithOpts(opts, fn) {
+	return (entity) => {
+		const result = fn(entity);
+		if (result === void 0) return;
+		const { unless, if: _if } = opts ?? {};
+		if (unless === void 0 && _if === void 0) return result;
+		const shouldRun = [unless ?? (() => false), _if ?? (() => true)].map((fn) => fn(entity));
+		return require_utils.maybePromiseThen(shouldRun.some((r) => r instanceof Promise) ? Promise.all(shouldRun) : shouldRun, ([unless, _if]) => !unless && _if ? result : void 0);
+	};
+}
+/**
+* Creates a validation rule for required fields.
+*
+* This is added automatically by codegen to entities based on FK not-nulls.
+*/
+function newRequiredRule(key, opts = {}) {
+	return ruleWithOpts(opts, (entity) => {
+		if (require_fields.getField(entity, key) === void 0) {
+			if (entity.isNewEntity && require_relations_AsyncReactiveField.isAsyncReactiveField(entity[key])) throw new Error(`AsyncReactiveField ${entity.constructor.name}.${key} must have a default value, either in the database or with config.setDefault (see the 4th step in https://joist-orm.io/modeling/reactive-fields/#async-reactive-fields.`);
+			return {
+				field: key,
+				code: "required",
+				message: `${key} is required`
+			};
+		}
+	});
+}
+/**
+* Like `newRequiredRule`, but for `lazy` columns (i.e. codegen only wires this up for `lazy` fields).
+*
+* On an already-persisted entity that hasn't loaded the column, we skip the check rather than force-load
+* (or falsely fail) a value that was required when the row was last saved. It still fires on create and
+* when the field is explicitly loaded-then-unset.
+*/
+function newRequiredLazyFieldRule(key, opts = {}) {
+	return ruleWithOpts(opts, (entity) => {
+		if (!entity.isNewEntity && !entity[key].isLoaded) return;
+		if (require_fields.getField(entity, key) === void 0) return {
+			field: key,
+			code: "required",
+			message: `${key} is required`
+		};
+	});
+}
+function cannotBeUpdated(field, optsOrUnless) {
+	const opts = typeof optsOrUnless === "function" ? { unless: optsOrUnless } : optsOrUnless ?? {};
+	const fn = ruleWithOpts(opts, (entity) => {
+		if (entity.changes[field].hasUpdated) {
+			const value = entity[field];
+			if (require_relations_Reference.isLoadedReference(value) && require_EntityManager.getEmInternalApi(entity.em).isMerging(value.get)) return;
+			return {
+				field,
+				code: "not-updatable",
+				message: `${field} cannot be updated`
+			};
+		}
+	});
+	return Object.assign(fn, {
+		field,
+		immutable: opts.unless === void 0 && opts.if === void 0
+	});
+}
+/**
+* Creates a validation rule that a field cannot be changed once set.
+*
+* If the optional `unless` function returns true, then the update is allowed.
+*/
+function cannotBeChanged(field, opts) {
+	return ruleWithOpts(opts, (entity) => {
+		const changes = entity.changes[field];
+		if (changes.kind === "m2m" || changes.kind === "o2m" || changes.kind === "m2mEnum") throw new Error("cannotBeChanged is only supported on primitive & m2o fields");
+		else if (changes.hasUpdated) {
+			if (changes.originalValue === void 0) return;
+			const value = require_fields.getField(entity, field);
+			if (require_EntityManager.getEmInternalApi(entity.em).isMerging(value)) return;
+			return {
+				field,
+				code: "not-changeable",
+				message: `${field} cannot be changed`
+			};
+		}
+	});
+}
+function isCannotBeUpdatedRule(rule) {
+	return "field" in rule && "immutable" in rule;
+}
+/** For STI, enforces subtype-specific relations/FKs at runtime. */
+function mustBeSubType(relationName, opts = {}) {
+	return ruleWithOpts(opts, (entity) => {
+		const m2o = entity[relationName];
+		const other = m2o.get;
+		const otherCstr = m2o.otherMeta.cstr;
+		if (other && !(other instanceof otherCstr)) return `${relationName} must be a ${otherCstr.name} not ${other}`;
+	});
+}
+/**
+* Creates a validation rule that a field value cannot be smaller than a
+* certain value.
+*
+* @param field The field to validate
+* @param minValue The inclusive minimum value. e.g 0 range is [0, Infinity]
+* @param opts Optional validation rule options that control when the rule should run:
+*   - unless: Function that returns true to skip validation
+*   - if: Function that returns true to run validation
+*
+* @example
+* // Age cannot be smaller than 0
+* config.addRule(minValueRule("age", 0));
+*/
+function minValueRule(field, minValue, opts = {}) {
+	return ruleWithOpts(opts, (entity) => {
+		const value = entity[field];
+		if (value === void 0 || value === null) return;
+		if (typeof value !== "number") return {
+			field,
+			code: "not-numeric",
+			message: `${field} must be a number`
+		};
+		if (value < minValue) return {
+			field,
+			code: "under-min",
+			message: `${field} must be greater than or equal to ${minValue}`
+		};
+	});
+}
+/**
+* Creates a validation rule that a field value cannot be greater than a
+* certain value.
+*
+* @param field The field to validate
+* @param maxValue The include maximum value. e.g 10 range is [-Infinity, 10]
+* @param opts Optional validation rule options that control when the rule should run:
+*   - unless: Function that returns true to skip validation
+*   - if: Function that returns true to run validation
+*
+* @example
+* // Age cannot be greater than 150
+* config.addRule(maxValueRule("age", 150));
+*/
+function maxValueRule(field, maxValue, opts = {}) {
+	return ruleWithOpts(opts, (entity) => {
+		const value = entity[field];
+		if (value === void 0 || value === null) return;
+		if (typeof value !== "number") return {
+			field,
+			code: "not-numeric",
+			message: `${field} must be a number`
+		};
+		if (value > maxValue) return {
+			field,
+			code: "over-max",
+			message: `${field} must be smaller than or equal to ${maxValue}`
+		};
+	});
+}
+/**
+* Creates a validation rule that a field value must be within a range of
+* certain values
+*
+* @param field The field to validate
+* @param minValue The inclusive minimum value. e.g  0 [0,   Infinity]
+* @param maxValue The include maximum value.   e.g 10 [-Infinity, 10]
+* @param opts Optional validation rule options that control when the rule should run:
+*   - unless: Function that returns true to skip validation
+*   - if: Function that returns true to run validation * @example
+*
+* // Age must be between 0 and 150
+* config.addRule(rangeValueRule("age", 0, 150));
+*/
+function rangeValueRule(field, minValue, maxValue, opts = {}) {
+	return ruleWithOpts(opts, (entity) => {
+		const minValueResult = minValueRule(field, minValue)(entity);
+		const maxValueResult = maxValueRule(field, maxValue)(entity);
+		if (minValueResult) return minValueResult;
+		if (maxValueResult) return maxValueResult;
+	});
+}
+//#endregion
+exports.ValidationCode = ValidationCode;
+exports.ValidationErrors = ValidationErrors;
+exports.cannotBeChanged = cannotBeChanged;
+exports.cannotBeUpdated = cannotBeUpdated;
+exports.isCannotBeUpdatedRule = isCannotBeUpdatedRule;
+exports.maxValueRule = maxValueRule;
+exports.minValueRule = minValueRule;
+exports.mustBeSubType = mustBeSubType;
+exports.newRequiredLazyFieldRule = newRequiredLazyFieldRule;
+exports.newRequiredRule = newRequiredRule;
+exports.rangeValueRule = rangeValueRule;
+
+//# sourceMappingURL=rules.cjs.map

package/build/rules.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.cjs","names":["groupBy","maybePromiseThen","getField","isAsyncReactiveField","isLoadedReference","getEmInternalApi"],"sources":["../src/rules.ts"],"sourcesContent":["import { type Changes, type EntityChanges } from \"src/changes.ts\";\nimport { type Entity } from \"src/Entity.ts\";\nimport { getEmInternalApi } from \"src/EntityManager.ts\";\nimport { getField } from \"src/fields.ts\";\nimport type { ReactiveHint } from \"src/reactivity/reactiveHints.ts\";\nimport { type ManyToOneReferenceImpl, isAsyncReactiveField, isLoadedReference } from \"src/relations/index.ts\";\nimport { type FieldsOf } from \"src/typeMap.ts\";\nimport { type MaybePromise, groupBy, maybePromiseThen } from \"src/utils.ts\";\n\nexport enum ValidationCode {\n  required = \"required\",\n  cannotBeUpdated = \"not-updatable\",\n  cannotBeChanged = \"not-changeable\",\n  numeric = \"not-numeric\",\n  minValue = \"under-min\",\n  maxValue = \"over-max\",\n}\n\n/**\n * The return type of `ValidationRule` lambdas.\n *\n * We're flexible and allow rules to return a variety of shapes, like just a string, string[], etc.\n *\n * Returning `undefined` means the rule passed.\n */\nexport type ValidationRuleResult = string | string[] | GenericError | GenericError[] | undefined | void;\n\n/** An entity validation rule. */\nexport type ValidationRule<T extends Entity> = (entity: T) => MaybePromise<ValidationRuleResult>;\n\n/** Internal metadata for an async/reactive validation rule. */\nexport type ValidationRuleInternal<T extends Entity> = {\n  name: string;\n  hint: ReactiveHint<T> | undefined;\n  fn: ValidationRule<T>;\n};\n\n/** A generic error which contains a message, and optional field/codes. */\nexport type GenericError = { message: string; field?: string; code?: string };\n\n/** Combines the GenericError with the `entity` that caused it. */\nexport type ValidationError = { entity: Entity } & GenericError;\n\nexport type ValidationRuleOptsFn<T extends Entity> = (entity: T) => MaybePromise<boolean>;\nexport type ValidationRuleOpts<T extends Entity> = {\n  unless?: ValidationRuleOptsFn<T>;\n  if?: ValidationRuleOptsFn<T>;\n};\n\nfunction errorMessage(errors: ValidationError[]): string {\n  if (errors.length === 1) {\n    return `Validation error: ${errors[0].entity.toString()} ${errors[0].message}`;\n  } else {\n    const message = [...groupBy(errors, (e) => e.entity.toString()).entries()]\n      .map(([entityToString, errors]) => `${entityToString} ${errors.map((e) => e.message).join(\", \")}`)\n      .join(\", \");\n    return `Validation errors (${errors.length}): ${message}`;\n  }\n}\n\nexport class ValidationErrors extends Error {\n  public errors: Array<GenericError | ValidationError>;\n  public readonly toJSON: () => string;\n  constructor(errors: ValidationError[]);\n  constructor(message: string);\n  constructor(messageOrErrors: ValidationError[] | string) {\n    super(typeof messageOrErrors === \"string\" ? messageOrErrors : errorMessage(messageOrErrors));\n    this.errors = typeof messageOrErrors === \"string\" ? [{ message: messageOrErrors }] : messageOrErrors;\n    // Jest clones without prototype, so explictly setting this as a property rather than a class method\n    // https://github.com/jestjs/jest/issues/11958\n    this.toJSON = () => `ValidationErrors: ${this.message}`;\n  }\n}\n\nfunction ruleWithOpts<T extends Entity>(\n  opts: ValidationRuleOpts<T> | undefined,\n  fn: (entity: T) => ValidationRuleResult,\n): ValidationRule<T> {\n  return (entity) => {\n    // Since all of our rules are sync, we run the rule first, then check if we should have run it second since this\n    // may be an async operation.  This way we can avoid running promises if we don't have to.\n    const result = fn(entity);\n    if (result === undefined) return;\n    const { unless, if: _if } = opts ?? {};\n    if (unless === undefined && _if === undefined) return result;\n    const shouldRun = [unless ?? (() => false), _if ?? (() => true)].map((fn) => fn(entity));\n    return maybePromiseThen(\n      shouldRun.some((r) => r instanceof Promise) ? Promise.all(shouldRun) : (shouldRun as boolean[]),\n      ([unless, _if]) => (!unless && _if ? result : undefined),\n    );\n  };\n}\n\n/**\n * The fields of `F` that have their own column, i.e. what a required rule can check.\n *\n * The filter is an allow-list (\"keep kinds primitive/enum/m2o/poly\"), not a deny-list (\"drop kind\n * o2o\"), because of how it degrades when `T` is generic/uninferred: `FieldsOf<T>` is then `never`,\n * and `never extends X` is true for any `X`, so an allow-list keeps every key (permissive, exactly\n * like the unfiltered `keyof FieldsOf<T>` before it) while a deny-list would drop every key and\n * break valid calls like `newRequiredRule(\"city\")`.\n */\ntype ColumnBackedFields<F> = {\n  [K in keyof F as F[K] extends { kind: \"primitive\" | \"enum\" | \"m2o\" | \"poly\" } ? K : never]: F[K];\n};\n\n/**\n * Creates a validation rule for required fields.\n *\n * This is added automatically by codegen to entities based on FK not-nulls.\n */\nexport function newRequiredRule<T extends Entity>(\n  key: keyof ColumnBackedFields<FieldsOf<T>> & string,\n  opts: ValidationRuleOpts<T> = {},\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity) => {\n    // Use getField so that we peer through relations\n    if (getField(entity, key) === undefined) {\n      // Sanity check for AsyncReactiveFields--this should be cheap to just always do; alternatively we could\n      // have a RQF-specific `rqfRequiredRule` so that other `newRequiredRule` users don't pay the cost of these\n      // two `if` checks`.\n      if (entity.isNewEntity && isAsyncReactiveField((entity as any)[key])) {\n        throw new Error(\n          `AsyncReactiveField ${entity.constructor.name}.${key} must have a default value, either in the database or with config.setDefault (see the 4th step in https://joist-orm.io/modeling/reactive-fields/#async-reactive-fields.`,\n        );\n      }\n      return { field: key, code: ValidationCode.required, message: `${key} is required` };\n    }\n  });\n}\n\n/**\n * Like `newRequiredRule`, but for `lazy` columns (i.e. codegen only wires this up for `lazy` fields).\n *\n * On an already-persisted entity that hasn't loaded the column, we skip the check rather than force-load\n * (or falsely fail) a value that was required when the row was last saved. It still fires on create and\n * when the field is explicitly loaded-then-unset.\n */\nexport function newRequiredLazyFieldRule<T extends Entity>(\n  key: keyof FieldsOf<T> & string,\n  opts: ValidationRuleOpts<T> = {},\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity) => {\n    if (!entity.isNewEntity && !(entity as any)[key].isLoaded) return;\n    if (getField(entity, key) === undefined) {\n      return { field: key, code: ValidationCode.required, message: `${key} is required` };\n    }\n  });\n}\n\n/**\n * Creates a validation rule that a field cannot be updated; it can only be set on creation.\n *\n * If the optional `unless` function returns true, then the update is allowed.\n */\nexport function cannotBeUpdated<T extends Entity, K extends keyof Changes<T> & string>(\n  field: K,\n  opts?: ValidationRuleOpts<T>,\n): CannotBeUpdatedRule<T>;\nexport function cannotBeUpdated<T extends Entity, K extends keyof Changes<T> & string>(\n  field: K,\n  unless?: ValidationRuleOptsFn<T>,\n): CannotBeUpdatedRule<T>;\nexport function cannotBeUpdated<T extends Entity, K extends keyof Changes<T> & string>(\n  field: K,\n  optsOrUnless?: ValidationRuleOpts<T> | ValidationRuleOptsFn<T>,\n): CannotBeUpdatedRule<T> {\n  const opts = typeof optsOrUnless === \"function\" ? { unless: optsOrUnless } : (optsOrUnless ?? {});\n  const fn = ruleWithOpts(opts, (entity: T) => {\n    // For now putting the `EntityChanges` cast here to avoid breaking cannotBeUpdated rules\n    // on base types, see Publisher.ts's `cannotBeUpdated(\"type\")` repro.\n    if ((entity as any as EntityChanges<T>).changes[field].hasUpdated) {\n      const value = (entity as any)[field];\n      // If we're being changed b/c of an em.merge, that is okay\n      if (isLoadedReference(value) && getEmInternalApi(entity.em).isMerging(value.get)) return;\n      return { field, code: ValidationCode.cannotBeUpdated, message: `${field} cannot be updated` };\n    }\n    return;\n  });\n  return Object.assign(fn, { field, immutable: opts.unless === undefined && opts.if === undefined });\n}\n\n/**\n * Creates a validation rule that a field cannot be changed once set.\n *\n * If the optional `unless` function returns true, then the update is allowed.\n */\nexport function cannotBeChanged<T extends Entity, K extends keyof Changes<T> & string>(\n  field: K,\n  opts?: ValidationRuleOpts<T>,\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity: T) => {\n    const changes = (entity as any as EntityChanges<T>).changes[field];\n    if (changes.kind === \"m2m\" || changes.kind === \"o2m\" || changes.kind === \"m2mEnum\") {\n      throw new Error(\"cannotBeChanged is only supported on primitive & m2o fields\");\n    } else if (changes.hasUpdated) {\n      const originalValue = changes.originalValue;\n      if (originalValue === undefined) return;\n      const value = getField(entity, field);\n      if (getEmInternalApi(entity.em).isMerging(value)) return;\n      return { field, code: ValidationCode.cannotBeChanged, message: `${field} cannot be changed` };\n    }\n    return;\n  });\n}\n\ntype CannotBeUpdatedRule<T extends Entity> = ValidationRule<T> & { field: string; immutable: boolean };\n\nexport function isCannotBeUpdatedRule(rule: Function): rule is CannotBeUpdatedRule<any> {\n  return \"field\" in rule && \"immutable\" in rule;\n}\n\n/** For STI, enforces subtype-specific relations/FKs at runtime. */\nexport function mustBeSubType<T extends Entity, K extends keyof Changes<T> & string>(\n  relationName: K,\n  opts: ValidationRuleOpts<T> = {},\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity) => {\n    const m2o = (entity as any)[relationName] as ManyToOneReferenceImpl<any, any, any>;\n    const other = m2o.get;\n    const otherCstr = m2o.otherMeta.cstr;\n    if (other && !(other instanceof otherCstr)) {\n      return `${relationName} must be a ${otherCstr.name} not ${other}`;\n    }\n  });\n}\n\n/**\n * Creates a validation rule that a field value cannot be smaller than a\n * certain value.\n *\n * @param field The field to validate\n * @param minValue The inclusive minimum value. e.g 0 range is [0, Infinity]\n * @param opts Optional validation rule options that control when the rule should run:\n *   - unless: Function that returns true to skip validation\n *   - if: Function that returns true to run validation\n *\n * @example\n * // Age cannot be smaller than 0\n * config.addRule(minValueRule(\"age\", 0));\n */\nexport function minValueRule<T extends Entity, K extends keyof T & string>(\n  field: K,\n  minValue: number,\n  opts: ValidationRuleOpts<T> = {},\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity) => {\n    const value = entity[field];\n    // Ignore undefined and null values. These should be handled by required rules\n    if (value === undefined || value === null) return;\n    // Show an error when the value type is not a number\n    if (typeof value !== \"number\") {\n      return { field, code: ValidationCode.numeric, message: `${field} must be a number` };\n    }\n    // Show an error when the value is smaller than the minimum value\n    if (value < minValue) {\n      return {\n        field,\n        code: ValidationCode.minValue,\n        message: `${field} must be greater than or equal to ${minValue}`,\n      };\n    }\n    return;\n  });\n}\n\n/**\n * Creates a validation rule that a field value cannot be greater than a\n * certain value.\n *\n * @param field The field to validate\n * @param maxValue The include maximum value. e.g 10 range is [-Infinity, 10]\n * @param opts Optional validation rule options that control when the rule should run:\n *   - unless: Function that returns true to skip validation\n *   - if: Function that returns true to run validation\n *\n * @example\n * // Age cannot be greater than 150\n * config.addRule(maxValueRule(\"age\", 150));\n */\nexport function maxValueRule<T extends Entity, K extends keyof T & string>(\n  field: K,\n  maxValue: number,\n  opts: ValidationRuleOpts<T> = {},\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity) => {\n    const value = entity[field];\n    // Ignore undefined and null values. These should be handled by required rules\n    if (value === undefined || value === null) return;\n    // Show an error when the value type is not a number\n    if (typeof value !== \"number\") {\n      return { field, code: ValidationCode.numeric, message: `${field} must be a number` };\n    }\n    // Show an error when the value is smaller than the minimum value\n    if (value > maxValue) {\n      return {\n        field,\n        code: ValidationCode.maxValue,\n        message: `${field} must be smaller than or equal to ${maxValue}`,\n      };\n    }\n    return;\n  });\n}\n\n/**\n * Creates a validation rule that a field value must be within a range of\n * certain values\n *\n * @param field The field to validate\n * @param minValue The inclusive minimum value. e.g  0 [0,   Infinity]\n * @param maxValue The include maximum value.   e.g 10 [-Infinity, 10]\n * @param opts Optional validation rule options that control when the rule should run:\n *   - unless: Function that returns true to skip validation\n *   - if: Function that returns true to run validation * @example\n *\n * // Age must be between 0 and 150\n * config.addRule(rangeValueRule(\"age\", 0, 150));\n */\nexport function rangeValueRule<T extends Entity, K extends keyof T & string>(\n  field: K,\n  minValue: number,\n  maxValue: number,\n  opts: ValidationRuleOpts<T> = {},\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity) => {\n    // Check min and max value rules.  Because these are called without opts, it should be safe to treat them as sync.\n    const minValueResult = minValueRule<T, K>(field, minValue)(entity) as ValidationRuleResult;\n    const maxValueResult = maxValueRule<T, K>(field, maxValue)(entity) as ValidationRuleResult;\n    // Return any errors or nothing\n    if (minValueResult) return minValueResult;\n    if (maxValueResult) return maxValueResult;\n    return;\n  });\n}\n"],"mappings":"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"}