@memberjunction/global 5.42.0 → 5.43.0

package/dist/fieldRules/FieldRulesEvaluator.js

@@ -0,0 +1,130 @@
+import { SafeExpressionEvaluator } from '../SafeExpressionEvaluator.js';
+import { FieldTransformEngine } from './FieldTransformEngine.js';
+/**
+ * Computes the field changes a {@link FieldRuleSet} would make to a record — WITHOUT mutating anything.
+ *
+ * Returning a list of {@link FieldChange} (old → new per rule) is what makes a dry-run preview possible:
+ * the caller decides whether to apply. Conditions are evaluated with the safe expression evaluator;
+ * value formulas + the transform pipeline run through the shared {@link FieldTransformEngine}; entity
+ * lookups go through the injected resolver. The engine never touches a database itself.
+ */
+export class FieldRulesEvaluator {
+    constructor(options) {
+        this.transforms = new FieldTransformEngine();
+        this.conditions = new SafeExpressionEvaluator();
+        this.lookupResolver = options?.LookupResolver;
+        this.promptResolver = options?.PromptResolver;
+        this.entityDocumentResolver = options?.EntityDocumentResolver;
+    }
+    /** Computes one {@link FieldChange} per rule for a record (a row of field name → current value). */
+    async ComputeChanges(record, ruleSet) {
+        const changes = [];
+        for (const rule of ruleSet.Rules) {
+            changes.push(await this.evaluateRule(record, rule));
+        }
+        return changes;
+    }
+    async evaluateRule(record, rule) {
+        const oldValue = record[rule.TargetField];
+        const unchanged = (extra) => ({
+            Field: rule.TargetField, OldValue: oldValue, NewValue: oldValue, Changed: false, Applied: false, ...extra,
+        });
+        const condition = this.checkCondition(record, rule);
+        if (condition.error)
+            return unchanged({ Error: condition.error });
+        if (!condition.passed)
+            return unchanged({ SkipReason: 'condition evaluated false' });
+        let value;
+        try {
+            value = await this.resolveSource(record, rule.Source);
+        }
+        catch (err) {
+            return unchanged({ Error: `source: ${this.message(err)}` });
+        }
+        if (rule.Transforms?.length) {
+            try {
+                const result = this.transforms.ExecutePipeline(value, record, rule.Transforms);
+                if (result.Skipped)
+                    return unchanged({ SkipReason: 'transform skipped the field' });
+                value = result.Value;
+            }
+            catch (err) {
+                return unchanged({ Error: `transform: ${this.message(err)}` });
+            }
+        }
+        return {
+            Field: rule.TargetField,
+            OldValue: oldValue,
+            NewValue: value,
+            Changed: !this.equal(oldValue, value),
+            Applied: true,
+        };
+    }
+    checkCondition(record, rule) {
+        if (!rule.Condition) {
+            return { passed: true };
+        }
+        const result = this.conditions.evaluate(rule.Condition, record);
+        if (!result.success) {
+            return { passed: false, error: `condition: ${result.error ?? 'invalid expression'}` };
+        }
+        return { passed: result.value === true };
+    }
+    async resolveSource(record, source) {
+        switch (source.Kind) {
+            case 'static':
+                return source.Value;
+            case 'field':
+                return record[source.Field];
+            case 'formula':
+                return this.transforms.Evaluate(source.Expression, undefined, record);
+            case 'lookup': {
+                if (!this.lookupResolver) {
+                    throw new Error('a lookup rule was used but no LookupResolver was provided');
+                }
+                const matchValue = await this.resolveSource(record, source.Lookup.MatchValue);
+                const resolved = await this.lookupResolver({
+                    Entity: source.Lookup.Entity,
+                    MatchField: source.Lookup.MatchField,
+                    MatchValue: matchValue,
+                    ReturnField: source.Lookup.ReturnField,
+                });
+                return resolved === undefined ? (source.Lookup.Default ?? null) : resolved;
+            }
+            case 'prompt': {
+                if (!this.promptResolver) {
+                    throw new Error('a prompt rule was used but no PromptResolver was provided');
+                }
+                // By default hand the WHOLE record to the prompt; otherwise resolve each shaped Data entry
+                // through the same source machinery (so Data values can be fields, formulas, statics, …).
+                let data = record;
+                if (source.Prompt.Data) {
+                    data = {};
+                    for (const [key, valueSource] of Object.entries(source.Prompt.Data)) {
+                        data[key] = await this.resolveSource(record, valueSource);
+                    }
+                }
+                return this.promptResolver({ PromptID: source.Prompt.PromptID, Data: data });
+            }
+            case 'entityDocument': {
+                if (!this.entityDocumentResolver) {
+                    throw new Error('an entityDocument rule was used but no EntityDocumentResolver was provided');
+                }
+                return this.entityDocumentResolver({ EntityDocumentID: source.EntityDocument?.EntityDocumentID, Record: record });
+            }
+        }
+    }
+    equal(a, b) {
+        if (a === b)
+            return true;
+        if (a instanceof Date && b instanceof Date)
+            return a.getTime() === b.getTime();
+        if (a == null && b == null)
+            return true;
+        return false;
+    }
+    message(err) {
+        return err instanceof Error ? err.message : String(err);
+    }
+}
+//# sourceMappingURL=FieldRulesEvaluator.js.map

package/dist/fieldRules/FieldRulesEvaluator.js.map

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

package/dist/fieldRules/FieldTransformEngine.d.ts

@@ -0,0 +1,44 @@
+import type { TransformStep, TransformStepResult } from './transforms.js';
+/** Signature of a compiled custom/formula expression: `(value, fields) => result`. */
+export type CompiledExpression = (value: unknown, fields: Record<string, unknown>) => unknown;
+/**
+ * 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 declare class FieldTransformEngine {
+    private readonly compiledExpressionCache;
+    /**
+     * 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: unknown, fields: Record<string, unknown>, steps: TransformStep[]): TransformStepResult;
+    /**
+     * 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: TransformStep, value: unknown, fields: Record<string, unknown>): TransformStepResult;
+    /**
+     * 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: string, value: unknown, fields: Record<string, unknown>): unknown;
+    private dispatch;
+    private handleError;
+    private applyDirect;
+    private applyRegex;
+    private applySplit;
+    private applyCombine;
+    private applyLookup;
+    private applyFormat;
+    private applyCoerce;
+    private applySubstring;
+    private getCompiled;
+    private compile;
+}
+//# sourceMappingURL=FieldTransformEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FieldTransformEngine.d.ts","sourceRoot":"","sources":["../../src/fieldRules/FieldTransformEngine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,aAAa,EAEb,mBAAmB,EAUtB,MAAM,cAAc,CAAC;AAEtB,sFAAsF;AACtF,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;AAE9F;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAwD;IAEhG;;;OAGG;IACI,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,mBAAmB;IAYpH;;;OAGG;IACI,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB;IAS7G;;;;OAIG;IACI,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAI7F,OAAO,CAAC,QAAQ;IAoChB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,OAAO;CAQlB"}

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":"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"}

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"}