@oronts/vendure-data-hub-plugin 0.1.0

package/dist/src/jobs/processors/cron-processor.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidTimezone = isValidTimezone;
+exports.getDatePartsInTimezone = getDatePartsInTimezone;
+exports.cronMatches = cronMatches;
+exports.cronFieldMatch = cronFieldMatch;
+exports.getNextCronOccurrence = getNextCronOccurrence;
+const index_1 = require("../../constants/index");
+const validation_1 = require("../../../shared/utils/validation");
+function isValidTimezone(timezone) {
+    try {
+        Intl.DateTimeFormat(undefined, { timeZone: timezone });
+        return true;
+    }
+    catch {
+        // Invalid timezone - return false
+        return false;
+    }
+}
+function getDatePartsInTimezone(date, timezone) {
+    // Use Intl.DateTimeFormat to get components in the target timezone
+    const formatter = new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        year: 'numeric',
+        month: 'numeric',
+        day: 'numeric',
+        hour: 'numeric',
+        minute: 'numeric',
+        weekday: 'short',
+        hour12: false,
+    });
+    const parts = formatter.formatToParts(date);
+    const partMap = {};
+    for (const part of parts) {
+        partMap[part.type] = part.value;
+    }
+    // Map weekday abbreviation to number (0-6, Sun-Sat)
+    const weekdayMap = {
+        Sun: 0,
+        Mon: 1,
+        Tue: 2,
+        Wed: 3,
+        Thu: 4,
+        Fri: 5,
+        Sat: 6,
+    };
+    return {
+        minute: parseInt(partMap.minute, 10),
+        hour: parseInt(partMap.hour, 10),
+        day: parseInt(partMap.day, 10),
+        month: parseInt(partMap.month, 10),
+        weekday: weekdayMap[partMap.weekday] ?? date.getDay(),
+    };
+}
+/** 5-field cron: minute hour day-of-month month day-of-week */
+function cronMatches(date, expr, timezone) {
+    const fields = expr.trim().split(/\s+/);
+    if (fields.length < 5)
+        return false;
+    const [m, h, dom, mon, dow] = fields;
+    // Normalize month and weekday fields to handle named values
+    const normalizedMon = (0, validation_1.normalizeCronField)(mon, 'month');
+    const normalizedDow = (0, validation_1.normalizeCronField)(dow, 'weekday');
+    let minute;
+    let hour;
+    let day;
+    let month;
+    let weekday;
+    // If timezone is provided and valid, convert the date to that timezone
+    if (timezone && isValidTimezone(timezone)) {
+        const parts = getDatePartsInTimezone(date, timezone);
+        minute = parts.minute;
+        hour = parts.hour;
+        day = parts.day;
+        month = parts.month;
+        weekday = parts.weekday;
+    }
+    else {
+        // Use server local time
+        minute = date.getMinutes();
+        hour = date.getHours();
+        day = date.getDate();
+        month = date.getMonth() + 1;
+        weekday = date.getDay(); // 0-6 Sun-Sat
+    }
+    return (cronFieldMatch(minute, m, 0, 59) &&
+        cronFieldMatch(hour, h, 0, 23) &&
+        cronFieldMatch(day, dom, 1, 31) &&
+        cronFieldMatch(month, normalizedMon, 1, 12) &&
+        cronFieldMatch(weekday, normalizedDow, 0, 6));
+}
+function cronFieldMatch(value, field, min, max) {
+    field = field.trim();
+    // Wildcard - matches any value
+    if (field === '*') {
+        return true;
+    }
+    // Step values (e.g., */5 for every 5 minutes)
+    if (field.startsWith('*/')) {
+        const step = Number(field.slice(2));
+        return step > 0 && (value - min) % step === 0;
+    }
+    // Range with step (e.g., 1-30/5)
+    if (field.includes('-') && field.includes('/')) {
+        const [range, stepStr] = field.split('/');
+        const [startStr, endStr] = range.split('-');
+        const start = Number(startStr);
+        const end = Number(endStr);
+        const step = Number(stepStr);
+        if (isNaN(start) || isNaN(end) || isNaN(step) || step <= 0) {
+            return false;
+        }
+        if (value < start || value > end) {
+            return false;
+        }
+        return (value - start) % step === 0;
+    }
+    // Range (e.g., 1-5)
+    if (field.includes('-') && !field.includes(',')) {
+        const [startStr, endStr] = field.split('-');
+        const start = Number(startStr);
+        const end = Number(endStr);
+        if (isNaN(start) || isNaN(end)) {
+            return false;
+        }
+        return value >= start && value <= end;
+    }
+    // Comma-separated list (e.g., 1,3,5)
+    if (field.includes(',')) {
+        return field.split(',').some(part => cronFieldMatch(value, part.trim(), min, max));
+    }
+    // Single numeric value
+    const num = Number(field);
+    return !Number.isNaN(num) && num >= min && num <= max && num === value;
+}
+function getNextCronOccurrence(expr, after = new Date(), maxIterations = index_1.CRON.MAX_ITERATIONS, timezone) {
+    const validation = (0, validation_1.validateCronExpression)(expr);
+    if (!validation.valid) {
+        return null;
+    }
+    // Start from the next minute
+    const current = new Date(after);
+    current.setSeconds(0, 0);
+    current.setMinutes(current.getMinutes() + 1);
+    for (let i = 0; i < maxIterations; i++) {
+        if (cronMatches(current, expr, timezone)) {
+            return current;
+        }
+        current.setMinutes(current.getMinutes() + 1);
+    }
+    return null;
+}
+//# sourceMappingURL=cron-processor.js.map

package/dist/src/jobs/processors/cron-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-processor.js","sourceRoot":"","sources":["../../../../src/jobs/processors/cron-processor.ts"],"names":[],"mappings":";;AAGA,0CAQC;AAED,wDA+CC;AAGD,kCAwCC;AAED,wCA2DC;AAED,sDAwBC;AA9LD,iDAA6C;AAC7C,iEAA8F;AAE9F,SAAgB,eAAe,CAAC,QAAgB;IAC5C,IAAI,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,kCAAkC;QAClC,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,SAAgB,sBAAsB,CAClC,IAAU,EACV,QAAgB;IAQhB,mEAAmE;IACnE,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAC/C,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,KAAK;KAChB,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IACpC,CAAC;IAED,oDAAoD;IACpD,MAAM,UAAU,GAA2B;QACvC,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;KACT,CAAC;IAEF,OAAO;QACH,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;QAC9B,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAClC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE;KACxD,CAAC;AACN,CAAC;AAED,+DAA+D;AAC/D,SAAgB,WAAW,CAAC,IAAU,EAAE,IAAY,EAAE,QAAiB;IACnE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;IAErC,4DAA4D;IAC5D,MAAM,aAAa,GAAG,IAAA,+BAAkB,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,IAAA,+BAAkB,EAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAEzD,IAAI,MAAc,CAAC;IACnB,IAAI,IAAY,CAAC;IACjB,IAAI,GAAW,CAAC;IAChB,IAAI,KAAa,CAAC;IAClB,IAAI,OAAe,CAAC;IAEpB,uEAAuE;IACvE,IAAI,QAAQ,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QACtB,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QAClB,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QAChB,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACpB,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC5B,CAAC;SAAM,CAAC;QACJ,wBAAwB;QACxB,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC3B,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvB,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC5B,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,cAAc;IAC3C,CAAC;IAED,OAAO,CACH,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,cAAc,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC,CAC/C,CAAC;AACN,CAAC;AAED,SAAgB,cAAc,CAC1B,KAAa,EACb,KAAa,EACb,GAAW,EACX,GAAW;IAEX,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAErB,+BAA+B;IAC/B,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,8CAA8C;IAC9C,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,iCAAiC;IACjC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAE7B,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,IAAI,KAAK,GAAG,KAAK,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,oBAAoB;IACpB,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAE3B,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,GAAG,CAAC;IAC1C,CAAC;IAED,qCAAqC;IACrC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,uBAAuB;IACvB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,KAAK,CAAC;AAC3E,CAAC;AAED,SAAgB,qBAAqB,CACjC,IAAY,EACZ,QAAc,IAAI,IAAI,EAAE,EACxB,gBAAwB,YAAI,CAAC,cAAc,EAC3C,QAAiB;IAEjB,MAAM,UAAU,GAAG,IAAA,mCAAsB,EAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,6BAA6B;IAC7B,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;IAE7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;YACvC,OAAO,OAAO,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/src/jobs/processors/job-processor.d.ts

@@ -0,0 +1,17 @@
+import { JobResult, JobContext } from '../types';
+import { sleep } from '../../utils/retry.utils';
+export declare function createJobContext(jobId: string, attempt?: number, maxAttempts?: number): JobContext;
+export declare function createSuccessResult(durationMs?: number, metadata?: Record<string, unknown>): JobResult;
+export declare function createFailureResult(error: string | Error, durationMs?: number, metadata?: Record<string, unknown>): JobResult;
+export declare function withJobProcessing<T, R>(name: string, processor: (data: T) => Promise<R>): (data: T) => Promise<JobResult>;
+export declare function withRetry<T>(fn: () => Promise<T>, options?: {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    backoffMultiplier?: number;
+    onRetry?: (attempt: number, error: Error) => void;
+}): Promise<T>;
+export { sleep };
+export declare function calculateBackoffDelay(attempt: number, baseDelayMs?: number, maxDelayMs?: number, multiplier?: number): number;
+export declare function isRetryableError(error: Error, additionalPatterns?: (string | RegExp)[]): boolean;
+//# sourceMappingURL=job-processor.d.ts.map

package/dist/src/jobs/processors/job-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-processor.d.ts","sourceRoot":"","sources":["../../../../src/jobs/processors/job-processor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAIH,KAAK,EAGR,MAAM,yBAAyB,CAAC;AAKjC,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAU,EACnB,WAAW,GAAE,MAAyB,GACvC,UAAU,CAOZ;AAED,wBAAgB,mBAAmB,CAC/B,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,SAAS,CAMX;AAED,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,MAAM,GAAG,KAAK,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,SAAS,CAOX;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GACnC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,CAqBjC;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC7B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IACL,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAChD,GACP,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAA4B,EACzC,UAAU,GAAE,MAAgC,EAC5C,UAAU,GAAE,MAA+C,GAC5D,MAAM,CAQR;AAED,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,KAAK,EACZ,kBAAkB,GAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO,GAC7C,OAAO,CAuBT"}

package/dist/src/jobs/processors/job-processor.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = void 0;
+exports.createJobContext = createJobContext;
+exports.createSuccessResult = createSuccessResult;
+exports.createFailureResult = createFailureResult;
+exports.withJobProcessing = withJobProcessing;
+exports.withRetry = withRetry;
+exports.calculateBackoffDelay = calculateBackoffDelay;
+exports.isRetryableError = isRetryableError;
+const index_1 = require("../../constants/index");
+const logger_1 = require("../../services/logger");
+const retry_utils_1 = require("../../utils/retry.utils");
+Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return retry_utils_1.sleep; } });
+const error_utils_1 = require("../../utils/error.utils");
+const logger = new logger_1.DataHubLogger(index_1.LOGGER_CONTEXTS.JOB_PROCESSOR);
+function createJobContext(jobId, attempt = 1, maxAttempts = index_1.HTTP.MAX_RETRIES) {
+    return {
+        jobId,
+        attempt,
+        maxAttempts,
+        createdAt: new Date(),
+    };
+}
+function createSuccessResult(durationMs, metadata) {
+    return {
+        success: true,
+        durationMs,
+        metadata,
+    };
+}
+function createFailureResult(error, durationMs, metadata) {
+    return {
+        success: false,
+        error: (0, error_utils_1.getErrorMessage)(error),
+        durationMs,
+        metadata,
+    };
+}
+function withJobProcessing(name, processor) {
+    return async (data) => {
+        const startTime = Date.now();
+        try {
+            logger.debug(`Starting job: ${name}`);
+            await processor(data);
+            const durationMs = Date.now() - startTime;
+            logger.debug(`Job completed: ${name}`, { durationMs });
+            return createSuccessResult(durationMs);
+        }
+        catch (error) {
+            const durationMs = Date.now() - startTime;
+            const errorMessage = (0, error_utils_1.getErrorMessage)(error);
+            logger.error(`Job failed: ${name}`, (0, error_utils_1.toErrorOrUndefined)(error), { durationMs });
+            return createFailureResult(errorMessage, durationMs);
+        }
+    };
+}
+async function withRetry(fn, options = {}) {
+    const { maxAttempts = index_1.HTTP.MAX_RETRIES, baseDelayMs = index_1.HTTP.RETRY_DELAY_MS, maxDelayMs = index_1.HTTP.RETRY_MAX_DELAY_MS, backoffMultiplier = retry_utils_1.DEFAULT_RETRY_CONFIG.backoffMultiplier, onRetry, } = options;
+    const config = (0, retry_utils_1.createRetryConfig)({
+        maxAttempts,
+        initialDelayMs: baseDelayMs,
+        maxDelayMs,
+        backoffMultiplier,
+    });
+    return (0, retry_utils_1.executeWithRetry)(fn, {
+        config,
+        onRetry: onRetry ? (attempt, error) => onRetry(attempt, error) : undefined,
+        logger: {
+            warn: (msg, meta) => logger.warn(msg, meta),
+            debug: (msg, meta) => logger.debug(msg, meta),
+        },
+    });
+}
+function calculateBackoffDelay(attempt, baseDelayMs = index_1.HTTP.RETRY_DELAY_MS, maxDelayMs = index_1.HTTP.RETRY_MAX_DELAY_MS, multiplier = retry_utils_1.DEFAULT_RETRY_CONFIG.backoffMultiplier) {
+    return (0, retry_utils_1.calculateBackoff)(attempt, {
+        maxAttempts: 1,
+        initialDelayMs: baseDelayMs,
+        maxDelayMs,
+        backoffMultiplier: multiplier,
+        jitterFactor: 0,
+    });
+}
+function isRetryableError(error, additionalPatterns = []) {
+    // Check base patterns from retry.utils
+    if ((0, retry_utils_1.isRetryableError)(error)) {
+        return true;
+    }
+    // Check additional patterns if provided
+    if (additionalPatterns.length > 0) {
+        const message = error.message.toLowerCase();
+        for (const pattern of additionalPatterns) {
+            if (typeof pattern === 'string') {
+                if (message.includes(pattern.toLowerCase())) {
+                    return true;
+                }
+            }
+            else {
+                if (pattern.test(message)) {
+                    return true;
+                }
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=job-processor.js.map

package/dist/src/jobs/processors/job-processor.js.map

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

package/dist/src/jobs/types.d.ts

@@ -0,0 +1,103 @@
+import { ID } from '@vendure/core';
+import { TimerType } from '../constants/enums';
+export interface PipelineRunJobData {
+    /** The ID of the pipeline run to execute */
+    runId: ID;
+}
+/**
+ * Data payload for scheduled pipeline jobs
+ */
+export interface ScheduledPipelineJobData {
+    /** The ID of the pipeline to trigger */
+    pipelineId: ID;
+    /** The code of the pipeline (for logging) */
+    pipelineCode: string;
+    /** Trigger type: INTERVAL or CRON */
+    triggerType: 'INTERVAL' | 'CRON';
+}
+/**
+ * Data payload for webhook retry jobs
+ */
+export interface WebhookRetryJobData {
+    /** The ID of the webhook delivery to retry */
+    deliveryId: string;
+}
+export interface JobResult {
+    /** Whether the job completed successfully */
+    success: boolean;
+    /** Optional error message if failed */
+    error?: string;
+    /** Duration in milliseconds */
+    durationMs?: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Job processing context
+ */
+export interface JobContext {
+    /** Unique job ID */
+    jobId: string;
+    /** Attempt number (1-based) */
+    attempt: number;
+    /** Maximum attempts allowed */
+    maxAttempts: number;
+    /** Job creation timestamp */
+    createdAt: Date;
+}
+export interface ScheduledTimer {
+    /** Pipeline or task code */
+    code: string;
+    /** Trigger step key (for multiple triggers per pipeline) */
+    triggerKey?: string;
+    /** Timer handle from setInterval */
+    handle: NodeJS.Timeout;
+    /** Timer type */
+    type: TimerType;
+}
+/**
+ * Cron schedule configuration
+ *
+ * Uses `cron` as the canonical field name (more intuitive for users).
+ */
+export interface CronScheduleConfig {
+    /** Cron expression (5 fields: minute hour day month weekday) */
+    cron: string;
+    /** Optional timezone */
+    timezone?: string;
+}
+/**
+ * Interval schedule configuration
+ */
+export interface IntervalScheduleConfig {
+    /** Interval in seconds */
+    intervalSec: number;
+}
+/**
+ * Combined schedule configuration
+ */
+export type ScheduleConfig = CronScheduleConfig | IntervalScheduleConfig;
+export interface JobQueueConfig {
+    /** Queue name */
+    name: string;
+    /** Maximum concurrent jobs */
+    concurrency?: number;
+    /** Default job timeout in milliseconds */
+    timeout?: number;
+    /** Maximum retry attempts */
+    maxRetries?: number;
+    /** Retry delay in milliseconds */
+    retryDelay?: number;
+}
+/**
+ * Job options when adding to queue
+ */
+export interface JobOptions {
+    /** Priority (higher = more urgent) */
+    priority?: number;
+    /** Delay before processing in milliseconds */
+    delay?: number;
+    /** Maximum retry attempts for this job */
+    retries?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/jobs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/jobs/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IAC/B,4CAA4C;IAC5C,KAAK,EAAE,EAAE,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,wCAAwC;IACxC,UAAU,EAAE,EAAE,CAAC;IACf,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,WAAW,EAAE,UAAU,GAAG,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACtB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,SAAS,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC3B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC;IACvB,iBAAiB;IACjB,IAAI,EAAE,SAAS,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAC/B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,sBAAsB,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC3B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/src/jobs/types.js

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

package/dist/src/jobs/types.js.map

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

package/dist/src/loaders/asset/asset.loader.d.ts

@@ -0,0 +1,35 @@
+import { ID, Asset, RequestContext, TransactionalConnection, AssetService } from '@vendure/core';
+import { LoaderContext, EntityValidationResult, EntityFieldSchema, TargetOperation } from '../../types/index';
+import { DataHubLogger, DataHubLoggerFactory } from '../../services/logger';
+import { BaseEntityLoader, ExistingEntityLookupResult, LoaderMetadata } from '../base';
+import { AssetInput } from './types';
+/**
+ * AssetLoader - Refactored to extend BaseEntityLoader
+ *
+ * This eliminates ~60 lines of duplicate load() method code that was
+ * copy-pasted across all loaders. The base class handles:
+ * - Result initialization
+ * - Validation loop
+ * - Duplicate detection
+ * - CREATE/UPDATE/UPSERT operation logic
+ * - Dry run mode
+ * - Error handling
+ *
+ * Note: createEntity returns null when asset download fails,
+ * which the base class handles by recording the failure.
+ */
+export declare class AssetLoader extends BaseEntityLoader<AssetInput, Asset> {
+    private connection;
+    private assetService;
+    protected readonly logger: DataHubLogger;
+    protected readonly metadata: LoaderMetadata;
+    private readonly lookupHelper;
+    constructor(connection: TransactionalConnection, assetService: AssetService, loggerFactory: DataHubLoggerFactory);
+    protected getDuplicateErrorMessage(record: AssetInput): string;
+    findExisting(ctx: RequestContext, lookupFields: string[], record: AssetInput): Promise<ExistingEntityLookupResult<Asset> | null>;
+    validate(_ctx: RequestContext, record: AssetInput, operation: TargetOperation): Promise<EntityValidationResult>;
+    getFieldSchema(): EntityFieldSchema;
+    protected createEntity(context: LoaderContext, record: AssetInput): Promise<ID | null>;
+    protected updateEntity(context: LoaderContext, assetId: ID, record: AssetInput): Promise<void>;
+}
+//# sourceMappingURL=asset.loader.d.ts.map

package/dist/src/loaders/asset/asset.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.loader.d.ts","sourceRoot":"","sources":["../../../../src/loaders/asset/asset.loader.ts"],"names":[],"mappings":"AACA,OAAO,EACH,EAAE,EACF,KAAK,EACL,cAAc,EACd,uBAAuB,EACvB,YAAY,EACf,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG5E,OAAO,EACH,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,EAIjB,MAAM,SAAS,CAAC;AACjB,OAAO,EACH,UAAU,EAEb,MAAM,SAAS,CAAC;AASjB;;;;;;;;;;;;;;GAcG;AACH,qBACa,WAAY,SAAQ,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC;IAO5D,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,YAAY;IAPxB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAyB;IAEpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsD;gBAGvE,UAAU,EAAE,uBAAuB,EACnC,YAAY,EAAE,YAAY,EAClC,aAAa,EAAE,oBAAoB;IASvC,SAAS,CAAC,wBAAwB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAKxD,YAAY,CACd,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,EAAE,UAAU,GACnB,OAAO,CAAC,0BAA0B,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAkB9C,QAAQ,CACV,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,eAAe,GAC3B,OAAO,CAAC,sBAAsB,CAAC;IAkClC,cAAc,IAAI,iBAAiB;cA+CnB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC;cA8C5E,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBvG"}

package/dist/src/loaders/asset/asset.loader.js

@@ -0,0 +1,194 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssetLoader = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const logger_1 = require("../../services/logger");
+const index_1 = require("../../constants/index");
+const enums_1 = require("../../constants/enums");
+const base_1 = require("../base");
+const types_1 = require("./types");
+const helpers_1 = require("./helpers");
+/**
+ * AssetLoader - Refactored to extend BaseEntityLoader
+ *
+ * This eliminates ~60 lines of duplicate load() method code that was
+ * copy-pasted across all loaders. The base class handles:
+ * - Result initialization
+ * - Validation loop
+ * - Duplicate detection
+ * - CREATE/UPDATE/UPSERT operation logic
+ * - Dry run mode
+ * - Error handling
+ *
+ * Note: createEntity returns null when asset download fails,
+ * which the base class handles by recording the failure.
+ */
+let AssetLoader = class AssetLoader extends base_1.BaseEntityLoader {
+    constructor(connection, assetService, loggerFactory) {
+        super();
+        this.connection = connection;
+        this.assetService = assetService;
+        this.metadata = types_1.ASSET_LOADER_METADATA;
+        this.logger = loggerFactory.createLogger(index_1.LOGGER_CONTEXTS.ASSET_LOADER);
+        this.lookupHelper = (0, base_1.createLookupHelper)(this.assetService)
+            .addFilterStrategy('name', 'name', (ctx, svc, opts) => svc.findAll(ctx, opts))
+            .addIdStrategy((ctx, svc, id) => svc.findOne(ctx, id));
+    }
+    getDuplicateErrorMessage(record) {
+        const assetName = record.name || (0, helpers_1.extractFilenameFromUrl)(record.sourceUrl);
+        return `Asset with name "${assetName}" already exists`;
+    }
+    async findExisting(ctx, lookupFields, record) {
+        // Primary lookup by name and ID via helper
+        const result = await this.lookupHelper.findExisting(ctx, lookupFields, record);
+        if (result)
+            return result;
+        // Fallback: by source URL (field name mismatch: lookupField 'source' vs record 'sourceUrl')
+        if (record.sourceUrl && lookupFields.includes('source')) {
+            const assets = await this.assetService.findAll(ctx, {
+                filter: { source: { contains: (0, helpers_1.extractFilenameFromUrl)(record.sourceUrl) } },
+            });
+            if (assets.totalItems > 0) {
+                return { id: assets.items[0].id, entity: assets.items[0] };
+            }
+        }
+        return null;
+    }
+    async validate(_ctx, record, operation) {
+        const builder = new base_1.ValidationBuilder()
+            .requireStringForCreate('sourceUrl', record.sourceUrl, operation, 'Source URL is required');
+        // URL format validation (only if sourceUrl passed the required check)
+        if ((operation === enums_1.TARGET_OPERATION.CREATE || operation === enums_1.TARGET_OPERATION.UPSERT) &&
+            record.sourceUrl && typeof record.sourceUrl === 'string' && record.sourceUrl.trim() !== '') {
+            try {
+                new URL(record.sourceUrl);
+            }
+            catch {
+                builder.addError('sourceUrl', 'Invalid URL format', 'INVALID_FORMAT');
+            }
+        }
+        if (record.focalPoint) {
+            builder.addErrorIf(typeof record.focalPoint.x !== 'number' || record.focalPoint.x < 0 || record.focalPoint.x > 1, 'focalPoint.x', 'Focal point X must be between 0 and 1', 'INVALID_VALUE');
+            builder.addErrorIf(typeof record.focalPoint.y !== 'number' || record.focalPoint.y < 0 || record.focalPoint.y > 1, 'focalPoint.y', 'Focal point Y must be between 0 and 1', 'INVALID_VALUE');
+        }
+        return builder.build();
+    }
+    getFieldSchema() {
+        return {
+            entityType: enums_1.VendureEntityType.ASSET,
+            fields: [
+                {
+                    key: 'sourceUrl',
+                    label: 'Source URL',
+                    type: 'string',
+                    required: true,
+                    description: 'URL to download the asset from',
+                    example: 'https://example.com/images/product.jpg',
+                },
+                {
+                    key: 'name',
+                    label: 'Asset Name',
+                    type: 'string',
+                    lookupable: true,
+                    description: 'Display name for the asset (auto-generated from URL if not provided)',
+                    example: 'product-image.jpg',
+                },
+                {
+                    key: 'focalPoint',
+                    label: 'Focal Point',
+                    type: 'object',
+                    description: 'Focal point for image cropping (x, y between 0 and 1)',
+                    children: [
+                        { key: 'x', label: 'X Position', type: 'number', description: 'Horizontal focal point (0-1)' },
+                        { key: 'y', label: 'Y Position', type: 'number', description: 'Vertical focal point (0-1)' },
+                    ],
+                },
+                {
+                    key: 'tags',
+                    label: 'Tags',
+                    type: 'array',
+                    description: 'Array of tag names to assign to the asset',
+                    example: ['product', 'featured'],
+                },
+                {
+                    key: 'customFields',
+                    label: 'Custom Fields',
+                    type: 'object',
+                    description: 'Custom field values',
+                },
+            ],
+        };
+    }
+    async createEntity(context, record) {
+        const { ctx } = context;
+        const assetName = record.name || (0, helpers_1.extractFilenameFromUrl)(record.sourceUrl);
+        try {
+            const fileData = await (0, helpers_1.downloadFile)(record.sourceUrl);
+            if (!fileData) {
+                this.logger.warn(`Failed to download ${record.sourceUrl}`);
+                return null;
+            }
+            const mimeType = (0, helpers_1.getMimeType)(record.sourceUrl);
+            const file = {
+                filename: assetName,
+                mimetype: mimeType,
+                createReadStream: () => (0, helpers_1.createReadStreamFromBuffer)(fileData),
+            };
+            const assetResult = await this.assetService.create(ctx, {
+                file,
+                tags: record.tags,
+                customFields: record.customFields,
+            });
+            if ('errorCode' in assetResult) {
+                this.logger.error(`Asset creation error: ${assetResult.message}`);
+                return null;
+            }
+            const asset = assetResult;
+            if (record.focalPoint) {
+                await this.assetService.update(ctx, {
+                    id: asset.id,
+                    focalPoint: record.focalPoint,
+                });
+            }
+            this.logger.log(`Created asset ${assetName} (ID: ${asset.id})`);
+            return asset.id;
+        }
+        catch (error) {
+            this.logger.error(`Failed to create asset from URL ${record.sourceUrl}: ${error}`);
+            return null;
+        }
+    }
+    async updateEntity(context, assetId, record) {
+        const { ctx, options } = context;
+        const updateInput = { id: assetId };
+        if (record.name !== undefined && (0, helpers_1.shouldUpdateField)('name', options.updateOnlyFields)) {
+            updateInput.name = record.name;
+        }
+        if (record.focalPoint !== undefined && (0, helpers_1.shouldUpdateField)('focalPoint', options.updateOnlyFields)) {
+            updateInput.focalPoint = record.focalPoint;
+        }
+        if (record.customFields !== undefined && (0, helpers_1.shouldUpdateField)('customFields', options.updateOnlyFields)) {
+            updateInput.customFields = record.customFields;
+        }
+        await this.assetService.update(ctx, updateInput);
+        this.logger.debug(`Updated asset (ID: ${assetId})`);
+    }
+};
+exports.AssetLoader = AssetLoader;
+exports.AssetLoader = AssetLoader = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.TransactionalConnection,
+        core_1.AssetService,
+        logger_1.DataHubLoggerFactory])
+], AssetLoader);
+//# sourceMappingURL=asset.loader.js.map