hierarchical-approval 2.3.0 → 2.5.0

package/dist/{instance-DUJY_Axf.d.cts → instance-BO-i9-nq.d.cts}

@@ -59,6 +59,12 @@ interface ApprovalLevelConfig {
      */
     subWorkflow?: SubWorkflowConfig;
     escalationAfterDays?: number;
+    /**
+     * Escalate this level after this many **working hours**, for SLAs quoted in
+     * hours rather than days. Mutually exclusive with
+     * {@link escalationAfterDays}.
+     */
+    escalationAfterHours?: number;
     /**
      * Send a reminder to this level's pending approvers this many days after the
      * level opens. Escalation reassigns work; a reminder only nudges, which is
@@ -166,6 +172,11 @@ interface ApprovalTemplateConfig {
     escalation?: EscalationConfig;
     /** Overall SLA for the entire workflow in days. Emits approval:sla_breached when elapsed. */
     slaDeadlineDays?: number;
+    /**
+     * Overall SLA in **working hours**. Mutually exclusive with
+     * {@link slaDeadlineDays}.
+     */
+    slaDeadlineHours?: number;
     /** Allow emergency override (bypass remaining levels). Must be true to use engine.override(). */
     allowOverride?: boolean;
 }
@@ -227,6 +238,7 @@ interface ApprovalLevelInstance {
     weights?: Record<string, number>;
     escalationDueAt?: Date;
     escalationAfterDays?: number;
+    escalationAfterHours?: number;
     /** When the next reminder for this level is due; cleared when the level closes. */
     reminderDueAt?: Date;
     /** How many reminders have already been sent for this level. */
@@ -281,6 +293,7 @@ interface InfoRequest {
 interface TemplateSnapshot {
     escalation?: EscalationConfig;
     slaDeadlineDays?: number;
+    slaDeadlineHours?: number;
     allowOverride?: boolean;
 }
 interface ApprovalInstance {

package/dist/{instance-DUJY_Axf.d.ts → instance-BO-i9-nq.d.ts}

@@ -59,6 +59,12 @@ interface ApprovalLevelConfig {
      */
     subWorkflow?: SubWorkflowConfig;
     escalationAfterDays?: number;
+    /**
+     * Escalate this level after this many **working hours**, for SLAs quoted in
+     * hours rather than days. Mutually exclusive with
+     * {@link escalationAfterDays}.
+     */
+    escalationAfterHours?: number;
     /**
      * Send a reminder to this level's pending approvers this many days after the
      * level opens. Escalation reassigns work; a reminder only nudges, which is
@@ -166,6 +172,11 @@ interface ApprovalTemplateConfig {
     escalation?: EscalationConfig;
     /** Overall SLA for the entire workflow in days. Emits approval:sla_breached when elapsed. */
     slaDeadlineDays?: number;
+    /**
+     * Overall SLA in **working hours**. Mutually exclusive with
+     * {@link slaDeadlineDays}.
+     */
+    slaDeadlineHours?: number;
     /** Allow emergency override (bypass remaining levels). Must be true to use engine.override(). */
     allowOverride?: boolean;
 }
@@ -227,6 +238,7 @@ interface ApprovalLevelInstance {
     weights?: Record<string, number>;
     escalationDueAt?: Date;
     escalationAfterDays?: number;
+    escalationAfterHours?: number;
     /** When the next reminder for this level is due; cleared when the level closes. */
     reminderDueAt?: Date;
     /** How many reminders have already been sent for this level. */
@@ -281,6 +293,7 @@ interface InfoRequest {
 interface TemplateSnapshot {
     escalation?: EscalationConfig;
     slaDeadlineDays?: number;
+    slaDeadlineHours?: number;
     allowOverride?: boolean;
 }
 interface ApprovalInstance {

package/dist/nestjs.cjs

@@ -1072,6 +1072,18 @@ var ApprovalEngine = class _ApprovalEngine {
             message: `Level ${l.level} sets reminderEveryDays without reminderAfterDays, so no reminder would ever be sent.`
           });
         }
+        if (l.escalationAfterHours !== void 0 && l.escalationAfterHours <= 0) {
+          errors.push({
+            field: `levels[${i}].escalationAfterHours`,
+            message: `Level ${l.level} escalationAfterHours must be a positive number.`
+          });
+        }
+        if (l.escalationAfterDays !== void 0 && l.escalationAfterHours !== void 0) {
+          errors.push({
+            field: `levels[${i}].escalationAfterHours`,
+            message: `Level ${l.level} sets both escalationAfterDays and escalationAfterHours; pick one so the deadline is unambiguous.`
+          });
+        }
         if (l.escalationAfterDays !== void 0 && l.escalationAfterDays <= 0) {
           errors.push({
             field: `levels[${i}].escalationAfterDays`,
@@ -1136,6 +1148,18 @@ var ApprovalEngine = class _ApprovalEngine {
         }
       });
     }
+    if (config.slaDeadlineDays !== void 0 && config.slaDeadlineHours !== void 0) {
+      errors.push({
+        field: "slaDeadlineHours",
+        message: "Template sets both slaDeadlineDays and slaDeadlineHours; pick one so the SLA is unambiguous."
+      });
+    }
+    if (config.slaDeadlineHours !== void 0 && config.slaDeadlineHours <= 0) {
+      errors.push({
+        field: "slaDeadlineHours",
+        message: "slaDeadlineHours must be a positive number."
+      });
+    }
     if (config.conditions) {
       config.conditions.forEach((rule, ruleIdx) => {
         errors.push(...validateConditionExpression(rule.when, `conditions[${ruleIdx}].when`));
@@ -1249,7 +1273,8 @@ var ApprovalEngine = class _ApprovalEngine {
         threshold: cfg.threshold,
         weights: cfg.weights,
         escalationAfterDays: cfg.escalationAfterDays,
-        escalationDueAt: inFirstGroup && cfg.escalationAfterDays ? this.deadlineFrom(now, cfg.escalationAfterDays) : void 0,
+        escalationAfterHours: cfg.escalationAfterHours,
+        escalationDueAt: inFirstGroup ? this.levelEscalationDue(now, cfg) : void 0,
         subWorkflowTemplate: cfg.subWorkflow?.templateName,
         reminderAfterDays: cfg.reminderAfterDays,
         reminderEveryDays: cfg.reminderEveryDays,
@@ -1279,7 +1304,7 @@ var ApprovalEngine = class _ApprovalEngine {
       timestamp: now,
       ...auditCtx
     };
-    const slaDeadlineAt = template.slaDeadlineDays ? this.deadlineFrom(now, template.slaDeadlineDays) : void 0;
+    const slaDeadlineAt = template.slaDeadlineHours ? this.deadlineFromHours(now, template.slaDeadlineHours) : template.slaDeadlineDays ? this.deadlineFrom(now, template.slaDeadlineDays) : void 0;
     const instance = {
       id: instanceId,
       tenantId: this.tenantId,
@@ -1307,6 +1332,7 @@ var ApprovalEngine = class _ApprovalEngine {
       templateSnapshot: {
         escalation: template.escalation,
         slaDeadlineDays: template.slaDeadlineDays,
+        slaDeadlineHours: template.slaDeadlineHours,
         allowOverride: template.allowOverride
       }
     };
@@ -2578,7 +2604,7 @@ var ApprovalEngine = class _ApprovalEngine {
       reason: opts.reason,
       ...auditCtx
     };
-    const slaDeadlineAt = template.slaDeadlineDays ? this.deadlineFrom(now, template.slaDeadlineDays) : void 0;
+    const slaDeadlineAt = template.slaDeadlineHours ? this.deadlineFromHours(now, template.slaDeadlineHours) : template.slaDeadlineDays ? this.deadlineFrom(now, template.slaDeadlineDays) : void 0;
     const newInstance = {
       id: newInstanceId,
       tenantId: this.tenantId,
@@ -2601,6 +2627,7 @@ var ApprovalEngine = class _ApprovalEngine {
       templateSnapshot: {
         escalation: template.escalation,
         slaDeadlineDays: template.slaDeadlineDays,
+        slaDeadlineHours: template.slaDeadlineHours,
         allowOverride: template.allowOverride
       }
     };
@@ -3543,6 +3570,24 @@ var ApprovalEngine = class _ApprovalEngine {
   deadlineFrom(from, days) {
     return this.calendar ? this.calendar.addBusinessDays(from, days) : new Date(from.getTime() + days * 864e5);
   }
+  /**
+   * Resolve an hour-based deadline.
+   *
+   * A calendar that only knows whole days — `weekendCalendar`, say — has no
+   * `addBusinessHours`, and this falls back to elapsed clock time rather than
+   * quietly pretending the calendar was applied. Configure
+   * `businessHoursCalendar` to have hours skip evenings and weekends.
+   */
+  deadlineFromHours(from, hours) {
+    const addHours = this.calendar?.addBusinessHours?.bind(this.calendar);
+    return addHours ? addHours(from, hours) : new Date(from.getTime() + hours * 36e5);
+  }
+  /** Level deadline from whichever of days/hours the template configured. */
+  levelEscalationDue(from, level) {
+    if (level.escalationAfterHours) return this.deadlineFromHours(from, level.escalationAfterHours);
+    if (level.escalationAfterDays) return this.deadlineFrom(from, level.escalationAfterDays);
+    return void 0;
+  }
   async requireInstance(id) {
     const instance = await this.opts.adapter.getInstance(this.tenantId, id);
     if (!instance) throw new ApprovalNotFoundError("Instance", id);
@@ -3648,9 +3693,7 @@ var ApprovalEngine = class _ApprovalEngine {
           now
         );
       }
-      if (lvl.escalationAfterDays) {
-        lvl.escalationDueAt = this.deadlineFrom(now, lvl.escalationAfterDays);
-      }
+      lvl.escalationDueAt = this.levelEscalationDue(now, lvl);
       this.scheduleReminder(lvl, now);
       lvl.status = "pending";
     }