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

package/LICENSE

@@ -0,0 +1,7 @@
+ISC License
+
+Copyright (c) 2023 MemberJunction
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/dist/ActionEngine-Base.d.ts

@@ -1,5 +1,5 @@
 import { BaseEngine, IMetadataProvider, UserInfo } from "@memberjunction/core";
-import { MJActionCategoryEntity, MJActionEntity, MJActionExecutionLogEntity, MJActionFilterEntity, MJActionLibraryEntity, MJActionParamEntity, MJActionResultCodeEntity } from "@memberjunction/core-entities";
+import { MJActionCategoryEntity, MJActionEntity, MJActionExecutionLogEntity, MJActionFilterEntity, MJActionLibraryEntity, MJActionParamEntity, MJActionResultCodeEntity, MJEntityActionEntity, MJEntityActionParamEntity } from "@memberjunction/core-entities";
 import { MJActionEntityExtended } from "./MJActionEntityExtended.js";
 export declare class ActionLibrary {
     LibraryName: string;
@@ -152,6 +152,49 @@ export declare class ActionParam {
      */
     Type: 'Input' | 'Output' | 'Both';
 }
+/**
+ * Where an action run came from, when it was dispatched by an Entity Action binding rather than
+ * invoked directly. Carried on {@link RunActionParams.Provenance} and stamped onto
+ * `ActionExecutionLog` so a failed workflow is diagnosable: *which binding fired this, on which
+ * record, from which event.*
+ *
+ * Also supplies the two things the engine cannot work out for itself once the run is under way —
+ * the binding's `LoggingMode`, and the `EntityActionParam` rows the redaction rules need in order
+ * to see a parameter's `ValueType` and per-binding `LogValue` override.
+ *
+ * Absent for direct invocations (a resolver, a script, an agent step, a scheduled action), which
+ * is exactly what the log's NULL provenance columns mean.
+ */
+export declare class ActionInvocationProvenance {
+    /** The Entity Action binding that caused this run. */
+    EntityActionID?: string;
+    /**
+     * Which lifecycle event fired the binding — `AfterUpdate`, `Validate`, `List` and so on.
+     * Recorded separately from {@link EntityActionID} because one binding may be attached to
+     * several invocation types, and telling a `Validate` refusal apart from an `AfterUpdate` side
+     * effect is the first question anyone asks of the log.
+     */
+    EntityActionInvocationTypeID?: string;
+    /**
+     * The entity of the record the run operated on. Denormalized rather than derived through
+     * {@link EntityActionID} so it survives the binding being deleted or retargeted, and so the log
+     * can be queried by record with no join. Kept generic — every invoker has a subject, not only
+     * Entity Actions.
+     */
+    TargetEntityID?: string;
+    /**
+     * The primary key of the record the run operated on, as text. For multi-record invocation types
+     * (`List`, `View`) one log row is written per record, so this is always a single record.
+     */
+    TargetRecordID?: string;
+    /** The binding's `LoggingMode` — `All` / `FailuresOnly` / `None`. Defaults to `All` when absent. */
+    LoggingMode?: MJEntityActionEntity['LoggingMode'];
+    /**
+     * The binding's parameter rows. Required by the redaction rules: `ValueType` drives the hard
+     * whole-record rule, and `LogValue` supplies the per-binding override.
+     */
+    EntityActionParams?: MJEntityActionParamEntity[];
+}
 /**
  * Class that holds the parameters for an action to be run. This is passed to the Run method of an action.
  *
@@ -253,6 +296,12 @@ export declare class RunActionParams<TContext = any> {
      * to honor the caller's provider when supplied while remaining backward compatible.
      */
     Provider?: IMetadataProvider;
+    /**
+     * Optional. Set by the Entity Action invocation path to record which binding, which event and
+     * which record produced this run — see {@link ActionInvocationProvenance}. Left undefined for
+     * direct invocations, which is what the execution log's NULL provenance columns mean.
+     */
+    Provenance?: ActionInvocationProvenance;
 }
 /**
  * Base class for Action metadata.

package/dist/ActionEngine-Base.d.ts.map

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

package/dist/ActionEngine-Base.js

@@ -21,6 +21,21 @@ export class ActionResult {
  */
 export class ActionParam {
 }
+/**
+ * Where an action run came from, when it was dispatched by an Entity Action binding rather than
+ * invoked directly. Carried on {@link RunActionParams.Provenance} and stamped onto
+ * `ActionExecutionLog` so a failed workflow is diagnosable: *which binding fired this, on which
+ * record, from which event.*
+ *
+ * Also supplies the two things the engine cannot work out for itself once the run is under way —
+ * the binding's `LoggingMode`, and the `EntityActionParam` rows the redaction rules need in order
+ * to see a parameter's `ValueType` and per-binding `LogValue` override.
+ *
+ * Absent for direct invocations (a resolver, a script, an agent step, a scheduled action), which
+ * is exactly what the log's NULL provenance columns mean.
+ */
+export class ActionInvocationProvenance {
+}
 /**
  * Class that holds the parameters for an action to be run. This is passed to the Run method of an action.
  *

package/dist/ActionEngine-Base.js.map

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

package/dist/EntityActionEngine-Base.d.ts

@@ -110,6 +110,26 @@ export declare class EntityActionEngineBase extends BaseEngine<EntityActionEngin
      * @returns
      */
     GetActionsByEntityName(entityName: string, status?: 'Active' | 'Pending' | 'Disabled'): MJEntityActionEntityExtended[];
+    /**
+     * Orders bindings the way they will execute: ascending `Sequence`, ties broken by `Name` so the
+     * order is total and stable rather than dependent on how the rows happened to load.
+     *
+     * The dispatch loop runs bindings in array order, so this ordering IS the execution contract —
+     * a `Validate` binding that normalizes a field must be able to run before one that checks it.
+     * `Sequence` defaults to 0, so unsequenced bindings keep their pre-existing name-ordered behaviour
+     * relative to each other and run before anything deliberately pushed later.
+     */
+    protected SortBySequence(entityActions: MJEntityActionEntityExtended[]): MJEntityActionEntityExtended[];
+    /**
+     * Narrows a candidate set to the bindings that apply to `subject`, honouring `ScopeEntityID` /
+     * `ScopeRecordID`. Unscoped bindings (the overwhelming majority, and the pre-existing behaviour)
+     * always apply; scoped ones are asked of the `@RegisterClass`-resolved
+     * {@link EntityActionScopeResolver} for their scope entity.
+     *
+     * Call this from a dispatch path that has a record in hand. Ordering from
+     * {@link SortBySequence} is preserved.
+     */
+    FilterByScope(entityActions: MJEntityActionEntityExtended[], subject: BaseEntity | undefined | null): Promise<MJEntityActionEntityExtended[]>;
     /**
      * Helper method to get the MJEntityActionEntityExtended object for a given entity ID
      * @param entityID

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

@@ -1 +1 @@
-{"version":3,"file":"EntityActionEngine-Base.d.ts","sourceRoot":"","sources":["../src/EntityActionEngine-Base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA4B,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErH,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,kCAAkC,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAChO,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAE9E;;GAEG;AACH,qBAAa,4BAA4B;IACrC;;OAEG;IACI,YAAY,EAAE,4BAA4B,CAAC;IAElD;;OAEG;IACI,cAAc,EAAE,kCAAkC,CAAC;IAE1D;;OAEG;IACI,WAAW,CAAC,EAAE,QAAQ,CAAC;IAE9B;;OAEG;IACI,YAAY,CAAC,EAAE,UAAU,CAAC;IACjC;;OAEG;IACI,MAAM,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACI,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAGD;;GAEG;AACH,qBAAa,kBAAkB;IAC3B;;OAEG;IACI,SAAS,EAAE,eAAe,CAAC;IAElC;;OAEG;IACI,OAAO,EAAE,OAAO,CAAC;IAExB;;OAEG;IACI,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAEzC;;;OAGG;IACI,QAAQ,CAAC,EAAE,0BAA0B,CAAC;IAE7C;;OAEG;IACI,OAAO,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACI,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IAE9B;;;OAGG;IACI,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CACtC;AAEF;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,UAAU,CAAC,sBAAsB,CAAC;IAC1E,WAAkB,QAAQ,IAAI,sBAAsB,CAEnD;IAID,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,mBAAmB,CAAmC;IAC9D,OAAO,CAAC,4BAA4B,CAA4C;IAChF,OAAO,CAAC,oBAAoB,CAAoC;IAChE,OAAO,CAAC,wBAAwB,CAAwC;IAExE;;;;;OAKG;IACU,MAAM,CAAC,YAAY,GAAE,OAAe,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCvH;;OAEG;IACH,IAAW,eAAe,IAAI,kCAAkC,EAAE,CAEjE;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,0BAA0B,EAAE,CAEjD;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,8BAA8B,EAAE,CAEzD;IAED;;OAEG;IACH,IAAW,aAAa,IAAI,4BAA4B,EAAE,CAEzD;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,yBAAyB,EAAE,CAE/C;IAED;;;;;OAKG;IACI,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,4BAA4B,EAAE;IAI7H;;;;OAIG;IACI,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,4BAA4B,EAAE;IAI7E;;;;;;OAMG;IACI,uCAAuC,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,4BAA4B,EAAE;CAQzK"}
+{"version":3,"file":"EntityActionEngine-Base.d.ts","sourceRoot":"","sources":["../src/EntityActionEngine-Base.ts"],"names":[],"mappings":"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"}

package/dist/EntityActionEngine-Base.js

@@ -1,5 +1,6 @@
 import { BaseEngine } from "@memberjunction/core";
 import { UUIDsEqual } from "@memberjunction/global";
+import { IsEntityActionInScope, ResolveEntityActionScopeResolver } from "./EntityActionScopeResolver.js";
 /**
  * Parameters type for invoking an entity action
  */
@@ -99,7 +100,35 @@ export class EntityActionEngineBase extends BaseEngine {
      * @returns
      */
     GetActionsByEntityName(entityName, status) {
-        return this._EntityActions.filter(e => (!status || e.Status === status) && e.Entity.trim().toLowerCase() === entityName.trim().toLowerCase());
+        return this.SortBySequence(this._EntityActions.filter(e => (!status || e.Status === status) && e.Entity.trim().toLowerCase() === entityName.trim().toLowerCase()));
+    }
+    /**
+     * Orders bindings the way they will execute: ascending `Sequence`, ties broken by `Name` so the
+     * order is total and stable rather than dependent on how the rows happened to load.
+     *
+     * The dispatch loop runs bindings in array order, so this ordering IS the execution contract —
+     * a `Validate` binding that normalizes a field must be able to run before one that checks it.
+     * `Sequence` defaults to 0, so unsequenced bindings keep their pre-existing name-ordered behaviour
+     * relative to each other and run before anything deliberately pushed later.
+     */
+    SortBySequence(entityActions) {
+        return [...entityActions].sort((a, b) => {
+            const bySequence = (a.Sequence ?? 0) - (b.Sequence ?? 0);
+            return bySequence !== 0 ? bySequence : (a.Action ?? '').localeCompare(b.Action ?? '');
+        });
+    }
+    /**
+     * Narrows a candidate set to the bindings that apply to `subject`, honouring `ScopeEntityID` /
+     * `ScopeRecordID`. Unscoped bindings (the overwhelming majority, and the pre-existing behaviour)
+     * always apply; scoped ones are asked of the `@RegisterClass`-resolved
+     * {@link EntityActionScopeResolver} for their scope entity.
+     *
+     * Call this from a dispatch path that has a record in hand. Ordering from
+     * {@link SortBySequence} is preserved.
+     */
+    async FilterByScope(entityActions, subject) {
+        const verdicts = await Promise.all(entityActions.map(ea => IsEntityActionInScope(ea, subject, name => ResolveEntityActionScopeResolver(name))));
+        return entityActions.filter((_ea, i) => verdicts[i]);
     }
     /**
      * Helper method to get the MJEntityActionEntityExtended object for a given entity ID
@@ -107,7 +136,7 @@ export class EntityActionEngineBase extends BaseEngine {
      * @returns
      */
     GetActionsByEntityID(entityID) {
-        return this._EntityActions.filter(e => UUIDsEqual(e.EntityID, entityID));
+        return this.SortBySequence(this._EntityActions.filter(e => UUIDsEqual(e.EntityID, entityID)));
     }
     /**
      * Helper method to get the MJEntityActionEntityExtended object for a given entity name and invocation type

package/dist/EntityActionEngine-Base.js.map

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

package/dist/EntityActionScopeResolver.d.ts

@@ -0,0 +1,93 @@
+import { BaseEntity, EntityInfo } from "@memberjunction/core";
+import { MJEntityActionEntityExtended } from "./MJEntityActionEntityExtended.js";
+/**
+ * ============================================================================
+ * SCOPE RESOLUTION SEAM
+ * ============================================================================
+ *
+ * An `EntityAction` may be narrowed to ONE configuration record — *this Deal
+ * Type*, *this Contract Type*, *this Pipeline*, *this Company* — via the
+ * `ScopeEntityID` / `ScopeRecordID` pair. `NULL` means "applies to every record
+ * of the entity", which is the pre-existing behaviour and by far the common case.
+ *
+ * The framework **stores and filters on the pair; it does not interpret it.**
+ * *How* a scope record relates to a subject record is an application concern:
+ * Sales knows a Deal reaches its Deal Type through `Deal.DealTypeID`, and core
+ * must not. So the question *"does this subject record fall under this scope
+ * record?"* is answered by a `@RegisterClass`-resolved resolver, keyed by scope
+ * entity name, most-specific wins — the same shape as `BasePriceResolver` in
+ * BizApps Orders and `GLAccountResolver` in Accounting.
+ *
+ * The default implementation below walks the subject entity's foreign keys
+ * looking for one that points at the scope entity. That covers the direct case
+ * (Sales registers nothing for `Deal Types` because `Deal.DealTypeID` is found
+ * automatically). An app needing something indirect — scope by Company where the
+ * subject reaches Company through a Pipeline — registers its own resolver:
+ *
+ * ```typescript
+ * @RegisterClass(EntityActionScopeResolver, 'Companies')
+ * export class CompanyScopeResolver extends EntityActionScopeResolver {
+ *     public override async IsInScope(subject: BaseEntity, scopeEntityID: string, scopeRecordID: string): Promise<boolean | null> {
+ *         // return null to decline and fall back to the default FK walk
+ *     }
+ * }
+ * ```
+ *
+ * **Declining returns `null`, not `false`.** `false` means "I looked and this
+ * record is out of scope"; `null` means "not my call" and falls back to the
+ * default. Conflating them would silently disable every binding a partially
+ * applicable resolver didn't recognise.
+ */
+export declare class EntityActionScopeResolver {
+    /**
+     * Answers whether `subject` falls under the scope record identified by
+     * `scopeEntityID` / `scopeRecordID`.
+     *
+     * @returns `true` / `false` for a decision, or `null` to decline and let the
+     *          caller fall back to the default foreign-key walk.
+     */
+    IsInScope(subject: BaseEntity, scopeEntityID: string, scopeRecordID: string): Promise<boolean | null>;
+    /**
+     * The default answer: look for a foreign key on the subject entity that points at the scope
+     * entity, and compare the subject's value for that field against the scope record's ID.
+     *
+     * Returns `null` when the subject has no foreign key to the scope entity at all — the
+     * relationship is indirect and only the owning app knows how to traverse it, so declining is
+     * more honest than answering `false`. Returns `null` for ambiguity too: when several distinct
+     * foreign keys point at the scope entity, picking one arbitrarily would silently bind the
+     * workflow to the wrong relationship (a `Deal` with both `OwnerCompanyID` and `ClientCompanyID`
+     * has no single defensible "the" Company).
+     */
+    protected DefaultForeignKeyWalk(subject: BaseEntity, scopeEntityID: string, scopeRecordID: string): boolean | null;
+    /** Names of the subject entity's fields that are foreign keys into the scope entity. */
+    protected FindForeignKeyFields(subjectEntity: EntityInfo, scopeEntityID: string): string[];
+    /**
+     * Compares a subject's foreign-key value against a scope record ID. Scope record IDs are stored
+     * as text and may be UUIDs (which differ in case between SQL Server and PostgreSQL) or numeric
+     * keys, so `UUIDsEqual` handles the former and a trimmed comparison the latter.
+     */
+    protected ValuesMatch(subjectValue: string, scopeRecordID: string): boolean;
+}
+/**
+ * Decides whether a candidate binding applies to a subject record.
+ *
+ * Unscoped bindings (`ScopeEntityID` NULL) always apply — that is the
+ * pre-existing behaviour and must never be narrowed. Scoped bindings ask the
+ * resolver registered for the scope entity, falling back to the default
+ * foreign-key walk when no app-specific resolver declines or exists.
+ *
+ * **Fails open on an unanswerable scope**: when the scope entity is unknown to
+ * metadata or no resolver can decide, the binding is treated as *not*
+ * applicable, because a binding an administrator deliberately narrowed should
+ * not silently fire on every record of the entity. That is the safe direction —
+ * a workflow that doesn't run is visible; one that runs on every record is a
+ * production incident.
+ */
+export declare function IsEntityActionInScope(entityAction: MJEntityActionEntityExtended, subject: BaseEntity | undefined | null, resolveResolver: (scopeEntityName: string) => EntityActionScopeResolver | null): Promise<boolean>;
+/**
+ * Resolves the {@link EntityActionScopeResolver} registered for a scope entity, most-specific wins.
+ * Falls back to the base implementation (the foreign-key walk), which is what makes the direct case —
+ * `Deal.DealTypeID` reaching `Deal Types` — work with no app registration at all.
+ */
+export declare function ResolveEntityActionScopeResolver(scopeEntityName: string): EntityActionScopeResolver | null;
+//# sourceMappingURL=EntityActionScopeResolver.d.ts.map

package/dist/EntityActionScopeResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityActionScopeResolver.d.ts","sourceRoot":"","sources":["../src/EntityActionScopeResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAY,MAAM,sBAAsB,CAAC;AAExE,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,yBAAyB;IAClC;;;;;;OAMG;IACU,SAAS,CAClB,OAAO,EAAE,UAAU,EACnB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAI1B;;;;;;;;;;OAUG;IACH,SAAS,CAAC,qBAAqB,CAC3B,OAAO,EAAE,UAAU,EACnB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACtB,OAAO,GAAG,IAAI;IAYjB,wFAAwF;IACxF,SAAS,CAAC,oBAAoB,CAAC,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE;IAM1F;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO;CAI9E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CACvC,YAAY,EAAE,4BAA4B,EAC1C,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,EACtC,eAAe,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,yBAAyB,GAAG,IAAI,GAC/E,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,eAAe,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI,CAY1G"}

package/dist/EntityActionScopeResolver.js

@@ -0,0 +1,145 @@
+import { Metadata } from "@memberjunction/core";
+import { MJGlobal, UUIDsEqual } from "@memberjunction/global";
+/**
+ * ============================================================================
+ * SCOPE RESOLUTION SEAM
+ * ============================================================================
+ *
+ * An `EntityAction` may be narrowed to ONE configuration record — *this Deal
+ * Type*, *this Contract Type*, *this Pipeline*, *this Company* — via the
+ * `ScopeEntityID` / `ScopeRecordID` pair. `NULL` means "applies to every record
+ * of the entity", which is the pre-existing behaviour and by far the common case.
+ *
+ * The framework **stores and filters on the pair; it does not interpret it.**
+ * *How* a scope record relates to a subject record is an application concern:
+ * Sales knows a Deal reaches its Deal Type through `Deal.DealTypeID`, and core
+ * must not. So the question *"does this subject record fall under this scope
+ * record?"* is answered by a `@RegisterClass`-resolved resolver, keyed by scope
+ * entity name, most-specific wins — the same shape as `BasePriceResolver` in
+ * BizApps Orders and `GLAccountResolver` in Accounting.
+ *
+ * The default implementation below walks the subject entity's foreign keys
+ * looking for one that points at the scope entity. That covers the direct case
+ * (Sales registers nothing for `Deal Types` because `Deal.DealTypeID` is found
+ * automatically). An app needing something indirect — scope by Company where the
+ * subject reaches Company through a Pipeline — registers its own resolver:
+ *
+ * ```typescript
+ * @RegisterClass(EntityActionScopeResolver, 'Companies')
+ * export class CompanyScopeResolver extends EntityActionScopeResolver {
+ *     public override async IsInScope(subject: BaseEntity, scopeEntityID: string, scopeRecordID: string): Promise<boolean | null> {
+ *         // return null to decline and fall back to the default FK walk
+ *     }
+ * }
+ * ```
+ *
+ * **Declining returns `null`, not `false`.** `false` means "I looked and this
+ * record is out of scope"; `null` means "not my call" and falls back to the
+ * default. Conflating them would silently disable every binding a partially
+ * applicable resolver didn't recognise.
+ */
+export class EntityActionScopeResolver {
+    /**
+     * Answers whether `subject` falls under the scope record identified by
+     * `scopeEntityID` / `scopeRecordID`.
+     *
+     * @returns `true` / `false` for a decision, or `null` to decline and let the
+     *          caller fall back to the default foreign-key walk.
+     */
+    async IsInScope(subject, scopeEntityID, scopeRecordID) {
+        return this.DefaultForeignKeyWalk(subject, scopeEntityID, scopeRecordID);
+    }
+    /**
+     * The default answer: look for a foreign key on the subject entity that points at the scope
+     * entity, and compare the subject's value for that field against the scope record's ID.
+     *
+     * Returns `null` when the subject has no foreign key to the scope entity at all — the
+     * relationship is indirect and only the owning app knows how to traverse it, so declining is
+     * more honest than answering `false`. Returns `null` for ambiguity too: when several distinct
+     * foreign keys point at the scope entity, picking one arbitrarily would silently bind the
+     * workflow to the wrong relationship (a `Deal` with both `OwnerCompanyID` and `ClientCompanyID`
+     * has no single defensible "the" Company).
+     */
+    DefaultForeignKeyWalk(subject, scopeEntityID, scopeRecordID) {
+        const candidates = this.FindForeignKeyFields(subject.EntityInfo, scopeEntityID);
+        if (candidates.length !== 1) {
+            return null;
+        }
+        const value = subject.Get(candidates[0]);
+        if (value === null || value === undefined) {
+            return false;
+        }
+        return this.ValuesMatch(String(value), scopeRecordID);
+    }
+    /** Names of the subject entity's fields that are foreign keys into the scope entity. */
+    FindForeignKeyFields(subjectEntity, scopeEntityID) {
+        return subjectEntity.Fields
+            .filter(f => f.RelatedEntityID && UUIDsEqual(f.RelatedEntityID, scopeEntityID))
+            .map(f => f.Name);
+    }
+    /**
+     * Compares a subject's foreign-key value against a scope record ID. Scope record IDs are stored
+     * as text and may be UUIDs (which differ in case between SQL Server and PostgreSQL) or numeric
+     * keys, so `UUIDsEqual` handles the former and a trimmed comparison the latter.
+     */
+    ValuesMatch(subjectValue, scopeRecordID) {
+        return UUIDsEqual(subjectValue, scopeRecordID) ||
+            subjectValue.trim() === (scopeRecordID ?? '').trim();
+    }
+}
+/**
+ * Decides whether a candidate binding applies to a subject record.
+ *
+ * Unscoped bindings (`ScopeEntityID` NULL) always apply — that is the
+ * pre-existing behaviour and must never be narrowed. Scoped bindings ask the
+ * resolver registered for the scope entity, falling back to the default
+ * foreign-key walk when no app-specific resolver declines or exists.
+ *
+ * **Fails open on an unanswerable scope**: when the scope entity is unknown to
+ * metadata or no resolver can decide, the binding is treated as *not*
+ * applicable, because a binding an administrator deliberately narrowed should
+ * not silently fire on every record of the entity. That is the safe direction —
+ * a workflow that doesn't run is visible; one that runs on every record is a
+ * production incident.
+ */
+export async function IsEntityActionInScope(entityAction, subject, resolveResolver) {
+    const scopeEntityID = entityAction.ScopeEntityID;
+    const scopeRecordID = entityAction.ScopeRecordID;
+    // Unscoped — applies to all records. The overwhelmingly common case, and the
+    // pre-existing behaviour, so it short-circuits before any lookup.
+    if (!scopeEntityID || !scopeRecordID) {
+        return true;
+    }
+    // A scoped binding with no subject record to test (a View/List dispatch that
+    // hasn't resolved to a record yet) cannot be evaluated — decline rather than
+    // fire it against everything.
+    if (!subject) {
+        return false;
+    }
+    const scopeEntity = new Metadata().EntityByID(scopeEntityID); // global-provider-ok: entity-definition lookup (structural metadata)
+    if (!scopeEntity) {
+        return false;
+    }
+    const resolver = resolveResolver(scopeEntity.Name);
+    if (!resolver) {
+        return false;
+    }
+    const answer = await resolver.IsInScope(subject, scopeEntityID, scopeRecordID);
+    return answer === true;
+}
+/**
+ * Resolves the {@link EntityActionScopeResolver} registered for a scope entity, most-specific wins.
+ * Falls back to the base implementation (the foreign-key walk), which is what makes the direct case —
+ * `Deal.DealTypeID` reaching `Deal Types` — work with no app registration at all.
+ */
+export function ResolveEntityActionScopeResolver(scopeEntityName) {
+    // GetRegistration first: having NO app-specific resolver is the normal, expected case (the default
+    // foreign-key walk is the whole point), and going straight to CreateInstance would log a
+    // "no registration found" warning on every scoped dispatch for something that isn't a problem.
+    const registration = MJGlobal.Instance.ClassFactory.GetRegistration(EntityActionScopeResolver, scopeEntityName);
+    if (!registration) {
+        return new EntityActionScopeResolver();
+    }
+    return MJGlobal.Instance.ClassFactory.CreateInstance(EntityActionScopeResolver, scopeEntityName) ?? new EntityActionScopeResolver();
+}
+//# sourceMappingURL=EntityActionScopeResolver.js.map

package/dist/EntityActionScopeResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityActionScopeResolver.js","sourceRoot":"","sources":["../src/EntityActionScopeResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAG9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,OAAO,yBAAyB;IAClC;;;;;;OAMG;IACI,KAAK,CAAC,SAAS,CAClB,OAAmB,EACnB,aAAqB,EACrB,aAAqB;QAErB,OAAO,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;OAUG;IACO,qBAAqB,CAC3B,OAAmB,EACnB,aAAqB,EACrB,aAAqB;QAErB,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAChF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC;IAC1D,CAAC;IAED,wFAAwF;IAC9E,oBAAoB,CAAC,aAAyB,EAAE,aAAqB;QAC3E,OAAO,aAAa,CAAC,MAAM;aACtB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,IAAI,UAAU,CAAC,CAAC,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;aAC9E,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACO,WAAW,CAAC,YAAoB,EAAE,aAAqB;QAC7D,OAAO,UAAU,CAAC,YAAY,EAAE,aAAa,CAAC;YAC1C,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,CAAC;CACJ;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,YAA0C,EAC1C,OAAsC,EACtC,eAA8E;IAE9E,MAAM,aAAa,GAAG,YAAY,CAAC,aAAa,CAAC;IACjD,MAAM,aAAa,GAAG,YAAY,CAAC,aAAa,CAAC;IAEjD,6EAA6E;IAC7E,kEAAkE;IAClE,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,6EAA6E;IAC7E,6EAA6E;IAC7E,8BAA8B;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,QAAQ,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,qEAAqE;IACnI,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IAC/E,OAAO,MAAM,KAAK,IAAI,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAAC,eAAuB;IACpE,mGAAmG;IACnG,yFAAyF;IACzF,+FAA+F;IAC/F,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,eAAe,CAAC,yBAAyB,EAAE,eAAe,CAAC,CAAC;IAChH,IAAI,CAAC,YAAY,EAAE,CAAC;QAChB,OAAO,IAAI,yBAAyB,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,cAAc,CAChD,yBAAyB,EACzB,eAAe,CAClB,IAAI,IAAI,yBAAyB,EAAE,CAAC;AACzC,CAAC"}

package/dist/ParamRedaction.d.ts

@@ -0,0 +1,97 @@
+import { MJActionParamEntity, MJEntityActionParamEntity } from "@memberjunction/core-entities";
+import { ActionParam } from "./ActionEngine-Base.js";
+/**
+ * ============================================================================
+ * PARAMETER REDACTION — the single place action parameter values are made safe
+ * to persist.
+ * ============================================================================
+ *
+ * **THE INVARIANT: no code path may write a raw `ActionParam[]` to persistent
+ * storage.** Every persister — `ActionExecutionLog.Params` / `.ResultParams`,
+ * `QueueTask.Data`, and anything added later — routes through
+ * {@link RedactParams} first. Redaction lives here, with the parameters, rather
+ * than inside any one persister, because a persister-local implementation
+ * covers exactly one door: routing entity-action `After*` invocations through
+ * the queue would re-open the hole one layer down via `QueueTask.Data`.
+ *
+ * The posture is **fail-closed** for whole records and **opt-out** for
+ * everything else, applied in this order:
+ *
+ * | # | Rule | Beats |
+ * |---|---|---|
+ * | 1 | An Entity Action binding whose `ValueType` is `'Entity Object'` or `'Entity Object Data'` is **never** logged. Whole records by definition. **No configuration can re-enable it.** | everything |
+ * | 2 | `EntityActionParam.LogValue = 0` — per-binding suppression. `NULL` inherits rule 3. | rule 3 |
+ * | 3 | `ActionParam.LogValue = 0` — the definition declares the parameter unloggable. Default `1`. | — |
+ *
+ * When a value is suppressed the log still records **the shape** — name, type,
+ * value type, byte length, key count and truncated top-level keys — so
+ * *"it was called with the 41-column deal row, not the 3-field summary"* stays
+ * answerable without the payload being readable. **Shape, never values.** Only
+ * top-level keys are walked: for a record those are column names, i.e. schema.
+ * Deeper structure can encode content (a `Notes` object keyed by author), so it
+ * is deliberately not descended into.
+ */
+/** Why a parameter's value was withheld from persistent storage. */
+export type ParamRedactionReason = 
+/** Rule 1 — the binding's `ValueType` passes a whole record. Not configurable. */
+'WholeRecordValueType'
+/** Rule 2 — `EntityActionParam.LogValue = 0` on this specific binding. */
+ | 'BindingLogValueFalse'
+/** Rule 3 — `ActionParam.LogValue = 0` on the parameter definition. */
+ | 'ParamLogValueFalse';
+/**
+ * The record written in place of a parameter whose value is suppressed. Carries
+ * enough shape to diagnose a run and no content.
+ */
+export interface RedactedParam {
+    /** The parameter name — always recorded, never redacted. */
+    Name: string;
+    /** Input / Output / Both — always recorded. */
+    Type: 'Input' | 'Output' | 'Both';
+    /** The Entity Action binding's `ValueType`, when the run came from a binding. */
+    ValueType?: string;
+    /** Always `false` — the marker that distinguishes a redaction record from a logged param. */
+    Logged: false;
+    /** Which rule suppressed the value. */
+    Reason: ParamRedactionReason;
+    /** UTF-8 byte length of the value's JSON form. `-1` when the value could not be serialized. */
+    ByteLength: number;
+    /** Number of top-level keys, for object values. */
+    KeyCount?: number;
+    /** Top-level key names, truncated at {@link MAX_REDACTED_KEYS}. Schema, not data. */
+    Keys?: string[];
+    /** True when {@link Keys} was truncated — so a very wide row can't reintroduce the size problem. */
+    KeysElided?: boolean;
+    /** Number of elements, for array values. */
+    ItemCount?: number;
+}
+/** A parameter as persisted: either the parameter itself, or its redaction record. */
+export type LoggedParam = ActionParam | RedactedParam;
+/**
+ * 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 declare const MAX_REDACTED_KEYS = 25;
+/** True when a redaction record (rather than a live parameter) is what's in hand. */
+export declare function IsRedactedParam(param: LoggedParam): param is RedactedParam;
+/**
+ * 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 declare function RedactParams(params: ActionParam[] | undefined | null, actionParams?: MJActionParamEntity[] | null, entityActionParams?: MJEntityActionParamEntity[] | null): LoggedParam[];
+/**
+ * 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 declare function RedactParamsToJSON(params: ActionParam[] | undefined | null, actionParams?: MJActionParamEntity[] | null, entityActionParams?: MJEntityActionParamEntity[] | null): string;
+//# sourceMappingURL=ParamRedaction.d.ts.map

package/dist/ParamRedaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParamRedaction.d.ts","sourceRoot":"","sources":["../src/ParamRedaction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,oEAAoE;AACpE,MAAM,MAAM,oBAAoB;AAC5B,kFAAkF;AAChF,sBAAsB;AACxB,0EAA0E;GACxE,sBAAsB;AACxB,uEAAuE;GACrE,oBAAoB,CAAC;AAE3B;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,MAAM,EAAE,KAAK,CAAC;IACd,uCAAuC;IACvC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,+FAA+F;IAC/F,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oGAAoG;IACpG,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sFAAsF;AACtF,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAKpC,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,IAAI,aAAa,CAE1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CACxB,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,GAAG,IAAI,EACxC,YAAY,CAAC,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAC3C,kBAAkB,CAAC,EAAE,yBAAyB,EAAE,GAAG,IAAI,GACxD,WAAW,EAAE,CAcf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,GAAG,IAAI,EACxC,YAAY,CAAC,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAC3C,kBAAkB,CAAC,EAAE,yBAAyB,EAAE,GAAG,IAAI,GACxD,MAAM,CAER"}