joist-core 2.3.0 → 2.4.0-next.2

package/build/reactiveHints.js

@@ -1,509 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.reverseReactiveHint = reverseReactiveHint;
-exports.followReverseHint = followReverseHint;
-exports.convertToLoadHint = convertToLoadHint;
-exports.isTypeOrSubType = isTypeOrSubType;
-exports.isPolyHint = isPolyHint;
-exports.splitPolyHintToKeyAndType = splitPolyHintToKeyAndType;
-exports.getRelationFromMaybePolyKey = getRelationFromMaybePolyKey;
-const BaseEntity_1 = require("./BaseEntity");
-const Entity_1 = require("./Entity");
-const EntityManager_1 = require("./EntityManager");
-const EntityMetadata_1 = require("./EntityMetadata");
-const getProperties_1 = require("./getProperties");
-const normalizeHints_1 = require("./normalizeHints");
-const relations_1 = require("./relations");
-const ReactiveGetter_1 = require("./relations/ReactiveGetter");
-const RecursiveCollection_1 = require("./relations/RecursiveCollection");
-const utils_1 = require("./utils");
-/**
- * Takes a reactive hint and returns the `ReactiveTarget`s that, should they change, need to
- * walk back to this watching reactable.
- *
- * @param rootType The original type that contained the reactive rule/field, used for helpful error messages
- * @param entityType The current entity of the step we're walking
- * @param hint The current hint we're walking
- * @param reactForOtherSide the name of our FK column, if the previous collection needs to react to our FK changing
- * @param isFirst
- */
-function reverseReactiveHint(rootType, entityType, hint, reactForOtherSide, reactForOtherSideIsReadOnly, isFirst = true) {
-    const meta = (0, EntityMetadata_1.getMetadata)(entityType);
-    // This is the list of fields for this `entityType` that we will react to their changing values
-    const fields = [];
-    const readOnlyFields = [];
-    const maybeRecursive = [];
-    // If the hint before us was a collection, i.e. { books: ["title"] }, besides just reacting
-    // to our `title` changing, `reactForOtherSide` tells us to react to our `author` field as well.
-    if (reactForOtherSide) {
-        const _fields = reactForOtherSideIsReadOnly ? readOnlyFields : fields;
-        _fields.push(reactForOtherSide);
-        if (meta.timestampFields?.deletedAt) {
-            _fields.push(meta.timestampFields.deletedAt);
-        }
-    }
-    // Look through the hint for our own fields, i.e. `["firstName", "lastName]`, and nested hints like `{ books: "title" }`.
-    const subHintTargets = Object.entries((0, normalizeHints_1.normalizeHint)(hint)).flatMap(([keyMaybeSuffix, subHint]) => {
-        return reverseSubHint(rootType, entityType, hint, meta, 
-        // Pass fields & readOnlyFields, so `reverseSubHint` can append any of our primitive fields it finds
-        fields, readOnlyFields, maybeRecursive, keyMaybeSuffix, // maybeSuffix = might end with `_ro` like `name_ro`
-        subHint);
-    });
-    const myTargets = [];
-    // If any of our primitives (or m2o fields) change, establish a reactive path from "here" (entityType)
-    // that is initially empty (path: []) but will have paths layered on by upstream callers
-    if (fields.length > 0 || isFirst || reactForOtherSideIsReadOnly === "field-read-only") {
-        myTargets.push({ kind: "update", entity: entityType, fields, path: [] });
-    }
-    // Normally read-only fields don't trigger true async reactivity, but IsLoadedCache
-    // needs them for same-EM cache invalidation.
-    if (readOnlyFields.length > 0) {
-        myTargets.push({ kind: "read-only", entity: entityType, fields: readOnlyFields, path: [] });
-    }
-    return [...myTargets, ...maybeRecursive, ...subHintTargets];
-}
-function reverseSubHint(rootType, entityType, hint, meta, fields, readOnlyFields, maybeRecursive, keyMaybeSuffix, subHint) {
-    const key = keyMaybeSuffix.replace(normalizeHints_1.suffixRe, "");
-    const field = meta.allFields[key];
-    const isReadOnly = !!keyMaybeSuffix.match(normalizeHints_1.suffixRe) || (field && field.immutable);
-    const _fields = isReadOnly ? readOnlyFields : fields;
-    if (field) {
-        switch (field.kind) {
-            case "m2o": {
-                // If this is a ReactiveReference, maybe we do something different?
-                _fields.push(field.fieldName);
-                const otherMeta = field.otherMetadata();
-                // If this is a ReactiveReference, it won't have an "other" side, which is fine if:
-                // - we're only reacting to the RR value itself (and have no sub-hints), or
-                // - all of our sub-hints are read-only
-                const otherField = otherMeta.allFields[field.otherFieldName];
-                if (!otherField && !isAllReadOnly(subHint)) {
-                    throw new Error(`Invalid hint in ${rootType.name}.ts, we don't currently support reacting through ReactiveReferences, ${JSON.stringify(hint)}`);
-                }
-                return reverseReactiveHint(rootType, otherMeta.cstr, subHint, undefined, false, false).map(appendPath(maybeAddTypeFilterSuffix(meta, field)));
-            }
-            case "poly": {
-                _fields.push(field.fieldName);
-                // A poly is basically multiple m2os glued together, so copy/paste the `case m2o` code
-                // above but do it for each component FK, and glue them together.
-                return field.components.flatMap((comp) => {
-                    return reverseReactiveHint(rootType, comp.otherMetadata().cstr, subHint, undefined, false, false).map(appendPath(maybeAddTypeFilterSuffix(meta, comp)));
-                });
-            }
-            case "m2m": {
-                // While o2m and o2o can watch for just FK changes by passing `reactForOtherSide` (the FK lives in the other
-                // table), for m2m reactivity we push the collection name into the reactive hint, because it's effectively
-                // "the other/reverse side", and JoinRows will trigger `queueDownstreamReactables` explicitly, instead of
-                // `setField` which handles regular/non-m2m mutations.
-                _fields.push(field.fieldName);
-                const otherFieldName = maybeAddTypeFilterSuffix(meta, field);
-                return reverseReactiveHint(rootType, field.otherMetadata().cstr, subHint, 
-                // For m2m, we can always pass undefined here, as otherwise having the opposite m2m collection
-                // recalc all of its children will cause over-reactivity
-                undefined, false, false).map(appendPath(otherFieldName));
-            }
-            case "o2m":
-            case "o2o": {
-                const isOtherReadOnly = field.otherMetadata().allFields[field.otherFieldName].immutable;
-                const otherFieldName = maybeAddTypeFilterSuffix(meta, field);
-                // This is not a field, but we want our reverse side to be reactive, so pass reactForOtherSide
-                return reverseReactiveHint(rootType, field.otherMetadata().cstr, subHint, 
-                // IsLoadedCache invalidation always needs to know the otherField name, so we must
-                // end up with either a kind=update or kind=read-only target with `otherFieldName` in it.
-                field.otherFieldName, 
-                // We can have three outcomes:
-                // - kind=update fields=[otherFieldName] (normal behavior)
-                // - kind=update fields=[] + kind=read-only fields=[otherFieldName] (isOtherReadOnly)
-                // - kind=read-only fields=[otherFieldName] (hint isReadOnly)
-                isReadOnly ? "hint-read-only" : isOtherReadOnly ? "field-read-only" : false, false).map(appendPath(otherFieldName));
-            }
-            case "primaryKey":
-            case "primitive":
-            case "enum":
-                _fields.push(key);
-                return [];
-            case "m2mEnum":
-                // An enum m2m is a leaf of enum codes (no "other side" entity to recurse into); like a m2m,
-                // `JoinRows` calls `queueDownstreamReactables` explicitly when its membership changes.
-                _fields.push(key);
-                return [];
-            default:
-                throw new Error(`Invalid hint in ${rootType.name}.ts hint ${JSON.stringify(hint)}`);
-        }
-    }
-    else {
-        // We only need to look for ReactiveProperties here, because ReactiveFields & ReactiveReferences
-        // have underlying primitive fields that, when/if they change, will be handled in the ^ code.
-        //
-        // I.e. we specifically don't need to handle RFs & RRs ^, because the EntityManager.flush loop will
-        // notice their primitive values changing, and kicking off any downstream reactive fields as necessary.
-        const p = (0, getProperties_1.getProperties)(meta)[key];
-        if (p instanceof relations_1.PropertyImpl) {
-            // If the field is marked as readonly (i.e. using the `_ro` suffix), then we can assume that applies to its
-            // entire hint as well and can simply omit it. This also allows us to use non-reactive async props as long as
-            // they are readonly.
-            if (isReadOnly)
-                return [];
-            if (!p.reactiveHint) {
-                throw new Error(`Property ${key} cannot be used in reactive hints in ${rootType.name}.ts hint ${JSON.stringify(hint)}, please use hasReactiveProperty instead`);
-            }
-            return reverseReactiveHint(rootType, meta.cstr, p.reactiveHint, undefined, false, false);
-        }
-        else if (p instanceof ReactiveGetter_1.ReactiveGetterImpl) {
-            // If the field is marked as readonly, then we can assume that applies to its entire hint as well and can
-            // simply omit it.
-            if (isReadOnly)
-                return [];
-            return reverseReactiveHint(rootType, meta.cstr, p.reactiveHint, undefined, false, false);
-        }
-        else if (p instanceof RecursiveCollection_1.RecursiveParentsCollectionImpl) {
-            // I.e. if this is `Author.mentorsRecursive`:
-            // - fieldName=mentorsRecursive (being watched by the caller)
-            // - otherFieldName=menteesRecursive (our reversal for walking down)
-            // - m2oFieldName = mentor
-            //
-            // Note that "reversing parents" is generally easier, b/c when the tree changes, any given node can
-            // still "walk down" to find its children w/the "current value" childrenRecursive; and any just-now
-            // orphaned parents will themselves trigger their own childrenRecursive changes (i.e. we do not need
-            // any "old reference value" / "new reference value" handling).
-            //
-            // I.e. given a tree of `A is mentor of B is mentor of C`, when B changes mentors, and we need to
-            // "walk to all affected/children mentees, so they can observe their new mentorsRecursive", merely
-            // walking down from (b itself & it's mentees) will find all affected mentees.
-            const { otherFieldName, m2oFieldName } = p;
-            // When a mentor.firstName/etc field changes, walk to its transitive children (through otherFieldName)
-            // via the `return reverseReactiveHint` line below.
-            //
-            // But if the `author.mentor` field itself changes, we ourselves are also "a new mentee" of the mentor, so
-            // do `fields.push(m2oFieldName)` to notify our direct reactable (a new mentee), and then our transitive
-            // children/mentees. This avoids going "up to the mentor, and walking down all of his mentees", which would go
-            // through our siblings, which would not have changed/need reactivity.
-            _fields.push(m2oFieldName);
-            maybeRecursive.push({
-                kind: isReadOnly ? "read-only" : "update",
-                entity: entityType,
-                fields: [m2oFieldName],
-                path: [otherFieldName],
-            });
-            // Any reactables who were watching `parentsRecursive`, we'll back down to by going through `childrenRecursive`
-            return reverseReactiveHint(rootType, entityType, subHint, undefined, false).map(appendPath(otherFieldName));
-        }
-        else if (p instanceof RecursiveCollection_1.RecursiveChildrenCollectionImpl) {
-            const { otherFieldName, o2mFieldName } = p;
-            // I.e. this is `Author.menteesRecursive`
-            // - fieldName=menteesRecursive` (being watched by the caller)
-            // - otherFieldName=mentorsRecursive` (our reversal for walking up)
-            // - The o2m's otherFieldName gives us the FK field (e.g., "mentor") on the child entity.
-            //
-            // Note that "reversing children" is trickier than reversing parents, b/c when the tree changes,
-            // we need to consider both "old reference value" and "new reference value" scenarios.
-            const o2mField = meta.allFields[o2mFieldName];
-            const m2oFieldName = o2mField.otherFieldName;
-            _fields.push(m2oFieldName);
-            maybeRecursive.push({
-                kind: isReadOnly ? "read-only" : "update",
-                entity: entityType,
-                fields: [m2oFieldName], // i.e. parent
-                path: [otherFieldName], // i.e. parentsRecursive to tell them "observe your new childrenRecursive"
-            });
-            // Any reactables who were watching `childrenRecursive`, we'll up to by going through `parentsRecursive`
-            return reverseReactiveHint(rootType, entityType, subHint, undefined, false).map(appendPath(otherFieldName));
-        }
-        else if (p instanceof RecursiveCollection_1.RecursiveM2mCollectionImpl) {
-            // I.e. if this is `User.parentsRecursive`:
-            // - fieldName=parentsRecursive (being watched by the caller)
-            // - otherFieldName=childrenRecursive (our reversal for walking down)
-            // - m2mFieldName=parents (the underlying m2m collection)
-            //
-            // For m2m recursive, the "change signal" is when join rows are added/removed, so we push
-            // the m2m collection name into fields (like regular m2m handling). To find affected entities
-            // that are watching `parentsRecursive`, we walk through `childrenRecursive` (the reverse direction).
-            const { otherFieldName, m2mFieldName } = p;
-            // When a join row changes (e.g. parents collection is mutated), notify both this entity
-            // and its transitive children/parents via otherFieldName
-            _fields.push(m2mFieldName);
-            maybeRecursive.push({
-                kind: isReadOnly ? "read-only" : "update",
-                entity: entityType,
-                fields: [m2mFieldName],
-                path: [otherFieldName],
-            });
-            // Any reactables who were watching this recursive collection, we'll reach via the other direction
-            return reverseReactiveHint(rootType, entityType, subHint, undefined, false).map(appendPath(otherFieldName));
-        }
-        else {
-            throw new Error(`Invalid hint in ${rootType.name}.ts ${JSON.stringify(hint)}`);
-        }
-    }
-}
-function maybeAddTypeFilterSuffix(meta, field) {
-    const otherField = field.otherMetadata().allFields[field.otherFieldName];
-    if (!otherField) {
-        // This is usually an error, unless if its ReactiveReference which we don't create o2m-s for
-        const isReactiveReference = "kind" in field && field.kind === "m2o" && field.derived === "async";
-        if (!isReactiveReference)
-            (0, utils_1.fail)(`No field ${field.otherMetadata().type}.${field.otherFieldName}`);
-        return field.otherFieldName;
-    }
-    // If we're Foo, and the other field (which we'll traverse back from at runtime) is actually
-    // a poly FK pointing back to multiple `owner=Foo | Bar | Zaz`, add a suffix of `@Foo` so
-    // that any runtime traversal that hit `owner` and see a `Bar | Zaz` will stop.
-    const nextFieldIsPoly = otherField.kind === "poly";
-    // If we're a SubType, and the other field points to our base type, assume there might be
-    // SubType-specific fields in the path so far, so tell the other side to only walk back through
-    // us if its value is actually a SubType.
-    const nextFieldPointsToBaseType = !!meta.baseType && otherField.kind !== "poly" && otherField.otherMetadata().cstr !== meta.cstr;
-    return nextFieldIsPoly || nextFieldPointsToBaseType ? `${field.otherFieldName}@${meta.type}` : field.otherFieldName;
-}
-/**
- * Walks `reverseHint` for every entity in `entities`.
- *
- * I.e. given `[book1, book2]` and `["author", 'publisher"]`, will return all the books' authors' publishers.
- *
- * Note that for references (and only references), we walk both through "the current value"
- * and prior values remembered in `referenceHistory`. This is fundamentally because references are the true "owner"
- * of the relation, while collections are derived.
- *
- * For example, with reversals walking through collections:
- *
- * - Given a hint `book: { author: firstName }`
- * - Which reverses to `author[firstName] -> books`
- * - When we walk through `a1.books`, we use only the current value, which might have only `[b2]` in it.
- * - We don't need to worry about "the old a1.books" value, which might have previously had `[b1]` in it,
- *   because the `b1.author` changing authors (from `a1` to `a2`) will trigger its own reactivity.
- *
- * Contrast with reversals walking through references:
- *
- * - Given a hint `author: { books: "title" }`
- * - Which reverses to `book[title] -> author`
- * - When we traverse through `b1.author`, we use both the current value and remembered values, so that both
- *   "our prior authors" and "our new author" see their latest `author.books` collection values.
- *
- * Delete cleanup runs before reverse hints are walked, so the current relation value may already be unset by the
- * time we get here. For persisted entities, `cleanupOnEntityDeleted` clears the owning FK via `setField`, which
- * remembers the prior FK in `referenceHistory`; this lets us still find the old owner. For collection reversals
- * this is enough because collections are derived from the owning FK: removing `b1` from `a1.books` is represented
- * by `b1.author` changing, not by an independent "old books" snapshot.
- *
- * References can also have transient values during a unit of work, i.e. a ReactiveField might observe `b1.author=a2`
- * before the final flush changes it to `a3`. `setField` remembers both original and transient reference values
- * separately from `originalData`, and we walk them in addition to the current value.
- */
-async function followReverseHint(reactionName, entities, reverseHint) {
-    // Start at the current (unique) entities
-    let current = new Set(entities);
-    const paths = [...reverseHint];
-    // And "walk backwards" through the reverse hint
-    while (paths.length) {
-        const path = paths.shift();
-        const [fieldName, viaType] = path.split("@");
-        const promises = new Array(current.size);
-        // The path might touch either a reference or a collection
-        for (const c of current) {
-            const relation = c[fieldName];
-            // If `!relation`, I'd really like to `fail`, but atm we're knowingly creating invalid reversals for when
-            // a ReactiveField depends on a ReactiveReference; b/c RRs lack an "other side", we cannot walk them in
-            // reverse, and so for awhile we "supported" the RF -> RR pattern by relying on a totally-read-only reactive
-            // hint -> dropped during reversal.
-            //
-            // However, now IsLoadedCache means that even these "totally read only" RFs need to be reactive at least
-            // during their initial EM creation, to avoid stale values being observed during first-flush mutations,
-            // and so we're now stuck with these "invalid RR reversals" until we can figure out a better way to handle them.
-            // (Now that IsLoadedCache doesn't technically walk paths, it just invalidates given entity+field pairs, so
-            // it is not bothered by an invalid/missing RR reversal.)
-            if (!relation)
-                continue;
-            // fail(`Attempting to react for ${reactionName} for ${c.toString()}, but there is no "reverse walkable" field ${c.constructor.name}.${fieldName}`,);
-            const currentValuePromise = maybeApplyTypeFilter(relation.load(), viaType);
-            // Always wait for the relation itself
-            promises.push(currentValuePromise);
-            // If we're going from Book.author back to Author to re-validate the Author.books collection,
-            // see if Book.author has changed, so we can re-validate both the old author's books and the
-            // new author's books.
-            const fieldKind = (0, EntityMetadata_1.getMetadata)(c).fields[fieldName]?.kind;
-            const isReference = fieldKind === "m2o" || fieldKind === "poly";
-            const isManyToMany = fieldKind === "m2m";
-            // See jsdoc comment about why this is only necessary for references...
-            if (isReference) {
-                for (const value of (0, BaseEntity_1.getInstanceData)(c).getReferenceHistory(fieldName)) {
-                    promises.push(maybeApplyTypeFilter(loadReferenceHistoryValue(c, value), viaType));
-                }
-            }
-            if (isManyToMany) {
-                const m2m = c[fieldName];
-                const joinRows = (0, EntityManager_1.getEmInternalApi)(m2m.entity.em).joinRows(m2m);
-                // Return a tuple of [currentRows, removedRows]
-                promises.push(joinRows.removedFor(m2m, c));
-            }
-            // Walk up the old parents
-            if (relation instanceof RecursiveCollection_1.RecursiveParentsCollectionImpl) {
-                const { m2oFieldName } = relation;
-                for (const value of (0, BaseEntity_1.getInstanceData)(c).getReferenceHistory(m2oFieldName)) {
-                    promises.push(
-                    // First load the old parent itself
-                    loadReferenceHistoryValue(c, value).then((oldParent) => {
-                        if (!oldParent)
-                            return undefined;
-                        // And then resolve its fieldName=parentsRecursive
-                        const oldParentRecursiveParents = oldParent[fieldName];
-                        return oldParentRecursiveParents.load().then((parents) => {
-                            return [oldParent, ...parents];
-                        });
-                    }));
-                }
-            }
-        }
-        const nextLevel = await Promise.all(promises);
-        // Make a new set so that we dedupe as we go
-        current = (0, utils_1.flatAndUnique)(nextLevel);
-    }
-    return [...current];
-}
-/** Converts a normalized reactive `hint` into a load hint. */
-function convertToLoadHint(meta, hint, allowCustomKeys = false) {
-    const loadHint = {};
-    // Process the hints individually instead of just calling Object.fromEntries so that
-    // we can handle inlined reactive hints that overlap.
-    for (const [keyMaybeSuffix, subHint] of Object.entries((0, normalizeHints_1.normalizeHint)(hint))) {
-        let key = keyMaybeSuffix.replace(normalizeHints_1.suffixRe, "");
-        let field = meta.allFields[key];
-        // If `allowCustomKeys` is enabled, we're probably doing `toJSON`,
-        // so look for `companyId` & `companyIds` to turn into `company`
-        if (!field && allowCustomKeys) {
-            const realField = Object.values(meta.allFields).find((f) => f.fieldIdName === key);
-            if (realField) {
-                field = realField;
-                key = realField.fieldName;
-            }
-        }
-        if (field) {
-            switch (field.kind) {
-                case "m2m":
-                case "m2o":
-                case "o2m":
-                case "o2o":
-                    (0, utils_1.mergeNormalizedHints)(loadHint, { [key]: convertToLoadHint(field.otherMetadata(), subHint, allowCustomKeys) });
-                    break;
-                case "poly":
-                    for (const comp of field.components) {
-                        // Write `{ parent: { child@Type: hint } }` into the load hint
-                        (0, utils_1.mergeNormalizedHints)(loadHint, {
-                            [key]: Object.fromEntries(Object.entries(convertToLoadHint(comp.otherMetadata(), subHint, allowCustomKeys)).map(
-                            // Map the subHint keys to add in `@Type`
-                            ([subKey, subHint]) => [`${subKey}@${comp.otherMetadata().type}`, subHint])),
-                        });
-                    }
-                    break;
-                case "primitive":
-                case "enum":
-                    if (field.derived === "async") {
-                        (0, utils_1.mergeNormalizedHints)(loadHint, { [key]: {} });
-                    }
-                    continue;
-                case "m2mEnum":
-                    // The enum codes are a leaf, but the collection itself must be loaded for the reaction to read it.
-                    (0, utils_1.mergeNormalizedHints)(loadHint, { [key]: {} });
-                    break;
-                case "primaryKey":
-                    continue;
-                default:
-                    throw new Error(`Invalid reactive hint ${meta.tableName} ${JSON.stringify(hint)}`);
-            }
-        }
-        else {
-            const p = (0, getProperties_1.getProperties)(meta)[key];
-            if (p instanceof RecursiveCollection_1.RecursiveParentsCollectionImpl) {
-                (0, utils_1.mergeNormalizedHints)(loadHint, { [p.fieldName]: convertToLoadHint(meta, subHint, allowCustomKeys) });
-            }
-            else if (p instanceof RecursiveCollection_1.RecursiveChildrenCollectionImpl) {
-                (0, utils_1.mergeNormalizedHints)(loadHint, { [p.fieldName]: convertToLoadHint(meta, subHint, allowCustomKeys) });
-            }
-            else if (p instanceof RecursiveCollection_1.RecursiveM2mCollectionImpl) {
-                (0, utils_1.mergeNormalizedHints)(loadHint, { [p.fieldName]: convertToLoadHint(meta, subHint, allowCustomKeys) });
-            }
-            else if (p && p.reactiveHint) {
-                (0, utils_1.mergeNormalizedHints)(loadHint, convertToLoadHint(meta, p.reactiveHint, allowCustomKeys));
-            }
-            else if (!allowCustomKeys) {
-                (0, utils_1.fail)(`Invalid reactive hint on ${meta.tableName} ${JSON.stringify(hint)}`);
-            }
-        }
-    }
-    return loadHint;
-}
-function maybeApplyTypeFilter(loadPromise, viaType) {
-    if (viaType) {
-        return loadPromise.then((loaded) => {
-            if (Array.isArray(loaded)) {
-                return loaded.filter((e) => isTypeOrSubType(e, viaType));
-            }
-            else if (loaded && isTypeOrSubType(loaded, viaType)) {
-                return loaded;
-            }
-            else {
-                return undefined;
-            }
-        });
-    }
-    return loadPromise;
-}
-/** Loads a remembered reference value so reverse-hint walking can revisit it. */
-function loadReferenceHistoryValue(entity, value) {
-    if ((0, Entity_1.isEntity)(value))
-        return Promise.resolve(value);
-    if ((0, EntityManager_1.isId)(value))
-        return entity.em.load(value);
-    return Promise.resolve(undefined);
-}
-/** Returns true if `entity` is exactly `typeName` or a subtype of `typeName`.
- *
- * Used to honor poly/type filters like `@Publisher` during reverse-hint walks:
- * a `SmallPublisher` entity should pass an `@Publisher` filter because it is
- * a Publisher via inheritance.
- */
-function isTypeOrSubType(entity, typeName) {
-    const meta = (0, EntityMetadata_1.getMetadata)(entity);
-    return meta.type === typeName || meta.baseTypes.some((b) => b.type === typeName);
-}
-function isPolyHint(key) {
-    return key.includes("@");
-}
-function splitPolyHintToKeyAndType(key) {
-    const [k, type] = key.split("@");
-    return [k, type];
-}
-/** If this hint is a poly like `author@Book`, return the type, otherwise return undefined. */
-function getRelationFromMaybePolyKey(entity, key) {
-    if (isPolyHint(key)) {
-        const [realKey, typeName] = splitPolyHintToKeyAndType(key);
-        // Even though `entity[realKey]` might exist, if it's from a different poly type, we don't want it
-        const isApplicable = (0, EntityMetadata_1.getBaseAndSelfMetas)((0, EntityMetadata_1.getMetadata)(entity)).some((meta) => meta.type === typeName);
-        if (!isApplicable)
-            return undefined;
-        return entity[realKey];
-    }
-    else {
-        return entity[key];
-    }
-}
-/**
- * For an `author -> books -> bookReviews` hint, appends `BookReview.book`, `Book.author`,
- * i.e. the "other side" relation, to the reversed path on the way "out" from a mutated BookReview
- * to the target `Author` RF/RR/rule.
- */
-function appendPath(reverseField) {
-    return (rt) => {
-        // We can mutate this array b/c it's only owned by a single/continually-updated `ReactiveTarget`
-        rt.path = [...rt.path, reverseField];
-        return rt;
-    };
-}
-function isAllReadOnly(hint) {
-    for (const [key, subHint] of Object.entries((0, normalizeHints_1.normalizeHint)(hint))) {
-        const okay = (key.endsWith("_ro") || key.endsWith(":ro")) && isAllReadOnly(subHint);
-        if (!okay)
-            return false;
-    }
-    return true;
-}
-//# sourceMappingURL=reactiveHints.js.map

package/build/reactiveHints.js.map

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

package/build/relations/AbstractPropertyImpl.d.ts

@@ -1,8 +0,0 @@
-/** A base class for relations & non-relation (i.e. `ReactiveField) properties. */
-export declare abstract class AbstractPropertyImpl<T> {
-    #private;
-    constructor(entity: T);
-    get entity(): T;
-    abstract get isLoaded(): boolean;
-}
-//# sourceMappingURL=AbstractPropertyImpl.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"AbstractPropertyImpl.d.ts","sourceRoot":"","sources":["../../src/relations/AbstractPropertyImpl.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,8BAAsB,oBAAoB,CAAC,CAAC;;gBAG9B,MAAM,EAAE,CAAC;IAIrB,IAAI,MAAM,IAAI,CAAC,CAEd;IAED,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC;CAClC"}

package/build/relations/AbstractRelationImpl.d.ts

@@ -1,41 +0,0 @@
-import { AbstractPropertyImpl } from "./AbstractPropertyImpl";
-/**
- * Defines common hooks that relations can respond to to keep the entity graph in sync.
- */
-export declare abstract class AbstractRelationImpl<T, U> extends AbstractPropertyImpl<T> {
-    constructor(entity: T);
-    /** Called with the opts from a `new` or `em.create` call, i.e. on a new entity. */
-    abstract setFromOpts(value: U): void;
-    /** Similar to setFromOpts, but called post-construction. */
-    abstract set(value: U): void;
-    /** Whether this relation is loaded. */
-    abstract get isLoaded(): boolean;
-    /** Whether this relation is preloaded. */
-    abstract get isPreloaded(): boolean;
-    /** Loads the other side of this relation. */
-    abstract load(opts?: {
-        forceReload?: boolean;
-    }): Promise<any>;
-    /** Whether the relation from the preload cache, if preloaded. */
-    abstract preload(): void;
-    abstract get get(): U | undefined;
-    /**
-     * Called when our entity has been `em.delete`-d and then `em.flush` is being called,
-     * so we can unset any foreign keys to the being-deleted entity and clear out any pointers
-     * to it. I.e.:
-     *
-     * - `em.delete(author)`
-     * - `em.flush` loads all `author.books`
-     * - Unsets their `book.author` to let their validation rules know
-     */
-    abstract cleanupOnEntityDeleted(): Promise<void>;
-    /**
-     * Called to cascade deletes into the relation if it has cascade behavior enabled.  This function is called twice,
-     * once on the initial `EntityManager.delete` call in a potentially unloaded state, then again from a `beforeDelete`
-     * hook after the relation is fully loaded.
-     */
-    abstract maybeCascadeDelete(): void;
-    abstract get fieldName(): string;
-}
-export declare function isCascadeDelete(relation: AbstractRelationImpl<any, any>, fieldName: string): boolean;
-//# sourceMappingURL=AbstractRelationImpl.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"AbstractRelationImpl.d.ts","sourceRoot":"","sources":["../../src/relations/AbstractRelationImpl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;GAEG;AACH,8BAAsB,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,oBAAoB,CAAC,CAAC,CAAC;gBAClE,MAAM,EAAE,CAAC;IAIrB,mFAAmF;IACnF,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAEpC,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAE5B,uCAAuC;IACvC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC;IAEjC,0CAA0C;IAC1C,QAAQ,KAAK,WAAW,IAAI,OAAO,CAAC;IAEpC,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAE7D,iEAAiE;IACjE,QAAQ,CAAC,OAAO,IAAI,IAAI;IAExB,QAAQ,KAAK,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IAElC;;;;;;;;OAQG;IACH,QAAQ,CAAC,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhD;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,IAAI,IAAI;IAEnC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC;CAClC;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAIpG"}

package/build/relations/AsyncProperty.d.ts

@@ -1,36 +0,0 @@
-import { Entity } from "../Entity";
-import { AbstractPropertyImpl } from "./AbstractPropertyImpl";
-import { Property, PropertyT } from "./hasProperty";
-export interface AsyncProperty<T extends Entity, V> extends Property<T, V> {
-    load(opts?: {
-        forceReload?: boolean;
-    }): Promise<V>;
-}
-/**
- * Creates a derived value calculated from a SQL query.
- *
- * Unlike `hasProperty`, the lambda receives the entity and is expected
- * to perform its own SQL queries rather than relying on in-memory graph data.
- *
- * - For new (un-flushed) entities, `load` throws because the entity has no id yet.
- * - The result is cached until the next `em.flush`.
- */
-export declare function hasAsyncProperty<T extends Entity, V>(fn: (entity: T) => Promise<V>): Property<T, V>;
-export declare class AsyncPropertyImpl<T extends Entity, V> extends AbstractPropertyImpl<T> implements AsyncProperty<T, V> {
-    #private;
-    private fn;
-    constructor(entity: T, fn: (entity: T) => Promise<V>);
-    load(opts?: {
-        forceReload?: boolean;
-    }): Promise<V>;
-    get get(): V;
-    get isLoaded(): boolean;
-    /** Called after em.flush to invalidate the cached value. */
-    resetAfterFlush(): void;
-    [PropertyT]: T;
-}
-/** Type guard utility for determining if an entity field is an AsyncProperty. */
-export declare function isAsyncProperty(maybe: any): maybe is AsyncProperty<any, any>;
-/** Type guard utility for determining if an entity field is a loaded AsyncProperty. */
-export declare function isLoadedAsyncProperty(maybe: any): maybe is AsyncProperty<any, any>;
-//# sourceMappingURL=AsyncProperty.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"AsyncProperty.d.ts","sourceRoot":"","sources":["../../src/relations/AsyncProperty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IACxE,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAClD,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC5B,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAIhB;AAED,qBAAa,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,CAChD,SAAQ,oBAAoB,CAAC,CAAC,CAC9B,YAAW,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;;IAQ5B,OAAO,CAAC,EAAE;gBADV,MAAM,EAAE,CAAC,EACD,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;IAKvC,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAkBlD,IAAI,GAAG,IAAI,CAAC,CAMX;IAED,IAAI,QAAQ,IAAI,OAAO,CAGtB;IAED,4DAA4D;IAC5D,eAAe,IAAI,IAAI;IAMvB,CAAC,SAAS,CAAC,EAAuB,CAAC,CAAC;CACrC;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAE5E;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAElF"}