@oronts/vendure-data-hub-plugin 0.1.0

package/dist/src/operators/aggregation/join.operator.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * Multi-Source Join Operator
+ *
+ * Merges records from two datasets by matching on key fields.
+ * Supports INNER, LEFT, RIGHT, and FULL OUTER join types.
+ *
+ * The right-side dataset can be provided either:
+ * - Inline via `rightData` (static array of records)
+ * - From pipeline context via `rightDataPath` (dot-path to an array in the helpers context)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MULTI_JOIN_OPERATOR_DEFINITION = void 0;
+exports.multiJoinOperator = multiJoinOperator;
+const helpers_1 = require("../helpers");
+exports.MULTI_JOIN_OPERATOR_DEFINITION = {
+    type: 'OPERATOR',
+    code: 'multiJoin',
+    description: 'Join two datasets by matching key fields. Supports INNER, LEFT, RIGHT, and FULL OUTER join types.',
+    category: 'AGGREGATION',
+    categoryLabel: 'Aggregation',
+    categoryOrder: 6,
+    pure: false, // Creates/removes records based on join type
+    schema: {
+        fields: [
+            { key: 'leftKey', label: 'Left key field', type: 'string', required: true, description: 'Field path in left (primary) records to join on' },
+            { key: 'rightKey', label: 'Right key field', type: 'string', required: true, description: 'Field path in right records to join on' },
+            {
+                key: 'type', label: 'Join type', type: 'select', required: true,
+                options: [
+                    { value: 'INNER', label: 'Inner (only matches)' },
+                    { value: 'LEFT', label: 'Left (all left, match right)' },
+                    { value: 'RIGHT', label: 'Right (all right, match left)' },
+                    { value: 'FULL', label: 'Full outer (all from both)' },
+                ],
+            },
+            { key: 'rightData', label: 'Right dataset (inline)', type: 'json', description: 'Static array of right-side records' },
+            { key: 'rightDataPath', label: 'Right dataset path', type: 'string', description: 'Dot-path to right-side data in pipeline context' },
+            { key: 'prefix', label: 'Right field prefix', type: 'string', description: 'Prefix for right-side field names to avoid collisions' },
+            { key: 'select', label: 'Select right fields', type: 'json', description: 'Array of right-side field names to include (default: all)' },
+        ],
+    },
+};
+/**
+ * Resolve the right-side dataset from config or helpers context.
+ */
+function resolveRightData(config, helpers) {
+    if (config.rightData && Array.isArray(config.rightData) && config.rightData.length > 0) {
+        return config.rightData;
+    }
+    if (config.rightDataPath) {
+        const ctx = helpers.ctx;
+        if (ctx) {
+            const resolved = (0, helpers_1.getNestedValue)(ctx, config.rightDataPath);
+            if (Array.isArray(resolved)) {
+                return resolved;
+            }
+        }
+    }
+    return [];
+}
+/**
+ * Build an index of right-side records keyed by the join key value.
+ * Multiple records can share the same key (one-to-many).
+ */
+function buildIndex(records, keyPath) {
+    const index = new Map();
+    for (const record of records) {
+        const keyValue = (0, helpers_1.getNestedValue)(record, keyPath);
+        const key = keyValue == null ? '' : String(keyValue);
+        const existing = index.get(key);
+        if (existing) {
+            existing.push(record);
+        }
+        else {
+            index.set(key, [record]);
+        }
+    }
+    return index;
+}
+/**
+ * Merge right-side fields into a left record.
+ * Applies prefix and select filtering if configured.
+ */
+function mergeRecords(left, right, prefix, select) {
+    const result = (0, helpers_1.deepClone)(left);
+    if (!right) {
+        return result;
+    }
+    const rightClone = (0, helpers_1.deepClone)(right);
+    const fieldPrefix = prefix ? `${prefix}_` : '';
+    const entries = Object.entries(rightClone);
+    for (const [key, value] of entries) {
+        // If select is specified, skip fields not in the list
+        if (select && select.length > 0 && !select.includes(key)) {
+            continue;
+        }
+        const targetKey = `${fieldPrefix}${key}`;
+        result[targetKey] = value;
+    }
+    return result;
+}
+/**
+ * Create a record with null values for right-side fields.
+ * Used when a left record has no match in LEFT or FULL joins.
+ */
+function mergeWithNullRight(left, rightSample, prefix, select) {
+    const result = (0, helpers_1.deepClone)(left);
+    if (!rightSample) {
+        return result;
+    }
+    const fieldPrefix = prefix ? `${prefix}_` : '';
+    const keys = Object.keys(rightSample);
+    for (const key of keys) {
+        if (select && select.length > 0 && !select.includes(key)) {
+            continue;
+        }
+        const targetKey = `${fieldPrefix}${key}`;
+        result[targetKey] = null;
+    }
+    return result;
+}
+/**
+ * Create a record from a right-side record with null left-side fields.
+ * Used when a right record has no match in RIGHT or FULL joins.
+ */
+function mergeWithNullLeft(leftSample, right, prefix, select) {
+    const result = {};
+    // Fill left-side fields with null
+    if (leftSample) {
+        for (const key of Object.keys(leftSample)) {
+            result[key] = null;
+        }
+    }
+    // Merge right-side fields
+    const rightClone = (0, helpers_1.deepClone)(right);
+    const fieldPrefix = prefix ? `${prefix}_` : '';
+    for (const [key, value] of Object.entries(rightClone)) {
+        if (select && select.length > 0 && !select.includes(key)) {
+            continue;
+        }
+        const targetKey = `${fieldPrefix}${key}`;
+        result[targetKey] = value;
+    }
+    return result;
+}
+function multiJoinOperator(records, config, helpers) {
+    if (!config.leftKey || !config.rightKey) {
+        return { records: [...records] };
+    }
+    const joinType = config.type ?? 'LEFT';
+    const rightData = resolveRightData(config, helpers);
+    if (rightData.length === 0 && (joinType === 'INNER' || joinType === 'RIGHT')) {
+        // INNER with no right data => no results; RIGHT with no right data => no results
+        return { records: [] };
+    }
+    if (rightData.length === 0) {
+        // LEFT or FULL with no right data => return left records as-is
+        return { records: [...records] };
+    }
+    const rightIndex = buildIndex(rightData, config.rightKey);
+    const results = [];
+    // Track which right keys have been matched (for RIGHT and FULL joins)
+    const matchedRightKeys = new Set();
+    // Get a sample right record for null-filling
+    const rightSample = rightData.length > 0 ? rightData[0] : undefined;
+    const leftSample = records.length > 0 ? records[0] : undefined;
+    // Process left records
+    for (const leftRecord of records) {
+        const leftKeyValue = (0, helpers_1.getNestedValue)(leftRecord, config.leftKey);
+        const leftKey = leftKeyValue == null ? '' : String(leftKeyValue);
+        const matchingRight = rightIndex.get(leftKey);
+        if (matchingRight && matchingRight.length > 0) {
+            matchedRightKeys.add(leftKey);
+            // Emit one result per matching right record
+            for (const rightRecord of matchingRight) {
+                results.push(mergeRecords(leftRecord, rightRecord, config.prefix, config.select));
+            }
+        }
+        else if (joinType === 'LEFT' || joinType === 'FULL') {
+            // No match - include left with null right fields
+            results.push(mergeWithNullRight(leftRecord, rightSample, config.prefix, config.select));
+        }
+        // INNER and RIGHT: skip unmatched left records
+    }
+    // For RIGHT and FULL joins, include unmatched right records
+    if (joinType === 'RIGHT' || joinType === 'FULL') {
+        for (const [rightKey, rightRecords] of rightIndex) {
+            if (!matchedRightKeys.has(rightKey)) {
+                for (const rightRecord of rightRecords) {
+                    results.push(mergeWithNullLeft(leftSample, rightRecord, config.prefix, config.select));
+                }
+            }
+        }
+    }
+    return { records: results };
+}
+//# sourceMappingURL=join.operator.js.map

package/dist/src/operators/aggregation/join.operator.js.map

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

package/dist/src/operators/aggregation/types.d.ts

@@ -0,0 +1,53 @@
+import type { JoinType } from '../../../shared/types';
+import { BaseOperatorConfig, JsonObject } from '../types';
+export type { JoinType };
+export type AggregationOp = 'count' | 'sum' | 'avg' | 'min' | 'max' | 'first' | 'last';
+export interface AggregateOperatorConfig extends BaseOperatorConfig {
+    readonly op: AggregationOp;
+    readonly source?: string;
+    readonly target: string;
+    readonly groupBy?: string;
+}
+export interface CountOperatorConfig extends BaseOperatorConfig {
+    readonly source: string;
+    readonly target: string;
+}
+export interface UniqueOperatorConfig extends BaseOperatorConfig {
+    readonly source: string;
+    readonly target?: string;
+    readonly by?: string;
+}
+export interface FlattenOperatorConfig extends BaseOperatorConfig {
+    readonly source: string;
+    readonly target?: string;
+    readonly depth?: number;
+}
+export interface FirstLastOperatorConfig extends BaseOperatorConfig {
+    readonly source: string;
+    readonly target: string;
+}
+export interface ExpandOperatorConfig extends BaseOperatorConfig {
+    /** Path to the array to expand */
+    readonly path: string;
+    /** Whether to merge parent fields into each expanded record */
+    readonly mergeParent?: boolean;
+    /** Map of parent fields to include: { targetField: sourceFieldPath } */
+    readonly parentFields?: Record<string, string>;
+}
+export interface MultiJoinOperatorConfig extends BaseOperatorConfig {
+    /** Field path in left (primary) records to join on */
+    readonly leftKey: string;
+    /** Field path in right records to join on */
+    readonly rightKey: string;
+    /** Static right-side dataset provided inline */
+    readonly rightData?: JsonObject[];
+    /** Dot-path to right-side data from pipeline context */
+    readonly rightDataPath?: string;
+    /** Join type: INNER, LEFT, RIGHT, or FULL (default: LEFT) */
+    readonly type?: JoinType;
+    /** Prefix for right-side field names to avoid collisions */
+    readonly prefix?: string;
+    /** Which right-side fields to include (default: all) */
+    readonly select?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/operators/aggregation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/operators/aggregation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE1D,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAEvF,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IAC/D,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC5D,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IAC/D,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;IAClC,wDAAwD;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B"}

package/dist/src/operators/aggregation/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/operators/aggregation/types.js.map

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

package/dist/src/operators/constants.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Validation rule types for operator validation errors.
+ * Used as the `rule` field in ValidationError objects.
+ */
+export declare const VALIDATION_RULE: {
+    readonly REQUIRED: "required";
+    readonly FORMAT: "format";
+    readonly TYPE: "type";
+    readonly RANGE: "range";
+    readonly PATTERN: "pattern";
+    readonly CUSTOM: "custom";
+};
+export declare const ROUNDING_MODES: readonly [{
+    readonly value: "round";
+    readonly label: "Round (nearest)";
+}, {
+    readonly value: "floor";
+    readonly label: "Floor (down)";
+}, {
+    readonly value: "ceil";
+    readonly label: "Ceil (up)";
+}];
+export declare const TRIM_MODES: readonly [{
+    readonly value: "both";
+    readonly label: "Both";
+}, {
+    readonly value: "start";
+    readonly label: "Start";
+}, {
+    readonly value: "end";
+    readonly label: "End";
+}];
+export declare const UNIT_OPTIONS: readonly [{
+    readonly value: "g";
+    readonly label: "g (grams)";
+}, {
+    readonly value: "kg";
+    readonly label: "kg (kilograms)";
+}, {
+    readonly value: "lb";
+    readonly label: "lb (pounds)";
+}, {
+    readonly value: "oz";
+    readonly label: "oz (ounces)";
+}, {
+    readonly value: "cm";
+    readonly label: "cm (centimeters)";
+}, {
+    readonly value: "m";
+    readonly label: "m (meters)";
+}, {
+    readonly value: "mm";
+    readonly label: "mm (millimeters)";
+}, {
+    readonly value: "in";
+    readonly label: "in (inches)";
+}, {
+    readonly value: "ft";
+    readonly label: "ft (feet)";
+}, {
+    readonly value: "ml";
+    readonly label: "ml (milliliters)";
+}, {
+    readonly value: "l";
+    readonly label: "l (liters)";
+}, {
+    readonly value: "gal";
+    readonly label: "gal (gallons)";
+}];
+export declare const DATE_UNIT_OPTIONS: readonly [{
+    readonly value: "seconds";
+    readonly label: "Seconds";
+}, {
+    readonly value: "minutes";
+    readonly label: "Minutes";
+}, {
+    readonly value: "hours";
+    readonly label: "Hours";
+}, {
+    readonly value: "days";
+    readonly label: "Days";
+}, {
+    readonly value: "weeks";
+    readonly label: "Weeks";
+}, {
+    readonly value: "months";
+    readonly label: "Months";
+}, {
+    readonly value: "years";
+    readonly label: "Years";
+}];
+export declare const DATE_DIFF_UNIT_OPTIONS: readonly [{
+    readonly value: "seconds";
+    readonly label: "Seconds";
+}, {
+    readonly value: "minutes";
+    readonly label: "Minutes";
+}, {
+    readonly value: "hours";
+    readonly label: "Hours";
+}, {
+    readonly value: "days";
+    readonly label: "Days";
+}, {
+    readonly value: "weeks";
+    readonly label: "Weeks";
+}, {
+    readonly value: "months";
+    readonly label: "Months (approximate)";
+}, {
+    readonly value: "years";
+    readonly label: "Years (approximate)";
+}];
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/operators/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/operators/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;;;EAIjB,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;;;;EAIb,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaf,CAAC;AAEX,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAQpB,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;EAQzB,CAAC"}

package/dist/src/operators/constants.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATE_DIFF_UNIT_OPTIONS = exports.DATE_UNIT_OPTIONS = exports.UNIT_OPTIONS = exports.TRIM_MODES = exports.ROUNDING_MODES = exports.VALIDATION_RULE = void 0;
+/**
+ * Validation rule types for operator validation errors.
+ * Used as the `rule` field in ValidationError objects.
+ */
+exports.VALIDATION_RULE = {
+    REQUIRED: 'required',
+    FORMAT: 'format',
+    TYPE: 'type',
+    RANGE: 'range',
+    PATTERN: 'pattern',
+    CUSTOM: 'custom',
+};
+exports.ROUNDING_MODES = [
+    { value: 'round', label: 'Round (nearest)' },
+    { value: 'floor', label: 'Floor (down)' },
+    { value: 'ceil', label: 'Ceil (up)' },
+];
+exports.TRIM_MODES = [
+    { value: 'both', label: 'Both' },
+    { value: 'start', label: 'Start' },
+    { value: 'end', label: 'End' },
+];
+exports.UNIT_OPTIONS = [
+    { value: 'g', label: 'g (grams)' },
+    { value: 'kg', label: 'kg (kilograms)' },
+    { value: 'lb', label: 'lb (pounds)' },
+    { value: 'oz', label: 'oz (ounces)' },
+    { value: 'cm', label: 'cm (centimeters)' },
+    { value: 'm', label: 'm (meters)' },
+    { value: 'mm', label: 'mm (millimeters)' },
+    { value: 'in', label: 'in (inches)' },
+    { value: 'ft', label: 'ft (feet)' },
+    { value: 'ml', label: 'ml (milliliters)' },
+    { value: 'l', label: 'l (liters)' },
+    { value: 'gal', label: 'gal (gallons)' },
+];
+exports.DATE_UNIT_OPTIONS = [
+    { value: 'seconds', label: 'Seconds' },
+    { value: 'minutes', label: 'Minutes' },
+    { value: 'hours', label: 'Hours' },
+    { value: 'days', label: 'Days' },
+    { value: 'weeks', label: 'Weeks' },
+    { value: 'months', label: 'Months' },
+    { value: 'years', label: 'Years' },
+];
+exports.DATE_DIFF_UNIT_OPTIONS = [
+    { value: 'seconds', label: 'Seconds' },
+    { value: 'minutes', label: 'Minutes' },
+    { value: 'hours', label: 'Hours' },
+    { value: 'days', label: 'Days' },
+    { value: 'weeks', label: 'Weeks' },
+    { value: 'months', label: 'Months (approximate)' },
+    { value: 'years', label: 'Years (approximate)' },
+];
+//# sourceMappingURL=constants.js.map

package/dist/src/operators/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/operators/constants.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,eAAe,GAAG;IAC3B,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;CACV,CAAC;AAEE,QAAA,cAAc,GAAG;IAC1B,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE;IAC5C,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE;IACzC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE;CAC/B,CAAC;AAEE,QAAA,UAAU,GAAG;IACtB,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;IAChC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;CACxB,CAAC;AAEE,QAAA,YAAY,GAAG;IACxB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE;IAClC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,gBAAgB,EAAE;IACxC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE;IACrC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE;IACrC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,kBAAkB,EAAE;IAC1C,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE;IACnC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,kBAAkB,EAAE;IAC1C,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE;IACrC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE;IACnC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,kBAAkB,EAAE;IAC1C,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE;IACnC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE;CAClC,CAAC;AAEE,QAAA,iBAAiB,GAAG;IAC7B,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACtC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACtC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;IAChC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;IACpC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;CAC5B,CAAC;AAEE,QAAA,sBAAsB,GAAG;IAClC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACtC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACtC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;IAChC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,sBAAsB,EAAE;IAClD,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE;CAC1C,CAAC"}

package/dist/src/operators/data/copy.operator.d.ts

@@ -0,0 +1,6 @@
+import { AdapterDefinition, JsonObject } from '../types';
+import { CopyOperatorConfig } from './types';
+export declare const COPY_OPERATOR_DEFINITION: AdapterDefinition;
+export declare function applyCopyOperator(record: JsonObject, config: CopyOperatorConfig): JsonObject;
+export declare const copyOperator: (records: readonly JsonObject[], config: CopyOperatorConfig, helpers: import("../types").AdapterOperatorHelpers) => import("../types").OperatorResult;
+//# sourceMappingURL=copy.operator.d.ts.map

package/dist/src/operators/data/copy.operator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.operator.d.ts","sourceRoot":"","sources":["../../../../src/operators/data/copy.operator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAI7C,eAAO,MAAM,wBAAwB,EAAE,iBA2BtC,CAAC;AAEF,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,kBAAkB,GAC3B,UAAU,CAKZ;AAED,eAAO,MAAM,YAAY,uJAA0C,CAAC"}

package/dist/src/operators/data/copy.operator.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyOperator = exports.COPY_OPERATOR_DEFINITION = void 0;
+exports.applyCopyOperator = applyCopyOperator;
+const helpers_1 = require("./helpers");
+const operator_factory_1 = require("../operator-factory");
+exports.COPY_OPERATOR_DEFINITION = {
+    type: 'OPERATOR',
+    code: 'copy',
+    description: 'Copy a field value to another path.',
+    category: 'DATA',
+    categoryLabel: 'Data',
+    categoryOrder: 0,
+    pure: true,
+    summaryTemplate: '${from} \u2192 ${to}',
+    schema: {
+        fields: [
+            {
+                key: 'source',
+                label: 'Source field path',
+                type: 'string',
+                required: true,
+                description: 'Source field path',
+            },
+            {
+                key: 'target',
+                label: 'Target field path',
+                type: 'string',
+                required: true,
+                description: 'Target field path',
+            },
+        ],
+    },
+};
+function applyCopyOperator(record, config) {
+    if (!config.source || !config.target) {
+        return record;
+    }
+    return (0, helpers_1.applyCopy)(record, config.source, config.target);
+}
+exports.copyOperator = (0, operator_factory_1.createRecordOperator)(applyCopyOperator);
+//# sourceMappingURL=copy.operator.js.map

package/dist/src/operators/data/copy.operator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.operator.js","sourceRoot":"","sources":["../../../../src/operators/data/copy.operator.ts"],"names":[],"mappings":";;;AAkCA,8CAQC;AAxCD,uCAAsC;AACtC,0DAA2D;AAE9C,QAAA,wBAAwB,GAAsB;IACvD,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,qCAAqC;IAClD,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,MAAM;IACrB,aAAa,EAAE,CAAC;IAChB,IAAI,EAAE,IAAI;IACV,eAAe,EAAE,sBAAsB;IACvC,MAAM,EAAE;QACJ,MAAM,EAAE;YACJ;gBACI,GAAG,EAAE,QAAQ;gBACb,KAAK,EAAE,mBAAmB;gBAC1B,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,mBAAmB;aACnC;YACD;gBACI,GAAG,EAAE,QAAQ;gBACb,KAAK,EAAE,mBAAmB;gBAC1B,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,mBAAmB;aACnC;SACJ;KACJ;CACJ,CAAC;AAEF,SAAgB,iBAAiB,CAC7B,MAAkB,EAClB,MAA0B;IAE1B,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,OAAO,IAAA,mBAAS,EAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AAC3D,CAAC;AAEY,QAAA,YAAY,GAAG,IAAA,uCAAoB,EAAC,iBAAiB,CAAC,CAAC"}

package/dist/src/operators/data/hash.operator.d.ts

@@ -0,0 +1,12 @@
+import { AdapterDefinition, JsonObject } from '../types';
+import { HashOperatorConfig } from './types';
+/**
+ * Operator definition for generating cryptographic hashes of field values.
+ */
+export declare const HASH_OPERATOR_DEFINITION: AdapterDefinition;
+/**
+ * Apply hash operator to a single record.
+ */
+export declare function applyHashOperator(record: JsonObject, config: HashOperatorConfig): JsonObject;
+export declare const hashOperator: (records: readonly JsonObject[], config: HashOperatorConfig, helpers: import("../types").AdapterOperatorHelpers) => import("../types").OperatorResult;
+//# sourceMappingURL=hash.operator.d.ts.map

package/dist/src/operators/data/hash.operator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.operator.d.ts","sourceRoot":"","sources":["../../../../src/operators/data/hash.operator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAK7C;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBAwCtC,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,kBAAkB,GAC3B,UAAU,CAKZ;AAED,eAAO,MAAM,YAAY,uJAA0C,CAAC"}

package/dist/src/operators/data/hash.operator.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashOperator = exports.HASH_OPERATOR_DEFINITION = void 0;
+exports.applyHashOperator = applyHashOperator;
+const helpers_1 = require("./helpers");
+const operator_factory_1 = require("../operator-factory");
+const adapter_schema_options_1 = require("../../constants/adapter-schema-options");
+/**
+ * Operator definition for generating cryptographic hashes of field values.
+ */
+exports.HASH_OPERATOR_DEFINITION = {
+    type: 'OPERATOR',
+    code: 'hash',
+    description: 'Generate a cryptographic hash (MD5, SHA1, SHA256, SHA512) of field value(s).',
+    category: 'DATA',
+    categoryLabel: 'Data',
+    categoryOrder: 0,
+    pure: true,
+    schema: {
+        fields: [
+            {
+                key: 'source',
+                label: 'Source field path(s)',
+                type: 'json',
+                required: true,
+                description: 'Single path string or array of paths to hash together',
+            },
+            {
+                key: 'target',
+                label: 'Target field path',
+                type: 'string',
+                required: true,
+                description: 'Path where the hash will be stored',
+            },
+            {
+                key: 'algorithm',
+                label: 'Hash algorithm',
+                type: 'select',
+                options: adapter_schema_options_1.HASH_ALGORITHM_OPTIONS,
+                description: 'Default: sha256',
+            },
+            {
+                key: 'encoding',
+                label: 'Output encoding',
+                type: 'select',
+                options: adapter_schema_options_1.HASH_ENCODING_OPTIONS,
+                description: 'Default: hex',
+            },
+        ],
+    },
+};
+/**
+ * Apply hash operator to a single record.
+ */
+function applyHashOperator(record, config) {
+    if (!config.source || !config.target) {
+        return record;
+    }
+    return (0, helpers_1.applyHash)(record, config.source, config.target, config.algorithm, config.encoding);
+}
+exports.hashOperator = (0, operator_factory_1.createRecordOperator)(applyHashOperator);
+//# sourceMappingURL=hash.operator.js.map

package/dist/src/operators/data/hash.operator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.operator.js","sourceRoot":"","sources":["../../../../src/operators/data/hash.operator.ts"],"names":[],"mappings":";;;AAsDA,8CAQC;AA5DD,uCAAsC;AACtC,0DAA2D;AAC3D,mFAAuG;AAEvG;;GAEG;AACU,QAAA,wBAAwB,GAAsB;IACvD,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,8EAA8E;IAC3F,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,MAAM;IACrB,aAAa,EAAE,CAAC;IAChB,IAAI,EAAE,IAAI;IACV,MAAM,EAAE;QACJ,MAAM,EAAE;YACJ;gBACI,GAAG,EAAE,QAAQ;gBACb,KAAK,EAAE,sBAAsB;gBAC7B,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,uDAAuD;aACvE;YACD;gBACI,GAAG,EAAE,QAAQ;gBACb,KAAK,EAAE,mBAAmB;gBAC1B,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,oCAAoC;aACpD;YACD;gBACI,GAAG,EAAE,WAAW;gBAChB,KAAK,EAAE,gBAAgB;gBACvB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,+CAAsB;gBAC/B,WAAW,EAAE,iBAAiB;aACjC;YACD;gBACI,GAAG,EAAE,UAAU;gBACf,KAAK,EAAE,iBAAiB;gBACxB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,8CAAqB;gBAC9B,WAAW,EAAE,cAAc;aAC9B;SACJ;KACJ;CACJ,CAAC;AAEF;;GAEG;AACH,SAAgB,iBAAiB,CAC7B,MAAkB,EAClB,MAA0B;IAE1B,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,OAAO,IAAA,mBAAS,EAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC9F,CAAC;AAEY,QAAA,YAAY,GAAG,IAAA,uCAAoB,EAAC,iBAAiB,CAAC,CAAC"}

package/dist/src/operators/data/helpers.d.ts

@@ -0,0 +1,17 @@
+import { JsonObject, JsonValue } from '../types';
+import { TemplateOperatorConfig, HashAlgorithm } from './types';
+export declare function applyMapping(record: JsonObject, mapping: Record<string, string>, passthrough?: boolean): JsonObject;
+export declare function applyTemplate(record: JsonObject, config: TemplateOperatorConfig): JsonObject;
+export declare function applySet(record: JsonObject, path: string, value: JsonValue): JsonObject;
+export declare function applyRemove(record: JsonObject, path: string): JsonObject;
+export declare function applyRename(record: JsonObject, from: string, to: string): JsonObject;
+export declare function applyCopy(record: JsonObject, source: string, target: string): JsonObject;
+/**
+ * Generate a cryptographic hash of field value(s).
+ */
+export declare function applyHash(record: JsonObject, source: string | string[], target: string, algorithm?: HashAlgorithm, encoding?: 'hex' | 'base64'): JsonObject;
+/**
+ * Generate a UUID for the record.
+ */
+export declare function applyUuid(record: JsonObject, target: string, version?: 'v4' | 'v5', namespace?: string, source?: string): JsonObject;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/src/operators/data/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/operators/data/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAiBjD,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEhE,wBAAgB,YAAY,CACxB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,WAAW,UAAQ,GACpB,UAAU,CAWZ;AAED,wBAAgB,aAAa,CACzB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,sBAAsB,GAC/B,UAAU,CAiBZ;AAED,wBAAgB,QAAQ,CACpB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,GACjB,UAAU,CAIZ;AAED,wBAAgB,WAAW,CACvB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,GACb,UAAU,CAIZ;AAED,wBAAgB,WAAW,CACvB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACX,UAAU,CAQZ;AAED,wBAAgB,SAAS,CACrB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACf,UAAU,CAOZ;AAED;;GAEG;AACH,wBAAgB,SAAS,CACrB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EACzB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,aAAwB,EACnC,QAAQ,GAAE,KAAK,GAAG,QAAgB,GACnC,UAAU,CAqCZ;AAiDD;;GAEG;AACH,wBAAgB,SAAS,CACrB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,IAAI,GAAG,IAAW,EAC3B,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GAChB,UAAU,CAmCZ"}