hierarchical-approval 2.5.0 → 2.7.0

package/CHANGELOG.md

@@ -7,6 +7,78 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 _Nothing yet._
 
+## [2.7.0] - 2026-09-04
+
+### Added — `explainChain()`
+
+- **Explains why a chain resolves the way it does.** `previewApprovalChain()`
+  answers *what* the chain will be; nothing answered *why*, so "why does this
+  purchase order have a CFO level?" meant reading the template and
+  re-evaluating its conditions by hand — the most common support question about
+  an approval engine, and the one it was worst at answering.
+
+  ```ts
+  await engine.explainChain('purchase-order', data, 'buyer-1');
+  // levels:  [{ level: 3, name: 'CFO', source: 'condition', addedByRule: 0, … }]
+  // skipped: [{ level: 2, name: 'Finance', skippedByRule: 1 }]
+  // rules:   [{ index: 0, matched: true, addsLevels: [3], skipsLevels: [] }, …]
+  ```
+
+- **Every rule is reported, matched or not**, along with what it *would* add or
+  skip — which is how you find the rule that was supposed to fire and didn't,
+  not just the ones that did.
+
+- **Failures are described rather than thrown.** A level whose approvers cannot
+  be resolved is still listed, carrying `resolutionError`; a rule that throws —
+  an unregistered operator, a malformed group — is reported against that rule
+  and the rest of the explanation still returns. A diagnostic is least useful at
+  exactly the moment a broken rule would make it throw.
+
+- Reads nothing and writes nothing, so it is safe to expose to a support UI.
+  Sub-workflow levels are marked with their child template and skip approver
+  resolution, since nobody approves them directly.
+
+  New exports: `ChainExplanation`, `ExplainedLevel`, `ExplainedSkip`,
+  `ExplainedRule`.
+
+## [2.6.0] - 2026-09-04
+
+### Added — escalation ladders
+
+- **`escalationSteps` escalates repeatedly, up a chain.** A single `escalation`
+  could only ever fire once, so a request that stalled past its second deadline
+  had nowhere further to go — the usual "chase the manager, then the director,
+  then the VP" pattern had to be built outside the engine, on top of the events.
+
+  ```ts
+  escalationSteps: [
+    { afterDays: 2, escalateTo: { type: 'user', userId: 'director' } },
+    { afterDays: 4, escalateTo: { type: 'user', userId: 'vp' } },
+    { afterDays: 7, escalateTo: { type: 'role', role: 'exec' } },
+  ]
+  ```
+
+  Rungs are sorted by delay and fire in order, each **adding** an approver rather
+  than replacing one: escalation widens the pool, it does not hand the work over.
+
+- **Delays are measured from when the level opened, not from the previous
+  escalation**, so a ladder reads the way it is written. The level's opening
+  time is recovered from its `submitted` / `level_advanced` audit entry.
+
+- Rungs accept `afterHours` as well as `afterDays`, counted through the
+  working-hours calendar from 2.5.0 when one is configured. A per-level
+  `escalationAfterDays`/`escalationAfterHours` still decides *when* the first
+  rung fires — it is the more specific statement about that level — while the
+  ladder supplies *who*.
+
+- Templates carrying only the single-step `escalation` behave exactly as before;
+  the ladder takes precedence when both are set. Levels track progress in
+  `escalationStep`, and the ladder is captured in the template snapshot, so an
+  in-flight approval keeps the ladder it was submitted under.
+
+  New exports: `EscalationStep`. `ApprovalTemplateConfig` gains
+  `escalationSteps`; levels gain `escalationStep`.
+
 ## [2.5.0] - 2026-09-04
 
 ### Added — deadlines in working hours

package/README.md

@@ -468,6 +468,64 @@ 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.
 
+### Why does this chain look like this?
+
+`previewApprovalChain()` answers *what* the chain will be. `explainChain()`
+answers *why* — the question behind "why does this purchase order have a CFO
+level?":
+
+```ts
+const explanation = await engine.explainChain('purchase-order', data, 'buyer-1');
+// {
+//   templateName: 'purchase-order',
+//   levels: [
+//     { level: 1, name: 'Manager', source: 'template', resolvedApprovers: ['mgr-1'], … },
+//     { level: 3, name: 'CFO', source: 'condition', addedByRule: 0, resolvedApprovers: ['cfo'], … },
+//   ],
+//   skipped: [{ level: 2, name: 'Finance', skippedByRule: 1 }],
+//   rules: [
+//     { index: 0, matched: true,  addsLevels: [3], skipsLevels: [] },
+//     { index: 1, matched: true,  addsLevels: [], skipsLevels: [2] },
+//   ],
+// }
+```
+
+Every rule is reported, matched or not, along with what it *would* do — which is
+usually how you find the rule that was supposed to fire and didn't. A level
+whose approvers cannot be resolved is still listed, with `resolutionError`
+naming the reason; a rule that throws is reported against that rule rather than
+failing the whole explanation, since the explanation is least useful at exactly
+the moment a broken rule would make it throw.
+
+Reads nothing and writes nothing, so it is safe to expose to a support UI.
+
+### Escalation ladders
+
+A single `escalation` fires once, so a request that stalls past its second
+deadline has nowhere further to go. `escalationSteps` is a ladder:
+
+```ts
+escalationSteps: [
+  { afterDays: 2, escalateTo: { type: 'user', userId: 'director' } },
+  { afterDays: 4, escalateTo: { type: 'user', userId: 'vp' } },
+  { afterDays: 7, escalateTo: { type: 'role', role: 'exec' } },
+]
+```
+
+Rungs are sorted by delay and fire in order, each **adding** an approver without
+removing anyone already assigned — escalation widens the pool rather than
+handing the work over.
+
+Every delay is measured **from the moment the level opened**, not from the
+previous escalation, so the ladder reads the way it is written: late at day 2,
+later at day 4, latest at day 7. Rungs accept `afterHours` too, counted through
+the working-hours calendar if one is configured.
+
+A per-level `escalationAfterDays`/`escalationAfterHours` still wins for *when*
+the first rung fires — it is the more specific statement about that level — while
+the ladder supplies *who*. Templates with only the single-step `escalation`
+behave exactly as before.
+
 ### SLAs in working hours
 
 Deadlines were whole days, so "respond within four working hours" could only be

package/dist/{ApprovalEngine-CW7Uu1bV.d.cts → ApprovalEngine-BH9GvzMI.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-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 { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-yX9ERfQE.cjs';
+import { l as ConditionExpression, q as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, k as AuditContext, a as ApprovalInstance, e as ApprovalMode, b as AuditEntry } from './instance-weh2w7Ji.cjs';
+import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-C6HPrzh6.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-3J-_NSGq.cjs';
-import { I as IAuditAdapter } from './IAuditAdapter-Dwx8ZP4J.cjs';
+import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-CxnPzpqL.cjs';
+import { I as IAuditAdapter } from './IAuditAdapter-2UU5edKG.cjs';
 import { I as IMetricsAdapter } from './IMetricsAdapter-DWq8IFaf.cjs';
 import { I as ISchedulerAdapter } from './ISchedulerAdapter-DKv_QjVN.cjs';
-import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-B3vaV69v.cjs';
+import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-DPpiKzyh.cjs';
 
 declare const SubmitOptionsSchema: z.ZodObject<{
     templateName: z.ZodString;
@@ -299,6 +299,52 @@ interface PreviewResult {
     /** Indices (0-based) of conditions that fired for this data. */
     conditionsApplied: number[];
 }
+/** Where one level in an explained chain came from. */
+interface ExplainedLevel {
+    level: number;
+    name: string;
+    mode: ApprovalMode;
+    /** `'template'` for a statically declared level, `'condition'` for one a rule added. */
+    source: 'template' | 'condition';
+    /** Index of the condition rule that added it, when `source` is `'condition'`. */
+    addedByRule?: number;
+    resolvedApprovers: string[];
+    /** Why approver resolution failed, when it did. The level is still listed. */
+    resolutionError?: string;
+    /** Set when this level hands off to a child approval. */
+    subWorkflowTemplate?: string;
+}
+/** A level the template declares that will not run, and the rule that removed it. */
+interface ExplainedSkip {
+    level: number;
+    name: string;
+    /** Index of the condition rule whose `skipLevels` removed it. */
+    skippedByRule: number;
+}
+/** How one condition rule evaluated against the data. */
+interface ExplainedRule {
+    index: number;
+    matched: boolean;
+    /** Levels this rule would add. Present whether or not it matched. */
+    addsLevels: number[];
+    /** Levels this rule would skip. Present whether or not it matched. */
+    skipsLevels: number[];
+    /** Why the rule could not be evaluated, e.g. an unregistered operator. */
+    error?: string;
+}
+/**
+ * A full account of why a chain looks the way it does.
+ *
+ * `previewApprovalChain()` answers *what* the chain will be; this answers *why*,
+ * which is the question a support engineer actually has when a purchase order
+ * arrives with a level nobody expected.
+ */
+interface ChainExplanation {
+    templateName: string;
+    levels: ExplainedLevel[];
+    skipped: ExplainedSkip[];
+    rules: ExplainedRule[];
+}
 interface BulkResult {
     succeeded: ApprovalInstance[];
     failed: Array<{
@@ -677,6 +723,28 @@ declare class ApprovalEngine {
     /** Preview the resolved approval chain for a template and document data, without creating an instance. */
     previewApprovalChain(templateName: string, data: Record<string, unknown>, submittedBy: string): Promise<PreviewResult>;
     /** Check whether a user is eligible to approve a specific instance. Never throws. */
+    /**
+     * Explain why a chain resolves the way it does for a given document.
+     *
+     * `previewApprovalChain()` answers *what* the chain will be. This answers
+     * *why*: which rule added a level, which rule removed one, which rules were
+     * evaluated and did not match, and where each level's approvers came from —
+     * the question behind "why does this purchase order have a CFO level?", which
+     * previously meant reading the template and re-evaluating the conditions by
+     * hand.
+     *
+     * A rule that throws — an operator nobody registered, a malformed group — is
+     * reported against that rule rather than failing the whole explanation. The
+     * explanation is a diagnostic tool, and it is least useful at exactly the
+     * moment a broken rule makes it throw.
+     *
+     * Reads nothing and writes nothing; safe to expose to a support UI.
+     *
+     * @param templateName - Template to explain.
+     * @param data - Document data the conditions are evaluated against.
+     * @param submittedBy - Submitter, used for approver resolution.
+     */
+    explainChain(templateName: string, data: Record<string, unknown>, submittedBy: string): Promise<ChainExplanation>;
     canApprove(instanceId: string, userId: string): Promise<CanApproveResult>;
     /** Emergency bypass — completes the instance as 'approved', skipping remaining levels. Requires template.allowOverride = true. */
     override(instanceId: string, raw: OverrideOptions, auditCtx?: AuditContext): Promise<ApprovalInstance>;
@@ -852,6 +920,28 @@ declare class ApprovalEngine {
     private deadlineFromHours;
     /** Level deadline from whichever of days/hours the template configured. */
     private levelEscalationDue;
+    /** First rung of a ladder, sorted by delay, or undefined when there is none. */
+    private firstRungOf;
+    /**
+     * The escalation ladder for an instance, sorted by delay.
+     *
+     * Read from the instance's template snapshot so an in-flight approval keeps
+     * the ladder it was submitted under, exactly as the single-step
+     * {@link EscalationConfig} already did.
+     */
+    private escalationLadder;
+    /**
+     * When a level started collecting decisions.
+     *
+     * Escalation rungs are measured from this, not from the previous rung, so a
+     * ladder reads the way it is written. Recovered from the audit trail — the
+     * `submitted` entry for the opening level, the `level_advanced` entry
+     * otherwise — and falls back to `now` when no entry exists, which only leaves
+     * the ladder no worse off than the single-step behaviour it replaces.
+     */
+    private levelOpenedAt;
+    /** Deadline for one rung, measured from when the level opened. */
+    private stepDueAt;
     private requireInstance;
     /**
      * Identity of the parallel branch group a level belongs to.
@@ -942,4 +1032,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, 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 };
+export { type AddCommentOptions as A, type BulkResult as B, type CanApproveResult as C, type DelegateOptions as D, type EscalateOptions as E, type TemplateBundle as F, type TransferResult as G, type HealthResult as H, type IdGeneratorFn as I, businessHoursCalendar as J, defaultIdGenerator as K, toComparableNumber as L, validateConditionExpression as M, weekendCalendar as N, 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 ChainExplanation as j, type ConditionOperatorFn as k, type CycleTimeStats as l, type ExplainedLevel as m, type ExplainedRule as n, type ExplainedSkip as o, type IdempotencyKeyFn as p, type ImportResult as q, type OutOfOfficeProvider as r, type OverrideOptions as s, type PreviewResult as t, type ProvideInfoOptions as u, type PurgeResult as v, type RejectOptions as w, type RequestInfoOptions as x, type ResubmitOptions as y, type RetryPolicy as z };

package/dist/{ApprovalEngine-BHWls8-z.d.ts → ApprovalEngine-DkQcLaeT.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-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 { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-ChPT7ZDp.js';
+import { l as ConditionExpression, q as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, k as AuditContext, a as ApprovalInstance, e as ApprovalMode, b as AuditEntry } from './instance-weh2w7Ji.js';
+import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-BNGivLgU.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-CqzFklMn.js';
-import { I as IAuditAdapter } from './IAuditAdapter-CMCirvY-.js';
+import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-CXtg2wzF.js';
+import { I as IAuditAdapter } from './IAuditAdapter-DSor54iY.js';
 import { I as IMetricsAdapter } from './IMetricsAdapter-DWq8IFaf.js';
 import { I as ISchedulerAdapter } from './ISchedulerAdapter-DKv_QjVN.js';
-import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-BryQIKko.js';
+import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-BOWg-3AH.js';
 
 declare const SubmitOptionsSchema: z.ZodObject<{
     templateName: z.ZodString;
@@ -299,6 +299,52 @@ interface PreviewResult {
     /** Indices (0-based) of conditions that fired for this data. */
     conditionsApplied: number[];
 }
+/** Where one level in an explained chain came from. */
+interface ExplainedLevel {
+    level: number;
+    name: string;
+    mode: ApprovalMode;
+    /** `'template'` for a statically declared level, `'condition'` for one a rule added. */
+    source: 'template' | 'condition';
+    /** Index of the condition rule that added it, when `source` is `'condition'`. */
+    addedByRule?: number;
+    resolvedApprovers: string[];
+    /** Why approver resolution failed, when it did. The level is still listed. */
+    resolutionError?: string;
+    /** Set when this level hands off to a child approval. */
+    subWorkflowTemplate?: string;
+}
+/** A level the template declares that will not run, and the rule that removed it. */
+interface ExplainedSkip {
+    level: number;
+    name: string;
+    /** Index of the condition rule whose `skipLevels` removed it. */
+    skippedByRule: number;
+}
+/** How one condition rule evaluated against the data. */
+interface ExplainedRule {
+    index: number;
+    matched: boolean;
+    /** Levels this rule would add. Present whether or not it matched. */
+    addsLevels: number[];
+    /** Levels this rule would skip. Present whether or not it matched. */
+    skipsLevels: number[];
+    /** Why the rule could not be evaluated, e.g. an unregistered operator. */
+    error?: string;
+}
+/**
+ * A full account of why a chain looks the way it does.
+ *
+ * `previewApprovalChain()` answers *what* the chain will be; this answers *why*,
+ * which is the question a support engineer actually has when a purchase order
+ * arrives with a level nobody expected.
+ */
+interface ChainExplanation {
+    templateName: string;
+    levels: ExplainedLevel[];
+    skipped: ExplainedSkip[];
+    rules: ExplainedRule[];
+}
 interface BulkResult {
     succeeded: ApprovalInstance[];
     failed: Array<{
@@ -677,6 +723,28 @@ declare class ApprovalEngine {
     /** Preview the resolved approval chain for a template and document data, without creating an instance. */
     previewApprovalChain(templateName: string, data: Record<string, unknown>, submittedBy: string): Promise<PreviewResult>;
     /** Check whether a user is eligible to approve a specific instance. Never throws. */
+    /**
+     * Explain why a chain resolves the way it does for a given document.
+     *
+     * `previewApprovalChain()` answers *what* the chain will be. This answers
+     * *why*: which rule added a level, which rule removed one, which rules were
+     * evaluated and did not match, and where each level's approvers came from —
+     * the question behind "why does this purchase order have a CFO level?", which
+     * previously meant reading the template and re-evaluating the conditions by
+     * hand.
+     *
+     * A rule that throws — an operator nobody registered, a malformed group — is
+     * reported against that rule rather than failing the whole explanation. The
+     * explanation is a diagnostic tool, and it is least useful at exactly the
+     * moment a broken rule makes it throw.
+     *
+     * Reads nothing and writes nothing; safe to expose to a support UI.
+     *
+     * @param templateName - Template to explain.
+     * @param data - Document data the conditions are evaluated against.
+     * @param submittedBy - Submitter, used for approver resolution.
+     */
+    explainChain(templateName: string, data: Record<string, unknown>, submittedBy: string): Promise<ChainExplanation>;
     canApprove(instanceId: string, userId: string): Promise<CanApproveResult>;
     /** Emergency bypass — completes the instance as 'approved', skipping remaining levels. Requires template.allowOverride = true. */
     override(instanceId: string, raw: OverrideOptions, auditCtx?: AuditContext): Promise<ApprovalInstance>;
@@ -852,6 +920,28 @@ declare class ApprovalEngine {
     private deadlineFromHours;
     /** Level deadline from whichever of days/hours the template configured. */
     private levelEscalationDue;
+    /** First rung of a ladder, sorted by delay, or undefined when there is none. */
+    private firstRungOf;
+    /**
+     * The escalation ladder for an instance, sorted by delay.
+     *
+     * Read from the instance's template snapshot so an in-flight approval keeps
+     * the ladder it was submitted under, exactly as the single-step
+     * {@link EscalationConfig} already did.
+     */
+    private escalationLadder;
+    /**
+     * When a level started collecting decisions.
+     *
+     * Escalation rungs are measured from this, not from the previous rung, so a
+     * ladder reads the way it is written. Recovered from the audit trail — the
+     * `submitted` entry for the opening level, the `level_advanced` entry
+     * otherwise — and falls back to `now` when no entry exists, which only leaves
+     * the ladder no worse off than the single-step behaviour it replaces.
+     */
+    private levelOpenedAt;
+    /** Deadline for one rung, measured from when the level opened. */
+    private stepDueAt;
     private requireInstance;
     /**
      * Identity of the parallel branch group a level belongs to.
@@ -942,4 +1032,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, 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 };
+export { type AddCommentOptions as A, type BulkResult as B, type CanApproveResult as C, type DelegateOptions as D, type EscalateOptions as E, type TemplateBundle as F, type TransferResult as G, type HealthResult as H, type IdGeneratorFn as I, businessHoursCalendar as J, defaultIdGenerator as K, toComparableNumber as L, validateConditionExpression as M, weekendCalendar as N, 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 ChainExplanation as j, type ConditionOperatorFn as k, type CycleTimeStats as l, type ExplainedLevel as m, type ExplainedRule as n, type ExplainedSkip as o, type IdempotencyKeyFn as p, type ImportResult as q, type OutOfOfficeProvider as r, type OverrideOptions as s, type PreviewResult as t, type ProvideInfoOptions as u, type PurgeResult as v, type RejectOptions as w, type RequestInfoOptions as x, type ResubmitOptions as y, type RetryPolicy as z };

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

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

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

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

package/dist/{IAuthorizationPolicy-BryQIKko.d.ts → IAuthorizationPolicy-BOWg-3AH.d.ts}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,4 +1,4 @@
-import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-BO-i9-nq.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-weh2w7Ji.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-Pq9J60xv.cjs';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-BO-i9-nq.cjs';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-yX9ERfQE.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-weh2w7Ji.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-Dw2xXP9B.js';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-BO-i9-nq.js';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-ChPT7ZDp.js';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-weh2w7Ji.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-Pq9J60xv.cjs';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-BO-i9-nq.cjs';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-yX9ERfQE.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-weh2w7Ji.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-Dw2xXP9B.js';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-BO-i9-nq.js';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-ChPT7ZDp.js';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-weh2w7Ji.js';
 
 interface PostgresAdapterOptions {
     connectionString?: string;