@rytass/bpm-core-nestjs-module 0.5.0 → 0.5.1

package/src/lib/notification/notification.mutations.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationMutations = void 0;
+const tslib_1 = require("tslib");
+const graphql_1 = require("@nestjs/graphql");
+const bpm_auth_1 = require("../bpm-auth");
+const notification_preference_input_1 = require("./dto/notification-preference.input");
+const notification_preference_entity_1 = require("./notification-preference.entity");
+const notification_entity_1 = require("./notification.entity");
+const notification_service_1 = require("./notification.service");
+let NotificationMutations = class NotificationMutations {
+    constructor(notificationService) {
+        this.notificationService = notificationService;
+    }
+    async markNotificationRead(id, readerMemberId, currentMemberId) {
+        return this.notificationService.markNotificationRead({
+            id,
+            readerMemberId: currentMemberId ?? readerMemberId ?? null,
+        });
+    }
+    async markAllNotificationsRead(currentMemberId, recipientMemberId) {
+        return this.notificationService.markAllNotificationsRead({
+            recipientMemberId: currentMemberId ?? recipientMemberId ?? '',
+        });
+    }
+    async updateNotificationPreference(input, currentMemberId) {
+        return this.notificationService.updatePreference({
+            ...input,
+            memberId: currentMemberId,
+        });
+    }
+};
+exports.NotificationMutations = NotificationMutations;
+tslib_1.__decorate([
+    (0, graphql_1.Mutation)(() => notification_entity_1.NotificationEntity),
+    tslib_1.__param(0, (0, graphql_1.Args)('id', { type: () => String })),
+    tslib_1.__param(1, (0, graphql_1.Args)('readerMemberId', { nullable: true, type: () => String })),
+    tslib_1.__param(2, (0, bpm_auth_1.BPMCurrentMemberId)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], NotificationMutations.prototype, "markNotificationRead", null);
+tslib_1.__decorate([
+    (0, graphql_1.Mutation)(() => graphql_1.Int),
+    tslib_1.__param(0, (0, bpm_auth_1.BPMCurrentMemberId)()),
+    tslib_1.__param(1, (0, graphql_1.Args)('recipientMemberId', { nullable: true, type: () => String })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], NotificationMutations.prototype, "markAllNotificationsRead", null);
+tslib_1.__decorate([
+    (0, graphql_1.Mutation)(() => notification_preference_entity_1.NotificationPreferenceEntity),
+    tslib_1.__param(0, (0, graphql_1.Args)('input')),
+    tslib_1.__param(1, (0, bpm_auth_1.BPMCurrentMemberId)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [notification_preference_input_1.UpdateNotificationPreferenceInput, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], NotificationMutations.prototype, "updateNotificationPreference", null);
+exports.NotificationMutations = NotificationMutations = tslib_1.__decorate([
+    (0, graphql_1.Resolver)(),
+    (0, bpm_auth_1.BPMAuthenticated)(),
+    tslib_1.__metadata("design:paramtypes", [notification_service_1.NotificationService])
+], NotificationMutations);
+//# sourceMappingURL=notification.mutations.js.map

package/src/lib/notification/notification.mutations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.mutations.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/notification/notification.mutations.ts"],"names":[],"mappings":";;;;AAAA,6CAAgE;AAChE,0CAAmE;AACnE,uFAAwF;AACxF,qFAAgF;AAChF,+DAA2D;AAC3D,iEAA6D;AAItD,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YAA6B,mBAAwC;QAAxC,wBAAmB,GAAnB,mBAAmB,CAAqB;IAAG,CAAC;IAGnE,AAAN,KAAK,CAAC,oBAAoB,CACY,EAAU,EAE9C,cAA8B,EACR,eAAwB;QAE9C,OAAO,IAAI,CAAC,mBAAmB,CAAC,oBAAoB,CAAC;YACnD,EAAE;YACF,cAAc,EAAE,eAAe,IAAI,cAAc,IAAI,IAAI;SAC1D,CAAC,CAAC;IACL,CAAC;IAGK,AAAN,KAAK,CAAC,wBAAwB,CACN,eAAuB,EAE7C,iBAAiC;QAEjC,OAAO,IAAI,CAAC,mBAAmB,CAAC,wBAAwB,CAAC;YACvD,iBAAiB,EAAE,eAAe,IAAI,iBAAiB,IAAI,EAAE;SAC9D,CAAC,CAAC;IACL,CAAC;IAGK,AAAN,KAAK,CAAC,4BAA4B,CACjB,KAAwC,EACjC,eAAuB;QAE7C,OAAO,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC;YAC/C,GAAG,KAAK;YACR,QAAQ,EAAE,eAAe;SAC1B,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AArCY,sDAAqB;AAI1B;IADL,IAAA,kBAAQ,EAAC,GAAG,EAAE,CAAC,wCAAkB,CAAC;IAEhC,mBAAA,IAAA,cAAI,EAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAA;IAClC,mBAAA,IAAA,cAAI,EAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAA;IAE9D,mBAAA,IAAA,6BAAkB,GAAE,CAAA;;;;iEAMtB;AAGK;IADL,IAAA,kBAAQ,EAAC,GAAG,EAAE,CAAC,aAAG,CAAC;IAEjB,mBAAA,IAAA,6BAAkB,GAAE,CAAA;IACpB,mBAAA,IAAA,cAAI,EAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAA;;;;qEAMnE;AAGK;IADL,IAAA,kBAAQ,EAAC,GAAG,EAAE,CAAC,6DAA4B,CAAC;IAE1C,mBAAA,IAAA,cAAI,EAAC,OAAO,CAAC,CAAA;IACb,mBAAA,IAAA,6BAAkB,GAAE,CAAA;;6CADC,iEAAiC;;yEAOxD;gCApCU,qBAAqB;IAFjC,IAAA,kBAAQ,GAAE;IACV,IAAA,2BAAgB,GAAE;6CAEiC,0CAAmB;GAD1D,qBAAqB,CAqCjC"}

package/src/lib/notification/notification.queries.d.ts

@@ -0,0 +1,11 @@
+import { NotificationPreferenceEntity } from './notification-preference.entity';
+import { NotificationEntity } from './notification.entity';
+import { NotificationService } from './notification.service';
+export declare class NotificationQueries {
+    private readonly notificationService;
+    constructor(notificationService: NotificationService);
+    notifications(recipientMemberId: string, includeRead?: boolean | null, page?: number | null, pageSize?: number | null, currentMemberId?: string): Promise<readonly NotificationEntity[]>;
+    notificationCount(recipientMemberId: string, includeRead?: boolean | null, currentMemberId?: string): Promise<number>;
+    unreadNotificationCount(recipientMemberId: string, currentMemberId?: string): Promise<number>;
+    notificationPreference(memberId: string, currentMemberId?: string): Promise<NotificationPreferenceEntity>;
+}

package/src/lib/notification/notification.queries.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationQueries = void 0;
+const tslib_1 = require("tslib");
+const graphql_1 = require("@nestjs/graphql");
+const bpm_auth_1 = require("../bpm-auth");
+const notification_preference_entity_1 = require("./notification-preference.entity");
+const notification_entity_1 = require("./notification.entity");
+const notification_service_1 = require("./notification.service");
+let NotificationQueries = class NotificationQueries {
+    constructor(notificationService) {
+        this.notificationService = notificationService;
+    }
+    async notifications(recipientMemberId, includeRead, page, pageSize, currentMemberId) {
+        return this.notificationService.listNotifications({
+            includeRead: includeRead ?? false,
+            page: page ?? 1,
+            pageSize: pageSize ?? 10,
+            recipientMemberId: currentMemberId ?? recipientMemberId,
+        });
+    }
+    async notificationCount(recipientMemberId, includeRead, currentMemberId) {
+        return this.notificationService.countNotifications({
+            includeRead: includeRead ?? false,
+            recipientMemberId: currentMemberId ?? recipientMemberId,
+        });
+    }
+    async unreadNotificationCount(recipientMemberId, currentMemberId) {
+        return this.notificationService.countUnreadNotifications(currentMemberId ?? recipientMemberId);
+    }
+    async notificationPreference(memberId, currentMemberId) {
+        return this.notificationService.getPreference(currentMemberId ?? memberId);
+    }
+};
+exports.NotificationQueries = NotificationQueries;
+tslib_1.__decorate([
+    (0, graphql_1.Query)(() => [notification_entity_1.NotificationEntity]),
+    tslib_1.__param(0, (0, graphql_1.Args)('recipientMemberId', { type: () => String })),
+    tslib_1.__param(1, (0, graphql_1.Args)('includeRead', { nullable: true, type: () => Boolean })),
+    tslib_1.__param(2, (0, graphql_1.Args)('page', { nullable: true, type: () => graphql_1.Int })),
+    tslib_1.__param(3, (0, graphql_1.Args)('pageSize', { nullable: true, type: () => graphql_1.Int })),
+    tslib_1.__param(4, (0, bpm_auth_1.BPMCurrentMemberId)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object, Object, Object, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], NotificationQueries.prototype, "notifications", null);
+tslib_1.__decorate([
+    (0, graphql_1.Query)(() => graphql_1.Int),
+    tslib_1.__param(0, (0, graphql_1.Args)('recipientMemberId', { type: () => String })),
+    tslib_1.__param(1, (0, graphql_1.Args)('includeRead', { nullable: true, type: () => Boolean })),
+    tslib_1.__param(2, (0, bpm_auth_1.BPMCurrentMemberId)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], NotificationQueries.prototype, "notificationCount", null);
+tslib_1.__decorate([
+    (0, graphql_1.Query)(() => graphql_1.Int),
+    tslib_1.__param(0, (0, graphql_1.Args)('recipientMemberId', { type: () => String })),
+    tslib_1.__param(1, (0, bpm_auth_1.BPMCurrentMemberId)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], NotificationQueries.prototype, "unreadNotificationCount", null);
+tslib_1.__decorate([
+    (0, graphql_1.Query)(() => notification_preference_entity_1.NotificationPreferenceEntity),
+    tslib_1.__param(0, (0, graphql_1.Args)('memberId', { type: () => String })),
+    tslib_1.__param(1, (0, bpm_auth_1.BPMCurrentMemberId)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], NotificationQueries.prototype, "notificationPreference", null);
+exports.NotificationQueries = NotificationQueries = tslib_1.__decorate([
+    (0, graphql_1.Resolver)(),
+    (0, bpm_auth_1.BPMAuthenticated)(),
+    tslib_1.__metadata("design:paramtypes", [notification_service_1.NotificationService])
+], NotificationQueries);
+//# sourceMappingURL=notification.queries.js.map

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

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

package/src/lib/notification/notification.service.d.ts

@@ -0,0 +1,121 @@
+import { ServiceTaskNode, UserTaskNode } from '@rytass/bpm-core-shared/workflow';
+import { ModuleRef } from '@nestjs/core';
+import { EntityManager, Repository } from 'typeorm';
+import { ActivityLogEntity } from '../workflow-engine/activity-log.entity';
+import { ApprovalInstanceEntity } from '../workflow-engine/approval-instance.entity';
+import { TaskCandidateEntity } from '../workflow-engine/task-candidate.entity';
+import { TaskEntity } from '../workflow-engine/task.entity';
+import { NotificationDeliveryService } from './notification-delivery.service';
+import { NotificationPreferenceEntity } from './notification-preference.entity';
+import { NotificationEntity } from './notification.entity';
+import { NotificationChannelEnum, NotificationResolutionEnum } from './notification.enums';
+import { BPMResolvedNotificationOptions } from './notification-options';
+import { UpdateNotificationPreferenceInput } from './dto/notification-preference.input';
+interface SlaScanResult {
+    readonly overdueCount: number;
+    readonly warningCount: number;
+}
+export declare class NotificationService {
+    private readonly notificationRepository;
+    private readonly notificationPreferenceRepository;
+    private readonly taskRepository;
+    private readonly taskCandidateRepository;
+    private readonly approvalInstanceRepository;
+    private readonly activityLogRepository;
+    private readonly deliveryService;
+    private readonly moduleRef;
+    private readonly notificationOptions;
+    private readonly logger;
+    constructor(notificationRepository: Repository<NotificationEntity>, notificationPreferenceRepository: Repository<NotificationPreferenceEntity>, taskRepository: Repository<TaskEntity>, taskCandidateRepository: Repository<TaskCandidateEntity>, approvalInstanceRepository: Repository<ApprovalInstanceEntity>, activityLogRepository: Repository<ActivityLogEntity>, deliveryService: NotificationDeliveryService, moduleRef: ModuleRef, notificationOptions?: BPMResolvedNotificationOptions);
+    listNotifications({ includeRead, page, pageSize, recipientMemberId, }: {
+        readonly includeRead?: boolean;
+        readonly page?: number;
+        readonly pageSize?: number;
+        readonly recipientMemberId: string;
+    }): Promise<readonly NotificationEntity[]>;
+    countNotifications({ includeRead, recipientMemberId, }: {
+        readonly includeRead?: boolean;
+        readonly recipientMemberId: string;
+    }): Promise<number>;
+    countUnreadNotifications(recipientMemberId: string): Promise<number>;
+    markAllNotificationsRead({ recipientMemberId, }: {
+        readonly recipientMemberId: string;
+    }): Promise<number>;
+    markNotificationRead({ id, readerMemberId, }: {
+        readonly id: string;
+        readonly readerMemberId: string | null;
+    }): Promise<NotificationEntity>;
+    getPreference(memberId: string): Promise<NotificationPreferenceEntity>;
+    updatePreference(input: UpdateNotificationPreferenceInput): Promise<NotificationPreferenceEntity>;
+    createTaskAssignedNotification({ instance, manager, node, task, transferred, }: {
+        readonly instance: ApprovalInstanceEntity;
+        readonly manager: EntityManager;
+        readonly node: UserTaskNode;
+        readonly task: TaskEntity;
+        readonly transferred?: boolean;
+    }): Promise<readonly NotificationEntity[]>;
+    createServiceTaskNotifications({ instance, manager, node, recipientMemberIds, }: {
+        readonly instance: ApprovalInstanceEntity;
+        readonly manager: EntityManager;
+        readonly node: ServiceTaskNode;
+        readonly recipientMemberIds: readonly string[];
+    }): Promise<readonly NotificationEntity[]>;
+    /**
+     * Deliver an ad-hoc directive notification (STAGE_NOTIFY /
+     * COMPLETION_NOTIFY) to resolved member recipients. Runs inside the
+     * caller's transaction `manager` so it commits atomically with the
+     * workflow state change that triggered it.
+     */
+    createAdhocWorkflowNotifications({ channels, instance, manager, message, payload, recipientMemberIds, }: {
+        readonly channels: readonly NotificationChannelEnum[] | null;
+        readonly instance: ApprovalInstanceEntity;
+        readonly manager: EntityManager;
+        readonly message: string;
+        readonly payload: Readonly<Record<string, unknown>>;
+        readonly recipientMemberIds: readonly string[];
+    }): Promise<readonly NotificationEntity[]>;
+    createInstanceCompletedNotification({ instance, manager, }: {
+        readonly instance: ApprovalInstanceEntity;
+        readonly manager: EntityManager;
+    }): Promise<readonly NotificationEntity[]>;
+    /**
+     * Resolve the open task-assignment notifications for a decided task, so the
+     * inline 同意/拒絕 actions stop being offered once the task no longer needs
+     * the recipient. The acting member's notification records the actual
+     * decision (`resolution`); every other candidate's notification is marked
+     * `SUPERSEDED` when the task has ended. Runs inside the caller's
+     * transaction `manager` so it commits atomically with the decision.
+     */
+    resolveTaskNotifications({ actingMemberId, manager, resolution, supersedeOthers, taskId, }: {
+        readonly actingMemberId: string;
+        readonly manager: EntityManager;
+        readonly resolution: NotificationResolutionEnum;
+        readonly supersedeOthers: boolean;
+        readonly taskId: string;
+    }): Promise<void>;
+    /**
+     * Mark every still-open task-assignment notification for an instance as
+     * `SUPERSEDED` — used when the whole instance is cancelled, so lingering
+     * "待簽" notifications can no longer be actioned. Runs inside the caller's
+     * transaction `manager`.
+     */
+    supersedeInstanceTaskNotifications({ instanceId, manager, }: {
+        readonly instanceId: string;
+        readonly manager: EntityManager;
+    }): Promise<void>;
+    runSlaScan(now?: Date): Promise<SlaScanResult>;
+    private tryClaimSlaTask;
+    private createSlaNotificationOnce;
+    private createNotifications;
+    private recordSlaActivity;
+    private runSlaTimeoutHook;
+    private executeSlaTimeoutAction;
+    private resolveTaskActorMemberId;
+    private resolveTaskRecipientMemberIds;
+    private resolveEscalationTargetMemberId;
+}
+export declare function calculateTaskSlaDueAt({ node, now, }: {
+    readonly node: UserTaskNode;
+    readonly now: Date;
+}): Date | null;
+export {};