hierarchical-approval 2.3.0 → 2.5.0

package/CHANGELOG.md

@@ -7,6 +7,80 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 _Nothing yet._
 
+## [2.5.0] - 2026-09-04
+
+### Added — deadlines in working hours
+
+- **`escalationAfterHours` on a level and `slaDeadlineHours` on a template.**
+  Deadlines were whole days, but ERP SLAs are quoted in hours far more often —
+  "respond within four working hours" — and approximating that as a fraction of
+  a day counted evenings and weekends, so a request submitted at 16:00 on a
+  Friday was overdue before anybody could have looked at it.
+
+- **`businessHoursCalendar({ workdayStartHour, workdayEndHour, weekendDays,
+  holidays })`** advances the clock only through the configured working window.
+  A `from` outside working hours is first moved to the next working moment, so a
+  deadline never starts counting from a time nobody was at work.
+
+  ```ts
+  const engine = new ApprovalEngine({
+    adapter,
+    calendar: businessHoursCalendar({ workdayStartHour: 9, workdayEndHour: 17 }),
+  });
+  // Friday 16:00 + 4 working hours -> Monday 12:00
+  ```
+
+- **`BusinessCalendar.addBusinessHours` is optional.** `weekendCalendar` knows
+  whole days only; given an hour-based deadline the engine falls back to elapsed
+  clock time rather than quietly pretending the calendar was applied. A custom
+  calendar opts in by implementing the method.
+
+- `validateTemplate()` rejects setting both units on the same level or template,
+  and non-positive hour values.
+
+  New exports: `businessHoursCalendar`, `BusinessHoursCalendarOptions`.
+
+## [2.4.0] - 2026-09-04
+
+### Added — `DigestNotificationAdapter`
+
+- **Batches notifications per recipient instead of sending one per event.** An
+  approver on twenty documents received twenty separate messages a day, which is
+  how approval email ends up filtered into a folder nobody reads — the
+  notifications defeat themselves.
+
+  ```ts
+  import { DigestNotificationAdapter } from 'hierarchical-approval/plugins/notify';
+
+  const digest = new DigestNotificationAdapter({
+    intervalMs: 15 * 60_000,
+    send: async ({ recipient, events }) => mailer.send(recipient, summarise(events)),
+  });
+  ```
+
+- **Urgent events still go straight through.** Batching a rejection or a
+  completed approval behind a digest window would make the library's own
+  notifications the reason a decision was late, so `approval:rejected`,
+  `approval:completed`, `approval:sla_breached` and `approval:expired` bypass
+  the buffer by default — configurable via `passthrough`.
+
+- **`maxBatchSize`** (default 50) flushes a recipient early under a burst so the
+  buffer stays bounded, and flushes only *that* recipient: a burst aimed at one
+  person must not force everybody else's digest out early. Omit `intervalMs` to
+  disable the timer and drive `flush()` from a cron job or queue worker instead.
+
+- A failed `send` is logged and swallowed, as the notification-adapter contract
+  requires, and the buffer is cleared before sending so a failure cannot replay
+  the same events into every subsequent digest.
+
+- Buffers are in memory: a restart drops what has not been flushed. That is the
+  right trade for a convenience digest but not for delivery guarantees — put
+  `OutboxNotificationAdapter` underneath when an event must not be lost.
+
+  New exports from `hierarchical-approval/plugins/notify`:
+  `DigestNotificationAdapter`, `DigestNotificationAdapterOptions`, `Digest`,
+  `DigestSendFn`.
+
 ## [2.3.0] - 2026-09-04
 
 ### Added — retention

package/README.md

@@ -468,6 +468,33 @@ The sweep is **not atomic**: it reports per-instance failures rather than rollin
 back. A partial transfer is the useful outcome — the approvals that can move
 should move, and the ones that cannot are named so a human can look at them.
 
+### SLAs in working hours
+
+Deadlines were whole days, so "respond within four working hours" could only be
+approximated. Levels take `escalationAfterHours` and templates take
+`slaDeadlineHours`, counted through a working-hours calendar:
+
+```ts
+import { businessHoursCalendar } from 'hierarchical-approval';
+
+const engine = new ApprovalEngine({
+  adapter,
+  calendar: businessHoursCalendar({ workdayStartHour: 9, workdayEndHour: 17 }),
+});
+
+// Submitted Friday 16:00, escalationAfterHours: 4  ->  due Monday 12:00
+```
+
+Evenings, weekends and holidays are skipped, and a request arriving outside
+working hours starts counting from the next working moment — so one submitted at
+20:00 is not already overdue by morning.
+
+`weekendCalendar` knows whole days only. Give it an hour-based deadline and the
+engine falls back to **elapsed clock time**, rather than quietly pretending the
+calendar applied; use `businessHoursCalendar` when hours should skip
+non-working time. Days and hours are mutually exclusive on the same level or
+template, and `validateTemplate()` rejects setting both.
+
 ### Retention
 
 Approval tables only grow, and data-minimisation rules eventually require old

package/dist/{ApprovalEngine-Ci9urTDI.d.ts → ApprovalEngine-BHWls8-z.d.ts}

@@ -1,14 +1,14 @@
-import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-BU3sau5W.js';
-import { l as ConditionExpression, p as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, k as AuditContext, a as ApprovalInstance, e as ApprovalMode, b as AuditEntry } from './instance-DUJY_Axf.js';
-import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-BdgfUrIn.js';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-Dw2xXP9B.js';
+import { l as ConditionExpression, p as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, k as AuditContext, a as ApprovalInstance, e as ApprovalMode, b as AuditEntry } from './instance-BO-i9-nq.js';
+import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-BBq2czpO.js';
 import { z } from 'zod';
 import { L as Logger } from './Logger-BplhlU7l.js';
 import { C as Clock } from './Clock-3FnOczFJ.js';
-import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-BGYrAqep.js';
-import { I as IAuditAdapter } from './IAuditAdapter-C4OASS6u.js';
+import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-CqzFklMn.js';
+import { I as IAuditAdapter } from './IAuditAdapter-CMCirvY-.js';
 import { I as IMetricsAdapter } from './IMetricsAdapter-DWq8IFaf.js';
 import { I as ISchedulerAdapter } from './ISchedulerAdapter-DKv_QjVN.js';
-import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-BA_m2Dg9.js';
+import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-BryQIKko.js';
 
 declare const SubmitOptionsSchema: z.ZodObject<{
     templateName: z.ZodString;
@@ -141,6 +141,16 @@ interface BusinessCalendar {
      * elapsed clock time within the resulting business day.
      */
     addBusinessDays(from: Date, days: number): Date;
+    /**
+     * Return the date that is `hours` **working** hours after `from`, skipping
+     * non-working hours, weekends and holidays.
+     *
+     * Optional. A calendar that only knows about whole days — such as
+     * {@link weekendCalendar} — omits it, and the engine falls back to elapsed
+     * clock time for any hour-based deadline rather than silently pretending the
+     * calendar was applied.
+     */
+    addBusinessHours?(from: Date, hours: number): Date;
 }
 interface WeekendCalendarOptions {
     /** Dates to treat as non-working days (compared by local calendar date). */
@@ -157,6 +167,37 @@ interface WeekendCalendarOptions {
  * holidays. Day arithmetic is performed in the host's local timezone.
  */
 declare function weekendCalendar(options?: WeekendCalendarOptions): BusinessCalendar;
+interface BusinessHoursCalendarOptions extends WeekendCalendarOptions {
+    /** First working hour of the day, 0-23 in local time. Defaults to 9. */
+    workdayStartHour?: number;
+    /**
+     * Hour at which the working day ends, 0-24 in local time. Defaults to 17.
+     * Must be greater than {@link workdayStartHour}.
+     */
+    workdayEndHour?: number;
+}
+/**
+ * A calendar that counts only working hours within working days.
+ *
+ * SLAs in an ERP are quoted in hours far more often than days — "respond within
+ * four working hours" — and counting those as elapsed clock time makes a
+ * request submitted at 16:00 on a Friday overdue before anybody could have
+ * looked at it. This advances the clock only through the configured working
+ * window, skipping evenings, weekends and holidays.
+ *
+ * A `from` outside working hours is first moved forward to the next working
+ * moment, so a deadline never starts counting from a time nobody was at work.
+ *
+ * Arithmetic is performed in the host's local timezone, matching
+ * {@link weekendCalendar}.
+ *
+ * @example
+ * ```ts
+ * const calendar = businessHoursCalendar({ workdayStartHour: 9, workdayEndHour: 17 });
+ * // Friday 16:00 + 4 working hours -> Monday 12:00
+ * ```
+ */
+declare function businessHoursCalendar(options?: BusinessHoursCalendarOptions): Required<Pick<BusinessCalendar, 'addBusinessDays' | 'addBusinessHours'>>;
 
 type IdGeneratorPrefix = 'inst' | 'tpl' | 'att';
 type IdGeneratorFn = (prefix: IdGeneratorPrefix) => string;
@@ -800,6 +841,17 @@ declare class ApprovalEngine {
     private withOptimisticRetry;
     /** Compute a deadline `days` from `from`, honouring the business calendar if one is configured. */
     private deadlineFrom;
+    /**
+     * 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.
+     */
+    private deadlineFromHours;
+    /** Level deadline from whichever of days/hours the template configured. */
+    private levelEscalationDue;
     private requireInstance;
     /**
      * Identity of the parallel branch group a level belongs to.
@@ -890,4 +942,4 @@ declare class ApprovalEngine {
     private runExternalAudit;
 }
 
-export { type AddCommentOptions as A, type BulkResult as B, type CanApproveResult as C, type DelegateOptions as D, type EscalateOptions as E, weekendCalendar as F, type HealthResult as H, type IdGeneratorFn as I, type OrgProvider as O, type PreviewChainLevel as P, type ReassignOptions as R, type SubmitOptions as S, TEMPLATE_BUNDLE_VERSION as T, type UpdateDataOptions as U, type ValidationResult as V, type WeekendCalendarOptions as W, ApprovalEngine as a, type ApprovalEngineOptions as b, type ApprovalStatistics as c, type ApproveOptions as d, type ApproverResolverFn as e, type ApproverWorkload as f, type BusinessCalendar as g, type CancelOptions as h, type ConditionOperatorFn as i, type CycleTimeStats as j, type IdempotencyKeyFn as k, type ImportResult as l, type OutOfOfficeProvider as m, type OverrideOptions as n, type PreviewResult as o, type ProvideInfoOptions as p, type PurgeResult as q, type RejectOptions as r, type RequestInfoOptions as s, type ResubmitOptions as t, type RetryPolicy as u, type TemplateBundle as v, type TransferResult as w, defaultIdGenerator as x, toComparableNumber as y, validateConditionExpression as z };
+export { type AddCommentOptions as A, type BulkResult as B, type CanApproveResult as C, type DelegateOptions as D, type EscalateOptions as E, toComparableNumber as F, validateConditionExpression as G, type HealthResult as H, type IdGeneratorFn as I, weekendCalendar as J, type OrgProvider as O, type PreviewChainLevel as P, type ReassignOptions as R, type SubmitOptions as S, TEMPLATE_BUNDLE_VERSION as T, type UpdateDataOptions as U, type ValidationResult as V, type WeekendCalendarOptions as W, ApprovalEngine as a, type ApprovalEngineOptions as b, type ApprovalStatistics as c, type ApproveOptions as d, type ApproverResolverFn as e, type ApproverWorkload as f, type BusinessCalendar as g, type BusinessHoursCalendarOptions as h, type CancelOptions as i, type ConditionOperatorFn as j, type CycleTimeStats as k, type IdempotencyKeyFn as l, type ImportResult as m, type OutOfOfficeProvider as n, type OverrideOptions as o, type PreviewResult as p, type ProvideInfoOptions as q, type PurgeResult as r, type RejectOptions as s, type RequestInfoOptions as t, type ResubmitOptions as u, type RetryPolicy as v, type TemplateBundle as w, type TransferResult as x, businessHoursCalendar as y, defaultIdGenerator as z };

package/dist/{ApprovalEngine-C1dUPnLM.d.cts → ApprovalEngine-CW7Uu1bV.d.cts}

@@ -1,14 +1,14 @@
-import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-DdHO4Rf1.cjs';
-import { l as ConditionExpression, p as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, k as AuditContext, a as ApprovalInstance, e as ApprovalMode, b as AuditEntry } from './instance-DUJY_Axf.cjs';
-import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-JJAiMyMd.cjs';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-Pq9J60xv.cjs';
+import { l as ConditionExpression, p as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, k as AuditContext, a as ApprovalInstance, e as ApprovalMode, b as AuditEntry } from './instance-BO-i9-nq.cjs';
+import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-AwbhZEqz.cjs';
 import { z } from 'zod';
 import { L as Logger } from './Logger-BplhlU7l.cjs';
 import { C as Clock } from './Clock-3FnOczFJ.cjs';
-import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-D0ksiFM3.cjs';
-import { I as IAuditAdapter } from './IAuditAdapter-BHVKMMv6.cjs';
+import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-3J-_NSGq.cjs';
+import { I as IAuditAdapter } from './IAuditAdapter-Dwx8ZP4J.cjs';
 import { I as IMetricsAdapter } from './IMetricsAdapter-DWq8IFaf.cjs';
 import { I as ISchedulerAdapter } from './ISchedulerAdapter-DKv_QjVN.cjs';
-import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-CtLkwQ8I.cjs';
+import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-B3vaV69v.cjs';
 
 declare const SubmitOptionsSchema: z.ZodObject<{
     templateName: z.ZodString;
@@ -141,6 +141,16 @@ interface BusinessCalendar {
      * elapsed clock time within the resulting business day.
      */
     addBusinessDays(from: Date, days: number): Date;
+    /**
+     * Return the date that is `hours` **working** hours after `from`, skipping
+     * non-working hours, weekends and holidays.
+     *
+     * Optional. A calendar that only knows about whole days — such as
+     * {@link weekendCalendar} — omits it, and the engine falls back to elapsed
+     * clock time for any hour-based deadline rather than silently pretending the
+     * calendar was applied.
+     */
+    addBusinessHours?(from: Date, hours: number): Date;
 }
 interface WeekendCalendarOptions {
     /** Dates to treat as non-working days (compared by local calendar date). */
@@ -157,6 +167,37 @@ interface WeekendCalendarOptions {
  * holidays. Day arithmetic is performed in the host's local timezone.
  */
 declare function weekendCalendar(options?: WeekendCalendarOptions): BusinessCalendar;
+interface BusinessHoursCalendarOptions extends WeekendCalendarOptions {
+    /** First working hour of the day, 0-23 in local time. Defaults to 9. */
+    workdayStartHour?: number;
+    /**
+     * Hour at which the working day ends, 0-24 in local time. Defaults to 17.
+     * Must be greater than {@link workdayStartHour}.
+     */
+    workdayEndHour?: number;
+}
+/**
+ * A calendar that counts only working hours within working days.
+ *
+ * SLAs in an ERP are quoted in hours far more often than days — "respond within
+ * four working hours" — and counting those as elapsed clock time makes a
+ * request submitted at 16:00 on a Friday overdue before anybody could have
+ * looked at it. This advances the clock only through the configured working
+ * window, skipping evenings, weekends and holidays.
+ *
+ * A `from` outside working hours is first moved forward to the next working
+ * moment, so a deadline never starts counting from a time nobody was at work.
+ *
+ * Arithmetic is performed in the host's local timezone, matching
+ * {@link weekendCalendar}.
+ *
+ * @example
+ * ```ts
+ * const calendar = businessHoursCalendar({ workdayStartHour: 9, workdayEndHour: 17 });
+ * // Friday 16:00 + 4 working hours -> Monday 12:00
+ * ```
+ */
+declare function businessHoursCalendar(options?: BusinessHoursCalendarOptions): Required<Pick<BusinessCalendar, 'addBusinessDays' | 'addBusinessHours'>>;
 
 type IdGeneratorPrefix = 'inst' | 'tpl' | 'att';
 type IdGeneratorFn = (prefix: IdGeneratorPrefix) => string;
@@ -800,6 +841,17 @@ declare class ApprovalEngine {
     private withOptimisticRetry;
     /** Compute a deadline `days` from `from`, honouring the business calendar if one is configured. */
     private deadlineFrom;
+    /**
+     * 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.
+     */
+    private deadlineFromHours;
+    /** Level deadline from whichever of days/hours the template configured. */
+    private levelEscalationDue;
     private requireInstance;
     /**
      * Identity of the parallel branch group a level belongs to.
@@ -890,4 +942,4 @@ declare class ApprovalEngine {
     private runExternalAudit;
 }
 
-export { type AddCommentOptions as A, type BulkResult as B, type CanApproveResult as C, type DelegateOptions as D, type EscalateOptions as E, weekendCalendar as F, type HealthResult as H, type IdGeneratorFn as I, type OrgProvider as O, type PreviewChainLevel as P, type ReassignOptions as R, type SubmitOptions as S, TEMPLATE_BUNDLE_VERSION as T, type UpdateDataOptions as U, type ValidationResult as V, type WeekendCalendarOptions as W, ApprovalEngine as a, type ApprovalEngineOptions as b, type ApprovalStatistics as c, type ApproveOptions as d, type ApproverResolverFn as e, type ApproverWorkload as f, type BusinessCalendar as g, type CancelOptions as h, type ConditionOperatorFn as i, type CycleTimeStats as j, type IdempotencyKeyFn as k, type ImportResult as l, type OutOfOfficeProvider as m, type OverrideOptions as n, type PreviewResult as o, type ProvideInfoOptions as p, type PurgeResult as q, type RejectOptions as r, type RequestInfoOptions as s, type ResubmitOptions as t, type RetryPolicy as u, type TemplateBundle as v, type TransferResult as w, defaultIdGenerator as x, toComparableNumber as y, validateConditionExpression as z };
+export { type AddCommentOptions as A, type BulkResult as B, type CanApproveResult as C, type DelegateOptions as D, type EscalateOptions as E, toComparableNumber as F, validateConditionExpression as G, type HealthResult as H, type IdGeneratorFn as I, weekendCalendar as J, type OrgProvider as O, type PreviewChainLevel as P, type ReassignOptions as R, type SubmitOptions as S, TEMPLATE_BUNDLE_VERSION as T, type UpdateDataOptions as U, type ValidationResult as V, type WeekendCalendarOptions as W, ApprovalEngine as a, type ApprovalEngineOptions as b, type ApprovalStatistics as c, type ApproveOptions as d, type ApproverResolverFn as e, type ApproverWorkload as f, type BusinessCalendar as g, type BusinessHoursCalendarOptions as h, type CancelOptions as i, type ConditionOperatorFn as j, type CycleTimeStats as k, type IdempotencyKeyFn as l, type ImportResult as m, type OutOfOfficeProvider as n, type OverrideOptions as o, type PreviewResult as p, type ProvideInfoOptions as q, type PurgeResult as r, type RejectOptions as s, type RequestInfoOptions as t, type ResubmitOptions as u, type RetryPolicy as v, type TemplateBundle as w, type TransferResult as x, businessHoursCalendar as y, defaultIdGenerator as z };

package/dist/{IAuditAdapter-C4OASS6u.d.ts → IAuditAdapter-CMCirvY-.d.ts}

@@ -1,4 +1,4 @@
-import { b as AuditEntry, a as ApprovalInstance } from './instance-DUJY_Axf.js';
+import { b as AuditEntry, a as ApprovalInstance } from './instance-BO-i9-nq.js';
 
 interface IAuditAdapter {
     /**

package/dist/{IAuditAdapter-BHVKMMv6.d.cts → IAuditAdapter-Dwx8ZP4J.d.cts}

@@ -1,4 +1,4 @@
-import { b as AuditEntry, a as ApprovalInstance } from './instance-DUJY_Axf.cjs';
+import { b as AuditEntry, a as ApprovalInstance } from './instance-BO-i9-nq.cjs';
 
 interface IAuditAdapter {
     /**

package/dist/{IAuthorizationPolicy-CtLkwQ8I.d.cts → IAuthorizationPolicy-B3vaV69v.d.cts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-DUJY_Axf.cjs';
+import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-BO-i9-nq.cjs';
 
 interface AuthorizationContext {
     operation: 'submit' | 'approve' | 'reject' | 'delegate' | 'reassign' | 'cancel' | 'escalate' | 'override' | 'resubmit' | 'addComment' | 'updateData' | 'requestInfo' | 'provideInfo' | 'addAttachment' | 'removeAttachment';

package/dist/{IAuthorizationPolicy-BA_m2Dg9.d.ts → IAuthorizationPolicy-BryQIKko.d.ts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-DUJY_Axf.js';
+import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-BO-i9-nq.js';
 
 interface AuthorizationContext {
     operation: 'submit' | 'approve' | 'reject' | 'delegate' | 'reassign' | 'cancel' | 'escalate' | 'override' | 'resubmit' | 'addComment' | 'updateData' | 'requestInfo' | 'provideInfo' | 'addAttachment' | 'removeAttachment';

package/dist/{INotificationAdapter-JJAiMyMd.d.cts → INotificationAdapter-AwbhZEqz.d.cts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, b as AuditEntry } from './instance-DUJY_Axf.cjs';
+import { a as ApprovalInstance, b as AuditEntry } from './instance-BO-i9-nq.cjs';
 
 interface ApprovalEvent {
     instanceId: string;

package/dist/{INotificationAdapter-BdgfUrIn.d.ts → INotificationAdapter-BBq2czpO.d.ts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, b as AuditEntry } from './instance-DUJY_Axf.js';
+import { a as ApprovalInstance, b as AuditEntry } from './instance-BO-i9-nq.js';
 
 interface ApprovalEvent {
     instanceId: string;

package/dist/{IOperationMiddleware-D0ksiFM3.d.cts → IOperationMiddleware-3J-_NSGq.d.cts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance } from './instance-DUJY_Axf.cjs';
+import { a as ApprovalInstance } from './instance-BO-i9-nq.cjs';
 
 declare class ApprovalError extends Error {
     readonly code: string;

package/dist/{IOperationMiddleware-BGYrAqep.d.ts → IOperationMiddleware-CqzFklMn.d.ts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance } from './instance-DUJY_Axf.js';
+import { a as ApprovalInstance } from './instance-BO-i9-nq.js';
 
 declare class ApprovalError extends Error {
     readonly code: string;

package/dist/{IStorageAdapter-BU3sau5W.d.ts → IStorageAdapter-Dw2xXP9B.d.ts}

@@ -1,4 +1,4 @@
-import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-DUJY_Axf.js';
+import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-BO-i9-nq.js';
 
 interface PaginationOpts {
     limit: number;

package/dist/{IStorageAdapter-DdHO4Rf1.d.cts → IStorageAdapter-Pq9J60xv.d.cts}

@@ -1,4 +1,4 @@
-import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-DUJY_Axf.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-BO-i9-nq.cjs';
 
 interface PaginationOpts {
     limit: number;

package/dist/adapters/MemoryAdapter.d.cts

@@ -1,5 +1,5 @@
-import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-DdHO4Rf1.cjs';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-DUJY_Axf.cjs';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-Pq9J60xv.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-BO-i9-nq.cjs';
 
 declare class MemoryAdapter implements IStorageAdapter {
     private templates;

package/dist/adapters/MemoryAdapter.d.ts

@@ -1,5 +1,5 @@
-import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-BU3sau5W.js';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-DUJY_Axf.js';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-Dw2xXP9B.js';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-BO-i9-nq.js';
 
 declare class MemoryAdapter implements IStorageAdapter {
     private templates;

package/dist/adapters/PostgresAdapter.d.cts

@@ -1,7 +1,7 @@
 import * as tls from 'tls';
 import * as pg from 'pg';
-import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-DdHO4Rf1.cjs';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-DUJY_Axf.cjs';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-Pq9J60xv.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-BO-i9-nq.cjs';
 
 interface PostgresAdapterOptions {
     connectionString?: string;

package/dist/adapters/PostgresAdapter.d.ts

@@ -1,7 +1,7 @@
 import * as tls from 'tls';
 import * as pg from 'pg';
-import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-BU3sau5W.js';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-DUJY_Axf.js';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-Dw2xXP9B.js';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-BO-i9-nq.js';
 
 interface PostgresAdapterOptions {
     connectionString?: string;

package/dist/index.cjs

@@ -1071,6 +1071,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`,
@@ -1135,6 +1147,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`));
@@ -1248,7 +1272,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,
@@ -1278,7 +1303,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,
@@ -1306,6 +1331,7 @@ var ApprovalEngine = class _ApprovalEngine {
       templateSnapshot: {
         escalation: template.escalation,
         slaDeadlineDays: template.slaDeadlineDays,
+        slaDeadlineHours: template.slaDeadlineHours,
         allowOverride: template.allowOverride
       }
     };
@@ -2577,7 +2603,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,
@@ -2600,6 +2626,7 @@ var ApprovalEngine = class _ApprovalEngine {
       templateSnapshot: {
         escalation: template.escalation,
         slaDeadlineDays: template.slaDeadlineDays,
+        slaDeadlineHours: template.slaDeadlineHours,
         allowOverride: template.allowOverride
       }
     };
@@ -3542,6 +3569,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);
@@ -3647,9 +3692,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";
     }
@@ -4290,6 +4333,73 @@ function weekendCalendar(options = {}) {
     }
   };
 }
+var HOUR_MS = 36e5;
+function businessHoursCalendar(options = {}) {
+  const startHour = options.workdayStartHour ?? 9;
+  const endHour = options.workdayEndHour ?? 17;
+  if (!(endHour > startHour)) {
+    throw new Error(
+      `businessHoursCalendar: workdayEndHour (${endHour}) must be greater than workdayStartHour (${startHour}).`
+    );
+  }
+  const weekend = new Set(options.weekendDays ?? [0, 6]);
+  const holidays = new Set((options.holidays ?? []).map(dayKey));
+  const isBusinessDay = (d) => !weekend.has(d.getDay()) && !holidays.has(dayKey(d));
+  const startOfWorkday = (d) => {
+    const out = new Date(d.getTime());
+    out.setHours(startHour, 0, 0, 0);
+    return out;
+  };
+  const endOfWorkday = (d) => {
+    const out = new Date(d.getTime());
+    out.setHours(endHour, 0, 0, 0);
+    return out;
+  };
+  const toWorkingMoment = (from) => {
+    const cursor = new Date(from.getTime());
+    for (let guard = 0; guard < 3660; guard++) {
+      if (!isBusinessDay(cursor)) {
+        cursor.setDate(cursor.getDate() + 1);
+        cursor.setHours(startHour, 0, 0, 0);
+        continue;
+      }
+      if (cursor.getTime() < startOfWorkday(cursor).getTime()) return startOfWorkday(cursor);
+      if (cursor.getTime() >= endOfWorkday(cursor).getTime()) {
+        cursor.setDate(cursor.getDate() + 1);
+        cursor.setHours(startHour, 0, 0, 0);
+        continue;
+      }
+      return cursor;
+    }
+    throw new Error(
+      "businessHoursCalendar: no working day found within 10 years of the start date."
+    );
+  };
+  const base = weekendCalendar(options);
+  return {
+    addBusinessDays: base.addBusinessDays,
+    addBusinessHours(from, hours) {
+      if (hours <= 0 || Number.isNaN(hours)) return new Date(from.getTime());
+      let cursor = toWorkingMoment(from);
+      let remainingMs = Math.round(hours * HOUR_MS);
+      for (let guard = 0; remainingMs > 0 && guard < 3660; guard++) {
+        const dayEnd = endOfWorkday(cursor);
+        const availableMs = dayEnd.getTime() - cursor.getTime();
+        if (remainingMs <= availableMs) {
+          return new Date(cursor.getTime() + remainingMs);
+        }
+        remainingMs -= availableMs;
+        const next = new Date(cursor.getTime());
+        next.setDate(next.getDate() + 1);
+        next.setHours(startHour, 0, 0, 0);
+        cursor = toWorkingMoment(next);
+      }
+      throw new Error(
+        `businessHoursCalendar: ${hours} working hours could not be scheduled within 10 years \u2014 check weekendDays and holidays.`
+      );
+    }
+  };
+}
 
 exports.ApprovalConflictError = ApprovalConflictError;
 exports.ApprovalEngine = ApprovalEngine;
@@ -4301,6 +4411,7 @@ exports.ApprovalValidationError = ApprovalValidationError;
 exports.EscalationScheduler = EscalationScheduler;
 exports.MemoryAdapter = MemoryAdapter;
 exports.TEMPLATE_BUNDLE_VERSION = TEMPLATE_BUNDLE_VERSION;
+exports.businessHoursCalendar = businessHoursCalendar;
 exports.defaultIdGenerator = defaultIdGenerator;
 exports.noopLogger = noopLogger;
 exports.systemClock = systemClock;