@oronts/vendure-data-hub-plugin 0.1.0

package/dist/src/services/versioning/sandbox/field-diff-calculator.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FieldDiffCalculator = void 0;
+const enums_1 = require("../../../constants/enums");
+/**
+ * Helper for computing field-level diffs between records
+ */
+class FieldDiffCalculator {
+    /**
+     * Compute field-level diffs between two records
+     */
+    computeFieldDiffs(before, after) {
+        const diffs = [];
+        const allFields = new Set([...Object.keys(before), ...Object.keys(after)]);
+        for (const field of allFields) {
+            const diff = this.computeFieldDiff(field, before, after);
+            if (diff) {
+                diffs.push(diff);
+            }
+        }
+        return diffs;
+    }
+    /**
+     * Compute diff for a single field
+     */
+    computeFieldDiff(field, before, after) {
+        const beforeValue = before[field];
+        const afterValue = after[field];
+        const beforeType = beforeValue === null ? 'null' : typeof beforeValue;
+        const afterType = afterValue === null ? 'null' : typeof afterValue;
+        const changeType = this.determineChangeType(field, before, after, beforeValue, afterValue);
+        if (changeType === enums_1.FieldDiffChangeType.UNCHANGED) {
+            return null;
+        }
+        return { field, changeType, beforeValue, afterValue, beforeType, afterType };
+    }
+    /**
+     * Determine the type of change for a field
+     */
+    determineChangeType(field, before, after, beforeValue, afterValue) {
+        if (!(field in before) && field in after) {
+            return enums_1.FieldDiffChangeType.ADDED;
+        }
+        if (field in before && !(field in after)) {
+            return enums_1.FieldDiffChangeType.REMOVED;
+        }
+        if (!this.deepEquals(beforeValue, afterValue)) {
+            return enums_1.FieldDiffChangeType.MODIFIED;
+        }
+        return enums_1.FieldDiffChangeType.UNCHANGED;
+    }
+    /**
+     * Aggregate field changes across all samples
+     */
+    aggregateFieldChanges(samples) {
+        const fieldMap = new Map();
+        for (const sample of samples) {
+            this.aggregateSampleDiffs(fieldMap, sample);
+        }
+        return this.buildFieldChanges(fieldMap, samples.length);
+    }
+    /**
+     * Aggregate diffs from a single sample into the field map
+     */
+    aggregateSampleDiffs(fieldMap, sample) {
+        for (const diff of sample.fieldDiffs) {
+            const existing = fieldMap.get(diff.field);
+            if (existing) {
+                existing.count++;
+                if (existing.sampleBefore.length < 3) {
+                    existing.sampleBefore.push(diff.beforeValue);
+                    existing.sampleAfter.push(diff.afterValue);
+                }
+            }
+            else {
+                fieldMap.set(diff.field, {
+                    changeType: this.mapDiffChangeType(diff.changeType),
+                    count: 1,
+                    sampleBefore: [diff.beforeValue],
+                    sampleAfter: [diff.afterValue],
+                });
+            }
+        }
+    }
+    /**
+     * Map diff change type to field change type
+     */
+    mapDiffChangeType(changeType) {
+        switch (changeType) {
+            case enums_1.FieldDiffChangeType.ADDED: return enums_1.FieldDiffChangeType.ADDED;
+            case enums_1.FieldDiffChangeType.REMOVED: return enums_1.FieldDiffChangeType.REMOVED;
+            default: return enums_1.FieldDiffChangeType.MODIFIED;
+        }
+    }
+    /**
+     * Build FieldChange array from aggregated data
+     */
+    buildFieldChanges(fieldMap, totalRecords) {
+        return Array.from(fieldMap.entries()).map(([field, data]) => ({
+            field,
+            changeType: data.changeType,
+            affectedCount: data.count,
+            totalRecords,
+            percentage: Math.round((data.count / totalRecords) * 100),
+            sampleBefore: data.sampleBefore,
+            sampleAfter: data.sampleAfter,
+        }));
+    }
+    /**
+     * Determine the outcome of a transformation
+     */
+    determineOutcome(before, after, diffs) {
+        if (Object.keys(after).length === 0 && Object.keys(before).length > 0) {
+            return enums_1.RecordOutcome.FILTERED;
+        }
+        if (diffs.length === 0) {
+            return enums_1.RecordOutcome.UNCHANGED;
+        }
+        return enums_1.RecordOutcome.SUCCESS;
+    }
+    /**
+     * Deep equality check
+     */
+    deepEquals(a, b) {
+        if (a === b)
+            return true;
+        if (typeof a !== typeof b)
+            return false;
+        if (a === null || b === null)
+            return a === b;
+        if (typeof a !== 'object')
+            return a === b;
+        if (Array.isArray(a) && Array.isArray(b)) {
+            if (a.length !== b.length)
+                return false;
+            return a.every((item, idx) => this.deepEquals(item, b[idx]));
+        }
+        if (Array.isArray(a) !== Array.isArray(b))
+            return false;
+        const aObj = a;
+        const bObj = b;
+        const aKeys = Object.keys(aObj);
+        const bKeys = Object.keys(bObj);
+        if (aKeys.length !== bKeys.length)
+            return false;
+        return aKeys.every(key => this.deepEquals(aObj[key], bObj[key]));
+    }
+}
+exports.FieldDiffCalculator = FieldDiffCalculator;
+//# sourceMappingURL=field-diff-calculator.js.map

package/dist/src/services/versioning/sandbox/field-diff-calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-diff-calculator.js","sourceRoot":"","sources":["../../../../../src/services/versioning/sandbox/field-diff-calculator.ts"],"names":[],"mappings":"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"}

package/dist/src/services/versioning/sandbox/index.d.ts

@@ -0,0 +1,5 @@
+export * from './sandbox-step-executor';
+export * from './data-lineage-tracker';
+export * from './field-diff-calculator';
+export * from './load-operation-simulator';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/services/versioning/sandbox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/services/versioning/sandbox/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC"}

package/dist/src/services/versioning/sandbox/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./sandbox-step-executor"), exports);
+__exportStar(require("./data-lineage-tracker"), exports);
+__exportStar(require("./field-diff-calculator"), exports);
+__exportStar(require("./load-operation-simulator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/services/versioning/sandbox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/services/versioning/sandbox/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,yDAAuC;AACvC,0DAAwC;AACxC,6DAA2C"}

package/dist/src/services/versioning/sandbox/load-operation-simulator.d.ts

@@ -0,0 +1,57 @@
+import { RequestContext } from '@vendure/core';
+import { PipelineStepDefinition } from '../../../types/index';
+import { LoadOperationPreview, SandboxOptions } from '../sandbox.service';
+/**
+ * Helper for simulating load operations in sandbox mode
+ */
+export declare class LoadOperationSimulator {
+    /**
+     * Simulate load operations to preview what would happen
+     */
+    simulateLoadOperations(ctx: RequestContext, step: PipelineStepDefinition, records: Record<string, unknown>[], opts: Required<SandboxOptions>): Promise<LoadOperationPreview>;
+    /**
+     * Create empty load operation preview
+     */
+    private createEmptyPreview;
+    /**
+     * Analyze records and populate preview
+     */
+    private analyzeRecords;
+    /**
+     * Create operation detail object
+     */
+    private createOperationDetail;
+    /**
+     * Add operation to preview and update summary
+     */
+    private addOperationToPreview;
+    /**
+     * Add warnings for common issues
+     */
+    private addWarnings;
+    /**
+     * Determine what load operation would be performed for a record
+     */
+    private determineLoadOperation;
+    /**
+     * Check for required fields and return error if missing
+     */
+    private checkRequiredFields;
+    /**
+     * Determine operation type based on record ID and strategy
+     */
+    private determineOperationType;
+    /**
+     * Extract record ID from common fields
+     */
+    private extractRecordId;
+    /**
+     * Infer entity type from adapter code
+     */
+    private inferEntityType;
+    /**
+     * Get required fields for an entity type
+     */
+    private getRequiredFields;
+}
+//# sourceMappingURL=load-operation-simulator.d.ts.map

package/dist/src/services/versioning/sandbox/load-operation-simulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-operation-simulator.d.ts","sourceRoot":"","sources":["../../../../../src/services/versioning/sandbox/load-operation-simulator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAI9D,OAAO,EAAa,oBAAoB,EAAuB,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE1G;;GAEG;AACH,qBAAa,sBAAsB;IAC/B;;OAEG;IACG,sBAAsB,CACxB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAClC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,GAC/B,OAAO,CAAC,oBAAoB,CAAC;IAWhC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;YACW,cAAc;IAkB5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAc9B;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAU5B"}

package/dist/src/services/versioning/sandbox/load-operation-simulator.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadOperationSimulator = void 0;
+const enums_1 = require("../../../constants/enums");
+const step_configs_1 = require("../../../types/step-configs");
+const step_utils_1 = require("../../../utils/step-utils");
+/**
+ * Helper for simulating load operations in sandbox mode
+ */
+class LoadOperationSimulator {
+    /**
+     * Simulate load operations to preview what would happen
+     */
+    async simulateLoadOperations(ctx, step, records, opts) {
+        const adapterCode = (0, step_configs_1.getAdapterCode)(step) || 'unknown';
+        const entityType = this.inferEntityType(adapterCode);
+        const preview = this.createEmptyPreview(entityType, adapterCode);
+        await this.analyzeRecords(ctx, step, records, opts, preview, entityType);
+        this.addWarnings(preview, records.length, opts.maxRecords);
+        return preview;
+    }
+    /**
+     * Create empty load operation preview
+     */
+    createEmptyPreview(entityType, adapterCode) {
+        return {
+            entityType,
+            adapterCode,
+            operations: { create: [], update: [], delete: [], skip: [], error: [] },
+            summary: { createCount: 0, updateCount: 0, deleteCount: 0, skipCount: 0, errorCount: 0 },
+            warnings: [],
+        };
+    }
+    /**
+     * Analyze records and populate preview
+     */
+    async analyzeRecords(ctx, step, records, opts, preview, entityType) {
+        for (let i = 0; i < Math.min(records.length, opts.maxRecords); i++) {
+            const record = records[i];
+            const recordId = this.extractRecordId(record);
+            const operation = this.determineLoadOperation(step, record, entityType);
+            const detail = this.createOperationDetail(i, recordId, record, operation);
+            this.addOperationToPreview(preview, operation.type, detail);
+        }
+    }
+    /**
+     * Create operation detail object
+     */
+    createOperationDetail(index, recordId, record, operation) {
+        return {
+            recordIndex: index,
+            recordId,
+            entityId: operation.entityId,
+            reason: operation.reason,
+            data: record,
+            existingData: operation.existingData,
+            diff: operation.diff,
+        };
+    }
+    /**
+     * Add operation to preview and update summary
+     */
+    addOperationToPreview(preview, type, detail) {
+        preview.operations[type].push(detail);
+        preview.summary[`${type}Count`]++;
+    }
+    /**
+     * Add warnings for common issues
+     */
+    addWarnings(preview, totalRecords, maxRecords) {
+        if (preview.summary.deleteCount > 0) {
+            preview.warnings.push(`${preview.summary.deleteCount} records will be deleted - this cannot be undone`);
+        }
+        if (preview.summary.errorCount > 0) {
+            preview.warnings.push(`${preview.summary.errorCount} records have validation errors and will not be loaded`);
+        }
+        if (totalRecords > maxRecords) {
+            preview.warnings.push(`Only ${maxRecords} of ${totalRecords} records were analyzed`);
+        }
+    }
+    /**
+     * Determine what load operation would be performed for a record
+     */
+    determineLoadOperation(step, record, entityType) {
+        const recordId = this.extractRecordId(record);
+        const strategy = (0, step_utils_1.getStepStrategy)(step) ?? 'upsert';
+        const missingFieldsError = this.checkRequiredFields(record, entityType);
+        if (missingFieldsError) {
+            return missingFieldsError;
+        }
+        return this.determineOperationType(recordId, strategy);
+    }
+    /**
+     * Check for required fields and return error if missing
+     */
+    checkRequiredFields(record, entityType) {
+        const requiredFields = this.getRequiredFields(entityType);
+        const missingFields = requiredFields.filter(f => record[f] == null);
+        if (missingFields.length > 0) {
+            return {
+                type: enums_1.SandboxLoadResultType.ERROR,
+                entityId: null,
+                reason: `Missing required fields: ${missingFields.join(', ')}`,
+            };
+        }
+        return null;
+    }
+    /**
+     * Determine operation type based on record ID and strategy
+     */
+    determineOperationType(recordId, strategy) {
+        if (recordId) {
+            if (strategy === 'create-only') {
+                return { type: enums_1.SandboxLoadResultType.SKIP, entityId: recordId, reason: 'Record has ID but strategy is create-only' };
+            }
+            return { type: enums_1.SandboxLoadResultType.UPDATE, entityId: recordId, reason: 'Record has existing ID', diff: [] };
+        }
+        else {
+            if (strategy === 'update-only') {
+                return { type: enums_1.SandboxLoadResultType.SKIP, entityId: null, reason: 'Record has no ID but strategy is update-only' };
+            }
+            return { type: enums_1.SandboxLoadResultType.CREATE, entityId: null, reason: 'New record' };
+        }
+    }
+    /**
+     * Extract record ID from common fields
+     */
+    extractRecordId(record) {
+        const idFields = ['id', '_id', 'ID', 'Id', 'sku', 'code', 'uuid', 'externalId'];
+        for (const field of idFields) {
+            if (record[field] != null) {
+                return String(record[field]);
+            }
+        }
+        return null;
+    }
+    /**
+     * Infer entity type from adapter code
+     */
+    inferEntityType(adapterCode) {
+        const mapping = {
+            'vendure-products': enums_1.VendureEntityType.PRODUCT,
+            'vendure-variants': enums_1.VendureEntityType.PRODUCT_VARIANT,
+            'vendure-customers': enums_1.VendureEntityType.CUSTOMER,
+            'vendure-orders': enums_1.VendureEntityType.ORDER,
+            'vendure-collections': enums_1.VendureEntityType.COLLECTION,
+            'vendure-facets': enums_1.VendureEntityType.FACET,
+            'vendure-assets': enums_1.VendureEntityType.ASSET,
+            'vendure-product-sync': enums_1.VendureEntityType.PRODUCT,
+        };
+        return mapping[adapterCode] || 'Entity';
+    }
+    /**
+     * Get required fields for an entity type
+     */
+    getRequiredFields(entityType) {
+        const requirements = {
+            [enums_1.VendureEntityType.PRODUCT]: ['name'],
+            [enums_1.VendureEntityType.PRODUCT_VARIANT]: ['sku', 'productId'],
+            [enums_1.VendureEntityType.CUSTOMER]: ['emailAddress'],
+            [enums_1.VendureEntityType.COLLECTION]: ['name'],
+            [enums_1.VendureEntityType.FACET]: ['name', 'code'],
+        };
+        return requirements[entityType] || [];
+    }
+}
+exports.LoadOperationSimulator = LoadOperationSimulator;
+//# sourceMappingURL=load-operation-simulator.js.map

package/dist/src/services/versioning/sandbox/load-operation-simulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-operation-simulator.js","sourceRoot":"","sources":["../../../../../src/services/versioning/sandbox/load-operation-simulator.ts"],"names":[],"mappings":"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"}

package/dist/src/services/versioning/sandbox/sandbox-step-executor.d.ts

@@ -0,0 +1,70 @@
+import { RequestContext } from '@vendure/core';
+import { PipelineStepDefinition } from '../../../types/index';
+import { AdapterRuntimeService } from '../../../runtime/adapter-runtime.service';
+import { StepExecutionResult, LoadOperationPreview, SandboxOptions } from '../sandbox.service';
+import { DataLineageTracker } from './data-lineage-tracker';
+/**
+ * Helper for executing individual pipeline steps in sandbox mode
+ */
+export declare class SandboxStepExecutor {
+    private readonly adapterRuntime;
+    private readonly fieldDiffCalculator;
+    private readonly loadSimulator;
+    constructor(adapterRuntime: AdapterRuntimeService);
+    /**
+     * Execute a single step and return detailed results
+     */
+    executeStep(ctx: RequestContext, step: PipelineStepDefinition, inputRecords: Record<string, unknown>[], opts: Required<SandboxOptions>, lineageTracker: DataLineageTracker): Promise<StepExecutionResult & {
+        outputRecords?: Record<string, unknown>[];
+        loadPreview?: LoadOperationPreview;
+    }>;
+    /**
+     * Create initial step execution result
+     */
+    private createInitialExecution;
+    /**
+     * Dispatch to appropriate step handler
+     */
+    private dispatchStepExecution;
+    /**
+     * Execute EXTRACT step in sandbox mode
+     */
+    private executeExtract;
+    /**
+     * Track extracted records in lineage
+     */
+    private trackExtractedRecords;
+    /**
+     * Create samples for extract step
+     */
+    private createExtractSamples;
+    /**
+     * Execute TRANSFORM or VALIDATE step in sandbox mode
+     */
+    private executeTransform;
+    /**
+     * Create samples for transform step
+     */
+    private createTransformSamples;
+    /**
+     * Execute LOAD step in sandbox mode
+     */
+    private executeLoad;
+    /**
+     * Track load operations in lineage
+     */
+    private trackLoadOperations;
+    /**
+     * Create samples from load preview
+     */
+    private createLoadSamples;
+    /**
+     * Extract validation issues from a validate step
+     */
+    private extractValidationIssues;
+    /**
+     * Handle step execution error
+     */
+    private handleStepError;
+}
+//# sourceMappingURL=sandbox-step-executor.d.ts.map

package/dist/src/services/versioning/sandbox/sandbox-step-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-step-executor.d.ts","sourceRoot":"","sources":["../../../../../src/services/versioning/sandbox/sandbox-step-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAY,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAUjF,OAAO,EACH,mBAAmB,EAEnB,oBAAoB,EAEpB,cAAc,EACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D;;GAEG;AACH,qBAAa,mBAAmB;IAIhB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAH3C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6B;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;gBAEjC,cAAc,EAAE,qBAAqB;IAElE;;OAEG;IACG,WAAW,CACb,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,sBAAsB,EAC5B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACvC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC9B,cAAc,EAAE,kBAAkB,GACnC,OAAO,CAAC,mBAAmB,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,oBAAoB,CAAA;KAAE,CAAC;IAqBnH;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkB9B;;OAEG;YACW,qBAAqB;IAgCnC;;OAEG;YACW,cAAc;IAyB5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;YACW,gBAAgB;IAkC9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgC9B;;OAEG;YACW,WAAW;IAuBzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;OAEG;IACH,OAAO,CAAC,eAAe;CAK1B"}