@memberjunction/core 6.1.0-edge.5 → 6.1.0-edge.7

package/dist/generic/recordChangeFieldSecurity.d.ts

@@ -0,0 +1,164 @@
+import { EntityInfo } from "./entityInfo.js";
+import { UserInfo } from "./securityInfo.js";
+/**
+ * The two metadata lookups this projector needs, and nothing else.
+ *
+ * Narrower than `IMetadataProvider` on purpose: both `ProviderBase` (which passes `this`) and
+ * `Metadata` (which the GraphQL resolvers fall back to) satisfy this, while only the first
+ * satisfies the full provider interface. Asking for exactly what is used keeps the resolver half
+ * from having to invent a provider it does not have.
+ */
+export interface RecordChangeMetadataSource {
+    readonly Entities: EntityInfo[];
+    EntityByID(entityID: string): EntityInfo | undefined;
+}
+/**
+ * The audit entity whose rows carry OTHER entities' field values. Matched by name rather than by
+ * ID because every other enforcement point in this feature keys off the entity name too, and a
+ * name is the thing a reader can check against metadata without a lookup.
+ */
+export declare const RecordChangesEntityName = "MJ: Record Changes";
+/**
+ * The Record Change column naming the entity a row is ABOUT. Everything in this module hangs off
+ * it: it is what makes the denied set per-ROW rather than per-result.
+ */
+export declare const RecordChangeEntityIDField = "EntityID";
+/**
+ * Payload columns holding a JSON object keyed by the target entity's field names — projected
+ * key by key against the denied set. `ChangesJSON` is `{ [field]: { field, oldValue, newValue } }`;
+ * `FullRecordJSON` is a flat whole-row snapshot. Both are top-level-keyed by field name, which is
+ * what lets one projection handle them.
+ */
+export declare const RecordChangeJSONPayloadFields: readonly ["ChangesJSON", "FullRecordJSON"];
+/**
+ * The human-prose payload column — withheld outright, never redacted. See
+ * {@link RecordChangeFieldSecurityProjector}.
+ */
+export declare const RecordChangeProsePayloadField = "ChangesDescription";
+/**
+ * Every payload column this module touches, for callers that need to act on the set as a whole —
+ * notably the write guard, which must refuse a narrowed value coming back in.
+ */
+export declare const RecordChangePayloadFields: readonly string[];
+/**
+ * Outcome of projecting one JSON payload column: either a value to write back, or a decision to
+ * withhold the column entirely because the payload could not be inspected.
+ *
+ * Deliberately an interface with an optional `Value` rather than a discriminated union — MJCore
+ * compiles without `strictNullChecks`, under which TypeScript does not narrow a union on a
+ * boolean discriminant, so the union shape would force a cast at every read.
+ */
+export interface RecordChangePayloadProjection {
+    /** When true the caller drops the column; `Value` carries nothing. */
+    Withhold: boolean;
+    /** The value to write back. Meaningful only when {@link Withhold} is false. */
+    Value?: unknown;
+}
+/**
+ * Narrows one Record Change JSON payload to the fields the caller may read.
+ *
+ * **Withholds rather than guesses.** A payload that is not a string, or is a string that does not
+ * parse, or parses to something other than a plain object, is a payload this cannot prove is
+ * clean — so the column is dropped instead of passed through. A null/undefined/empty value is
+ * kept as-is: there is nothing stored to leak, and `ChangesJSON` is legitimately `''` on rows
+ * whose diff produced nothing.
+ *
+ * @param raw the column's stored value
+ * @param deniedLowercase field names the caller may not read, already lowercased
+ */
+export declare function ProjectRecordChangePayloadJSON(raw: unknown, deniedLowercase: Set<string>): RecordChangePayloadProjection;
+/**
+ * Field-level security for the payload columns of `MJ: Record Changes`.
+ *
+ * ## Why this is not `ProviderBase.ApplyFieldSecurityProjection`
+ *
+ * Every other FLS enforcement point computes the denied set against **the entity being read**. A
+ * Record Change row is about a DIFFERENT entity — the one named by its own `EntityID` column —
+ * and `MJ: Record Changes` itself has field security switched off in every default deployment.
+ * The main projection therefore short-circuits on `EnableFieldLevelSecurity` and returns the row
+ * untouched, with a denied field's old and new values sitting in `ChangesJSON` in plain text.
+ * That is the leak this closes: a user with entity-level read on the audit trail could read a
+ * salary they were denied on `MJ: Employees` straight out of it, in the default configuration.
+ *
+ * ## What happens to each column
+ *
+ * | Column | Treatment |
+ * |---|---|
+ * | `ChangesJSON` | projected — denied field keys dropped |
+ * | `FullRecordJSON` | projected — same, it is a whole-row snapshot |
+ * | `ChangesDescription` | **withheld entirely** whenever the caller is denied anything on the target entity |
+ *
+ * `ChangesDescription` is human prose ("Salary changed from 100000 to 120000"). Redacting prose
+ * on the fly leaks on the first value that appears in an unexpected form, and regenerating it
+ * from the filtered JSON is a larger surface than this is worth. Withholding the whole column is
+ * coarse and it is safe, which is the right trade for a field whose only job is to be readable
+ * text — and callers already degrade, the record-changes UI falling back to 'Changes made'.
+ *
+ * ## Rows in one result span different entities
+ *
+ * `EntityID` varies row to row, and `EntityInfo.GetDeniedReadFields` walks every field on the
+ * entity — its documented performance contract is that it must not be called in a row loop. Every
+ * lookup here is memoized on the raw `EntityID` string for the projector's lifetime, which is one
+ * request. Construct one projector per request, never one per row.
+ */
+export declare class RecordChangeFieldSecurityProjector {
+    private readonly provider;
+    private readonly user;
+    private readonly deniedByEntityID;
+    private carriesDenials;
+    private payloadKeys;
+    constructor(provider: RecordChangeMetadataSource, user: UserInfo);
+    /**
+     * Whether an entity is the audit trail this projector guards. Callers gate on this before
+     * constructing a projector, so nothing is paid on the other 99% of reads.
+     */
+    static IsRecordChangesEntity(entity: EntityInfo | null | undefined): boolean;
+    /**
+     * Projects a whole result set. Returns the ORIGINAL array when nothing needed changing, so an
+     * unrestricted caller's rows are never rebuilt — and, on the cache-hit paths, so the cache's
+     * own frozen objects are handed back by reference exactly as they are today.
+     */
+    ProjectRows<T>(rows: T[]): T[];
+    /**
+     * Single-row form, for the GraphQL read boundary. Returns the original object untouched when
+     * there is nothing to project.
+     */
+    ProjectRow<T>(row: T): T;
+    /**
+     * Whether this caller is denied ANY field on ANY field-security-enabled entity.
+     *
+     * The whole projector is a no-op for everyone else, and this gate is what makes that true —
+     * including for the fail-closed branch in {@link deniedFieldsFor}, which would otherwise blank
+     * audit rows on deployments that never enabled field security at all. Cost is one pass over
+     * the entity list plus one denied-set walk per ENABLED entity, and the flag is off on every
+     * entity an administrator has not explicitly opted in.
+     *
+     * Public because the WRITE side needs the same question: a caller who could have been served a
+     * narrowed payload must not be allowed to write one back. See
+     * `ResolverBase.StripRecordChangePayloadFromClientInput`.
+     */
+    CallerCarriesAnyDenial(): boolean;
+    private callerCarriesDenials;
+    private projectOne;
+    /**
+     * The denied-read set for the entity a Record Change row is ABOUT, or `null` to fail closed.
+     *
+     * **`null` drops all three payload columns.** Two shapes reach it and both have to. The first
+     * is an `EntityID` that no longer resolves to a known entity. The second is the one that
+     * decides the policy: a row that does not carry `EntityID` at all. A caller can ask for
+     * `Fields: ['ChangesJSON']` and nothing else, and field narrowing runs BEFORE this projection
+     * — so failing open on a missing `EntityID` would be a one-parameter bypass of the entire
+     * control.
+     *
+     * The cost of failing closed is paid only by callers who already carry denials somewhere (see
+     * {@link callerCarriesDenials}), and lands on audit rows for entities that are gone from
+     * metadata — rows for which no caller can render an entity name either way.
+     */
+    private deniedFieldsFor;
+    /**
+     * Resolves the row's actual key casing once. Returns null — cached as null — when the rows
+     * carry no payload column at all, which makes every later row a single map read.
+     */
+    private resolvePayloadKeys;
+}
+//# sourceMappingURL=recordChangeFieldSecurity.d.ts.map

package/dist/generic/recordChangeFieldSecurity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordChangeFieldSecurity.d.ts","sourceRoot":"","sources":["../../src/generic/recordChangeFieldSecurity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B;IACvC,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC;IAChC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;CACxD;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,yBAAyB,aAAa,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,4CAA6C,CAAC;AAExF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,uBAAuB,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAGtD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,WAAW,6BAA6B;IAC1C,sEAAsE;IACtE,QAAQ,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,6BAA6B,CAiCxH;AA8BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,kCAAkC;IAMvC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IANzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyC;IAC1E,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,WAAW,CAAyD;gBAGvD,QAAQ,EAAE,0BAA0B,EACpC,IAAI,EAAE,QAAQ;IAGnC;;;OAGG;WACW,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO;IAInF;;;;OAIG;IACI,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAerC;;;OAGG;IACI,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;IAO/B;;;;;;;;;;;;OAYG;IACI,sBAAsB,IAAI,OAAO;IAIxC,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,UAAU;IAiClB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,eAAe;IAkBvB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAsB7B"}

package/dist/generic/recordChangeFieldSecurity.js

@@ -0,0 +1,279 @@
+/**
+ * The audit entity whose rows carry OTHER entities' field values. Matched by name rather than by
+ * ID because every other enforcement point in this feature keys off the entity name too, and a
+ * name is the thing a reader can check against metadata without a lookup.
+ */
+export const RecordChangesEntityName = 'MJ: Record Changes';
+/**
+ * The Record Change column naming the entity a row is ABOUT. Everything in this module hangs off
+ * it: it is what makes the denied set per-ROW rather than per-result.
+ */
+export const RecordChangeEntityIDField = 'EntityID';
+/**
+ * Payload columns holding a JSON object keyed by the target entity's field names — projected
+ * key by key against the denied set. `ChangesJSON` is `{ [field]: { field, oldValue, newValue } }`;
+ * `FullRecordJSON` is a flat whole-row snapshot. Both are top-level-keyed by field name, which is
+ * what lets one projection handle them.
+ */
+export const RecordChangeJSONPayloadFields = ['ChangesJSON', 'FullRecordJSON'];
+/**
+ * The human-prose payload column — withheld outright, never redacted. See
+ * {@link RecordChangeFieldSecurityProjector}.
+ */
+export const RecordChangeProsePayloadField = 'ChangesDescription';
+/**
+ * Every payload column this module touches, for callers that need to act on the set as a whole —
+ * notably the write guard, which must refuse a narrowed value coming back in.
+ */
+export const RecordChangePayloadFields = [
+    ...RecordChangeJSONPayloadFields,
+    RecordChangeProsePayloadField,
+];
+/**
+ * Narrows one Record Change JSON payload to the fields the caller may read.
+ *
+ * **Withholds rather than guesses.** A payload that is not a string, or is a string that does not
+ * parse, or parses to something other than a plain object, is a payload this cannot prove is
+ * clean — so the column is dropped instead of passed through. A null/undefined/empty value is
+ * kept as-is: there is nothing stored to leak, and `ChangesJSON` is legitimately `''` on rows
+ * whose diff produced nothing.
+ *
+ * @param raw the column's stored value
+ * @param deniedLowercase field names the caller may not read, already lowercased
+ */
+export function ProjectRecordChangePayloadJSON(raw, deniedLowercase) {
+    if (raw === null || raw === undefined) {
+        return { Withhold: false, Value: raw };
+    }
+    if (typeof raw !== 'string') {
+        return { Withhold: true };
+    }
+    if (raw.trim().length === 0) {
+        return { Withhold: false, Value: raw };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return { Withhold: true };
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        return { Withhold: true };
+    }
+    const source = parsed;
+    const kept = {};
+    for (const key of Object.keys(source)) {
+        if (deniedLowercase.has(key.trim().toLowerCase())) {
+            continue;
+        }
+        if (isDeniedChangeEntry(source[key], deniedLowercase)) {
+            continue;
+        }
+        kept[key] = source[key];
+    }
+    return { Withhold: false, Value: JSON.stringify(kept) };
+}
+/**
+ * A `ChangesJSON` entry is `{ field, oldValue, newValue }` stored under a key that is that same
+ * field name, so the key check already catches it. This second check costs one property read and
+ * covers the case where the two disagree — a payload written by something other than
+ * `DatabaseProviderBase.DiffObjects`, or hand-edited. Where they disagree, the entry is dropped.
+ */
+function isDeniedChangeEntry(value, deniedLowercase) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const field = value['field'];
+    return typeof field === 'string' && deniedLowercase.has(field.trim().toLowerCase());
+}
+/**
+ * Field-level security for the payload columns of `MJ: Record Changes`.
+ *
+ * ## Why this is not `ProviderBase.ApplyFieldSecurityProjection`
+ *
+ * Every other FLS enforcement point computes the denied set against **the entity being read**. A
+ * Record Change row is about a DIFFERENT entity — the one named by its own `EntityID` column —
+ * and `MJ: Record Changes` itself has field security switched off in every default deployment.
+ * The main projection therefore short-circuits on `EnableFieldLevelSecurity` and returns the row
+ * untouched, with a denied field's old and new values sitting in `ChangesJSON` in plain text.
+ * That is the leak this closes: a user with entity-level read on the audit trail could read a
+ * salary they were denied on `MJ: Employees` straight out of it, in the default configuration.
+ *
+ * ## What happens to each column
+ *
+ * | Column | Treatment |
+ * |---|---|
+ * | `ChangesJSON` | projected — denied field keys dropped |
+ * | `FullRecordJSON` | projected — same, it is a whole-row snapshot |
+ * | `ChangesDescription` | **withheld entirely** whenever the caller is denied anything on the target entity |
+ *
+ * `ChangesDescription` is human prose ("Salary changed from 100000 to 120000"). Redacting prose
+ * on the fly leaks on the first value that appears in an unexpected form, and regenerating it
+ * from the filtered JSON is a larger surface than this is worth. Withholding the whole column is
+ * coarse and it is safe, which is the right trade for a field whose only job is to be readable
+ * text — and callers already degrade, the record-changes UI falling back to 'Changes made'.
+ *
+ * ## Rows in one result span different entities
+ *
+ * `EntityID` varies row to row, and `EntityInfo.GetDeniedReadFields` walks every field on the
+ * entity — its documented performance contract is that it must not be called in a row loop. Every
+ * lookup here is memoized on the raw `EntityID` string for the projector's lifetime, which is one
+ * request. Construct one projector per request, never one per row.
+ */
+export class RecordChangeFieldSecurityProjector {
+    constructor(provider, user) {
+        this.provider = provider;
+        this.user = user;
+        this.deniedByEntityID = new Map();
+        this.carriesDenials = null;
+        this.payloadKeys = undefined;
+    }
+    /**
+     * Whether an entity is the audit trail this projector guards. Callers gate on this before
+     * constructing a projector, so nothing is paid on the other 99% of reads.
+     */
+    static IsRecordChangesEntity(entity) {
+        return entity?.Name?.trim().toLowerCase() === RecordChangesEntityName.toLowerCase();
+    }
+    /**
+     * Projects a whole result set. Returns the ORIGINAL array when nothing needed changing, so an
+     * unrestricted caller's rows are never rebuilt — and, on the cache-hit paths, so the cache's
+     * own frozen objects are handed back by reference exactly as they are today.
+     */
+    ProjectRows(rows) {
+        if (!rows?.length || !this.callerCarriesDenials()) {
+            return rows;
+        }
+        let mutated = false;
+        const projected = rows.map((row) => {
+            const next = this.projectOne(row);
+            if (next !== row) {
+                mutated = true;
+            }
+            return next;
+        });
+        return mutated ? projected : rows;
+    }
+    /**
+     * Single-row form, for the GraphQL read boundary. Returns the original object untouched when
+     * there is nothing to project.
+     */
+    ProjectRow(row) {
+        if (!row || !this.callerCarriesDenials()) {
+            return row;
+        }
+        return this.projectOne(row);
+    }
+    /**
+     * Whether this caller is denied ANY field on ANY field-security-enabled entity.
+     *
+     * The whole projector is a no-op for everyone else, and this gate is what makes that true —
+     * including for the fail-closed branch in {@link deniedFieldsFor}, which would otherwise blank
+     * audit rows on deployments that never enabled field security at all. Cost is one pass over
+     * the entity list plus one denied-set walk per ENABLED entity, and the flag is off on every
+     * entity an administrator has not explicitly opted in.
+     *
+     * Public because the WRITE side needs the same question: a caller who could have been served a
+     * narrowed payload must not be allowed to write one back. See
+     * `ResolverBase.StripRecordChangePayloadFromClientInput`.
+     */
+    CallerCarriesAnyDenial() {
+        return this.callerCarriesDenials();
+    }
+    callerCarriesDenials() {
+        if (this.carriesDenials === null) {
+            this.carriesDenials = this.provider.Entities.some((e) => e.EnableFieldLevelSecurity && e.GetDeniedReadFields(this.user).size > 0);
+        }
+        return this.carriesDenials;
+    }
+    projectOne(row) {
+        const source = row;
+        if (!source || typeof source !== 'object') {
+            return row;
+        }
+        const keys = this.resolvePayloadKeys(source);
+        if (!keys) {
+            return row; // the caller selected none of the payload columns — nothing to protect
+        }
+        const denied = this.deniedFieldsFor(source, keys);
+        if (denied !== null && denied.size === 0) {
+            return row; // caller reads every field on the entity this row is about
+        }
+        const projected = { ...source };
+        if (keys.Prose) {
+            delete projected[keys.Prose];
+        }
+        for (const key of keys.JSON) {
+            if (denied === null) {
+                delete projected[key];
+                continue;
+            }
+            const result = ProjectRecordChangePayloadJSON(source[key], denied);
+            if (result.Withhold) {
+                delete projected[key];
+            }
+            else {
+                projected[key] = result.Value;
+            }
+        }
+        return projected;
+    }
+    /**
+     * The denied-read set for the entity a Record Change row is ABOUT, or `null` to fail closed.
+     *
+     * **`null` drops all three payload columns.** Two shapes reach it and both have to. The first
+     * is an `EntityID` that no longer resolves to a known entity. The second is the one that
+     * decides the policy: a row that does not carry `EntityID` at all. A caller can ask for
+     * `Fields: ['ChangesJSON']` and nothing else, and field narrowing runs BEFORE this projection
+     * — so failing open on a missing `EntityID` would be a one-parameter bypass of the entire
+     * control.
+     *
+     * The cost of failing closed is paid only by callers who already carry denials somewhere (see
+     * {@link callerCarriesDenials}), and lands on audit rows for entities that are gone from
+     * metadata — rows for which no caller can render an entity name either way.
+     */
+    deniedFieldsFor(source, keys) {
+        if (!keys.EntityID) {
+            return null;
+        }
+        const rawEntityID = source[keys.EntityID];
+        if (typeof rawEntityID !== 'string' || rawEntityID.trim().length === 0) {
+            return null;
+        }
+        const cached = this.deniedByEntityID.get(rawEntityID);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const entity = this.provider.EntityByID(rawEntityID);
+        const denied = entity ? entity.GetDeniedReadFields(this.user) : null;
+        this.deniedByEntityID.set(rawEntityID, denied);
+        return denied;
+    }
+    /**
+     * Resolves the row's actual key casing once. Returns null — cached as null — when the rows
+     * carry no payload column at all, which makes every later row a single map read.
+     */
+    resolvePayloadKeys(source) {
+        if (this.payloadKeys !== undefined) {
+            return this.payloadKeys;
+        }
+        const byLowerName = new Map();
+        for (const key of Object.keys(source)) {
+            byLowerName.set(key.trim().toLowerCase(), key);
+        }
+        const jsonKeys = RecordChangeJSONPayloadFields
+            .map((name) => byLowerName.get(name.toLowerCase()))
+            .filter((key) => key !== undefined);
+        const proseKey = byLowerName.get(RecordChangeProsePayloadField.toLowerCase()) ?? null;
+        this.payloadKeys = (jsonKeys.length === 0 && proseKey === null)
+            ? null
+            : {
+                JSON: jsonKeys,
+                Prose: proseKey,
+                EntityID: byLowerName.get(RecordChangeEntityIDField.toLowerCase()) ?? null,
+            };
+        return this.payloadKeys;
+    }
+}
+//# sourceMappingURL=recordChangeFieldSecurity.js.map

package/dist/generic/recordChangeFieldSecurity.js.map

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

package/dist/generic/relatedRecordBatchLoader.js

@@ -114,7 +114,7 @@ function distributeChildren(parents, collectionName, foreignKey, children) {
         if (!(collection instanceof RelatedRecordCollection)) {
             continue;
         }
-        const key = normalizeKey(parent.FirstPrimaryKey?.Value);
+        const key = normalizeKey(parent.FirstPrimaryKey?.Value); // first-pk-ok: RelatedEntityJoinField is one FK column, so the parent key it holds is single-column by design
         collection.SetLoadedItems(byParent.get(key) ?? []);
     }
 }
@@ -127,7 +127,7 @@ function distributeChildren(parents, collectionName, foreignKey, children) {
 function collectParentKeys(parents) {
     const keys = new Set();
     for (const parent of parents) {
-        const value = parent.FirstPrimaryKey?.Value;
+        const value = parent.FirstPrimaryKey?.Value; // first-pk-ok: RelatedEntityJoinField is one FK column, so the parent key it holds is single-column by design
         if (value !== null && value !== undefined && value !== '') {
             keys.add(String(value));
         }

package/dist/generic/relatedRecordBatchLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"relatedRecordBatchLoader.js","sourceRoot":"","sources":["../../src/generic/relatedRecordBatchLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC3C,OAAqB,EACrB,eAAyB,EACzB,QAA0B,EAC1B,WAAsB;IAEtB,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;QAC/C,OAAO;IACX,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACjC,MAAM,wBAAwB,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IACzE,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,wBAAwB,CACnC,OAAqB,EACrB,cAAsB,EACtB,QAA0B,EAC1B,WAAsB;IAEtB,gGAAgG;IAChG,2FAA2F;IAC3F,iDAAiD;IACjD,MAAM,QAAQ,GAAG,OAAO;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAA0B,cAAc,CAAC,CAAC;SACjE,IAAI,CAAC,CAAC,CAAC,EAAgC,EAAE,CAAC,CAAC,YAAY,uBAAuB,CAAC,CAAC;IAErF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,QAAQ,CACJ,oEAAoE,cAAc,mBAAmB;YACrG,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,IAAI,qBAAqB,aAAa,CACxE,CAAC;QACF,OAAO;IACX,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,sBAAsB,CAAC;IACnD,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CACjC;QACI,UAAU,EAAE,QAAQ,CAAC,iBAAiB;QACtC,WAAW,EAAE,GAAG,UAAU,QAAQ,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;QAC7F,OAAO,EAAE,QAAQ,CAAC,aAAa;QAC/B,UAAU,EAAE,eAAe;KAC9B,EACD,WAAW,CACd,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAClB,4FAA4F;QAC5F,wFAAwF;QACxF,gDAAgD;QAChD,MAAM,IAAI,KAAK,CACX,wDAAwD,cAAc,IAAI;YAC1E,IAAI,QAAQ,CAAC,iBAAiB,MAAM,MAAM,CAAC,YAAY,IAAI,eAAe,EAAE,CAC/E,CAAC;IACN,CAAC;IAED,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,kBAAkB,CACvB,OAAqB,EACrB,cAAsB,EACtB,UAAkB,EAClB,QAAsB;IAEtB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IACjD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC3B,4FAA4F;QAC5F,sDAAsD;QACtD,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACJ,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/B,CAAC;IACL,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAA0B,cAAc,CAAC,CAAC;QAChF,IAAI,CAAC,CAAC,UAAU,YAAY,uBAAuB,CAAC,EAAE,CAAC;YACnD,SAAS;QACb,CAAC;QACD,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QACxD,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,OAAqB;IAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,EAAE,KAAK,CAAC;QAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACxD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5B,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,KAAc;IAChC,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpD,CAAC"}
+{"version":3,"file":"relatedRecordBatchLoader.js","sourceRoot":"","sources":["../../src/generic/relatedRecordBatchLoader.ts"],"names":[],"mappings":"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"}

package/dist/generic/relatedRecordCollection.d.ts

@@ -26,7 +26,7 @@ import type { BaseEntity } from './baseEntity.js';
 import { EntityCompanion, EntityCompanionDeserializeMode, EntityCompanionPayload } from './entityCompanion.js';
 import type { EntitySavePlan } from './entitySavePlan.js';
 import { ValidationResult } from './entityInfo.js';
-import type { EntitySaveOptions } from './interfaces.js';
+import type { EntitySaveOptions, IEntityDataProvider } from './interfaces.js';
 /**
  * When a child collection populates itself from the database.
  *
@@ -606,5 +606,6 @@ export declare class RelatedRecordCollection<T extends BaseEntity = BaseEntity>
      * callers assume when they display or reference "line 3".
      */
     private applySequence;
+    BindProvider(provider: IEntityDataProvider | null): void;
 }
 //# sourceMappingURL=relatedRecordCollection.d.ts.map

package/dist/generic/relatedRecordCollection.d.ts.map

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

package/dist/generic/relatedRecordCollection.js

@@ -365,7 +365,7 @@ export class RelatedRecordCollection extends EntityCompanion {
         if (!provider) {
             throw new Error(`RelatedRecordCollection '${this.Name}': owner has no provider; cannot load.`);
         }
-        const parentKey = this.Owner.FirstPrimaryKey?.Value;
+        const parentKey = this.Owner.FirstPrimaryKey?.Value; // first-pk-ok: RelatedEntityJoinField is one FK column, so the parent key it holds is single-column by design
         const result = await provider.RunView({
             EntityName: this.RelatedEntityName,
             ExtraFilter: `${this.options.RelatedEntityJoinField} = '${String(parentKey).replace(/'/g, "''")}'`,
@@ -487,7 +487,7 @@ export class RelatedRecordCollection extends EntityCompanion {
         // survives the engine reassigning it wholesale, which is the case a captured array
         // reference misses. Re-running discovery here would also risk silently binding to a
         // DIFFERENT engine mid-life if two happened to cache the same entity.
-        const parentKey = this.Owner.FirstPrimaryKey?.Value;
+        const parentKey = this.Owner.FirstPrimaryKey?.Value; // first-pk-ok: RelatedEntityJoinField is one FK column, so the parent key it holds is single-column by design
         if (parentKey === null || parentKey === undefined || parentKey === '') {
             return;
         }
@@ -598,7 +598,7 @@ export class RelatedRecordCollection extends EntityCompanion {
      *          entity — in which case the caller falls back to a database load.
      */
     findCachedRecords() {
-        const parentKey = this.Owner.FirstPrimaryKey?.Value;
+        const parentKey = this.Owner.FirstPrimaryKey?.Value; // first-pk-ok: RelatedEntityJoinField is one FK column, so the parent key it holds is single-column by design
         if (parentKey === null || parentKey === undefined || parentKey === '') {
             return null; // an unsaved parent owns no persisted related records
         }
@@ -1030,7 +1030,7 @@ export class RelatedRecordCollection extends EntityCompanion {
      * already be correct.
      */
     stampParentKey() {
-        const parentKey = this.Owner.FirstPrimaryKey?.Value;
+        const parentKey = this.Owner.FirstPrimaryKey?.Value; // first-pk-ok: RelatedEntityJoinField is one FK column, so the parent key it holds is single-column by design
         if (parentKey === null || parentKey === undefined || parentKey === '') {
             return;
         }
@@ -1062,5 +1062,17 @@ export class RelatedRecordCollection extends EntityCompanion {
             }
         });
     }
+    BindProvider(provider) {
+        for (const item of this.items) {
+            if (item.BoundProvider !== provider) {
+                item.BindProvider(provider);
+            }
+        }
+        for (const item of this.removed) {
+            if (item.BoundProvider !== provider) {
+                item.BindProvider(provider);
+            }
+        }
+    }
 }
 //# sourceMappingURL=relatedRecordCollection.js.map