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

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

@@ -0,0 +1,259 @@
+"use strict";
+var InstanceEventDeliveryService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceEventDeliveryService = 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 outbox_1 = require("../common/outbox");
+const approval_instance_event_entity_1 = require("./approval-instance-event.entity");
+const instance_event_service_1 = require("./instance-event.service");
+/** Dispatches in flight per claim, so one scan cannot saturate the host observer. */
+const MAX_CONCURRENT_DISPATCHES = 5;
+/** Admin list page size bounds; a larger request is clamped, not rejected. */
+const MAX_PAGE_SIZE = 200;
+/** Stored error text is capped; host error messages are not trusted to be short. */
+const MAX_ERROR_LENGTH = 500;
+/** A claim older than this is treated as abandoned and may be taken over. */
+const MIN_STALE_CLAIM_MS = 60_000;
+const DAY_MS = 86_400_000;
+/**
+ * Delivers outbox rows to the host observer (ADR 27 §1.3).
+ *
+ * Guarantees, and how they are kept:
+ * - At least once. A row is `DELIVERED` only after the observer resolved; a
+ *   crash between dispatch and write-back redelivers. Hosts dedupe on `id`.
+ * - Per-instance order by `seq`. The claim skips a row while an earlier `PENDING`
+ *   row of the same instance exists. `FAILED` rows do not block.
+ * - Claims never change `status`. A claim is a `claimed_at` stamp, taken with
+ *   `FOR UPDATE SKIP LOCKED`, so several replicas can scan at once.
+ * - Write-back is conditional on `claimed_at`. A worker that lost its claim
+ *   records nothing.
+ */
+let InstanceEventDeliveryService = InstanceEventDeliveryService_1 = class InstanceEventDeliveryService {
+    constructor(repository, events) {
+        this.repository = repository;
+        this.events = events;
+        this.logger = new common_1.Logger(InstanceEventDeliveryService_1.name);
+    }
+    /**
+     * Claims and delivers due rows across all instances, up to `batchSize`.
+     * Returns the number of rows attempted. No-op without a bound observer.
+     */
+    async deliverDue(now = new Date()) {
+        if (!this.events.enabled) {
+            return 0;
+        }
+        const { batchSize } = this.events.delivery;
+        let attempted = 0;
+        while (attempted < batchSize) {
+            const rows = await this.claim({
+                ids: null,
+                limit: Math.min(MAX_CONCURRENT_DISPATCHES, batchSize - attempted),
+                now,
+            });
+            if (rows.length === 0) {
+                break;
+            }
+            attempted += rows.length;
+            await Promise.all(rows.map((row) => this.attemptSafely(row, now)));
+        }
+        return attempted;
+    }
+    /**
+     * Delivers the named rows. Used by the commit subscriber. A row whose earlier
+     * sibling is still pending is skipped here and picked up by the scheduler.
+     */
+    async deliverByIds(ids, now = new Date()) {
+        if (!this.events.enabled || ids.length === 0) {
+            return 0;
+        }
+        const rows = await this.claim({
+            ids: [...new Set(ids)],
+            limit: ids.length,
+            now,
+        });
+        await Promise.all(rows.map((row) => this.attemptSafely(row, now)));
+        return rows.length;
+    }
+    /**
+     * Deletes `DELIVERED` rows older than `retentionDays`. `FAILED` rows are kept
+     * until an operator retries or removes them. Returns the number deleted.
+     */
+    async purgeDelivered(now = new Date()) {
+        const cutoff = new Date(now.getTime() - this.events.delivery.retentionDays * DAY_MS);
+        const result = await this.repository.delete({
+            deliveredAt: (0, typeorm_2.LessThan)(cutoff),
+            status: 'DELIVERED',
+        });
+        return result.affected ?? 0;
+    }
+    /**
+     * Admin read: newest first, optionally filtered. Not gated by `enabled`, so
+     * rows left behind by an earlier deployment stay visible.
+     */
+    async listEvents(input) {
+        const pageSize = clampPageSize(input.pageSize);
+        const page = Math.max(1, Math.floor(input.page));
+        const [items, total] = await this.repository.findAndCount({
+            order: { seq: 'DESC' },
+            skip: (page - 1) * pageSize,
+            take: pageSize,
+            where: {
+                ...(input.instanceId ? { instanceId: input.instanceId } : {}),
+                ...(input.status ? { status: input.status } : {}),
+            },
+        });
+        return { items, total };
+    }
+    /**
+     * Admin retry of a `FAILED` row. Resets the attempt budget and makes the row
+     * due now; the next scan or commit kick delivers it. Only `FAILED` rows match,
+     * so a row that is already pending or delivered is rejected, not reset.
+     */
+    async retryFailedEvent(id, now = new Date()) {
+        const existing = await this.repository.findOne({ where: { id } });
+        if (!existing) {
+            throw new common_1.NotFoundException(`Instance event ${id} not found`);
+        }
+        const result = await this.repository.update({ id, status: 'FAILED' }, {
+            attemptCount: 0,
+            lastError: null,
+            nextAttemptAt: now,
+            status: 'PENDING',
+        });
+        if (!result.affected) {
+            throw new common_1.BadRequestException(`Instance event ${id} is not FAILED and cannot be retried`);
+        }
+        const refreshed = await this.repository.findOne({ where: { id } });
+        if (!refreshed) {
+            throw new common_1.NotFoundException(`Instance event ${id} not found`);
+        }
+        return refreshed;
+    }
+    /**
+     * `base * 2^(attempt - 1)` with ±20 % jitter, capped at `maxRetryDelayMs`.
+     * Same policy as the webhook outbox.
+     */
+    readRetryDelay(attempt) {
+        const { maxRetryDelayMs, retryBaseDelayMs } = this.events.delivery;
+        const exponential = retryBaseDelayMs * 2 ** Math.min(Math.max(attempt - 1, 0), 30);
+        return Math.min(Math.round(exponential * (0.8 + Math.random() * 0.4)), maxRetryDelayMs);
+    }
+    async claim({ ids, limit, now, }) {
+        const staleBefore = new Date(now.getTime() - this.readStaleClaimMs());
+        return this.repository.manager.transaction(async (manager) => {
+            const claimedRows = (await manager.query(`
+            UPDATE approval_instance_events
+               SET claimed_at = $1
+             WHERE id IN (
+               SELECT e.id
+                 FROM approval_instance_events e
+                WHERE e.status = $2
+                  AND e.next_attempt_at <= $1
+                  AND (e.claimed_at IS NULL OR e.claimed_at <= $3)
+                  AND ($5::uuid[] IS NULL OR e.id = ANY($5::uuid[]))
+                  AND NOT EXISTS (
+                    SELECT 1
+                      FROM approval_instance_events earlier
+                     WHERE earlier.instance_id = e.instance_id
+                       AND earlier.seq < e.seq
+                       AND earlier.status = $2
+                  )
+                ORDER BY e.seq ASC
+                FOR UPDATE SKIP LOCKED
+                LIMIT $4
+             )
+             RETURNING id
+          `, [now, 'PENDING', staleBefore, limit, ids ? [...ids] : null]));
+            const claimedIds = (0, outbox_1.readClaimedIds)(claimedRows);
+            if (claimedIds.length === 0) {
+                return [];
+            }
+            const found = await manager
+                .getRepository(approval_instance_event_entity_1.ApprovalInstanceEventEntity)
+                .find({ where: { id: (0, typeorm_2.In)([...claimedIds]) } });
+            return [...found].sort((left, right) => Number(left.seq) - Number(right.seq));
+        });
+    }
+    async attemptSafely(row, claimedAt) {
+        try {
+            await this.attempt(row, claimedAt);
+        }
+        catch (error) {
+            this.logger.warn(`Instance event ${row.id} could not record its outcome (${readErrorName(error)})`);
+        }
+    }
+    async attempt(row, claimedAt) {
+        const observer = this.events.observer;
+        if (observer === null) {
+            return;
+        }
+        const { dispatchTimeoutMs, maxAttempts } = this.events.delivery;
+        const attemptCount = row.attemptCount + 1;
+        const outcome = await (0, outbox_1.withDispatchTimeout)(this.dispatch(observer, row), dispatchTimeoutMs).then(() => ({ kind: 'DELIVERED' }), (error) => ({ error, kind: 'FAILED' }));
+        if (outcome.kind === 'DELIVERED') {
+            await this.writeOutcome(row, claimedAt, {
+                attemptCount,
+                claimedAt: null,
+                deliveredAt: new Date(),
+                lastError: null,
+                status: 'DELIVERED',
+            });
+            return;
+        }
+        const terminal = attemptCount >= maxAttempts;
+        await this.writeOutcome(row, claimedAt, {
+            attemptCount,
+            claimedAt: null,
+            lastError: readErrorText(outcome.error),
+            nextAttemptAt: terminal
+                ? row.nextAttemptAt
+                : new Date(Date.now() + this.readRetryDelay(attemptCount)),
+            status: terminal ? 'FAILED' : 'PENDING',
+        });
+    }
+    async dispatch(observer, row) {
+        await observer.onInstanceEvent(toObserverEvent(row));
+    }
+    async writeOutcome(row, claimedAt, changes) {
+        const result = await this.repository.update({ claimedAt, id: row.id }, changes);
+        if (!result.affected) {
+            this.logger.warn(`Instance event ${row.id} lost its claim before the outcome was recorded`);
+        }
+    }
+    readStaleClaimMs() {
+        return Math.max(this.events.delivery.dispatchTimeoutMs * 3, MIN_STALE_CLAIM_MS);
+    }
+};
+exports.InstanceEventDeliveryService = InstanceEventDeliveryService;
+exports.InstanceEventDeliveryService = InstanceEventDeliveryService = InstanceEventDeliveryService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, typeorm_1.InjectRepository)(approval_instance_event_entity_1.ApprovalInstanceEventEntity)),
+    tslib_1.__metadata("design:paramtypes", [typeorm_2.Repository,
+        instance_event_service_1.InstanceEventService])
+], InstanceEventDeliveryService);
+/** Reads a stored row as the observer sees it. Payloads never hold `formData`. */
+function toObserverEvent(row) {
+    return {
+        ...row.payload,
+        id: row.id,
+        instanceId: row.instanceId,
+        occurredAt: row.occurredAt.toISOString(),
+        seq: row.seq,
+        type: row.type,
+    };
+}
+function clampPageSize(pageSize) {
+    return Math.min(Math.max(Math.floor(pageSize), 1), MAX_PAGE_SIZE);
+}
+function readErrorName(error) {
+    return error instanceof Error ? error.name : 'UnknownError';
+}
+function readErrorText(error) {
+    const name = readErrorName(error);
+    const message = error instanceof Error ? error.message : '';
+    return `${name}: ${message}`.slice(0, MAX_ERROR_LENGTH);
+}
+//# sourceMappingURL=instance-event.delivery.service.js.map

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

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

package/src/lib/instance-event/instance-event.delivery.subscriber.d.ts

@@ -0,0 +1,24 @@
+import { DataSource, EntitySubscriberInterface, InsertEvent, TransactionCommitEvent, TransactionRollbackEvent } from 'typeorm';
+import { ApprovalInstanceEventEntity } from './approval-instance-event.entity';
+import { InstanceEventDeliveryService } from './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.
+ */
+export declare class InstanceEventDeliverySubscriber implements EntitySubscriberInterface<ApprovalInstanceEventEntity> {
+    private readonly deliveryService;
+    private readonly logger;
+    private readonly pending;
+    constructor(dataSource: DataSource, deliveryService: InstanceEventDeliveryService);
+    listenTo(): typeof ApprovalInstanceEventEntity;
+    afterInsert(event: InsertEvent<ApprovalInstanceEventEntity>): void;
+    afterTransactionCommit(event: TransactionCommitEvent): void;
+    afterTransactionRollback(event: TransactionRollbackEvent): void;
+    private kick;
+}

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;