@memberjunction/global 5.41.0 → 5.43.0

package/dist/fieldRules/FieldTransformEngine.js

@@ -0,0 +1,189 @@
+import { MJLruCache } from '../MJLruCache.js';
+import { GetFieldTransform } from './transformRegistry.js';
+/**
+ * Framework-agnostic engine that runs a field-value transform pipeline over a single `(value, fields)`
+ * pair. Lifted from the MemberJunction integration field-mapping engine so the integration sync AND the
+ * rules-based bulk-update processor share one implementation of every transform type.
+ *
+ * Holds an LRU cache of compiled custom/formula expressions (an identical expression compiles once, not
+ * once per record). A failed compile is cached as the `Error` it threw and re-thrown from cache, so a
+ * malformed expression is compiled exactly once across a whole batch.
+ */
+export class FieldTransformEngine {
+    constructor() {
+        this.compiledExpressionCache = new MJLruCache();
+    }
+    /**
+     * Runs `value` through every step of `steps`, returning the final value (or `Skipped` when an
+     * OnError='Skip' step drops the field). `fields` is the full record, available to combine/custom steps.
+     */
+    ExecutePipeline(value, fields, steps) {
+        let current = value;
+        for (const step of steps) {
+            const result = this.ExecuteStep(step, current, fields);
+            if (result.Skipped) {
+                return result;
+            }
+            current = result.Value;
+        }
+        return { Value: current, Skipped: false };
+    }
+    /**
+     * Executes a single transform step, applying the configured transformation and handling errors
+     * according to the step's OnError strategy (default 'Null' — grace: null the field, keep going).
+     */
+    ExecuteStep(step, value, fields) {
+        const onError = step.OnError ?? 'Null';
+        try {
+            return { Value: this.dispatch(step, value, fields), Skipped: false };
+        }
+        catch (err) {
+            return this.handleError(onError, err);
+        }
+    }
+    /**
+     * Evaluates a value-producing expression against the record. Reuses the compiled-expression cache.
+     * The expression sees the current field value as `value` and all record fields as `fields`
+     * (e.g. `fields.FirstName + ' ' + fields.LastName`).
+     */
+    Evaluate(expression, value, fields) {
+        return this.getCompiled(expression)(value, fields);
+    }
+    dispatch(step, value, fields) {
+        switch (step.Type) {
+            case 'direct':
+                return this.applyDirect(value, step.Config);
+            case 'regex':
+                return this.applyRegex(value, step.Config);
+            case 'split':
+                return this.applySplit(value, step.Config);
+            case 'combine':
+                return this.applyCombine(fields, step.Config);
+            case 'lookup':
+                return this.applyLookup(value, step.Config);
+            case 'format':
+                return this.applyFormat(value, step.Config);
+            case 'coerce':
+                return this.applyCoerce(value, step.Config);
+            case 'substring':
+                return this.applySubstring(value, step.Config);
+            case 'custom':
+                try {
+                    return this.Evaluate(step.Config.Expression, value, fields);
+                }
+                catch (err) {
+                    throw new Error(`Custom transform expression failed: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            default: {
+                // Not a built-in — dispatch to a registered plugin (e.g. 'jsonpath' / 'xpath', whose
+                // libraries must not be deps of this package). See {@link RegisterFieldTransform}.
+                const plugin = GetFieldTransform(step.Type);
+                if (plugin) {
+                    return plugin(value, fields, step.Config);
+                }
+                throw new Error(`Unknown transform type '${step.Type}'. If it is a plugin transform (e.g. 'jsonpath'/'xpath'), import the package that registers it before running.`);
+            }
+        }
+    }
+    handleError(onError, err) {
+        switch (onError) {
+            case 'Skip':
+                return { Value: undefined, Skipped: true };
+            case 'Null':
+                return { Value: null, Skipped: false };
+            case 'Fail':
+                throw err;
+        }
+    }
+    applyDirect(value, config) {
+        return value == null && config.DefaultValue !== undefined ? config.DefaultValue : value;
+    }
+    applyRegex(value, config) {
+        return String(value ?? '').replace(new RegExp(config.Pattern, config.Flags ?? ''), config.Replacement);
+    }
+    applySplit(value, config) {
+        return String(value ?? '').split(config.Delimiter)[config.Index] ?? null;
+    }
+    applyCombine(fields, config) {
+        return config.SourceFields.map((f) => String(fields[f] ?? '')).join(config.Separator);
+    }
+    applyLookup(value, config) {
+        const lowerKey = String(value ?? '').toLowerCase();
+        const entry = Object.entries(config.Map).find(([key]) => key.toLowerCase() === lowerKey);
+        return entry ? entry[1] : (config.Default ?? null);
+    }
+    applyFormat(value, config) {
+        if (config.FormatType === 'date') {
+            const dateVal = value instanceof Date ? value : new Date(String(value));
+            if (isNaN(dateVal.getTime())) {
+                throw new Error(`Cannot format "${String(value)}" as a date`);
+            }
+            return config.FormatString.toLowerCase() === 'iso' || config.FormatString === 'ISO8601'
+                ? dateVal.toISOString()
+                : dateVal.toLocaleDateString('en-US');
+        }
+        if (config.FormatType === 'number') {
+            const numVal = Number(value);
+            if (!Number.isFinite(numVal)) {
+                throw new Error(`Cannot format "${String(value)}" as a number`);
+            }
+            return numVal.toFixed(Number(config.FormatString) || 0);
+        }
+        return String(value ?? '');
+    }
+    applyCoerce(value, config) {
+        switch (config.TargetType) {
+            case 'string':
+                return String(value ?? '');
+            case 'number': {
+                const num = Number(value);
+                if (isNaN(num)) {
+                    throw new Error(`Cannot coerce "${String(value)}" to number`);
+                }
+                return num;
+            }
+            case 'boolean': {
+                if (typeof value === 'boolean')
+                    return value;
+                if (typeof value === 'number')
+                    return value !== 0;
+                const s = String(value).toLowerCase().trim();
+                return s === 'true' || s === '1' || s === 'yes';
+            }
+            case 'date': {
+                const d = new Date(String(value));
+                if (isNaN(d.getTime())) {
+                    throw new Error(`Cannot coerce "${String(value)}" to date`);
+                }
+                return d;
+            }
+            default:
+                throw new Error(`Unknown coerce target type: ${config.TargetType}`);
+        }
+    }
+    applySubstring(value, config) {
+        const s = String(value ?? '');
+        return config.Length !== undefined ? s.substring(config.Start, config.Start + config.Length) : s.substring(config.Start);
+    }
+    getCompiled(expression) {
+        let cached = this.compiledExpressionCache.Get(expression);
+        if (cached === undefined) {
+            cached = this.compile(expression);
+            this.compiledExpressionCache.Set(expression, cached);
+        }
+        if (cached instanceof Error) {
+            throw cached;
+        }
+        return cached;
+    }
+    compile(expression) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-implied-eval
+            return new Function('value', 'fields', `return (${expression});`);
+        }
+        catch (err) {
+            return err instanceof Error ? err : new Error(String(err));
+        }
+    }
+}
+//# sourceMappingURL=FieldTransformEngine.js.map

package/dist/fieldRules/FieldTransformEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldTransformEngine.js","sourceRoot":"","sources":["../../src/fieldRules/FieldTransformEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAmBxD;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAoB;IAAjC;QACqB,4BAAuB,GAAG,IAAI,UAAU,EAAsC,CAAC;IAuLpG,CAAC;IArLG;;;OAGG;IACI,eAAe,CAAC,KAAc,EAAE,MAA+B,EAAE,KAAsB;QAC1F,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACvD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,MAAM,CAAC;YAClB,CAAC;YACD,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACI,WAAW,CAAC,IAAmB,EAAE,KAAc,EAAE,MAA+B;QACnF,MAAM,OAAO,GAAqB,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC;QACzD,IAAI,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACzE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,QAAQ,CAAC,UAAkB,EAAE,KAAc,EAAE,MAA+B;QAC/E,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAEO,QAAQ,CAAC,IAAmB,EAAE,KAAc,EAAE,MAA+B;QACjF,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,QAAQ;gBACT,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,MAAsB,CAAC,CAAC;YAChE,KAAK,OAAO;gBACR,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,MAAqB,CAAC,CAAC;YAC9D,KAAK,OAAO;gBACR,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,MAAqB,CAAC,CAAC;YAC9D,KAAK,SAAS;gBACV,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,MAAuB,CAAC,CAAC;YACnE,KAAK,QAAQ;gBACT,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,MAAsB,CAAC,CAAC;YAChE,KAAK,QAAQ;gBACT,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,MAAsB,CAAC,CAAC;YAChE,KAAK,QAAQ;gBACT,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,MAAsB,CAAC,CAAC;YAChE,KAAK,WAAW;gBACZ,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,MAAyB,CAAC,CAAC;YACtE,KAAK,QAAQ;gBACT,IAAI,CAAC;oBACD,OAAO,IAAI,CAAC,QAAQ,CAAE,IAAI,CAAC,MAAuB,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBAClF,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACX,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC/G,CAAC;YACL,OAAO,CAAC,CAAC,CAAC;gBACN,qFAAqF;gBACrF,mFAAmF;gBACnF,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5C,IAAI,MAAM,EAAE,CAAC;oBACT,OAAO,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC9C,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,2BAA4B,IAAsB,CAAC,IAAI,gHAAgH,CAAC,CAAC;YAC7L,CAAC;QACL,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,OAAyB,EAAE,GAAY;QACvD,QAAQ,OAAO,EAAE,CAAC;YACd,KAAK,MAAM;gBACP,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC/C,KAAK,MAAM;gBACP,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC3C,KAAK,MAAM;gBACP,MAAM,GAAG,CAAC;QAClB,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,KAAc,EAAE,MAAoB;QACpD,OAAO,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5F,CAAC;IAEO,UAAU,CAAC,KAAc,EAAE,MAAmB;QAClD,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3G,CAAC;IAEO,UAAU,CAAC,KAAc,EAAE,MAAmB;QAClD,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IAC7E,CAAC;IAEO,YAAY,CAAC,MAA+B,EAAE,MAAqB;QACvE,OAAO,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1F,CAAC;IAEO,WAAW,CAAC,KAAc,EAAE,MAAoB;QACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,CAAC;QACzF,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;IACvD,CAAC;IAEO,WAAW,CAAC,KAAc,EAAE,MAAoB;QACpD,IAAI,MAAM,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACxE,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS;gBACnF,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE;gBACvB,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC/B,CAAC;IAEO,WAAW,CAAC,KAAc,EAAE,MAAoB;QACpD,QAAQ,MAAM,CAAC,UAAU,EAAE,CAAC;YACxB,KAAK,QAAQ;gBACT,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC/B,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACZ,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC1B,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;oBACb,MAAM,IAAI,KAAK,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBAClE,CAAC;gBACD,OAAO,GAAG,CAAC;YACf,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBACb,IAAI,OAAO,KAAK,KAAK,SAAS;oBAAE,OAAO,KAAK,CAAC;gBAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;oBAAE,OAAO,KAAK,KAAK,CAAC,CAAC;gBAClD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;gBAC7C,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC;YACpD,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACV,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAClC,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;oBACrB,MAAM,IAAI,KAAK,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBAChE,CAAC;gBACD,OAAO,CAAC,CAAC;YACb,CAAC;YACD;gBACI,MAAM,IAAI,KAAK,CAAC,+BAAgC,MAAuB,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9F,CAAC;IACL,CAAC;IAEO,cAAc,CAAC,KAAc,EAAE,MAAuB;QAC1D,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7H,CAAC;IAEO,WAAW,CAAC,UAAkB;QAClC,IAAI,MAAM,GAAG,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAClC,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;YAC1B,MAAM,MAAM,CAAC;QACjB,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAEO,OAAO,CAAC,UAAkB;QAC9B,IAAI,CAAC;YACD,8DAA8D;YAC9D,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,UAAU,IAAI,CAAuB,CAAC;QAC5F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,CAAC;IACL,CAAC;CACJ"}

package/dist/fieldRules/index.d.ts

@@ -0,0 +1,6 @@
+export * from './transforms.js';
+export * from './transformRegistry.js';
+export * from './FieldTransformEngine.js';
+export * from './rules.js';
+export * from './FieldRulesEvaluator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/fieldRules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fieldRules/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC"}

package/dist/fieldRules/index.js

@@ -0,0 +1,6 @@
+export * from './transforms.js';
+export * from './transformRegistry.js';
+export * from './FieldTransformEngine.js';
+export * from './rules.js';
+export * from './FieldRulesEvaluator.js';
+//# sourceMappingURL=index.js.map

package/dist/fieldRules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fieldRules/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC"}

package/dist/fieldRules/rules.d.ts

@@ -0,0 +1,135 @@
+import type { TransformStep } from './transforms.js';
+/**
+ * How a field rule produces its base value (before any transform pipeline runs):
+ *  - `static`  — a literal constant
+ *  - `field`   — copy another field's current value
+ *  - `formula` — a JS value expression over the record (`fields.X`), e.g. `fields.FirstName + ' ' + fields.LastName`
+ *  - `lookup`  — resolve a value from another entity by matching a key (requires a LookupResolver)
+ *  - `prompt`  — run an AI prompt over the record and use its output (requires a PromptResolver). By
+ *    default the WHOLE record is passed as the prompt's data; supply `Data` to send a narrower / shaped
+ *    context (e.g. a rendered entity-document of the record). Powerful but one model call PER record —
+ *    use the dry-run preview + bounded concurrency, and prefer it for enrichment/summarization fields.
+ */
+export type FieldRuleValueSource = {
+    Kind: 'static';
+    Value: unknown;
+} | {
+    Kind: 'field';
+    Field: string;
+} | {
+    Kind: 'formula';
+    Expression: string;
+} | {
+    Kind: 'lookup';
+    Lookup: FieldRuleLookup;
+} | {
+    Kind: 'prompt';
+    Prompt: FieldRulePrompt;
+} | {
+    Kind: 'entityDocument';
+    EntityDocument?: FieldRuleEntityDocument;
+};
+/**
+ * Renders the record as text via an MJ Entity Document template (the same templates used for
+ * embeddings/RAG), using the existing rendering infrastructure through an injected
+ * {@link EntityDocumentResolver}. Most useful inside a `prompt` source's `Data` — hand the LLM a rich,
+ * curated rendering of the record instead of raw fields.
+ */
+export interface FieldRuleEntityDocument {
+    /** Which Entity Document template to render. Omit to use the entity's default/primary document. */
+    EntityDocumentID?: string;
+}
+/** An AI prompt source: run a prompt over the record and use its output as the field value. */
+export interface FieldRulePrompt {
+    /** The AI prompt to run (its ID). */
+    PromptID: string;
+    /**
+     * Optional shaping of the data handed to the prompt. Omit to pass the whole record. Each entry's
+     * value is computed like any other source (`field` / `formula` / `static`), so you can pass selected
+     * fields, derived values, or a pre-rendered entity-document string under named keys.
+     */
+    Data?: Record<string, FieldRuleValueSource>;
+}
+/** An entity lookup: find a record where MatchField === (computed) MatchValue, return ReturnField. */
+export interface FieldRuleLookup {
+    /** Entity to look in (e.g. 'Accounts'). */
+    Entity: string;
+    /** Field on the lookup entity to match against. */
+    MatchField: string;
+    /** How to compute the value to match (static / field / formula). */
+    MatchValue: FieldRuleValueSource;
+    /** Field to return from the matched record. */
+    ReturnField: string;
+    /** Value to use when no record matches. */
+    Default?: unknown;
+}
+/** A single rule: set TargetField from Source (optionally transformed), gated by an optional Condition. */
+export interface FieldRule {
+    /** The field on the record to set. */
+    TargetField: string;
+    /** How to produce the base value. */
+    Source: FieldRuleValueSource;
+    /** Optional transform pipeline applied to the computed value. */
+    Transforms?: TransformStep[];
+    /** Optional boolean expression over the record — the rule only applies when it evaluates true. */
+    Condition?: string;
+}
+/** An ordered set of field rules applied to each record. */
+export interface FieldRuleSet {
+    Rules: FieldRule[];
+}
+/** The computed outcome of one rule for one record — the unit of a dry-run preview. */
+export interface FieldChange {
+    /** The target field. */
+    Field: string;
+    /** The record's current value. */
+    OldValue: unknown;
+    /** The computed new value (equals OldValue when not Applied). */
+    NewValue: unknown;
+    /** True when NewValue differs from OldValue. */
+    Changed: boolean;
+    /** True when the rule produced a value to write (condition passed, no skip/error). */
+    Applied: boolean;
+    /** Why the rule did not apply (condition false / transform skipped). */
+    SkipReason?: string;
+    /** Set when computing the value errored (condition or source/transform). */
+    Error?: string;
+}
+/** A lookup with its MatchValue already resolved to a concrete value, handed to the LookupResolver. */
+export interface ResolvedLookup {
+    Entity: string;
+    MatchField: string;
+    MatchValue: unknown;
+    ReturnField: string;
+}
+/**
+ * Resolves an entity lookup to a value. Injected into the evaluator so the engine stays framework-pure
+ * (the bulk-update processor supplies a RunView-backed resolver; unit tests supply a stub).
+ * Should return the matched record's ReturnField value, or `undefined` when nothing matches.
+ */
+export type LookupResolver = (lookup: ResolvedLookup) => Promise<unknown>;
+/** A prompt source with its data already resolved to concrete values, handed to the PromptResolver. */
+export interface ResolvedPrompt {
+    PromptID: string;
+    /** The data context for the prompt run (the whole record by default, or the shaped `Data` map). */
+    Data: Record<string, unknown>;
+}
+/**
+ * Runs an AI prompt and returns its output value. Injected into the evaluator so the engine itself never
+ * depends on the AI stack — the bulk-update processor supplies a real `AIPromptRunner`-backed resolver;
+ * unit tests supply a stub. This is the same dependency-inversion seam as {@link LookupResolver}.
+ */
+export type PromptResolver = (prompt: ResolvedPrompt) => Promise<unknown>;
+/** An entity-document source with its record handed to the {@link EntityDocumentResolver} to render. */
+export interface ResolvedEntityDocument {
+    EntityDocumentID?: string;
+    /** The record's field values, to render through the Entity Document template. */
+    Record: Record<string, unknown>;
+}
+/**
+ * Renders a record to text via the existing Entity Document / Template infrastructure. Injected so the
+ * engine never depends on `@memberjunction/templates` or the AI/vector stack — the bulk-update processor
+ * supplies a resolver backed by the real render infra. Same dependency-inversion seam as the others.
+ */
+export type EntityDocumentResolver = (doc: ResolvedEntityDocument) => Promise<string>;
+//# sourceMappingURL=rules.d.ts.map

package/dist/fieldRules/rules.d.ts.map

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

package/dist/fieldRules/rules.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rules.js.map

package/dist/fieldRules/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/fieldRules/rules.ts"],"names":[],"mappings":""}

package/dist/fieldRules/transformRegistry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * A pluggable transform handler: `(value, fields, config) => result`. Same call shape as the built-in
+ * transforms, so a plugin is indistinguishable from a built-in at the call site.
+ */
+export type FieldTransformPlugin = (value: unknown, fields: Record<string, unknown>, config: unknown) => unknown;
+/**
+ * Registers a transform plugin by type name so the {@link FieldTransformEngine} can dispatch a
+ * non-built-in transform to it.
+ *
+ * This is how heavier transforms (e.g. `jsonpath`, `xpath`) are added WITHOUT making their libraries
+ * (jsonpath-plus, xpath, @xmldom/xmldom, …) dependencies of this foundational package: a separate
+ * package owns the libs, implements the handler, and calls this at module-load to register it. Any
+ * `FieldTransformEngine` in the process (integration sync, rules-based bulk update, …) then supports the
+ * transform — the engine stays lib-free, the plugin owns the deps. Idempotent per type (last wins).
+ *
+ * @param type - The transform `Type` string (case-insensitive), e.g. `'jsonpath'`.
+ * @param plugin - The handler.
+ */
+export declare function RegisterFieldTransform(type: string, plugin: FieldTransformPlugin): void;
+/** Returns the registered plugin for a transform type, or `undefined` if none is registered. */
+export declare function GetFieldTransform(type: string): FieldTransformPlugin | undefined;
+//# sourceMappingURL=transformRegistry.d.ts.map

package/dist/fieldRules/transformRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformRegistry.d.ts","sourceRoot":"","sources":["../../src/fieldRules/transformRegistry.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;AAejH;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAEvF;AAED,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAEhF"}

package/dist/fieldRules/transformRegistry.js

@@ -0,0 +1,33 @@
+import { GetGlobalObjectStore } from '../util.js';
+/** Global-object-store key so registrations survive bundlers that duplicate this module. */
+const STORE_KEY = '__mj_FieldTransformPlugins__';
+function registry() {
+    const store = (GetGlobalObjectStore() ?? globalThis);
+    let map = store[STORE_KEY];
+    if (!map) {
+        map = new Map();
+        store[STORE_KEY] = map;
+    }
+    return map;
+}
+/**
+ * Registers a transform plugin by type name so the {@link FieldTransformEngine} can dispatch a
+ * non-built-in transform to it.
+ *
+ * This is how heavier transforms (e.g. `jsonpath`, `xpath`) are added WITHOUT making their libraries
+ * (jsonpath-plus, xpath, @xmldom/xmldom, …) dependencies of this foundational package: a separate
+ * package owns the libs, implements the handler, and calls this at module-load to register it. Any
+ * `FieldTransformEngine` in the process (integration sync, rules-based bulk update, …) then supports the
+ * transform — the engine stays lib-free, the plugin owns the deps. Idempotent per type (last wins).
+ *
+ * @param type - The transform `Type` string (case-insensitive), e.g. `'jsonpath'`.
+ * @param plugin - The handler.
+ */
+export function RegisterFieldTransform(type, plugin) {
+    registry().set(type.trim().toLowerCase(), plugin);
+}
+/** Returns the registered plugin for a transform type, or `undefined` if none is registered. */
+export function GetFieldTransform(type) {
+    return registry().get(type.trim().toLowerCase());
+}
+//# sourceMappingURL=transformRegistry.js.map

package/dist/fieldRules/transformRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformRegistry.js","sourceRoot":"","sources":["../../src/fieldRules/transformRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAQ/C,4FAA4F;AAC5F,MAAM,SAAS,GAAG,8BAA8B,CAAC;AAEjD,SAAS,QAAQ;IACb,MAAM,KAAK,GAAG,CAAC,oBAAoB,EAAE,IAAK,UAAiD,CAA4B,CAAC;IACxH,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,CAAkD,CAAC;IAC5E,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,GAAG,GAAG,IAAI,GAAG,EAAgC,CAAC;QAC9C,KAAK,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,MAA4B;IAC7E,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC1C,OAAO,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/fieldRules/transforms.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Field-value transform pipeline types.
+ *
+ * This package is the canonical home for these types. The MemberJunction integration field-mapping
+ * engine and the rules-based bulk-update processor both consume them — author once, reuse everywhere.
+ */
+/** Supported transform types for field value transformation */
+export type TransformType = 'direct' | 'regex' | 'split' | 'combine' | 'lookup' | 'format' | 'coerce' | 'substring' | 'custom' | 'jsonpath' | 'xpath';
+/** What to do when a transform step encounters an error */
+export type TransformOnError = 'Skip' | 'Null' | 'Fail';
+/** A single step in a field value transformation pipeline */
+export interface TransformStep {
+    /** The type of transform to apply */
+    Type: TransformType;
+    /** Configuration for the transform step */
+    Config: TransformConfig;
+    /** Error handling strategy for this step. Defaults to 'Null' (grace — null the field, keep going). */
+    OnError?: TransformOnError;
+}
+/** Configuration for extracting value(s) from JSON via a JSONPath expression. */
+export interface JsonPathConfig {
+    /** JSONPath expression, e.g. `$.store.book[0].title` or `$..author`. */
+    Path: string;
+    /** Return only the first match (default). When false, returns the full array of matches. */
+    First?: boolean;
+}
+/** Configuration for extracting value(s) from XML via an XPath expression. */
+export interface XPathConfig {
+    /** XPath expression, e.g. `/catalog/book[1]/title/text()` or `//author`. */
+    Path: string;
+    /** Return only the first match (default). When false, returns the full array of matches. */
+    First?: boolean;
+}
+/** Union of all transform configuration types */
+export type TransformConfig = DirectConfig | RegexConfig | SplitConfig | CombineConfig | LookupConfig | FormatConfig | JsonPathConfig | XPathConfig | CoerceConfig | SubstringConfig | CustomConfig;
+/** Configuration for direct pass-through (no transformation) */
+export interface DirectConfig {
+    /** Optional default value if source is null/undefined */
+    DefaultValue?: unknown;
+}
+/** Configuration for regex-based string transformation */
+export interface RegexConfig {
+    /** Regular expression pattern to match */
+    Pattern: string;
+    /** Replacement string (supports $1, $2, etc. for capture groups) */
+    Replacement: string;
+    /** Regex flags (e.g., 'gi' for global, case-insensitive) */
+    Flags?: string;
+}
+/** Configuration for splitting a string value and extracting a portion */
+export interface SplitConfig {
+    /** Delimiter to split on */
+    Delimiter: string;
+    /** Zero-based index of the part to extract */
+    Index: number;
+}
+/** Configuration for combining multiple source field values */
+export interface CombineConfig {
+    /** Names of source fields to combine */
+    SourceFields: string[];
+    /** Separator to place between combined values */
+    Separator: string;
+}
+/** Configuration for value lookup/mapping (in-memory translation table — not an entity lookup) */
+export interface LookupConfig {
+    /** Map of source values to destination values. Keys are matched case-insensitively */
+    Map: Record<string, unknown>;
+    /** Value to use when the source value is not found in the map */
+    Default?: unknown;
+}
+/** Configuration for date/number formatting */
+export interface FormatConfig {
+    /** The target format string. For dates: ISO8601 locale format specifiers */
+    FormatString: string;
+    /** The type of formatting to apply */
+    FormatType: 'date' | 'number' | 'string';
+}
+/** Configuration for type coercion */
+export interface CoerceConfig {
+    /** Target type to coerce the value into */
+    TargetType: 'string' | 'number' | 'boolean' | 'date';
+}
+/** Configuration for extracting a substring */
+export interface SubstringConfig {
+    /** Start index (zero-based) */
+    Start: number;
+    /** Number of characters to extract. If omitted, extracts to end */
+    Length?: number;
+}
+/** Configuration for custom JavaScript expression evaluation */
+export interface CustomConfig {
+    /** JavaScript expression to evaluate. The source value is available as 'value' and all fields as 'fields' */
+    Expression: string;
+}
+/** Result of running a transform step or pipeline. */
+export interface TransformStepResult {
+    /** The resulting value (undefined when Skipped). */
+    Value: unknown;
+    /** True when an OnError='Skip' step asked to drop the field entirely. */
+    Skipped: boolean;
+}
+//# sourceMappingURL=transforms.d.ts.map

package/dist/fieldRules/transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../../src/fieldRules/transforms.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+DAA+D;AAC/D,MAAM,MAAM,aAAa,GACnB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,UAAU,GACV,OAAO,CAAC;AAEd,2DAA2D;AAC3D,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC1B,qCAAqC;IACrC,IAAI,EAAE,aAAa,CAAC;IACpB,2CAA2C;IAC3C,MAAM,EAAE,eAAe,CAAC;IACxB,sGAAsG;IACtG,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC3B,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IACxB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,iDAAiD;AACjD,MAAM,MAAM,eAAe,GACrB,YAAY,GACZ,WAAW,GACX,WAAW,GACX,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,cAAc,GACd,WAAW,GACX,YAAY,GACZ,eAAe,GACf,YAAY,CAAC;AAEnB,gEAAgE;AAChE,MAAM,WAAW,YAAY;IACzB,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IACxB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IACxB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC1B,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,kGAAkG;AAClG,MAAM,WAAW,YAAY;IACzB,sFAAsF;IACtF,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IACzB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC5C;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAY;IACzB,2CAA2C;IAC3C,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;CACxD;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC5B,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAY;IACzB,6GAA6G;IAC7G,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAChC,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;CACpB"}

package/dist/fieldRules/transforms.js

@@ -0,0 +1,8 @@
+/**
+ * Field-value transform pipeline types.
+ *
+ * This package is the canonical home for these types. The MemberJunction integration field-mapping
+ * engine and the rules-based bulk-update processor both consume them — author once, reuse everywhere.
+ */
+export {};
+//# sourceMappingURL=transforms.js.map

package/dist/fieldRules/transforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.js","sourceRoot":"","sources":["../../src/fieldRules/transforms.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { ClassFactory, ClassRegistration } from './ClassFactory.js';
 export * from './interface.js';
 export * from './util.js';
+export * from './valueMapping.js';
 export * from './ObjectCache.js';
 export * from './MJLruCache.js';
 export * from './BaseSingleton.js';
@@ -13,9 +14,11 @@ export * from './util/SerializationUtils.js';
 export * from './ValidationTypes.js';
 export * from './JSONValidator.js';
 export * from './SafeExpressionEvaluator.js';
+export * from './fieldRules/index.js';
 export * from './SQLExpressionValidator.js';
 export * from './warningManager.js';
 export * from './EncryptionUtils.js';
+export * from './KeyedSerialTaskQueue.js';
 export * from './Global.js';
 export * from './RegisterClass.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AAMjC,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,cAAc,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AAMtC,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -2,6 +2,7 @@
 export { ClassFactory, ClassRegistration } from './ClassFactory.js';
 export * from './interface.js';
 export * from './util.js';
+export * from './valueMapping.js';
 export * from './ObjectCache.js';
 export * from './MJLruCache.js';
 export * from './BaseSingleton.js';
@@ -14,9 +15,11 @@ export * from './util/SerializationUtils.js';
 export * from './ValidationTypes.js';
 export * from './JSONValidator.js';
 export * from './SafeExpressionEvaluator.js';
+export * from './fieldRules/index.js';
 export * from './SQLExpressionValidator.js';
 export * from './warningManager.js';
 export * from './EncryptionUtils.js';
+export * from './KeyedSerialTaskQueue.js';
 // NOTE: TelemetryManager has moved to @memberjunction/core
 // Import from there instead of here
 // Export the main classes

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AAEjC,2DAA2D;AAC3D,oCAAoC;AAEpC,0BAA0B;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAE/B,6DAA6D;AAC7D,oCAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,cAAc,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AAEtC,2DAA2D;AAC3D,oCAAoC;AAEpC,0BAA0B;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAE/B,6DAA6D;AAC7D,oCAAoC"}