@rytass/bpm-core-nestjs-module 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## 0.7.0 (2026-08-10)
+
+### 🚀 Features
+
+- **bpm-core:** lint the new SLA and return-behaviour node fields ([f10c0bb](https://github.com/Rytass/BPMCore/commit/f10c0bb))
+- **bpm-core:** enforce required return comments ([6cb288f](https://github.com/Rytass/BPMCore/commit/6cb288f))
+- **bpm-core:** resolve task SLA due dates through a host business calendar ([3cb9d4d](https://github.com/Rytass/BPMCore/commit/3cb9d4d))
+
+### 🩹 Fixes
+
+- **bpm-core:** stop SLA escalation from walking the whole management chain ([f7e4669](https://github.com/Rytass/BPMCore/commit/f7e4669))
+
+### ❤️ Thank You
+
+- Chia Yu Pai @fantasywind
+- Claude Opus 5 (1M context)
+
 # Changelog
 
 All notable changes to `@rytass/bpm-core-nestjs-module` are documented in this

package/README.md

@@ -811,6 +811,7 @@ BPMRootModule.forRootAsync({
 | `memberResolverProvider`                         | required                       | Provider for `BPM_MEMBER_RESOLVER`.                            |
 | `attachmentStorageProvider`                      | local `.storage/attachments`   | Host-provided `@rytass/storages` adapter.                      |
 | `workflowServiceTaskDispatcherProvider`          | built-in `fetch` dispatcher    | Host provider for executable workflow `WEBHOOK` service tasks. |
+| `businessCalendarProvider`                       | Monday–Friday calendar         | Host provider for `BPM_BUSINESS_CALENDAR`, used by `BUSINESS_DAY` SLAs. BPMCore ships no holiday data. |
 | `attachmentRoutePrefix`                          | `/attachments`                 | Drives both the BPM signed URL path and the Nest controller mount path for `AttachmentController`. Must be set at module wiring time (see "Attachment Storage" below). |
 | `attachmentStorageProviderId`                    | `local`                        | Value stored on attachment metadata for the active adapter.    |
 | `attachmentPublicBaseUrl`                        | `http://localhost:17603`       | Public base URL for signed attachment URLs.                    |
@@ -835,6 +836,7 @@ BPMRootModule.forRootAsync({
 | `notificationDeliveryRetryBaseDelayMs`           | `60000`                        | Base retry delay multiplied by attempt count.                  |
 | `notificationSlaSchedulerEnabled`                | `false`                        | Runs automatic SLA scan loop in this process.                  |
 | `notificationSlaScanIntervalMs`                  | `60000`                        | SLA scheduler interval.                                        |
+| `notificationSlaBusinessCalendarTimeZone`        | `UTC`                          | IANA zone for the built-in weekday calendar. Ignored when `businessCalendarProvider` is set. |
 | `notificationSlaTimeoutRemindEnabled`            | `true`                         | Enables SLA timeout `REMIND`.                                  |
 | `notificationSlaTimeoutAutoApproveEnabled`       | `false`                        | Enables SLA timeout `AUTO_APPROVE`.                            |
 | `notificationSlaTimeoutEscalateEnabled`          | `false`                        | Enables SLA timeout `ESCALATE`.                                |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rytass/bpm-core-nestjs-module",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Embeddable NestJS BPM approval workflow module: workflow engine, approval templates, forms, organization/member contracts, attachments, signatures, notifications, delegation, and TypeORM migrations.",
   "keywords": [
     "bpm",
@@ -42,6 +42,9 @@
       "bpm-auth": [
         "./src/lib/bpm-auth/index.d.ts"
       ],
+      "calendar": [
+        "./src/lib/calendar/index.d.ts"
+      ],
       "condition": [
         "./src/lib/condition/index.d.ts"
       ],
@@ -91,6 +94,10 @@
       "types": "./src/lib/bpm-auth/index.d.ts",
       "default": "./src/lib/bpm-auth/index.js"
     },
+    "./calendar": {
+      "types": "./src/lib/calendar/index.d.ts",
+      "default": "./src/lib/calendar/index.js"
+    },
     "./database": {
       "types": "./src/lib/database/index.d.ts",
       "default": "./src/lib/database/index.js"
@@ -141,8 +148,8 @@
     "@nestjs/core": "^11.0.0",
     "@nestjs/graphql": "^13.4.0",
     "@nestjs/typeorm": "^11.0.1",
-    "@rytass/bpm-core-shared": "^0.6.0",
-    "@rytass/secret-adapter-vault-nestjs": "^0.4.5 || ^0.5.0",
+    "@rytass/bpm-core-shared": "^0.7.0",
+    "@rytass/secret-adapter-vault-nestjs": "^0.4.5 || ^0.5.0 || ^0.6.0",
     "express": "^4.0.0 || ^5.0.0",
     "graphql": "^16.0.0",
     "reflect-metadata": "^0.1.13 || ^0.2.0",

package/src/index.d.ts

@@ -1,6 +1,7 @@
 export * from './lib/attachment';
 export * from './lib/bpm';
 export * from './lib/bpm-auth';
+export * from './lib/calendar';
 export * from './lib/common';
 export * from './lib/condition';
 export * from './lib/database';

package/src/index.js

@@ -4,6 +4,7 @@ const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./lib/attachment"), exports);
 tslib_1.__exportStar(require("./lib/bpm"), exports);
 tslib_1.__exportStar(require("./lib/bpm-auth"), exports);
+tslib_1.__exportStar(require("./lib/calendar"), exports);
 tslib_1.__exportStar(require("./lib/common"), exports);
 tslib_1.__exportStar(require("./lib/condition"), exports);
 tslib_1.__exportStar(require("./lib/database"), exports);

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/bpm-core/src/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,oDAA0B;AAC1B,yDAA+B;AAC/B,uDAA6B;AAC7B,0DAAgC;AAChC,yDAA+B;AAC/B,2DAAiC;AACjC,qDAA2B;AAC3B,yDAA+B;AAC/B,6DAAmC;AACnC,6DAAmC;AACnC,0DAAgC;AAChC,yDAA+B;AAC/B,gEAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/bpm-core/src/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,oDAA0B;AAC1B,yDAA+B;AAC/B,yDAA+B;AAC/B,uDAA6B;AAC7B,0DAAgC;AAChC,yDAA+B;AAC/B,2DAAiC;AACjC,qDAA2B;AAC3B,yDAA+B;AAC/B,6DAAmC;AACnC,6DAAmC;AACnC,0DAAgC;AAChC,yDAA+B;AAC/B,gEAAsC"}

package/src/lib/bpm/bpm-root.module.d.ts

@@ -3,6 +3,7 @@ import { ModuleMetadata } from '@nestjs/common/interfaces';
 import { BPMRootAttachmentOptions } from '../attachment/attachment-options';
 import { AttachmentStorage } from '../attachment/attachment-storage.token';
 import { BPMAuthModuleOptions } from '../bpm-auth/bpm-auth.options';
+import { BPMBusinessCalendar } from '../calendar/business-calendar.token';
 import { BPMRootIdentityOptions } from '../identity/identity-options';
 import { BPMMemberResolver } from '../identity/member-resolver.interface';
 import { BPMRootNotificationOptions } from '../notification/notification-options';
@@ -27,6 +28,16 @@ export interface BPMRootModuleOptions extends Pick<ModuleMetadata, 'imports'>, B
      * operations that require authentication will not receive a host session.
      */
     readonly authContextFactory?: BPMAuthModuleOptions['contextFactory'];
+    /**
+     * Host-provided business calendar used by workflow nodes whose SLA opts into
+     * `BUSINESS_DAY`.
+     *
+     * BPMCore ships no national holiday data. When omitted, BPM falls back to a
+     * Monday–Friday calendar (see `notificationSlaBusinessCalendarTimeZone`);
+     * hosts that need national holidays or make-up working days register their
+     * own `BPM_BUSINESS_CALENDAR` provider here.
+     */
+    readonly businessCalendarProvider?: Provider<BPMBusinessCalendar>;
     /**
      * Host-provided member resolver provider.
      *
@@ -72,6 +83,13 @@ export interface BPMRootModuleAsyncOptions extends Pick<ModuleMetadata, 'imports
      * use a Nest provider with `useFactory` / `inject` here.
      */
     readonly attachmentStorageProvider?: Provider<AttachmentStorage>;
+    /**
+     * Host-provided business calendar for `BUSINESS_DAY` SLAs.
+     *
+     * This provider is static at module wiring time. If secrets or a repository
+     * are required, use a Nest provider with `useFactory` / `inject` here.
+     */
+    readonly businessCalendarProvider?: Provider<BPMBusinessCalendar>;
     /**
      * Providers injected into `useFactory`.
      *

package/src/lib/bpm/bpm-root.module.js

@@ -6,6 +6,7 @@ const tslib_1 = require("tslib");
 const common_1 = require("@nestjs/common");
 const attachment_module_1 = require("../attachment/attachment.module");
 const bpm_auth_module_1 = require("../bpm-auth/bpm-auth.module");
+const calendar_module_1 = require("../calendar/calendar.module");
 const delegation_module_1 = require("../delegation/delegation.module");
 const form_module_1 = require("../form/form.module");
 const identity_module_1 = require("../identity/identity.module");
@@ -82,6 +83,7 @@ let BPMRootModule = BPMRootModule_1 = class BPMRootModule {
         return {
             exports: [
                 notification_options_module_1.NotificationOptionsModule,
+                calendar_module_1.CalendarModule,
                 bpm_auth_module_1.BPMAuthModule,
                 identity_module_1.IdentityModule,
                 organization_module_1.OrganizationModule,
@@ -99,6 +101,9 @@ let BPMRootModule = BPMRootModule_1 = class BPMRootModule {
                     inject: options.inject,
                     useFactory: options.useFactory,
                 }),
+                calendar_module_1.CalendarModule.forRoot({
+                    businessCalendarProvider: options.businessCalendarProvider,
+                }),
                 bpm_auth_module_1.BPMAuthModule.forRootAsync(authOptions),
                 identity_module_1.IdentityModule.forRootAsync({
                     imports: options.imports,
@@ -139,6 +144,9 @@ exports.BPMRootModule = BPMRootModule = BPMRootModule_1 = tslib_1.__decorate([
 function createBPMFeatureModules(options) {
     return [
         notification_options_module_1.NotificationOptionsModule.forRoot(options),
+        calendar_module_1.CalendarModule.forRoot({
+            businessCalendarProvider: options.businessCalendarProvider,
+        }),
         bpm_auth_module_1.BPMAuthModule.forRoot(createBPMAuthModuleOptions(options)),
         identity_module_1.IdentityModule.forRoot({
             ...options,

package/src/lib/bpm/bpm-root.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"bpm-root.module.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/bpm/bpm-root.module.ts"],"names":[],"mappings":";;;;;AAAA,2CAMwB;AAGxB,uEAAmE;AAEnE,iEAA4D;AAK5D,uEAAmE;AACnE,qDAAiD;AAEjD,iEAA6D;AAE7D,6EAAyE;AACzE,6FAAwF;AAExF,6EAAyE;AAEzE,oEAAgE;AAChE,iEAA6D;AAC7D,sFAAiF;AAiIjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEI,IAAM,aAAa,qBAAnB,MAAM,aAAa;IACxB;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,OAA6B;QAC1C,MAAM,cAAc,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAExD,OAAO;YACL,OAAO,EAAE,CAAC,GAAG,cAAc,CAAC;YAC5B,OAAO,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,cAAc,CAAC;YACxD,MAAM,EAAE,eAAa;SACtB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,YAAY,CAAC,OAAkC;QACpD,MAAM,WAAW,GAA8B;YAC7C,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,KAAK,EACf,GAAG,IAAwB,EACI,EAAE;gBACjC,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;gBAEtD,OAAO,0BAA0B,CAAC,WAAW,CAAC,CAAC;YACjD,CAAC;SACF,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP,uDAAyB;gBACzB,+BAAa;gBACb,gCAAc;gBACd,wCAAkB;gBAClB,oCAAgB;gBAChB,wBAAU;gBACV,gCAAc;gBACd,oCAAgB;gBAChB,wCAAkB;gBAClB,kCAAe;gBACf,6CAAoB;aACrB;YACD,OAAO,EAAE;gBACP,uDAAyB,CAAC,YAAY,CAAC;oBACrC,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,UAAU,EAAE,OAAO,CAAC,UAAU;iBAC/B,CAAC;gBACF,+BAAa,CAAC,YAAY,CAAC,WAAW,CAAC;gBACvC,gCAAc,CAAC,YAAY,CAAC;oBAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;oBACtD,UAAU,EAAE,OAAO,CAAC,UAAU;iBAC/B,CAAC;gBACF,wCAAkB;gBAClB,oCAAgB,CAAC,YAAY,CAAC;oBAC5B,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;oBACpD,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,eAAe,EAAE,OAAO,CAAC,yBAAyB;oBAClD,UAAU,EAAE,OAAO,CAAC,UAAU;iBAC/B,CAAC;gBACF,wBAAU;gBACV,gCAAc;gBACd,oCAAgB;gBAChB,wCAAkB;gBAClB,kCAAe,CAAC,YAAY,CAAC;oBAC3B,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,UAAU,EAAE,OAAO,CAAC,UAAU;iBAC/B,CAAC;gBACF,6CAAoB,CAAC,OAAO,CAAC;oBAC3B,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,6BAA6B,EAC3B,OAAO,CAAC,qCAAqC;iBAChD,CAAC;aACH;YACD,MAAM,EAAE,eAAa;SACtB,CAAC;IACJ,CAAC;CACF,CAAA;AA7FY,sCAAa;wBAAb,aAAa;IADzB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,aAAa,CA6FzB;AAED,SAAS,uBAAuB,CAC9B,OAA6B;IAE7B,OAAO;QACL,uDAAyB,CAAC,OAAO,CAAC,OAAO,CAAC;QAC1C,+BAAa,CAAC,OAAO,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC;QAC1D,gCAAc,CAAC,OAAO,CAAC;YACrB,GAAG,OAAO;YACV,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;SACvD,CAAC;QACF,wCAAkB;QAClB,oCAAgB,CAAC,OAAO,CAAC;YACvB,GAAG,OAAO;YACV,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,eAAe,EAAE,OAAO,CAAC,yBAAyB;SACnD,CAAC;QACF,wBAAU;QACV,gCAAc;QACd,oCAAgB;QAChB,wCAAkB;QAClB,kCAAe,CAAC,OAAO,CAAC,OAAO,CAAC;QAChC,6CAAoB,CAAC,OAAO,CAAC;YAC3B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,6BAA6B,EAC3B,OAAO,CAAC,qCAAqC;SAChD,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CACjC,OAAgE;IAEhE,OAAO;QACL,cAAc,EAAE,OAAO,CAAC,kBAAkB;KAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"bpm-root.module.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/bpm/bpm-root.module.ts"],"names":[],"mappings":"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"}

package/src/lib/calendar/business-calendar.provider.d.ts

@@ -0,0 +1,11 @@
+import { Provider } from '@nestjs/common';
+import { BPMBusinessCalendar } from './business-calendar.token';
+/**
+ * Default {@link BPMBusinessCalendar} used when the host registers none.
+ *
+ * Treats Monday–Friday as working days in the time zone configured through
+ * `notificationSlaBusinessCalendarTimeZone`, and knows about no holidays. Hosts
+ * that need national holidays or make-up working days replace this provider via
+ * `BPMRootModule`'s `businessCalendarProvider`.
+ */
+export declare const defaultBusinessCalendarProvider: Provider<BPMBusinessCalendar>;

package/src/lib/calendar/business-calendar.provider.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultBusinessCalendarProvider = void 0;
+const notification_options_1 = require("../notification/notification-options");
+const business_calendar_token_1 = require("./business-calendar.token");
+const weekday_business_calendar_1 = require("./weekday-business-calendar");
+/**
+ * Default {@link BPMBusinessCalendar} used when the host registers none.
+ *
+ * Treats Monday–Friday as working days in the time zone configured through
+ * `notificationSlaBusinessCalendarTimeZone`, and knows about no holidays. Hosts
+ * that need national holidays or make-up working days replace this provider via
+ * `BPMRootModule`'s `businessCalendarProvider`.
+ */
+exports.defaultBusinessCalendarProvider = {
+    inject: [notification_options_1.BPM_NOTIFICATION_OPTIONS],
+    provide: business_calendar_token_1.BPM_BUSINESS_CALENDAR,
+    useFactory: (options) => new weekday_business_calendar_1.BPMWeekdayBusinessCalendar(options.slaBusinessCalendarTimeZone),
+};
+//# sourceMappingURL=business-calendar.provider.js.map

package/src/lib/calendar/business-calendar.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-calendar.provider.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/calendar/business-calendar.provider.ts"],"names":[],"mappings":";;;AACA,+EAG8C;AAC9C,uEAGmC;AACnC,2EAAyE;AAEzE;;;;;;;GAOG;AACU,QAAA,+BAA+B,GAAkC;IAC5E,MAAM,EAAE,CAAC,+CAAwB,CAAC;IAClC,OAAO,EAAE,+CAAqB;IAC9B,UAAU,EAAE,CACV,OAAuC,EAClB,EAAE,CACvB,IAAI,sDAA0B,CAAC,OAAO,CAAC,2BAA2B,CAAC;CACtE,CAAC"}

package/src/lib/calendar/business-calendar.token.d.ts

@@ -0,0 +1,38 @@
+import { InjectionToken } from '@nestjs/common';
+/**
+ * Host-provided business calendar used to resolve `BUSINESS_DAY` SLA due
+ * dates.
+ *
+ * BPMCore deliberately ships **no** national holiday data. A host that needs
+ * real working-day semantics (national holidays, make-up working Saturdays,
+ * company shutdown days) implements this contract against its own calendar
+ * source and registers it through `BPMRootModule`'s `businessCalendarProvider`.
+ *
+ * @example
+ * ```ts
+ * BPMRootModule.forRoot({
+ *   businessCalendarProvider: {
+ *     provide: BPM_BUSINESS_CALENDAR,
+ *     useClass: TaiwanBusinessCalendar,
+ *   },
+ *   // ...
+ * });
+ * ```
+ */
+export interface BPMBusinessCalendar {
+    /**
+     * IANA time zone the calendar's dates are expressed in, for example
+     * `Asia/Taipei`. BPM converts each instant to a local date in this zone
+     * before asking {@link BPMBusinessCalendar.isBusinessDay}, so day boundaries
+     * follow the host's calendar rather than the server's locale or UTC.
+     */
+    readonly timeZone: string;
+    /**
+     * Answers whether `localDate` is a working day.
+     *
+     * @param localDate Calendar date in `YYYY-MM-DD` form, already expressed in
+     * {@link BPMBusinessCalendar.timeZone}.
+     */
+    isBusinessDay(localDate: string): boolean | Promise<boolean>;
+}
+export declare const BPM_BUSINESS_CALENDAR: InjectionToken<BPMBusinessCalendar>;

package/src/lib/calendar/business-calendar.token.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BPM_BUSINESS_CALENDAR = void 0;
+exports.BPM_BUSINESS_CALENDAR = Symbol('BPM_BUSINESS_CALENDAR');
+//# sourceMappingURL=business-calendar.token.js.map

package/src/lib/calendar/business-calendar.token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-calendar.token.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/calendar/business-calendar.token.ts"],"names":[],"mappings":";;;AAwCa,QAAA,qBAAqB,GAChC,MAAM,CAAC,uBAAuB,CAAC,CAAC"}

package/src/lib/calendar/calendar.module.d.ts

@@ -0,0 +1,18 @@
+import { DynamicModule, Provider } from '@nestjs/common';
+import { BPMBusinessCalendar } from './business-calendar.token';
+export interface CalendarModuleOptions {
+    /**
+     * Host-provided business calendar. When omitted, BPM falls back to a
+     * Monday–Friday calendar with no holiday knowledge.
+     */
+    readonly businessCalendarProvider?: Provider<BPMBusinessCalendar>;
+}
+/**
+ * Supplies SLA scheduling to every BPM module.
+ *
+ * Global because the workflow engine computes due dates while creating tasks
+ * and hosts should not have to thread the calendar through each feature module.
+ */
+export declare class CalendarModule {
+    static forRoot(options?: CalendarModuleOptions): DynamicModule;
+}

package/src/lib/calendar/calendar.module.js

@@ -0,0 +1,32 @@
+"use strict";
+var CalendarModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalendarModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const business_calendar_provider_1 = require("./business-calendar.provider");
+const sla_schedule_service_1 = require("./sla-schedule.service");
+/**
+ * Supplies SLA scheduling to every BPM module.
+ *
+ * Global because the workflow engine computes due dates while creating tasks
+ * and hosts should not have to thread the calendar through each feature module.
+ */
+let CalendarModule = CalendarModule_1 = class CalendarModule {
+    static forRoot(options = {}) {
+        return {
+            exports: [sla_schedule_service_1.BPMSlaScheduleService],
+            module: CalendarModule_1,
+            providers: [
+                options.businessCalendarProvider ?? business_calendar_provider_1.defaultBusinessCalendarProvider,
+                sla_schedule_service_1.BPMSlaScheduleService,
+            ],
+        };
+    }
+};
+exports.CalendarModule = CalendarModule;
+exports.CalendarModule = CalendarModule = CalendarModule_1 = tslib_1.__decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], CalendarModule);
+//# sourceMappingURL=calendar.module.js.map

package/src/lib/calendar/calendar.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.module.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/calendar/calendar.module.ts"],"names":[],"mappings":";;;;;AAAA,2CAAyE;AAEzE,6EAA+E;AAC/E,iEAA+D;AAU/D;;;;;GAKG;AAGI,IAAM,cAAc,sBAApB,MAAM,cAAc;IACzB,MAAM,CAAC,OAAO,CAAC,UAAiC,EAAE;QAChD,OAAO;YACL,OAAO,EAAE,CAAC,4CAAqB,CAAC;YAChC,MAAM,EAAE,gBAAc;YACtB,SAAS,EAAE;gBACT,OAAO,CAAC,wBAAwB,IAAI,4DAA+B;gBACnE,4CAAqB;aACtB;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AAXY,wCAAc;yBAAd,cAAc;IAF1B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,cAAc,CAW1B"}

package/src/lib/calendar/index.d.ts

@@ -0,0 +1,5 @@
+export * from './business-calendar.provider';
+export * from './business-calendar.token';
+export * from './calendar.module';
+export * from './sla-schedule.service';
+export * from './weekday-business-calendar';

package/src/lib/calendar/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./business-calendar.provider"), exports);
+tslib_1.__exportStar(require("./business-calendar.token"), exports);
+tslib_1.__exportStar(require("./calendar.module"), exports);
+tslib_1.__exportStar(require("./sla-schedule.service"), exports);
+tslib_1.__exportStar(require("./weekday-business-calendar"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/calendar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/calendar/index.ts"],"names":[],"mappings":";;;AAAA,uEAA6C;AAC7C,oEAA0C;AAC1C,4DAAkC;AAClC,iEAAuC;AACvC,sEAA4C"}

package/src/lib/calendar/sla-schedule.service.d.ts

@@ -0,0 +1,33 @@
+import { UserTaskNode } from '@rytass/bpm-core-shared/workflow';
+import { BPMBusinessCalendar } from './business-calendar.token';
+/**
+ * Resolves task SLA due dates, honouring {@link SlaConfig.calendar}.
+ *
+ * `CALENDAR` (the default) adds the ISO duration as elapsed wall time —
+ * identical to BPM's pre-0.7.0 behaviour. `BUSINESS_DAY` advances the duration's
+ * day component across business days only, asking the host-provided
+ * {@link BPMBusinessCalendar} about each candidate date; any sub-day component
+ * is then added as plain elapsed time on top of the resolved business day.
+ */
+export declare class BPMSlaScheduleService {
+    private readonly businessCalendar;
+    private readonly logger;
+    private readonly dateFormatter;
+    constructor(businessCalendar: BPMBusinessCalendar);
+    resolveTaskSlaDueAt({ node, now, }: {
+        readonly node: UserTaskNode;
+        readonly now: Date;
+    }): Promise<Date | null>;
+    /**
+     * Walks forward one calendar day at a time from `now`, consuming one unit of
+     * `businessDays` for each date the host calendar reports as a working day,
+     * and returns how many calendar days were stepped.
+     *
+     * The starting date is never counted: an SLA of "1 business day" always lands
+     * on the *next* working day, whether the task was raised on a Monday or on a
+     * Saturday.
+     */
+    private countCalendarDaysForBusinessDays;
+    /** Formats an instant as a `YYYY-MM-DD` date in the calendar's time zone. */
+    private readLocalDate;
+}

package/src/lib/calendar/sla-schedule.service.js

@@ -0,0 +1,94 @@
+"use strict";
+var BPMSlaScheduleService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BPMSlaScheduleService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const iso_duration_1 = require("../common/iso-duration");
+const business_calendar_token_1 = require("./business-calendar.token");
+/**
+ * Upper bound on how far the business-day search may walk before giving up.
+ *
+ * A host calendar that reports every date as a non-business day would
+ * otherwise loop forever (and, when the calendar is database-backed, issue one
+ * query per step). The allowance is generous enough for weekends plus a long
+ * holiday season, and capped so a misconfigured calendar degrades quickly.
+ */
+const MAX_BUSINESS_DAY_SCAN_STEPS = 400;
+function readBusinessDayScanLimit(days) {
+    return Math.min(days * 7 + 60, MAX_BUSINESS_DAY_SCAN_STEPS);
+}
+/**
+ * Resolves task SLA due dates, honouring {@link SlaConfig.calendar}.
+ *
+ * `CALENDAR` (the default) adds the ISO duration as elapsed wall time —
+ * identical to BPM's pre-0.7.0 behaviour. `BUSINESS_DAY` advances the duration's
+ * day component across business days only, asking the host-provided
+ * {@link BPMBusinessCalendar} about each candidate date; any sub-day component
+ * is then added as plain elapsed time on top of the resolved business day.
+ */
+let BPMSlaScheduleService = BPMSlaScheduleService_1 = class BPMSlaScheduleService {
+    constructor(businessCalendar) {
+        this.businessCalendar = businessCalendar;
+        this.logger = new common_1.Logger(BPMSlaScheduleService_1.name);
+        this.dateFormatter = new Intl.DateTimeFormat('en-CA', {
+            day: '2-digit',
+            month: '2-digit',
+            timeZone: businessCalendar.timeZone,
+            year: 'numeric',
+        });
+    }
+    async resolveTaskSlaDueAt({ node, now, }) {
+        const sla = node.data.sla;
+        if (!sla?.duration) {
+            return null;
+        }
+        const parts = (0, iso_duration_1.parseIsoDurationParts)(sla.duration);
+        if (!parts) {
+            return null;
+        }
+        if (sla.calendar !== 'BUSINESS_DAY' || parts.days === 0) {
+            return new Date(now.getTime() + parts.days * iso_duration_1.MS_PER_DAY + parts.timeMs);
+        }
+        const advancedDays = await this.countCalendarDaysForBusinessDays(now, parts.days, node.id);
+        return new Date(now.getTime() + advancedDays * iso_duration_1.MS_PER_DAY + parts.timeMs);
+    }
+    /**
+     * Walks forward one calendar day at a time from `now`, consuming one unit of
+     * `businessDays` for each date the host calendar reports as a working day,
+     * and returns how many calendar days were stepped.
+     *
+     * The starting date is never counted: an SLA of "1 business day" always lands
+     * on the *next* working day, whether the task was raised on a Monday or on a
+     * Saturday.
+     */
+    async countCalendarDaysForBusinessDays(now, businessDays, nodeId) {
+        const scanLimit = readBusinessDayScanLimit(businessDays);
+        let remainingBusinessDays = businessDays;
+        let steps = 0;
+        while (remainingBusinessDays > 0 && steps < scanLimit) {
+            steps += 1;
+            const candidate = new Date(now.getTime() + steps * iso_duration_1.MS_PER_DAY);
+            if (await this.businessCalendar.isBusinessDay(this.readLocalDate(candidate))) {
+                remainingBusinessDays -= 1;
+            }
+        }
+        if (remainingBusinessDays > 0) {
+            this.logger.warn(`Business calendar reported no working day within ${scanLimit} days for node ${nodeId}; falling back to calendar time.`);
+            return businessDays;
+        }
+        return steps;
+    }
+    /** Formats an instant as a `YYYY-MM-DD` date in the calendar's time zone. */
+    readLocalDate(value) {
+        // `en-CA` renders ISO-ordered dates, so no part reassembly is needed.
+        return this.dateFormatter.format(value);
+    }
+};
+exports.BPMSlaScheduleService = BPMSlaScheduleService;
+exports.BPMSlaScheduleService = BPMSlaScheduleService = BPMSlaScheduleService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Inject)(business_calendar_token_1.BPM_BUSINESS_CALENDAR)),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], BPMSlaScheduleService);
+//# sourceMappingURL=sla-schedule.service.js.map

package/src/lib/calendar/sla-schedule.service.js.map

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

package/src/lib/calendar/weekday-business-calendar.d.ts

@@ -0,0 +1,15 @@
+import { BPMBusinessCalendar } from './business-calendar.token';
+/**
+ * Built-in fallback calendar: Monday through Friday are working days, weekends
+ * are not, and no holiday is known.
+ *
+ * This is what a host gets when it opts a node into `BUSINESS_DAY` without
+ * registering a calendar. It is intentionally naive — a host that cares about
+ * national holidays or make-up working days must supply its own
+ * {@link BPMBusinessCalendar}.
+ */
+export declare class BPMWeekdayBusinessCalendar implements BPMBusinessCalendar {
+    readonly timeZone: string;
+    constructor(timeZone?: string);
+    isBusinessDay(localDate: string): boolean;
+}

package/src/lib/calendar/weekday-business-calendar.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BPMWeekdayBusinessCalendar = void 0;
+const SATURDAY = 6;
+const SUNDAY = 0;
+/**
+ * Built-in fallback calendar: Monday through Friday are working days, weekends
+ * are not, and no holiday is known.
+ *
+ * This is what a host gets when it opts a node into `BUSINESS_DAY` without
+ * registering a calendar. It is intentionally naive — a host that cares about
+ * national holidays or make-up working days must supply its own
+ * {@link BPMBusinessCalendar}.
+ */
+class BPMWeekdayBusinessCalendar {
+    constructor(timeZone = 'UTC') {
+        this.timeZone = timeZone;
+    }
+    isBusinessDay(localDate) {
+        // `localDate` is already expressed in this calendar's zone, so reading it
+        // back as a UTC instant yields the correct weekday without re-applying an
+        // offset.
+        const weekday = new Date(`${localDate}T00:00:00.000Z`).getUTCDay();
+        return weekday !== SATURDAY && weekday !== SUNDAY;
+    }
+}
+exports.BPMWeekdayBusinessCalendar = BPMWeekdayBusinessCalendar;
+//# sourceMappingURL=weekday-business-calendar.js.map

package/src/lib/calendar/weekday-business-calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekday-business-calendar.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/calendar/weekday-business-calendar.ts"],"names":[],"mappings":";;;AAEA,MAAM,QAAQ,GAAG,CAAC,CAAC;AACnB,MAAM,MAAM,GAAG,CAAC,CAAC;AAEjB;;;;;;;;GAQG;AACH,MAAa,0BAA0B;IAGrC,YAAY,QAAQ,GAAG,KAAK;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,0EAA0E;QAC1E,0EAA0E;QAC1E,UAAU;QACV,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,GAAG,SAAS,gBAAgB,CAAC,CAAC,SAAS,EAAE,CAAC;QAEnE,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,MAAM,CAAC;IACpD,CAAC;CACF;AAfD,gEAeC"}

package/src/lib/common/iso-duration.d.ts

@@ -1 +1,12 @@
+export declare const MS_PER_DAY: number;
+/**
+ * The day component and the sub-day (time) component of an ISO duration, kept
+ * apart because business-day SLA scheduling advances them differently: `days`
+ * skips non-business dates, `timeMs` is added as plain elapsed time.
+ */
+export interface IsoDurationParts {
+    readonly days: number;
+    readonly timeMs: number;
+}
 export declare function parseIsoDurationToMilliseconds(value: string): number | null;
+export declare function parseIsoDurationParts(value: string): IsoDurationParts | null;

package/src/lib/common/iso-duration.js

@@ -1,12 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MS_PER_DAY = void 0;
 exports.parseIsoDurationToMilliseconds = parseIsoDurationToMilliseconds;
+exports.parseIsoDurationParts = parseIsoDurationParts;
 const ISO_DURATION_PATTERN = /^P(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?$/u;
 const MS_PER_SECOND = 1000;
 const SECONDS_PER_MINUTE = 60;
 const MINUTES_PER_HOUR = 60;
 const HOURS_PER_DAY = 24;
+exports.MS_PER_DAY = HOURS_PER_DAY * MINUTES_PER_HOUR * SECONDS_PER_MINUTE * MS_PER_SECOND;
 function parseIsoDurationToMilliseconds(value) {
+    const parts = parseIsoDurationParts(value);
+    return parts ? parts.days * exports.MS_PER_DAY + parts.timeMs : null;
+}
+function parseIsoDurationParts(value) {
     const match = ISO_DURATION_PATTERN.exec(value.trim());
     if (!match) {
         return null;
@@ -15,11 +22,13 @@ function parseIsoDurationToMilliseconds(value) {
     const hours = readDurationUnit(match[2]);
     const minutes = readDurationUnit(match[3]);
     const seconds = readDurationUnit(match[4]);
-    const totalSeconds = seconds +
+    const timeSeconds = seconds +
         minutes * SECONDS_PER_MINUTE +
-        hours * MINUTES_PER_HOUR * SECONDS_PER_MINUTE +
-        days * HOURS_PER_DAY * MINUTES_PER_HOUR * SECONDS_PER_MINUTE;
-    return totalSeconds > 0 ? totalSeconds * MS_PER_SECOND : null;
+        hours * MINUTES_PER_HOUR * SECONDS_PER_MINUTE;
+    if (days === 0 && timeSeconds === 0) {
+        return null;
+    }
+    return { days, timeMs: timeSeconds * MS_PER_SECOND };
 }
 function readDurationUnit(value) {
     return value ? Number(value) : 0;

package/src/lib/common/iso-duration.js.map

@@ -1 +1 @@
-{"version":3,"file":"iso-duration.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/common/iso-duration.ts"],"names":[],"mappings":";;AAQA,wEAkBC;AA1BD,MAAM,oBAAoB,GACxB,wDAAwD,CAAC;AAE3D,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,SAAgB,8BAA8B,CAAC,KAAa;IAC1D,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAEtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,YAAY,GAChB,OAAO;QACP,OAAO,GAAG,kBAAkB;QAC5B,KAAK,GAAG,gBAAgB,GAAG,kBAAkB;QAC7C,IAAI,GAAG,aAAa,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;IAE/D,OAAO,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;AAChE,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAyB;IACjD,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"iso-duration.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/common/iso-duration.ts"],"names":[],"mappings":";;;AAqBA,wEAIC;AAED,sDAqBC;AAhDD,MAAM,oBAAoB,GACxB,wDAAwD,CAAC;AAE3D,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,aAAa,GAAG,EAAE,CAAC;AAEZ,QAAA,UAAU,GACrB,aAAa,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAYxE,SAAgB,8BAA8B,CAAC,KAAa;IAC1D,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAE3C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,kBAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED,SAAgB,qBAAqB,CAAC,KAAa;IACjD,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAEtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,WAAW,GACf,OAAO;QACP,OAAO,GAAG,kBAAkB;QAC5B,KAAK,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;IAEhD,IAAI,IAAI,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,GAAG,aAAa,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAyB;IACjD,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/src/lib/notification/notification-options.d.ts

@@ -126,6 +126,15 @@ export interface BPMRootNotificationOptions {
      * tight loops in long-running API processes.
      */
     readonly notificationSlaScanIntervalMs?: number;
+    /**
+     * IANA time zone used by BPM's built-in Monday–Friday business calendar when
+     * the host registers no `businessCalendarProvider`.
+     *
+     * Only affects nodes whose SLA opts into `BUSINESS_DAY`. Defaults to `UTC`.
+     * Hosts that inject their own `BPMBusinessCalendar` declare the time zone on
+     * the calendar itself and this option is ignored.
+     */
+    readonly notificationSlaBusinessCalendarTimeZone?: string;
     /**
      * Enables the SLA timeout `REMIND` action.
      *
@@ -199,6 +208,7 @@ export interface BPMResolvedNotificationOptions {
     readonly deliveryRetryBaseDelayMs: number;
     readonly deliveryScanIntervalMs: number;
     readonly deliverySchedulerEnabled: boolean;
+    readonly slaBusinessCalendarTimeZone: string;
     readonly slaScanIntervalMs: number;
     readonly slaSchedulerEnabled: boolean;
     readonly slaTimeoutAutoApproveEnabled: boolean;