@acorex-platform/framework-shared 0.0.10 → 0.0.15

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

@@ -0,0 +1,5 @@
+export * from './lib/background-job.constants';
+export * from './lib/background-job.errors';
+export * from './lib/background-job-result.util';
+export * from './lib/background-job.types';
+//# 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/shared/background-job/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC"}

package/background-job/src/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/background-job.constants"), exports);
+tslib_1.__exportStar(require("./lib/background-job.errors"), exports);
+tslib_1.__exportStar(require("./lib/background-job-result.util"), exports);
+tslib_1.__exportStar(require("./lib/background-job.types"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/framework/shared/background-job/src/index.ts"],"names":[],"mappings":";;;AAAA,yEAA+C;AAC/C,sEAA4C;AAC5C,2EAAiD;AACjD,qEAA2C"}

package/background-job/src/lib/background-job-result.util.d.ts

@@ -0,0 +1,12 @@
+import type { AXPBackgroundJobError, AXPBackgroundJobHandlerResult, AXPBackgroundJobResult } from './background-job.types';
+export declare function buildBackgroundJobSuccessResult(data?: Record<string, unknown> | null, message?: string | null): AXPBackgroundJobResult | undefined;
+export declare function buildBackgroundJobFailureResult(error: AXPBackgroundJobError, stack?: string): AXPBackgroundJobResult;
+export declare function resolveBackgroundJobResultMessage(result: AXPBackgroundJobResult | undefined): string | undefined;
+export declare function resolveBackgroundJobResultErrorCode(result: AXPBackgroundJobResult | undefined): string | undefined;
+export declare function buildBackgroundJobHandlerResultFromCommand(commandResult: {
+    data?: unknown;
+    message?: {
+        text?: string | Record<string, string>;
+    };
+}): AXPBackgroundJobHandlerResult | undefined;
+//# sourceMappingURL=background-job-result.util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"background-job-result.util.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/shared/background-job/src/lib/background-job-result.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAM3H,wBAAgB,+BAA+B,CAC7C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACrC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,sBAAsB,GAAG,SAAS,CAYpC;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,qBAAqB,EAC5B,KAAK,CAAC,EAAE,MAAM,GACb,sBAAsB,CAmBxB;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,sBAAsB,GAAG,SAAS,GACzC,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,sBAAsB,GAAG,SAAS,GACzC,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,0CAA0C,CACxD,aAAa,EAAE;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CACtD,GACA,6BAA6B,GAAG,SAAS,CAqB3C"}

package/background-job/src/lib/background-job-result.util.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBackgroundJobSuccessResult = buildBackgroundJobSuccessResult;
+exports.buildBackgroundJobFailureResult = buildBackgroundJobFailureResult;
+exports.resolveBackgroundJobResultMessage = resolveBackgroundJobResultMessage;
+exports.resolveBackgroundJobResultErrorCode = resolveBackgroundJobResultErrorCode;
+exports.buildBackgroundJobHandlerResultFromCommand = buildBackgroundJobHandlerResultFromCommand;
+//#region ---- Result envelope helpers ----
+const MAX_RESULT_STACK_LENGTH = 8192;
+function buildBackgroundJobSuccessResult(data, message) {
+    const normalizedMessage = (message === null || message === void 0 ? void 0 : message.trim()) || undefined;
+    const normalizedData = data !== null && data !== void 0 ? data : undefined;
+    if (!normalizedData && !normalizedMessage) {
+        return undefined;
+    }
+    return Object.assign(Object.assign({}, (normalizedData ? { data: normalizedData } : {})), (normalizedMessage ? { message: normalizedMessage } : {}));
+}
+function buildBackgroundJobFailureResult(error, stack) {
+    const data = {};
+    if (error.code) {
+        data['code'] = error.code;
+    }
+    if (typeof error.retryable === 'boolean') {
+        data['retryable'] = error.retryable;
+    }
+    if (error.detail) {
+        data['detail'] = error.detail;
+    }
+    const trimmedStack = stack === null || stack === void 0 ? void 0 : stack.trim();
+    return Object.assign(Object.assign({ message: error.message }, (Object.keys(data).length > 0 ? { data } : {})), (trimmedStack ? { stack: trimmedStack.slice(0, MAX_RESULT_STACK_LENGTH) } : {}));
+}
+function resolveBackgroundJobResultMessage(result) {
+    var _a;
+    const message = (_a = result === null || result === void 0 ? void 0 : result.message) === null || _a === void 0 ? void 0 : _a.trim();
+    return message || undefined;
+}
+function resolveBackgroundJobResultErrorCode(result) {
+    var _a;
+    const code = (_a = result === null || result === void 0 ? void 0 : result.data) === null || _a === void 0 ? void 0 : _a['code'];
+    return typeof code === 'string' ? code : undefined;
+}
+function buildBackgroundJobHandlerResultFromCommand(commandResult) {
+    var _a, _b, _c, _d;
+    const rawText = (_a = commandResult.message) === null || _a === void 0 ? void 0 : _a.text;
+    const message = typeof rawText === 'string'
+        ? rawText.trim() || undefined
+        : rawText && typeof rawText === 'object'
+            ? String((_d = (_c = (_b = rawText['en-US']) !== null && _b !== void 0 ? _b : rawText['en']) !== null && _c !== void 0 ? _c : Object.values(rawText)[0]) !== null && _d !== void 0 ? _d : '').trim() ||
+                undefined
+            : undefined;
+    let data;
+    if (commandResult.data !== undefined) {
+        if (typeof commandResult.data === 'object' && commandResult.data !== null) {
+            data = commandResult.data;
+        }
+        else {
+            data = { value: commandResult.data };
+        }
+    }
+    const result = buildBackgroundJobSuccessResult(data, message);
+    return result ? { result } : undefined;
+}
+//#endregion
+//# sourceMappingURL=background-job-result.util.js.map

package/background-job/src/lib/background-job-result.util.js.map

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

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

@@ -0,0 +1,81 @@
+export declare const AXP_BACKGROUND_JOB_MODULE = "BackgroundJobManagement";
+export declare const AXP_BACKGROUND_JOB_ENTITY = "BackgroundJobManagement.BackgroundJob";
+export declare const AXP_BACKGROUND_JOB_ATTEMPT_ENTITY = "BackgroundJobManagement.BackgroundJobAttempt";
+export declare const AXP_BACKGROUND_JOB_SCHEDULE_ENTITY = "BackgroundJobManagement.BackgroundJobSchedule";
+/** Default lifecycle status for new schedules. */
+export declare const AXP_BACKGROUND_JOB_SCHEDULE_STATUS_ACTIVE: "active";
+/** Registered client status provider key for job schedules. */
+export declare const AXP_BACKGROUND_JOB_SCHEDULE_STATUS_DEFINITION_KEY = "background-job-management.status.background-job-schedule";
+/** Default lifecycle status for new logical jobs. */
+export declare const AXP_BACKGROUND_JOB_STATUS_CREATED: "created";
+/** Registered client status provider key for logical background jobs. */
+export declare const AXP_BACKGROUND_JOB_STATUS_DEFINITION_KEY = "background-job-management.status.background-job";
+/** Error message / abort reason used when a cooperative handler stops on cancellation. */
+export declare const AXP_BACKGROUND_JOB_CANCELLATION_REQUESTED = "cancellation-requested";
+/** Applied to new schedules when no failure policy is supplied. */
+export declare const AXP_BACKGROUND_JOB_SCHEDULE_DEFAULT_FAILURE_POLICY: {
+    consecutiveFailureThreshold: number;
+    onThresholdExceeded: "pause";
+    resetAfterSuccess: boolean;
+};
+/** BullMQ queue name — separate from the workflow queue. */
+export declare const AXP_BACKGROUND_JOBS_QUEUE = "background-jobs";
+/** BullMQ job name for attempt execution. */
+export declare const AXP_BACKGROUND_JOB_EXECUTE = "background-job.execute";
+/** Only one node runs the schedule scanner. */
+export declare const AXP_BACKGROUND_JOB_SCHEDULER_LEADER_LOCK = "bg-job:scheduler:leader";
+/** Prevents duplicate creation of the same scheduled occurrence (short-lived). */
+export declare function backgroundJobScheduleFireLockKey(scheduleId: string, scheduledOccurrence: string): string;
+/** Prevents concurrent execution of the same business operation. */
+export declare function backgroundJobRunLockKey(idempotencyKey: string): string;
+export declare const AXPBackgroundJobCommandKeys: {
+    readonly JobCreate: "BackgroundJobManagement:Job:Create";
+    readonly JobCancel: "BackgroundJobManagement:Job:Cancel";
+    readonly JobPause: "BackgroundJobManagement:Job:Pause";
+    readonly JobResume: "BackgroundJobManagement:Job:Resume";
+    readonly JobRetry: "BackgroundJobManagement:Job:Retry";
+    readonly JobDelete: "BackgroundJobManagement:Job:Delete";
+    readonly JobReplayDeadLetter: "BackgroundJobManagement:Job:ReplayDeadLetter";
+    readonly ScheduleUpsert: "BackgroundJobManagement:Schedule:Upsert";
+    readonly ScheduleEnable: "BackgroundJobManagement:Schedule:Enable";
+    readonly ScheduleDisable: "BackgroundJobManagement:Schedule:Disable";
+    readonly ScheduleRunNow: "BackgroundJobManagement:Schedule:RunNow";
+    readonly ScheduleDelete: "BackgroundJobManagement:Schedule:Delete";
+};
+export declare const AXPBackgroundJobQueryKeys: {
+    readonly JobGetOne: "BackgroundJobManagement:Job:GetOne";
+    readonly JobList: "BackgroundJobManagement:Job:List";
+    readonly JobListActive: "BackgroundJobManagement:Job:ListActive";
+    readonly JobListDeadLetter: "BackgroundJobManagement:Job:ListDeadLetter";
+    readonly AttemptGetOne: "BackgroundJobManagement:Attempt:GetOne";
+    readonly AttemptListByJob: "BackgroundJobManagement:Attempt:ListByJob";
+    readonly ScheduleGetOne: "BackgroundJobManagement:Schedule:GetOne";
+    readonly ScheduleList: "BackgroundJobManagement:Schedule:List";
+    readonly ScheduleGetByScope: "BackgroundJobManagement:Schedule:GetByScope";
+};
+/** Server command keys invoked by the background-job engine or server API. */
+export declare const AXPBackgroundJobServerCommands: {
+    readonly Create: "background-job.create";
+    readonly Cancel: "background-job.cancel";
+    readonly Pause: "background-job.pause";
+    readonly Resume: "background-job.resume";
+    readonly Retry: "background-job.retry";
+    readonly Delete: "background-job.delete";
+    readonly ReplayDeadLetter: "background-job.replay-dead-letter";
+    readonly ScheduleUpsert: "background-job.schedule.upsert";
+    readonly ScheduleEnable: "background-job.schedule.enable";
+    readonly ScheduleDisable: "background-job.schedule.disable";
+    readonly ScheduleRunNow: "background-job.schedule.run-now";
+    readonly ScheduleDelete: "background-job.schedule.delete";
+    readonly RetentionPurge: "background-job.retention.purge";
+};
+/** Leader lock for the retention trigger loop (creates purge jobs). */
+export declare const AXP_BACKGROUND_JOB_RETENTION_LEADER_LOCK = "bg-job:retention:leader";
+/**
+ * Platform-scope tenant used for system schedules and purge jobs.
+ * Matches the platform tenant seeded in tenant-management.
+ */
+export declare const AXP_BACKGROUND_JOB_PLATFORM_TENANT_ID = "f0000002-0000-4000-a000-000000000001";
+/** Stable scope key for the global retention purge schedule. */
+export declare const AXP_BACKGROUND_JOB_RETENTION_SCHEDULE_COMMAND_KEY = "background-job.retention.purge";
+//# sourceMappingURL=background-job.constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"background-job.constants.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/shared/background-job/src/lib/background-job.constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AAEnE,eAAO,MAAM,yBAAyB,0CAA0C,CAAC;AAEjF,eAAO,MAAM,iCAAiC,iDAAiD,CAAC;AAEhG,eAAO,MAAM,kCAAkC,kDAAkD,CAAC;AAElG,kDAAkD;AAClD,eAAO,MAAM,yCAAyC,EAAG,QAAiB,CAAC;AAE3E,+DAA+D;AAC/D,eAAO,MAAM,iDAAiD,6DACF,CAAC;AAE7D,qDAAqD;AACrD,eAAO,MAAM,iCAAiC,EAAG,SAAkB,CAAC;AAEpE,yEAAyE;AACzE,eAAO,MAAM,wCAAwC,oDACF,CAAC;AAEpD,0FAA0F;AAC1F,eAAO,MAAM,yCAAyC,2BAA2B,CAAC;AAElF,mEAAmE;AACnE,eAAO,MAAM,kDAAkD;;;;CAI9D,CAAC;AAMF,4DAA4D;AAC5D,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAE3D,6CAA6C;AAC7C,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AAMnE,+CAA+C;AAC/C,eAAO,MAAM,wCAAwC,4BAA4B,CAAC;AAElF,kFAAkF;AAClF,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAER;AAED,oEAAoE;AACpE,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEtE;AAMD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;CAa9B,CAAC;AAEX,eAAO,MAAM,yBAAyB;;;;;;;;;;CAU5B,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;CAcjC,CAAC;AAEX,uEAAuE;AACvE,eAAO,MAAM,wCAAwC,4BAA4B,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,qCAAqC,yCAAyC,CAAC;AAE5F,gEAAgE;AAChE,eAAO,MAAM,iDAAiD,mCAAmC,CAAC"}

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

@@ -0,0 +1,98 @@
+"use strict";
+//#region ---- Entity module keys ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXP_BACKGROUND_JOB_RETENTION_SCHEDULE_COMMAND_KEY = exports.AXP_BACKGROUND_JOB_PLATFORM_TENANT_ID = exports.AXP_BACKGROUND_JOB_RETENTION_LEADER_LOCK = exports.AXPBackgroundJobServerCommands = exports.AXPBackgroundJobQueryKeys = exports.AXPBackgroundJobCommandKeys = exports.AXP_BACKGROUND_JOB_SCHEDULER_LEADER_LOCK = exports.AXP_BACKGROUND_JOB_EXECUTE = exports.AXP_BACKGROUND_JOBS_QUEUE = exports.AXP_BACKGROUND_JOB_SCHEDULE_DEFAULT_FAILURE_POLICY = exports.AXP_BACKGROUND_JOB_CANCELLATION_REQUESTED = exports.AXP_BACKGROUND_JOB_STATUS_DEFINITION_KEY = exports.AXP_BACKGROUND_JOB_STATUS_CREATED = exports.AXP_BACKGROUND_JOB_SCHEDULE_STATUS_DEFINITION_KEY = exports.AXP_BACKGROUND_JOB_SCHEDULE_STATUS_ACTIVE = exports.AXP_BACKGROUND_JOB_SCHEDULE_ENTITY = exports.AXP_BACKGROUND_JOB_ATTEMPT_ENTITY = exports.AXP_BACKGROUND_JOB_ENTITY = exports.AXP_BACKGROUND_JOB_MODULE = void 0;
+exports.backgroundJobScheduleFireLockKey = backgroundJobScheduleFireLockKey;
+exports.backgroundJobRunLockKey = backgroundJobRunLockKey;
+exports.AXP_BACKGROUND_JOB_MODULE = 'BackgroundJobManagement';
+exports.AXP_BACKGROUND_JOB_ENTITY = 'BackgroundJobManagement.BackgroundJob';
+exports.AXP_BACKGROUND_JOB_ATTEMPT_ENTITY = 'BackgroundJobManagement.BackgroundJobAttempt';
+exports.AXP_BACKGROUND_JOB_SCHEDULE_ENTITY = 'BackgroundJobManagement.BackgroundJobSchedule';
+/** Default lifecycle status for new schedules. */
+exports.AXP_BACKGROUND_JOB_SCHEDULE_STATUS_ACTIVE = 'active';
+/** Registered client status provider key for job schedules. */
+exports.AXP_BACKGROUND_JOB_SCHEDULE_STATUS_DEFINITION_KEY = 'background-job-management.status.background-job-schedule';
+/** Default lifecycle status for new logical jobs. */
+exports.AXP_BACKGROUND_JOB_STATUS_CREATED = 'created';
+/** Registered client status provider key for logical background jobs. */
+exports.AXP_BACKGROUND_JOB_STATUS_DEFINITION_KEY = 'background-job-management.status.background-job';
+/** Error message / abort reason used when a cooperative handler stops on cancellation. */
+exports.AXP_BACKGROUND_JOB_CANCELLATION_REQUESTED = 'cancellation-requested';
+/** Applied to new schedules when no failure policy is supplied. */
+exports.AXP_BACKGROUND_JOB_SCHEDULE_DEFAULT_FAILURE_POLICY = {
+    consecutiveFailureThreshold: 5,
+    onThresholdExceeded: 'pause',
+    resetAfterSuccess: true,
+};
+//#endregion
+//#region ---- Queue constants ----
+/** BullMQ queue name — separate from the workflow queue. */
+exports.AXP_BACKGROUND_JOBS_QUEUE = 'background-jobs';
+/** BullMQ job name for attempt execution. */
+exports.AXP_BACKGROUND_JOB_EXECUTE = 'background-job.execute';
+//#endregion
+//#region ---- Distributed lock key builders ----
+/** Only one node runs the schedule scanner. */
+exports.AXP_BACKGROUND_JOB_SCHEDULER_LEADER_LOCK = 'bg-job:scheduler:leader';
+/** Prevents duplicate creation of the same scheduled occurrence (short-lived). */
+function backgroundJobScheduleFireLockKey(scheduleId, scheduledOccurrence) {
+    return `bg-job:schedule-fire:${scheduleId}:${scheduledOccurrence}`;
+}
+/** Prevents concurrent execution of the same business operation. */
+function backgroundJobRunLockKey(idempotencyKey) {
+    return `bg-job:run:${idempotencyKey}`;
+}
+//#endregion
+//#region ---- Client / gateway command and query keys ----
+exports.AXPBackgroundJobCommandKeys = {
+    JobCreate: 'BackgroundJobManagement:Job:Create',
+    JobCancel: 'BackgroundJobManagement:Job:Cancel',
+    JobPause: 'BackgroundJobManagement:Job:Pause',
+    JobResume: 'BackgroundJobManagement:Job:Resume',
+    JobRetry: 'BackgroundJobManagement:Job:Retry',
+    JobDelete: 'BackgroundJobManagement:Job:Delete',
+    JobReplayDeadLetter: 'BackgroundJobManagement:Job:ReplayDeadLetter',
+    ScheduleUpsert: 'BackgroundJobManagement:Schedule:Upsert',
+    ScheduleEnable: 'BackgroundJobManagement:Schedule:Enable',
+    ScheduleDisable: 'BackgroundJobManagement:Schedule:Disable',
+    ScheduleRunNow: 'BackgroundJobManagement:Schedule:RunNow',
+    ScheduleDelete: 'BackgroundJobManagement:Schedule:Delete',
+};
+exports.AXPBackgroundJobQueryKeys = {
+    JobGetOne: 'BackgroundJobManagement:Job:GetOne',
+    JobList: 'BackgroundJobManagement:Job:List',
+    JobListActive: 'BackgroundJobManagement:Job:ListActive',
+    JobListDeadLetter: 'BackgroundJobManagement:Job:ListDeadLetter',
+    AttemptGetOne: 'BackgroundJobManagement:Attempt:GetOne',
+    AttemptListByJob: 'BackgroundJobManagement:Attempt:ListByJob',
+    ScheduleGetOne: 'BackgroundJobManagement:Schedule:GetOne',
+    ScheduleList: 'BackgroundJobManagement:Schedule:List',
+    ScheduleGetByScope: 'BackgroundJobManagement:Schedule:GetByScope',
+};
+/** Server command keys invoked by the background-job engine or server API. */
+exports.AXPBackgroundJobServerCommands = {
+    Create: 'background-job.create',
+    Cancel: 'background-job.cancel',
+    Pause: 'background-job.pause',
+    Resume: 'background-job.resume',
+    Retry: 'background-job.retry',
+    Delete: 'background-job.delete',
+    ReplayDeadLetter: 'background-job.replay-dead-letter',
+    ScheduleUpsert: 'background-job.schedule.upsert',
+    ScheduleEnable: 'background-job.schedule.enable',
+    ScheduleDisable: 'background-job.schedule.disable',
+    ScheduleRunNow: 'background-job.schedule.run-now',
+    ScheduleDelete: 'background-job.schedule.delete',
+    RetentionPurge: 'background-job.retention.purge',
+};
+/** Leader lock for the retention trigger loop (creates purge jobs). */
+exports.AXP_BACKGROUND_JOB_RETENTION_LEADER_LOCK = 'bg-job:retention:leader';
+/**
+ * Platform-scope tenant used for system schedules and purge jobs.
+ * Matches the platform tenant seeded in tenant-management.
+ */
+exports.AXP_BACKGROUND_JOB_PLATFORM_TENANT_ID = 'f0000002-0000-4000-a000-000000000001';
+/** Stable scope key for the global retention purge schedule. */
+exports.AXP_BACKGROUND_JOB_RETENTION_SCHEDULE_COMMAND_KEY = 'background-job.retention.purge';
+//#endregion
+//# sourceMappingURL=background-job.constants.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * Stable background job lifecycle error codes for client i18n mapping.
+ */
+export declare const AXP_BACKGROUND_JOB_ERROR_CODES: {
+    readonly NOT_FOUND: "BACKGROUND_JOB_NOT_FOUND";
+    readonly RETRY_INVALID_STATUS: "BACKGROUND_JOB_RETRY_INVALID_STATUS";
+    readonly NOT_DEAD_LETTERED: "BACKGROUND_JOB_NOT_DEAD_LETTERED";
+};
+export type AXPBackgroundJobErrorCode = (typeof AXP_BACKGROUND_JOB_ERROR_CODES)[keyof typeof AXP_BACKGROUND_JOB_ERROR_CODES];
+export interface AXPBackgroundJobApiErrorPayload {
+    code: AXPBackgroundJobErrorCode;
+    jobId?: string;
+    status?: string;
+    scheduleId?: string;
+}
+//# 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/shared/background-job/src/lib/background-job.errors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;CAIjC,CAAC;AAEX,MAAM,MAAM,yBAAyB,GACnC,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,OAAO,8BAA8B,CAAC,CAAC;AAMvF,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,yBAAyB,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

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

@@ -0,0 +1,14 @@
+"use strict";
+//#region ---- Error codes ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXP_BACKGROUND_JOB_ERROR_CODES = void 0;
+/**
+ * Stable background job lifecycle error codes for client i18n mapping.
+ */
+exports.AXP_BACKGROUND_JOB_ERROR_CODES = {
+    NOT_FOUND: 'BACKGROUND_JOB_NOT_FOUND',
+    RETRY_INVALID_STATUS: 'BACKGROUND_JOB_RETRY_INVALID_STATUS',
+    NOT_DEAD_LETTERED: 'BACKGROUND_JOB_NOT_DEAD_LETTERED',
+};
+//#endregion
+//# 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/shared/background-job/src/lib/background-job.errors.ts"],"names":[],"mappings":";AAAA,+BAA+B;;;AAE/B;;GAEG;AACU,QAAA,8BAA8B,GAAG;IAC5C,SAAS,EAAE,0BAA0B;IACrC,oBAAoB,EAAE,qCAAqC;IAC3D,iBAAiB,EAAE,kCAAkC;CAC7C,CAAC;AAgBX,YAAY"}

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

@@ -0,0 +1,268 @@
+/**
+ * Aggregate status of a durable logical job (`BackgroundJob`).
+ * `paused` applies only when cooperative pause is explicitly enabled.
+ */
+export type AXPBackgroundJobStatus = 'created' | 'scheduled' | 'queued' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled' | 'dead-lettered';
+/** How the logical job was created. Retry is NOT a logical job trigger. */
+export type AXPBackgroundJobTrigger = 'schedule' | 'manual' | 'event' | 'system';
+/** Terminal + runtime status of a single execution attempt. */
+export type AXPBackgroundJobAttemptStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'timed-out' | 'abandoned';
+/** Why this attempt exists under its logical job. */
+export type AXPBackgroundJobAttemptTrigger = 'initial' | 'automatic-retry' | 'manual-retry' | 'dead-letter-replay';
+/** Who sees the job in the client tray. */
+export type AXPBackgroundJobVisibility = 'initiator' | 'tenant-admin' | 'silent';
+export declare const AXP_BACKGROUND_JOB_TERMINAL_STATUSES: readonly AXPBackgroundJobStatus[];
+export declare const AXP_BACKGROUND_JOB_ATTEMPT_TERMINAL_STATUSES: readonly AXPBackgroundJobAttemptStatus[];
+export declare function isBackgroundJobTerminal(status: AXPBackgroundJobStatus): boolean;
+export declare function isBackgroundJobAttemptTerminal(status: AXPBackgroundJobAttemptStatus): boolean;
+export interface AXPBackgroundJobError {
+    code?: string;
+    message: string;
+    detail?: string;
+    retryable?: boolean;
+}
+export interface AXPBackgroundJobCapabilities {
+    canCancelQueued?: boolean;
+    supportsCooperativeCancellation?: boolean;
+    supportsCooperativePause?: boolean;
+    supportsProgress?: boolean;
+    supportsEstimate?: boolean;
+    clickable?: boolean;
+    notifyOnComplete?: boolean;
+    notifyOnFailed?: boolean;
+}
+export type AXPBackgroundJobBackoffKind = 'fixed' | 'exponential';
+export type AXPBackgroundJobExhaustedAction = 'fail' | 'dead-letter';
+export type AXPBackgroundJobTimeoutPolicy = 'retry' | 'fail' | 'dead-letter';
+/**
+ * Controls execution attempts for ONE logical job.
+ * Distinct from `AXPBackgroundJobScheduleFailurePolicy` (schedule reaction to repeated job failures).
+ */
+export interface AXPBackgroundJobRetryPolicy {
+    /** Includes the initial execution (maxAttempts = 3 → initial + 2 retries). */
+    maxAttempts: number;
+    backoff?: AXPBackgroundJobBackoffKind;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    retryableErrorCodes?: string[];
+    nonRetryableErrorCodes?: string[];
+    onExhausted?: AXPBackgroundJobExhaustedAction;
+    timeoutPolicy?: AXPBackgroundJobTimeoutPolicy;
+}
+/** Error code assigned to attempts aborted by the per-attempt timeout controller. */
+export declare const AXP_BACKGROUND_JOB_TIMEOUT_ERROR_CODE = "BACKGROUND_JOB_TIMEOUT";
+export declare const AXP_BACKGROUND_JOB_DEFAULT_RETRY_POLICY: AXPBackgroundJobRetryPolicy;
+export type AXPBackgroundJobScheduleSource = 'system' | 'integration' | 'user';
+export type AXPBackgroundJobScheduleConcurrencyPolicy = 'skip-if-running' | 'queue';
+export type AXPBackgroundJobScheduleMissedRunPolicy = 'skip' | 'catch-up-one';
+export type AXPBackgroundJobScheduleStatus = 'active' | 'pause' | 'disabled';
+export type AXPBackgroundJobScheduleThresholdAction = 'disable' | 'alert-only' | 'pause';
+/**
+ * Controls how a SCHEDULE reacts to repeated job failures.
+ * Not a job retry policy — see `AXPBackgroundJobRetryPolicy`.
+ */
+export interface AXPBackgroundJobScheduleFailurePolicy {
+    consecutiveFailureThreshold?: number;
+    onThresholdExceeded?: AXPBackgroundJobScheduleThresholdAction;
+    resetAfterSuccess?: boolean;
+    alertRecipients?: string[];
+    cooldownMs?: number;
+}
+/** Structured outcome stored on a logical job when an attempt finishes. */
+export interface AXPBackgroundJobResult {
+    /** Small structured payload (counts, ids, flags). */
+    data?: Record<string, unknown>;
+    /** Human-readable outcome — success summary or failure message. */
+    message?: string;
+    /** Optional stack trace for failures (truncated by the engine). */
+    stack?: string;
+}
+import type { AXPMultiLanguageString } from '@acorex-platform/framework-shared/core';
+import type { AXPEntityModel, AXPRecordStateInfo } from '@acorex-platform/framework-shared/entity';
+/**
+ * Durable logical job — the business request and aggregate status across all attempts.
+ * Runtime execution data lives on `AXPBackgroundJobAttempt`.
+ */
+export interface AXPBackgroundJob extends AXPEntityModel<string> {
+    command: AXPBackgroundJobScheduleCommand;
+    providerKey: string;
+    scheduleId?: string;
+    /** Exact intended scheduled occurrence (UTC-normalized ISO string); schedule-created jobs only. */
+    scheduledOccurrence?: string;
+    trigger: AXPBackgroundJobTrigger;
+    tenantId: string;
+    userId?: string;
+    applicationId?: string;
+    title: string;
+    status: AXPBackgroundJobStatus;
+    progress?: number;
+    statusText?: string;
+    currentStep?: string;
+    payloadReference?: string;
+    /** Outcome envelope — `{ data?, message?, stack? }`; see `AXPBackgroundJobResult`. */
+    result?: AXPBackgroundJobResult;
+    resultReference?: string;
+    capabilities: AXPBackgroundJobCapabilities;
+    retryPolicy: AXPBackgroundJobRetryPolicy;
+    /** Per-attempt timeout enforced by the engine. */
+    executionTimeoutMs?: number;
+    /** Aggregate pointer; 0 before first attempt. */
+    currentAttempt: number;
+    /** From policy; includes initial execution. */
+    maxAttempts: number;
+    idempotencyKey?: string;
+    priority?: number;
+    visibility: AXPBackgroundJobVisibility;
+    correlationId?: string;
+    /** Technical fan-out / bulk execution only — not orchestration. */
+    parentJobId?: string;
+    /** Set when created via ReplayDeadLetter. */
+    replayedFromJobId?: string;
+    cancellationRequestedAt?: string;
+    cancelledAt?: string;
+    cancellationReason?: string;
+    cancelledBy?: string;
+    createdAt: string;
+    queuedAt?: string;
+    firstStartedAt?: string;
+    /** When the job first started executing (same as firstStartedAt once running). */
+    executedAt?: string;
+    completedAt?: string;
+    totalDurationMs?: number;
+}
+/**
+ * One execution attempt under a logical job.
+ * Created and updated internally by the execution engine — no public CRUD.
+ */
+export interface AXPBackgroundJobAttempt {
+    id: string;
+    jobId: string;
+    /** 1-based. */
+    attemptNumber: number;
+    trigger: AXPBackgroundJobAttemptTrigger;
+    status: AXPBackgroundJobAttemptStatus;
+    workerId?: string;
+    queueJobId?: string;
+    traceId?: string;
+    spanId?: string;
+    startedAt?: string;
+    heartbeatAt?: string;
+    completedAt?: string;
+    durationMs?: number;
+    error?: AXPBackgroundJobError;
+    createdAt: string;
+}
+/** Command bound to a background job schedule. */
+export interface AXPBackgroundJobScheduleCommand {
+    key: string;
+    title?: string;
+    payload: Record<string, unknown>;
+}
+/** Recurrence rule that creates job instances over time. */
+export interface AXPBackgroundJobSchedule extends AXPEntityModel<string> {
+    command: AXPBackgroundJobScheduleCommand;
+    providerKey: string;
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
+    connectionId?: string;
+    /** IANA timezone code (e.g. `UTC`, `Asia/Tehran`). */
+    timezone?: string;
+    cron: string;
+    /** Lifecycle status — only `active` schedules are fired by the scanner. */
+    status: AXPBackgroundJobScheduleStatus;
+    source: AXPBackgroundJobScheduleSource;
+    priority?: number;
+    /** Copied to jobs created by this schedule. */
+    defaultVisibility: AXPBackgroundJobVisibility;
+    concurrencyPolicy: AXPBackgroundJobScheduleConcurrencyPolicy;
+    missedRunPolicy: AXPBackgroundJobScheduleMissedRunPolicy;
+    /** e.g. `simpro:pull:{tenantId}:{connectionId}` */
+    idempotencyKeyTemplate?: string;
+    failurePolicy?: AXPBackgroundJobScheduleFailurePolicy;
+    /** Copied to jobs created by this schedule. */
+    jobCapabilities?: AXPBackgroundJobCapabilities;
+    nextRunAt?: string;
+    lastTriggeredAt?: string;
+    lastSuccessAt?: string;
+    lastFailureAt?: string;
+    consecutiveFailures: number;
+}
+/** Resolves the server command key for a persisted job row. */
+export declare function resolveBackgroundJobCommandKey(entity: Pick<AXPBackgroundJob, 'command'>): string;
+/** Resolves the command payload for a persisted job row. */
+export declare function resolveBackgroundJobCommandPayload(entity: Pick<AXPBackgroundJob, 'command'>): Record<string, unknown>;
+/** Resolves the command key from a schedule row. */
+export declare function resolveScheduleCommandKey(schedule: Pick<AXPBackgroundJobSchedule, 'command'>): string;
+/** Resolves the command payload from a schedule row. */
+export declare function resolveScheduleCommandPayload(schedule: Pick<AXPBackgroundJobSchedule, 'command'>): Record<string, unknown>;
+/** Resolves tenant scope from a schedule row. */
+export declare function resolveScheduleTenantId(schedule: Pick<AXPBackgroundJobSchedule, 'ownershipInfo'>): string;
+/** Resolves application scope from a schedule row. */
+export declare function resolveScheduleApplicationId(schedule: Pick<AXPBackgroundJobSchedule, 'ownershipInfo'>): string | undefined;
+/** Resolves the IANA timezone code used by the schedule scanner. */
+export declare function resolveScheduleTimezoneCode(schedule: {
+    timezone?: string | {
+        code?: string;
+    } | null;
+}): string;
+/** Resolves schedule status, including legacy rows that only stored `isDisabled`. */
+export declare function resolveScheduleStatus(schedule: Partial<Pick<AXPBackgroundJobSchedule, 'status'>> & {
+    isDisabled?: boolean;
+}): AXPBackgroundJobScheduleStatus;
+/** Whether the schedule scanner should fire this row. */
+export declare function isScheduleActive(schedule: Partial<Pick<AXPBackgroundJobSchedule, 'status'>> & {
+    isDisabled?: boolean;
+}): boolean;
+/** Resolves a plain string job title from a schedule row. */
+export declare function resolveScheduleTitle(schedule: Pick<AXPBackgroundJobSchedule, 'title' | 'command'>): string;
+/** Derives tray/provider grouping from a server command key. */
+export declare function deriveBackgroundJobProviderKey(commandKey: string): string;
+/** Runtime class so Nest/webpack can resolve `@Body()` decorator metadata. */
+export declare class AXPCreateBackgroundJobRequest {
+    command?: AXPBackgroundJobScheduleCommand;
+    title?: string;
+    providerKey?: string;
+    trigger?: AXPBackgroundJobTrigger;
+    tenantId?: string;
+    userId?: string;
+    applicationId?: string;
+    idempotencyKey?: string;
+    visibility?: AXPBackgroundJobVisibility;
+    priority?: number;
+    executionTimeoutMs?: number;
+    capabilities?: AXPBackgroundJobCapabilities;
+    retryPolicy?: Partial<AXPBackgroundJobRetryPolicy>;
+    correlationId?: string;
+    parentJobId?: string;
+    scheduleId?: string;
+    scheduledOccurrence?: string;
+    payloadReference?: string;
+    stateInfo?: AXPRecordStateInfo;
+}
+export interface AXPCreateBackgroundJobResult {
+    jobId: string;
+    job: AXPBackgroundJob;
+    /** True when an existing non-terminal job with the same idempotency key was returned instead. */
+    deduplicated?: boolean;
+}
+export type AXPBackgroundJobCancellationStatus = 'cancellation-requested' | 'cancelled';
+export interface AXPCancelBackgroundJobResult {
+    success: boolean;
+    status: AXPBackgroundJobCancellationStatus;
+}
+/** True when a handler aborted because the job was cancelled cooperatively. */
+export declare function isBackgroundJobCancellationMessage(message: string | undefined): boolean;
+/** True when a handler aborted because the job was cancelled cooperatively. */
+export declare function isBackgroundJobCancellationError(error: unknown): boolean;
+export interface AXPRetryBackgroundJobResult {
+    jobId: string;
+    attemptId: string;
+    attemptNumber: number;
+}
+/** Returned by a job handler on success; stored on the job per payload/result size rules. */
+export interface AXPBackgroundJobHandlerResult {
+    result?: AXPBackgroundJobResult;
+    /** Pointer to large output (file, blob store). */
+    resultReference?: string;
+}
+//# sourceMappingURL=background-job.types.d.ts.map

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

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