@acorex-platform/framework-server 0.0.10 → 0.0.14

package/background-job/src/index.d.ts

@@ -0,0 +1,26 @@
+export * from './lib/bull-queue-root.module';
+export * from './lib/background-job.module';
+export * from './lib/background-job.service';
+export * from './lib/background-job.errors';
+export * from './lib/background-job-redis.config';
+export * from './lib/lock/distributed-lock.port';
+export * from './lib/lock/redis-distributed-lock.service';
+export * from './lib/store/background-job-store.service';
+export * from './lib/store/background-job-command-title.resolver';
+export * from './lib/store/background-job-capabilities.resolver';
+export * from './lib/store/background-job-attempt-store.service';
+export * from './lib/store/background-job-schedule-store.service';
+export * from './lib/store/background-job-schema.bootstrap';
+export * from './lib/execution/background-job-runtime';
+export * from './lib/execution/background-job-attempt.factory';
+export * from './lib/execution/background-job-cancellation.service';
+export * from './lib/execution/background-job-execution.service';
+export * from './lib/execution/background-job-retry-scheduler.service';
+export * from './lib/execution/background-job-retry.util';
+export * from './lib/execution/background-job-worker-id.util';
+export * from './lib/queue/background-job-dispatcher.service';
+export * from './lib/queue/background-job.processor';
+export * from './lib/schedule/background-job-schedule-scanner.service';
+export * from './lib/observability/background-job-observability.publisher';
+export * from './lib/observability/background-job-sanitize.util';
+//# sourceMappingURL=index.d.ts.map

package/background-job/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/framework/server/background-job/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,0CAA0C,CAAC;AACzD,cAAc,mDAAmD,CAAC;AAClE,cAAc,kDAAkD,CAAC;AACjE,cAAc,kDAAkD,CAAC;AACjE,cAAc,mDAAmD,CAAC;AAClE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AACvD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,qDAAqD,CAAC;AACpE,cAAc,kDAAkD,CAAC;AACjE,cAAc,wDAAwD,CAAC;AACvE,cAAc,2CAA2C,CAAC;AAC1D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,sCAAsC,CAAC;AACrD,cAAc,wDAAwD,CAAC;AACvE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,kDAAkD,CAAC"}

package/background-job/src/index.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/bull-queue-root.module"), exports);
+tslib_1.__exportStar(require("./lib/background-job.module"), exports);
+tslib_1.__exportStar(require("./lib/background-job.service"), exports);
+tslib_1.__exportStar(require("./lib/background-job.errors"), exports);
+tslib_1.__exportStar(require("./lib/background-job-redis.config"), exports);
+tslib_1.__exportStar(require("./lib/lock/distributed-lock.port"), exports);
+tslib_1.__exportStar(require("./lib/lock/redis-distributed-lock.service"), exports);
+tslib_1.__exportStar(require("./lib/store/background-job-store.service"), exports);
+tslib_1.__exportStar(require("./lib/store/background-job-command-title.resolver"), exports);
+tslib_1.__exportStar(require("./lib/store/background-job-capabilities.resolver"), exports);
+tslib_1.__exportStar(require("./lib/store/background-job-attempt-store.service"), exports);
+tslib_1.__exportStar(require("./lib/store/background-job-schedule-store.service"), exports);
+tslib_1.__exportStar(require("./lib/store/background-job-schema.bootstrap"), exports);
+tslib_1.__exportStar(require("./lib/execution/background-job-runtime"), exports);
+tslib_1.__exportStar(require("./lib/execution/background-job-attempt.factory"), exports);
+tslib_1.__exportStar(require("./lib/execution/background-job-cancellation.service"), exports);
+tslib_1.__exportStar(require("./lib/execution/background-job-execution.service"), exports);
+tslib_1.__exportStar(require("./lib/execution/background-job-retry-scheduler.service"), exports);
+tslib_1.__exportStar(require("./lib/execution/background-job-retry.util"), exports);
+tslib_1.__exportStar(require("./lib/execution/background-job-worker-id.util"), exports);
+tslib_1.__exportStar(require("./lib/queue/background-job-dispatcher.service"), exports);
+tslib_1.__exportStar(require("./lib/queue/background-job.processor"), exports);
+tslib_1.__exportStar(require("./lib/schedule/background-job-schedule-scanner.service"), exports);
+tslib_1.__exportStar(require("./lib/observability/background-job-observability.publisher"), exports);
+tslib_1.__exportStar(require("./lib/observability/background-job-sanitize.util"), exports);
+//# sourceMappingURL=index.js.map

package/background-job/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/framework/server/background-job/src/index.ts"],"names":[],"mappings":";;;AAAA,uEAA6C;AAC7C,sEAA4C;AAC5C,uEAA6C;AAC7C,sEAA4C;AAC5C,4EAAkD;AAClD,2EAAiD;AACjD,oFAA0D;AAC1D,mFAAyD;AACzD,4FAAkE;AAClE,2FAAiE;AACjE,2FAAiE;AACjE,4FAAkE;AAClE,sFAA4D;AAC5D,iFAAuD;AACvD,yFAA+D;AAC/D,8FAAoE;AACpE,2FAAiE;AACjE,iGAAuE;AACvE,oFAA0D;AAC1D,wFAA8D;AAC9D,wFAA8D;AAC9D,+EAAqD;AACrD,iGAAuE;AACvE,qGAA2E;AAC3E,2FAAiE"}

package/background-job/src/lib/background-job-redis.config.d.ts

@@ -0,0 +1,13 @@
+export type BackgroundJobRedisConnection = {
+    host: string;
+    port: number;
+} | {
+    url: string;
+} | null;
+/**
+ * Resolves the Redis connection for the background-job queue and distributed locks.
+ * Same environment contract as the workflow queue (`REDIS_URL` or `REDIS_HOST`/`REDIS_PORT`).
+ * Returns null when Redis is not configured — the engine then runs inline (single instance).
+ */
+export declare function resolveBackgroundJobRedisConnection(): BackgroundJobRedisConnection;
+//# sourceMappingURL=background-job-redis.config.d.ts.map

package/background-job/src/lib/background-job-redis.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-redis.config.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/background-job/src/lib/background-job-redis.config.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,4BAA4B,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAEnG;;;;GAIG;AACH,wBAAgB,mCAAmC,IAAI,4BAA4B,CAalF"}

package/background-job/src/lib/background-job-redis.config.js

@@ -0,0 +1,23 @@
+"use strict";
+//#region ---- Redis connection for background jobs ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveBackgroundJobRedisConnection = resolveBackgroundJobRedisConnection;
+/**
+ * Resolves the Redis connection for the background-job queue and distributed locks.
+ * Same environment contract as the workflow queue (`REDIS_URL` or `REDIS_HOST`/`REDIS_PORT`).
+ * Returns null when Redis is not configured — the engine then runs inline (single instance).
+ */
+function resolveBackgroundJobRedisConnection() {
+    const url = process.env['REDIS_URL']?.trim();
+    if (url) {
+        return { url };
+    }
+    const host = process.env['REDIS_HOST']?.trim();
+    const portRaw = Number(process.env['REDIS_PORT'] ?? 6379);
+    if (host) {
+        return { host, port: Number.isFinite(portRaw) ? portRaw : 6379 };
+    }
+    return null;
+}
+//#endregion
+//# sourceMappingURL=background-job-redis.config.js.map

package/background-job/src/lib/background-job-redis.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-redis.config.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/background-job/src/lib/background-job-redis.config.ts"],"names":[],"mappings":";AAAA,wDAAwD;;AASxD,kFAaC;AAlBD;;;;GAIG;AACH,SAAgB,mCAAmC;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC;IAC7C,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,CAAC;IAC1D,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,YAAY"}

package/background-job/src/lib/background-job.errors.d.ts

@@ -0,0 +1,4 @@
+import { type AXPBackgroundJobApiErrorPayload, type AXPBackgroundJobErrorCode } from '@acorex-platform/framework-shared/background-job';
+export declare function throwBackgroundJobBadRequest(code: AXPBackgroundJobErrorCode, payload?: Omit<AXPBackgroundJobApiErrorPayload, 'code'>): never;
+export declare function throwBackgroundJobNotFound(jobId: string): never;
+//# sourceMappingURL=background-job.errors.d.ts.map

package/background-job/src/lib/background-job.errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job.errors.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/background-job/src/lib/background-job.errors.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC/B,MAAM,kDAAkD,CAAC;AAE1D,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,yBAAyB,EAC/B,OAAO,GAAE,IAAI,CAAC,+BAA+B,EAAE,MAAM,CAAM,GAC1D,KAAK,CAEP;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAK/D"}

package/background-job/src/lib/background-job.errors.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.throwBackgroundJobBadRequest = throwBackgroundJobBadRequest;
+exports.throwBackgroundJobNotFound = throwBackgroundJobNotFound;
+const common_1 = require("@nestjs/common");
+const background_job_1 = require("@acorex-platform/framework-shared/background-job");
+function throwBackgroundJobBadRequest(code, payload = {}) {
+    throw new common_1.BadRequestException({ code, ...payload });
+}
+function throwBackgroundJobNotFound(jobId) {
+    throw new common_1.NotFoundException({
+        code: background_job_1.AXP_BACKGROUND_JOB_ERROR_CODES.NOT_FOUND,
+        jobId,
+    });
+}
+//# sourceMappingURL=background-job.errors.js.map

package/background-job/src/lib/background-job.errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job.errors.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/background-job/src/lib/background-job.errors.ts"],"names":[],"mappings":";;AAOA,oEAKC;AAED,gEAKC;AAnBD,2CAAwE;AACxE,qFAI0D;AAE1D,SAAgB,4BAA4B,CAC1C,IAA+B,EAC/B,UAAyD,EAAE;IAE3D,MAAM,IAAI,4BAAmB,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,SAAgB,0BAA0B,CAAC,KAAa;IACtD,MAAM,IAAI,0BAAiB,CAAC;QAC1B,IAAI,EAAE,+CAA8B,CAAC,SAAS;QAC9C,KAAK;KACoC,CAAC,CAAC;AAC/C,CAAC"}

package/background-job/src/lib/background-job.module.d.ts

@@ -0,0 +1,23 @@
+import { DynamicModule, type Type } from '@nestjs/common';
+import { type BackgroundJobRedisConnection } from './background-job-redis.config';
+import { BackgroundJobObservabilityPublisher } from './observability/background-job-observability.publisher';
+export interface BackgroundJobModuleOptions {
+    /**
+     * Explicit Redis connection; defaults to `REDIS_URL` / `REDIS_HOST` env vars.
+     * Without Redis the engine runs inline with in-process locks (single instance only).
+     */
+    readonly redis?: BackgroundJobRedisConnection;
+    /**
+     * When false, skips `BullModule.forRoot()` — use when the host app already
+     * imported `BullQueueRootModule.forRoot()` once.
+     */
+    readonly registerBullRoot?: boolean;
+    /** Disables the schedule scanner (e.g. one-off worker processes). */
+    readonly enableScheduleScanner?: boolean;
+    /** Override the default log-only observability publisher (e.g. system-insight adapter). */
+    readonly observabilityPublisher?: Type<BackgroundJobObservabilityPublisher>;
+}
+export declare class BackgroundJobModule {
+    static forRoot(options?: BackgroundJobModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=background-job.module.d.ts.map

package/background-job/src/lib/background-job.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job.module.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/background-job/src/lib/background-job.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAyB,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAKjF,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,+BAA+B,CAAC;AAWvC,OAAO,EACL,mCAAmC,EAEpC,MAAM,wDAAwD,CAAC;AAehE,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,4BAA4B,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,qEAAqE;IACrE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,2FAA2F;IAC3F,QAAQ,CAAC,sBAAsB,CAAC,EAAE,IAAI,CAAC,mCAAmC,CAAC,CAAC;CAC7E;AAMD,qBACa,mBAAmB;IAC9B,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,0BAA+B,GAAG,aAAa;CA2DxE"}

package/background-job/src/lib/background-job.module.js

@@ -0,0 +1,92 @@
+"use strict";
+var BackgroundJobModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackgroundJobModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const bullmq_1 = require("@nestjs/bullmq");
+const core_1 = require("@acorex-platform/framework-server/core");
+const providers_1 = require("@acorex-platform/framework-server/domain/providers");
+const background_job_1 = require("@acorex-platform/framework-shared/background-job");
+const background_job_redis_config_1 = require("./background-job-redis.config");
+const background_job_service_1 = require("./background-job.service");
+const background_job_attempt_factory_1 = require("./execution/background-job-attempt.factory");
+const background_job_cancellation_service_1 = require("./execution/background-job-cancellation.service");
+const background_job_execution_service_1 = require("./execution/background-job-execution.service");
+const background_job_retry_scheduler_service_1 = require("./execution/background-job-retry-scheduler.service");
+const distributed_lock_port_1 = require("./lock/distributed-lock.port");
+const redis_distributed_lock_service_1 = require("./lock/redis-distributed-lock.service");
+const background_job_observability_publisher_1 = require("./observability/background-job-observability.publisher");
+const background_job_dispatcher_service_1 = require("./queue/background-job-dispatcher.service");
+const background_job_processor_1 = require("./queue/background-job.processor");
+const background_job_schedule_scanner_service_1 = require("./schedule/background-job-schedule-scanner.service");
+const background_job_attempt_store_service_1 = require("./store/background-job-attempt-store.service");
+const background_job_schema_bootstrap_1 = require("./store/background-job-schema.bootstrap");
+const background_job_schedule_store_service_1 = require("./store/background-job-schedule-store.service");
+const background_job_command_title_resolver_1 = require("./store/background-job-command-title.resolver");
+const background_job_capabilities_resolver_1 = require("./store/background-job-capabilities.resolver");
+const background_job_store_service_1 = require("./store/background-job-store.service");
+//#endregion
+//#region ---- Background job module ----
+let BackgroundJobModule = BackgroundJobModule_1 = class BackgroundJobModule {
+    static forRoot(options = {}) {
+        const connection = options.redis ?? (0, background_job_redis_config_1.resolveBackgroundJobRedisConnection)();
+        const imports = [core_1.EntityStorageModule, providers_1.ServerCommandModule];
+        const providers = [
+            background_job_schema_bootstrap_1.BackgroundJobSchemaBootstrap,
+            background_job_store_service_1.BackgroundJobStoreService,
+            background_job_command_title_resolver_1.BackgroundJobCommandTitleResolver,
+            background_job_capabilities_resolver_1.BackgroundJobCapabilitiesResolver,
+            background_job_attempt_store_service_1.BackgroundJobAttemptStoreService,
+            background_job_schedule_store_service_1.BackgroundJobScheduleStoreService,
+            background_job_attempt_factory_1.BackgroundJobAttemptFactory,
+            background_job_cancellation_service_1.BackgroundJobCancellationService,
+            background_job_retry_scheduler_service_1.BackgroundJobRetrySchedulerService,
+            background_job_execution_service_1.BackgroundJobExecutionService,
+            background_job_dispatcher_service_1.BackgroundJobDispatcherService,
+            background_job_service_1.BackgroundJobService,
+            {
+                provide: distributed_lock_port_1.DistributedLockPort,
+                useFactory: () => connection ? new redis_distributed_lock_service_1.RedisDistributedLockService(connection) : new redis_distributed_lock_service_1.InProcessLockService(),
+            },
+            {
+                provide: background_job_observability_publisher_1.BackgroundJobObservabilityPublisher,
+                useClass: options.observabilityPublisher ?? background_job_observability_publisher_1.LoggingBackgroundJobObservabilityPublisher,
+            },
+        ];
+        if (connection) {
+            if (options.registerBullRoot !== false) {
+                imports.push(bullmq_1.BullModule.forRoot({ connection }));
+            }
+            imports.push(bullmq_1.BullModule.registerQueue({ name: background_job_1.AXP_BACKGROUND_JOBS_QUEUE }));
+            providers.push(background_job_processor_1.BackgroundJobProcessor);
+        }
+        if (options.enableScheduleScanner !== false) {
+            providers.push(background_job_schedule_scanner_service_1.BackgroundJobScheduleScannerService);
+        }
+        return {
+            module: BackgroundJobModule_1,
+            imports,
+            providers,
+            exports: [
+                background_job_service_1.BackgroundJobService,
+                background_job_dispatcher_service_1.BackgroundJobDispatcherService,
+                background_job_execution_service_1.BackgroundJobExecutionService,
+                background_job_cancellation_service_1.BackgroundJobCancellationService,
+                background_job_store_service_1.BackgroundJobStoreService,
+                background_job_command_title_resolver_1.BackgroundJobCommandTitleResolver,
+                background_job_capabilities_resolver_1.BackgroundJobCapabilitiesResolver,
+                background_job_attempt_store_service_1.BackgroundJobAttemptStoreService,
+                background_job_schedule_store_service_1.BackgroundJobScheduleStoreService,
+                distributed_lock_port_1.DistributedLockPort,
+                background_job_observability_publisher_1.BackgroundJobObservabilityPublisher,
+            ],
+        };
+    }
+};
+exports.BackgroundJobModule = BackgroundJobModule;
+exports.BackgroundJobModule = BackgroundJobModule = BackgroundJobModule_1 = tslib_1.__decorate([
+    (0, common_1.Module)({})
+], BackgroundJobModule);
+//#endregion
+//# sourceMappingURL=background-job.module.js.map

package/background-job/src/lib/background-job.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-job.module.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/background-job/src/lib/background-job.module.ts"],"names":[],"mappings":";;;;;AAAA,2CAAiF;AACjF,2CAA4C;AAC5C,iEAA6E;AAC7E,kFAAyF;AACzF,qFAA6F;AAC7F,+EAGuC;AACvC,qEAAgE;AAChE,+FAAyF;AACzF,yGAAmG;AACnG,mGAA6F;AAC7F,+GAAwG;AACxG,wEAAmE;AACnE,0FAG+C;AAC/C,mHAGgE;AAChE,iGAA2F;AAC3F,+EAA0E;AAC1E,gHAAyG;AACzG,uGAAgG;AAChG,6FAAuF;AACvF,yGAAkG;AAClG,yGAAkG;AAClG,uGAEsD;AACtD,uFAAiF;AAqBjF,YAAY;AAEZ,yCAAyC;AAGlC,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAC9B,MAAM,CAAC,OAAO,CAAC,UAAsC,EAAE;QACrD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,IAAI,IAAA,iEAAmC,GAAE,CAAC;QAE1E,MAAM,OAAO,GAA6B,CAAC,0BAAmB,EAAE,+BAAmB,CAAC,CAAC;QACrF,MAAM,SAAS,GAAe;YAC5B,8DAA4B;YAC5B,wDAAyB;YACzB,yEAAiC;YACjC,wEAAiC;YACjC,uEAAgC;YAChC,yEAAiC;YACjC,4DAA2B;YAC3B,sEAAgC;YAChC,2EAAkC;YAClC,gEAA6B;YAC7B,kEAA8B;YAC9B,6CAAoB;YACpB;gBACE,OAAO,EAAE,2CAAmB;gBAC5B,UAAU,EAAE,GAAG,EAAE,CACf,UAAU,CAAC,CAAC,CAAC,IAAI,4DAA2B,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,qDAAoB,EAAE;aACxF;YACD;gBACE,OAAO,EAAE,4EAAmC;gBAC5C,QAAQ,EAAE,OAAO,CAAC,sBAAsB,IAAI,mFAA0C;aACvF;SACF,CAAC;QAEF,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,gBAAgB,KAAK,KAAK,EAAE,CAAC;gBACvC,OAAO,CAAC,IAAI,CAAC,mBAAU,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,mBAAU,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,0CAAyB,EAAE,CAAC,CAAC,CAAC;YAC5E,SAAS,CAAC,IAAI,CAAC,iDAAsB,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,OAAO,CAAC,qBAAqB,KAAK,KAAK,EAAE,CAAC;YAC5C,SAAS,CAAC,IAAI,CAAC,6EAAmC,CAAC,CAAC;QACtD,CAAC;QAED,OAAO;YACL,MAAM,EAAE,qBAAmB;YAC3B,OAAO;YACP,SAAS;YACT,OAAO,EAAE;gBACP,6CAAoB;gBACpB,kEAA8B;gBAC9B,gEAA6B;gBAC7B,sEAAgC;gBAChC,wDAAyB;gBACzB,yEAAiC;gBACjC,wEAAiC;gBACjC,uEAAgC;gBAChC,yEAAiC;gBACjC,2CAAmB;gBACnB,4EAAmC;aACpC;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AA5DY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,mBAAmB,CA4D/B;AAED,YAAY"}

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

@@ -0,0 +1,40 @@
+import { type AXPBackgroundJob, type AXPCreateBackgroundJobRequest, type AXPCreateBackgroundJobResult, type AXPCancelBackgroundJobResult, type AXPRetryBackgroundJobResult } from '@acorex-platform/framework-shared/background-job';
+import { BackgroundJobCancellationService } from './execution/background-job-cancellation.service';
+import { BackgroundJobDispatcherService } from './queue/background-job-dispatcher.service';
+import { BackgroundJobAttemptStoreService } from './store/background-job-attempt-store.service';
+import { BackgroundJobCommandTitleResolver } from './store/background-job-command-title.resolver';
+import { BackgroundJobStoreService } from './store/background-job-store.service';
+/**
+ * Public entry point for job lifecycle commands (spec §5.1).
+ * Server command handlers and module controllers call this service.
+ */
+export declare class BackgroundJobService {
+    private readonly jobStore;
+    private readonly attemptStore;
+    private readonly commandTitleResolver;
+    private readonly dispatcher;
+    private readonly cancellation;
+    private readonly logger;
+    constructor(jobStore: BackgroundJobStoreService, attemptStore: BackgroundJobAttemptStoreService, commandTitleResolver: BackgroundJobCommandTitleResolver, dispatcher: BackgroundJobDispatcherService, cancellation: BackgroundJobCancellationService);
+    createJob(request: AXPCreateBackgroundJobRequest): Promise<AXPCreateBackgroundJobResult>;
+    cancelJob(jobId: string, options?: {
+        reason?: string;
+        cancelledBy?: string;
+    }): Promise<AXPCancelBackgroundJobResult>;
+    /** Hard-deletes a job and its attempts. */
+    deleteJob(jobId: string): Promise<{
+        success: boolean;
+    }>;
+    /** Creates a new attempt with `trigger = manual-retry` under the same logical job. */
+    retryJob(jobId: string): Promise<AXPRetryBackgroundJobResult>;
+    /**
+     * Creates a NEW logical job with `replayedFromJobId`; the original dead-lettered
+     * job remains immutable. First attempt uses `trigger = dead-letter-replay`.
+     */
+    replayDeadLetter(jobId: string): Promise<{
+        jobId: string;
+    }>;
+    getJob(jobId: string): Promise<AXPBackgroundJob | null>;
+    private resolveCreateCommand;
+}
+//# sourceMappingURL=background-job.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"background-job.service.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/background-job/src/lib/background-job.service.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,gBAAgB,EAErB,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EAEjC,KAAK,2BAA2B,EAEjC,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,gCAAgC,EAAE,MAAM,iDAAiD,CAAC;AACnG,OAAO,EAAE,8BAA8B,EAAE,MAAM,2CAA2C,CAAC;AAC3F,OAAO,EAAE,gCAAgC,EAAE,MAAM,8CAA8C,CAAC;AAChG,OAAO,EAAE,iCAAiC,EAAE,MAAM,+CAA+C,CAAC;AAClG,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAKjF;;;GAGG;AACH,qBACa,oBAAoB;IAI7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAP/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;gBAG7C,QAAQ,EAAE,yBAAyB,EACnC,YAAY,EAAE,gCAAgC,EAC9C,oBAAoB,EAAE,iCAAiC,EACvD,UAAU,EAAE,8BAA8B,EAC1C,YAAY,EAAE,gCAAgC;IAK3D,SAAS,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,4BAA4B,CAAC;IA8DxF,SAAS,CACb,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GACtD,OAAO,CAAC,4BAA4B,CAAC;IAIxC,2CAA2C;IACrC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAe7D,sFAAsF;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;IA4BnE;;;OAGG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IA8C3D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAQ/C,oBAAoB;CAqBnC"}

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

@@ -0,0 +1,194 @@
+"use strict";
+var BackgroundJobService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackgroundJobService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const background_job_1 = require("@acorex-platform/framework-shared/background-job");
+const background_job_cancellation_service_1 = require("./execution/background-job-cancellation.service");
+const background_job_dispatcher_service_1 = require("./queue/background-job-dispatcher.service");
+const background_job_attempt_store_service_1 = require("./store/background-job-attempt-store.service");
+const background_job_command_title_resolver_1 = require("./store/background-job-command-title.resolver");
+const background_job_store_service_1 = require("./store/background-job-store.service");
+const background_job_errors_1 = require("./background-job.errors");
+//#region ---- Background job facade (create / cancel / retry / replay / delete) ----
+/**
+ * Public entry point for job lifecycle commands (spec §5.1).
+ * Server command handlers and module controllers call this service.
+ */
+let BackgroundJobService = BackgroundJobService_1 = class BackgroundJobService {
+    constructor(jobStore, attemptStore, commandTitleResolver, dispatcher, cancellation) {
+        this.jobStore = jobStore;
+        this.attemptStore = attemptStore;
+        this.commandTitleResolver = commandTitleResolver;
+        this.dispatcher = dispatcher;
+        this.cancellation = cancellation;
+        this.logger = new common_1.Logger(BackgroundJobService_1.name);
+    }
+    //#region ---- Create ----
+    async createJob(request) {
+        const command = await this.resolveCreateCommand(request);
+        const commandKey = command.key;
+        if (!request.tenantId?.trim()) {
+            throw new Error('tenantId is required');
+        }
+        // Create-time deduplication: an active job with the same idempotency key wins.
+        if (request.idempotencyKey) {
+            const existing = await this.jobStore.findActiveByIdempotencyKey(request.idempotencyKey);
+            if (existing) {
+                this.logger.debug(`Job creation deduplicated by idempotency key '${request.idempotencyKey}' → ${existing.id}`);
+                return { jobId: existing.id, job: existing, deduplicated: true };
+            }
+        }
+        const retryPolicy = {
+            ...background_job_1.AXP_BACKGROUND_JOB_DEFAULT_RETRY_POLICY,
+            ...request.retryPolicy,
+        };
+        const now = new Date().toISOString();
+        const title = request.title?.trim() || command.title?.trim() || commandKey;
+        const job = await this.jobStore.insert({
+            command,
+            providerKey: request.providerKey ?? (0, background_job_1.deriveBackgroundJobProviderKey)(commandKey),
+            ...(request.scheduleId ? { scheduleId: request.scheduleId } : {}),
+            ...(request.scheduledOccurrence ? { scheduledOccurrence: request.scheduledOccurrence } : {}),
+            trigger: request.trigger ?? 'manual',
+            tenantId: request.tenantId,
+            userId: request.userId,
+            applicationId: request.applicationId,
+            title,
+            status: 'created',
+            payloadReference: request.payloadReference,
+            capabilities: request.capabilities ?? {},
+            retryPolicy,
+            executionTimeoutMs: request.executionTimeoutMs,
+            currentAttempt: 0,
+            maxAttempts: retryPolicy.maxAttempts,
+            idempotencyKey: request.idempotencyKey,
+            priority: request.priority,
+            visibility: request.visibility ?? 'initiator',
+            correlationId: request.correlationId,
+            parentJobId: request.parentJobId,
+            createdAt: now,
+            ...(request.stateInfo ? { stateInfo: request.stateInfo } : {}),
+        });
+        await this.dispatcher.dispatch(job.id, 'initial');
+        job.status = 'queued';
+        return { jobId: job.id, job };
+    }
+    //#endregion
+    //#region ---- Cancel ----
+    async cancelJob(jobId, options = {}) {
+        return this.cancellation.requestCancellation(jobId, options);
+    }
+    /** Hard-deletes a job and its attempts. */
+    async deleteJob(jobId) {
+        const job = await this.jobStore.getOne(jobId);
+        if (!job) {
+            return { success: false };
+        }
+        await this.attemptStore.deleteByJobId(jobId);
+        await this.jobStore.deleteOne(jobId);
+        return { success: true };
+    }
+    //#endregion
+    //#region ---- Retry / dead-letter replay ----
+    /** Creates a new attempt with `trigger = manual-retry` under the same logical job. */
+    async retryJob(jobId) {
+        const job = await this.jobStore.getOne(jobId);
+        if (!job) {
+            (0, background_job_errors_1.throwBackgroundJobNotFound)(jobId);
+        }
+        if (job.status === 'queued') {
+            await this.dispatcher.dispatch(jobId, 'manual-retry');
+            return { jobId, attemptId: '', attemptNumber: (job.currentAttempt ?? 0) + 1 };
+        }
+        if (job.status !== 'failed' && job.status !== 'cancelled') {
+            (0, background_job_errors_1.throwBackgroundJobBadRequest)(background_job_1.AXP_BACKGROUND_JOB_ERROR_CODES.RETRY_INVALID_STATUS, {
+                jobId,
+                status: job.status,
+            });
+        }
+        await this.jobStore.patch(jobId, {
+            completedAt: undefined,
+            cancellationRequestedAt: undefined,
+            cancelledAt: undefined,
+        });
+        await this.dispatcher.dispatch(jobId, 'manual-retry');
+        return { jobId, attemptId: '', attemptNumber: (job.currentAttempt ?? 0) + 1 };
+    }
+    /**
+     * Creates a NEW logical job with `replayedFromJobId`; the original dead-lettered
+     * job remains immutable. First attempt uses `trigger = dead-letter-replay`.
+     */
+    async replayDeadLetter(jobId) {
+        const original = await this.jobStore.getOne(jobId);
+        if (!original) {
+            (0, background_job_errors_1.throwBackgroundJobNotFound)(jobId);
+        }
+        if (original.status !== 'dead-lettered') {
+            (0, background_job_errors_1.throwBackgroundJobBadRequest)(background_job_1.AXP_BACKGROUND_JOB_ERROR_CODES.NOT_DEAD_LETTERED, {
+                jobId,
+                status: original.status,
+            });
+        }
+        const now = new Date().toISOString();
+        const replay = await this.jobStore.insert({
+            command: original.command,
+            providerKey: original.providerKey,
+            trigger: original.trigger,
+            tenantId: original.tenantId,
+            userId: original.userId,
+            applicationId: original.applicationId,
+            title: original.title,
+            ...(original.scheduleId ? { scheduleId: original.scheduleId } : {}),
+            status: 'created',
+            payloadReference: original.payloadReference,
+            capabilities: original.capabilities,
+            retryPolicy: original.retryPolicy,
+            executionTimeoutMs: original.executionTimeoutMs,
+            currentAttempt: 0,
+            maxAttempts: original.maxAttempts,
+            idempotencyKey: original.idempotencyKey,
+            priority: original.priority,
+            visibility: original.visibility,
+            correlationId: original.correlationId,
+            parentJobId: original.parentJobId,
+            replayedFromJobId: original.id,
+            createdAt: now,
+        });
+        await this.dispatcher.dispatch(replay.id, 'dead-letter-replay');
+        return { jobId: replay.id };
+    }
+    //#endregion
+    //#region ---- Reads ----
+    async getJob(jobId) {
+        return this.jobStore.getOne(jobId);
+    }
+    //#endregion
+    //#region ---- Helpers ----
+    async resolveCreateCommand(request) {
+        const key = request.command?.key?.trim();
+        if (!key) {
+            throw new Error('command.key is required');
+        }
+        const title = request.command?.title?.trim() ||
+            (await this.commandTitleResolver.resolve(key)) ||
+            undefined;
+        return {
+            key,
+            payload: request.command?.payload ?? {},
+            ...(title ? { title } : {}),
+        };
+    }
+};
+exports.BackgroundJobService = BackgroundJobService;
+exports.BackgroundJobService = BackgroundJobService = BackgroundJobService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [background_job_store_service_1.BackgroundJobStoreService,
+        background_job_attempt_store_service_1.BackgroundJobAttemptStoreService,
+        background_job_command_title_resolver_1.BackgroundJobCommandTitleResolver,
+        background_job_dispatcher_service_1.BackgroundJobDispatcherService,
+        background_job_cancellation_service_1.BackgroundJobCancellationService])
+], BackgroundJobService);
+//#endregion
+//# sourceMappingURL=background-job.service.js.map

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

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

package/background-job/src/lib/bull-queue-root.module.d.ts

@@ -0,0 +1,13 @@
+import { DynamicModule } from '@nestjs/common';
+import { type BackgroundJobRedisConnection } from './background-job-redis.config';
+/**
+ * Registers the global BullMQ connection. Import exactly once in the host app
+ * before any module that calls `BullModule.registerQueue()`.
+ *
+ * Feature modules (`BackgroundJobModule`, `WorkflowModule`, …) must not call
+ * `BullModule.forRoot()` — only `registerQueue()` — or workers stop consuming.
+ */
+export declare class BullQueueRootModule {
+    static forRoot(connection?: BackgroundJobRedisConnection): DynamicModule;
+}
+//# sourceMappingURL=bull-queue-root.module.d.ts.map

package/background-job/src/lib/bull-queue-root.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bull-queue-root.module.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/background-job/src/lib/bull-queue-root.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAE/D,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,+BAA+B,CAAC;AAIvC;;;;;;GAMG;AACH,qBAEa,mBAAmB;IAC9B,MAAM,CAAC,OAAO,CACZ,UAAU,GAAE,4BAAoE,GAC/E,aAAa;CAUjB"}

package/background-job/src/lib/bull-queue-root.module.js

@@ -0,0 +1,34 @@
+"use strict";
+var BullQueueRootModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BullQueueRootModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const bullmq_1 = require("@nestjs/bullmq");
+const background_job_redis_config_1 = require("./background-job-redis.config");
+//#region ---- Shared BullMQ root (register once per app) ----
+/**
+ * Registers the global BullMQ connection. Import exactly once in the host app
+ * before any module that calls `BullModule.registerQueue()`.
+ *
+ * Feature modules (`BackgroundJobModule`, `WorkflowModule`, …) must not call
+ * `BullModule.forRoot()` — only `registerQueue()` — or workers stop consuming.
+ */
+let BullQueueRootModule = BullQueueRootModule_1 = class BullQueueRootModule {
+    static forRoot(connection = (0, background_job_redis_config_1.resolveBackgroundJobRedisConnection)()) {
+        if (!connection) {
+            return { module: BullQueueRootModule_1 };
+        }
+        return {
+            module: BullQueueRootModule_1,
+            imports: [bullmq_1.BullModule.forRoot({ connection })],
+        };
+    }
+};
+exports.BullQueueRootModule = BullQueueRootModule;
+exports.BullQueueRootModule = BullQueueRootModule = BullQueueRootModule_1 = tslib_1.__decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], BullQueueRootModule);
+//#endregion
+//# sourceMappingURL=bull-queue-root.module.js.map

package/background-job/src/lib/bull-queue-root.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bull-queue-root.module.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/background-job/src/lib/bull-queue-root.module.ts"],"names":[],"mappings":";;;;;AAAA,2CAA+D;AAC/D,2CAA4C;AAC5C,+EAGuC;AAEvC,8DAA8D;AAE9D;;;;;;GAMG;AAGI,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAC9B,MAAM,CAAC,OAAO,CACZ,aAA2C,IAAA,iEAAmC,GAAE;QAEhF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,EAAE,MAAM,EAAE,qBAAmB,EAAE,CAAC;QACzC,CAAC;QAED,OAAO;YACL,MAAM,EAAE,qBAAmB;YAC3B,OAAO,EAAE,CAAC,mBAAU,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;SAC9C,CAAC;IACJ,CAAC;CACF,CAAA;AAbY,kDAAmB;8BAAnB,mBAAmB;IAF/B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,mBAAmB,CAa/B;AAED,YAAY"}

package/background-job/src/lib/execution/background-job-attempt.factory.d.ts

@@ -0,0 +1,14 @@
+import type { AXPBackgroundJob, AXPBackgroundJobAttempt, AXPBackgroundJobAttemptTrigger } from '@acorex-platform/framework-shared/background-job';
+import { BackgroundJobAttemptStoreService } from '../store/background-job-attempt-store.service';
+import { BackgroundJobStoreService } from '../store/background-job-store.service';
+/**
+ * Creates attempt rows with a monotonic `attemptNumber` and the correct attempt trigger,
+ * and advances the aggregate `currentAttempt` pointer on the logical job.
+ */
+export declare class BackgroundJobAttemptFactory {
+    private readonly attemptStore;
+    private readonly jobStore;
+    constructor(attemptStore: BackgroundJobAttemptStoreService, jobStore: BackgroundJobStoreService);
+    createAttempt(job: AXPBackgroundJob, trigger: AXPBackgroundJobAttemptTrigger, queueJobId?: string): Promise<AXPBackgroundJobAttempt>;
+}
+//# sourceMappingURL=background-job-attempt.factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-attempt.factory.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/background-job/src/lib/execution/background-job-attempt.factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,gCAAgC,EAAE,MAAM,+CAA+C,CAAC;AACjG,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAKlF;;;GAGG;AACH,qBACa,2BAA2B;IAEpC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,YAAY,EAAE,gCAAgC,EAC9C,QAAQ,EAAE,yBAAyB;IAGhD,aAAa,CACjB,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,8BAA8B,EACvC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,uBAAuB,CAAC;CAmBpC"}