@acorex-platform/framework-server 0.0.10 → 0.0.14

package/background-job/src/lib/execution/background-job-retry.util.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isErrorRetryable = isErrorRetryable;
+exports.computeBackoffDelayMs = computeBackoffDelayMs;
+exports.classifyRetry = classifyRetry;
+const background_job_1 = require("@acorex-platform/framework-shared/background-job");
+function isErrorRetryable(error, policy) {
+    const code = error.code?.trim();
+    if (code && policy.nonRetryableErrorCodes?.includes(code)) {
+        return false;
+    }
+    if (code && policy.retryableErrorCodes?.includes(code)) {
+        return true;
+    }
+    // Explicit flag from handler wins when the code lists are inconclusive.
+    if (typeof error.retryable === 'boolean') {
+        return error.retryable;
+    }
+    // When a retryable allowlist exists, unlisted codes are non-retryable.
+    if (policy.retryableErrorCodes && policy.retryableErrorCodes.length > 0) {
+        return false;
+    }
+    return true;
+}
+function computeBackoffDelayMs(policy, attemptNumber) {
+    const initial = Math.max(policy.initialDelayMs ?? 2000, 0);
+    const max = Math.max(policy.maxDelayMs ?? 300000, initial);
+    if (policy.backoff === 'fixed') {
+        return Math.min(initial, max);
+    }
+    // Exponential: initial * 2^(attemptNumber - 1)
+    const delay = initial * Math.pow(2, Math.max(attemptNumber - 1, 0));
+    return Math.min(delay, max);
+}
+/**
+ * Decides the next step after a failed or timed-out attempt.
+ * The engine owns business retries — BullMQ delivers with `attempts: 1`.
+ */
+function classifyRetry(job, error, timedOut) {
+    const policy = job.retryPolicy;
+    const exhaustedStatus = policy.onExhausted === 'dead-letter' ? 'dead-lettered' : 'failed';
+    if (timedOut && policy.timeoutPolicy) {
+        if (policy.timeoutPolicy === 'fail') {
+            return { retry: false, delayMs: 0, finalStatus: 'failed' };
+        }
+        if (policy.timeoutPolicy === 'dead-letter') {
+            return { retry: false, delayMs: 0, finalStatus: 'dead-lettered' };
+        }
+        // 'retry' falls through to attempt-count evaluation below.
+    }
+    const timeoutError = timedOut
+        ? { ...error, code: error.code ?? background_job_1.AXP_BACKGROUND_JOB_TIMEOUT_ERROR_CODE }
+        : error;
+    const retryable = timedOut
+        ? policy.timeoutPolicy === 'retry' || isErrorRetryable(timeoutError, policy)
+        : isErrorRetryable(timeoutError, policy);
+    const attemptsRemaining = (job.currentAttempt ?? 0) < (job.maxAttempts ?? 1);
+    if (retryable && attemptsRemaining) {
+        return {
+            retry: true,
+            delayMs: computeBackoffDelayMs(policy, job.currentAttempt ?? 1),
+            finalStatus: exhaustedStatus,
+        };
+    }
+    return { retry: false, delayMs: 0, finalStatus: exhaustedStatus };
+}
+//#endregion
+//# sourceMappingURL=background-job-retry.util.js.map

package/background-job/src/lib/execution/background-job-retry.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-retry.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/execution/background-job-retry.util.ts"],"names":[],"mappings":"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"}

package/background-job/src/lib/execution/background-job-runtime.d.ts

@@ -0,0 +1,18 @@
+/** Active background-job execution scope — available via {@link BackgroundJobRuntime.current}. */
+export interface BackgroundJobRuntimeContext {
+    readonly jobId: string;
+    readonly attemptId: string;
+    readonly signal: AbortSignal;
+    readonly payload: Record<string, unknown>;
+    readonly tenantId: string;
+    readonly userId?: string;
+    reportProgress(progress: number, statusText?: string, currentStep?: string): Promise<void>;
+    isCancellationRequested(): Promise<boolean>;
+    heartbeat(): Promise<void>;
+}
+export declare class BackgroundJobRuntime {
+    private static readonly storage;
+    static current(): BackgroundJobRuntimeContext | undefined;
+    static run<T>(context: BackgroundJobRuntimeContext, fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=background-job-runtime.d.ts.map

package/background-job/src/lib/execution/background-job-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-runtime.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/execution/background-job-runtime.ts"],"names":[],"mappings":"AAIA,kGAAkG;AAClG,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAwD;IAEvF,MAAM,CAAC,OAAO,IAAI,2BAA2B,GAAG,SAAS;IAIzD,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAGtF"}

package/background-job/src/lib/execution/background-job-runtime.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackgroundJobRuntime = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+class BackgroundJobRuntime {
+    static current() {
+        return this.storage.getStore();
+    }
+    static run(context, fn) {
+        return this.storage.run(context, fn);
+    }
+}
+exports.BackgroundJobRuntime = BackgroundJobRuntime;
+BackgroundJobRuntime.storage = new node_async_hooks_1.AsyncLocalStorage();
+//#endregion
+//# sourceMappingURL=background-job-runtime.js.map

package/background-job/src/lib/execution/background-job-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-runtime.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/execution/background-job-runtime.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAkBrD,MAAa,oBAAoB;IAG/B,MAAM,CAAC,OAAO;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,GAAG,CAAI,OAAoC,EAAE,EAAoB;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;;AATH,oDAUC;AATyB,4BAAO,GAAG,IAAI,oCAAiB,EAA+B,CAAC;AAWzF,YAAY"}

package/background-job/src/lib/execution/background-job-worker-id.util.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Phase 1 worker id: service name + host + process id + short instance id.
+ * No persistent `BackgroundJobWorker` registry required.
+ */
+export declare function getBackgroundJobWorkerId(): string;
+//# sourceMappingURL=background-job-worker-id.util.d.ts.map

package/background-job/src/lib/execution/background-job-worker-id.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-worker-id.util.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/execution/background-job-worker-id.util.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAMjD"}

package/background-job/src/lib/execution/background-job-worker-id.util.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBackgroundJobWorkerId = getBackgroundJobWorkerId;
+const node_os_1 = require("node:os");
+const node_crypto_1 = require("node:crypto");
+//#region ---- Worker identification (spec §7.5, Phase 1) ----
+let cachedWorkerId = null;
+/**
+ * Phase 1 worker id: service name + host + process id + short instance id.
+ * No persistent `BackgroundJobWorker` registry required.
+ */
+function getBackgroundJobWorkerId() {
+    if (!cachedWorkerId) {
+        const service = process.env['SERVICE_NAME']?.trim() || 'acorex-api';
+        cachedWorkerId = `${service}:${(0, node_os_1.hostname)()}:${process.pid}:${(0, node_crypto_1.randomUUID)().slice(0, 8)}`;
+    }
+    return cachedWorkerId;
+}
+//#endregion
+//# sourceMappingURL=background-job-worker-id.util.js.map

package/background-job/src/lib/execution/background-job-worker-id.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-worker-id.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/execution/background-job-worker-id.util.ts"],"names":[],"mappings":";;AAWA,4DAMC;AAjBD,qCAAmC;AACnC,6CAAyC;AAEzC,8DAA8D;AAE9D,IAAI,cAAc,GAAkB,IAAI,CAAC;AAEzC;;;GAGG;AACH,SAAgB,wBAAwB;IACtC,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,IAAI,YAAY,CAAC;QACpE,cAAc,GAAG,GAAG,OAAO,IAAI,IAAA,kBAAQ,GAAE,IAAI,OAAO,CAAC,GAAG,IAAI,IAAA,wBAAU,GAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACzF,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,YAAY"}

package/background-job/src/lib/lock/distributed-lock.port.d.ts

@@ -0,0 +1,17 @@
+export interface DistributedLockHandle {
+    readonly key: string;
+    readonly ownerToken: string;
+}
+/**
+ * Atomic distributed lock for schedule firing, scheduler leadership, and job execution.
+ * NOT `Common.RecordLock` — that service is for entity edit locks only.
+ */
+export declare abstract class DistributedLockPort {
+    /** Acquires the lock or returns null when it is held by another owner. */
+    abstract acquire(key: string, ttlMs: number): Promise<DistributedLockHandle | null>;
+    /** Extends the TTL; returns false when the lock is no longer owned by this handle. */
+    abstract renew(handle: DistributedLockHandle, ttlMs: number): Promise<boolean>;
+    /** Releases only when the owner token still matches (atomic check-and-delete). */
+    abstract release(handle: DistributedLockHandle): Promise<void>;
+}
+//# sourceMappingURL=distributed-lock.port.d.ts.map

package/background-job/src/lib/lock/distributed-lock.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributed-lock.port.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/lock/distributed-lock.port.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,8BAAsB,mBAAmB;IACvC,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAEnF,sFAAsF;IACtF,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAE9E,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;CAC/D"}

package/background-job/src/lib/lock/distributed-lock.port.js

@@ -0,0 +1,13 @@
+"use strict";
+//#region ---- Distributed lock port ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DistributedLockPort = void 0;
+/**
+ * Atomic distributed lock for schedule firing, scheduler leadership, and job execution.
+ * NOT `Common.RecordLock` — that service is for entity edit locks only.
+ */
+class DistributedLockPort {
+}
+exports.DistributedLockPort = DistributedLockPort;
+//#endregion
+//# sourceMappingURL=distributed-lock.port.js.map

package/background-job/src/lib/lock/distributed-lock.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributed-lock.port.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/lock/distributed-lock.port.ts"],"names":[],"mappings":";AAAA,yCAAyC;;;AAOzC;;;GAGG;AACH,MAAsB,mBAAmB;CASxC;AATD,kDASC;AAED,YAAY"}

package/background-job/src/lib/lock/redis-distributed-lock.service.d.ts

@@ -0,0 +1,27 @@
+import { OnModuleDestroy } from '@nestjs/common';
+import { type BackgroundJobRedisConnection } from '../background-job-redis.config';
+import { DistributedLockPort, type DistributedLockHandle } from './distributed-lock.port';
+/**
+ * Redis `SET key owner NX PX ttl` lock with owner-token-verified release and renewal.
+ */
+export declare class RedisDistributedLockService extends DistributedLockPort implements OnModuleDestroy {
+    private readonly logger;
+    private readonly client;
+    constructor(connection?: BackgroundJobRedisConnection);
+    acquire(key: string, ttlMs: number): Promise<DistributedLockHandle | null>;
+    renew(handle: DistributedLockHandle, ttlMs: number): Promise<boolean>;
+    release(handle: DistributedLockHandle): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+}
+/**
+ * Process-local lock used when Redis is not configured (development / single instance).
+ * Provides the same semantics within one Node process; NOT safe for multi-instance production.
+ */
+export declare class InProcessLockService extends DistributedLockPort {
+    private readonly locks;
+    acquire(key: string, ttlMs: number): Promise<DistributedLockHandle | null>;
+    renew(handle: DistributedLockHandle, ttlMs: number): Promise<boolean>;
+    release(handle: DistributedLockHandle): Promise<void>;
+    private evictExpired;
+}
+//# sourceMappingURL=redis-distributed-lock.service.d.ts.map

package/background-job/src/lib/lock/redis-distributed-lock.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-distributed-lock.service.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/lock/redis-distributed-lock.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGrE,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAsB1F;;GAEG;AACH,qBACa,2BAA4B,SAAQ,mBAAoB,YAAW,eAAe;IAC7F,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgD;IACvE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,UAAU,CAAC,EAAE,4BAA4B;IAiB/C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAM1E,KAAK,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWrE,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC;AAMD;;;GAGG;AACH,qBACa,oBAAqB,SAAQ,mBAAmB;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgE;IAEhF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAW1E,KAAK,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrE,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3D,OAAO,CAAC,YAAY;CAMrB"}

package/background-job/src/lib/lock/redis-distributed-lock.service.js

@@ -0,0 +1,117 @@
+"use strict";
+var RedisDistributedLockService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InProcessLockService = exports.RedisDistributedLockService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const node_crypto_1 = require("node:crypto");
+const ioredis_1 = tslib_1.__importDefault(require("ioredis"));
+const background_job_redis_config_1 = require("../background-job-redis.config");
+const distributed_lock_port_1 = require("./distributed-lock.port");
+//#region ---- Lua scripts (atomic owner-checked operations) ----
+const RELEASE_SCRIPT = `
+if redis.call("get", KEYS[1]) == ARGV[1] then
+  return redis.call("del", KEYS[1])
+else
+  return 0
+end`;
+const RENEW_SCRIPT = `
+if redis.call("get", KEYS[1]) == ARGV[1] then
+  return redis.call("pexpire", KEYS[1], ARGV[2])
+else
+  return 0
+end`;
+//#endregion
+//#region ---- Redis distributed lock ----
+/**
+ * Redis `SET key owner NX PX ttl` lock with owner-token-verified release and renewal.
+ */
+let RedisDistributedLockService = RedisDistributedLockService_1 = class RedisDistributedLockService extends distributed_lock_port_1.DistributedLockPort {
+    constructor(connection) {
+        super();
+        this.logger = new common_1.Logger(RedisDistributedLockService_1.name);
+        const resolved = connection ?? (0, background_job_redis_config_1.resolveBackgroundJobRedisConnection)();
+        if (!resolved) {
+            throw new Error('RedisDistributedLockService requires a Redis connection');
+        }
+        this.client =
+            'url' in resolved
+                ? new ioredis_1.default(resolved.url, { lazyConnect: true, maxRetriesPerRequest: 2 })
+                : new ioredis_1.default({ ...resolved, lazyConnect: true, maxRetriesPerRequest: 2 });
+        this.client.on('error', (err) => {
+            this.logger.warn(`Redis lock client error: ${err.message}`);
+        });
+    }
+    async acquire(key, ttlMs) {
+        const ownerToken = (0, node_crypto_1.randomUUID)();
+        const result = await this.client.set(key, ownerToken, 'PX', ttlMs, 'NX');
+        return result === 'OK' ? { key, ownerToken } : null;
+    }
+    async renew(handle, ttlMs) {
+        const result = await this.client.eval(RENEW_SCRIPT, 1, handle.key, handle.ownerToken, String(ttlMs));
+        return result === 1;
+    }
+    async release(handle) {
+        try {
+            await this.client.eval(RELEASE_SCRIPT, 1, handle.key, handle.ownerToken);
+        }
+        catch (err) {
+            this.logger.warn(`Failed to release lock ${handle.key}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    async onModuleDestroy() {
+        await this.client.quit().catch(() => this.client.disconnect());
+    }
+};
+exports.RedisDistributedLockService = RedisDistributedLockService;
+exports.RedisDistributedLockService = RedisDistributedLockService = RedisDistributedLockService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], RedisDistributedLockService);
+//#endregion
+//#region ---- In-process fallback lock (no Redis, single instance only) ----
+/**
+ * Process-local lock used when Redis is not configured (development / single instance).
+ * Provides the same semantics within one Node process; NOT safe for multi-instance production.
+ */
+let InProcessLockService = class InProcessLockService extends distributed_lock_port_1.DistributedLockPort {
+    constructor() {
+        super(...arguments);
+        this.locks = new Map();
+    }
+    async acquire(key, ttlMs) {
+        this.evictExpired(key);
+        if (this.locks.has(key)) {
+            return null;
+        }
+        const ownerToken = (0, node_crypto_1.randomUUID)();
+        this.locks.set(key, { ownerToken, expiresAt: Date.now() + ttlMs });
+        return { key, ownerToken };
+    }
+    async renew(handle, ttlMs) {
+        const entry = this.locks.get(handle.key);
+        if (!entry || entry.ownerToken !== handle.ownerToken) {
+            return false;
+        }
+        entry.expiresAt = Date.now() + ttlMs;
+        return true;
+    }
+    async release(handle) {
+        const entry = this.locks.get(handle.key);
+        if (entry && entry.ownerToken === handle.ownerToken) {
+            this.locks.delete(handle.key);
+        }
+    }
+    evictExpired(key) {
+        const entry = this.locks.get(key);
+        if (entry && entry.expiresAt <= Date.now()) {
+            this.locks.delete(key);
+        }
+    }
+};
+exports.InProcessLockService = InProcessLockService;
+exports.InProcessLockService = InProcessLockService = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], InProcessLockService);
+//#endregion
+//# sourceMappingURL=redis-distributed-lock.service.js.map

package/background-job/src/lib/lock/redis-distributed-lock.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-distributed-lock.service.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/lock/redis-distributed-lock.service.ts"],"names":[],"mappings":"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"}

package/background-job/src/lib/observability/background-job-observability.publisher.d.ts

@@ -0,0 +1,21 @@
+import { type AXPBackgroundJob, type AXPBackgroundJobAttempt } from '@acorex-platform/framework-shared/background-job';
+/**
+ * Publishes terminal attempt logs (`recordType = attempt`) and optional logical
+ * job summaries (`recordType = job-summary`) to the observability backend.
+ * The default implementation logs locally; the system-insight adapter is provided
+ * by the background-job-management server module.
+ *
+ * Observability storage is never the operational source of truth (spec principle 8).
+ */
+export declare abstract class BackgroundJobObservabilityPublisher {
+    /** Called once per terminal attempt. Payload snapshots must already be sanitized. */
+    abstract publishAttemptTerminal(job: AXPBackgroundJob, attempt: AXPBackgroundJobAttempt): Promise<void>;
+    /** Called once when the logical job reaches terminal status. */
+    abstract publishJobTerminal(job: AXPBackgroundJob): Promise<void>;
+}
+export declare class LoggingBackgroundJobObservabilityPublisher extends BackgroundJobObservabilityPublisher {
+    private readonly logger;
+    publishAttemptTerminal(job: AXPBackgroundJob, attempt: AXPBackgroundJobAttempt): Promise<void>;
+    publishJobTerminal(job: AXPBackgroundJob): Promise<void>;
+}
+//# sourceMappingURL=background-job-observability.publisher.d.ts.map

package/background-job/src/lib/observability/background-job-observability.publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-observability.publisher.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/observability/background-job-observability.publisher.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC7B,MAAM,kDAAkD,CAAC;AAI1D;;;;;;;GAOG;AACH,8BAAsB,mCAAmC;IACvD,qFAAqF;IACrF,QAAQ,CAAC,sBAAsB,CAC7B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAEhB,gEAAgE;IAChE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAClE;AAMD,qBACa,0CAA2C,SAAQ,mCAAmC;IACjG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;IAE7D,sBAAsB,CAC1B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAQV,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAM/D"}

package/background-job/src/lib/observability/background-job-observability.publisher.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggingBackgroundJobObservabilityPublisher = exports.BackgroundJobObservabilityPublisher = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const background_job_1 = require("@acorex-platform/framework-shared/background-job");
+//#region ---- Observability publisher port (spec §7.2, §10.1) ----
+/**
+ * Publishes terminal attempt logs (`recordType = attempt`) and optional logical
+ * job summaries (`recordType = job-summary`) to the observability backend.
+ * The default implementation logs locally; the system-insight adapter is provided
+ * by the background-job-management server module.
+ *
+ * Observability storage is never the operational source of truth (spec principle 8).
+ */
+class BackgroundJobObservabilityPublisher {
+}
+exports.BackgroundJobObservabilityPublisher = BackgroundJobObservabilityPublisher;
+//#endregion
+//#region ---- Default (log-only) publisher ----
+let LoggingBackgroundJobObservabilityPublisher = class LoggingBackgroundJobObservabilityPublisher extends BackgroundJobObservabilityPublisher {
+    constructor() {
+        super(...arguments);
+        this.logger = new common_1.Logger('BackgroundJobObservability');
+    }
+    async publishAttemptTerminal(job, attempt) {
+        this.logger.log(`attempt terminal: job=${job.id} type=${(0, background_job_1.resolveBackgroundJobCommandKey)(job)} attempt=${attempt.attemptNumber}/${job.maxAttempts} ` +
+            `trigger=${attempt.trigger} status=${attempt.status} duration=${attempt.durationMs ?? '-'}ms` +
+            (attempt.error ? ` error=${attempt.error.code ?? ''}:${attempt.error.message}` : ''));
+    }
+    async publishJobTerminal(job) {
+        this.logger.log(`job terminal: job=${job.id} type=${(0, background_job_1.resolveBackgroundJobCommandKey)(job)} status=${job.status} ` +
+            `attempts=${job.currentAttempt} totalDuration=${job.totalDurationMs ?? '-'}ms`);
+    }
+};
+exports.LoggingBackgroundJobObservabilityPublisher = LoggingBackgroundJobObservabilityPublisher;
+exports.LoggingBackgroundJobObservabilityPublisher = LoggingBackgroundJobObservabilityPublisher = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], LoggingBackgroundJobObservabilityPublisher);
+//#endregion
+//# sourceMappingURL=background-job-observability.publisher.js.map

package/background-job/src/lib/observability/background-job-observability.publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-observability.publisher.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/observability/background-job-observability.publisher.ts"],"names":[],"mappings":";;;;AAAA,2CAAoD;AACpD,qFAI0D;AAE1D,mEAAmE;AAEnE;;;;;;;GAOG;AACH,MAAsB,mCAAmC;CASxD;AATD,kFASC;AAED,YAAY;AAEZ,gDAAgD;AAGzC,IAAM,0CAA0C,GAAhD,MAAM,0CAA2C,SAAQ,mCAAmC;IAA5F;;QACY,WAAM,GAAG,IAAI,eAAM,CAAC,4BAA4B,CAAC,CAAC;IAmBrE,CAAC;IAjBC,KAAK,CAAC,sBAAsB,CAC1B,GAAqB,EACrB,OAAgC;QAEhC,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,yBAAyB,GAAG,CAAC,EAAE,SAAS,IAAA,+CAA8B,EAAC,GAAG,CAAC,YAAY,OAAO,CAAC,aAAa,IAAI,GAAG,CAAC,WAAW,GAAG;YAChI,WAAW,OAAO,CAAC,OAAO,WAAW,OAAO,CAAC,MAAM,aAAa,OAAO,CAAC,UAAU,IAAI,GAAG,IAAI;YAC7F,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACvF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,GAAqB;QAC5C,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,qBAAqB,GAAG,CAAC,EAAE,SAAS,IAAA,+CAA8B,EAAC,GAAG,CAAC,WAAW,GAAG,CAAC,MAAM,GAAG;YAC7F,YAAY,GAAG,CAAC,cAAc,kBAAkB,GAAG,CAAC,eAAe,IAAI,GAAG,IAAI,CACjF,CAAC;IACJ,CAAC;CACF,CAAA;AApBY,gGAA0C;qDAA1C,0CAA0C;IADtD,IAAA,mBAAU,GAAE;GACA,0CAA0C,CAoBtD;AAED,YAAY"}

package/background-job/src/lib/observability/background-job-sanitize.util.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Redacts sensitive keys and truncates oversized values before a payload/result
+ * snapshot is written to System Insight. Never mutates the input.
+ */
+export declare function sanitizeForObservability(value: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+//# sourceMappingURL=background-job-sanitize.util.d.ts.map

package/background-job/src/lib/observability/background-job-sanitize.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-sanitize.util.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/observability/background-job-sanitize.util.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAYrC"}

package/background-job/src/lib/observability/background-job-sanitize.util.js

@@ -0,0 +1,42 @@
+"use strict";
+//#region ---- Payload sanitization for observability (spec §4.5) ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeForObservability = sanitizeForObservability;
+const SENSITIVE_KEY_PATTERN = /token|secret|password|credential|authorization|api[-_]?key|private[-_]?key|client[-_]?secret/i;
+const MAX_SNAPSHOT_LENGTH = 4096;
+/**
+ * Redacts sensitive keys and truncates oversized values before a payload/result
+ * snapshot is written to System Insight. Never mutates the input.
+ */
+function sanitizeForObservability(value) {
+    if (!value) {
+        return undefined;
+    }
+    const sanitized = redactObject(value, 0);
+    const json = JSON.stringify(sanitized);
+    if (json.length <= MAX_SNAPSHOT_LENGTH) {
+        return sanitized;
+    }
+    return { __truncated: true, preview: json.slice(0, MAX_SNAPSHOT_LENGTH) };
+}
+function redactObject(value, depth) {
+    if (depth > 5) {
+        return { __truncated: true };
+    }
+    const result = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (SENSITIVE_KEY_PATTERN.test(key)) {
+            result[key] = '[REDACTED]';
+            continue;
+        }
+        if (entry && typeof entry === 'object' && !Array.isArray(entry)) {
+            result[key] = redactObject(entry, depth + 1);
+        }
+        else {
+            result[key] = entry;
+        }
+    }
+    return result;
+}
+//#endregion
+//# sourceMappingURL=background-job-sanitize.util.js.map

package/background-job/src/lib/observability/background-job-sanitize.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-sanitize.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/observability/background-job-sanitize.util.ts"],"names":[],"mappings":";AAAA,sEAAsE;;AAWtE,4DAcC;AAvBD,MAAM,qBAAqB,GACzB,+FAA+F,CAAC;AAElG,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;;;GAGG;AACH,SAAgB,wBAAwB,CACtC,KAA0C;IAE1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,IAAI,CAAC,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACvC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,SAAS,YAAY,CAAC,KAA8B,EAAE,KAAa;IACjE,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,KAAgC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,YAAY"}

package/background-job/src/lib/queue/background-job-dispatcher.service.d.ts

@@ -0,0 +1,12 @@
+import type { AXPBackgroundJobAttemptTrigger } from '@acorex-platform/framework-shared/background-job';
+import { BackgroundJobRetrySchedulerService } from '../execution/background-job-retry-scheduler.service';
+import { BackgroundJobStoreService } from '../store/background-job-store.service';
+export declare class BackgroundJobDispatcherService {
+    private readonly jobStore;
+    private readonly scheduler;
+    private readonly logger;
+    constructor(jobStore: BackgroundJobStoreService, scheduler: BackgroundJobRetrySchedulerService);
+    /** Marks the job queued and hands it to the queue (or inline executor). */
+    dispatch(jobId: string, attemptTrigger: AXPBackgroundJobAttemptTrigger, delayMs?: number): Promise<void>;
+}
+//# sourceMappingURL=background-job-dispatcher.service.d.ts.map

package/background-job/src/lib/queue/background-job-dispatcher.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-dispatcher.service.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/queue/background-job-dispatcher.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kDAAkD,CAAC;AACvG,OAAO,EAAE,kCAAkC,EAAE,MAAM,qDAAqD,CAAC;AACzG,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAIlF,qBACa,8BAA8B;IAIvC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmD;gBAGvD,QAAQ,EAAE,yBAAyB,EACnC,SAAS,EAAE,kCAAkC;IAGhE,2EAA2E;IACrE,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,8BAA8B,EAC9C,OAAO,SAAI,GACV,OAAO,CAAC,IAAI,CAAC;CAsBjB"}

package/background-job/src/lib/queue/background-job-dispatcher.service.js

@@ -0,0 +1,43 @@
+"use strict";
+var BackgroundJobDispatcherService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackgroundJobDispatcherService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const background_job_retry_scheduler_service_1 = require("../execution/background-job-retry-scheduler.service");
+const background_job_store_service_1 = require("../store/background-job-store.service");
+//#region ---- Dispatcher (enqueue BullMQ or inline execute) ----
+let BackgroundJobDispatcherService = BackgroundJobDispatcherService_1 = class BackgroundJobDispatcherService {
+    constructor(jobStore, scheduler) {
+        this.jobStore = jobStore;
+        this.scheduler = scheduler;
+        this.logger = new common_1.Logger(BackgroundJobDispatcherService_1.name);
+    }
+    /** Marks the job queued and hands it to the queue (or inline executor). */
+    async dispatch(jobId, attemptTrigger, delayMs = 0) {
+        const job = await this.jobStore.getOne(jobId);
+        if (!job) {
+            throw new Error(`Job ${jobId} not found`);
+        }
+        await this.jobStore.patch(jobId, {
+            status: 'queued',
+            queuedAt: new Date().toISOString(),
+        });
+        await this.scheduler.scheduleExecution({
+            jobId,
+            attemptTrigger,
+            tenantId: job.tenantId,
+            userId: job.userId,
+            applicationId: job.applicationId,
+        }, delayMs);
+        this.logger.debug(`Dispatched job ${jobId} (${attemptTrigger}, delay ${delayMs}ms)`);
+    }
+};
+exports.BackgroundJobDispatcherService = BackgroundJobDispatcherService;
+exports.BackgroundJobDispatcherService = BackgroundJobDispatcherService = BackgroundJobDispatcherService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [background_job_store_service_1.BackgroundJobStoreService,
+        background_job_retry_scheduler_service_1.BackgroundJobRetrySchedulerService])
+], BackgroundJobDispatcherService);
+//#endregion
+//# sourceMappingURL=background-job-dispatcher.service.js.map

package/background-job/src/lib/queue/background-job-dispatcher.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-dispatcher.service.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/queue/background-job-dispatcher.service.ts"],"names":[],"mappings":";;;;;AAAA,2CAAoD;AAEpD,gHAAyG;AACzG,wFAAkF;AAElF,iEAAiE;AAG1D,IAAM,8BAA8B,sCAApC,MAAM,8BAA8B;IAGzC,YACmB,QAAmC,EACnC,SAA6C;QAD7C,aAAQ,GAAR,QAAQ,CAA2B;QACnC,cAAS,GAAT,SAAS,CAAoC;QAJ/C,WAAM,GAAG,IAAI,eAAM,CAAC,gCAA8B,CAAC,IAAI,CAAC,CAAC;IAKvE,CAAC;IAEJ,2EAA2E;IAC3E,KAAK,CAAC,QAAQ,CACZ,KAAa,EACb,cAA8C,EAC9C,OAAO,GAAG,CAAC;QAEX,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,YAAY,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE;YAC/B,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACnC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,SAAS,CAAC,iBAAiB,CACpC;YACE,KAAK;YACL,cAAc;YACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,aAAa,EAAE,GAAG,CAAC,aAAa;SACjC,EACD,OAAO,CACR,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,KAAK,KAAK,cAAc,WAAW,OAAO,KAAK,CAAC,CAAC;IACvF,CAAC;CACF,CAAA;AAnCY,wEAA8B;yCAA9B,8BAA8B;IAD1C,IAAA,mBAAU,GAAE;6CAKkB,wDAAyB;QACxB,2EAAkC;GALrD,8BAA8B,CAmC1C;AAED,YAAY"}

package/background-job/src/lib/queue/background-job.processor.d.ts

@@ -0,0 +1,11 @@
+import { WorkerHost } from '@nestjs/bullmq';
+import type { Job } from 'bullmq';
+import { BackgroundJobExecutionService } from '../execution/background-job-execution.service';
+import type { BackgroundJobQueuePayload } from '../execution/background-job-retry-scheduler.service';
+export declare class BackgroundJobProcessor extends WorkerHost {
+    private readonly execution;
+    private readonly logger;
+    constructor(execution: BackgroundJobExecutionService);
+    process(job: Job<BackgroundJobQueuePayload>): Promise<void>;
+}
+//# sourceMappingURL=background-job.processor.d.ts.map

package/background-job/src/lib/queue/background-job.processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job.processor.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/queue/background-job.processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAKlC,OAAO,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AAC9F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qDAAqD,CAAC;AAIrG,qBACa,sBAAuB,SAAQ,UAAU;IAGxC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;gBAErC,SAAS,EAAE,6BAA6B;IAI/D,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAuBlE"}

package/background-job/src/lib/queue/background-job.processor.js

@@ -0,0 +1,44 @@
+"use strict";
+var BackgroundJobProcessor_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackgroundJobProcessor = void 0;
+const tslib_1 = require("tslib");
+const bullmq_1 = require("@nestjs/bullmq");
+const common_1 = require("@nestjs/common");
+const background_job_1 = require("@acorex-platform/framework-shared/background-job");
+const background_job_execution_service_1 = require("../execution/background-job-execution.service");
+//#region ---- BullMQ processor (queue delivery only — spec §9.2) ----
+let BackgroundJobProcessor = BackgroundJobProcessor_1 = class BackgroundJobProcessor extends bullmq_1.WorkerHost {
+    constructor(execution) {
+        super();
+        this.execution = execution;
+        this.logger = new common_1.Logger(BackgroundJobProcessor_1.name);
+    }
+    async process(job) {
+        if (job.name !== background_job_1.AXP_BACKGROUND_JOB_EXECUTE) {
+            this.logger.warn(`Unknown background job: ${job.name}`);
+            return;
+        }
+        try {
+            await this.execution.executeAttempt({
+                jobId: job.data.jobId,
+                attemptTrigger: job.data.attemptTrigger,
+                tenantId: job.data.tenantId,
+                userId: job.data.userId,
+                applicationId: job.data.applicationId,
+                queueJobId: job.id,
+            });
+        }
+        catch (error) {
+            this.logger.error(`Background job ${job.data.jobId} failed: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error.stack : undefined);
+            throw error;
+        }
+    }
+};
+exports.BackgroundJobProcessor = BackgroundJobProcessor;
+exports.BackgroundJobProcessor = BackgroundJobProcessor = BackgroundJobProcessor_1 = tslib_1.__decorate([
+    (0, bullmq_1.Processor)(background_job_1.AXP_BACKGROUND_JOBS_QUEUE),
+    tslib_1.__metadata("design:paramtypes", [background_job_execution_service_1.BackgroundJobExecutionService])
+], BackgroundJobProcessor);
+//#endregion
+//# sourceMappingURL=background-job.processor.js.map