@memberjunction/actions-base 5.51.0 → 6.1.0-edge.0

package/dist/ParamRedaction.js

@@ -0,0 +1,142 @@
+import { BaseEntity } from "@memberjunction/core";
+import { UUIDsEqual } from "@memberjunction/global";
+/**
+ * Upper bound on how many top-level key names a redaction record carries. A wide
+ * record would otherwise reintroduce the size problem the redaction exists to solve.
+ */
+export const MAX_REDACTED_KEYS = 25;
+/** The Entity Action `ValueType` values that pass a whole record and are therefore never logged. */
+const WHOLE_RECORD_VALUE_TYPES = new Set(['entity object', 'entity object data']);
+/** True when a redaction record (rather than a live parameter) is what's in hand. */
+export function IsRedactedParam(param) {
+    return param.Logged === false;
+}
+/**
+ * Produces the persistable form of an action's parameters, applying the three
+ * redaction rules documented on this module.
+ *
+ * @param params The runtime parameters, as passed to (or returned by) the action.
+ * @param actionParams The `ActionParam` definition rows for the action. When a
+ *        runtime parameter has no matching definition its value is logged —
+ *        `ActionParam.LogValue` defaults to `1`, and an undeclared parameter has
+ *        no declaration to opt out with. Rule 1 does not depend on this lookup.
+ * @param entityActionParams The `EntityActionParam` binding rows, when the run
+ *        originated from an Entity Action. Omitted for direct invocations, in
+ *        which case rules 1 and 2 cannot apply.
+ */
+export function RedactParams(params, actionParams, entityActionParams) {
+    if (!params) {
+        return [];
+    }
+    return params.map(p => {
+        const definition = findDefinition(p.Name, actionParams);
+        const binding = findBinding(definition, entityActionParams);
+        const reason = resolveRedactionReason(definition, binding);
+        if (!reason) {
+            return p;
+        }
+        return buildRedactionRecord(p, binding, reason);
+    });
+}
+/**
+ * Convenience wrapper producing the JSON string persisters actually write. Kept
+ * beside {@link RedactParams} so no caller is tempted to `JSON.stringify` a raw
+ * `ActionParam[]` itself.
+ */
+export function RedactParamsToJSON(params, actionParams, entityActionParams) {
+    return JSON.stringify(RedactParams(params, actionParams, entityActionParams));
+}
+/** Case-insensitive lookup of a runtime parameter's definition row. */
+function findDefinition(name, actionParams) {
+    if (!actionParams || !name) {
+        return undefined;
+    }
+    const target = name.trim().toLowerCase();
+    return actionParams.find(ap => (ap.Name ?? '').trim().toLowerCase() === target);
+}
+/** Finds the Entity Action binding row that supplies this parameter, if the run came from a binding. */
+function findBinding(definition, entityActionParams) {
+    if (!definition || !entityActionParams) {
+        return undefined;
+    }
+    return entityActionParams.find(eap => UUIDsEqual(eap.ActionParamID, definition.ID));
+}
+/**
+ * Applies the three rules in precedence order and returns the reason a value is
+ * withheld, or `undefined` when it may be logged.
+ */
+function resolveRedactionReason(definition, binding) {
+    // Rule 1 — whole-record value types. Unconditional; nothing below can re-enable it.
+    if (binding && WHOLE_RECORD_VALUE_TYPES.has((binding.ValueType ?? '').trim().toLowerCase())) {
+        return 'WholeRecordValueType';
+    }
+    // Rule 2 — the binding's explicit override. NULL falls through to the definition.
+    if (binding && binding.LogValue != null) {
+        return binding.LogValue ? undefined : 'BindingLogValueFalse';
+    }
+    // Rule 3 — the definition. An absent definition means an undeclared parameter,
+    // which has nothing to opt out with, so it is logged (LogValue's default is 1).
+    if (definition && definition.LogValue === false) {
+        return 'ParamLogValueFalse';
+    }
+    return undefined;
+}
+/** Builds the shape-only record persisted in place of a suppressed value. */
+function buildRedactionRecord(param, binding, reason) {
+    const record = {
+        Name: param.Name,
+        Type: param.Type,
+        Logged: false,
+        Reason: reason,
+        ByteLength: 0
+    };
+    if (binding?.ValueType) {
+        record.ValueType = binding.ValueType;
+    }
+    describeShape(param.Value, record);
+    return record;
+}
+/**
+ * Fills the shape fields of a redaction record. A `BaseEntity` is described
+ * through `GetAll()` — its fields are getters, not enumerable own properties, so
+ * describing the instance directly would report a misleading empty shape (the
+ * same trap `'Entity Object Data'` exists to avoid).
+ */
+function describeShape(value, record) {
+    if (value === null || value === undefined) {
+        record.ByteLength = 0;
+        return;
+    }
+    const described = value instanceof BaseEntity ? value.GetAll() : value;
+    record.ByteLength = utf8ByteLength(described);
+    if (Array.isArray(described)) {
+        record.ItemCount = described.length;
+        return;
+    }
+    if (typeof described === 'object') {
+        const keys = Object.keys(described);
+        record.KeyCount = keys.length;
+        record.Keys = keys.slice(0, MAX_REDACTED_KEYS);
+        if (keys.length > MAX_REDACTED_KEYS) {
+            record.KeysElided = true;
+        }
+    }
+}
+/**
+ * UTF-8 byte length of a value's JSON form. Returns `-1` when the value cannot be
+ * serialized (a circular reference, say) — a distinguishable signal rather than a
+ * misleading zero, and never a reason to throw out of a logging path.
+ */
+function utf8ByteLength(value) {
+    try {
+        const json = JSON.stringify(value);
+        if (json === undefined) {
+            return 0;
+        }
+        return new TextEncoder().encode(json).length;
+    }
+    catch {
+        return -1;
+    }
+}
+//# sourceMappingURL=ParamRedaction.js.map

package/dist/ParamRedaction.js.map

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

package/dist/__tests__/EntityActionEngine-Base.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EntityActionEngine-Base.test.d.ts.map

package/dist/__tests__/EntityActionEngine-Base.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityActionEngine-Base.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/EntityActionEngine-Base.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/EntityActionEngine-Base.test.js

@@ -0,0 +1,160 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+const mockEntityByID = vi.fn();
+vi.mock('@memberjunction/core', () => ({
+    BaseEngine: class BaseEngine {
+        static getInstance(_key) {
+            return {};
+        }
+        async Load() { }
+    },
+    BaseEnginePropertyConfig: class BaseEnginePropertyConfig {
+    },
+    BaseEntity: class BaseEntity {
+    },
+    EntityInfo: class EntityInfo {
+    },
+    IMetadataProvider: class IMetadataProvider {
+    },
+    UserInfo: class UserInfo {
+    },
+    Metadata: class Metadata {
+        EntityByID(id) {
+            return mockEntityByID(id);
+        }
+    },
+    RunView: class RunView {
+    }
+}));
+vi.mock('@memberjunction/core-entities', () => ({}));
+import { EntityActionEngineBase } from '../EntityActionEngine-Base.js';
+const DEAL_TYPES_ID = 'AAAAAAAA-0000-0000-0000-000000000001';
+const SCOPE_RECORD_ID = 'CCCCCCCC-0000-0000-0000-000000000003';
+const DEALS_ENTITY_ID = 'EEEEEEEE-0000-0000-0000-000000000005';
+function bindingRow(spec) {
+    return {
+        Entity: spec.Entity ?? 'Deals',
+        EntityID: spec.EntityID ?? DEALS_ENTITY_ID,
+        Status: spec.Status ?? 'Active',
+        ScopeEntityID: spec.ScopeEntityID ?? null,
+        ScopeRecordID: spec.ScopeRecordID ?? null,
+        ...spec
+    };
+}
+/**
+ * A live engine instance with its cache pre-seeded. The engine's cached arrays are private and
+ * normally filled by `Config()`; seeding them directly is what lets these tests exercise the pure
+ * ordering/filtering logic without a database.
+ */
+function engineWith(bindings) {
+    const engine = new EntityActionEngineBase();
+    engine._EntityActions = bindings;
+    return engine;
+}
+function dealRecord(dealTypeID) {
+    return {
+        EntityInfo: { Fields: [{ Name: 'DealTypeID', RelatedEntityID: DEAL_TYPES_ID }] },
+        Get: (name) => (name === 'DealTypeID' ? dealTypeID : undefined)
+    };
+}
+describe('EntityActionEngineBase — Sequence ordering', () => {
+    it('returns bindings in ascending Sequence order', () => {
+        const engine = engineWith([
+            bindingRow({ Action: 'Notify', Sequence: 30 }),
+            bindingRow({ Action: 'Normalize', Sequence: 10 }),
+            bindingRow({ Action: 'Validate', Sequence: 20 })
+        ]);
+        expect(engine.GetActionsByEntityName('Deals').map(e => e.Action)).toEqual(['Normalize', 'Validate', 'Notify']);
+    });
+    it('breaks Sequence ties by Action name so the order is total and stable', () => {
+        const engine = engineWith([
+            bindingRow({ Action: 'Zulu', Sequence: 5 }),
+            bindingRow({ Action: 'Alpha', Sequence: 5 }),
+            bindingRow({ Action: 'Mike', Sequence: 5 })
+        ]);
+        expect(engine.GetActionsByEntityName('Deals').map(e => e.Action)).toEqual(['Alpha', 'Mike', 'Zulu']);
+    });
+    it('treats a null Sequence as 0, so unsequenced bindings run before deliberately-later ones', () => {
+        const engine = engineWith([
+            bindingRow({ Action: 'Later', Sequence: 100 }),
+            bindingRow({ Action: 'Unsequenced', Sequence: null }),
+            bindingRow({ Action: 'Explicit Zero', Sequence: 0 })
+        ]);
+        expect(engine.GetActionsByEntityName('Deals').map(e => e.Action)).toEqual([
+            'Explicit Zero',
+            'Unsequenced',
+            'Later'
+        ]);
+    });
+    it('supports negative Sequence for a binding that must run first', () => {
+        const engine = engineWith([
+            bindingRow({ Action: 'Default', Sequence: 0 }),
+            bindingRow({ Action: 'Preflight', Sequence: -10 })
+        ]);
+        expect(engine.GetActionsByEntityName('Deals').map(e => e.Action)).toEqual(['Preflight', 'Default']);
+    });
+    it('does not mutate the cached array — ordering must not reorder the engine cache', () => {
+        const cached = [bindingRow({ Action: 'B', Sequence: 2 }), bindingRow({ Action: 'A', Sequence: 1 })];
+        const engine = engineWith(cached);
+        engine.GetActionsByEntityName('Deals');
+        expect(cached.map(e => e.Action)).toEqual(['B', 'A']);
+    });
+    it('orders GetActionsByEntityID the same way', () => {
+        const engine = engineWith([
+            bindingRow({ Action: 'Second', Sequence: 2 }),
+            bindingRow({ Action: 'First', Sequence: 1 })
+        ]);
+        expect(engine.GetActionsByEntityID(DEALS_ENTITY_ID).map(e => e.Action)).toEqual(['First', 'Second']);
+    });
+    it('still honours the entity-name and status filters', () => {
+        const engine = engineWith([
+            bindingRow({ Action: 'OtherEntity', Sequence: 1, Entity: 'Contacts' }),
+            bindingRow({ Action: 'Disabled', Sequence: 2, Status: 'Disabled' }),
+            bindingRow({ Action: 'Active', Sequence: 3 })
+        ]);
+        expect(engine.GetActionsByEntityName('Deals', 'Active').map(e => e.Action)).toEqual(['Active']);
+        // Entity name matching is case/whitespace-insensitive, as before.
+        expect(engine.GetActionsByEntityName('  deals  ').map(e => e.Action)).toEqual([
+            'Disabled',
+            'Active'
+        ]);
+    });
+});
+describe('EntityActionEngineBase — FilterByScope', () => {
+    beforeEach(() => {
+        mockEntityByID.mockReset();
+        mockEntityByID.mockImplementation((id) => (id === DEAL_TYPES_ID ? { Name: 'Deal Types' } : undefined));
+    });
+    it('keeps unscoped bindings and drops scoped ones the record falls outside of', async () => {
+        const engine = engineWith([]);
+        const bindings = [
+            bindingRow({ Action: 'Applies To All', Sequence: 1 }),
+            bindingRow({ Action: 'Scoped Match', Sequence: 2, ScopeEntityID: DEAL_TYPES_ID, ScopeRecordID: SCOPE_RECORD_ID }),
+            bindingRow({ Action: 'Scoped Other', Sequence: 3, ScopeEntityID: DEAL_TYPES_ID, ScopeRecordID: 'a-different-type' })
+        ];
+        const kept = await engine.FilterByScope(bindings, dealRecord(SCOPE_RECORD_ID));
+        expect(kept.map(e => e.Action)).toEqual(['Applies To All', 'Scoped Match']);
+    });
+    it('preserves the incoming Sequence ordering', async () => {
+        const engine = engineWith([]);
+        const bindings = engine.GetActionsByEntityName.call(engineWith([
+            bindingRow({ Action: 'Third', Sequence: 3 }),
+            bindingRow({ Action: 'First', Sequence: 1 }),
+            bindingRow({ Action: 'Second', Sequence: 2 })
+        ]), 'Deals');
+        const kept = await engine.FilterByScope(bindings, dealRecord(SCOPE_RECORD_ID));
+        expect(kept.map(e => e.Action)).toEqual(['First', 'Second', 'Third']);
+    });
+    it('drops every scoped binding when there is no subject record to evaluate', async () => {
+        const engine = engineWith([]);
+        const bindings = [
+            bindingRow({ Action: 'Unscoped' }),
+            bindingRow({ Action: 'Scoped', ScopeEntityID: DEAL_TYPES_ID, ScopeRecordID: SCOPE_RECORD_ID })
+        ];
+        const kept = await engine.FilterByScope(bindings, undefined);
+        expect(kept.map(e => e.Action)).toEqual(['Unscoped']);
+    });
+    it('returns an empty array for an empty candidate set', async () => {
+        await expect(engineWith([]).FilterByScope([], dealRecord(SCOPE_RECORD_ID))).resolves.toEqual([]);
+    });
+});
+//# sourceMappingURL=EntityActionEngine-Base.test.js.map

package/dist/__tests__/EntityActionEngine-Base.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityActionEngine-Base.test.js","sourceRoot":"","sources":["../../src/__tests__/EntityActionEngine-Base.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE9D,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAE/B,EAAE,CAAC,IAAI,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,UAAU;QACd,MAAM,CAAC,WAAW,CAAI,IAAa;YACzC,OAAO,EAAO,CAAC;QACnB,CAAC;QACS,KAAK,CAAC,IAAI,KAAmB,CAAC;KAC3C;IACD,wBAAwB,EAAE,MAAM,wBAAwB;KAAG;IAC3D,UAAU,EAAE,MAAM,UAAU;KAAG;IAC/B,UAAU,EAAE,MAAM,UAAU;KAAG;IAC/B,iBAAiB,EAAE,MAAM,iBAAiB;KAAG;IAC7C,QAAQ,EAAE,MAAM,QAAQ;KAAG;IAC3B,QAAQ,EAAE,MAAM,QAAQ;QACb,UAAU,CAAC,EAAU;YACxB,OAAO,cAAc,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC;KACJ;IACD,OAAO,EAAE,MAAM,OAAO;KAAG;CAC5B,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,+BAA+B,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAIpE,MAAM,aAAa,GAAG,sCAAsC,CAAC;AAC7D,MAAM,eAAe,GAAG,sCAAsC,CAAC;AAC/D,MAAM,eAAe,GAAG,sCAAsC,CAAC;AAY/D,SAAS,UAAU,CAAC,IAAiB;IACjC,OAAO;QACH,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,OAAO;QAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,eAAe;QAC1C,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,QAAQ;QAC/B,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;QACzC,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;QACzC,GAAG,IAAI;KACiC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,QAAwC;IACxD,MAAM,MAAM,GAAG,IAAI,sBAAsB,EAAE,CAAC;IAC3C,MAAwE,CAAC,cAAc,GAAG,QAAQ,CAAC;IACpG,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,SAAS,UAAU,CAAC,UAAyB;IACzC,OAAO;QACH,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC,EAA2B;QACzG,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;KACjD,CAAC;AAC/B,CAAC;AAED,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IACxD,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,UAAU,CAAC;YACtB,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YAC9C,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YACjD,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;SACnD,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC5E,MAAM,MAAM,GAAG,UAAU,CAAC;YACtB,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YAC3C,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YAC5C,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;SAC9C,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yFAAyF,EAAE,GAAG,EAAE;QAC/F,MAAM,MAAM,GAAG,UAAU,CAAC;YACtB,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;YAC9C,UAAU,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACrD,UAAU,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;SACvD,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YACtE,eAAe;YACf,aAAa;YACb,OAAO;SACV,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACpE,MAAM,MAAM,GAAG,UAAU,CAAC;YACtB,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YAC9C,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;SACrD,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IACxG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACrF,MAAM,MAAM,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACpG,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,UAAU,CAAC;YACtB,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YAC7C,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;SAC/C,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QACxD,MAAM,MAAM,GAAG,UAAU,CAAC;YACtB,UAAU,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;YACtE,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;YACnE,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;SAChD,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChG,kEAAkE;QAClE,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC1E,UAAU;YACV,QAAQ;SACX,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACpD,UAAU,CAAC,GAAG,EAAE;QACZ,cAAc,CAAC,SAAS,EAAE,CAAC;QAC3B,cAAc,CAAC,kBAAkB,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACnH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG;YACb,UAAU,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YACrD,UAAU,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;YACjH,UAAU,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC;SACvH,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC;QAC/E,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,sBAAsB,CAAC,IAAI,CAC/C,UAAU,CAAC;YACP,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YAC5C,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YAC5C,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;SAChD,CAAC,EACF,OAAO,CACV,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC;QAC/E,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG;YACb,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;YAClC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;SACjG,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC7D,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/__tests__/EntityActionScopeResolver.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EntityActionScopeResolver.test.d.ts.map

package/dist/__tests__/EntityActionScopeResolver.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityActionScopeResolver.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/EntityActionScopeResolver.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/EntityActionScopeResolver.test.js

@@ -0,0 +1,149 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+/**
+ * The scope resolver reads two things: an entity's field metadata (to walk foreign keys) and the
+ * `Metadata` catalog (to turn `ScopeEntityID` into an entity name for resolver lookup). Both are
+ * mocked so the tests are pure and deterministic.
+ */
+const mockEntityByID = vi.fn();
+vi.mock('@memberjunction/core', () => ({
+    BaseEntity: class BaseEntity {
+    },
+    EntityInfo: class EntityInfo {
+    },
+    Metadata: class Metadata {
+        EntityByID(id) {
+            return mockEntityByID(id);
+        }
+    }
+}));
+import { EntityActionScopeResolver, IsEntityActionInScope } from '../EntityActionScopeResolver.js';
+// ── Fixtures ─────────────────────────────────────────────────────────────────────────────────────
+const DEAL_TYPES_ID = 'AAAAAAAA-0000-0000-0000-000000000001';
+const COMPANIES_ID = 'BBBBBBBB-0000-0000-0000-000000000002';
+const SCOPE_RECORD_ID = 'CCCCCCCC-0000-0000-0000-000000000003';
+/** A subject record with the given FK fields and values. */
+function subject(fields, values) {
+    return {
+        EntityInfo: { Fields: fields },
+        Get: (name) => values[name]
+    };
+}
+function entityAction(scopeEntityID, scopeRecordID) {
+    return { ScopeEntityID: scopeEntityID, ScopeRecordID: scopeRecordID };
+}
+/** The default resolver, used wherever a test isn't exercising a custom registration. */
+const defaultResolverFactory = () => new EntityActionScopeResolver();
+describe('EntityActionScopeResolver — default foreign-key walk', () => {
+    const resolver = new EntityActionScopeResolver();
+    it('matches when the single FK to the scope entity holds the scope record ID', async () => {
+        const deal = subject([{ Name: 'DealTypeID', RelatedEntityID: DEAL_TYPES_ID }], { DealTypeID: SCOPE_RECORD_ID });
+        await expect(resolver.IsInScope(deal, DEAL_TYPES_ID, SCOPE_RECORD_ID)).resolves.toBe(true);
+    });
+    it('rejects when the FK points at a different scope record', async () => {
+        const deal = subject([{ Name: 'DealTypeID', RelatedEntityID: DEAL_TYPES_ID }], {
+            DealTypeID: 'DDDDDDDD-0000-0000-0000-00000000000D'
+        });
+        await expect(resolver.IsInScope(deal, DEAL_TYPES_ID, SCOPE_RECORD_ID)).resolves.toBe(false);
+    });
+    it('compares UUIDs case-insensitively — SQL Server uppercases, PostgreSQL lowercases', async () => {
+        const deal = subject([{ Name: 'DealTypeID', RelatedEntityID: DEAL_TYPES_ID }], {
+            DealTypeID: SCOPE_RECORD_ID.toLowerCase()
+        });
+        await expect(resolver.IsInScope(deal, DEAL_TYPES_ID, SCOPE_RECORD_ID.toUpperCase())).resolves.toBe(true);
+    });
+    it('matches non-UUID (numeric/text) scope record keys', async () => {
+        const deal = subject([{ Name: 'RegionID', RelatedEntityID: DEAL_TYPES_ID }], { RegionID: 42 });
+        await expect(resolver.IsInScope(deal, DEAL_TYPES_ID, '42')).resolves.toBe(true);
+        await expect(resolver.IsInScope(deal, DEAL_TYPES_ID, '43')).resolves.toBe(false);
+    });
+    it('rejects when the FK is null on this record', async () => {
+        const deal = subject([{ Name: 'DealTypeID', RelatedEntityID: DEAL_TYPES_ID }], { DealTypeID: null });
+        await expect(resolver.IsInScope(deal, DEAL_TYPES_ID, SCOPE_RECORD_ID)).resolves.toBe(false);
+    });
+    it('DECLINES (null) when the subject has no FK to the scope entity — the relationship is indirect', async () => {
+        const deal = subject([{ Name: 'DealTypeID', RelatedEntityID: DEAL_TYPES_ID }], { DealTypeID: SCOPE_RECORD_ID });
+        await expect(resolver.IsInScope(deal, COMPANIES_ID, SCOPE_RECORD_ID)).resolves.toBeNull();
+    });
+    it('DECLINES (null) on ambiguity — two FKs to the same entity have no defensible "the" one', async () => {
+        const deal = subject([
+            { Name: 'OwnerCompanyID', RelatedEntityID: COMPANIES_ID },
+            { Name: 'ClientCompanyID', RelatedEntityID: COMPANIES_ID }
+        ], { OwnerCompanyID: SCOPE_RECORD_ID, ClientCompanyID: 'other' });
+        await expect(resolver.IsInScope(deal, COMPANIES_ID, SCOPE_RECORD_ID)).resolves.toBeNull();
+    });
+    it('ignores non-FK fields when looking for the scope relationship', async () => {
+        const deal = subject([{ Name: 'Amount' }, { Name: 'DealTypeID', RelatedEntityID: DEAL_TYPES_ID }], { Amount: 100, DealTypeID: SCOPE_RECORD_ID });
+        await expect(resolver.IsInScope(deal, DEAL_TYPES_ID, SCOPE_RECORD_ID)).resolves.toBe(true);
+    });
+});
+describe('IsEntityActionInScope', () => {
+    beforeEach(() => {
+        mockEntityByID.mockReset();
+        mockEntityByID.mockImplementation((id) => (id === DEAL_TYPES_ID ? { Name: 'Deal Types' } : undefined));
+    });
+    it('an unscoped binding always applies — the pre-existing behaviour', async () => {
+        const deal = subject([], {});
+        await expect(IsEntityActionInScope(entityAction(null, null), deal, defaultResolverFactory)).resolves.toBe(true);
+    });
+    it('a half-configured scope (entity but no record) is treated as unscoped', async () => {
+        const deal = subject([], {});
+        await expect(IsEntityActionInScope(entityAction(DEAL_TYPES_ID, null), deal, defaultResolverFactory)).resolves.toBe(true);
+        await expect(IsEntityActionInScope(entityAction(null, SCOPE_RECORD_ID), deal, defaultResolverFactory)).resolves.toBe(true);
+    });
+    it('an unscoped binding applies even with no subject record in hand', async () => {
+        await expect(IsEntityActionInScope(entityAction(null, null), undefined, defaultResolverFactory)).resolves.toBe(true);
+    });
+    it('a scoped binding applies when the default FK walk matches', async () => {
+        const deal = subject([{ Name: 'DealTypeID', RelatedEntityID: DEAL_TYPES_ID }], { DealTypeID: SCOPE_RECORD_ID });
+        await expect(IsEntityActionInScope(entityAction(DEAL_TYPES_ID, SCOPE_RECORD_ID), deal, defaultResolverFactory)).resolves.toBe(true);
+    });
+    it('a scoped binding does NOT apply to a record under a different scope record', async () => {
+        const deal = subject([{ Name: 'DealTypeID', RelatedEntityID: DEAL_TYPES_ID }], { DealTypeID: 'someone-else' });
+        await expect(IsEntityActionInScope(entityAction(DEAL_TYPES_ID, SCOPE_RECORD_ID), deal, defaultResolverFactory)).resolves.toBe(false);
+    });
+    it('a scoped binding does NOT fire when there is no subject record to evaluate', async () => {
+        await expect(IsEntityActionInScope(entityAction(DEAL_TYPES_ID, SCOPE_RECORD_ID), null, defaultResolverFactory)).resolves.toBe(false);
+    });
+    it('a scoped binding does NOT fire when the scope entity is unknown to metadata', async () => {
+        const deal = subject([{ Name: 'CompanyID', RelatedEntityID: COMPANIES_ID }], { CompanyID: SCOPE_RECORD_ID });
+        await expect(IsEntityActionInScope(entityAction(COMPANIES_ID, SCOPE_RECORD_ID), deal, defaultResolverFactory)).resolves.toBe(false);
+    });
+    it('a scoped binding does NOT fire when no resolver can be produced', async () => {
+        const deal = subject([{ Name: 'DealTypeID', RelatedEntityID: DEAL_TYPES_ID }], { DealTypeID: SCOPE_RECORD_ID });
+        await expect(IsEntityActionInScope(entityAction(DEAL_TYPES_ID, SCOPE_RECORD_ID), deal, () => null)).resolves.toBe(false);
+    });
+    it('a resolver that DECLINES (null) leaves the binding not-applicable — declining is not approval', async () => {
+        class DecliningResolver extends EntityActionScopeResolver {
+            async IsInScope() {
+                return null;
+            }
+        }
+        const deal = subject([{ Name: 'DealTypeID', RelatedEntityID: DEAL_TYPES_ID }], { DealTypeID: SCOPE_RECORD_ID });
+        await expect(IsEntityActionInScope(entityAction(DEAL_TYPES_ID, SCOPE_RECORD_ID), deal, () => new DecliningResolver())).resolves.toBe(false);
+    });
+    it('an app-specific resolver overrides the default FK walk in both directions', async () => {
+        class AlwaysInScope extends EntityActionScopeResolver {
+            async IsInScope() {
+                return true;
+            }
+        }
+        class NeverInScope extends EntityActionScopeResolver {
+            async IsInScope() {
+                return false;
+            }
+        }
+        // No FK at all — the default walk would decline, but the app resolver says yes.
+        const orphan = subject([], {});
+        await expect(IsEntityActionInScope(entityAction(DEAL_TYPES_ID, SCOPE_RECORD_ID), orphan, () => new AlwaysInScope())).resolves.toBe(true);
+        // FK matches — the default walk would say yes, but the app resolver says no.
+        const matching = subject([{ Name: 'DealTypeID', RelatedEntityID: DEAL_TYPES_ID }], { DealTypeID: SCOPE_RECORD_ID });
+        await expect(IsEntityActionInScope(entityAction(DEAL_TYPES_ID, SCOPE_RECORD_ID), matching, () => new NeverInScope())).resolves.toBe(false);
+    });
+    it('looks the resolver up by the scope entity NAME', async () => {
+        const lookup = vi.fn().mockReturnValue(new EntityActionScopeResolver());
+        const deal = subject([{ Name: 'DealTypeID', RelatedEntityID: DEAL_TYPES_ID }], { DealTypeID: SCOPE_RECORD_ID });
+        await IsEntityActionInScope(entityAction(DEAL_TYPES_ID, SCOPE_RECORD_ID), deal, lookup);
+        expect(lookup).toHaveBeenCalledWith('Deal Types');
+    });
+});
+//# sourceMappingURL=EntityActionScopeResolver.test.js.map

package/dist/__tests__/EntityActionScopeResolver.test.js.map

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

package/dist/__tests__/ParamRedaction.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ParamRedaction.test.d.ts.map

package/dist/__tests__/ParamRedaction.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParamRedaction.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/ParamRedaction.test.ts"],"names":[],"mappings":""}