joist-core 2.3.0 → 2.4.0

package/build/fields.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.cjs","names":["getEmInternalApi","getInstanceData","getMetadata","fail","cleanStringValue","isEntity","maybeResolveReferenceToId","maybeRequireTemporal"],"sources":["../src/fields.ts"],"sourcesContent":["import { getInstanceData } from \"src/BaseEntity.ts\";\nimport { type Entity, isEntity } from \"src/Entity.ts\";\nimport { getEmInternalApi } from \"src/EntityManager.ts\";\nimport { type Field, getMetadata } from \"src/EntityMetadata.ts\";\nimport { cleanStringValue, ensureNotDeleted, maybeResolveReferenceToId } from \"src/index.ts\";\nimport { maybeRequireTemporal } from \"src/serde/temporal.ts\";\nimport { fail } from \"src/utils.ts\";\n\n/**\n * Returns the current value of `fieldName`, this is an internal method that should\n * only be called by the code-generated getters.\n *\n * We skip any typing like `fieldName: keyof T` because this method should only be\n * called by trusted codegen anyway.\n */\nexport function getField(entity: Entity, fieldName: string): any {\n  const { em } = entity;\n  const api = getEmInternalApi(em);\n  api.pluginManager.beforeGetField(entity, fieldName);\n  // We may not have converted the database column value into domain values yet\n  const instanceData = getInstanceData(entity);\n  const { data } = instanceData;\n  if (fieldName in data) {\n    return data[fieldName];\n  } else {\n    if (!entity.isNewEntity) {\n      const field = getMetadata(entity).allFields[fieldName];\n      const serde = field?.serde ?? fail(`Missing serde for ${fieldName}`);\n      data[fieldName] = serde.fromRow(instanceData.rowData, instanceData.rowIndex);\n    }\n    return data[fieldName];\n  }\n}\n\n/** Returns whether `fieldName` is a field/column on `entity` that can be changed. */\nexport function isChangeableField(entity: Entity, fieldName: string): boolean {\n  return !!getMetadata(entity).allFields[fieldName]?.serde;\n}\n\n/** Returns whether `fieldName` has been set, even if it's undefined, on `entity`. */\nexport function isFieldSet(entity: Entity, fieldName: string): boolean {\n  const { data } = getInstanceData(entity);\n  if (fieldName in data) return true;\n  // Avoid calling `getField` on new entities because it populates the field as a side effect.\n  if (entity.isNewEntity) return false;\n  // We may not have converted the database column value into domain values yet.\n  getField(entity, fieldName);\n  return fieldName in data;\n}\n\n/**\n * Sets the current value of `fieldName`, this is an internal method that should\n * only be called by the code-generated setters.\n *\n * We skip any typing like `fieldName: keyof T` because this method should only be\n * called by trusted codegen anyway.\n *\n * Returns `true` if the value was changed, or `false` if it was a noop.\n */\nexport function setField(entity: Entity, fieldName: string, newValue: any): boolean {\n  ensureNotDeleted(entity, \"pending\");\n  const { em } = entity;\n  const api = getEmInternalApi(em);\n  const { rm, pluginManager, indexManager, fieldLogger, isLoadedCache } = api;\n\n  // If we're flushing, only allow writes from hooks\n  api.checkWritesAllowed();\n\n  // Tell any `#isLoaded` or `#value` caches that they might be stale\n  isLoadedCache.resetIsLoaded(entity, fieldName);\n\n  const instanceData = getInstanceData(entity);\n  const { data, originalData, flushedData } = instanceData;\n\n  // Do string sanitization\n  const field = getMetadata(entity).allFields[fieldName];\n  if (field.kind === \"primitive\" && field.type === \"string\" && field.sanitize !== false) {\n    newValue = cleanStringValue(newValue);\n  }\n\n  const currentValue = getField(entity, fieldName);\n  const isReference = field.kind === \"m2o\" || field.kind === \"poly\";\n  const currentEqualsNew = fieldValueEquals(field, currentValue, newValue);\n  // Remember every prior reference value so `followReverseHint` can rewalk both original and transient owners.\n  if (isReference && !currentEqualsNew) {\n    instanceData.rememberReferenceValue(fieldName, currentValue);\n  }\n\n  // If a `set` occurs during the AsyncReactiveField-loop, copy the last-flushed value to flushedData.\n  // Then our `pendingOperation` logic can tell \"do we need another micro-flush?\" separately\n  // from our public-facing changed fields logic.\n  if (flushedData) {\n    if (fieldName in flushedData) {\n      // We've already copied the last-micro-flush value into flushedData,\n      // are we changing back to that? If so, we won't need another micro-flush.\n      if (equalOrSameEntity(flushedData[fieldName], newValue)) {\n        delete flushedData[fieldName];\n      } else {\n        // Otherwise just let data[fieldName] get the even-newer value, and keep\n        // flushedData[fieldName] as the last-micro-flushed value.\n      }\n    } else if (!currentEqualsNew) {\n      // This is the 1st rqf-loop change for this field, so let data[fieldName]\n      // get the even newer value, but keep the last-micro-flushed value in flushedData.\n      flushedData[fieldName] = currentValue;\n    }\n  }\n\n  // \"Un-dirty\" our originalData if newValue is reverting to originalData\n  if (fieldName in originalData) {\n    if (fieldValueEquals(field, originalData[fieldName], newValue)) {\n      indexManager.maybeUpdateFieldIndex(entity, fieldName, currentValue, newValue);\n\n      pluginManager.beforeSetField(entity, fieldName, newValue);\n      data[fieldName] = newValue;\n      instanceData.markFieldClean(fieldName);\n\n      fieldLogger.logSet(entity, fieldName, newValue);\n      if (isReference && instanceData.getReferenceHistory(fieldName).length > 0) {\n        rm.queueDownstreamReactables(entity, fieldName);\n      } else {\n        // For normal reverts, the field is clean again, so any pending downstream work can be removed.\n        rm.dequeueDownstreamReactables(entity, fieldName);\n      }\n\n      return true;\n    }\n  }\n\n  // Push this logic into a field serde type abstraction?\n  if (currentEqualsNew) {\n    // If we're doing `entity.field = undefined`, we'll be equal, but mark ourselves as \"set\"\n    // so that defaults know to respect the intent of keeping this field undefined.\n    if (!(fieldName in data)) data[fieldName] = undefined;\n    return false;\n  }\n\n  // Only save the currentValue on the 1st change of this field\n  if (!(fieldName in originalData)) {\n    instanceData.markFieldDirty(fieldName, currentValue);\n  }\n  fieldLogger.logSet(entity, fieldName, newValue);\n  rm.queueDownstreamReactables(entity, fieldName);\n\n  indexManager.maybeUpdateFieldIndex(entity, fieldName, currentValue, newValue);\n\n  pluginManager.beforeSetField(entity, fieldName, newValue);\n  data[fieldName] = newValue;\n  return true;\n}\n\nfunction fieldValueEquals(field: Field, a: unknown, b: unknown): boolean {\n  // Primitive scalar sets are the common path, so avoid Date/Temporal/entity checks when both values cannot need them.\n  if (field.kind !== \"m2o\" && field.kind !== \"poly\" && isNonObjectValue(a) && isNonObjectValue(b)) return a === b;\n  return equalOrSameEntity(a, b);\n}\n\nfunction isNonObjectValue(value: unknown): boolean {\n  return value === null || typeof value !== \"object\";\n}\n\nfunction equalOrSameEntity(a: any, b: any): boolean {\n  return (\n    equal(a, b) ||\n    (Array.isArray(a) && Array.isArray(b) && equalArrays(a, b)) ||\n    // This is kind of gross, but make sure not to compare two both-new entities\n    (((isEntity(a) && !a.isNewEntity) || (isEntity(b) && !b.isNewEntity)) &&\n      maybeResolveReferenceToId(a) === maybeResolveReferenceToId(b))\n  );\n}\n\nexport function equalArrays(a: any[], b: any[]): boolean {\n  if (a.length !== b.length) return false;\n  return a.every((_: any, i) => equal(a[i], b[i]));\n}\n\nconst Temporal = maybeRequireTemporal()?.Temporal;\nexport function equal(a: any, b: any): boolean {\n  if (a === b) return true;\n  if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime();\n  if (Temporal) {\n    if (a instanceof Temporal.ZonedDateTime && b instanceof Temporal.ZonedDateTime) return a.equals(b);\n    if (a instanceof Temporal.PlainDateTime && b instanceof Temporal.PlainDateTime) return a.equals(b);\n    if (a instanceof Temporal.PlainDate && b instanceof Temporal.PlainDate) return a.equals(b);\n  }\n  return false;\n}\n"],"mappings":"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"}

package/build/fields.d.cts

@@ -0,0 +1,29 @@
+import { Entity } from "./Entity.cjs";
+//#region src/fields.d.ts
+/**
+ * Returns the current value of `fieldName`, this is an internal method that should
+ * only be called by the code-generated getters.
+ *
+ * We skip any typing like `fieldName: keyof T` because this method should only be
+ * called by trusted codegen anyway.
+ */
+declare function getField(entity: Entity, fieldName: string): any;
+/** Returns whether `fieldName` is a field/column on `entity` that can be changed. */
+declare function isChangeableField(entity: Entity, fieldName: string): boolean;
+/** Returns whether `fieldName` has been set, even if it's undefined, on `entity`. */
+declare function isFieldSet(entity: Entity, fieldName: string): boolean;
+/**
+ * Sets the current value of `fieldName`, this is an internal method that should
+ * only be called by the code-generated setters.
+ *
+ * We skip any typing like `fieldName: keyof T` because this method should only be
+ * called by trusted codegen anyway.
+ *
+ * Returns `true` if the value was changed, or `false` if it was a noop.
+ */
+declare function setField(entity: Entity, fieldName: string, newValue: any): boolean;
+declare function equalArrays(a: any[], b: any[]): boolean;
+declare function equal(a: any, b: any): boolean;
+//#endregion
+export { equal, equalArrays, getField, isChangeableField, isFieldSet, setField };
+//# sourceMappingURL=fields.d.cts.map

package/build/fields.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.cts","names":[],"sources":["../src/fields.ts"],"mappings":";;;;;;;;;iBAegB,SAAS,QAAQ,QAAQ;;iBAoBzB,kBAAkB,QAAQ,QAAQ;;iBAKlC,WAAW,QAAQ,QAAQ;;;;;;;;;;iBAmB3B,SAAS,QAAQ,QAAQ,mBAAmB;iBAgH5C,YAAY,UAAU;iBAMtB,MAAM,QAAQ"}

package/build/fields.d.mts

@@ -0,0 +1,29 @@
+import { Entity } from "./Entity.mjs";
+//#region src/fields.d.ts
+/**
+ * Returns the current value of `fieldName`, this is an internal method that should
+ * only be called by the code-generated getters.
+ *
+ * We skip any typing like `fieldName: keyof T` because this method should only be
+ * called by trusted codegen anyway.
+ */
+declare function getField(entity: Entity, fieldName: string): any;
+/** Returns whether `fieldName` is a field/column on `entity` that can be changed. */
+declare function isChangeableField(entity: Entity, fieldName: string): boolean;
+/** Returns whether `fieldName` has been set, even if it's undefined, on `entity`. */
+declare function isFieldSet(entity: Entity, fieldName: string): boolean;
+/**
+ * Sets the current value of `fieldName`, this is an internal method that should
+ * only be called by the code-generated setters.
+ *
+ * We skip any typing like `fieldName: keyof T` because this method should only be
+ * called by trusted codegen anyway.
+ *
+ * Returns `true` if the value was changed, or `false` if it was a noop.
+ */
+declare function setField(entity: Entity, fieldName: string, newValue: any): boolean;
+declare function equalArrays(a: any[], b: any[]): boolean;
+declare function equal(a: any, b: any): boolean;
+//#endregion
+export { equal, equalArrays, getField, isChangeableField, isFieldSet, setField };
+//# sourceMappingURL=fields.d.mts.map

package/build/fields.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.mts","names":[],"sources":["../src/fields.ts"],"mappings":";;;;;;;;;iBAegB,SAAS,QAAQ,QAAQ;;iBAoBzB,kBAAkB,QAAQ,QAAQ;;iBAKlC,WAAW,QAAQ,QAAQ;;;;;;;;;;iBAmB3B,SAAS,QAAQ,QAAQ,mBAAmB;iBAgH5C,YAAY,UAAU;iBAMtB,MAAM,QAAQ"}

package/build/fields.js

@@ -1,183 +1,121 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getField = getField;
-exports.isChangeableField = isChangeableField;
-exports.isFieldSet = isFieldSet;
-exports.setField = setField;
-exports.equalArrays = equalArrays;
-exports.equal = equal;
-const BaseEntity_1 = require("./BaseEntity");
-const Entity_1 = require("./Entity");
-const EntityManager_1 = require("./EntityManager");
-const EntityMetadata_1 = require("./EntityMetadata");
-const index_1 = require("./index");
-const temporal_1 = require("./temporal");
-const utils_1 = require("./utils");
+import { maybeRequireTemporal } from "./serde/temporal.js";
+import { maybeResolveReferenceToId } from "./keys.js";
+import { cleanStringValue, fail } from "./utils.js";
+import { getMetadata } from "./EntityMetadata.js";
+import { ensureNotDeleted } from "./index.js";
+import { getEmInternalApi } from "./EntityManager.js";
+import { isEntity } from "./Entity.js";
+import { getInstanceData } from "./BaseEntity.js";
+//#region src/fields.ts
 /**
- * Returns the current value of `fieldName`, this is an internal method that should
- * only be called by the code-generated getters.
- *
- * We skip any typing like `fieldName: keyof T` because this method should only be
- * called by trusted codegen anyway.
- */
+* Returns the current value of `fieldName`, this is an internal method that should
+* only be called by the code-generated getters.
+*
+* We skip any typing like `fieldName: keyof T` because this method should only be
+* called by trusted codegen anyway.
+*/
 function getField(entity, fieldName) {
-    const { em } = entity;
-    const api = (0, EntityManager_1.getEmInternalApi)(em);
-    api.pluginManager.beforeGetField(entity, fieldName);
-    // We may not have converted the database column value into domain values yet
-    const { data, row } = (0, BaseEntity_1.getInstanceData)(entity);
-    if (fieldName in data) {
-        return data[fieldName];
-    }
-    else {
-        if (!entity.isNewEntity) {
-            const serde = (0, EntityMetadata_1.getMetadata)(entity).allFields[fieldName]?.serde ?? (0, utils_1.fail)(`Missing serde for ${fieldName}`);
-            serde.setOnEntity(data, row);
-        }
-        return data[fieldName];
-    }
+	const { em } = entity;
+	getEmInternalApi(em).pluginManager.beforeGetField(entity, fieldName);
+	const instanceData = getInstanceData(entity);
+	const { data } = instanceData;
+	if (fieldName in data) return data[fieldName];
+	else {
+		if (!entity.isNewEntity) data[fieldName] = (getMetadata(entity).allFields[fieldName]?.serde ?? fail(`Missing serde for ${fieldName}`)).fromRow(instanceData.rowData, instanceData.rowIndex);
+		return data[fieldName];
+	}
 }
 /** Returns whether `fieldName` is a field/column on `entity` that can be changed. */
 function isChangeableField(entity, fieldName) {
-    return !!(0, EntityMetadata_1.getMetadata)(entity).allFields[fieldName]?.serde;
+	return !!getMetadata(entity).allFields[fieldName]?.serde;
 }
 /** Returns whether `fieldName` has been set, even if it's undefined, on `entity`. */
 function isFieldSet(entity, fieldName) {
-    const { data } = (0, BaseEntity_1.getInstanceData)(entity);
-    if (fieldName in data)
-        return true;
-    // Avoid calling `getField` on new entities because it populates the field as a side effect.
-    if (entity.isNewEntity)
-        return false;
-    // We may not have converted the database column value into domain values yet.
-    getField(entity, fieldName);
-    return fieldName in data;
+	const { data } = getInstanceData(entity);
+	if (fieldName in data) return true;
+	if (entity.isNewEntity) return false;
+	getField(entity, fieldName);
+	return fieldName in data;
 }
 /**
- * Sets the current value of `fieldName`, this is an internal method that should
- * only be called by the code-generated setters.
- *
- * We skip any typing like `fieldName: keyof T` because this method should only be
- * called by trusted codegen anyway.
- *
- * Returns `true` if the value was changed, or `false` if it was a noop.
- */
+* Sets the current value of `fieldName`, this is an internal method that should
+* only be called by the code-generated setters.
+*
+* We skip any typing like `fieldName: keyof T` because this method should only be
+* called by trusted codegen anyway.
+*
+* Returns `true` if the value was changed, or `false` if it was a noop.
+*/
 function setField(entity, fieldName, newValue) {
-    (0, index_1.ensureNotDeleted)(entity, "pending");
-    const { em } = entity;
-    const api = (0, EntityManager_1.getEmInternalApi)(em);
-    const { rm, pluginManager, indexManager, fieldLogger, isLoadedCache } = api;
-    // If we're flushing, only allow writes from hooks
-    api.checkWritesAllowed();
-    // Tell any `#isLoaded` or `#value` caches that they might be stale
-    isLoadedCache.resetIsLoaded(entity, fieldName);
-    const instanceData = (0, BaseEntity_1.getInstanceData)(entity);
-    const { data, originalData, flushedData } = instanceData;
-    // Do string sanitization
-    const field = (0, EntityMetadata_1.getMetadata)(entity).allFields[fieldName];
-    if (field.kind === "primitive" && field.type === "string" && field.sanitize !== false) {
-        newValue = (0, index_1.cleanStringValue)(newValue);
-    }
-    const currentValue = getField(entity, fieldName);
-    const isReference = field.kind === "m2o" || field.kind === "poly";
-    const currentEqualsNew = fieldValueEquals(field, currentValue, newValue);
-    // Remember every prior reference value so `followReverseHint` can rewalk both original and transient owners.
-    if (isReference && !currentEqualsNew) {
-        instanceData.rememberReferenceValue(fieldName, currentValue);
-    }
-    // If a `set` occurs during the AsyncReactiveField-loop, copy the last-flushed value to flushedData.
-    // Then our `pendingOperation` logic can tell "do we need another micro-flush?" separately
-    // from our public-facing changed fields logic.
-    if (flushedData) {
-        if (fieldName in flushedData) {
-            // We've already copied the last-micro-flush value into flushedData,
-            // are we changing back to that? If so, we won't need another micro-flush.
-            if (equalOrSameEntity(flushedData[fieldName], newValue)) {
-                delete flushedData[fieldName];
-            }
-            else {
-                // Otherwise just let data[fieldName] get the even-newer value, and keep
-                // flushedData[fieldName] as the last-micro-flushed value.
-            }
-        }
-        else if (!currentEqualsNew) {
-            // This is the 1st rqf-loop change for this field, so let data[fieldName]
-            // get the even newer value, but keep the last-micro-flushed value in flushedData.
-            flushedData[fieldName] = currentValue;
-        }
-    }
-    // "Un-dirty" our originalData if newValue is reverting to originalData
-    if (fieldName in originalData) {
-        if (fieldValueEquals(field, originalData[fieldName], newValue)) {
-            indexManager.maybeUpdateFieldIndex(entity, fieldName, currentValue, newValue);
-            pluginManager.beforeSetField(entity, fieldName, newValue);
-            data[fieldName] = newValue;
-            instanceData.markFieldClean(fieldName);
-            fieldLogger?.logSet(entity, fieldName, newValue);
-            if (isReference && instanceData.getReferenceHistory(fieldName).length > 0) {
-                rm.queueDownstreamReactables(entity, fieldName);
-            }
-            else {
-                // For normal reverts, the field is clean again, so any pending downstream work can be removed.
-                rm.dequeueDownstreamReactables(entity, fieldName);
-            }
-            return true;
-        }
-    }
-    // Push this logic into a field serde type abstraction?
-    if (currentEqualsNew) {
-        // If we're doing `entity.field = undefined`, we'll be equal, but mark ourselves as "set"
-        // so that defaults know to respect the intent of keeping this field undefined.
-        if (!(fieldName in data))
-            data[fieldName] = undefined;
-        return false;
-    }
-    // Only save the currentValue on the 1st change of this field
-    if (!(fieldName in originalData)) {
-        instanceData.markFieldDirty(fieldName, currentValue);
-    }
-    fieldLogger?.logSet(entity, fieldName, newValue);
-    rm.queueDownstreamReactables(entity, fieldName);
-    indexManager.maybeUpdateFieldIndex(entity, fieldName, currentValue, newValue);
-    pluginManager.beforeSetField(entity, fieldName, newValue);
-    data[fieldName] = newValue;
-    return true;
+	ensureNotDeleted(entity, "pending");
+	const { em } = entity;
+	const api = getEmInternalApi(em);
+	const { rm, pluginManager, indexManager, fieldLogger, isLoadedCache } = api;
+	api.checkWritesAllowed();
+	isLoadedCache.resetIsLoaded(entity, fieldName);
+	const instanceData = getInstanceData(entity);
+	const { data, originalData, flushedData } = instanceData;
+	const field = getMetadata(entity).allFields[fieldName];
+	if (field.kind === "primitive" && field.type === "string" && field.sanitize !== false) newValue = cleanStringValue(newValue);
+	const currentValue = getField(entity, fieldName);
+	const isReference = field.kind === "m2o" || field.kind === "poly";
+	const currentEqualsNew = fieldValueEquals(field, currentValue, newValue);
+	if (isReference && !currentEqualsNew) instanceData.rememberReferenceValue(fieldName, currentValue);
+	if (flushedData) {
+		if (fieldName in flushedData) {
+			if (equalOrSameEntity(flushedData[fieldName], newValue)) delete flushedData[fieldName];
+		} else if (!currentEqualsNew) flushedData[fieldName] = currentValue;
+	}
+	if (fieldName in originalData) {
+		if (fieldValueEquals(field, originalData[fieldName], newValue)) {
+			indexManager.maybeUpdateFieldIndex(entity, fieldName, currentValue, newValue);
+			pluginManager.beforeSetField(entity, fieldName, newValue);
+			data[fieldName] = newValue;
+			instanceData.markFieldClean(fieldName);
+			fieldLogger.logSet(entity, fieldName, newValue);
+			if (isReference && instanceData.getReferenceHistory(fieldName).length > 0) rm.queueDownstreamReactables(entity, fieldName);
+			else rm.dequeueDownstreamReactables(entity, fieldName);
+			return true;
+		}
+	}
+	if (currentEqualsNew) {
+		if (!(fieldName in data)) data[fieldName] = void 0;
+		return false;
+	}
+	if (!(fieldName in originalData)) instanceData.markFieldDirty(fieldName, currentValue);
+	fieldLogger.logSet(entity, fieldName, newValue);
+	rm.queueDownstreamReactables(entity, fieldName);
+	indexManager.maybeUpdateFieldIndex(entity, fieldName, currentValue, newValue);
+	pluginManager.beforeSetField(entity, fieldName, newValue);
+	data[fieldName] = newValue;
+	return true;
 }
 function fieldValueEquals(field, a, b) {
-    // Primitive scalar sets are the common path, so avoid Date/Temporal/entity checks when both values cannot need them.
-    if (field.kind !== "m2o" && field.kind !== "poly" && isNonObjectValue(a) && isNonObjectValue(b))
-        return a === b;
-    return equalOrSameEntity(a, b);
+	if (field.kind !== "m2o" && field.kind !== "poly" && isNonObjectValue(a) && isNonObjectValue(b)) return a === b;
+	return equalOrSameEntity(a, b);
 }
 function isNonObjectValue(value) {
-    return value === null || typeof value !== "object";
+	return value === null || typeof value !== "object";
 }
 function equalOrSameEntity(a, b) {
-    return (equal(a, b) ||
-        (Array.isArray(a) && Array.isArray(b) && equalArrays(a, b)) ||
-        // This is kind of gross, but make sure not to compare two both-new entities
-        ((((0, Entity_1.isEntity)(a) && !a.isNewEntity) || ((0, Entity_1.isEntity)(b) && !b.isNewEntity)) &&
-            (0, index_1.maybeResolveReferenceToId)(a) === (0, index_1.maybeResolveReferenceToId)(b)));
+	return equal(a, b) || Array.isArray(a) && Array.isArray(b) && equalArrays(a, b) || (isEntity(a) && !a.isNewEntity || isEntity(b) && !b.isNewEntity) && maybeResolveReferenceToId(a) === maybeResolveReferenceToId(b);
 }
 function equalArrays(a, b) {
-    if (a.length !== b.length)
-        return false;
-    return a.every((_, i) => equal(a[i], b[i]));
+	if (a.length !== b.length) return false;
+	return a.every((_, i) => equal(a[i], b[i]));
 }
-const Temporal = (0, temporal_1.maybeRequireTemporal)()?.Temporal;
+const Temporal = maybeRequireTemporal()?.Temporal;
 function equal(a, b) {
-    if (a === b)
-        return true;
-    if (a instanceof Date && b instanceof Date)
-        return a.getTime() === b.getTime();
-    if (Temporal) {
-        if (a instanceof Temporal.ZonedDateTime && b instanceof Temporal.ZonedDateTime)
-            return a.equals(b);
-        if (a instanceof Temporal.PlainDateTime && b instanceof Temporal.PlainDateTime)
-            return a.equals(b);
-        if (a instanceof Temporal.PlainDate && b instanceof Temporal.PlainDate)
-            return a.equals(b);
-    }
-    return false;
+	if (a === b) return true;
+	if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime();
+	if (Temporal) {
+		if (a instanceof Temporal.ZonedDateTime && b instanceof Temporal.ZonedDateTime) return a.equals(b);
+		if (a instanceof Temporal.PlainDateTime && b instanceof Temporal.PlainDateTime) return a.equals(b);
+		if (a instanceof Temporal.PlainDate && b instanceof Temporal.PlainDate) return a.equals(b);
+	}
+	return false;
 }
+//#endregion
+export { equal, equalArrays, getField, isChangeableField, isFieldSet, setField };
+
 //# sourceMappingURL=fields.js.map

package/build/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fields.js","names":[],"sources":["../src/fields.ts"],"sourcesContent":["import { getInstanceData } from \"src/BaseEntity.ts\";\nimport { type Entity, isEntity } from \"src/Entity.ts\";\nimport { getEmInternalApi } from \"src/EntityManager.ts\";\nimport { type Field, getMetadata } from \"src/EntityMetadata.ts\";\nimport { cleanStringValue, ensureNotDeleted, maybeResolveReferenceToId } from \"src/index.ts\";\nimport { maybeRequireTemporal } from \"src/serde/temporal.ts\";\nimport { fail } from \"src/utils.ts\";\n\n/**\n * Returns the current value of `fieldName`, this is an internal method that should\n * only be called by the code-generated getters.\n *\n * We skip any typing like `fieldName: keyof T` because this method should only be\n * called by trusted codegen anyway.\n */\nexport function getField(entity: Entity, fieldName: string): any {\n  const { em } = entity;\n  const api = getEmInternalApi(em);\n  api.pluginManager.beforeGetField(entity, fieldName);\n  // We may not have converted the database column value into domain values yet\n  const instanceData = getInstanceData(entity);\n  const { data } = instanceData;\n  if (fieldName in data) {\n    return data[fieldName];\n  } else {\n    if (!entity.isNewEntity) {\n      const field = getMetadata(entity).allFields[fieldName];\n      const serde = field?.serde ?? fail(`Missing serde for ${fieldName}`);\n      data[fieldName] = serde.fromRow(instanceData.rowData, instanceData.rowIndex);\n    }\n    return data[fieldName];\n  }\n}\n\n/** Returns whether `fieldName` is a field/column on `entity` that can be changed. */\nexport function isChangeableField(entity: Entity, fieldName: string): boolean {\n  return !!getMetadata(entity).allFields[fieldName]?.serde;\n}\n\n/** Returns whether `fieldName` has been set, even if it's undefined, on `entity`. */\nexport function isFieldSet(entity: Entity, fieldName: string): boolean {\n  const { data } = getInstanceData(entity);\n  if (fieldName in data) return true;\n  // Avoid calling `getField` on new entities because it populates the field as a side effect.\n  if (entity.isNewEntity) return false;\n  // We may not have converted the database column value into domain values yet.\n  getField(entity, fieldName);\n  return fieldName in data;\n}\n\n/**\n * Sets the current value of `fieldName`, this is an internal method that should\n * only be called by the code-generated setters.\n *\n * We skip any typing like `fieldName: keyof T` because this method should only be\n * called by trusted codegen anyway.\n *\n * Returns `true` if the value was changed, or `false` if it was a noop.\n */\nexport function setField(entity: Entity, fieldName: string, newValue: any): boolean {\n  ensureNotDeleted(entity, \"pending\");\n  const { em } = entity;\n  const api = getEmInternalApi(em);\n  const { rm, pluginManager, indexManager, fieldLogger, isLoadedCache } = api;\n\n  // If we're flushing, only allow writes from hooks\n  api.checkWritesAllowed();\n\n  // Tell any `#isLoaded` or `#value` caches that they might be stale\n  isLoadedCache.resetIsLoaded(entity, fieldName);\n\n  const instanceData = getInstanceData(entity);\n  const { data, originalData, flushedData } = instanceData;\n\n  // Do string sanitization\n  const field = getMetadata(entity).allFields[fieldName];\n  if (field.kind === \"primitive\" && field.type === \"string\" && field.sanitize !== false) {\n    newValue = cleanStringValue(newValue);\n  }\n\n  const currentValue = getField(entity, fieldName);\n  const isReference = field.kind === \"m2o\" || field.kind === \"poly\";\n  const currentEqualsNew = fieldValueEquals(field, currentValue, newValue);\n  // Remember every prior reference value so `followReverseHint` can rewalk both original and transient owners.\n  if (isReference && !currentEqualsNew) {\n    instanceData.rememberReferenceValue(fieldName, currentValue);\n  }\n\n  // If a `set` occurs during the AsyncReactiveField-loop, copy the last-flushed value to flushedData.\n  // Then our `pendingOperation` logic can tell \"do we need another micro-flush?\" separately\n  // from our public-facing changed fields logic.\n  if (flushedData) {\n    if (fieldName in flushedData) {\n      // We've already copied the last-micro-flush value into flushedData,\n      // are we changing back to that? If so, we won't need another micro-flush.\n      if (equalOrSameEntity(flushedData[fieldName], newValue)) {\n        delete flushedData[fieldName];\n      } else {\n        // Otherwise just let data[fieldName] get the even-newer value, and keep\n        // flushedData[fieldName] as the last-micro-flushed value.\n      }\n    } else if (!currentEqualsNew) {\n      // This is the 1st rqf-loop change for this field, so let data[fieldName]\n      // get the even newer value, but keep the last-micro-flushed value in flushedData.\n      flushedData[fieldName] = currentValue;\n    }\n  }\n\n  // \"Un-dirty\" our originalData if newValue is reverting to originalData\n  if (fieldName in originalData) {\n    if (fieldValueEquals(field, originalData[fieldName], newValue)) {\n      indexManager.maybeUpdateFieldIndex(entity, fieldName, currentValue, newValue);\n\n      pluginManager.beforeSetField(entity, fieldName, newValue);\n      data[fieldName] = newValue;\n      instanceData.markFieldClean(fieldName);\n\n      fieldLogger.logSet(entity, fieldName, newValue);\n      if (isReference && instanceData.getReferenceHistory(fieldName).length > 0) {\n        rm.queueDownstreamReactables(entity, fieldName);\n      } else {\n        // For normal reverts, the field is clean again, so any pending downstream work can be removed.\n        rm.dequeueDownstreamReactables(entity, fieldName);\n      }\n\n      return true;\n    }\n  }\n\n  // Push this logic into a field serde type abstraction?\n  if (currentEqualsNew) {\n    // If we're doing `entity.field = undefined`, we'll be equal, but mark ourselves as \"set\"\n    // so that defaults know to respect the intent of keeping this field undefined.\n    if (!(fieldName in data)) data[fieldName] = undefined;\n    return false;\n  }\n\n  // Only save the currentValue on the 1st change of this field\n  if (!(fieldName in originalData)) {\n    instanceData.markFieldDirty(fieldName, currentValue);\n  }\n  fieldLogger.logSet(entity, fieldName, newValue);\n  rm.queueDownstreamReactables(entity, fieldName);\n\n  indexManager.maybeUpdateFieldIndex(entity, fieldName, currentValue, newValue);\n\n  pluginManager.beforeSetField(entity, fieldName, newValue);\n  data[fieldName] = newValue;\n  return true;\n}\n\nfunction fieldValueEquals(field: Field, a: unknown, b: unknown): boolean {\n  // Primitive scalar sets are the common path, so avoid Date/Temporal/entity checks when both values cannot need them.\n  if (field.kind !== \"m2o\" && field.kind !== \"poly\" && isNonObjectValue(a) && isNonObjectValue(b)) return a === b;\n  return equalOrSameEntity(a, b);\n}\n\nfunction isNonObjectValue(value: unknown): boolean {\n  return value === null || typeof value !== \"object\";\n}\n\nfunction equalOrSameEntity(a: any, b: any): boolean {\n  return (\n    equal(a, b) ||\n    (Array.isArray(a) && Array.isArray(b) && equalArrays(a, b)) ||\n    // This is kind of gross, but make sure not to compare two both-new entities\n    (((isEntity(a) && !a.isNewEntity) || (isEntity(b) && !b.isNewEntity)) &&\n      maybeResolveReferenceToId(a) === maybeResolveReferenceToId(b))\n  );\n}\n\nexport function equalArrays(a: any[], b: any[]): boolean {\n  if (a.length !== b.length) return false;\n  return a.every((_: any, i) => equal(a[i], b[i]));\n}\n\nconst Temporal = maybeRequireTemporal()?.Temporal;\nexport function equal(a: any, b: any): boolean {\n  if (a === b) return true;\n  if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime();\n  if (Temporal) {\n    if (a instanceof Temporal.ZonedDateTime && b instanceof Temporal.ZonedDateTime) return a.equals(b);\n    if (a instanceof Temporal.PlainDateTime && b instanceof Temporal.PlainDateTime) return a.equals(b);\n    if (a instanceof Temporal.PlainDate && b instanceof Temporal.PlainDate) return a.equals(b);\n  }\n  return false;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,SAAgB,SAAS,QAAgB,WAAwB;CAC/D,MAAM,EAAE,OAAO;CAEf,iBAD6B,EAC3B,CAAC,CAAC,cAAc,eAAe,QAAQ,SAAS;CAElD,MAAM,eAAe,gBAAgB,MAAM;CAC3C,MAAM,EAAE,SAAS;CACjB,IAAI,aAAa,MACf,OAAO,KAAK;MACP;EACL,IAAI,CAAC,OAAO,aAGV,KAAK,cAFS,YAAY,MAAM,CAAC,CAAC,UAAU,UACzB,EAAE,SAAS,KAAK,qBAAqB,WAAW,EAAA,CAC3C,QAAQ,aAAa,SAAS,aAAa,QAAQ;EAE7E,OAAO,KAAK;CACd;AACF;;AAGA,SAAgB,kBAAkB,QAAgB,WAA4B;CAC5E,OAAO,CAAC,CAAC,YAAY,MAAM,CAAC,CAAC,UAAU,UAAU,EAAE;AACrD;;AAGA,SAAgB,WAAW,QAAgB,WAA4B;CACrE,MAAM,EAAE,SAAS,gBAAgB,MAAM;CACvC,IAAI,aAAa,MAAM,OAAO;CAE9B,IAAI,OAAO,aAAa,OAAO;CAE/B,SAAS,QAAQ,SAAS;CAC1B,OAAO,aAAa;AACtB;;;;;;;;;;AAWA,SAAgB,SAAS,QAAgB,WAAmB,UAAwB;CAClF,iBAAiB,QAAQ,SAAS;CAClC,MAAM,EAAE,OAAO;CACf,MAAM,MAAM,iBAAiB,EAAE;CAC/B,MAAM,EAAE,IAAI,eAAe,cAAc,aAAa,kBAAkB;CAGxE,IAAI,mBAAmB;CAGvB,cAAc,cAAc,QAAQ,SAAS;CAE7C,MAAM,eAAe,gBAAgB,MAAM;CAC3C,MAAM,EAAE,MAAM,cAAc,gBAAgB;CAG5C,MAAM,QAAQ,YAAY,MAAM,CAAC,CAAC,UAAU;CAC5C,IAAI,MAAM,SAAS,eAAe,MAAM,SAAS,YAAY,MAAM,aAAa,OAC9E,WAAW,iBAAiB,QAAQ;CAGtC,MAAM,eAAe,SAAS,QAAQ,SAAS;CAC/C,MAAM,cAAc,MAAM,SAAS,SAAS,MAAM,SAAS;CAC3D,MAAM,mBAAmB,iBAAiB,OAAO,cAAc,QAAQ;CAEvE,IAAI,eAAe,CAAC,kBAClB,aAAa,uBAAuB,WAAW,YAAY;CAM7D,IAAI,aAAa;EACf,IAAI,aAAa,aAGX;OAAA,kBAAkB,YAAY,YAAY,QAAQ,GACpD,OAAO,YAAY;EAAA,OAKhB,IAAI,CAAC,kBAGV,YAAY,aAAa;CAE7B;CAGA,IAAI,aAAa,cACX;MAAA,iBAAiB,OAAO,aAAa,YAAY,QAAQ,GAAG;GAC9D,aAAa,sBAAsB,QAAQ,WAAW,cAAc,QAAQ;GAE5E,cAAc,eAAe,QAAQ,WAAW,QAAQ;GACxD,KAAK,aAAa;GAClB,aAAa,eAAe,SAAS;GAErC,YAAY,OAAO,QAAQ,WAAW,QAAQ;GAC9C,IAAI,eAAe,aAAa,oBAAoB,SAAS,CAAC,CAAC,SAAS,GACtE,GAAG,0BAA0B,QAAQ,SAAS;QAG9C,GAAG,4BAA4B,QAAQ,SAAS;GAGlD,OAAO;EACT;;CAIF,IAAI,kBAAkB;EAGpB,IAAI,EAAE,aAAa,OAAO,KAAK,aAAa,KAAA;EAC5C,OAAO;CACT;CAGA,IAAI,EAAE,aAAa,eACjB,aAAa,eAAe,WAAW,YAAY;CAErD,YAAY,OAAO,QAAQ,WAAW,QAAQ;CAC9C,GAAG,0BAA0B,QAAQ,SAAS;CAE9C,aAAa,sBAAsB,QAAQ,WAAW,cAAc,QAAQ;CAE5E,cAAc,eAAe,QAAQ,WAAW,QAAQ;CACxD,KAAK,aAAa;CAClB,OAAO;AACT;AAEA,SAAS,iBAAiB,OAAc,GAAY,GAAqB;CAEvE,IAAI,MAAM,SAAS,SAAS,MAAM,SAAS,UAAU,iBAAiB,CAAC,KAAK,iBAAiB,CAAC,GAAG,OAAO,MAAM;CAC9G,OAAO,kBAAkB,GAAG,CAAC;AAC/B;AAEA,SAAS,iBAAiB,OAAyB;CACjD,OAAO,UAAU,QAAQ,OAAO,UAAU;AAC5C;AAEA,SAAS,kBAAkB,GAAQ,GAAiB;CAClD,OACE,MAAM,GAAG,CAAC,KACT,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,KAAK,YAAY,GAAG,CAAC,MAEtD,SAAS,CAAC,KAAK,CAAC,EAAE,eAAiB,SAAS,CAAC,KAAK,CAAC,EAAE,gBACtD,0BAA0B,CAAC,MAAM,0BAA0B,CAAC;AAElE;AAEA,SAAgB,YAAY,GAAU,GAAmB;CACvD,IAAI,EAAE,WAAW,EAAE,QAAQ,OAAO;CAClC,OAAO,EAAE,OAAO,GAAQ,MAAM,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;AACjD;AAEA,MAAM,WAAW,qBAAqB,CAAC,EAAE;AACzC,SAAgB,MAAM,GAAQ,GAAiB;CAC7C,IAAI,MAAM,GAAG,OAAO;CACpB,IAAI,aAAa,QAAQ,aAAa,MAAM,OAAO,EAAE,QAAQ,MAAM,EAAE,QAAQ;CAC7E,IAAI,UAAU;EACZ,IAAI,aAAa,SAAS,iBAAiB,aAAa,SAAS,eAAe,OAAO,EAAE,OAAO,CAAC;EACjG,IAAI,aAAa,SAAS,iBAAiB,aAAa,SAAS,eAAe,OAAO,EAAE,OAAO,CAAC;EACjG,IAAI,aAAa,SAAS,aAAa,aAAa,SAAS,WAAW,OAAO,EAAE,OAAO,CAAC;CAC3F;CACA,OAAO;AACT"}

package/build/flush/FlushLock.cjs

@@ -0,0 +1,51 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/flush/FlushLock.ts
+/** A marker to prevent setter calls during `flush` calls. */
+const currentFlushSecret = new (require("async_hooks")).AsyncLocalStorage();
+/**
+* Prevents entities being mutated mid-flush.
+*
+* The `flush` process does a dirty check + SQL flush and generally doesn't want
+* entities to re-dirtied after it's done the initial dirty check. So we'd like
+* to prevent all setter calls while `flush` is running.
+*
+* That said, lifecycle code like hooks actually can make setter calls b/c `flush`
+* invokes them at a specific point in its process.
+*
+* We solve this by using node's `AsyncLocalStorage` to mark certain callbacks (promise
+* handlers) as blessed / invoked-from-`flush`-itself, and they are allowed to call setters,
+* but any external callers (i.e. application code) will be rejected.
+*/
+var FlushLock = class {
+	#flushSecret = 0;
+	#isFlushing = false;
+	/** This will begin any non-hook restrictions on writing to entities. */
+	startLock() {
+		if (this.#isFlushing) throw new Error("Cannot flush while another flush is already in progress");
+		this.#isFlushing = true;
+	}
+	releaseLock() {
+		this.#isFlushing = false;
+	}
+	/** Any writes that happen from `fn`, despite flush being locked, will be allowed. */
+	allowWrites(fn) {
+		return currentFlushSecret.run({ flushSecret: this.#flushSecret }, () => fn().then(() => {
+			this.#flushSecret += 1;
+		}));
+	}
+	/** Blows up if writes are locked, i.e. we're flushing and the caller is not within an `allowWrites` block. */
+	checkWritesAllowed() {
+		if (this.#isFlushing) {
+			const { flushSecret } = currentFlushSecret.getStore() || {};
+			if (flushSecret === void 0) throw new Error(`Cannot mutate an entity during an em.flush outside of a entity hook or from afterCommit`);
+			else if (flushSecret !== this.#flushSecret) throw new Error(`Attempting to reuse a hook context outside its flush loop`);
+		}
+	}
+	get isFlushing() {
+		return this.#isFlushing;
+	}
+};
+//#endregion
+exports.FlushLock = FlushLock;
+
+//# sourceMappingURL=FlushLock.cjs.map

package/build/flush/FlushLock.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlushLock.cjs","names":["AsyncLocalStorage","#isFlushing","#flushSecret"],"sources":["../../src/flush/FlushLock.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"async_hooks\";\n\n/** A marker to prevent setter calls during `flush` calls. */\nconst currentFlushSecret = new AsyncLocalStorage<{ flushSecret: number }>();\n\n/**\n * Prevents entities being mutated mid-flush.\n *\n * The `flush` process does a dirty check + SQL flush and generally doesn't want\n * entities to re-dirtied after it's done the initial dirty check. So we'd like\n * to prevent all setter calls while `flush` is running.\n *\n * That said, lifecycle code like hooks actually can make setter calls b/c `flush`\n * invokes them at a specific point in its process.\n *\n * We solve this by using node's `AsyncLocalStorage` to mark certain callbacks (promise\n * handlers) as blessed / invoked-from-`flush`-itself, and they are allowed to call setters,\n * but any external callers (i.e. application code) will be rejected.\n */\nexport class FlushLock {\n  #flushSecret: number = 0;\n  #isFlushing: boolean = false;\n\n  /** This will begin any non-hook restrictions on writing to entities. */\n  startLock(): void {\n    if (this.#isFlushing) {\n      throw new Error(\"Cannot flush while another flush is already in progress\");\n    }\n    this.#isFlushing = true;\n  }\n\n  releaseLock(): void {\n    this.#isFlushing = false;\n  }\n\n  /** Any writes that happen from `fn`, despite flush being locked, will be allowed. */\n  allowWrites(fn: () => Promise<void>): Promise<void> {\n    return currentFlushSecret.run({ flushSecret: this.#flushSecret }, () =>\n      fn().then(() => {\n        this.#flushSecret += 1;\n      }),\n    );\n  }\n\n  /** Blows up if writes are locked, i.e. we're flushing and the caller is not within an `allowWrites` block. */\n  checkWritesAllowed(): void {\n    if (this.#isFlushing) {\n      const { flushSecret } = currentFlushSecret.getStore() || {};\n      if (flushSecret === undefined) {\n        throw new Error(`Cannot mutate an entity during an em.flush outside of a entity hook or from afterCommit`);\n      } else if (flushSecret !== this.#flushSecret) {\n        throw new Error(`Attempting to reuse a hook context outside its flush loop`);\n      }\n    }\n  }\n\n  get isFlushing(): boolean {\n    return this.#isFlushing;\n  }\n}\n"],"mappings":";;;AAGA,MAAM,qBAAqB,0BAAIA,EAAAA,CAAAA,kBAA2C;;;;;;;;;;;;;;;AAgB1E,IAAa,YAAb,MAAuB;CACrB,eAAuB;CACvB,cAAuB;;CAGvB,YAAkB;EAChB,IAAI,KAAKC,aACP,MAAM,IAAI,MAAM,yDAAyD;EAE3E,KAAKA,cAAc;CACrB;CAEA,cAAoB;EAClB,KAAKA,cAAc;CACrB;;CAGA,YAAY,IAAwC;EAClD,OAAO,mBAAmB,IAAI,EAAE,aAAa,KAAKC,aAAa,SAC7D,GAAG,CAAC,CAAC,WAAW;GACd,KAAKA,gBAAgB;EACvB,CAAC,CACH;CACF;;CAGA,qBAA2B;EACzB,IAAI,KAAKD,aAAa;GACpB,MAAM,EAAE,gBAAgB,mBAAmB,SAAS,KAAK,CAAC;GAC1D,IAAI,gBAAgB,KAAA,GAClB,MAAM,IAAI,MAAM,yFAAyF;QACpG,IAAI,gBAAgB,KAAKC,cAC9B,MAAM,IAAI,MAAM,2DAA2D;EAE/E;CACF;CAEA,IAAI,aAAsB;EACxB,OAAO,KAAKD;CACd;AACF"}

package/build/flush/FlushLock.d.cts

@@ -0,0 +1,29 @@
+//#region src/flush/FlushLock.d.ts
+/**
+ * Prevents entities being mutated mid-flush.
+ *
+ * The `flush` process does a dirty check + SQL flush and generally doesn't want
+ * entities to re-dirtied after it's done the initial dirty check. So we'd like
+ * to prevent all setter calls while `flush` is running.
+ *
+ * That said, lifecycle code like hooks actually can make setter calls b/c `flush`
+ * invokes them at a specific point in its process.
+ *
+ * We solve this by using node's `AsyncLocalStorage` to mark certain callbacks (promise
+ * handlers) as blessed / invoked-from-`flush`-itself, and they are allowed to call setters,
+ * but any external callers (i.e. application code) will be rejected.
+ */
+declare class FlushLock {
+  #private;
+  /** This will begin any non-hook restrictions on writing to entities. */
+  startLock(): void;
+  releaseLock(): void;
+  /** Any writes that happen from `fn`, despite flush being locked, will be allowed. */
+  allowWrites(fn: () => Promise<void>): Promise<void>;
+  /** Blows up if writes are locked, i.e. we're flushing and the caller is not within an `allowWrites` block. */
+  checkWritesAllowed(): void;
+  get isFlushing(): boolean;
+}
+//#endregion
+export { FlushLock };
+//# sourceMappingURL=FlushLock.d.cts.map

package/build/flush/FlushLock.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlushLock.d.cts","names":[],"sources":["../../src/flush/FlushLock.ts"],"mappings":";;;;;;;;;;;;;;;cAmBa;;;EAKX;EAOA;;EAKA,YAAY,UAAU,gBAAgB;;EAStC;MAWI"}

package/build/flush/FlushLock.d.mts

@@ -0,0 +1,29 @@
+//#region src/flush/FlushLock.d.ts
+/**
+ * Prevents entities being mutated mid-flush.
+ *
+ * The `flush` process does a dirty check + SQL flush and generally doesn't want
+ * entities to re-dirtied after it's done the initial dirty check. So we'd like
+ * to prevent all setter calls while `flush` is running.
+ *
+ * That said, lifecycle code like hooks actually can make setter calls b/c `flush`
+ * invokes them at a specific point in its process.
+ *
+ * We solve this by using node's `AsyncLocalStorage` to mark certain callbacks (promise
+ * handlers) as blessed / invoked-from-`flush`-itself, and they are allowed to call setters,
+ * but any external callers (i.e. application code) will be rejected.
+ */
+declare class FlushLock {
+  #private;
+  /** This will begin any non-hook restrictions on writing to entities. */
+  startLock(): void;
+  releaseLock(): void;
+  /** Any writes that happen from `fn`, despite flush being locked, will be allowed. */
+  allowWrites(fn: () => Promise<void>): Promise<void>;
+  /** Blows up if writes are locked, i.e. we're flushing and the caller is not within an `allowWrites` block. */
+  checkWritesAllowed(): void;
+  get isFlushing(): boolean;
+}
+//#endregion
+export { FlushLock };
+//# sourceMappingURL=FlushLock.d.mts.map

package/build/flush/FlushLock.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlushLock.d.mts","names":[],"sources":["../../src/flush/FlushLock.ts"],"mappings":";;;;;;;;;;;;;;;cAmBa;;;EAKX;EAOA;;EAKA,YAAY,UAAU,gBAAgB;;EAStC;MAWI"}

package/build/flush/FlushLock.js

@@ -0,0 +1,51 @@
+import { AsyncLocalStorage } from "async_hooks";
+//#region src/flush/FlushLock.ts
+/** A marker to prevent setter calls during `flush` calls. */
+const currentFlushSecret = new AsyncLocalStorage();
+/**
+* Prevents entities being mutated mid-flush.
+*
+* The `flush` process does a dirty check + SQL flush and generally doesn't want
+* entities to re-dirtied after it's done the initial dirty check. So we'd like
+* to prevent all setter calls while `flush` is running.
+*
+* That said, lifecycle code like hooks actually can make setter calls b/c `flush`
+* invokes them at a specific point in its process.
+*
+* We solve this by using node's `AsyncLocalStorage` to mark certain callbacks (promise
+* handlers) as blessed / invoked-from-`flush`-itself, and they are allowed to call setters,
+* but any external callers (i.e. application code) will be rejected.
+*/
+var FlushLock = class {
+	#flushSecret = 0;
+	#isFlushing = false;
+	/** This will begin any non-hook restrictions on writing to entities. */
+	startLock() {
+		if (this.#isFlushing) throw new Error("Cannot flush while another flush is already in progress");
+		this.#isFlushing = true;
+	}
+	releaseLock() {
+		this.#isFlushing = false;
+	}
+	/** Any writes that happen from `fn`, despite flush being locked, will be allowed. */
+	allowWrites(fn) {
+		return currentFlushSecret.run({ flushSecret: this.#flushSecret }, () => fn().then(() => {
+			this.#flushSecret += 1;
+		}));
+	}
+	/** Blows up if writes are locked, i.e. we're flushing and the caller is not within an `allowWrites` block. */
+	checkWritesAllowed() {
+		if (this.#isFlushing) {
+			const { flushSecret } = currentFlushSecret.getStore() || {};
+			if (flushSecret === void 0) throw new Error(`Cannot mutate an entity during an em.flush outside of a entity hook or from afterCommit`);
+			else if (flushSecret !== this.#flushSecret) throw new Error(`Attempting to reuse a hook context outside its flush loop`);
+		}
+	}
+	get isFlushing() {
+		return this.#isFlushing;
+	}
+};
+//#endregion
+export { FlushLock };
+
+//# sourceMappingURL=FlushLock.js.map

package/build/flush/FlushLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlushLock.js","names":["#isFlushing","#flushSecret"],"sources":["../../src/flush/FlushLock.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"async_hooks\";\n\n/** A marker to prevent setter calls during `flush` calls. */\nconst currentFlushSecret = new AsyncLocalStorage<{ flushSecret: number }>();\n\n/**\n * Prevents entities being mutated mid-flush.\n *\n * The `flush` process does a dirty check + SQL flush and generally doesn't want\n * entities to re-dirtied after it's done the initial dirty check. So we'd like\n * to prevent all setter calls while `flush` is running.\n *\n * That said, lifecycle code like hooks actually can make setter calls b/c `flush`\n * invokes them at a specific point in its process.\n *\n * We solve this by using node's `AsyncLocalStorage` to mark certain callbacks (promise\n * handlers) as blessed / invoked-from-`flush`-itself, and they are allowed to call setters,\n * but any external callers (i.e. application code) will be rejected.\n */\nexport class FlushLock {\n  #flushSecret: number = 0;\n  #isFlushing: boolean = false;\n\n  /** This will begin any non-hook restrictions on writing to entities. */\n  startLock(): void {\n    if (this.#isFlushing) {\n      throw new Error(\"Cannot flush while another flush is already in progress\");\n    }\n    this.#isFlushing = true;\n  }\n\n  releaseLock(): void {\n    this.#isFlushing = false;\n  }\n\n  /** Any writes that happen from `fn`, despite flush being locked, will be allowed. */\n  allowWrites(fn: () => Promise<void>): Promise<void> {\n    return currentFlushSecret.run({ flushSecret: this.#flushSecret }, () =>\n      fn().then(() => {\n        this.#flushSecret += 1;\n      }),\n    );\n  }\n\n  /** Blows up if writes are locked, i.e. we're flushing and the caller is not within an `allowWrites` block. */\n  checkWritesAllowed(): void {\n    if (this.#isFlushing) {\n      const { flushSecret } = currentFlushSecret.getStore() || {};\n      if (flushSecret === undefined) {\n        throw new Error(`Cannot mutate an entity during an em.flush outside of a entity hook or from afterCommit`);\n      } else if (flushSecret !== this.#flushSecret) {\n        throw new Error(`Attempting to reuse a hook context outside its flush loop`);\n      }\n    }\n  }\n\n  get isFlushing(): boolean {\n    return this.#isFlushing;\n  }\n}\n"],"mappings":";;;AAGA,MAAM,qBAAqB,IAAI,kBAA2C;;;;;;;;;;;;;;;AAgB1E,IAAa,YAAb,MAAuB;CACrB,eAAuB;CACvB,cAAuB;;CAGvB,YAAkB;EAChB,IAAI,KAAKA,aACP,MAAM,IAAI,MAAM,yDAAyD;EAE3E,KAAKA,cAAc;CACrB;CAEA,cAAoB;EAClB,KAAKA,cAAc;CACrB;;CAGA,YAAY,IAAwC;EAClD,OAAO,mBAAmB,IAAI,EAAE,aAAa,KAAKC,aAAa,SAC7D,GAAG,CAAC,CAAC,WAAW;GACd,KAAKA,gBAAgB;EACvB,CAAC,CACH;CACF;;CAGA,qBAA2B;EACzB,IAAI,KAAKD,aAAa;GACpB,MAAM,EAAE,gBAAgB,mBAAmB,SAAS,KAAK,CAAC;GAC1D,IAAI,gBAAgB,KAAA,GAClB,MAAM,IAAI,MAAM,yFAAyF;QACpG,IAAI,gBAAgB,KAAKC,cAC9B,MAAM,IAAI,MAAM,2DAA2D;EAE/E;CACF;CAEA,IAAI,aAAsB;EACxB,OAAO,KAAKD;CACd;AACF"}