joist-core 2.3.0 → 2.4.0-next.2

package/build/defaults.js

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

package/build/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"defaults.js","names":["#loadHint","#deps","#deferreds"],"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/drivers/Driver.cjs

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../plugins/PreloadPlugin.cjs");
+require("../EntityManager.cjs");

package/build/drivers/Driver.d.cts

@@ -0,0 +1,51 @@
+import { JoinRowTodo, Todo } from "../flush/Todo.cjs";
+import { ParsedFindQuery } from "../queries/find/QueryParser.cjs";
+import { RowData } from "../RowData.cjs";
+import { PreloadPlugin } from "../plugins/PreloadPlugin.cjs";
+import { EntityManager } from "../EntityManager.cjs";
+//#region src/drivers/Driver.d.ts
+/**
+ * Isolates all SQL calls that Joist needs to make to fetch/save data.
+ *
+ * @typeParam TX - the connection library-specific `Transaction` type, i.e. `Knex.Transaction`
+ */
+interface Driver<TX = unknown> {
+  /** Executes a low-level `ParsedFindQuery` against the database and returns the rows. */
+  executeFind(em: EntityManager, parsed: ParsedFindQuery, settings: {
+    limit?: number;
+    offset?: number;
+  }): Promise<any[]>;
+  /**
+   * Executes a raw SQL query with bindings and returns its command count and rows.
+   *
+   * The count is reported by the database command, never inferred from the returned rows.
+   * Commands without a count, such as DDL, return null; `em.execute` requires a nonnegative integer.
+   */
+  executeQuery(em: EntityManager, sql: string, bindings: any[]): Promise<DriverQueryResult>;
+  /**
+   * Like `executeFind`, but returns a lazy {@link RowData} instead of materialized POJO rows.
+   *
+   * This method's *presence* is the capability signal: drivers define it only when lazy rows
+   * are supported + enabled (i.e. `PostgresDriver` with `lazyRows: true`), and entity-hydrating
+   * loaders fall back to classic rows wrapped in a `PojoRowData` when it is undefined.
+   */
+  executeFindRowData?(em: EntityManager, parsed: ParsedFindQuery, settings: {
+    limit?: number;
+    offset?: number;
+  }): Promise<RowData>;
+  transaction<T>(em: EntityManager, fn: (txn: TX) => Promise<T>): Promise<T>;
+  assignNewIds(em: EntityManager, todos: Record<string, Todo>): Promise<void>;
+  flush(em: EntityManager, todos: Record<string, Todo>, joinRows: Record<string, JoinRowTodo>): Promise<void>;
+  /** Allows the driver to opt `EntityManager`s into plugins it has enabled/supported by default. */
+  defaultPlugins: {
+    preloadPlugin?: PreloadPlugin;
+  };
+}
+/** Raw rows and the database command's affected-row count for mutations or selected-row count for reads. */
+interface DriverQueryResult {
+  rowCount: number | null;
+  rows: any[];
+}
+//#endregion
+export { Driver, DriverQueryResult };
+//# sourceMappingURL=Driver.d.cts.map

package/build/drivers/Driver.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Driver.d.cts","names":[],"sources":["../../src/drivers/Driver.ts"],"mappings":";;;;;;;;;;;UAWiB,OAAO;;EAEtB,YACE,IAAI,eACJ,QAAQ,iBACR;IAAY;IAAgB;MAC3B;;;;;;;EAQH,aAAa,IAAI,eAAe,aAAa,kBAAkB,QAAQ;;;;;;;;EASvE,oBACE,IAAI,eACJ,QAAQ,iBACR;IAAY;IAAgB;MAC3B,QAAQ;EAEX,YAAY,GAAG,IAAI,eAAe,KAAK,KAAK,OAAO,QAAQ,KAAK,QAAQ;EAExE,aAAa,IAAI,eAAe,OAAO,eAAe,QAAQ;EAE9D,MAAM,IAAI,eAAe,OAAO,eAAe,OAAO,UAAU,eAAe,eAAe;;EAG9F;IAAkB,gBAAgB;;;;UAInB;EACf;EACA"}