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

package/src/lib/identity/identity.queries.js

@@ -5,7 +5,6 @@ const tslib_1 = require("tslib");
 const graphql_1 = require("@nestjs/graphql");
 const bpm_auth_1 = require("../bpm-auth");
 const identity_service_1 = require("./identity.service");
-const member_metadata_cache_entity_1 = require("./member-metadata-cache.entity");
 const member_profile_object_1 = require("./member-profile.object");
 let IdentityQueries = class IdentityQueries {
     constructor(identityService) {
@@ -19,9 +18,6 @@ let IdentityQueries = class IdentityQueries {
         const metadataList = await this.identityService.resolveMembers(memberIds);
         return metadataList.map(member_profile_object_1.toMemberProfileObject);
     }
-    async cachedMembers() {
-        return this.identityService.listCachedMembers();
-    }
     async searchMembers(searchText, page, pageSize) {
         const metadataList = await this.identityService.searchMembers(searchText, {
             page: page ?? undefined,
@@ -48,13 +44,6 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:paramtypes", [Array]),
     tslib_1.__metadata("design:returntype", Promise)
 ], IdentityQueries.prototype, "members", null);
-tslib_1.__decorate([
-    (0, graphql_1.Query)(() => [member_metadata_cache_entity_1.MemberMetadataCacheEntity]),
-    (0, bpm_auth_1.BPMAdminOnly)(),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], IdentityQueries.prototype, "cachedMembers", null);
 tslib_1.__decorate([
     (0, graphql_1.Query)(() => [member_profile_object_1.MemberProfileObject]),
     tslib_1.__param(0, (0, graphql_1.Args)('searchText', { type: () => String })),

package/src/lib/identity/identity.queries.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity.queries.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/identity/identity.queries.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"identity.queries.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/identity/identity.queries.ts"],"names":[],"mappings":";;;;AAAA,6CAA6D;AAC7D,0CAA+C;AAC/C,yDAAqD;AACrD,mEAGiC;AAI1B,IAAM,eAAe,GAArB,MAAM,eAAe;IAC1B,YAA6B,eAAgC;QAAhC,oBAAe,GAAf,eAAe,CAAiB;IAAG,CAAC;IAG3D,AAAN,KAAK,CAAC,MAAM,CACgC,QAAgB;QAE1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAEpE,OAAO,IAAA,6CAAqB,EAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAGK,AAAN,KAAK,CAAC,OAAO,CACkC,SAA4B;QAEzE,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAE1E,OAAO,YAAY,CAAC,GAAG,CAAC,6CAAqB,CAAC,CAAC;IACjD,CAAC;IAGK,AAAN,KAAK,CAAC,aAAa,CAC2B,UAAkB,EACX,IAAoB,EAEvE,QAAwB;QAExB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,UAAU,EAAE;YACxE,IAAI,EAAE,IAAI,IAAI,SAAS;YACvB,QAAQ,EAAE,QAAQ,IAAI,SAAS;SAChC,CAAC,CAAC;QAEH,OAAO,YAAY,CAAC,GAAG,CAAC,6CAAqB,CAAC,CAAC;IACjD,CAAC;IAGK,AAAN,KAAK,CAAC,WAAW,CAEf,UAA0B;QAE1B,OAAO,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF,CAAA;AA3CY,0CAAe;AAIpB;IADL,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,2CAAmB,CAAC;IAE9B,mBAAA,IAAA,cAAI,EAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAA;;;;6CAK1C;AAGK;IADL,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,CAAC,2CAAmB,CAAC,CAAC;IAEhC,mBAAA,IAAA,cAAI,EAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;;;;8CAK7C;AAGK;IADL,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,CAAC,2CAAmB,CAAC,CAAC;IAEhC,mBAAA,IAAA,cAAI,EAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAA;IAC1C,mBAAA,IAAA,cAAI,EAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,aAAG,EAAE,CAAC,CAAA;IACjD,mBAAA,IAAA,cAAI,EAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,aAAG,EAAE,CAAC,CAAA;;;;oDASvD;AAGK;IADL,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,aAAG,CAAC;IAEd,mBAAA,IAAA,cAAI,EAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAA;;;;kDAI5D;0BA1CU,eAAe;IAF3B,IAAA,kBAAQ,GAAE;IACV,IAAA,2BAAgB,GAAE;6CAE6B,kCAAe;GADlD,eAAe,CA2C3B"}

package/src/lib/instance-event/approval-instance-event.entity.d.ts

@@ -0,0 +1,27 @@
+import { ApprovalInstanceEntity } from '../workflow-engine/approval-instance.entity';
+import { BPMInstanceEventPayload, BPMInstanceEventStatus, BPMInstanceEventType } from './instance-event.types';
+/**
+ * One outbox row per instance lifecycle event (ADR 27 §1.2). Written in the
+ * same transaction as the state change, delivered after commit. Mirrors
+ * migration `0000000032000-host-integration-round`; `synchronize` stays off.
+ */
+export declare class ApprovalInstanceEventEntity {
+    id: string;
+    /**
+     * Write order, assigned by the database (migration
+     * `0000000032000-host-integration-round`). Sort by this, not by `id` or
+     * `occurredAt`. `bigint`, so the driver returns a string.
+     */
+    seq: string;
+    instanceId: string;
+    instance?: ApprovalInstanceEntity;
+    type: BPMInstanceEventType;
+    payload: BPMInstanceEventPayload;
+    status: BPMInstanceEventStatus;
+    attemptCount: number;
+    nextAttemptAt: Date;
+    claimedAt: Date | null;
+    deliveredAt: Date | null;
+    lastError: string | null;
+    occurredAt: Date;
+}

package/src/lib/instance-event/approval-instance-event.entity.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApprovalInstanceEventEntity = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+const approval_instance_entity_1 = require("../workflow-engine/approval-instance.entity");
+const instance_event_types_1 = require("./instance-event.types");
+/**
+ * One outbox row per instance lifecycle event (ADR 27 §1.2). Written in the
+ * same transaction as the state change, delivered after commit. Mirrors
+ * migration `0000000032000-host-integration-round`; `synchronize` stays off.
+ */
+let ApprovalInstanceEventEntity = class ApprovalInstanceEventEntity {
+};
+exports.ApprovalInstanceEventEntity = ApprovalInstanceEventEntity;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    tslib_1.__metadata("design:type", String)
+], ApprovalInstanceEventEntity.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({
+        generated: 'identity',
+        generatedIdentity: 'ALWAYS',
+        name: 'seq',
+        type: 'bigint',
+        update: false,
+    }),
+    tslib_1.__metadata("design:type", String)
+], ApprovalInstanceEventEntity.prototype, "seq", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('uuid', { name: 'instance_id' }),
+    tslib_1.__metadata("design:type", String)
+], ApprovalInstanceEventEntity.prototype, "instanceId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(() => approval_instance_entity_1.ApprovalInstanceEntity, {
+        createForeignKeyConstraints: true,
+        onDelete: 'CASCADE',
+    }),
+    (0, typeorm_1.JoinColumn)({
+        foreignKeyConstraintName: 'FK_approval_instance_events_instance',
+        name: 'instance_id',
+    }),
+    tslib_1.__metadata("design:type", approval_instance_entity_1.ApprovalInstanceEntity)
+], ApprovalInstanceEventEntity.prototype, "instance", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('text'),
+    tslib_1.__metadata("design:type", String)
+], ApprovalInstanceEventEntity.prototype, "type", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('jsonb'),
+    tslib_1.__metadata("design:type", Object)
+], ApprovalInstanceEventEntity.prototype, "payload", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('text', { default: 'PENDING' }),
+    tslib_1.__metadata("design:type", String)
+], ApprovalInstanceEventEntity.prototype, "status", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('integer', { default: 0, name: 'attempt_count' }),
+    tslib_1.__metadata("design:type", Number)
+], ApprovalInstanceEventEntity.prototype, "attemptCount", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('timestamptz', {
+        default: () => 'now()',
+        name: 'next_attempt_at',
+    }),
+    tslib_1.__metadata("design:type", Date)
+], ApprovalInstanceEventEntity.prototype, "nextAttemptAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('timestamptz', { name: 'claimed_at', nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], ApprovalInstanceEventEntity.prototype, "claimedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('timestamptz', { name: 'delivered_at', nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], ApprovalInstanceEventEntity.prototype, "deliveredAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('text', { name: 'last_error', nullable: true }),
+    tslib_1.__metadata("design:type", Object)
+], ApprovalInstanceEventEntity.prototype, "lastError", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('timestamptz', {
+        default: () => 'now()',
+        name: 'occurred_at',
+    }),
+    tslib_1.__metadata("design:type", Date)
+], ApprovalInstanceEventEntity.prototype, "occurredAt", void 0);
+exports.ApprovalInstanceEventEntity = ApprovalInstanceEventEntity = tslib_1.__decorate([
+    (0, typeorm_1.Entity)('approval_instance_events'),
+    (0, typeorm_1.Check)('CHK_approval_instance_events_status', `"status" IN (${instance_event_types_1.BPM_INSTANCE_EVENT_STATUSES.map((status) => `'${status}'`).join(', ')})`),
+    (0, typeorm_1.Index)('IDX_approval_instance_events_due', ['status', 'nextAttemptAt']),
+    (0, typeorm_1.Index)('IDX_approval_instance_events_instance_seq', ['instanceId', 'seq'])
+], ApprovalInstanceEventEntity);
+//# sourceMappingURL=approval-instance-event.entity.js.map

package/src/lib/instance-event/approval-instance-event.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-instance-event.entity.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/instance-event/approval-instance-event.entity.ts"],"names":[],"mappings":";;;;AAAA,qCAQiB;AACjB,0FAAqF;AACrF,iEAKgC;AAEhC;;;;GAIG;AAQI,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;CA+DvC,CAAA;AA/DY,kEAA2B;AAEtC;IADC,IAAA,gCAAsB,EAAC,MAAM,CAAC;;uDACnB;AAcZ;IAPC,IAAA,gBAAM,EAAC;QACN,SAAS,EAAE,UAAU;QACrB,iBAAiB,EAAE,QAAQ;QAC3B,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,KAAK;KACd,CAAC;;wDACW;AAGb;IADC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;;+DACpB;AAUpB;IARC,IAAA,mBAAS,EAAC,GAAG,EAAE,CAAC,iDAAsB,EAAE;QACvC,2BAA2B,EAAE,IAAI;QACjC,QAAQ,EAAE,SAAS;KACpB,CAAC;IACD,IAAA,oBAAU,EAAC;QACV,wBAAwB,EAAE,sCAAsC;QAChE,IAAI,EAAE,aAAa;KACpB,CAAC;sCACS,iDAAsB;6DAAC;AAGlC;IADC,IAAA,gBAAM,EAAC,MAAM,CAAC;;yDACa;AAG5B;IADC,IAAA,gBAAM,EAAC,OAAO,CAAC;;4DACkB;AAGlC;IADC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;;2DACP;AAGhC;IADC,IAAA,gBAAM,EAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;;iEACnC;AAMtB;IAJC,IAAA,gBAAM,EAAC,aAAa,EAAE;QACrB,OAAO,EAAE,GAAW,EAAE,CAAC,OAAO;QAC9B,IAAI,EAAE,iBAAiB;KACxB,CAAC;sCACc,IAAI;kEAAC;AAGrB;IADC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8DACtC;AAGxB;IADC,IAAA,gBAAM,EAAC,aAAa,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;gEACtC;AAG1B;IADC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8DAC7B;AAM1B;IAJC,IAAA,gBAAM,EAAC,aAAa,EAAE;QACrB,OAAO,EAAE,GAAW,EAAE,CAAC,OAAO;QAC9B,IAAI,EAAE,aAAa;KACpB,CAAC;sCACW,IAAI;+DAAC;sCA9DP,2BAA2B;IAPvC,IAAA,gBAAM,EAAC,0BAA0B,CAAC;IAClC,IAAA,eAAK,EACJ,qCAAqC,EACrC,gBAAgB,kDAA2B,CAAC,GAAG,CAAC,CAAC,MAAc,EAAU,EAAE,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACzG;IACA,IAAA,eAAK,EAAC,kCAAkC,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IACtE,IAAA,eAAK,EAAC,2CAA2C,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;GAC7D,2BAA2B,CA+DvC"}

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

@@ -0,0 +1,13 @@
+export * from './approval-instance-event.entity';
+export * from './instance-event.delivery-scheduler.service';
+export * from './instance-event.delivery.service';
+export * from './instance-event.delivery.subscriber';
+export * from './instance-event.enums';
+export * from './instance-event.module';
+export * from './instance-event.object';
+export * from './instance-event.options';
+export * from './instance-event.resolver';
+export * from './instance-event.service';
+export * from './instance-event.token';
+export * from './instance-event.types';
+export * from './instance-event.writer';

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./approval-instance-event.entity"), exports);
+tslib_1.__exportStar(require("./instance-event.delivery-scheduler.service"), exports);
+tslib_1.__exportStar(require("./instance-event.delivery.service"), exports);
+tslib_1.__exportStar(require("./instance-event.delivery.subscriber"), exports);
+tslib_1.__exportStar(require("./instance-event.enums"), exports);
+tslib_1.__exportStar(require("./instance-event.module"), exports);
+tslib_1.__exportStar(require("./instance-event.object"), exports);
+tslib_1.__exportStar(require("./instance-event.options"), exports);
+tslib_1.__exportStar(require("./instance-event.resolver"), exports);
+tslib_1.__exportStar(require("./instance-event.service"), exports);
+tslib_1.__exportStar(require("./instance-event.token"), exports);
+tslib_1.__exportStar(require("./instance-event.types"), exports);
+tslib_1.__exportStar(require("./instance-event.writer"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/instance-event/index.ts"],"names":[],"mappings":";;;AAAA,2EAAiD;AACjD,sFAA4D;AAC5D,4EAAkD;AAClD,+EAAqD;AACrD,iEAAuC;AACvC,kEAAwC;AACxC,kEAAwC;AACxC,mEAAyC;AACzC,oEAA0C;AAC1C,mEAAyC;AACzC,iEAAuC;AACvC,iEAAuC;AACvC,kEAAwC"}

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

@@ -0,0 +1,21 @@
+import { OnApplicationBootstrap, OnApplicationShutdown } from '@nestjs/common';
+import { InstanceEventDeliveryService } from './instance-event.delivery.service';
+import { InstanceEventService } from './instance-event.service';
+/**
+ * The fallback that retries failed attempts, releases rows the commit kick
+ * missed (ADR 27 §1.3), and sweeps delivered rows past retention. `SKIP LOCKED`
+ * in the claim lets several API instances run it at once.
+ */
+export declare class InstanceEventDeliverySchedulerService implements OnApplicationBootstrap, OnApplicationShutdown {
+    private readonly deliveryService;
+    private readonly events;
+    private readonly logger;
+    private timer;
+    private scanning;
+    private lastPurgeAt;
+    constructor(deliveryService: InstanceEventDeliveryService, events: InstanceEventService);
+    onApplicationBootstrap(): void;
+    onApplicationShutdown(): void;
+    scan(): Promise<void>;
+    private purgeIfDue;
+}

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

@@ -0,0 +1,81 @@
+"use strict";
+var InstanceEventDeliverySchedulerService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceEventDeliverySchedulerService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const instance_event_delivery_service_1 = require("./instance-event.delivery.service");
+const instance_event_service_1 = require("./instance-event.service");
+/** Retention sweeps are cheap but not urgent; once an hour is plenty. */
+const PURGE_INTERVAL_MS = 3_600_000;
+/**
+ * The fallback that retries failed attempts, releases rows the commit kick
+ * missed (ADR 27 §1.3), and sweeps delivered rows past retention. `SKIP LOCKED`
+ * in the claim lets several API instances run it at once.
+ */
+let InstanceEventDeliverySchedulerService = InstanceEventDeliverySchedulerService_1 = class InstanceEventDeliverySchedulerService {
+    constructor(deliveryService, events) {
+        this.deliveryService = deliveryService;
+        this.events = events;
+        this.logger = new common_1.Logger(InstanceEventDeliverySchedulerService_1.name);
+        this.timer = null;
+        this.scanning = false;
+        this.lastPurgeAt = 0;
+    }
+    onApplicationBootstrap() {
+        // Without an observer there is nothing to deliver to, so no idle timer.
+        if (process.env.NODE_ENV === 'test' || !this.events.enabled) {
+            return;
+        }
+        this.timer = setInterval(() => {
+            void this.scan();
+        }, this.events.delivery.scanIntervalMs);
+        this.timer.unref();
+    }
+    onApplicationShutdown() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    async scan() {
+        // A slow observer must not stack scans on top of each other.
+        if (this.scanning) {
+            return;
+        }
+        this.scanning = true;
+        try {
+            const count = await this.deliveryService.deliverDue();
+            if (count) {
+                this.logger.log(`Attempted ${count} instance event deliveries`);
+            }
+            await this.purgeIfDue(Date.now());
+        }
+        catch (error) {
+            this.logger.error(error instanceof Error
+                ? error.message
+                : 'Instance event delivery scan failed');
+        }
+        finally {
+            this.scanning = false;
+        }
+    }
+    async purgeIfDue(now) {
+        if (now - this.lastPurgeAt < PURGE_INTERVAL_MS) {
+            return;
+        }
+        // Stamped before the call, so a failing sweep is not retried every scan.
+        this.lastPurgeAt = now;
+        const purged = await this.deliveryService.purgeDelivered(new Date(now));
+        if (purged) {
+            this.logger.log(`Purged ${purged} delivered instance events`);
+        }
+    }
+};
+exports.InstanceEventDeliverySchedulerService = InstanceEventDeliverySchedulerService;
+exports.InstanceEventDeliverySchedulerService = InstanceEventDeliverySchedulerService = InstanceEventDeliverySchedulerService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [instance_event_delivery_service_1.InstanceEventDeliveryService,
+        instance_event_service_1.InstanceEventService])
+], InstanceEventDeliverySchedulerService);
+//# sourceMappingURL=instance-event.delivery-scheduler.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instance-event.delivery-scheduler.service.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/instance-event/instance-event.delivery-scheduler.service.ts"],"names":[],"mappings":";;;;;AAAA,2CAKwB;AACxB,uFAAiF;AACjF,qEAAgE;AAEhE,yEAAyE;AACzE,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAEpC;;;;GAIG;AAEI,IAAM,qCAAqC,6CAA3C,MAAM,qCAAqC;IAUhD,YACmB,eAA6C,EAC7C,MAA4B;QAD5B,oBAAe,GAAf,eAAe,CAA8B;QAC7C,WAAM,GAAN,MAAM,CAAsB;QAT9B,WAAM,GAAG,IAAI,eAAM,CAClC,uCAAqC,CAAC,IAAI,CAC3C,CAAC;QACM,UAAK,GAA0B,IAAI,CAAC;QACpC,aAAQ,GAAG,KAAK,CAAC;QACjB,gBAAW,GAAG,CAAC,CAAC;IAKrB,CAAC;IAEJ,sBAAsB;QACpB,wEAAwE;QACxE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAS,EAAE;YAClC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,qBAAqB;QACnB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,6DAA6D;QAC7D,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC;YAEtD,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,KAAK,4BAA4B,CAAC,CAAC;YAClE,CAAC;YAED,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,KAAK,YAAY,KAAK;gBACpB,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,qCAAqC,CAC1C,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,GAAW;QAClC,IAAI,GAAG,GAAG,IAAI,CAAC,WAAW,GAAG,iBAAiB,EAAE,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,yEAAyE;QACzE,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QAEvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAExE,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,MAAM,4BAA4B,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;CACF,CAAA;AA3EY,sFAAqC;gDAArC,qCAAqC;IADjD,IAAA,mBAAU,GAAE;6CAYyB,8DAA4B;QACrC,6CAAoB;GAZpC,qCAAqC,CA2EjD"}

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

@@ -0,0 +1,69 @@
+import { Repository } from 'typeorm';
+import { ApprovalInstanceEventEntity } from './approval-instance-event.entity';
+import { InstanceEventService } from './instance-event.service';
+import type { BPMInstanceEventStatus } from './instance-event.types';
+export interface ListInstanceEventsInput {
+    readonly instanceId: string | null;
+    readonly page: number;
+    readonly pageSize: number;
+    readonly status: BPMInstanceEventStatus | null;
+}
+/**
+ * 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.
+ */
+export declare class InstanceEventDeliveryService {
+    private readonly repository;
+    private readonly events;
+    private readonly logger;
+    constructor(repository: Repository<ApprovalInstanceEventEntity>, events: InstanceEventService);
+    /**
+     * Claims and delivers due rows across all instances, up to `batchSize`.
+     * Returns the number of rows attempted. No-op without a bound observer.
+     */
+    deliverDue(now?: Date): Promise<number>;
+    /**
+     * 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.
+     */
+    deliverByIds(ids: readonly string[], now?: Date): Promise<number>;
+    /**
+     * Deletes `DELIVERED` rows older than `retentionDays`. `FAILED` rows are kept
+     * until an operator retries or removes them. Returns the number deleted.
+     */
+    purgeDelivered(now?: Date): Promise<number>;
+    /**
+     * Admin read: newest first, optionally filtered. Not gated by `enabled`, so
+     * rows left behind by an earlier deployment stay visible.
+     */
+    listEvents(input: ListInstanceEventsInput): Promise<{
+        readonly items: readonly ApprovalInstanceEventEntity[];
+        readonly total: number;
+    }>;
+    /**
+     * 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.
+     */
+    retryFailedEvent(id: string, now?: Date): Promise<ApprovalInstanceEventEntity>;
+    /**
+     * `base * 2^(attempt - 1)` with ±20 % jitter, capped at `maxRetryDelayMs`.
+     * Same policy as the webhook outbox.
+     */
+    readRetryDelay(attempt: number): number;
+    private claim;
+    private attemptSafely;
+    private attempt;
+    private dispatch;
+    private writeOutcome;
+    private readStaleClaimMs;
+}

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