@rytass/bpm-core-nestjs-module 0.22.0 → 0.23.0

package/src/lib/instance-event/instance-event.delivery.subscriber.js

@@ -0,0 +1,85 @@
+"use strict";
+var InstanceEventDeliverySubscriber_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceEventDeliverySubscriber = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const typeorm_2 = require("typeorm");
+const approval_instance_event_entity_1 = require("./approval-instance-event.entity");
+const instance_event_delivery_service_1 = require("./instance-event.delivery.service");
+/**
+ * Starts delivery of a lifecycle event the moment the transaction that wrote
+ * it commits (ADR 27 §1.3), without every engine entry point having to
+ * remember to.
+ *
+ * Inserted ids are held per query runner and released on commit; a rollback
+ * drops them, so an event whose state change was rolled back is never
+ * delivered. The kick is best effort and never awaited: the scheduler
+ * releases anything it misses.
+ */
+let InstanceEventDeliverySubscriber = InstanceEventDeliverySubscriber_1 = class InstanceEventDeliverySubscriber {
+    constructor(dataSource, deliveryService) {
+        this.deliveryService = deliveryService;
+        this.logger = new common_1.Logger(InstanceEventDeliverySubscriber_1.name);
+        this.pending = new WeakMap();
+        // The documented way to register a Nest-managed subscriber; guarded so a
+        // stand-in data source in tests does not break the module graph.
+        if (Array.isArray(dataSource?.subscribers)) {
+            dataSource.subscribers.push(this);
+        }
+    }
+    listenTo() {
+        return approval_instance_event_entity_1.ApprovalInstanceEventEntity;
+    }
+    afterInsert(event) {
+        const row = event.entity;
+        if (!row?.id || row.status !== 'PENDING') {
+            return;
+        }
+        if (!event.queryRunner?.isTransactionActive) {
+            this.kick([row.id]);
+            return;
+        }
+        const queued = this.pending.get(event.queryRunner) ?? [];
+        this.pending.set(event.queryRunner, [...queued, row.id]);
+    }
+    afterTransactionCommit(event) {
+        // Releasing a savepoint broadcasts the same event while the outer
+        // transaction is still open and its rows still invisible. Wait for the
+        // real COMMIT, after which TypeORM has cleared `isTransactionActive`.
+        if (event.queryRunner.isTransactionActive) {
+            return;
+        }
+        const ids = this.pending.get(event.queryRunner) ?? [];
+        this.pending.delete(event.queryRunner);
+        if (ids.length > 0) {
+            this.kick(ids);
+        }
+    }
+    afterTransactionRollback(event) {
+        // Rolling back to a savepoint leaves the outer transaction, and the rows
+        // it queued outside that savepoint, intact.
+        if (event.queryRunner.isTransactionActive) {
+            return;
+        }
+        this.pending.delete(event.queryRunner);
+    }
+    kick(ids) {
+        setImmediate(() => {
+            this.deliveryService
+                .deliverByIds([...new Set(ids)])
+                .catch((error) => {
+                this.logger.warn(`Immediate instance event delivery failed; the scheduler will retry: ${error instanceof Error ? error.message : String(error)}`);
+            });
+        });
+    }
+};
+exports.InstanceEventDeliverySubscriber = InstanceEventDeliverySubscriber;
+exports.InstanceEventDeliverySubscriber = InstanceEventDeliverySubscriber = InstanceEventDeliverySubscriber_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, typeorm_1.InjectDataSource)()),
+    tslib_1.__metadata("design:paramtypes", [typeorm_2.DataSource,
+        instance_event_delivery_service_1.InstanceEventDeliveryService])
+], InstanceEventDeliverySubscriber);
+//# sourceMappingURL=instance-event.delivery.subscriber.js.map

package/src/lib/instance-event/instance-event.delivery.subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-event.delivery.subscriber.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/instance-event/instance-event.delivery.subscriber.ts"],"names":[],"mappings":"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"}

package/src/lib/instance-event/instance-event.enums.d.ts

@@ -0,0 +1,12 @@
+import type { BPMInstanceEventStatus } from './instance-event.types';
+/**
+ * GraphQL view of the outbox status. Values match `BPMInstanceEventStatus`
+ * one to one; the two maps below keep that pairing checked by the compiler.
+ */
+export declare enum ApprovalInstanceEventStatusEnum {
+    DELIVERED = "DELIVERED",
+    FAILED = "FAILED",
+    PENDING = "PENDING"
+}
+export declare const APPROVAL_INSTANCE_EVENT_STATUS_TO_ENUM: Readonly<Record<BPMInstanceEventStatus, ApprovalInstanceEventStatusEnum>>;
+export declare const APPROVAL_INSTANCE_EVENT_ENUM_TO_STATUS: Readonly<Record<ApprovalInstanceEventStatusEnum, BPMInstanceEventStatus>>;

package/src/lib/instance-event/instance-event.enums.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APPROVAL_INSTANCE_EVENT_ENUM_TO_STATUS = exports.APPROVAL_INSTANCE_EVENT_STATUS_TO_ENUM = exports.ApprovalInstanceEventStatusEnum = void 0;
+const graphql_1 = require("@nestjs/graphql");
+/**
+ * GraphQL view of the outbox status. Values match `BPMInstanceEventStatus`
+ * one to one; the two maps below keep that pairing checked by the compiler.
+ */
+var ApprovalInstanceEventStatusEnum;
+(function (ApprovalInstanceEventStatusEnum) {
+    ApprovalInstanceEventStatusEnum["DELIVERED"] = "DELIVERED";
+    ApprovalInstanceEventStatusEnum["FAILED"] = "FAILED";
+    ApprovalInstanceEventStatusEnum["PENDING"] = "PENDING";
+})(ApprovalInstanceEventStatusEnum || (exports.ApprovalInstanceEventStatusEnum = ApprovalInstanceEventStatusEnum = {}));
+(0, graphql_1.registerEnumType)(ApprovalInstanceEventStatusEnum, {
+    name: 'BPMApprovalInstanceEventStatus',
+});
+exports.APPROVAL_INSTANCE_EVENT_STATUS_TO_ENUM = {
+    DELIVERED: ApprovalInstanceEventStatusEnum.DELIVERED,
+    FAILED: ApprovalInstanceEventStatusEnum.FAILED,
+    PENDING: ApprovalInstanceEventStatusEnum.PENDING,
+};
+exports.APPROVAL_INSTANCE_EVENT_ENUM_TO_STATUS = {
+    [ApprovalInstanceEventStatusEnum.DELIVERED]: 'DELIVERED',
+    [ApprovalInstanceEventStatusEnum.FAILED]: 'FAILED',
+    [ApprovalInstanceEventStatusEnum.PENDING]: 'PENDING',
+};
+//# sourceMappingURL=instance-event.enums.js.map

package/src/lib/instance-event/instance-event.enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-event.enums.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/instance-event/instance-event.enums.ts"],"names":[],"mappings":";;;AAAA,6CAAmD;AAGnD;;;GAGG;AACH,IAAY,+BAIX;AAJD,WAAY,+BAA+B;IACzC,0DAAuB,CAAA;IACvB,oDAAiB,CAAA;IACjB,sDAAmB,CAAA;AACrB,CAAC,EAJW,+BAA+B,+CAA/B,+BAA+B,QAI1C;AAED,IAAA,0BAAgB,EAAC,+BAA+B,EAAE;IAChD,IAAI,EAAE,gCAAgC;CACvC,CAAC,CAAC;AAEU,QAAA,sCAAsC,GAE/C;IACF,SAAS,EAAE,+BAA+B,CAAC,SAAS;IACpD,MAAM,EAAE,+BAA+B,CAAC,MAAM;IAC9C,OAAO,EAAE,+BAA+B,CAAC,OAAO;CACjD,CAAC;AAEW,QAAA,sCAAsC,GAE/C;IACF,CAAC,+BAA+B,CAAC,SAAS,CAAC,EAAE,WAAW;IACxD,CAAC,+BAA+B,CAAC,MAAM,CAAC,EAAE,QAAQ;IAClD,CAAC,+BAA+B,CAAC,OAAO,CAAC,EAAE,SAAS;CACrD,CAAC"}

package/src/lib/instance-event/instance-event.module.d.ts

@@ -0,0 +1,13 @@
+import { DynamicModule, ModuleMetadata, Provider } from '@nestjs/common';
+import { BPMInstanceEventObserver } from './instance-event.token';
+export interface InstanceEventModuleOptions extends Pick<ModuleMetadata, 'imports'> {
+    readonly observerProvider?: Provider<BPMInstanceEventObserver>;
+}
+export declare class InstanceEventModule {
+    /**
+     * `BPM_INSTANCE_EVENT_OBSERVER` is exported only when `observerProvider` is
+     * given. Exporting an unprovided token makes Nest fail with
+     * `UnknownExportException`.
+     */
+    static forRoot(options?: InstanceEventModuleOptions): DynamicModule;
+}

package/src/lib/instance-event/instance-event.module.js

@@ -0,0 +1,52 @@
+"use strict";
+var InstanceEventModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceEventModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const approval_instance_event_entity_1 = require("./approval-instance-event.entity");
+const instance_event_delivery_service_1 = require("./instance-event.delivery.service");
+const instance_event_delivery_scheduler_service_1 = require("./instance-event.delivery-scheduler.service");
+const instance_event_delivery_subscriber_1 = require("./instance-event.delivery.subscriber");
+const instance_event_resolver_1 = require("./instance-event.resolver");
+const instance_event_token_1 = require("./instance-event.token");
+const instance_event_service_1 = require("./instance-event.service");
+const instance_event_writer_1 = require("./instance-event.writer");
+let InstanceEventModule = InstanceEventModule_1 = class InstanceEventModule {
+    /**
+     * `BPM_INSTANCE_EVENT_OBSERVER` is exported only when `observerProvider` is
+     * given. Exporting an unprovided token makes Nest fail with
+     * `UnknownExportException`.
+     */
+    static forRoot(options = {}) {
+        const observerProviders = options.observerProvider
+            ? [options.observerProvider]
+            : [];
+        const observerExports = options.observerProvider ? [instance_event_token_1.BPM_INSTANCE_EVENT_OBSERVER] : [];
+        return {
+            exports: [instance_event_service_1.InstanceEventService, instance_event_writer_1.InstanceEventWriter, ...observerExports],
+            global: true,
+            imports: [
+                ...(options.imports ?? []),
+                typeorm_1.TypeOrmModule.forFeature([approval_instance_event_entity_1.ApprovalInstanceEventEntity]),
+            ],
+            module: InstanceEventModule_1,
+            providers: [
+                ...observerProviders,
+                instance_event_service_1.InstanceEventService,
+                instance_event_writer_1.InstanceEventWriter,
+                instance_event_delivery_service_1.InstanceEventDeliveryService,
+                instance_event_delivery_subscriber_1.InstanceEventDeliverySubscriber,
+                instance_event_delivery_scheduler_service_1.InstanceEventDeliverySchedulerService,
+                instance_event_resolver_1.InstanceEventResolver,
+            ],
+        };
+    }
+};
+exports.InstanceEventModule = InstanceEventModule;
+exports.InstanceEventModule = InstanceEventModule = InstanceEventModule_1 = tslib_1.__decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], InstanceEventModule);
+//# sourceMappingURL=instance-event.module.js.map

package/src/lib/instance-event/instance-event.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-event.module.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/instance-event/instance-event.module.ts"],"names":[],"mappings":";;;;;AAAA,2CAMwB;AACxB,6CAAgD;AAChD,qFAA+E;AAC/E,uFAAiF;AACjF,2GAAoG;AACpG,6FAAuF;AACvF,uEAAkE;AAClE,iEAGgC;AAChC,qEAAgE;AAChE,mEAA8D;AAWvD,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAC9B;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,UAAsC,EAAE;QACrD,MAAM,iBAAiB,GAAwB,OAAO,CAAC,gBAAgB;YACrE,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;YAC5B,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,eAAe,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,kDAA2B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEhE,OAAO;YACL,OAAO,EAAE,CAAC,6CAAoB,EAAE,2CAAmB,EAAE,GAAG,eAAe,CAAC;YACxE,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE;gBACP,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC1B,uBAAa,CAAC,UAAU,CAAC,CAAC,4DAA2B,CAAC,CAAC;aACxD;YACD,MAAM,EAAE,qBAAmB;YAC3B,SAAS,EAAE;gBACT,GAAG,iBAAiB;gBACpB,6CAAoB;gBACpB,2CAAmB;gBACnB,8DAA4B;gBAC5B,oEAA+B;gBAC/B,iFAAqC;gBACrC,+CAAqB;aACtB;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AAhCY,kDAAmB;8BAAnB,mBAAmB;IAF/B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,mBAAmB,CAgC/B"}

package/src/lib/instance-event/instance-event.object.d.ts

@@ -0,0 +1,24 @@
+import { ApprovalInstanceEventStatusEnum } from './instance-event.enums';
+/**
+ * An administrator's view of one outbox row (ADR 27 §1). `payload` is left
+ * out on purpose: it is the observer's input and is not needed to triage a
+ * failed delivery. `claimedAt` is an internal lock stamp and is left out too.
+ */
+export declare class ApprovalInstanceEventObject {
+    attemptCount: number;
+    deliveredAt: Date | null;
+    id: string;
+    instanceId: string;
+    lastError: string | null;
+    nextAttemptAt: Date;
+    occurredAt: Date;
+    /** Write order. A string, because the database column is `bigint`. */
+    seq: string;
+    status: ApprovalInstanceEventStatusEnum;
+    type: string;
+}
+/** One page of outbox rows, newest first. */
+export declare class ApprovalInstanceEventPageObject {
+    items: readonly ApprovalInstanceEventObject[];
+    total: number;
+}

package/src/lib/instance-event/instance-event.object.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApprovalInstanceEventPageObject = exports.ApprovalInstanceEventObject = void 0;
+const tslib_1 = require("tslib");
+const graphql_1 = require("@nestjs/graphql");
+const instance_event_enums_1 = require("./instance-event.enums");
+/**
+ * An administrator's view of one outbox row (ADR 27 §1). `payload` is left
+ * out on purpose: it is the observer's input and is not needed to triage a
+ * failed delivery. `claimedAt` is an internal lock stamp and is left out too.
+ */
+let ApprovalInstanceEventObject = class ApprovalInstanceEventObject {
+};
+exports.ApprovalInstanceEventObject = ApprovalInstanceEventObject;
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => graphql_1.Int),
+    tslib_1.__metadata("design:type", Number)
+], ApprovalInstanceEventObject.prototype, "attemptCount", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => Date, { nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], ApprovalInstanceEventObject.prototype, "deliveredAt", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => graphql_1.ID),
+    tslib_1.__metadata("design:type", String)
+], ApprovalInstanceEventObject.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => graphql_1.ID),
+    tslib_1.__metadata("design:type", String)
+], ApprovalInstanceEventObject.prototype, "instanceId", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => String, { nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], ApprovalInstanceEventObject.prototype, "lastError", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => Date),
+    tslib_1.__metadata("design:type", Date)
+], ApprovalInstanceEventObject.prototype, "nextAttemptAt", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => Date),
+    tslib_1.__metadata("design:type", Date)
+], ApprovalInstanceEventObject.prototype, "occurredAt", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => String),
+    tslib_1.__metadata("design:type", String)
+], ApprovalInstanceEventObject.prototype, "seq", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => instance_event_enums_1.ApprovalInstanceEventStatusEnum),
+    tslib_1.__metadata("design:type", String)
+], ApprovalInstanceEventObject.prototype, "status", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => String),
+    tslib_1.__metadata("design:type", String)
+], ApprovalInstanceEventObject.prototype, "type", void 0);
+exports.ApprovalInstanceEventObject = ApprovalInstanceEventObject = tslib_1.__decorate([
+    (0, graphql_1.ObjectType)('BPMApprovalInstanceEvent')
+], ApprovalInstanceEventObject);
+/** One page of outbox rows, newest first. */
+let ApprovalInstanceEventPageObject = class ApprovalInstanceEventPageObject {
+};
+exports.ApprovalInstanceEventPageObject = ApprovalInstanceEventPageObject;
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => [ApprovalInstanceEventObject]),
+    tslib_1.__metadata("design:type", Array)
+], ApprovalInstanceEventPageObject.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => graphql_1.Int),
+    tslib_1.__metadata("design:type", Number)
+], ApprovalInstanceEventPageObject.prototype, "total", void 0);
+exports.ApprovalInstanceEventPageObject = ApprovalInstanceEventPageObject = tslib_1.__decorate([
+    (0, graphql_1.ObjectType)('BPMApprovalInstanceEventPage')
+], ApprovalInstanceEventPageObject);
+//# sourceMappingURL=instance-event.object.js.map

package/src/lib/instance-event/instance-event.object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-event.object.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/instance-event/instance-event.object.ts"],"names":[],"mappings":";;;;AAAA,6CAA6D;AAC7D,iEAAyE;AAEzE;;;;GAIG;AAEI,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;CA+BvC,CAAA;AA/BY,kEAA2B;AAEtC;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,aAAG,CAAC;;iEACK;AAGtB;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;gEACZ;AAG1B;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,YAAE,CAAC;;uDACJ;AAGZ;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,YAAE,CAAC;;+DACI;AAGpB;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8DACd;AAG1B;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC;sCACF,IAAI;kEAAC;AAGrB;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC;sCACL,IAAI;+DAAC;AAIlB;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC;;wDACP;AAGb;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,sDAA+B,CAAC;;2DACJ;AAGzC;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC;;yDACN;sCA9BH,2BAA2B;IADvC,IAAA,oBAAU,EAAC,0BAA0B,CAAC;GAC1B,2BAA2B,CA+BvC;AAED,6CAA6C;AAEtC,IAAM,+BAA+B,GAArC,MAAM,+BAA+B;CAM3C,CAAA;AANY,0EAA+B;AAE1C;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,CAAC,2BAA2B,CAAC,CAAC;;8DACI;AAG/C;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,aAAG,CAAC;;8DACF;0CALJ,+BAA+B;IAD3C,IAAA,oBAAU,EAAC,8BAA8B,CAAC;GAC9B,+BAA+B,CAM3C"}

package/src/lib/instance-event/instance-event.options.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tuning for the instance event outbox (ADR 27 §1.4). Defaults match the
+ * workflow webhook outbox so an operator reasons about one retry policy.
+ */
+export interface BPMInstanceEventDeliveryOptions {
+    /** Rows claimed per scan. Default 25. */
+    readonly batchSize: number;
+    /** Time the observer gets to answer one event. Default 10000 ms. */
+    readonly dispatchTimeoutMs: number;
+    /** Attempts before a row is parked as `FAILED`. Default 6. */
+    readonly maxAttempts: number;
+    /** Upper bound on a single retry delay. Default 3600000 ms. */
+    readonly maxRetryDelayMs: number;
+    /** Days a `DELIVERED` row is kept. `FAILED` rows are never swept. Default 30. */
+    readonly retentionDays: number;
+    /** Base of the exponential retry delay. Default 30000 ms. */
+    readonly retryBaseDelayMs: number;
+    /** Interval of the fallback scan. Default 15000 ms. */
+    readonly scanIntervalMs: number;
+}
+export declare const DEFAULT_BPM_INSTANCE_EVENT_DELIVERY_OPTIONS: BPMInstanceEventDeliveryOptions;
+/**
+ * Fills every unset or non-positive field from the defaults. A host that sets
+ * `batchSize: 0` gets 25, not an outbox that never delivers.
+ */
+export declare function resolveInstanceEventDeliveryOptions(overrides: Partial<BPMInstanceEventDeliveryOptions> | undefined): BPMInstanceEventDeliveryOptions;

package/src/lib/instance-event/instance-event.options.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_BPM_INSTANCE_EVENT_DELIVERY_OPTIONS = void 0;
+exports.resolveInstanceEventDeliveryOptions = resolveInstanceEventDeliveryOptions;
+exports.DEFAULT_BPM_INSTANCE_EVENT_DELIVERY_OPTIONS = {
+    batchSize: 25,
+    dispatchTimeoutMs: 10_000,
+    maxAttempts: 6,
+    maxRetryDelayMs: 3_600_000,
+    retentionDays: 30,
+    retryBaseDelayMs: 30_000,
+    scanIntervalMs: 15_000,
+};
+/**
+ * Fills every unset or non-positive field from the defaults. A host that sets
+ * `batchSize: 0` gets 25, not an outbox that never delivers.
+ */
+function resolveInstanceEventDeliveryOptions(overrides) {
+    const defaults = exports.DEFAULT_BPM_INSTANCE_EVENT_DELIVERY_OPTIONS;
+    return {
+        batchSize: readPositive(overrides?.batchSize, defaults.batchSize),
+        dispatchTimeoutMs: readPositive(overrides?.dispatchTimeoutMs, defaults.dispatchTimeoutMs),
+        maxAttempts: readPositive(overrides?.maxAttempts, defaults.maxAttempts),
+        maxRetryDelayMs: readPositive(overrides?.maxRetryDelayMs, defaults.maxRetryDelayMs),
+        retentionDays: readPositive(overrides?.retentionDays, defaults.retentionDays),
+        retryBaseDelayMs: readPositive(overrides?.retryBaseDelayMs, defaults.retryBaseDelayMs),
+        scanIntervalMs: readPositive(overrides?.scanIntervalMs, defaults.scanIntervalMs),
+    };
+}
+function readPositive(value, fallback) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0
+        ? Math.floor(value)
+        : fallback;
+}
+//# sourceMappingURL=instance-event.options.js.map

package/src/lib/instance-event/instance-event.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-event.options.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/instance-event/instance-event.options.ts"],"names":[],"mappings":";;;AAoCA,kFA6BC;AA5CY,QAAA,2CAA2C,GACtD;IACE,SAAS,EAAE,EAAE;IACb,iBAAiB,EAAE,MAAM;IACzB,WAAW,EAAE,CAAC;IACd,eAAe,EAAE,SAAS;IAC1B,aAAa,EAAE,EAAE;IACjB,gBAAgB,EAAE,MAAM;IACxB,cAAc,EAAE,MAAM;CACvB,CAAC;AAEJ;;;GAGG;AACH,SAAgB,mCAAmC,CACjD,SAA+D;IAE/D,MAAM,QAAQ,GAAG,mDAA2C,CAAC;IAE7D,OAAO;QACL,SAAS,EAAE,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;QACjE,iBAAiB,EAAE,YAAY,CAC7B,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,CAAC,iBAAiB,CAC3B;QACD,WAAW,EAAE,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC;QACvE,eAAe,EAAE,YAAY,CAC3B,SAAS,EAAE,eAAe,EAC1B,QAAQ,CAAC,eAAe,CACzB;QACD,aAAa,EAAE,YAAY,CACzB,SAAS,EAAE,aAAa,EACxB,QAAQ,CAAC,aAAa,CACvB;QACD,gBAAgB,EAAE,YAAY,CAC5B,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,CAAC,gBAAgB,CAC1B;QACD,cAAc,EAAE,YAAY,CAC1B,SAAS,EAAE,cAAc,EACzB,QAAQ,CAAC,cAAc,CACxB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB,EAAE,QAAgB;IAC/D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QACrE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QACnB,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC"}

package/src/lib/instance-event/instance-event.resolver.d.ts

@@ -0,0 +1,10 @@
+import { InstanceEventDeliveryService } from './instance-event.delivery.service';
+import { ApprovalInstanceEventStatusEnum } from './instance-event.enums';
+import { ApprovalInstanceEventObject, ApprovalInstanceEventPageObject } from './instance-event.object';
+/** Admin access to the outbox: triage failed deliveries and retry them. */
+export declare class InstanceEventResolver {
+    private readonly deliveryService;
+    constructor(deliveryService: InstanceEventDeliveryService);
+    approvalInstanceEvents(instanceId?: string | null, status?: ApprovalInstanceEventStatusEnum | null, page?: number, pageSize?: number): Promise<ApprovalInstanceEventPageObject>;
+    retryApprovalInstanceEvent(id: string): Promise<ApprovalInstanceEventObject>;
+}

package/src/lib/instance-event/instance-event.resolver.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceEventResolver = void 0;
+const tslib_1 = require("tslib");
+const graphql_1 = require("@nestjs/graphql");
+const bpm_auth_1 = require("../bpm-auth");
+const instance_event_delivery_service_1 = require("./instance-event.delivery.service");
+const instance_event_enums_1 = require("./instance-event.enums");
+const instance_event_object_1 = require("./instance-event.object");
+/** Admin access to the outbox: triage failed deliveries and retry them. */
+let InstanceEventResolver = class InstanceEventResolver {
+    constructor(deliveryService) {
+        this.deliveryService = deliveryService;
+    }
+    async approvalInstanceEvents(instanceId, status, page = 1, pageSize = 50) {
+        const result = await this.deliveryService.listEvents({
+            instanceId: instanceId ?? null,
+            page,
+            pageSize,
+            status: status ? instance_event_enums_1.APPROVAL_INSTANCE_EVENT_ENUM_TO_STATUS[status] : null,
+        });
+        return Object.assign(new instance_event_object_1.ApprovalInstanceEventPageObject(), {
+            items: result.items.map((row) => toObject(row)),
+            total: result.total,
+        });
+    }
+    async retryApprovalInstanceEvent(id) {
+        return toObject(await this.deliveryService.retryFailedEvent(id));
+    }
+};
+exports.InstanceEventResolver = InstanceEventResolver;
+tslib_1.__decorate([
+    (0, graphql_1.Query)(() => instance_event_object_1.ApprovalInstanceEventPageObject),
+    tslib_1.__param(0, (0, graphql_1.Args)('instanceId', { nullable: true, type: () => graphql_1.ID })),
+    tslib_1.__param(1, (0, graphql_1.Args)('status', {
+        nullable: true,
+        type: () => instance_event_enums_1.ApprovalInstanceEventStatusEnum,
+    })),
+    tslib_1.__param(2, (0, graphql_1.Args)('page', { defaultValue: 1, type: () => graphql_1.Int })),
+    tslib_1.__param(3, (0, graphql_1.Args)('pageSize', { defaultValue: 50, type: () => graphql_1.Int })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, Object, Object, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], InstanceEventResolver.prototype, "approvalInstanceEvents", null);
+tslib_1.__decorate([
+    (0, graphql_1.Mutation)(() => instance_event_object_1.ApprovalInstanceEventObject),
+    tslib_1.__param(0, (0, graphql_1.Args)('id', { type: () => graphql_1.ID })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], InstanceEventResolver.prototype, "retryApprovalInstanceEvent", null);
+exports.InstanceEventResolver = InstanceEventResolver = tslib_1.__decorate([
+    (0, graphql_1.Resolver)(),
+    (0, bpm_auth_1.BPMAdminOnly)(),
+    tslib_1.__metadata("design:paramtypes", [instance_event_delivery_service_1.InstanceEventDeliveryService])
+], InstanceEventResolver);
+/**
+ * Field by field, so `payload` and `claimedAt` never reach the GraphQL
+ * response even if the entity gains fields later.
+ */
+function toObject(row) {
+    return Object.assign(new instance_event_object_1.ApprovalInstanceEventObject(), {
+        attemptCount: row.attemptCount,
+        deliveredAt: row.deliveredAt,
+        id: row.id,
+        instanceId: row.instanceId,
+        lastError: row.lastError,
+        nextAttemptAt: row.nextAttemptAt,
+        occurredAt: row.occurredAt,
+        seq: row.seq,
+        status: instance_event_enums_1.APPROVAL_INSTANCE_EVENT_STATUS_TO_ENUM[row.status],
+        type: row.type,
+    });
+}
+//# sourceMappingURL=instance-event.resolver.js.map

package/src/lib/instance-event/instance-event.resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-event.resolver.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/instance-event/instance-event.resolver.ts"],"names":[],"mappings":";;;;AAAA,6CAA2E;AAC3E,0CAA2C;AAE3C,uFAAiF;AACjF,iEAIgC;AAChC,mEAGiC;AAEjC,2EAA2E;AAGpE,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YAA6B,eAA6C;QAA7C,oBAAe,GAAf,eAAe,CAA8B;IAAG,CAAC;IAGxE,AAAN,KAAK,CAAC,sBAAsB,CAE1B,UAA0B,EAK1B,MAA+C,EACK,OAAO,CAAC,EACH,WAAW,EAAE;QAEtE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC;YACnD,UAAU,EAAE,UAAU,IAAI,IAAI;YAC9B,IAAI;YACJ,QAAQ;YACR,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,6DAAsC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;SACvE,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,uDAA+B,EAAE,EAAE;YAC1D,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC/C,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IAGK,AAAN,KAAK,CAAC,0BAA0B,CACE,EAAU;QAE1C,OAAO,QAAQ,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;CACF,CAAA;AAlCY,sDAAqB;AAI1B;IADL,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,uDAA+B,CAAC;IAE1C,mBAAA,IAAA,cAAI,EAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,YAAE,EAAE,CAAC,CAAA;IAEtD,mBAAA,IAAA,cAAI,EAAC,QAAQ,EAAE;QACd,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,GAAG,EAAE,CAAC,sDAA+B;KAC5C,CAAC,CAAA;IAED,mBAAA,IAAA,cAAI,EAAC,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,aAAG,EAAE,CAAC,CAAA;IAClD,mBAAA,IAAA,cAAI,EAAC,UAAU,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,aAAG,EAAE,CAAC,CAAA;;;;mEAazD;AAGK;IADL,IAAA,kBAAQ,EAAC,GAAG,EAAE,CAAC,mDAA2B,CAAC;IAEzC,mBAAA,IAAA,cAAI,EAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,YAAE,EAAE,CAAC,CAAA;;;;uEAGhC;gCAjCU,qBAAqB;IAFjC,IAAA,kBAAQ,GAAE;IACV,IAAA,uBAAY,GAAE;6CAEiC,8DAA4B;GAD/D,qBAAqB,CAkCjC;AAED;;;GAGG;AACH,SAAS,QAAQ,CACf,GAAgC;IAEhC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,mDAA2B,EAAE,EAAE;QACtD,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,MAAM,EAAE,6DAAsC,CAAC,GAAG,CAAC,MAAM,CAAC;QAC1D,IAAI,EAAE,GAAG,CAAC,IAAI;KACf,CAAC,CAAC;AACL,CAAC"}

package/src/lib/instance-event/instance-event.service.d.ts

@@ -0,0 +1,18 @@
+import { BPMRootRuntimeOptions } from '../bpm/bpm-root-options';
+import { BPMInstanceEventDeliveryOptions } from './instance-event.options';
+import { BPMInstanceEventObserver } from './instance-event.token';
+/**
+ * Holds the host observer for instance lifecycle events. `observer` is `null`
+ * when the host bound none; the engine then writes no outbox rows.
+ *
+ * Resolution: the Nest provider (`BPM_INSTANCE_EVENT_OBSERVER`) wins over the
+ * runtime option `BPMRootRuntimeOptions.instanceEventObserver`.
+ *
+ * `delivery` is the resolved outbox tuning, with unset fields defaulted.
+ */
+export declare class InstanceEventService {
+    readonly observer: BPMInstanceEventObserver | null;
+    readonly delivery: BPMInstanceEventDeliveryOptions;
+    constructor(injectedObserver: BPMInstanceEventObserver | undefined, rootOptions: BPMRootRuntimeOptions | undefined);
+    get enabled(): boolean;
+}

package/src/lib/instance-event/instance-event.service.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceEventService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const bpm_root_options_1 = require("../bpm/bpm-root-options");
+const instance_event_options_1 = require("./instance-event.options");
+const instance_event_token_1 = require("./instance-event.token");
+/**
+ * Holds the host observer for instance lifecycle events. `observer` is `null`
+ * when the host bound none; the engine then writes no outbox rows.
+ *
+ * Resolution: the Nest provider (`BPM_INSTANCE_EVENT_OBSERVER`) wins over the
+ * runtime option `BPMRootRuntimeOptions.instanceEventObserver`.
+ *
+ * `delivery` is the resolved outbox tuning, with unset fields defaulted.
+ */
+let InstanceEventService = class InstanceEventService {
+    constructor(injectedObserver, rootOptions) {
+        this.observer =
+            injectedObserver ?? rootOptions?.instanceEventObserver ?? null;
+        this.delivery = (0, instance_event_options_1.resolveInstanceEventDeliveryOptions)(rootOptions?.instanceEventDelivery);
+    }
+    get enabled() {
+        return this.observer !== null;
+    }
+};
+exports.InstanceEventService = InstanceEventService;
+exports.InstanceEventService = InstanceEventService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Optional)()),
+    tslib_1.__param(0, (0, common_1.Inject)(instance_event_token_1.BPM_INSTANCE_EVENT_OBSERVER)),
+    tslib_1.__param(1, (0, common_1.Optional)()),
+    tslib_1.__param(1, (0, common_1.Inject)(bpm_root_options_1.BPM_ROOT_OPTIONS)),
+    tslib_1.__metadata("design:paramtypes", [Object, Object])
+], InstanceEventService);
+//# sourceMappingURL=instance-event.service.js.map

package/src/lib/instance-event/instance-event.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-event.service.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/instance-event/instance-event.service.ts"],"names":[],"mappings":";;;;AAAA,2CAA8D;AAC9D,8DAGiC;AACjC,qEAGkC;AAClC,iEAGgC;AAEhC;;;;;;;;GAQG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAI/B,YAGE,gBAAsD,EAGtD,WAA8C;QAE9C,IAAI,CAAC,QAAQ;YACX,gBAAgB,IAAI,WAAW,EAAE,qBAAqB,IAAI,IAAI,CAAC;QACjE,IAAI,CAAC,QAAQ,GAAG,IAAA,4DAAmC,EACjD,WAAW,EAAE,qBAAqB,CACnC,CAAC;IACJ,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;IAChC,CAAC;CACF,CAAA;AAtBY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;IAMR,mBAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,mBAAA,IAAA,eAAM,EAAC,kDAA2B,CAAC,CAAA;IAEnC,mBAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,mBAAA,IAAA,eAAM,EAAC,mCAAgB,CAAC,CAAA;;GAThB,oBAAoB,CAsBhC"}

package/src/lib/instance-event/instance-event.token.d.ts

@@ -0,0 +1,19 @@
+import { InjectionToken } from '@nestjs/common';
+import type { BPMInstanceEvent } from './instance-event.types';
+/**
+ * Host hook that receives approval instance lifecycle events (ADR 27 §1).
+ *
+ * Delivery is at-least-once and runs after the state change has committed. A
+ * redelivered event carries the same `event.id`, so the host dedupes on it.
+ * Events of one instance arrive in `seq` order; events of different instances
+ * have no ordering guarantee. A thrown error is retried with backoff and the
+ * event is marked FAILED after the retry limit.
+ */
+export interface BPMInstanceEventObserver {
+    onInstanceEvent(event: BPMInstanceEvent): Promise<void> | void;
+}
+/**
+ * Optional host binding for {@link BPMInstanceEventObserver}. Without an
+ * observer, the engine writes no event rows at all.
+ */
+export declare const BPM_INSTANCE_EVENT_OBSERVER: InjectionToken<BPMInstanceEventObserver>;

package/src/lib/instance-event/instance-event.token.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BPM_INSTANCE_EVENT_OBSERVER = void 0;
+/**
+ * Optional host binding for {@link BPMInstanceEventObserver}. Without an
+ * observer, the engine writes no event rows at all.
+ */
+exports.BPM_INSTANCE_EVENT_OBSERVER = Symbol('BPM_INSTANCE_EVENT_OBSERVER');
+//# sourceMappingURL=instance-event.token.js.map

package/src/lib/instance-event/instance-event.token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-event.token.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/instance-event/instance-event.token.ts"],"names":[],"mappings":";;;AAgBA;;;GAGG;AACU,QAAA,2BAA2B,GACtC,MAAM,CAAC,6BAA6B,CAAC,CAAC"}

package/src/lib/instance-event/instance-event.types.d.ts

@@ -0,0 +1,67 @@
+import type { ApprovalInstanceStateEnum } from '../workflow-engine/workflow-engine.enums';
+/** Empty payload for event types that carry no type-specific fields. */
+export type BPMInstanceEventNoPayload = Readonly<Record<never, never>>;
+/**
+ * Type-specific fields per event type (ADR 27 §1.3). `formData` is never part
+ * of an event: a host that needs it reads the instance by `instanceId`.
+ */
+export interface BPMInstanceEventTypePayloads {
+    readonly INSTANCE_APPROVED: BPMInstanceEventNoPayload;
+    readonly INSTANCE_CANCELLED: {
+        readonly actorMemberId: string | null;
+    };
+    readonly INSTANCE_EXPIRED: BPMInstanceEventNoPayload;
+    readonly INSTANCE_REJECTED: {
+        readonly actorMemberId: string | null;
+    };
+    readonly INSTANCE_RESUBMITTED: {
+        readonly actorMemberId: string | null;
+    };
+    readonly INSTANCE_RETURNED: {
+        readonly actorMemberId: string | null;
+        readonly nodeId: string;
+    };
+    readonly INSTANCE_SUBMITTED: {
+        readonly actorMemberId: string | null;
+    };
+    readonly NODE_ACTIVATED: {
+        readonly nodeId: string;
+        readonly taskIds: readonly string[];
+    };
+    readonly TASK_AUTO_DECISION_FAILED: {
+        readonly reason: string;
+        readonly taskId: string;
+    };
+}
+export type BPMInstanceEventType = keyof BPMInstanceEventTypePayloads;
+/**
+ * Template and state at the moment the event was written. The table has no
+ * columns for these, so they are stored inside `payload`.
+ */
+export interface BPMInstanceEventSnapshot {
+    readonly instanceState: ApprovalInstanceStateEnum;
+    readonly templateId: string;
+    readonly templateKey: string | null;
+    readonly templateVersionId: string;
+}
+/** Columns that every delivered event carries. */
+export interface BPMInstanceEventHeader {
+    /** Generated by the database. Stable across redeliveries; dedupe on it. */
+    readonly id: string;
+    readonly instanceId: string;
+    /** Write order, assigned by the database. A bigint, so a string. */
+    readonly seq: string;
+    readonly occurredAt: string;
+}
+/** The payload stored in `approval_instance_events.payload`. */
+export type BPMInstanceEventPayload = {
+    readonly [K in BPMInstanceEventType]: BPMInstanceEventSnapshot & BPMInstanceEventTypePayloads[K];
+}[BPMInstanceEventType];
+/** What the observer receives. Discriminated on `type`. */
+export type BPMInstanceEvent = {
+    readonly [K in BPMInstanceEventType]: BPMInstanceEventHeader & {
+        readonly type: K;
+    } & BPMInstanceEventSnapshot & BPMInstanceEventTypePayloads[K];
+}[BPMInstanceEventType];
+export declare const BPM_INSTANCE_EVENT_STATUSES: readonly ["PENDING", "DELIVERED", "FAILED"];
+export type BPMInstanceEventStatus = (typeof BPM_INSTANCE_EVENT_STATUSES)[number];