joist-core 2.3.0 → 2.4.0

package/build/defaults.cjs

@@ -0,0 +1,195 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_normalizeHints = require("./normalizeHints.cjs");
+const require_reactivity_reactiveHints = require("./reactivity/reactiveHints.cjs");
+const require_fields = require("./fields.cjs");
+const require_relations_Reference = require("./relations/Reference.cjs");
+require("./relations/index.cjs");
+const require_utils = require("./utils.cjs");
+const require_EntityMetadata = require("./EntityMetadata.cjs");
+const require_trusted = require("./trusted.cjs");
+require("./Entity.cjs");
+const require_BaseEntity = require("./BaseEntity.cjs");
+let joist_utils = require("joist-utils");
+//#region src/defaults.ts
+function hasDefaultValue(meta, fieldName) {
+	return require_EntityMetadata.getBaseAndSelfMetas(meta).some((m) => fieldName in m.config.__data.syncDefaults || fieldName in m.config.__data.asyncDefaults);
+}
+/** Run the sync defaults for `entity`. */
+function setSyncDefaults(entity) {
+	return require_trusted.runInTrustedContext(() => {
+		const meta = require_EntityMetadata.getMetadata(entity);
+		const syncDefaults = require_EntityMetadata.getBaseAndSelfMetas(meta).reduce((acc, m) => ({
+			...acc,
+			...m.config.__data.syncDefaults
+		}), {});
+		for (const [fieldName, maybeFn] of Object.entries(syncDefaults)) {
+			const field = meta.allFields[fieldName];
+			if ((field.kind === "primitive" || field.kind === "enum") && field.derived === "async") {
+				const value = maybeFn instanceof Function ? maybeFn(entity) : maybeFn;
+				require_fields.setField(entity, fieldName, value);
+			} else if (!isRelation(field)) {
+				if (!(fieldName in require_BaseEntity.getInstanceData(entity).data)) {
+					const value = maybeFn instanceof Function ? maybeFn(entity) : maybeFn;
+					if (value !== void 0) entity[fieldName] = value;
+				}
+			} else {
+				const value = entity[fieldName];
+				if (require_relations_Reference.isLoadedReference(value) && !value.isSet && !value.hasBeenSet) value.set(maybeFn instanceof Function ? maybeFn(entity) : maybeFn);
+			}
+		}
+	});
+}
+/** Runs the async defaults for all inserted entities in `todos`. */
+async function setAsyncDefaults(suppressedTypeErrors, ctx, insertsBySubType) {
+	return require_trusted.runInTrustedContext(async () => {
+		const dt = new DependencyTracker(insertsBySubType);
+		const results = await Promise.allSettled([...insertsBySubType.entries()].flatMap(([meta, inserts]) => {
+			return Object.values(meta.config.__data.asyncDefaults).map((df) => df.setOnEntities(ctx, dt, suppressedTypeErrors, meta, inserts));
+		}));
+		require_utils.failIfAnyRejected(results);
+	});
+}
+/** Sets async defaults *synchronously*, only safe for factories with `DeepNew` entities. */
+function setAsyncDefaultsSynchronously(ctx, entity) {
+	return require_trusted.runInTrustedContext(() => {
+		for (const df of Object.values(require_EntityMetadata.getMetadata(entity).config.__data.asyncDefaults)) df.setOnFactoryEntity(ctx, entity);
+	});
+}
+/** Wraps the hint + lambda of an async `setDefault`. */
+var AsyncDefault = class {
+	fieldName;
+	fieldHint;
+	fn;
+	#loadHint;
+	#deps;
+	constructor(fieldName, fieldHint, fn) {
+		this.fieldName = fieldName;
+		this.fieldHint = fieldHint;
+		this.fn = fn;
+	}
+	/** Given a list of inserts of the same type/subtype, set ourselves on each of them. */
+	async setOnEntities(ctx, dt, suppressedTypeErrors, baseMetadata, inserts) {
+		try {
+			const deps = this.deps(baseMetadata).filter((dep) => dt.hasMaybePending(dep.meta));
+			if (deps.length > 0) await Promise.all(deps.map((dep) => dt.getDeferred(dep.meta, dep.fieldName).promise));
+			const results = await Promise.allSettled(inserts.map(async (entity) => {
+				if (!isRelation(baseMetadata.allFields[this.fieldName])) {
+					if (!(this.fieldName in require_BaseEntity.getInstanceData(entity).data)) {
+						const value = await this.getValue(entity, ctx);
+						if (value !== void 0) entity[this.fieldName] = value;
+					}
+				} else {
+					const value = entity[this.fieldName];
+					if (require_relations_Reference.isLoadedReference(value) && !value.isSet && !value.hasBeenSet) {
+						const val = await this.getValue(entity, ctx);
+						if (val !== void 0) value.set(val);
+					}
+				}
+			}).map((promise) => promise.catch((reason) => {
+				if (reason instanceof TypeError) suppressedTypeErrors.push(reason);
+				else throw reason;
+			})));
+			require_utils.failIfAnyRejected(results);
+		} finally {
+			dt.getDeferred(baseMetadata, this.fieldName).resolve();
+		}
+	}
+	setOnFactoryEntity(ctx, entity) {
+		if (this.fn.constructor.name === "AsyncFunction") return;
+		const value = entity[this.fieldName];
+		try {
+			if (value === void 0 || require_relations_Reference.isLoadedReference(value) && !value.isSet) {
+				const val = this.fn(entity, ctx);
+				if (val instanceof Promise) throw new Error(`Use the \`async\` keyword for the setDefault "${this.fieldName}" function that returns a Promise`);
+				else if (val === void 0) {} else if (require_relations_Reference.isLoadedReference(value)) value.set(val);
+				else entity[this.fieldName] = val;
+			}
+		} catch (e) {}
+	}
+	/** For the given `entity`, returns what the default value should be. */
+	getValue(entity, ctx) {
+		this.#loadHint ??= require_reactivity_reactiveHints.convertToLoadHint(require_EntityMetadata.getMetadata(entity), this.fieldHint);
+		return entity.em.populate(entity, this.#loadHint).then((loaded) => this.fn(loaded, ctx));
+	}
+	deps(meta) {
+		return this.#deps ??= getDefaultDependencies(meta, this.fieldName, this.fieldHint);
+	}
+};
+/**
+* Given a `meta` and a nested field hint, return the meta+field tuples included within the hint.
+*
+* I.e. passing `{ author: { firstName: {}, publisher: "name" } }` would return `[[Author, "firstName"],
+* [Publisher, "name"]]`.
+*/
+function getDefaultDependencies(baseMeta, baseFieldName, baseHint) {
+	const deps = [];
+	const todo = [[baseMeta, require_normalizeHints.normalizeHint(baseHint)]];
+	while (todo.length !== 0) {
+		const [meta, hint] = todo.pop();
+		for (const [fieldName, nestedHint] of Object.entries(hint)) {
+			const field = meta.allFields[fieldName];
+			if (meta === baseMeta && fieldName === baseFieldName) continue;
+			if (!field) continue;
+			switch (field.kind) {
+				case "enum":
+				case "primitive":
+					if (field.default === "config" && fieldName in meta.config.__data.asyncDefaults) deps.push({
+						meta,
+						fieldName
+					});
+					break;
+				case "m2o":
+					if (field.default === "config" && fieldName in meta.config.__data.asyncDefaults) deps.push({
+						meta,
+						fieldName
+					});
+					if (nestedHint) todo.push([field.otherMetadata(), require_normalizeHints.normalizeHint(nestedHint)]);
+					break;
+				case "o2o":
+				case "o2m":
+				case "m2m": if (nestedHint) todo.push([field.otherMetadata(), require_normalizeHints.normalizeHint(nestedHint)]);
+			}
+		}
+	}
+	return deps;
+}
+/**
+* This tracks cross-default dependencies that are active within a single `em.flush` loop.
+*
+* I.e. this is not a static "the Author.firstName in general depends on Publisher.whatever",
+* it tracks that we're actively inserting 10 new `Author` instances, and their `firstName`
+* default needs to wait until the `Publisher.whatever` fields have their async default
+* calculated.
+*
+* Really this is just a smaller wrapper around a map of `Deferred`s.
+*/
+var DependencyTracker = class {
+	#deferreds = /* @__PURE__ */ new Map();
+	constructor(insertsBySubType) {
+		for (const meta of [...insertsBySubType.keys()]) this.#deferreds.set(meta.type, /* @__PURE__ */ new Map());
+	}
+	hasMaybePending(meta) {
+		return this.#deferreds.has(meta.type) ?? false;
+	}
+	getDeferred(meta, fieldName) {
+		const map = this.#deferreds.get(meta.type) ?? require_utils.fail(`No deferred check necessary for ${meta.type}.${fieldName}`);
+		let deferred = map.get(fieldName);
+		if (!deferred) {
+			deferred = new joist_utils.Deferred();
+			map.set(fieldName, deferred);
+		}
+		return deferred;
+	}
+};
+function isRelation(field) {
+	return field.kind !== "primitive" && field.kind !== "enum";
+}
+//#endregion
+exports.AsyncDefault = AsyncDefault;
+exports.getDefaultDependencies = getDefaultDependencies;
+exports.hasDefaultValue = hasDefaultValue;
+exports.setAsyncDefaults = setAsyncDefaults;
+exports.setAsyncDefaultsSynchronously = setAsyncDefaultsSynchronously;
+exports.setSyncDefaults = setSyncDefaults;
+
+//# sourceMappingURL=defaults.cjs.map

package/build/defaults.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.cjs","names":["getBaseAndSelfMetas","runInTrustedContext","getMetadata","getInstanceData","isLoadedReference","#loadHint","convertToLoadHint","#deps","normalizeHint","#deferreds","fail","Deferred"],"sources":["../src/defaults.ts"],"sourcesContent":["import { Deferred } from \"joist-utils\";\nimport { getInstanceData } from \"src/BaseEntity.ts\";\nimport { type Entity } from \"src/Entity.ts\";\nimport {\n  type EntityMetadata,\n  type EnumField,\n  type Field,\n  type PrimitiveField,\n  getBaseAndSelfMetas,\n  getMetadata,\n} from \"src/EntityMetadata.ts\";\nimport { setField } from \"src/fields.ts\";\nimport { normalizeHint } from \"src/normalizeHints.ts\";\nimport { type ReactiveHint, convertToLoadHint } from \"src/reactivity/reactiveHints.ts\";\nimport { isLoadedReference } from \"src/relations/index.ts\";\nimport { runInTrustedContext } from \"src/trusted.ts\";\nimport { fail, failIfAnyRejected } from \"src/utils.ts\";\n\nexport function hasDefaultValue(meta: EntityMetadata, fieldName: string): boolean {\n  return getBaseAndSelfMetas(meta).some(\n    (m) => fieldName in m.config.__data.syncDefaults || fieldName in m.config.__data.asyncDefaults,\n  );\n}\n\n/** Run the sync defaults for `entity`. */\nexport function setSyncDefaults(entity: Entity): void {\n  return runInTrustedContext(() => {\n    const meta = getMetadata(entity);\n    // Allow subtypes to override base setDefaults\n    const syncDefaults: Record<string, any> = getBaseAndSelfMetas(meta).reduce(\n      (acc, m) => ({ ...acc, ...m.config.__data.syncDefaults }),\n      {},\n    );\n    for (const [fieldName, maybeFn] of Object.entries(syncDefaults)) {\n      const field = meta.allFields[fieldName];\n      // Use allFields in case a subtype sets a default for one of its base fields\n      if (\n        (field.kind === \"primitive\" || field.kind === \"enum\") &&\n        (field as PrimitiveField | EnumField).derived === \"async\"\n      ) {\n        // If this is an AsyncReactiveField, we want to push in a default, but setOpts is called\n        // from the codegen constructor, so the user-defined `hasAsyncReactiveField` fields will\n        // not have been initialized yet (i.e. `entity[field]` will be undefined and not yet an\n        // `instanceof AsyncReactiveField`). Thankfully we can just use setField.\n        const value = maybeFn instanceof Function ? maybeFn(entity) : maybeFn;\n        setField(entity, fieldName, value);\n      } else if (!isRelation(field)) {\n        const hasBeenSet = fieldName in getInstanceData(entity).data;\n        if (!hasBeenSet) {\n          const value = maybeFn instanceof Function ? maybeFn(entity) : maybeFn;\n          // If the value is undefined, leave it unset, so that a default invoked during\n          // the constructor being called (before any other opts are set) can be called\n          // again during `em.flush` and get an opportunity to observe other fields.\n          if (value !== undefined) {\n            (entity as any)[fieldName] = value;\n          }\n        }\n      } else {\n        const value = (entity as any)[fieldName];\n        if (isLoadedReference(value) && !value.isSet && !value.hasBeenSet) {\n          // A sync default usually would never be for a reference, because reference defaults usually\n          // require a field hint (so would be async) to get \"the other entity\". However, something like:\n          // `config.setDefault(\"original\", (self) => self);` is technically valid.\n          value.set(maybeFn instanceof Function ? maybeFn(entity) : maybeFn);\n        }\n      }\n    }\n  });\n}\n\n/** Runs the async defaults for all inserted entities in `todos`. */\nexport async function setAsyncDefaults(\n  suppressedTypeErrors: Error[],\n  ctx: unknown,\n  // We want this to be per-subtype, so that a subtype can have its own default, and we still invoke\n  // the subtype `setOnEntities(...all subtype entities...)` and `setOnEntities(...any base types...)`\n  // as bulk calls.\n  insertsBySubType: Map<EntityMetadata, Entity[]>,\n): Promise<void> {\n  return runInTrustedContext(async () => {\n    const dt = new DependencyTracker(insertsBySubType);\n    const results = await Promise.allSettled(\n      [...insertsBySubType.entries()].flatMap(([meta, inserts]) => {\n        // configure will have copy/pasted base defaults into our config, so we can loop over it directly\n        return Object.values(meta.config.__data.asyncDefaults).map((df) =>\n          df.setOnEntities(ctx, dt, suppressedTypeErrors, meta, inserts),\n        );\n      }),\n    );\n    failIfAnyRejected(results);\n  });\n}\n\n/** Sets async defaults *synchronously*, only safe for factories with `DeepNew` entities. */\nexport function setAsyncDefaultsSynchronously(ctx: unknown, entity: Entity): void {\n  return runInTrustedContext(() => {\n    // configure will have copy/pasted base defaults into our config, so we can loop over it directly\n    for (const df of Object.values(getMetadata(entity).config.__data.asyncDefaults)) {\n      df.setOnFactoryEntity(ctx, entity);\n    }\n  });\n}\n\n/** Wraps the hint + lambda of an async `setDefault`. */\nexport class AsyncDefault<T extends Entity> {\n  readonly fieldName: string;\n  readonly fieldHint: ReactiveHint<T>;\n  readonly fn: (entity: any, ctx: any) => any;\n  #loadHint: any;\n  // We can't calc this until post-boot because it requires following metadata\n  #deps: DefaultDependency[] | undefined;\n\n  constructor(fieldName: string, fieldHint: ReactiveHint<T>, fn: (entity: T, ctx: any) => any) {\n    this.fieldName = fieldName;\n    this.fieldHint = fieldHint;\n    this.fn = fn;\n  }\n\n  /** Given a list of inserts of the same type/subtype, set ourselves on each of them. */\n  async setOnEntities(\n    ctx: any,\n    dt: DependencyTracker,\n    suppressedTypeErrors: Error[],\n    baseMetadata: EntityMetadata,\n    inserts: T[],\n  ): Promise<any> {\n    try {\n      // Ensure our dependencies have been set\n      // (...and only wait on dependencies that are actively being calculated)\n      const deps = this.deps(baseMetadata).filter((dep) => dt.hasMaybePending(dep.meta));\n      if (deps.length > 0) {\n        // console.log(\n        //   \"WAITING ON\",\n        //   deps.map((dep) => `${dep.meta.type}.${dep.fieldName}`),\n        //   `FOR ${baseMetadata.type}.${this.fieldName}`,\n        // );\n        // deps promises shouldn't reject, so we should be fine w/o allSettled here\n        await Promise.all(deps.map((dep) => dt.getDeferred(dep.meta, dep.fieldName).promise));\n      }\n\n      // Run our default for all entities, use allSettled to avoid leaving lambdas running if one fails\n      const results = await Promise.allSettled(\n        inserts\n          .map(async (entity) => {\n            if (!isRelation(baseMetadata.allFields[this.fieldName])) {\n              const hasBeenSet = this.fieldName in getInstanceData(entity).data;\n              if (!hasBeenSet) {\n                const value = await this.getValue(entity, ctx);\n                if (value !== undefined) {\n                  (entity as any)[this.fieldName] = value;\n                }\n              }\n            } else {\n              const value = (entity as any)[this.fieldName];\n              if (isLoadedReference(value) && !value.isSet && !value.hasBeenSet) {\n                const val = await this.getValue(entity, ctx);\n                if (val !== undefined) {\n                  value.set(val);\n                }\n              }\n            }\n          })\n          .map((promise) =>\n            promise.catch((reason) => {\n              // If we NPE-d because a required field wasn't set, hold on to this and\n              // let the validation failures reject the `em.flush` instead of us\n              if (reason instanceof TypeError) {\n                suppressedTypeErrors.push(reason);\n              } else {\n                throw reason;\n              }\n            }),\n          ),\n      );\n      failIfAnyRejected(results);\n    } finally {\n      // Mark ourselves as complete (from a `finally` just in case our `setDefault`\n      // blows up, we don't forever block the other defaults waiting on us).\n      // console.log(`FINISHED ${baseMetadata.type}.${this.fieldName}`);\n      dt.getDeferred(baseMetadata, this.fieldName).resolve();\n    }\n  }\n\n  setOnFactoryEntity(ctx: unknown, entity: T): void {\n    // If the lambda uses the `async` keyword, it definitely makes a promise, so don't invoke it\n    // from a synchronous factory call.\n    if (this.fn.constructor.name === \"AsyncFunction\") return;\n    const value = (entity as any)[this.fieldName];\n    try {\n      if (value === undefined || (isLoadedReference(value) && !value.isSet)) {\n        const val = this.fn(entity, ctx);\n        // Even though we checked `async () => ...` above, a lambda could still return a Promise\n        if (val instanceof Promise) {\n          throw new Error(\n            `Use the \\`async\\` keyword for the setDefault \"${this.fieldName}\" function that returns a Promise`,\n          );\n        } else if (val === undefined) {\n          // If val is undefined, let the setDefault get invoked again later\n        } else {\n          if (isLoadedReference(value)) {\n            value.set(val);\n          } else {\n            (entity as any)[this.fieldName] = val;\n          }\n        }\n      }\n    } catch (e) {\n      // It's likely common to get NPEs/TypeErrors from speculatively executing defaults\n      // pre-em.flush, i.e. we don't have the DependencyTracker/etc infra here, the lambdas\n      // could do a `book.author.get.name` and NPE on the `author.get.name`. So instead just\n      // suppress errors and assume `em.flush` will try again.\n      // ...we need to add a NotLoadedError\n      // if (!(e instanceof TypeError || e instanceof NotL)) {\n      //   throw e;\n      // }\n    }\n  }\n\n  /** For the given `entity`, returns what the default value should be. */\n  private getValue(entity: T, ctx: any): Promise<any> {\n    // We can't convert this until now, since it requires the `metadata`\n    this.#loadHint ??= convertToLoadHint(getMetadata(entity), this.fieldHint);\n    return entity.em.populate(entity, this.#loadHint).then((loaded) => this.fn(loaded, ctx));\n  }\n\n  // Calc once and cache\n  private deps(meta: EntityMetadata): DefaultDependency[] {\n    return (this.#deps ??= getDefaultDependencies(meta, this.fieldName, this.fieldHint));\n  }\n}\n\ntype DefaultDependency = {\n  meta: EntityMetadata;\n  fieldName: string;\n};\n\n/**\n * Given a `meta` and a nested field hint, return the meta+field tuples included within the hint.\n *\n * I.e. passing `{ author: { firstName: {}, publisher: \"name\" } }` would return `[[Author, \"firstName\"],\n * [Publisher, \"name\"]]`.\n */\nexport function getDefaultDependencies<T extends Entity>(\n  baseMeta: EntityMetadata<T>,\n  baseFieldName: string,\n  baseHint: ReactiveHint<T>,\n): DefaultDependency[] {\n  // Ensure the hint is an `{ ... }`\n  const deps: DefaultDependency[] = [];\n  const todo: [meta: EntityMetadata, hint: ReactiveHint<any>][] = [[baseMeta, normalizeHint(baseHint)]];\n  while (todo.length !== 0) {\n    const [meta, hint] = todo.pop()!;\n    for (const [fieldName, nestedHint] of Object.entries(hint)) {\n      const field = meta.allFields[fieldName];\n      // Super naive circular dependency detection\n      const isSameField = meta === baseMeta && fieldName === baseFieldName;\n      if (isSameField) continue;\n      // If this is an invalid hint, just ignore it, and assume someone else will fail on it\n      if (!field) continue;\n      switch (field.kind) {\n        case \"enum\":\n        case \"primitive\":\n          if (field.default === \"config\" && fieldName in meta.config.__data.asyncDefaults) {\n            deps.push({ meta, fieldName });\n          }\n          break;\n        case \"m2o\":\n          if (field.default === \"config\" && fieldName in meta.config.__data.asyncDefaults) {\n            deps.push({ meta, fieldName });\n          }\n          if (nestedHint) {\n            todo.push([field.otherMetadata(), normalizeHint(nestedHint)]);\n          }\n          break;\n        case \"o2o\":\n        case \"o2m\":\n        case \"m2m\":\n          if (nestedHint) {\n            todo.push([field.otherMetadata(), normalizeHint(nestedHint)]);\n          }\n          break;\n      }\n    }\n  }\n  return deps;\n}\n\n/**\n * This tracks cross-default dependencies that are active within a single `em.flush` loop.\n *\n * I.e. this is not a static \"the Author.firstName in general depends on Publisher.whatever\",\n * it tracks that we're actively inserting 10 new `Author` instances, and their `firstName`\n * default needs to wait until the `Publisher.whatever` fields have their async default\n * calculated.\n *\n * Really this is just a smaller wrapper around a map of `Deferred`s.\n */\nclass DependencyTracker {\n  // Create a map \"entityType -> fieldName -> deferred\"\n  #deferreds = new Map<string, Map<string, Deferred<void>>>();\n\n  constructor(insertsBySubType: Map<EntityMetadata, Entity[]>) {\n    // Seed it with any entities that we're actively inserting (as any dependencies to\n    // entities that aren't even having `setDefault` called can be skipped)\n    for (const meta of [...insertsBySubType.keys()]) {\n      this.#deferreds.set(meta.type, new Map());\n    }\n  }\n\n  hasMaybePending(meta: EntityMetadata): boolean {\n    return this.#deferreds.has(meta.type) ?? false;\n  }\n\n  getDeferred(meta: EntityMetadata, fieldName: string): Deferred<void> {\n    const map = this.#deferreds.get(meta.type) ?? fail(`No deferred check necessary for ${meta.type}.${fieldName}`);\n    let deferred = map.get(fieldName);\n    if (!deferred) {\n      deferred = new Deferred();\n      map.set(fieldName, deferred);\n    }\n    return deferred;\n  }\n}\n\nfunction isRelation(field: Field): boolean {\n  return field.kind !== \"primitive\" && field.kind !== \"enum\";\n}\n"],"mappings":"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"}

package/build/defaults.d.cts

@@ -0,0 +1,56 @@
+import { ReactiveHint } from "./reactivity/reactiveHints.cjs";
+import { EntityMetadata } from "./EntityMetadata.cjs";
+import { Entity } from "./Entity.cjs";
+import { Deferred } from "joist-utils";
+//#region src/defaults.d.ts
+declare function hasDefaultValue(meta: EntityMetadata, fieldName: string): boolean;
+/** Run the sync defaults for `entity`. */
+declare function setSyncDefaults(entity: Entity): void;
+/** Runs the async defaults for all inserted entities in `todos`. */
+declare function setAsyncDefaults(suppressedTypeErrors: Error[], ctx: unknown, insertsBySubType: Map<EntityMetadata, Entity[]>): Promise<void>;
+/** Sets async defaults *synchronously*, only safe for factories with `DeepNew` entities. */
+declare function setAsyncDefaultsSynchronously(ctx: unknown, entity: Entity): void;
+/** Wraps the hint + lambda of an async `setDefault`. */
+declare class AsyncDefault<T extends Entity> {
+  #private;
+  readonly fieldName: string;
+  readonly fieldHint: ReactiveHint<T>;
+  readonly fn: (entity: any, ctx: any) => any;
+  constructor(fieldName: string, fieldHint: ReactiveHint<T>, fn: (entity: T, ctx: any) => any);
+  /** Given a list of inserts of the same type/subtype, set ourselves on each of them. */
+  setOnEntities(ctx: any, dt: DependencyTracker, suppressedTypeErrors: Error[], baseMetadata: EntityMetadata, inserts: T[]): Promise<any>;
+  setOnFactoryEntity(ctx: unknown, entity: T): void;
+  /** For the given `entity`, returns what the default value should be. */
+  private getValue;
+  private deps;
+}
+type DefaultDependency = {
+  meta: EntityMetadata;
+  fieldName: string;
+};
+/**
+ * Given a `meta` and a nested field hint, return the meta+field tuples included within the hint.
+ *
+ * I.e. passing `{ author: { firstName: {}, publisher: "name" } }` would return `[[Author, "firstName"],
+ * [Publisher, "name"]]`.
+ */
+declare function getDefaultDependencies<T extends Entity>(baseMeta: EntityMetadata<T>, baseFieldName: string, baseHint: ReactiveHint<T>): DefaultDependency[];
+/**
+ * This tracks cross-default dependencies that are active within a single `em.flush` loop.
+ *
+ * I.e. this is not a static "the Author.firstName in general depends on Publisher.whatever",
+ * it tracks that we're actively inserting 10 new `Author` instances, and their `firstName`
+ * default needs to wait until the `Publisher.whatever` fields have their async default
+ * calculated.
+ *
+ * Really this is just a smaller wrapper around a map of `Deferred`s.
+ */
+declare class DependencyTracker {
+  #private;
+  constructor(insertsBySubType: Map<EntityMetadata, Entity[]>);
+  hasMaybePending(meta: EntityMetadata): boolean;
+  getDeferred(meta: EntityMetadata, fieldName: string): Deferred<void>;
+}
+//#endregion
+export { AsyncDefault, getDefaultDependencies, hasDefaultValue, setAsyncDefaults, setAsyncDefaultsSynchronously, setSyncDefaults };
+//# sourceMappingURL=defaults.d.cts.map

package/build/defaults.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.cts","names":[],"sources":["../src/defaults.ts"],"mappings":";;;;;iBAkBgB,gBAAgB,MAAM,gBAAgB;;iBAOtC,gBAAgB,QAAQ;;iBA8ClB,iBACpB,sBAAsB,SACtB,cAIA,kBAAkB,IAAI,gBAAgB,YACrC;;iBAgBa,8BAA8B,cAAc,QAAQ;;cAUvD,aAAa,UAAU;;WACzB;WACA,WAAW,aAAa;WACxB,KAAK,aAAa;EAK3B,YAAY,mBAAmB,WAAW,aAAa,IAAI,KAAK,QAAQ,GAAG;;EAOrE,cACJ,UACA,IAAI,mBACJ,sBAAsB,SACtB,cAAc,gBACd,SAAS,MACR;EA0DH,mBAAmB,cAAc,QAAQ;;UAoCjC;UAOA;;KAKL;EACH,MAAM;EACN;;;;;;;;iBASc,uBAAuB,UAAU,QAC/C,UAAU,eAAe,IACzB,uBACA,UAAU,aAAa,KACtB;;;;;;;;;;;cAmDG;;EAIJ,YAAY,kBAAkB,IAAI,gBAAgB;EAQlD,gBAAgB,MAAM;EAItB,YAAY,MAAM,gBAAgB,oBAAoB"}

package/build/defaults.d.mts

@@ -0,0 +1,56 @@
+import { ReactiveHint } from "./reactivity/reactiveHints.mjs";
+import { EntityMetadata } from "./EntityMetadata.mjs";
+import { Entity } from "./Entity.mjs";
+import { Deferred } from "joist-utils";
+//#region src/defaults.d.ts
+declare function hasDefaultValue(meta: EntityMetadata, fieldName: string): boolean;
+/** Run the sync defaults for `entity`. */
+declare function setSyncDefaults(entity: Entity): void;
+/** Runs the async defaults for all inserted entities in `todos`. */
+declare function setAsyncDefaults(suppressedTypeErrors: Error[], ctx: unknown, insertsBySubType: Map<EntityMetadata, Entity[]>): Promise<void>;
+/** Sets async defaults *synchronously*, only safe for factories with `DeepNew` entities. */
+declare function setAsyncDefaultsSynchronously(ctx: unknown, entity: Entity): void;
+/** Wraps the hint + lambda of an async `setDefault`. */
+declare class AsyncDefault<T extends Entity> {
+  #private;
+  readonly fieldName: string;
+  readonly fieldHint: ReactiveHint<T>;
+  readonly fn: (entity: any, ctx: any) => any;
+  constructor(fieldName: string, fieldHint: ReactiveHint<T>, fn: (entity: T, ctx: any) => any);
+  /** Given a list of inserts of the same type/subtype, set ourselves on each of them. */
+  setOnEntities(ctx: any, dt: DependencyTracker, suppressedTypeErrors: Error[], baseMetadata: EntityMetadata, inserts: T[]): Promise<any>;
+  setOnFactoryEntity(ctx: unknown, entity: T): void;
+  /** For the given `entity`, returns what the default value should be. */
+  private getValue;
+  private deps;
+}
+type DefaultDependency = {
+  meta: EntityMetadata;
+  fieldName: string;
+};
+/**
+ * Given a `meta` and a nested field hint, return the meta+field tuples included within the hint.
+ *
+ * I.e. passing `{ author: { firstName: {}, publisher: "name" } }` would return `[[Author, "firstName"],
+ * [Publisher, "name"]]`.
+ */
+declare function getDefaultDependencies<T extends Entity>(baseMeta: EntityMetadata<T>, baseFieldName: string, baseHint: ReactiveHint<T>): DefaultDependency[];
+/**
+ * This tracks cross-default dependencies that are active within a single `em.flush` loop.
+ *
+ * I.e. this is not a static "the Author.firstName in general depends on Publisher.whatever",
+ * it tracks that we're actively inserting 10 new `Author` instances, and their `firstName`
+ * default needs to wait until the `Publisher.whatever` fields have their async default
+ * calculated.
+ *
+ * Really this is just a smaller wrapper around a map of `Deferred`s.
+ */
+declare class DependencyTracker {
+  #private;
+  constructor(insertsBySubType: Map<EntityMetadata, Entity[]>);
+  hasMaybePending(meta: EntityMetadata): boolean;
+  getDeferred(meta: EntityMetadata, fieldName: string): Deferred<void>;
+}
+//#endregion
+export { AsyncDefault, getDefaultDependencies, hasDefaultValue, setAsyncDefaults, setAsyncDefaultsSynchronously, setSyncDefaults };
+//# sourceMappingURL=defaults.d.mts.map

package/build/defaults.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.mts","names":[],"sources":["../src/defaults.ts"],"mappings":";;;;;iBAkBgB,gBAAgB,MAAM,gBAAgB;;iBAOtC,gBAAgB,QAAQ;;iBA8ClB,iBACpB,sBAAsB,SACtB,cAIA,kBAAkB,IAAI,gBAAgB,YACrC;;iBAgBa,8BAA8B,cAAc,QAAQ;;cAUvD,aAAa,UAAU;;WACzB;WACA,WAAW,aAAa;WACxB,KAAK,aAAa;EAK3B,YAAY,mBAAmB,WAAW,aAAa,IAAI,KAAK,QAAQ,GAAG;;EAOrE,cACJ,UACA,IAAI,mBACJ,sBAAsB,SACtB,cAAc,gBACd,SAAS,MACR;EA0DH,mBAAmB,cAAc,QAAQ;;UAoCjC;UAOA;;KAKL;EACH,MAAM;EACN;;;;;;;;iBASc,uBAAuB,UAAU,QAC/C,UAAU,eAAe,IACzB,uBACA,UAAU,aAAa,KACtB;;;;;;;;;;;cAmDG;;EAIJ,YAAY,kBAAkB,IAAI,gBAAgB;EAQlD,gBAAgB,MAAM;EAItB,YAAY,MAAM,gBAAgB,oBAAoB"}