joist-orm 1.293.0 → 2.0.0

package/build/logging/FactoryLogger.js

@@ -1,77 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FactoryLogger = void 0;
-exports.setFactoryWriter = setFactoryWriter;
-const ansis_1 = __importDefault(require("ansis"));
-const config_1 = require("../config");
-let writer = undefined;
-const { gray, green, yellow } = ansis_1.default;
-class FactoryLogger {
-    level = 0;
-    writeFn;
-    skipNextLogCreating = false;
-    // We default to process.stdout.write to side-step around Jest's console.log instrumentation
-    // adding "...at..." stack traces to our output.
-    constructor() {
-        this.writeFn = writer ?? process.stdout.write.bind(process.stdout);
-    }
-    logCreating(cstr) {
-        // This was already logged by the parent `field = creating new`
-        if (this.skipNextLogCreating) {
-            this.skipNextLogCreating = false;
-        }
-        else {
-            this.write("Creating", green.bold(`new ${cstr.name}`), gray(`at ${(0, config_1.getCallerName)(2)}`));
-        }
-    }
-    logAddToUseMap(e, source) {
-        if (source === "sameBranch" || source === "diffBranch") {
-            this.write(`${gray(`created`)} ${e.toString()} ${gray("added to scope")}`);
-        }
-        else {
-            this.write(`${gray(`...adding`)} ${e.toString()} ${gray("opt to scope")}`);
-        }
-    }
-    logCreated(e) {
-        // This matches the `logAddToUseMap` but for entities not going into scope
-        this.write(`${gray(`created`)} ${e.toString()}`);
-    }
-    logFoundExisting(e) {
-        // Make this yellow because it reverses the "new Entity" we thought we were going to do
-        this.write(`${yellow(`using existing`)} ${e.toString()}`);
-    }
-    logFoundOpt(fieldName, e) {
-        this.write(`${gray(`${fieldName} =`)} ${e.toString()} ${gray("from opt")}`);
-    }
-    logNotFoundAndCreating(fieldName, meta) {
-        this.write(`${gray(`${fieldName} =`)} creating ${green.bold(`new ${meta.type}`)}`);
-        this.skipNextLogCreating = true;
-    }
-    logFoundInUseMap(fieldName, e) {
-        this.write(`${gray(`${fieldName} =`)} ${e.toString()} ${gray("from scope")}`);
-    }
-    logFoundSingleEntity(fieldName, e) {
-        this.write(`${gray(`${fieldName} =`)} ${e.toString()} ${gray("from em")}`);
-    }
-    indent() {
-        this.level++;
-    }
-    dedent() {
-        this.level--;
-    }
-    write(...line) {
-        this.writeFn(this.prefix() + line.join(" ") + "\n");
-    }
-    prefix() {
-        return "  ".repeat(this.level);
-    }
-}
-exports.FactoryLogger = FactoryLogger;
-// Allow our test suite observe the logger behavior
-function setFactoryWriter(write) {
-    writer = write;
-}
-//# sourceMappingURL=FactoryLogger.js.map

package/build/logging/FactoryLogger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"FactoryLogger.js","sourceRoot":"","sources":["../../src/logging/FactoryLogger.ts"],"names":[],"mappings":"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"}

package/build/logging/FieldLogger.d.ts

@@ -1,27 +0,0 @@
-import { Entity } from "../Entity";
-export type WriteFn = (line: string) => void;
-export type FieldLoggerWatch = {
-    /** The entity name, i.e. `Author` */
-    entity: string;
-    /** The fields, i.e. `["firstName", "lastName"]`. */
-    fieldNames?: string[];
-    /** Whether to stop a debugger when the field is set. */
-    breakpoint?: boolean;
-};
-/**
- * Logs the setting of fields on entities to a `writeFn`, which defaults to `process.stdout`.
- */
-export declare class FieldLogger {
-    #private;
-    constructor(
-    /** The fields to watch, defaults to all fields. */
-    watching: FieldLoggerWatch[], 
-    /** An optional/semi-internal write function, mostly for testing. */
-    writeFn?: WriteFn);
-    logCreate(entity: Entity): void;
-    logSet(entity: Entity, fieldName: string, value: unknown): void;
-    private log;
-    private shouldLog;
-    private getColor;
-}
-//# sourceMappingURL=FieldLogger.d.ts.map

package/build/logging/FieldLogger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FieldLogger.d.ts","sourceRoot":"","sources":["../../src/logging/FieldLogger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAY,MAAM,WAAW,CAAC;AAI7C,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,qBAAa,WAAW;;;IAKpB,mDAAmD;IACnD,QAAQ,EAAE,gBAAgB,EAAE;IAC5B,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO;IAOnB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAe/D,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,QAAQ;CAOjB"}

package/build/logging/FieldLogger.js

@@ -1,69 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FieldLogger = void 0;
-const ansis_1 = __importDefault(require("ansis"));
-const Entity_1 = require("../Entity");
-const config_1 = require("../config");
-const { gray, green, yellow, blue, red } = ansis_1.default;
-/**
- * Logs the setting of fields on entities to a `writeFn`, which defaults to `process.stdout`.
- */
-class FieldLogger {
-    #writeFn;
-    #watching = [];
-    constructor(
-    /** The fields to watch, defaults to all fields. */
-    watching, 
-    /** An optional/semi-internal write function, mostly for testing. */
-    writeFn) {
-        // We default to process.stdout.write to side-step around Jest's console.log instrumentation
-        this.#writeFn = writeFn ?? ((line) => process.stdout.write(`${line}\n`));
-        this.#watching = watching ?? [];
-    }
-    logCreate(entity) {
-        const log = this.shouldLog(entity, "constructor");
-        if (!log)
-            return;
-        this.log(green.bold(`${entity.toTaggedString()}`) + " " + yellow(`created`), gray(`at ${(0, config_1.getFuzzyCallerName)()}`));
-        if (log === "breakpoint")
-            debugger;
-    }
-    logSet(entity, fieldName, value) {
-        const log = this.shouldLog(entity, fieldName);
-        if (!log)
-            return;
-        const color = this.getColor(value);
-        this.log(green.bold(`${entity.toTaggedString()}`) + yellow(`.${fieldName}`), gray(`=`), color(`${value}`), 
-        // We don't know if we'll be called from getField or M2O.set+getField, i.e. how many stack frames to skip
-        // to really get "the caller's location", so use `getFuzzyCallerName` instead of `getCallerName`.
-        gray(`at ${(0, config_1.getFuzzyCallerName)()}`));
-        if (log === "breakpoint")
-            debugger;
-    }
-    log(...line) {
-        this.#writeFn(`${line.join(" ")}`);
-    }
-    shouldLog(entity, fieldName) {
-        if (this.#watching.length === 0)
-            return true;
-        for (const { entity: entityName, fieldNames, breakpoint } of this.#watching) {
-            if (entity.constructor.name === entityName && (fieldNames === undefined || fieldNames.includes(fieldName))) {
-                return breakpoint ? "breakpoint" : true;
-            }
-        }
-        return false;
-    }
-    // Do some `typeof` -> color
-    getColor(value) {
-        return typeof value === "boolean"
-            ? red // boolean => red
-            : (0, Entity_1.isEntity)(value)
-                ? green // entity => green (matches other logging)
-                : blue; // otherwise strings/dates/numbers are blue;
-    }
-}
-exports.FieldLogger = FieldLogger;
-//# sourceMappingURL=FieldLogger.js.map

package/build/logging/FieldLogger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"FieldLogger.js","sourceRoot":"","sources":["../../src/logging/FieldLogger.ts"],"names":[],"mappings":"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"}

package/build/logging/ReactionLogger.d.ts

@@ -1,23 +0,0 @@
-import { Reactable } from "../config";
-import { Entity } from "../Entity";
-import { EntityManager } from "../EntityManager";
-import { ReactiveAction } from "../ReactionsManager";
-export declare let globalLogger: ReactionLogger | undefined;
-type WriteFn = (line: string) => void;
-export declare class ReactionLogger {
-    private writeFn;
-    constructor(writeFn?: WriteFn);
-    now(): number;
-    logQueued(entity: Entity, fieldName: string, r: Reactable): void;
-    logQueuedAll(entity: Entity, reason: string, r: Reactable): void;
-    logStartingRecalc(em: EntityManager, kind: "reactables" | "reactiveQueries"): void;
-    logWalked(todo: Entity[], r: Reactable, entities: Entity[]): void;
-    logLoading(em: EntityManager, actions: ReactiveAction[]): void;
-    logLoadingTime(em: EntityManager, millis: number): void;
-    private entityCount;
-    private log;
-}
-export declare function setReactionLogging(enabled: boolean): void;
-export declare function setReactionLogging(logger: ReactionLogger): void;
-export {};
-//# sourceMappingURL=ReactionLogger.d.ts.map

package/build/logging/ReactionLogger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ReactionLogger.d.ts","sourceRoot":"","sources":["../../src/logging/ReactionLogger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD,eAAO,IAAI,YAAY,EAAE,cAAc,GAAG,SAAqB,CAAC;AAChE,KAAK,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAEtC,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAU;gBAGb,OAAO,GAAE,OAAmD;IAIxE,GAAG,IAAI,MAAM;IAIb,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,GAAG,IAAI;IAQhE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,GAAG,IAAI;IAQhE,iBAAiB,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,GAAG,iBAAiB,GAAG,IAAI;IAOlF,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAyBjE,UAAU,CAAC,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI;IAe9D,cAAc,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIvD,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,GAAG;CAGZ;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;AAC3D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC"}

package/build/logging/ReactionLogger.js

@@ -1,65 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReactionLogger = exports.globalLogger = void 0;
-exports.setReactionLogging = setReactionLogging;
-const ansis_1 = __importDefault(require("ansis"));
-const utils_1 = require("../utils");
-const { gray, green, yellow, white } = ansis_1.default;
-exports.globalLogger = undefined;
-class ReactionLogger {
-    writeFn;
-    // We default to process.stdout.write to side-step around Jest's console.log instrumentation
-    constructor(writeFn = process.stdout.write.bind(process.stdout)) {
-        this.writeFn = writeFn;
-    }
-    now() {
-        return performance.now();
-    }
-    logQueued(entity, fieldName, r) {
-        this.log(green.bold(`${entity.toTaggedString()}`) + yellow(`.${fieldName}`), gray(`changed, queuing`), green.bold(`${entity.toTaggedString()}`) + yellow(maybeDotPath(r)) + yellow(r.name));
-    }
-    logQueuedAll(entity, reason, r) {
-        this.log(green.bold(`${entity.toTaggedString()}`), gray(`${reason}, queuing`), green.bold(`${entity.toTaggedString()}`) + green(maybeDotPath(r)) + yellow(r.name));
-    }
-    logStartingRecalc(em, kind) {
-        this.log(white.bold(`Recalculating reactive ${kind === "reactiveQueries" ? "queries" : "fields"} values...`), this.entityCount(em));
-    }
-    logWalked(todo, r, entities) {
-        // Keep for future debugging...
-        const from = todo[0].constructor.name;
-        this.log(" ", // indent
-        gray(`Walked`), white(`${todo.length}`), green.bold(`${from}`) + green(`.${r.path.join(".")}`), gray("paths, found"), white(`${entities.length}`), green.bold(`${r.cstr.name}`) + green(".") + yellow(r.name), gray("to recalc"));
-        if (entities.length > 0) {
-            this.log("   ", // indent
-            gray("["), todo.map((e) => e.toTaggedString()).join(" "), gray("] -> ["), [...new Set(entities)].map((e) => e.toTaggedString()).join(" "), gray("]"));
-        }
-    }
-    logLoading(em, actions) {
-        this.log(" ", gray("Loading"), String(actions.length), gray("actions..."), this.entityCount(em));
-        // Group by the action name
-        [...(0, utils_1.groupBy)(actions, (a) => `${a.entity.constructor.name},${a.r.name}`).values()].forEach((actions) => {
-            const { r, entity } = actions[0];
-            this.log("   ", green.bold(entity.constructor.name) + green(".") + yellow(r.name), gray("-> ["), String(actions.map((a) => a.entity.toTaggedString()).join(" ")), gray("]"));
-        });
-    }
-    logLoadingTime(em, millis) {
-        this.log("   ", gray("took"), String(Math.floor(millis)), gray("millis"), this.entityCount(em));
-    }
-    entityCount(em) {
-        return gray("(em.entities=") + em.entities.length + gray(")");
-    }
-    log(...line) {
-        this.writeFn(`${line.join(" ")}\n`);
-    }
-}
-exports.ReactionLogger = ReactionLogger;
-function setReactionLogging(arg) {
-    exports.globalLogger = typeof arg === "boolean" ? (arg ? new ReactionLogger() : undefined) : arg;
-}
-function maybeDotPath(r) {
-    return r.path.length > 0 ? `.${r.path.join(".")}.` : ".";
-}
-//# sourceMappingURL=ReactionLogger.js.map

package/build/logging/ReactionLogger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ReactionLogger.js","sourceRoot":"","sources":["../../src/logging/ReactionLogger.ts"],"names":[],"mappings":"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"}

package/build/newEntity.d.ts

@@ -1,45 +0,0 @@
-import { Entity } from "./Entity";
-import { EntityConstructor, EntityManager } from "./EntityManager";
-import { EntityMetadata } from "./EntityMetadata";
-/**
- * Constructs an instance of `cstr` but with relations all made lazy.
- *
- * Specifically we avoid going through `new` b/c that invokes the `constructor` which instantiates
- * the instance-level class fields/relations like `books = hasMany`.
- *
- * Instead, we just call `Object.create`, which does not make any constructor/super calls, and instead
- * let any `this.books` accesses resolve to the getters we've installed on the prototype.
- */
-export declare function newEntity<T extends Entity>(em: EntityManager, cstr: EntityConstructor<T>, isNew: boolean): T;
-/**
- * A function for `has...` methods to integrate with the `newEntity` lazy field system.
- *
- * We need TypeScript to still see `books = hasMany(...)` as being typed as `Many<Book>`,
- * so this method's return type is `R` i.e. the `Many<Book>` relation type.
- *
- * But at runtime we actually want this to be a `LazyField` that can be rewritten
- * into a getter, and only invoked when the relation is actually accessed.
- */
-export declare function lazyField<T extends Entity, R>(fn: (entity: T, fieldName: string) => R): R;
-/**
- * Easily resolves `otherMetadata` fields for lazy relations.
- *
- * When `lazyRelation`s are initialized for their first/only time, i.e. the `books = hasBooks(authorMetadata)`
- * call that `getFakeInstance` does, it's when the class bodies are still being evaled, which is before the
- * `metadata.ts` file has run.
- *
- * This means that any `authorMetadata` consts would still be undefined.
- *
- * So instead we just do not bother passing metadata consts to `has...` methods, and instead let the methods
- * one-time resolve `otherMetadata` on their first invocation, which will be after the `metadata.ts` file has
- * finished importing, and the consts are all defined.
- */
-export declare function resolveOtherMeta(entity: Entity, fieldName: string): EntityMetadata;
-/** Wraps `has...` relation constructors in an easily-identifiable container. */
-export declare class LazyField<T extends Entity> {
-    #private;
-    constructor(fn: (entity: T, fieldName: string) => any);
-    /** Called by our getters to lazily create the relation on first access. */
-    create(entity: T, fieldName: string): any;
-}
-//# sourceMappingURL=newEntity.d.ts.map

package/build/newEntity.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"newEntity.d.ts","sourceRoot":"","sources":["../src/newEntity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAe,MAAM,kBAAkB,CAAC;AAO/D;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAa5G;AA6BD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,CAEzF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAIlF;AAED,gFAAgF;AAChF,qBAAa,SAAS,CAAC,CAAC,SAAS,MAAM;;gBAEzB,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,GAAG;IAIrD,2EAA2E;IAC3E,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM;CAGpC"}

package/build/newEntity.js

@@ -1,106 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LazyField = void 0;
-exports.newEntity = newEntity;
-exports.lazyField = lazyField;
-exports.resolveOtherMeta = resolveOtherMeta;
-const BaseEntity_1 = require("./BaseEntity");
-const EntityMetadata_1 = require("./EntityMetadata");
-const getProperties_1 = require("./getProperties");
-const utils_1 = require("./utils");
-// Marks a constructor like Author has having had our relation getters installed
-const lazySymbol = Symbol("lazy");
-/**
- * Constructs an instance of `cstr` but with relations all made lazy.
- *
- * Specifically we avoid going through `new` b/c that invokes the `constructor` which instantiates
- * the instance-level class fields/relations like `books = hasMany`.
- *
- * Instead, we just call `Object.create`, which does not make any constructor/super calls, and instead
- * let any `this.books` accesses resolve to the getters we've installed on the prototype.
- */
-function newEntity(em, cstr, isNew) {
-    if (!Object.hasOwn(cstr, lazySymbol)) {
-        moveRelationsToGetters(cstr);
-        cstr[lazySymbol] = true;
-    }
-    const meta = (0, EntityMetadata_1.getMetadata)(cstr);
-    if (meta.ctiAbstract)
-        (0, utils_1.fail)(`Cannot create an instance of abstract entity ${meta.type}`);
-    // This side-steps the `Author` constructor that initializes fields instance-level fields, which instead
-    // we've shoved up to be getters on the prototype, and the only instance field we expect to have is `__data`,
-    // which is set by the `baseEntityCstr` call.
-    const entity = Object.create(cstr.prototype);
-    (0, BaseEntity_1.baseEntityCstr)(em, entity, isNew);
-    return entity;
-}
-function moveRelationsToGetters(cstr) {
-    // Reuse getProperties's detect
-    for (const [fieldName, value] of (0, getProperties_1.getLazyFields)((0, EntityMetadata_1.getMetadata)(cstr))) {
-        if (value instanceof LazyField) {
-            Object.defineProperty(cstr.prototype, fieldName, {
-                get() {
-                    return (this.__data.relations[fieldName] ??= value.create(this, fieldName));
-                },
-            });
-        }
-        else if (fieldName === "transientFields") {
-            Object.defineProperty(cstr.prototype, fieldName, {
-                get() {
-                    // This prototype-level `get` will only ever be called once per instance, b/c when we're
-                    // called for the first/only time, we set an instance-level `this.transientFields` that, for
-                    // all future calls, will resolve to the instance's own copy of the fields.
-                    //
-                    // This has the pleasant upshot of making the instance-level `transientFields` lazy, and
-                    // they will not be created on an instance until they're actually asked for.
-                    const copy = structuredClone(value);
-                    Object.defineProperty(this, "transientFields", { value: copy });
-                    return copy;
-                },
-            });
-        }
-    }
-}
-/**
- * A function for `has...` methods to integrate with the `newEntity` lazy field system.
- *
- * We need TypeScript to still see `books = hasMany(...)` as being typed as `Many<Book>`,
- * so this method's return type is `R` i.e. the `Many<Book>` relation type.
- *
- * But at runtime we actually want this to be a `LazyField` that can be rewritten
- * into a getter, and only invoked when the relation is actually accessed.
- */
-function lazyField(fn) {
-    return new LazyField(fn);
-}
-/**
- * Easily resolves `otherMetadata` fields for lazy relations.
- *
- * When `lazyRelation`s are initialized for their first/only time, i.e. the `books = hasBooks(authorMetadata)`
- * call that `getFakeInstance` does, it's when the class bodies are still being evaled, which is before the
- * `metadata.ts` file has run.
- *
- * This means that any `authorMetadata` consts would still be undefined.
- *
- * So instead we just do not bother passing metadata consts to `has...` methods, and instead let the methods
- * one-time resolve `otherMetadata` on their first invocation, which will be after the `metadata.ts` file has
- * finished importing, and the consts are all defined.
- */
-function resolveOtherMeta(entity, fieldName) {
-    const meta = (0, EntityMetadata_1.getMetadata)(entity);
-    const field = meta.allFields[fieldName] ?? (0, utils_1.fail)(`Could not find field ${meta.type}.${fieldName}`);
-    return field.otherMetadata();
-}
-/** Wraps `has...` relation constructors in an easily-identifiable container. */
-class LazyField {
-    #fn;
-    constructor(fn) {
-        this.#fn = fn;
-    }
-    /** Called by our getters to lazily create the relation on first access. */
-    create(entity, fieldName) {
-        return this.#fn(entity, fieldName);
-    }
-}
-exports.LazyField = LazyField;
-//# sourceMappingURL=newEntity.js.map

package/build/newEntity.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"newEntity.js","sourceRoot":"","sources":["../src/newEntity.ts"],"names":[],"mappings":"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"}

package/build/newTestInstance.d.ts

@@ -1,193 +0,0 @@
-import { Entity } from "./Entity";
-import { EntityConstructor, EntityManager, IdOf, MaybeAbstractEntityConstructor } from "./EntityManager";
-import { DeepNew, FactoryExtrasOf } from "./index";
-import { ActualFactoryOpts, OptsOf } from "./typeMap";
-/**
- * DeepPartial-esque type specific to our `newTestInstance` factory.
- *
- * Specifically (vs using DeepPartial directly) this:
- *
- * 1. Adds a `use` tag of `Entity | Entity[]` that will be checked for existing
- * entities before creating new ones (i.e. "if `newTestInstance` needs a `Book`,
- * use the one in `use` instead of making a new one).
- *
- * 2. Works specifically against the constructor/entity opts fields.
- */
-export type FactoryOpts<T extends Entity> = DeepPartialOpts<T> & {
-    use?: Entity | Entity[];
-    useFactoryDefaults?: boolean | "none";
-    useExistingCheck?: boolean;
-    useLogging?: boolean;
-} & {
-    [K in keyof FactoryExtrasOf<T>]?: FactoryExtrasOf<T>[K];
-};
-export declare const testDate: Date;
-export declare const testPlainDate: import("temporal-spec").Temporal.PlainDate | undefined;
-export declare const testPlainDateTime: import("temporal-spec").Temporal.PlainDateTime | undefined;
-export declare const testZonedDateTime: import("temporal-spec").Temporal.ZonedDateTime | undefined;
-/**
- * Creates a test instance of `T`.
- *
- * If the factory code passes factoryOpts.useExisting, they can "intercept" the `em.create`
- * to try and resolve "already created" / singleton instances. The `useExisting` callback is
- * useful b/c the `opts` will be the "resolved-to-entity" opts, and not the raw "maybe object
- * literal, maybe object instance" opts that tests pass into the factory.
- */
-export declare function newTestInstance<T extends Entity>(em: EntityManager, cstr: EntityConstructor<T>, 
-/** The test's test-specific override opts. */
-testOpts?: FactoryOpts<T>, 
-/** The factory file's default opts. */
-factoryOpts?: FactoryOpts<T> & {
-    useExisting?: (opts: OptsOf<T>, existing: DeepNew<T>) => boolean;
-}): DeepNew<T>;
-/**
- * A marker value for later replacement with the test instance's "unique-ish" index.
- *
- * This is meant to just be a helpful identifier in fields like entity names/descriptions for
- * debugging purposes.
- */
-export declare const testIndex: number;
-/**
- * A marker value for the default `newTestInstance` behavior.
- *
- * Useful for passing arguments to `newTestInstance` where you sometimes want to
- * provide a specific value, and other times ask for the "pick a default" behavior
- * (i.e. you don't want to pass `undefined` b/c that means explicitly "leave this
- * key unset").
- *
- * Note that this is a function so that we can infer the return type as basically
- * `any` without really using `any` (which would disable type-checking in the rest
- * of the expression).
- */
-export declare function defaultValue<T>(): T;
-/**
- * A marker value to never set a field, even if it's required.
- *
- * The factories treat `{ author: undefined }` as "still set the author", because of how easy
- * it is for destructuring/restructuring opts to implicitly set `undefined` values.
- *
- * If you want to force a field to not be set, you can use `{ author: noValue() }`.
- */
-export declare function noValue<T>(): T;
-/**
- * A marker value to accept values only if explicitly created-or-passed within the current,
- * unique "branch" of a factory call.
- *
- * This is useful for "diamond-shape" entity models like:
- *
- * ```
- *  ParentGroup <-- ParentItem
- *      |              |
- *   ChildGroup  <-- ChildItem
- * ```
- *
- * Where it's important that the `ChildItem -> ParentItem -> ParentGroup` path matches
- * the `ChildItem -> ChildGroup -> ParentGroup` path.
- *
- * This can be hard to achieve in normal factory behavior, i.e. for a call like:
- *
- * ```ts
- * const c = newChild(em, {
- *   groups: [
- *     { childItems: [{}, {}] },
- *     { childItems: [{}, {}] },
- *   ],
- * });
- * ```
- *
- * The first `ChildGroup` will create a new `ParentGroup` that is used by everything, which
- * is not our intent, as both `ChildGroup`s, and all four `ParentItem`s, will live in a single
- * `ParentGroup`.
- *
- * An initial idea is to pass `parentGroup: {}` in the factories, because that turns off "reusing
- * existing instances", but for this problem the `{}` approach is "too good" at creating new
- * instances, b/c the above diamond pattern will be disconnected.
- *
- * So `branchValue` provides a middle ground, where _usually_ it will be a new entity, unless
- * it was explicitly created within the same "branch" of a factory call.
- */
-export declare function maybeBranchValue<T>(opts?: ActualFactoryOpts<T>): T;
-/**
- * Allows a factory to declare that an optional relation should be filled in with an
- * "obvious default", or a new entity if one doesn't exist.
- *
- * This "obvious default or new entity" is what Joist already does for _required_ relations,
- * and so `maybeNew` lets the factory tell Joist to apply the same behavior to an optional
- * field.
- *
- * I.e.:
- *
- * ```typescript
- * export function newAuthor(em: Entity, opts: FactoryOpts<Author>) {
- *   return newTestInstance(em, Author, {
- *     // this always make a new publisher, unless explicitly overridden by the test,
- *     // i.e. when each author really needs "their own" publisher.
- *     publisher: {},
- *     // this will make a new publisher but first looks for "good defaults" in the
- *     // test, i.e. an already-created publisher. This is the default behavior of
- *     // required fields ("look for a good default"), and `maybeNew` lets you tell
- *     // Joist to invoke that same "maybe new" behavior for an optional field.
- *     publisher: maybeNew<Publisher>({}),
- *     ...opts,
- *   });
- * }
- * ```
- */
-export declare function maybeNew<T extends Entity>(opts?: ActualFactoryOpts<T>): FactoryEntityOpt<T>;
-/**
- * Similar to `maybeNew` in behaviour/use but with enhancements to support polymorphic fields:
- * 1) Allows you to specify which entity type to create, if it is found a new one is needed
- * 2) Allows you to prioritize which existing entities to select
- *
- * For example below, we are specifying that an Author should be created if needed (and optionally it's default opts
- * in the `ifNewOpts` field), and also that the priority order for choosing existing entities is Author, Book, and then Publisher.
- * Note since BookReview is excluded from `existingSearchOrder`, an existing BookReview will never be chosen.
- *
- * ```typescript
- * export function newComment(em: EntityManager, opts: FactoryOpts<Comment> = {}): New<Comment> {
- *   return newTestInstance(em, Comment, {
- *     parent: maybeNewPoly<CommentParent, Author>(
- *       Author, {
- *         ifNewOpts: { firstName: "optional"},
- *         existingSearchOrder: [Author, Book, Publisher]
- *       }),
- *     ...opts,
- *   });
- * }
- * ```
- */
-export declare function maybeNewPoly<T extends Entity, NewT extends T = T>(ifNewCstr: EntityConstructor<NewT>, opts?: {
-    ifNewOpts?: ActualFactoryOpts<NewT>;
-    existingSearchOrder?: MaybeAbstractEntityConstructor<T>[];
-}): FactoryEntityOpt<NewT>;
-/**
- * Returns a unique-ish test index for putting in `name` fields.
- *
- * Note that `testIndex` is easier to just include in a string, because it doesn't require passing
- * the `EntityManger` and `type`. But if a factory really wants the test index as a number, they can
- * call this method.
- *
- * Despite the name, these are 1-based, i.e. the first `Author` is `a1`.
- */
-export declare function getTestIndex<T extends Entity>(em: EntityManager, type: MaybeAbstractEntityConstructor<T>): number;
-type DefinedOr<T> = T | undefined | null;
-type DeepPartialOpts<T extends Entity> = AllowRelationsOrPartials<OptsOf<T>>;
-/** What a factory can accept for a given entity. */
-export type FactoryEntityOpt<T extends Entity> = T | IdOf<T> | (ActualFactoryOpts<T> & {
-    useFactoryDefaults?: boolean | "none";
-});
-type AllowRelationsOrPartials<T> = {
-    [P in keyof T]?: T[P] extends DefinedOr<infer U> ? U extends Array<infer V> ? V extends Entity ? Array<FactoryEntityOpt<V>> : T[P] : U extends Entity ? FactoryEntityOpt<U> : T[P] : T[P];
-};
-export type UseMapSource = "testOpts" | "useOpt" | "sameBranch" | "diffBranch";
-/** Enables factory logging for all factories. */
-export declare function setFactoryLogging(enabled: boolean): void;
-/** Marker for tests setting derived values during test setup. */
-export declare class FactoryInitialValue {
-    readonly value: any;
-    constructor(value: any);
-}
-export declare function isFactoryCreation(entity: Entity): boolean;
-export declare function resetFactoryCreated(): void;
-export {};
-//# sourceMappingURL=newTestInstance.d.ts.map