joist-orm 1.294.0 → 2.0.1

package/build/relations/ReactiveField.d.ts

@@ -1,87 +0,0 @@
-import { Entity } from "../Entity";
-import { PrimitiveField } from "../EntityMetadata";
-import { IsLoadedCachable } from "../IsLoadedCache";
-import { Reacted, ReactiveHint } from "../reactiveHints";
-import { AbstractPropertyImpl } from "./AbstractPropertyImpl";
-import { AsyncPropertyT } from "./hasAsyncProperty";
-/**
- * A `ReactiveField` is a value that is derived from other entities/values,
- * similar to an `AsyncProperty`, but it is also persisted in the database.
- *
- * This allows callers (or SQL queries) to access the value without first calling
- * `await load()` on the property.
- *
- * So, unlike `AsyncProperty`, `.get` is always available; if the property is unloaded,
- * then `.get` will return the last-calculated value, but if the property is loaded,
- * then it will go ahead and invoke function to calculate the latest value (i.e. so
- * that you can observe the latest & greatest value w/o waiting for `em.flush` to
- * re-calc the value while persisting to the database.
- */
-export interface ReactiveField<T extends Entity, V> {
-    [AsyncPropertyT]: T;
-    isLoaded: boolean;
-    isSet: boolean;
-    /**
-     * Calculates the latest derived value.
-     *
-     * Users are not required to call this method explicitly, as Joist will keep the
-     * persisted value automatically in-sync, but if for some reason (code changes,
-     * bug fixes, etc.) you need to trigger an explicit recalc, you can call `.load()`,
-     * any dependent data will be loaded from the database, and the latest value
-     * returned, and then later stored to the database on `em.flush`.
-     *
-     * Note that persisted properties used in load hints, i.e. `em.populate`s that
-     * accidentally list reactive fields (instead of just relations) will not have
-     * `.load()` invoked, and will instead use the previously-calculated value.
-     * The rationale is that one persisted property should be able to declare its
-     * dependency on another persisted property (for its reactive field-level hint)
-     * without causing that dependent property's populate hint to itself be loaded.
-     */
-    load(opts?: {
-        forceReload?: boolean;
-    }): Promise<V>;
-    /** If loaded, returns the latest derived value, or if unload returns the previously-calculated value. */
-    get: V;
-    /**
-     * Returns the as-of-last-flush previously-calculated value.
-     *
-     * This is useful if you have to purposefully avoid using the lambda to calc the latest value,
-     * i.e. if you're in a test and want to watch a calculated value change from some dummy value
-     * to the new derived value.
-     * */
-    fieldValue: V;
-}
-/**
- * Creates a calculated derived value from a load hint + lambda.
- *
- * The property can be accessed by default as a promise, with `someProperty.load()`.
- *
- * But if `someProperty` is used as a populate hint, then it can be accessed synchronously,
- * with `someProperty.get`.
- */
-export declare function hasReactiveField<T extends Entity, const H extends ReactiveHint<T>, V>(hint: H, fn: (entity: Reacted<T, H>) => V): ReactiveField<T, V>;
-export declare class ReactiveFieldImpl<T extends Entity, H extends ReactiveHint<T>, V> extends AbstractPropertyImpl<T> implements ReactiveField<T, V>, IsLoadedCachable {
-    #private;
-    private fn;
-    constructor(entity: T, field: PrimitiveField, reactiveHint: H, fn: (entity: Reacted<T, H>) => V);
-    load(opts?: {
-        forceReload?: boolean;
-    }): Promise<V>;
-    /** Returns either the latest calculated value (if loaded) or the previously-calculated value (if not loaded). */
-    get get(): V;
-    get fieldName(): keyof T & string;
-    get reactiveHint(): H;
-    get fieldValue(): V;
-    get isSet(): boolean;
-    get isLoaded(): boolean;
-    resetIsLoaded(): void;
-    get loadHint(): any;
-    setFactoryValue(newValue: any): void;
-    [AsyncPropertyT]: T;
-    private resetCacheUnlessFactoryPinned;
-}
-/** Type guard utility for determining if an entity field is an AsyncProperty. */
-export declare function isReactiveField(maybeAsyncProperty: any): maybeAsyncProperty is ReactiveField<any, any>;
-/** Type guard utility for determining if an entity field is a loaded AsyncProperty. */
-export declare function isLoadedAsyncProperty(maybeAsyncProperty: any): maybeAsyncProperty is ReactiveField<any, any>;
-//# sourceMappingURL=ReactiveField.d.ts.map

package/build/relations/ReactiveField.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ReactiveField.d.ts","sourceRoot":"","sources":["../../src/relations/ReactiveField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAe,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAqB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC;IAChD,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IAEf;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEnD,yGAAyG;IACzG,GAAG,EAAE,CAAC,CAAC;IAEP;;;;;;SAMK;IACL,UAAU,EAAE,CAAC,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EACnF,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAC/B,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAKrB;AAED,qBAAa,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAC3E,SAAQ,oBAAoB,CAAC,CAAC,CAC9B,YAAW,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,gBAAgB;;IAa9C,OAAO,CAAC,EAAE;gBAHV,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,cAAc,EACrB,YAAY,EAAE,CAAC,EACP,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;IAOpC,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IA2BxD,iHAAiH;IACjH,IAAI,GAAG,IAAI,CAAC,CAwBX;IAED,IAAI,SAAS,IAAI,MAAM,CAAC,GAAG,MAAM,CAEhC;IAED,IAAI,YAAY,IAAI,CAAC,CAEpB;IAED,IAAI,UAAU,IAAI,CAAC,CAElB;IAED,IAAI,KAAK,YAER;IAED,IAAI,QAAQ,YAMX;IAED,aAAa,IAAI,IAAI;IAOrB,IAAI,QAAQ,IAAI,GAAG,CAGlB;IAED,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI;IAKpC,CAAC,cAAc,CAAC,EAAuB,CAAC,CAAC;IAEzC,OAAO,CAAC,6BAA6B;CAKtC;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,kBAAkB,EAAE,GAAG,GAAG,kBAAkB,IAAI,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAEtG;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,kBAAkB,EAAE,GAAG,GAAG,kBAAkB,IAAI,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAE5G"}

package/build/relations/ReactiveField.js

@@ -1,149 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReactiveFieldImpl = void 0;
-exports.hasReactiveField = hasReactiveField;
-exports.isReactiveField = isReactiveField;
-exports.isLoadedAsyncProperty = isLoadedAsyncProperty;
-const EntityManager_1 = require("../EntityManager");
-const EntityMetadata_1 = require("../EntityMetadata");
-const fields_1 = require("../fields");
-const index_1 = require("../index");
-const newEntity_1 = require("../newEntity");
-const reactiveHints_1 = require("../reactiveHints");
-const AbstractPropertyImpl_1 = require("./AbstractPropertyImpl");
-const hasAsyncProperty_1 = require("./hasAsyncProperty");
-/**
- * Creates a calculated derived value from a load hint + lambda.
- *
- * The property can be accessed by default as a promise, with `someProperty.load()`.
- *
- * But if `someProperty` is used as a populate hint, then it can be accessed synchronously,
- * with `someProperty.get`.
- */
-function hasReactiveField(hint, fn) {
-    return (0, newEntity_1.lazyField)((entity, fieldName) => {
-        const field = (0, EntityMetadata_1.getMetadata)(entity).allFields[fieldName];
-        return new ReactiveFieldImpl(entity, field, hint, fn);
-    });
-}
-class ReactiveFieldImpl extends AbstractPropertyImpl_1.AbstractPropertyImpl {
-    fn;
-    #field;
-    #reactiveHint;
-    #loadPromise;
-    // Initially undefined, then cached as true/false
-    #isLoaded;
-    #isCached = false;
-    constructor(entity, field, reactiveHint, fn) {
-        super(entity);
-        this.fn = fn;
-        this.#field = field;
-        this.#reactiveHint = reactiveHint;
-    }
-    async load(opts) {
-        // Even without `forceReload=true`, any explicit calls to `.load()` ==> ensure a fresh value,
-        // because `.get` may have cached the stale/previously-calculated value.
-        //
-        // (Currently `em.populate` / `populateDataLoader` has a hack/escape hatch that ignores calling
-        // RF.load(), to avoid pulling in the RF subgraph over using the materialized value, which ideally would be
-        // replaced with us learning to do the maybeDirty approach.)
-        if (!this.isLoaded || opts?.forceReload) {
-            return (this.#loadPromise ??= this.entity.em.populate(this.entity, { hint: this.loadHint }).then(() => {
-                this.#loadPromise = undefined;
-                this.#isLoaded = true;
-                (0, EntityManager_1.getEmInternalApi)(this.entity.em).isLoadedCache.add(this);
-                // Wait and reset `#isCached` until inside this `then`, so that we don't have a race condition where:
-                // - two relations (us and someone else) are both passed to `em.calc`
-                // - their load hint is simpler, so their promises resolves first, and their `.get` calls our `.get`
-                // - our `.get` sees we're not loaded, but calls `fieldValue` for the existing value, and dutifully sets `#isCached=true`
-                // - finally our promise runs, and if we didn't immediately set `#isCached=false` here, our `.get` would again
-                //   early return and keep using the stale fieldValue.
-                this.resetCacheUnlessFactoryPinned();
-                // Go through `this.get` so that `setField` is called to set our latest value
-                return this.get;
-            }));
-        }
-        this.resetCacheUnlessFactoryPinned();
-        return this.get;
-    }
-    /** Returns either the latest calculated value (if loaded) or the previously-calculated value (if not loaded). */
-    get get() {
-        const { fn } = this;
-        // Some ReactiveFields can have surprisingly expensive calculations, especially in loops
-        // or those that invoke loops, so cache the value.
-        if (this.#isCached)
-            return this.fieldValue;
-        // isLoaded will watch for our previously-loaded subgraph being mutated (isLoaded is locally cached but hooked into
-        // our IsLoadedCache cache that is immediately invalidated on write-path), and if we've drifted to not-loaded, it's
-        // better to fail and tell the user.
-        if (this.isLoaded) {
-            const newValue = fn(this.entity);
-            if (!(0, EntityManager_1.getEmInternalApi)(this.entity.em).isValidating) {
-                // setField will immediately invalidate downstream #isLoaded/#isCached values
-                (0, fields_1.setField)(this.entity, this.fieldName, newValue);
-                this.#isCached = true;
-                (0, EntityManager_1.getEmInternalApi)(this.entity.em).isLoadedCache.add(this);
-            }
-            return newValue;
-        }
-        else if (this.isSet) {
-            this.#isCached = true;
-            (0, EntityManager_1.getEmInternalApi)(this.entity.em).isLoadedCache.add(this);
-            return this.fieldValue;
-        }
-        else {
-            throw new Error(`${this.fieldName} has not been derived yet`);
-        }
-    }
-    get fieldName() {
-        return this.#field.fieldName;
-    }
-    get reactiveHint() {
-        return this.#reactiveHint;
-    }
-    get fieldValue() {
-        return (0, fields_1.getField)(this.entity, this.fieldName);
-    }
-    get isSet() {
-        return (0, fields_1.isFieldSet)(this.entity, this.fieldName);
-    }
-    get isLoaded() {
-        // Skip an expensive isLoaded(subgraph) call if no mutations have happened
-        if (this.#isLoaded !== undefined)
-            return this.#isLoaded;
-        this.#isLoaded = (0, index_1.isLoaded)(this.entity, this.loadHint);
-        (0, EntityManager_1.getEmInternalApi)(this.entity.em).isLoadedCache.add(this);
-        return this.#isLoaded;
-    }
-    resetIsLoaded() {
-        // Even though we reset this on every mutation, `isLoaded` will still realize when the subgraph
-        // is still loaded (as it did before we added caching), so users won't see false positive.
-        this.#isLoaded = undefined;
-        this.resetCacheUnlessFactoryPinned();
-    }
-    get loadHint() {
-        const meta = (0, EntityMetadata_1.getMetadata)(this.entity);
-        return (meta.config.__data.cachedReactiveLoadHints[this.fieldName] ??= (0, reactiveHints_1.convertToLoadHint)(meta, this.reactiveHint));
-    }
-    setFactoryValue(newValue) {
-        (0, fields_1.setField)(this.entity, this.fieldName, newValue);
-        this.#isCached = "factory-value";
-    }
-    [hasAsyncProperty_1.AsyncPropertyT] = undefined;
-    resetCacheUnlessFactoryPinned() {
-        // If factories asked for a hard-coded value, don't reset the cached flag
-        if (this.#isCached === "factory-value")
-            return;
-        this.#isCached = false;
-    }
-}
-exports.ReactiveFieldImpl = ReactiveFieldImpl;
-/** Type guard utility for determining if an entity field is an AsyncProperty. */
-function isReactiveField(maybeAsyncProperty) {
-    return maybeAsyncProperty instanceof ReactiveFieldImpl;
-}
-/** Type guard utility for determining if an entity field is a loaded AsyncProperty. */
-function isLoadedAsyncProperty(maybeAsyncProperty) {
-    return isReactiveField(maybeAsyncProperty) && maybeAsyncProperty.isLoaded;
-}
-//# sourceMappingURL=ReactiveField.js.map

package/build/relations/ReactiveField.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ReactiveField.js","sourceRoot":"","sources":["../../src/relations/ReactiveField.ts"],"names":[],"mappings":";;;AAoEA,4CAQC;AAiID,0CAEC;AAGD,sDAEC;AAnND,oDAAoD;AACpD,sDAAgE;AAChE,sCAA2D;AAC3D,oCAAoC;AAEpC,4CAAyC;AACzC,oDAA4E;AAC5E,iEAA8D;AAC9D,yDAAoD;AAmDpD;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAC9B,IAAO,EACP,EAAgC;IAEhC,OAAO,IAAA,qBAAS,EAAC,CAAC,MAAS,EAAE,SAAS,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,IAAA,4BAAW,EAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAmB,CAAC;QACzE,OAAO,IAAI,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAa,iBACX,SAAQ,2CAAuB;IAcrB;IAXD,MAAM,CAAiB;IACvB,aAAa,CAAI;IAC1B,YAAY,CAAM;IAClB,iDAAiD;IACjD,SAAS,CAAsB;IAC/B,SAAS,GAA8B,KAAK,CAAC;IAE7C,YACE,MAAS,EACT,KAAqB,EACrB,YAAe,EACP,EAAgC;QAExC,KAAK,CAAC,MAAM,CAAC,CAAC;QAFN,OAAE,GAAF,EAAE,CAA8B;QAGxC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAgC;QACzC,6FAA6F;QAC7F,wEAAwE;QACxE,EAAE;QACF,+FAA+F;QAC/F,2GAA2G;QAC3G,4DAA4D;QAC5D,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,EAAE,WAAW,EAAE,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC3G,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;gBAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,IAAA,gCAAgB,EAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACzD,qGAAqG;gBACrG,qEAAqE;gBACrE,oGAAoG;gBACpG,yHAAyH;gBACzH,8GAA8G;gBAC9G,sDAAsD;gBACtD,IAAI,CAAC,6BAA6B,EAAE,CAAC;gBACrC,6EAA6E;gBAC7E,OAAO,IAAI,CAAC,GAAG,CAAC;YAClB,CAAC,CAAC,CAAC,CAAC;QACN,CAAC;QACD,IAAI,CAAC,6BAA6B,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,iHAAiH;IACjH,IAAI,GAAG;QACL,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;QACpB,wFAAwF;QACxF,kDAAkD;QAClD,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC;QAC3C,mHAAmH;QACnH,mHAAmH;QACnH,oCAAoC;QACpC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,QAAQ,GAAG,EAAE,CAAC,IAAI,CAAC,MAAuB,CAAC,CAAC;YAClD,IAAI,CAAC,IAAA,gCAAgB,EAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;gBACnD,6EAA6E;gBAC7E,IAAA,iBAAQ,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;gBAChD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,IAAA,gCAAgB,EAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAA,gCAAgB,EAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC,UAAU,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,2BAA2B,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,SAA6B,CAAC;IACnD,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAA,iBAAQ,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAA,mBAAU,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,QAAQ;QACV,0EAA0E;QAC1E,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QACxD,IAAI,CAAC,SAAS,GAAG,IAAA,gBAAQ,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAA,gCAAgB,EAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,aAAa;QACX,+FAA+F;QAC/F,0FAA0F;QAC1F,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,6BAA6B,EAAE,CAAC;IACvC,CAAC;IAED,IAAI,QAAQ;QACV,MAAM,IAAI,GAAG,IAAA,4BAAW,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,IAAA,iCAAiB,EAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IACrH,CAAC;IAED,eAAe,CAAC,QAAa;QAC3B,IAAA,iBAAQ,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,GAAG,eAAe,CAAC;IACnC,CAAC;IAED,CAAC,iCAAc,CAAC,GAAG,SAAqB,CAAC;IAEjC,6BAA6B;QACnC,yEAAyE;QACzE,IAAI,IAAI,CAAC,SAAS,KAAK,eAAe;YAAE,OAAO;QAC/C,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;CACF;AA5HD,8CA4HC;AAED,iFAAiF;AACjF,SAAgB,eAAe,CAAC,kBAAuB;IACrD,OAAO,kBAAkB,YAAY,iBAAiB,CAAC;AACzD,CAAC;AAED,uFAAuF;AACvF,SAAgB,qBAAqB,CAAC,kBAAuB;IAC3D,OAAO,eAAe,CAAC,kBAAkB,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC;AAC5E,CAAC"}

package/build/relations/ReactiveGetter.d.ts

@@ -1,30 +0,0 @@
-import { Entity } from "../Entity";
-import { Reacted, ShallowReactiveHint } from "../reactiveHints";
-import { AsyncPropertyT } from "./hasAsyncProperty";
-/**
- * A `ReactiveGetter` is a getter that declares what primitive fields it depends on.
- *
- * This is very similar to a `ReactiveAsyncProperty`, except because it's limited to
- * only immediate fields on the entity, it can always have `.get` called, and doesn't
- * need to be loaded.
- *
- * The benefit over a pure getter is that `ReactiveGetter` can be used in reactive
- * rules and reactive fields, which would otherwise need to use `fullNonReactiveAccess`
- * to access getter, and risk missing reactivity.
- */
-export interface ReactiveGetter<T extends Entity, V> {
-    [AsyncPropertyT]: T;
-    get: V;
-}
-/** Creates a `ReactiveGetter`, for simple "getters" that still trackable for reactivity. */
-export declare function hasReactiveGetter<T extends Entity, const H extends ShallowReactiveHint<T>, V>(fieldName: keyof T & string, hint: H, fn: (entity: Reacted<T, H>) => V): ReactiveGetter<T, V>;
-export declare class ReactiveGetterImpl<T extends Entity, const H extends ShallowReactiveHint<T>, V> implements ReactiveGetter<T, V> {
-    #private;
-    constructor(entity: T, fieldName: keyof T & string, hint: H, fn: (entity: Reacted<T, H>) => V);
-    get get(): V;
-    get reactiveHint(): H;
-    [AsyncPropertyT]: T;
-}
-/** Type guard utility for determining if an entity field is an AsyncProperty. */
-export declare function isReactiveGetter(maybeReactiveGetter: any): maybeReactiveGetter is ReactiveGetter<any, any>;
-//# sourceMappingURL=ReactiveGetter.d.ts.map

package/build/relations/ReactiveGetter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ReactiveGetter.d.ts","sourceRoot":"","sources":["../../src/relations/ReactiveGetter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC;IACjD,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IACpB,GAAG,EAAE,CAAC,CAAC;CACR;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,EAC3F,SAAS,EAAE,MAAM,CAAC,GAAG,MAAM,EAC3B,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAC/B,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAItB;AAED,qBAAa,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CACzF,YAAW,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;;gBAOnB,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;IAO7F,IAAI,GAAG,IAAI,CAAC,CAEX;IAED,IAAI,YAAY,IAAI,CAAC,CAEpB;IAED,CAAC,cAAc,CAAC,EAAuB,CAAC,CAAC;CAC1C;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,mBAAmB,EAAE,GAAG,GAAG,mBAAmB,IAAI,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAE1G"}

package/build/relations/ReactiveGetter.js

@@ -1,38 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReactiveGetterImpl = void 0;
-exports.hasReactiveGetter = hasReactiveGetter;
-exports.isReactiveGetter = isReactiveGetter;
-const newEntity_1 = require("../newEntity");
-const hasAsyncProperty_1 = require("./hasAsyncProperty");
-/** Creates a `ReactiveGetter`, for simple "getters" that still trackable for reactivity. */
-function hasReactiveGetter(fieldName, hint, fn) {
-    return (0, newEntity_1.lazyField)((entity, fieldName) => {
-        return new ReactiveGetterImpl(entity, fieldName, hint, fn);
-    });
-}
-class ReactiveGetterImpl {
-    #entity;
-    #fieldName;
-    #hint;
-    #fn;
-    constructor(entity, fieldName, hint, fn) {
-        this.#entity = entity;
-        this.#fieldName = fieldName;
-        this.#hint = hint;
-        this.#fn = fn;
-    }
-    get get() {
-        return this.#fn(this.#entity);
-    }
-    get reactiveHint() {
-        return this.#hint;
-    }
-    [hasAsyncProperty_1.AsyncPropertyT] = undefined;
-}
-exports.ReactiveGetterImpl = ReactiveGetterImpl;
-/** Type guard utility for determining if an entity field is an AsyncProperty. */
-function isReactiveGetter(maybeReactiveGetter) {
-    return maybeReactiveGetter instanceof ReactiveGetterImpl;
-}
-//# sourceMappingURL=ReactiveGetter.js.map

package/build/relations/ReactiveGetter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ReactiveGetter.js","sourceRoot":"","sources":["../../src/relations/ReactiveGetter.ts"],"names":[],"mappings":";;;AAsBA,8CAQC;AA6BD,4CAEC;AA5DD,4CAAyC;AAEzC,yDAAoD;AAkBpD,4FAA4F;AAC5F,SAAgB,iBAAiB,CAC/B,SAA2B,EAC3B,IAAO,EACP,EAAgC;IAEhC,OAAO,IAAA,qBAAS,EAAC,CAAC,MAAS,EAAE,SAAS,EAAE,EAAE;QACxC,OAAO,IAAI,kBAAkB,CAAC,MAAM,EAAE,SAA6B,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAa,kBAAkB;IAGpB,OAAO,CAAI;IACX,UAAU,CAAmB;IAC7B,KAAK,CAAI;IACT,GAAG,CAA+B;IAE3C,YAAY,MAAS,EAAE,SAA2B,EAAE,IAAO,EAAE,EAAgC;QAC3F,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAc,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,CAAC,iCAAc,CAAC,GAAG,SAAqB,CAAC;CAC1C;AAxBD,gDAwBC;AAED,iFAAiF;AACjF,SAAgB,gBAAgB,CAAC,mBAAwB;IACvD,OAAO,mBAAmB,YAAY,kBAAkB,CAAC;AAC3D,CAAC"}

package/build/relations/ReactiveManyToMany.d.ts

@@ -1,56 +0,0 @@
-import { Entity, EntityMetadata, ManyToManyField, ReadOnlyCollection } from "..";
-import { IsLoadedCachable } from "../IsLoadedCache";
-import { MaybeReactedEntity, Reacted, ReactiveHint } from "../reactiveHints";
-import { AbstractRelationImpl } from "./AbstractRelationImpl";
-import { RelationT, RelationU } from "./Relation";
-/**
- * A reactive, derived many-to-many collection.
- *
- * Similar to `ReactiveReference` but for collections--membership is calculated from a reactive
- * function and persisted to the underlying join table.
- */
-export interface ReactiveManyToMany<T extends Entity, U extends Entity> extends ReadOnlyCollection<T, U> {
-    load(opts?: {
-        withDeleted?: boolean;
-        forceReload?: boolean;
-    }): Promise<readonly U[]>;
-}
-/** Creates a `ReactiveManyToMany`. */
-export declare function hasReactiveManyToMany<T extends Entity, U extends Entity, const H extends ReactiveHint<T>>(hint: H, fn: (entity: Reacted<T, H>) => readonly MaybeReactedEntity<U>[]): ReactiveManyToMany<T, U>;
-/** Implements ReactiveManyToMany, initially a copy/paste of ReactiveReference but for m2m. */
-export declare class ReactiveManyToManyImpl<T extends Entity, U extends Entity, H extends ReactiveHint<T>> extends AbstractRelationImpl<T, U[]> implements ReactiveManyToMany<T, U>, IsLoadedCachable {
-    #private;
-    reactiveHint: H;
-    private fn;
-    constructor(entity: T, field: ManyToManyField, reactiveHint: H, fn: (entity: Reacted<T, H>) => readonly MaybeReactedEntity<U>[]);
-    load(opts?: {
-        withDeleted?: boolean;
-        forceReload?: boolean;
-    }): Promise<ReadonlyArray<U>>;
-    get isLoaded(): boolean;
-    resetIsLoaded(): void;
-    get getWithDeleted(): U[];
-    get get(): U[];
-    set(): void;
-    get loadHint(): any;
-    setFromOpts(_others: U[]): void;
-    maybeCascadeDelete(): void;
-    cleanupOnEntityDeleted(): Promise<void>;
-    get meta(): EntityMetadata;
-    get fieldName(): string;
-    get otherMeta(): EntityMetadata;
-    get joinTableName(): string;
-    get columnName(): string;
-    get otherColumnName(): string;
-    get otherFieldName(): string;
-    get hasBeenSet(): boolean;
-    get isPreloaded(): boolean;
-    preload(): void;
-    import(other: ReactiveManyToManyImpl<T, U, H>, _: unknown, mapEntities: (e: U[] | undefined) => U[] | undefined): void;
-    toString(): string;
-    [RelationT]: T;
-    [RelationU]: U;
-}
-/** Type guard utility for determining if an entity field is a ReactiveManyToMany. */
-export declare function isReactiveManyToMany(maybeReactiveManyToMany: any): maybeReactiveManyToMany is ReactiveManyToMany<any, any>;
-//# sourceMappingURL=ReactiveManyToMany.d.ts.map

package/build/relations/ReactiveManyToMany.d.ts.map

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

package/build/relations/ReactiveManyToMany.js

@@ -1,243 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReactiveManyToManyImpl = void 0;
-exports.hasReactiveManyToMany = hasReactiveManyToMany;
-exports.isReactiveManyToMany = isReactiveManyToMany;
-const __1 = require("..");
-const manyToManyDataLoader_1 = require("../dataloaders/manyToManyDataLoader");
-const newEntity_1 = require("../newEntity");
-const reactiveHints_1 = require("../reactiveHints");
-const AbstractRelationImpl_1 = require("./AbstractRelationImpl");
-const Relation_1 = require("./Relation");
-/** Creates a `ReactiveManyToMany`. */
-function hasReactiveManyToMany(hint, fn) {
-    return (0, newEntity_1.lazyField)((entity, fieldName) => {
-        const m2m = (0, __1.getMetadata)(entity).allFields[fieldName];
-        return new ReactiveManyToManyImpl(entity, m2m, hint, fn);
-    });
-}
-/** Implements ReactiveManyToMany, initially a copy/paste of ReactiveReference but for m2m. */
-class ReactiveManyToManyImpl extends AbstractRelationImpl_1.AbstractRelationImpl {
-    reactiveHint;
-    fn;
-    #field;
-    // Could be either the ref-loaded stored array, or full-loaded calculated array
-    #loaded;
-    // In ref-mode, we use our materialized FK value (which might be undefined)
-    // If full-mode, we calculate the FK value from the subgraph
-    #loadedMode = undefined;
-    // #isLoaded doesn't necessary care if we're ref-mode or full-mode, it's just
-    // whether a caller can call `.get` and not have it blow up.
-    #isLoaded = undefined;
-    #isCached = false;
-    #loadPromise;
-    constructor(entity, field, reactiveHint, fn) {
-        super(entity);
-        this.reactiveHint = reactiveHint;
-        this.fn = fn;
-        this.#field = field;
-        (0, __1.getInstanceData)(entity).relations[this.fieldName] = this;
-    }
-    async load(opts) {
-        (0, __1.ensureNotDeleted)(this.entity, "pending");
-        const { loadHint } = this;
-        if (!this.isLoaded || opts?.forceReload) {
-            const { em } = this.entity;
-            const maybeDirty = opts?.forceReload || (0, __1.getEmInternalApi)(em).rm.isMaybePendingRecalc(this.entity, this.fieldName);
-            if (maybeDirty) {
-                this.#isCached = false;
-                return (this.#loadPromise ??= em.populate(this.entity, { hint: loadHint, ...opts }).then(() => {
-                    this.#loadPromise = undefined;
-                    this.#loadedMode = "full";
-                    this.#isLoaded = true;
-                    (0, __1.getEmInternalApi)(this.entity.em).isLoadedCache.add(this);
-                    return this.#doGet(opts);
-                }));
-            }
-            else {
-                // Load from join table (existing materialized state)
-                return (this.#loadPromise ??= this.#loadFromJoinTable().then((loaded) => {
-                    this.#loadPromise = undefined;
-                    this.#loadedMode = "ref";
-                    this.#isLoaded = true;
-                    this.#loaded = loaded;
-                    (0, __1.getEmInternalApi)(this.entity.em).isLoadedCache.add(this);
-                    return this.#filterDeleted(loaded, opts);
-                }));
-            }
-        }
-        return this.#doGet(opts);
-    }
-    get isLoaded() {
-        if (this.#isLoaded !== undefined)
-            return this.#isLoaded;
-        (0, __1.getEmInternalApi)(this.entity.em).isLoadedCache.add(this);
-        // If a WIP mutation has marked our field as potentially dirty, we need to be "full" loaded
-        const maybeDirty = (0, __1.getEmInternalApi)(this.entity.em).rm.isMaybePendingRecalc(this.entity, this.fieldName);
-        if (maybeDirty) {
-            // If we're dirty, only being "full" loaded is good enough to recalc
-            this.#loadedMode = "full";
-            this.#isLoaded = (0, __1.isLoaded)(this.entity, this.loadHint);
-            this.#isCached = false;
-        }
-        else {
-            // If we've had `.load` called before, assume we're still loaded
-            this.#isLoaded = !!this.#loadedMode;
-        }
-        return this.#isLoaded;
-    }
-    resetIsLoaded() {
-        this.#isLoaded = undefined;
-        this.#isCached = false;
-    }
-    #doGet(opts) {
-        const { fn } = this;
-        (0, __1.ensureNotDeleted)(this.entity, "pending");
-        // Fast pass if we've already calculated this (cache invalidation will happen on
-        // any mutation via #resetIsLoaded)..
-        if (this.#isCached) {
-            return this.#filterDeleted(this.#loaded ?? [], opts);
-        }
-        // Call isLoaded to probe the load hint, and get `#isLoaded` set, but still have
-        // our `if` check the raw `#isLoaded` to know if we should eval-latest or return `loaded`.
-        if (this.isLoaded && this.#loadedMode === "full") {
-            const newValue = fn(this.entity);
-            // Preserve deleted entities that were in the previous loaded value
-            const previousDeleted = (this.#loaded ?? []).filter((e) => e.isDeletedEntity);
-            for (const entity of previousDeleted) {
-                if (!newValue.includes(entity))
-                    newValue.push(entity);
-            }
-            if (!(0, __1.getEmInternalApi)(this.entity.em).isValidating) {
-                this.#syncJoinTableRows(newValue);
-            }
-            this.#loaded = newValue;
-            this.#isCached = true;
-            (0, __1.getEmInternalApi)(this.entity.em).isLoadedCache.add(this);
-        }
-        else if (!!this.#loadedMode) {
-            // We're either loadedMode=ref, or loadedMode=full (but not actually fully loaded),
-            // but in theory loadedMode only gets set in `.load()`, so we should have #loaded
-            // set to some value, even if it's not fully up-to-date.
-            this.#isCached = true;
-            (0, __1.getEmInternalApi)(this.entity.em).isLoadedCache.add(this);
-        }
-        else {
-            const noun = this.entity.isNewEntity ? "derived" : "loaded";
-            throw new Error(`${this.entity}.${this.fieldName} has not been ${noun} yet`);
-        }
-        return this.#filterDeleted(this.#loaded ?? [], opts);
-    }
-    get getWithDeleted() {
-        return this.#doGet({ withDeleted: true });
-    }
-    get get() {
-        return this.#doGet({ withDeleted: false });
-    }
-    set() {
-        (0, __1.fail)(`Cannot set ${this.entity}.${this.fieldName} ReactiveManyToMany directly.`);
-    }
-    get loadHint() {
-        const meta = (0, __1.getMetadata)(this.entity);
-        return (meta.config.__data.cachedReactiveLoadHints[this.fieldName] ??= (0, reactiveHints_1.convertToLoadHint)(meta, this.reactiveHint));
-    }
-    setFromOpts(_others) {
-        throw new Error(`ReactiveManyToMany ${this.entity}.${this.fieldName} cannot be set via opts`);
-    }
-    maybeCascadeDelete() {
-        if (this.#isCascadeDelete) {
-            const jr = (0, __1.getEmInternalApi)(this.entity.em).joinRows(this);
-            jr.getOthers(this.columnName, this.entity).forEach((e) => this.entity.em.delete(e));
-        }
-    }
-    async cleanupOnEntityDeleted() {
-        const existing = await this.load({ withDeleted: true });
-        const jr = (0, __1.getEmInternalApi)(this.entity.em).joinRows(this);
-        for (const entity of existing)
-            jr.addRemove(this, this.entity, entity);
-        this.#loaded = [];
-        this.#isLoaded = false;
-    }
-    // Properties needed for JoinRows/ManyToManyCollection compatibility
-    get meta() {
-        return (0, __1.getMetadata)(this.entity);
-    }
-    get fieldName() {
-        return this.#field.fieldName;
-    }
-    get otherMeta() {
-        return this.#field.otherMetadata();
-    }
-    get joinTableName() {
-        return this.#field.joinTableName;
-    }
-    get columnName() {
-        return this.#field.columnNames[0];
-    }
-    get otherColumnName() {
-        return this.#field.columnNames[1];
-    }
-    get otherFieldName() {
-        return this.#field.otherFieldName;
-    }
-    get hasBeenSet() {
-        return true;
-    }
-    get isPreloaded() {
-        return false;
-    }
-    preload() {
-        // No-op for now - could implement if needed
-    }
-    import(other, _, mapEntities) {
-        this.#loaded = mapEntities(other.#loaded);
-        this.#loadedMode = other.#loadedMode;
-        this.#isLoaded = other.#isLoaded ?? false;
-        // Don't set `#isCached b/c we're not registering ourselves with `isLoadedCache` yet; let
-        // the first caller to `#doGet` do that if needed.
-    }
-    toString() {
-        return `ReactiveManyToMany(entity: ${this.entity}, fieldName: ${this.fieldName}, otherMeta: ${this.otherMeta.type})`;
-    }
-    get #isCascadeDelete() {
-        return (0, AbstractRelationImpl_1.isCascadeDelete)(this, this.#field.fieldName);
-    }
-    async #loadFromJoinTable() {
-        const { em } = this.entity;
-        // Use the existing m2m dataloader by creating a compatible collection-like object
-        const key = `${this.columnName}=${this.entity.id}`;
-        const result = await (0, manyToManyDataLoader_1.manyToManyDataLoader)(em, this).load(key);
-        return result;
-    }
-    // This is like calling `setField` but for a m2m relation...
-    #syncJoinTableRows(newValue) {
-        const jr = (0, __1.getEmInternalApi)(this.entity.em).joinRows(this);
-        const newSet = new Set(newValue);
-        const oldSet = new Set(jr.getOthers(this.columnName, this.entity));
-        // Find entities to add (in new but not in old)
-        for (const entity of newValue) {
-            if (!oldSet.has(entity)) {
-                jr.addNew(this, this.entity, entity);
-            }
-        }
-        // Find entities to remove (in old but not in new)
-        for (const entity of oldSet) {
-            if (!newSet.has(entity)) {
-                jr.addRemove(this, this.entity, entity);
-            }
-        }
-    }
-    #filterDeleted(entities, opts) {
-        return opts?.withDeleted === true
-            ? [...entities]
-            : entities.filter((e) => !e.isDeletedEntity && !e.isSoftDeletedEntity);
-    }
-    [Relation_1.RelationT] = null;
-    [Relation_1.RelationU] = null;
-}
-exports.ReactiveManyToManyImpl = ReactiveManyToManyImpl;
-/** Type guard utility for determining if an entity field is a ReactiveManyToMany. */
-function isReactiveManyToMany(maybeReactiveManyToMany) {
-    return maybeReactiveManyToMany instanceof ReactiveManyToManyImpl;
-}
-//# sourceMappingURL=ReactiveManyToMany.js.map

package/build/relations/ReactiveManyToMany.js.map

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