@memberjunction/global 5.41.0 → 5.43.0

package/dist/valueMapping.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview Generic value-mapping resolver. Resolves a declarative mapping config of reference
+ * strings against a set of named sources. Genericized from the Flow Agent input-mapping mechanism so
+ * the same engine can drive agent step mappings, Record Process input/output mappings, and any other
+ * "map values from named sources" need — keeping the logic in one canonical, reusable place.
+ *
+ * Reference syntax (a mapping value that is a string):
+ *  - `static:<literal>`           → the literal text after the colon
+ *  - `<sourceName>.<path>`        → value at `path` within `sources[sourceName]` (source name matched
+ *                                   case-insensitively; `path` supports dot + `arr[0]` indexing)
+ *  - anything else                → returned verbatim (treated as a literal)
+ *
+ * Objects and arrays are resolved recursively, preserving shape.
+ */
+/**
+ * Reads a value at a dot/bracket path from an object (e.g. `a.b`, `a.items[0].name`). Path
+ * navigation is case-sensitive; returns `undefined` if any segment is missing.
+ */
+export declare function getValueAtPath(obj: unknown, path: string): unknown;
+/**
+ * Resolves a single mapping reference against the supplied named sources. See the module overview
+ * for the reference syntax. Non-string refs are returned unchanged.
+ */
+export declare function resolveMappingRef(ref: unknown, sources: Record<string, unknown>): unknown;
+/**
+ * Recursively resolves a mapping config (string / array / object) against named sources, returning a
+ * structure of the same shape with every reference resolved.
+ *
+ * @param mapping - The mapping config (e.g. `{ name: 'record.Name', when: 'static:today' }`).
+ * @param sources - Named sources to resolve references against (e.g. `{ record, context }`).
+ */
+export declare function resolveValueMapping<T = Record<string, unknown>>(mapping: unknown, sources: Record<string, unknown>): T;
+//# sourceMappingURL=valueMapping.d.ts.map

package/dist/valueMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valueMapping.d.ts","sourceRoot":"","sources":["../src/valueMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CA6BlE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAwBzF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAetH"}

package/dist/valueMapping.js

@@ -0,0 +1,104 @@
+/**
+ * @fileoverview Generic value-mapping resolver. Resolves a declarative mapping config of reference
+ * strings against a set of named sources. Genericized from the Flow Agent input-mapping mechanism so
+ * the same engine can drive agent step mappings, Record Process input/output mappings, and any other
+ * "map values from named sources" need — keeping the logic in one canonical, reusable place.
+ *
+ * Reference syntax (a mapping value that is a string):
+ *  - `static:<literal>`           → the literal text after the colon
+ *  - `<sourceName>.<path>`        → value at `path` within `sources[sourceName]` (source name matched
+ *                                   case-insensitively; `path` supports dot + `arr[0]` indexing)
+ *  - anything else                → returned verbatim (treated as a literal)
+ *
+ * Objects and arrays are resolved recursively, preserving shape.
+ */
+/**
+ * Reads a value at a dot/bracket path from an object (e.g. `a.b`, `a.items[0].name`). Path
+ * navigation is case-sensitive; returns `undefined` if any segment is missing.
+ */
+export function getValueAtPath(obj, path) {
+    if (!path) {
+        return obj;
+    }
+    let current = obj;
+    for (const part of path.split('.')) {
+        if (!part) {
+            continue;
+        }
+        const arrayMatch = part.match(/^([^[]+)\[(\d+)\]$/);
+        if (arrayMatch) {
+            const name = arrayMatch[1];
+            const index = parseInt(arrayMatch[2], 10);
+            if (current && typeof current === 'object' && name in current) {
+                const arr = current[name];
+                current = Array.isArray(arr) && index >= 0 && index < arr.length ? arr[index] : undefined;
+            }
+            else {
+                return undefined;
+            }
+        }
+        else if (current && typeof current === 'object' && part in current) {
+            current = current[part];
+        }
+        else {
+            return undefined;
+        }
+        if (current === undefined) {
+            return undefined;
+        }
+    }
+    return current;
+}
+/**
+ * Resolves a single mapping reference against the supplied named sources. See the module overview
+ * for the reference syntax. Non-string refs are returned unchanged.
+ */
+export function resolveMappingRef(ref, sources) {
+    if (typeof ref !== 'string') {
+        return ref;
+    }
+    const trimmed = ref.trim();
+    if (trimmed.toLowerCase().startsWith('static:')) {
+        return ref.substring(ref.indexOf(':') + 1);
+    }
+    // A bare reference that matches a source name returns the whole source value (useful for scalar
+    // sources, e.g. `recordId`). Checked before the dotted-path form below.
+    const wholeSourceKey = Object.keys(sources).find((k) => k.toLowerCase() === trimmed.toLowerCase());
+    if (wholeSourceKey !== undefined) {
+        return sources[wholeSourceKey];
+    }
+    const dot = trimmed.indexOf('.');
+    if (dot > 0) {
+        const sourceName = trimmed.substring(0, dot);
+        const sourceKey = Object.keys(sources).find((k) => k.toLowerCase() === sourceName.toLowerCase());
+        if (sourceKey !== undefined) {
+            const path = ref.substring(ref.indexOf('.') + 1);
+            return getValueAtPath(sources[sourceKey], path);
+        }
+    }
+    return ref; // no recognized source prefix → treat as a literal
+}
+/**
+ * Recursively resolves a mapping config (string / array / object) against named sources, returning a
+ * structure of the same shape with every reference resolved.
+ *
+ * @param mapping - The mapping config (e.g. `{ name: 'record.Name', when: 'static:today' }`).
+ * @param sources - Named sources to resolve references against (e.g. `{ record, context }`).
+ */
+export function resolveValueMapping(mapping, sources) {
+    if (typeof mapping === 'string') {
+        return resolveMappingRef(mapping, sources);
+    }
+    if (Array.isArray(mapping)) {
+        return mapping.map((item) => resolveValueMapping(item, sources));
+    }
+    if (mapping && typeof mapping === 'object') {
+        const out = {};
+        for (const [key, value] of Object.entries(mapping)) {
+            out[key] = resolveValueMapping(value, sources);
+        }
+        return out;
+    }
+    return mapping;
+}
+//# sourceMappingURL=valueMapping.js.map

package/dist/valueMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"valueMapping.js","sourceRoot":"","sources":["../src/valueMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY,EAAE,IAAY;IACrD,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,OAAO,GAAG,CAAC;IACf,CAAC;IACD,IAAI,OAAO,GAAY,GAAG,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,SAAS;QACb,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACpD,IAAI,UAAU,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1C,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,IAAI,IAAK,OAAmC,EAAE,CAAC;gBACzF,MAAM,GAAG,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;gBACvD,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9F,CAAC;iBAAM,CAAC;gBACJ,OAAO,SAAS,CAAC;YACrB,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,IAAI,IAAK,OAAmC,EAAE,CAAC;YAChG,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACJ,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY,EAAE,OAAgC;IAC5E,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,GAAG,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9C,OAAO,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,gGAAgG;IAChG,wEAAwE;IACxE,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACnG,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACV,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;QACjG,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACjD,OAAO,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC,CAAC,mDAAmD;AACnE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAA8B,OAAgB,EAAE,OAAgC;IAC/G,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAM,CAAC;IACpD,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAiB,CAAC;IACrF,CAAC;IACD,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,GAAQ,CAAC;IACpB,CAAC;IACD,OAAO,OAAY,CAAC;AACxB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/global",
   "type": "module",
-  "version": "5.41.0",
+  "version": "5.43.0",
   "description": "MemberJunction: Global Object - Needed for ALL other MJ components",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",