@memberjunction/global 5.42.0 → 5.43.0

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

@@ -14,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,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,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

@@ -15,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,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,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"}

package/package.json

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