hierarchical-approval 4.0.4 → 4.0.5

package/CHANGELOG.md

@@ -5,8 +5,32 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [4.0.5] - 2026-09-25
+
+### Fixed
+
+- `RateLimitMiddleware`'s constructor validation now throws
+  `ApprovalValidationError`, instead of a plain `Error` a caller catching
+  `ApprovalValidationError` to distinguish config problems would miss.
+- `DigestNotificationAdapter`'s `intervalMs` validation now throws
+  `ApprovalValidationError` for the same reason.
+- `HashChainAuditAdapter`'s missing-`reader` validation now throws
+  `ApprovalValidationError` for the same reason.
+- `businessHoursCalendar`'s three configuration guards now throw
+  `ApprovalValidationError` for the same reason.
+
 ## [4.0.4] - 2026-09-24
 
+### Fixed
+
+- `resubmit`'s duplicate-level error now names the offending level numbers,
+  instead of a message that gave no clue which levels collided.
+- `purgeInstances`'s date-validation error now names the offending value,
+  instead of a message that gave no clue which value failed.
+- `delegate`'s, `reassign`'s, and `override`'s self-action guards now name
+  the offending id, matching every sibling guard in the same methods that
+  already named theirs.
+
 ## [4.0.3] - 2026-09-22
 
 ### Fixed

package/dist/{ApprovalEngine-D0_F5OPZ.d.cts → ApprovalEngine-BaJ2PNB7.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-Dhrc4ES6.cjs';
-import { m as ConditionExpression, r as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, k as AuditContext, a as ApprovalInstance, C as Comment, e as ApprovalMode, f as ApprovalStatus, L as LevelStatus, b as AuditEntry } from './instance-CUZcHWK2.cjs';
-import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-J0wSPLIC.cjs';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-CrbVtEE-.cjs';
+import { m as ConditionExpression, r as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, k as AuditContext, a as ApprovalInstance, C as Comment, e as ApprovalMode, f as ApprovalStatus, L as LevelStatus, b as AuditEntry } from './instance-Cu6-qPxs.cjs';
+import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-D9IOl9G_.cjs';
 import { z } from 'zod';
 import { L as Logger } from './Logger-hqFbBCtB.cjs';
 import { C as Clock } from './Clock-D8Qp39q_.cjs';
-import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-UUKqztxM.cjs';
-import { I as IAuditAdapter } from './IAuditAdapter-D9WE0t7A.cjs';
+import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-CsF_xD4b.cjs';
+import { I as IAuditAdapter } from './IAuditAdapter-Dqpkg-Tz.cjs';
 import { I as IMetricsAdapter } from './IMetricsAdapter-WROxYSXd.cjs';
 import { I as ISchedulerAdapter } from './ISchedulerAdapter-CLMdBA-5.cjs';
-import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-DDmjeYV-.cjs';
+import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-D5mAFBTC.cjs';
 
 declare const SubmitOptionsSchema: z.ZodObject<{
     templateName: z.ZodString;
@@ -587,6 +587,7 @@ interface ApprovalEngineOptions {
      */
     outOfOfficeProvider?: OutOfOfficeProvider;
     logger?: Logger;
+    /** Interval, in milliseconds, between automatic escalation sweeps. Default: 60000 (1 minute). */
     escalationPollIntervalMs?: number;
     /** Maximum number of instances allowed in a single bulk operation. Default: 200. */
     maxBulkItems?: number;

package/dist/{ApprovalEngine-D4bXQrKD.d.ts → ApprovalEngine-CeBKYLz4.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-DSKJ1onF.js';
-import { m as ConditionExpression, r as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, k as AuditContext, a as ApprovalInstance, C as Comment, e as ApprovalMode, f as ApprovalStatus, L as LevelStatus, b as AuditEntry } from './instance-CUZcHWK2.js';
-import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-CLROEfRd.js';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-DDOW9z0L.js';
+import { m as ConditionExpression, r as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, k as AuditContext, a as ApprovalInstance, C as Comment, e as ApprovalMode, f as ApprovalStatus, L as LevelStatus, b as AuditEntry } from './instance-Cu6-qPxs.js';
+import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-B_9JFH1i.js';
 import { z } from 'zod';
 import { L as Logger } from './Logger-hqFbBCtB.js';
 import { C as Clock } from './Clock-D8Qp39q_.js';
-import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-B32a2dwP.js';
-import { I as IAuditAdapter } from './IAuditAdapter-FI_RF_XU.js';
+import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-C-N8MpHV.js';
+import { I as IAuditAdapter } from './IAuditAdapter-ggCTPf02.js';
 import { I as IMetricsAdapter } from './IMetricsAdapter-WROxYSXd.js';
 import { I as ISchedulerAdapter } from './ISchedulerAdapter-CLMdBA-5.js';
-import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-BKKw7jGN.js';
+import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-BUHKvalu.js';
 
 declare const SubmitOptionsSchema: z.ZodObject<{
     templateName: z.ZodString;
@@ -587,6 +587,7 @@ interface ApprovalEngineOptions {
      */
     outOfOfficeProvider?: OutOfOfficeProvider;
     logger?: Logger;
+    /** Interval, in milliseconds, between automatic escalation sweeps. Default: 60000 (1 minute). */
     escalationPollIntervalMs?: number;
     /** Maximum number of instances allowed in a single bulk operation. Default: 200. */
     maxBulkItems?: number;

package/dist/{IAuditAdapter-D9WE0t7A.d.cts → IAuditAdapter-Dqpkg-Tz.d.cts}

@@ -1,4 +1,4 @@
-import { b as AuditEntry, a as ApprovalInstance } from './instance-CUZcHWK2.cjs';
+import { b as AuditEntry, a as ApprovalInstance } from './instance-Cu6-qPxs.cjs';
 
 /** Secondary write sink for audit entries, alongside the primary storage adapter. */
 interface IAuditAdapter {

package/dist/{IAuditAdapter-FI_RF_XU.d.ts → IAuditAdapter-ggCTPf02.d.ts}

@@ -1,4 +1,4 @@
-import { b as AuditEntry, a as ApprovalInstance } from './instance-CUZcHWK2.js';
+import { b as AuditEntry, a as ApprovalInstance } from './instance-Cu6-qPxs.js';
 
 /** Secondary write sink for audit entries, alongside the primary storage adapter. */
 interface IAuditAdapter {

package/dist/{IAuthorizationPolicy-BKKw7jGN.d.ts → IAuthorizationPolicy-BUHKvalu.d.ts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-CUZcHWK2.js';
+import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-Cu6-qPxs.js';
 
 interface AuthorizationContext {
     /** The engine method the actor is attempting to call. */

package/dist/{IAuthorizationPolicy-DDmjeYV-.d.cts → IAuthorizationPolicy-D5mAFBTC.d.cts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-CUZcHWK2.cjs';
+import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-Cu6-qPxs.cjs';
 
 interface AuthorizationContext {
     /** The engine method the actor is attempting to call. */

package/dist/{INotificationAdapter-CLROEfRd.d.ts → INotificationAdapter-B_9JFH1i.d.ts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, b as AuditEntry } from './instance-CUZcHWK2.js';
+import { a as ApprovalInstance, b as AuditEntry } from './instance-Cu6-qPxs.js';
 
 /** Common fields carried by every lifecycle event emitted for an approval instance. */
 interface ApprovalEvent {

package/dist/{INotificationAdapter-J0wSPLIC.d.cts → INotificationAdapter-D9IOl9G_.d.cts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, b as AuditEntry } from './instance-CUZcHWK2.cjs';
+import { a as ApprovalInstance, b as AuditEntry } from './instance-Cu6-qPxs.cjs';
 
 /** Common fields carried by every lifecycle event emitted for an approval instance. */
 interface ApprovalEvent {

package/dist/{IOperationMiddleware-B32a2dwP.d.ts → IOperationMiddleware-C-N8MpHV.d.ts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance } from './instance-CUZcHWK2.js';
+import { a as ApprovalInstance } from './instance-Cu6-qPxs.js';
 
 /** Base class for all errors thrown by this library; carries a stable machine-readable `code`. */
 declare class ApprovalError extends Error {

package/dist/{IOperationMiddleware-UUKqztxM.d.cts → IOperationMiddleware-CsF_xD4b.d.cts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance } from './instance-CUZcHWK2.cjs';
+import { a as ApprovalInstance } from './instance-Cu6-qPxs.cjs';
 
 /** Base class for all errors thrown by this library; carries a stable machine-readable `code`. */
 declare class ApprovalError extends Error {

package/dist/{IStorageAdapter-Dhrc4ES6.d.cts → IStorageAdapter-CrbVtEE-.d.cts}

@@ -1,4 +1,4 @@
-import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-CUZcHWK2.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-Cu6-qPxs.cjs';
 
 /** Offset-based pagination request. */
 interface PaginationOpts {

package/dist/{IStorageAdapter-DSKJ1onF.d.ts → IStorageAdapter-DDOW9z0L.d.ts}

@@ -1,4 +1,4 @@
-import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-CUZcHWK2.js';
+import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-Cu6-qPxs.js';
 
 /** Offset-based pagination request. */
 interface PaginationOpts {

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-Dhrc4ES6.cjs';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-CUZcHWK2.cjs';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-CrbVtEE-.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-Cu6-qPxs.cjs';
 
 /**
  * In-process {@link IStorageAdapter} backed by two `Map`s, keyed by

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-DSKJ1onF.js';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-CUZcHWK2.js';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-DDOW9z0L.js';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-Cu6-qPxs.js';
 
 /**
  * In-process {@link IStorageAdapter} backed by two `Map`s, keyed by

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-Dhrc4ES6.cjs';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-CUZcHWK2.cjs';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-CrbVtEE-.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-Cu6-qPxs.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-DSKJ1onF.js';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-CUZcHWK2.js';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-DDOW9z0L.js';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-Cu6-qPxs.js';
 
 interface PostgresAdapterOptions {
     connectionString?: string;

package/dist/index.cjs

@@ -674,7 +674,7 @@ var LevelResolver = class {
           break;
         case "role": {
           if (!orgProvider) {
-            throw new Error(
+            throw new ApprovalValidationError(
               `Cannot resolve role "${approver.role}" without an orgProvider configured on ApprovalEngine.`
             );
           }
@@ -689,7 +689,7 @@ var LevelResolver = class {
             approver.resolver
           );
           if (!fn) {
-            throw new Error(
+            throw new ApprovalValidationError(
               `No resolver registered for "${approver.resolver}". Call engine.registerResolver("${approver.resolver}", fn) first.`
             );
           }
@@ -2573,7 +2573,7 @@ var ApprovalEngine = class _ApprovalEngine {
       assertStatus(instance, "pending");
       if (instance.infoRequest) {
         throw new ApprovalError(
-          `A clarification request is already open on this approval (asked by "${instance.infoRequest.askedBy}"). Answer it with provideInfo() first.`,
+          `A clarification request is already open on instance "${instance.id}" (asked by "${instance.infoRequest.askedBy}"). Answer it with provideInfo() first.`,
           "INFO_ALREADY_REQUESTED"
         );
       }
@@ -2660,7 +2660,7 @@ var ApprovalEngine = class _ApprovalEngine {
       const open = instance.infoRequest;
       if (!open) {
         throw new ApprovalError(
-          "No clarification request is open on this approval.",
+          `No clarification request is open on instance "${instance.id}".`,
           "NO_INFO_REQUESTED"
         );
       }
@@ -4533,7 +4533,7 @@ var ApprovalEngine = class _ApprovalEngine {
     const pending = this.pendingLevels(instance);
     if (pending.length === 0) {
       throw new ApprovalError(
-        `Instance has no level awaiting a decision (status: ${instance.status}).`,
+        `Instance "${instance.id}" has no level awaiting a decision (status: ${instance.status}).`,
         "INVALID_LEVEL"
       );
     }
@@ -5179,7 +5179,7 @@ function businessHoursCalendar(options = {}) {
   const startHour = options.workdayStartHour ?? 9;
   const endHour = options.workdayEndHour ?? 17;
   if (!(endHour > startHour)) {
-    throw new Error(
+    throw new ApprovalValidationError(
       `businessHoursCalendar: workdayEndHour (${endHour}) must be greater than workdayStartHour (${startHour}).`
     );
   }
@@ -5212,7 +5212,7 @@ function businessHoursCalendar(options = {}) {
       }
       return cursor;
     }
-    throw new Error(
+    throw new ApprovalValidationError(
       `businessHoursCalendar: no working day found within 10 years of ${from.toISOString()} \u2014 check weekendDays and holidays.`
     );
   };
@@ -5235,7 +5235,7 @@ function businessHoursCalendar(options = {}) {
         next.setHours(startHour, 0, 0, 0);
         cursor = toWorkingMoment(next);
       }
-      throw new Error(
+      throw new ApprovalValidationError(
         `businessHoursCalendar: ${hours} working hours could not be scheduled within 10 years \u2014 check weekendDays and holidays.`
       );
     }