hierarchical-approval 1.9.0 → 2.1.0

package/CHANGELOG.md

@@ -7,6 +7,82 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 _Nothing yet._
 
+## [2.1.0] - 2026-09-04
+
+### Added — sub-workflows
+
+- **A level can delegate to a whole separate approval.** "A capital request over
+  1M needs its own board approval before this purchase order can proceed" could
+  only be modelled by flattening the board's chain into the purchase order's —
+  duplicating it in every template that needed it, and losing the board approval
+  as a thing with its own identity, audit trail and lifecycle.
+
+  ```ts
+  { level: 2, name: 'Board approval', mode: 'any', approvers: [],
+    subWorkflow: { templateName: 'BOARD' } }
+  ```
+
+  When the level opens, a child instance is submitted against the named
+  template, carrying the parent's document data so the child's own conditions
+  see the same document. The parent level stays open, with no approvers of its
+  own, until the child finishes.
+
+- **An approved child advances the parent; any other terminal outcome rejects
+  it.** Rejected, cancelled and expired all collapse into one rejection
+  deliberately: a parent that treated a cancelled child as "carry on" would
+  advance past a gate nobody cleared.
+
+- **Children are spawned outside the parent's optimistic write.** The child's own
+  `submit()` reads and writes; nesting that inside the parent's compare-and-set
+  would turn a slow child template into spurious version conflicts on the
+  decision the user just made. The same applies in reverse when a child returns
+  its outcome.
+
+- **Nesting is capped at five levels**, and `validateTemplate()` rejects a
+  template that would spawn itself, sets both `approvers` and `subWorkflow`
+  (whose approvers would never be asked), or names no child template. A
+  sub-workflow level is exempt from the "must have at least one approver" rule,
+  since its child decides it.
+
+  New exports: `SubWorkflowConfig`, `SubWorkflowEvent`. `ApprovalInstance` gains
+  `parentLevel` and `subWorkflowDepth`; levels gain `childInstanceId` and
+  `subWorkflowTemplate`.
+
+## [2.0.0] - 2026-09-04
+
+### BREAKING — `IStorageAdapter` requires `countInstances`
+
+**Only affects custom storage adapters.** The bundled `MemoryAdapter` and
+`PostgresAdapter` implement it; if you use those, upgrading needs no code
+change (run `migrate()` if you have not since 1.7.0).
+
+Reporting needs counts far more often than rows. `getStatistics()` alone issued
+`4N + 5` count queries for a tenant with N templates, and every one of them went
+through `getInstancesByFilter(…, { limit: 1 })` — making the database compute the
+count *and* serialise a complete instance row, JSONB levels and document data
+included, only to discard it. `healthCheck()` did the same.
+
+```ts
+countInstances(tenantId: string, filter: InstanceFilter): Promise<number>;
+```
+
+`PostgresAdapter` answers it with a bare `SELECT COUNT(*)`: no row payload, no
+`COUNT(*) OVER()` window, and the planner is free to satisfy it from an index
+rather than touching the JSONB columns at all. Every filter — including the
+`data` dot-path matching from 1.4.0 — is supported and parameterised.
+
+**Migrating a custom adapter.** One line restores the previous behaviour, and
+you can replace it with a real count query whenever it suits:
+
+```ts
+countInstances = (tenantId, filter) =>
+  this.getInstancesByFilter(tenantId, filter, { limit: 1, offset: 0 }).then((r) => r.total);
+```
+
+No behaviour changes for callers: `getStatistics()` and `healthCheck()` return
+exactly what they did, computed without fetching rows nobody reads. The
+cycle-time sweep still reads rows, because it needs their timestamps.
+
 ## [1.9.0] - 2026-09-04
 
 ### Added — `getWorkload()`

package/README.md

@@ -399,6 +399,24 @@ engine.registerConditionOperator('between', (actual, expected) => {
 });
 ```
 
+### Writing a custom storage adapter
+
+Implement `IStorageAdapter`. Most methods map straightforwardly onto a table;
+one deserves a note:
+
+```ts
+countInstances(tenantId: string, filter: InstanceFilter): Promise<number>;
+```
+
+Reporting asks for counts far more often than rows, so this exists to let the
+database answer with a real `COUNT(*)` rather than fetching a page and reading
+its total. If you have nothing better to hand, one line is a valid start:
+
+```ts
+countInstances = (tenantId, filter) =>
+  this.getInstancesByFilter(tenantId, filter, { limit: 1, offset: 0 }).then((r) => r.total);
+```
+
 ### Who is holding things up
 
 `getStatistics()` answers how the tenant is doing; `getWorkload()` answers who
@@ -450,6 +468,40 @@ 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.
 
+### Sub-workflows
+
+A level can delegate to a whole separate approval instead of to a list of
+approvers — "a capital request over 1M needs its own board approval before this
+purchase order can proceed" — without flattening the board's chain into the
+purchase order's:
+
+```ts
+levels: [
+  { level: 1, name: 'Manager', approvers: [{ type: 'user', userId: 'mgr' }], mode: 'any' },
+  { level: 2, name: 'Board approval', mode: 'any', approvers: [],
+    subWorkflow: { templateName: 'BOARD' } },
+  { level: 3, name: 'CEO', approvers: [{ type: 'user', userId: 'ceo' }], mode: 'any' },
+]
+```
+
+When level 2 opens, a child instance is submitted against `BOARD`, carrying the
+parent's document data so the child's own conditions see the same document. The
+parent level stays open, with no approvers of its own, until the child finishes.
+
+| Child outcome | Parent |
+|---|---|
+| `approved` | Level approved; the chain advances |
+| `rejected`, `cancelled`, `expired` | Parent rejected |
+
+Collapsing the non-approved outcomes into one rejection is deliberate: a parent
+that treated a cancelled child as "carry on" would advance past a gate nobody
+cleared.
+
+Children link back via `parentInstanceId` and `parentLevel`, and the level
+records `childInstanceId`. Nesting is allowed up to five levels deep, and
+`validateTemplate()` rejects a template that would spawn itself. Emits
+`approval:subworkflow_started` / `approval:subworkflow_completed`.
+
 ### Attachments
 
 Attach supporting evidence — a quote PDF, a signed contract, a screenshot of a

package/dist/{ApprovalEngine-a1jXglT3.d.ts → ApprovalEngine-CJwnpnpL.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-DMa5VNNz.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-BE0uJmg3.js';
-import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-Dv_MuYwS.js';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-DjRvHUF0.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 { 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-DWYXVuJD.js';
-import { I as IAuditAdapter } from './IAuditAdapter-DDV4Rf9F.js';
+import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-BGYrAqep.js';
+import { I as IAuditAdapter } from './IAuditAdapter-C4OASS6u.js';
 import { I as IMetricsAdapter } from './IMetricsAdapter-DWq8IFaf.js';
 import { I as ISchedulerAdapter } from './ISchedulerAdapter-DKv_QjVN.js';
-import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-CFJ-gXKl.js';
+import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-BA_m2Dg9.js';
 
 declare const SubmitOptionsSchema: z.ZodObject<{
     templateName: z.ZodString;
@@ -470,7 +470,18 @@ declare class ApprovalEngine {
     updateTemplate(config: ApprovalTemplateConfig): Promise<string>;
     getTemplate(name: string): Promise<ApprovalTemplate>;
     listTemplates(): Promise<ApprovalTemplate[]>;
-    submit(raw: SubmitOptions, auditCtx?: AuditContext): Promise<ApprovalInstance>;
+    submit(raw: SubmitOptions, auditCtx?: AuditContext, 
+    /**
+     * @internal Set only when the engine spawns a sub-workflow child. Passed at
+     * creation rather than stamped afterwards, because the child spawns its own
+     * children before any post-submit update could reach it — which is how a
+     * grandchild ended up recorded at depth 1.
+     */
+    link?: {
+        parentInstanceId: string;
+        parentLevel: number;
+        depth: number;
+    }): Promise<ApprovalInstance>;
     approve(instanceId: string, raw: ApproveOptions, auditCtx?: AuditContext): Promise<ApprovalInstance>;
     reject(instanceId: string, raw: RejectOptions, auditCtx?: AuditContext): Promise<ApprovalInstance>;
     delegate(instanceId: string, raw: DelegateOptions, auditCtx?: AuditContext): Promise<void>;
@@ -736,6 +747,40 @@ declare class ApprovalEngine {
      * half-decided quorum level stops pestering the approvers who did their part.
      */
     private sendReminder;
+    /**
+     * Start child approvals for any open level that delegates to a sub-workflow.
+     *
+     * Run after the parent has been persisted, never inside the same optimistic
+     * write: the child's own `submit()` performs its own reads and writes, and
+     * nesting them under the parent's compare-and-set would make a slow child
+     * template a source of spurious version conflicts on the parent.
+     */
+    private startSubWorkflows;
+    /**
+     * Return a finished child's outcome to the parent level that is waiting on it.
+     *
+     * An approved child approves its parent level and lets the chain advance; any
+     * other terminal outcome — rejected, cancelled, expired — rejects the parent,
+     * because the approval the parent was waiting for did not happen. Collapsing
+     * those into one rejection is deliberate: a parent that treated a cancelled
+     * child as "carry on" would advance past a gate nobody cleared.
+     */
+    private propagateToParent;
+    /** Mark a sub-workflow level approved and advance the parent chain. */
+    private completeSubWorkflowLevel;
+    /** Reject a parent because the child approval it was waiting on did not succeed. */
+    private rejectFromSubWorkflow;
+    /**
+     * Work that must happen after a decision is durably recorded, not inside it.
+     *
+     * Both branches touch other instances — a newly opened level may spawn a
+     * child approval, and a finished instance may be a child that owes its
+     * outcome to a parent. Doing either inside the deciding instance's
+     * compare-and-set would nest writes under a version guard that knows nothing
+     * about them, so a slow child template would surface as a spurious conflict
+     * on the decision the user just made.
+     */
+    private afterDecision;
     private findNextLevel;
     private findPreviousLevel;
     private guardBulkSize;

package/dist/{ApprovalEngine-BDI4r_KB.d.cts → ApprovalEngine-DqRIadYg.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-CRSfnH8U.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-BE0uJmg3.cjs';
-import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-Dy2d0JKy.cjs';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-Bk7ybd3z.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 { 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-DGG-guxK.cjs';
-import { I as IAuditAdapter } from './IAuditAdapter-UJNdJanq.cjs';
+import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-D0ksiFM3.cjs';
+import { I as IAuditAdapter } from './IAuditAdapter-BHVKMMv6.cjs';
 import { I as IMetricsAdapter } from './IMetricsAdapter-DWq8IFaf.cjs';
 import { I as ISchedulerAdapter } from './ISchedulerAdapter-DKv_QjVN.cjs';
-import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-CN6LAaKg.cjs';
+import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-CtLkwQ8I.cjs';
 
 declare const SubmitOptionsSchema: z.ZodObject<{
     templateName: z.ZodString;
@@ -470,7 +470,18 @@ declare class ApprovalEngine {
     updateTemplate(config: ApprovalTemplateConfig): Promise<string>;
     getTemplate(name: string): Promise<ApprovalTemplate>;
     listTemplates(): Promise<ApprovalTemplate[]>;
-    submit(raw: SubmitOptions, auditCtx?: AuditContext): Promise<ApprovalInstance>;
+    submit(raw: SubmitOptions, auditCtx?: AuditContext, 
+    /**
+     * @internal Set only when the engine spawns a sub-workflow child. Passed at
+     * creation rather than stamped afterwards, because the child spawns its own
+     * children before any post-submit update could reach it — which is how a
+     * grandchild ended up recorded at depth 1.
+     */
+    link?: {
+        parentInstanceId: string;
+        parentLevel: number;
+        depth: number;
+    }): Promise<ApprovalInstance>;
     approve(instanceId: string, raw: ApproveOptions, auditCtx?: AuditContext): Promise<ApprovalInstance>;
     reject(instanceId: string, raw: RejectOptions, auditCtx?: AuditContext): Promise<ApprovalInstance>;
     delegate(instanceId: string, raw: DelegateOptions, auditCtx?: AuditContext): Promise<void>;
@@ -736,6 +747,40 @@ declare class ApprovalEngine {
      * half-decided quorum level stops pestering the approvers who did their part.
      */
     private sendReminder;
+    /**
+     * Start child approvals for any open level that delegates to a sub-workflow.
+     *
+     * Run after the parent has been persisted, never inside the same optimistic
+     * write: the child's own `submit()` performs its own reads and writes, and
+     * nesting them under the parent's compare-and-set would make a slow child
+     * template a source of spurious version conflicts on the parent.
+     */
+    private startSubWorkflows;
+    /**
+     * Return a finished child's outcome to the parent level that is waiting on it.
+     *
+     * An approved child approves its parent level and lets the chain advance; any
+     * other terminal outcome — rejected, cancelled, expired — rejects the parent,
+     * because the approval the parent was waiting for did not happen. Collapsing
+     * those into one rejection is deliberate: a parent that treated a cancelled
+     * child as "carry on" would advance past a gate nobody cleared.
+     */
+    private propagateToParent;
+    /** Mark a sub-workflow level approved and advance the parent chain. */
+    private completeSubWorkflowLevel;
+    /** Reject a parent because the child approval it was waiting on did not succeed. */
+    private rejectFromSubWorkflow;
+    /**
+     * Work that must happen after a decision is durably recorded, not inside it.
+     *
+     * Both branches touch other instances — a newly opened level may spawn a
+     * child approval, and a finished instance may be a child that owes its
+     * outcome to a parent. Doing either inside the deciding instance's
+     * compare-and-set would nest writes under a version guard that knows nothing
+     * about them, so a slow child template would surface as a spurious conflict
+     * on the decision the user just made.
+     */
+    private afterDecision;
     private findNextLevel;
     private findPreviousLevel;
     private guardBulkSize;

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

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

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

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

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

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

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

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

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

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, b as AuditEntry } from './instance-BE0uJmg3.js';
+import { a as ApprovalInstance, b as AuditEntry } from './instance-DUJY_Axf.js';
 
 interface ApprovalEvent {
     instanceId: string;
@@ -112,6 +112,14 @@ interface AttachmentEvent extends ApprovalEvent {
     uri: string;
     level?: number;
 }
+/** Emitted when a level hands off to a child approval, and when that child returns. */
+interface SubWorkflowEvent extends ApprovalEvent {
+    level: number;
+    childInstanceId: string;
+    childTemplateName: string;
+    /** Set on completion: the outcome the child returned. */
+    outcome?: 'approved' | 'rejected' | 'cancelled' | 'expired';
+}
 interface ApprovalEventMap {
     'approval:submitted': SubmittedEvent;
     'approval:approved': ApprovedEvent;
@@ -132,6 +140,8 @@ interface ApprovalEventMap {
     'approval:info_provided': InfoProvidedEvent;
     'approval:attachment_added': AttachmentEvent;
     'approval:attachment_removed': AttachmentEvent;
+    'approval:subworkflow_started': SubWorkflowEvent;
+    'approval:subworkflow_completed': SubWorkflowEvent;
 }
 type ApprovalEventName = keyof ApprovalEventMap;
 interface HistoryEntry extends AuditEntry {
@@ -155,4 +165,4 @@ interface INotificationAdapter {
     notify(event: NotificationEvent): Promise<void>;
 }
 
-export type { ApprovalEvent as A, CancelledEvent as C, DataUpdatedEvent as D, EscalatedEvent as E, HistoryEntry as H, INotificationAdapter as I, LevelAdvancedEvent as L, NotificationEvent as N, OverriddenEvent as O, ReassignedEvent as R, SlaBreachedEvent as S, ApprovalEventMap as a, ApprovalEventName as b, ApprovedEvent as c, AttachmentEvent as d, DelegatedEvent as e, ExpiredEvent as f, InfoProvidedEvent as g, InfoRequestedEvent as h, RejectedEvent as i, ReminderEvent as j, ResubmittedEvent as k, SubmittedEvent as l };
+export type { ApprovalEvent as A, CancelledEvent as C, DataUpdatedEvent as D, EscalatedEvent as E, HistoryEntry as H, INotificationAdapter as I, LevelAdvancedEvent as L, NotificationEvent as N, OverriddenEvent as O, ReassignedEvent as R, SlaBreachedEvent as S, ApprovalEventMap as a, ApprovalEventName as b, ApprovedEvent as c, AttachmentEvent as d, DelegatedEvent as e, ExpiredEvent as f, InfoProvidedEvent as g, InfoRequestedEvent as h, RejectedEvent as i, ReminderEvent as j, ResubmittedEvent as k, SubWorkflowEvent as l, SubmittedEvent as m };

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

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, b as AuditEntry } from './instance-BE0uJmg3.cjs';
+import { a as ApprovalInstance, b as AuditEntry } from './instance-DUJY_Axf.cjs';
 
 interface ApprovalEvent {
     instanceId: string;
@@ -112,6 +112,14 @@ interface AttachmentEvent extends ApprovalEvent {
     uri: string;
     level?: number;
 }
+/** Emitted when a level hands off to a child approval, and when that child returns. */
+interface SubWorkflowEvent extends ApprovalEvent {
+    level: number;
+    childInstanceId: string;
+    childTemplateName: string;
+    /** Set on completion: the outcome the child returned. */
+    outcome?: 'approved' | 'rejected' | 'cancelled' | 'expired';
+}
 interface ApprovalEventMap {
     'approval:submitted': SubmittedEvent;
     'approval:approved': ApprovedEvent;
@@ -132,6 +140,8 @@ interface ApprovalEventMap {
     'approval:info_provided': InfoProvidedEvent;
     'approval:attachment_added': AttachmentEvent;
     'approval:attachment_removed': AttachmentEvent;
+    'approval:subworkflow_started': SubWorkflowEvent;
+    'approval:subworkflow_completed': SubWorkflowEvent;
 }
 type ApprovalEventName = keyof ApprovalEventMap;
 interface HistoryEntry extends AuditEntry {
@@ -155,4 +165,4 @@ interface INotificationAdapter {
     notify(event: NotificationEvent): Promise<void>;
 }
 
-export type { ApprovalEvent as A, CancelledEvent as C, DataUpdatedEvent as D, EscalatedEvent as E, HistoryEntry as H, INotificationAdapter as I, LevelAdvancedEvent as L, NotificationEvent as N, OverriddenEvent as O, ReassignedEvent as R, SlaBreachedEvent as S, ApprovalEventMap as a, ApprovalEventName as b, ApprovedEvent as c, AttachmentEvent as d, DelegatedEvent as e, ExpiredEvent as f, InfoProvidedEvent as g, InfoRequestedEvent as h, RejectedEvent as i, ReminderEvent as j, ResubmittedEvent as k, SubmittedEvent as l };
+export type { ApprovalEvent as A, CancelledEvent as C, DataUpdatedEvent as D, EscalatedEvent as E, HistoryEntry as H, INotificationAdapter as I, LevelAdvancedEvent as L, NotificationEvent as N, OverriddenEvent as O, ReassignedEvent as R, SlaBreachedEvent as S, ApprovalEventMap as a, ApprovalEventName as b, ApprovedEvent as c, AttachmentEvent as d, DelegatedEvent as e, ExpiredEvent as f, InfoProvidedEvent as g, InfoRequestedEvent as h, RejectedEvent as i, ReminderEvent as j, ResubmittedEvent as k, SubWorkflowEvent as l, SubmittedEvent as m };

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

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

package/dist/{IOperationMiddleware-DGG-guxK.d.cts → IOperationMiddleware-D0ksiFM3.d.cts}

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

package/dist/{IStorageAdapter-DMa5VNNz.d.ts → IStorageAdapter-Bk7ybd3z.d.cts}

@@ -1,4 +1,4 @@
-import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-BE0uJmg3.js';
+import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-DUJY_Axf.cjs';
 
 interface PaginationOpts {
     limit: number;
@@ -51,6 +51,26 @@ interface IStorageAdapter {
     /** Optional cursor-based pagination — more efficient than offset at scale. */
     getInstancesByCursor?(tenantId: string, filter: InstanceFilter, opts: CursorPaginationOpts): Promise<CursorPaginatedResult<ApprovalInstance>>;
     getOverdueInstances(tenantId: string, asOf: Date, filter?: InstanceFilter): Promise<ApprovalInstance[]>;
+    /**
+     * Count instances matching a filter, without fetching any of them.
+     *
+     * Reporting needs counts far more often than rows: `getStatistics()` alone
+     * issues `4N + 5` of them for a tenant with N templates. Answering those
+     * through `getInstancesByFilter` made the database compute the count *and*
+     * serialise a full instance row — JSONB levels, document data and all — for
+     * every one, only to discard it.
+     *
+     * A custom adapter with nothing better available can satisfy this in one line:
+     *
+     * ```ts
+     * countInstances = (tenantId, filter) =>
+     *   this.getInstancesByFilter(tenantId, filter, { limit: 1, offset: 0 })
+     *       .then((r) => r.total);
+     * ```
+     *
+     * @since 2.0.0 — required. See the release notes for the migration.
+     */
+    countInstances(tenantId: string, filter: InstanceFilter): Promise<number>;
     getIdempotentInstance(tenantId: string, idempotencyKey: string): Promise<ApprovalInstance | null>;
     appendAuditEntry(tenantId: string, instanceId: string, entry: AuditEntry): Promise<void>;
 }

package/dist/{IStorageAdapter-CRSfnH8U.d.cts → IStorageAdapter-DjRvHUF0.d.ts}

@@ -1,4 +1,4 @@
-import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-BE0uJmg3.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-DUJY_Axf.js';
 
 interface PaginationOpts {
     limit: number;
@@ -51,6 +51,26 @@ interface IStorageAdapter {
     /** Optional cursor-based pagination — more efficient than offset at scale. */
     getInstancesByCursor?(tenantId: string, filter: InstanceFilter, opts: CursorPaginationOpts): Promise<CursorPaginatedResult<ApprovalInstance>>;
     getOverdueInstances(tenantId: string, asOf: Date, filter?: InstanceFilter): Promise<ApprovalInstance[]>;
+    /**
+     * Count instances matching a filter, without fetching any of them.
+     *
+     * Reporting needs counts far more often than rows: `getStatistics()` alone
+     * issues `4N + 5` of them for a tenant with N templates. Answering those
+     * through `getInstancesByFilter` made the database compute the count *and*
+     * serialise a full instance row — JSONB levels, document data and all — for
+     * every one, only to discard it.
+     *
+     * A custom adapter with nothing better available can satisfy this in one line:
+     *
+     * ```ts
+     * countInstances = (tenantId, filter) =>
+     *   this.getInstancesByFilter(tenantId, filter, { limit: 1, offset: 0 })
+     *       .then((r) => r.total);
+     * ```
+     *
+     * @since 2.0.0 — required. See the release notes for the migration.
+     */
+    countInstances(tenantId: string, filter: InstanceFilter): Promise<number>;
     getIdempotentInstance(tenantId: string, idempotencyKey: string): Promise<ApprovalInstance | null>;
     appendAuditEntry(tenantId: string, instanceId: string, entry: AuditEntry): Promise<void>;
 }

package/dist/adapters/MemoryAdapter.cjs

@@ -167,6 +167,13 @@ var MemoryAdapter = class {
       return hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry || hasDueReminder;
     }).map((i) => reviveDates(deepClone(i)));
   }
+  async countInstances(tenantId, filter) {
+    let count = 0;
+    for (const instance of this.instances.values()) {
+      if (instance.tenantId === tenantId && applyFilter(instance, filter)) count++;
+    }
+    return count;
+  }
   async getInstancesByCursor(tenantId, filter, opts) {
     const all = [...this.instances.values()].filter((i) => i.tenantId === tenantId && applyFilter(i, filter)).map((i) => reviveDates(deepClone(i))).sort((a, b) => {
       const ta = a.updatedAt.getTime();

package/dist/adapters/MemoryAdapter.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/errors.ts","../../src/adapters/MemoryAdapter.ts"],"names":[],"mappings":";;;AAAO,IAAM,aAAA,GAAN,cAA4B,KAAA,CAAM;AAAA,EACvC,WAAA,CACE,SACgB,IAAA,EAChB;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAFG,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAGhB,IAAA,IAAA,CAAK,IAAA,GAAO,eAAA;AAAA,EACd;AAAA,EAEA,MAAA,GAA0D;AACxD,IAAA,OAAO,EAAE,MAAM,IAAA,CAAK,IAAA,EAAM,SAAS,IAAA,CAAK,OAAA,EAAS,IAAA,EAAM,IAAA,CAAK,IAAA,EAAK;AAAA,EACnE;AAAA,EAEA,YAAA,GAAuB;AACrB,IAAA,MAAM,GAAA,GAA8B;AAAA,MAClC,SAAA,EAAW,GAAA;AAAA,MACX,QAAA,EAAU,GAAA;AAAA,MACV,SAAA,EAAW,GAAA;AAAA,MACX,UAAA,EAAY,GAAA;AAAA,MACZ,kBAAA,EAAoB;AAAA,KACtB;AACA,IAAA,OAAO,GAAA,CAAI,IAAA,CAAK,IAAI,CAAA,IAAK,GAAA;AAAA,EAC3B;AACF,CAAA;AASO,IAAM,qBAAA,GAAN,cAAoC,aAAA,CAAc;AAAA,EACvD,YAAY,UAAA,EAAoB;AAC9B,IAAA,KAAA;AAAA,MACE,iDAAiD,UAAU,CAAA,2DAAA,CAAA;AAAA,MAC3D;AAAA,KACF;AACA,IAAA,IAAA,CAAK,IAAA,GAAO,uBAAA;AAAA,EACd;AACF,CAAA;;;AC7BA,SAAS,UAAa,KAAA,EAAa;AACjC,EAAA,OAAO,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC,CAAA;AACzC;AAEA,SAAS,YAAY,QAAA,EAA8C;AACjE,EAAA,OAAO;AAAA,IACL,GAAG,QAAA;AAAA,IACH,SAAA,EAAW,IAAI,IAAA,CAAK,QAAA,CAAS,SAAS,CAAA;AAAA,IACtC,SAAA,EAAW,IAAI,IAAA,CAAK,QAAA,CAAS,SAAS,CAAA;AAAA,IACtC,WAAW,QAAA,CAAS,SAAA,GAAY,IAAI,IAAA,CAAK,QAAA,CAAS,SAAS,CAAA,GAAI,MAAA;AAAA,IAC/D,eAAe,QAAA,CAAS,aAAA,GAAgB,IAAI,IAAA,CAAK,QAAA,CAAS,aAAa,CAAA,GAAI,MAAA;AAAA,IAC3E,eAAe,QAAA,CAAS,aAAA,GAAgB,IAAI,IAAA,CAAK,QAAA,CAAS,aAAa,CAAA,GAAI,MAAA;AAAA,IAC3E,QAAA,EAAU,QAAA,CAAS,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,MAAO,EAAE,GAAG,CAAA,EAAG,WAAW,IAAI,IAAA,CAAK,CAAA,CAAE,SAAS,GAAE,CAAE,CAAA;AAAA,IACnF,MAAA,EAAQ,QAAA,CAAS,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM;AACjC,MAAA,MAAM,KAAA,GAAkB,EAAE,GAAG,CAAA,EAAE;AAC/B,MAAA,IAAI,EAAE,eAAA,EAAiB,KAAA,CAAM,kBAAkB,IAAI,IAAA,CAAK,EAAE,eAAe,CAAA;AACzE,MAAA,IAAI,EAAE,cAAA,EAAgB,KAAA,CAAM,iBAAiB,IAAI,IAAA,CAAK,EAAE,cAAc,CAAA;AACtE,MAAA,OAAO,KAAA;AAAA,IACT,CAAC;AAAA,GACH;AACF;AAEA,SAAS,oBAAoB,QAAA,EAA8C;AACzE,EAAA,OAAO,EAAE,GAAG,QAAA,EAAU,SAAA,EAAW,IAAI,IAAA,CAAK,QAAA,CAAS,SAAS,CAAA,EAAE;AAChE;AASA,SAAS,QAAA,CAAS,MAA+B,IAAA,EAAuB;AACtE,EAAA,OAAO,KAAK,KAAA,CAAM,GAAG,EAAE,MAAA,CAAgB,CAAC,KAAK,GAAA,KAAQ;AACnD,IAAA,IAAI,GAAA,KAAQ,IAAA,IAAQ,OAAO,GAAA,KAAQ,QAAA,IAAY,MAAA,CAAO,SAAA,CAAU,cAAA,CAAe,IAAA,CAAK,GAAA,EAAK,GAAG,CAAA,EAAG;AAC7F,MAAA,OAAQ,IAAgC,GAAG,CAAA;AAAA,IAC7C;AACA,IAAA,OAAO,MAAA;AAAA,EACT,GAAG,IAAI,CAAA;AACT;AAGA,SAAS,UAAA,CAAW,GAAY,CAAA,EAAqB;AACnD,EAAA,IAAI,MAAA,CAAO,EAAA,CAAG,CAAA,EAAG,CAAC,GAAG,OAAO,IAAA;AAC5B,EAAA,IAAI,CAAA,KAAM,IAAA,IAAQ,CAAA,KAAM,IAAA,IAAQ,OAAO,MAAM,QAAA,IAAY,OAAO,CAAA,KAAM,QAAA,EAAU,OAAO,KAAA;AACvF,EAAA,IAAI,KAAA,CAAM,QAAQ,CAAC,CAAA,KAAM,MAAM,OAAA,CAAQ,CAAC,GAAG,OAAO,KAAA;AAClD,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,CAA4B,CAAA;AACtD,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,CAA4B,CAAA;AACtD,EAAA,IAAI,KAAA,CAAM,MAAA,KAAW,KAAA,CAAM,MAAA,EAAQ,OAAO,KAAA;AAC1C,EAAA,OAAO,KAAA,CAAM,KAAA;AAAA,IACX,CAAC,CAAA,KACC,MAAA,CAAO,SAAA,CAAU,eAAe,IAAA,CAAK,CAAA,EAAG,CAAC,CAAA,IACzC,WAAY,CAAA,CAA8B,CAAC,CAAA,EAAI,CAAA,CAA8B,CAAC,CAAC;AAAA,GACnF;AACF;AAEA,SAAS,WAAA,CAAY,UAA4B,MAAA,EAAiC;AAChF,EAAA,IAAI,OAAO,MAAA,IAAU,QAAA,CAAS,MAAA,KAAW,MAAA,CAAO,QAAQ,OAAO,KAAA;AAC/D,EAAA,IAAI,OAAO,YAAA,IAAgB,QAAA,CAAS,YAAA,KAAiB,MAAA,CAAO,cAAc,OAAO,KAAA;AACjF,EAAA,IAAI,OAAO,WAAA,IAAe,QAAA,CAAS,WAAA,KAAgB,MAAA,CAAO,aAAa,OAAO,KAAA;AAC9E,EAAA,IAAI,OAAO,YAAA,IAAgB,QAAA,CAAS,YAAA,KAAiB,MAAA,CAAO,cAAc,OAAO,KAAA;AAEjF,EAAA,IAAI,MAAA,CAAO,YAAY,IAAI,IAAA,CAAK,SAAS,SAAS,CAAA,GAAI,MAAA,CAAO,QAAA,EAAU,OAAO,KAAA;AAC9E,EAAA,IAAI,MAAA,CAAO,UAAU,IAAI,IAAA,CAAK,SAAS,SAAS,CAAA,GAAI,MAAA,CAAO,MAAA,EAAQ,OAAO,KAAA;AAC1E,EAAA,IAAI,OAAO,IAAA,EAAM;AACf,IAAA,KAAA,MAAW,CAAC,MAAM,QAAQ,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,IAAI,CAAA,EAAG;AAC1D,MAAA,IAAI,CAAC,UAAA,CAAW,QAAA,CAAS,QAAA,CAAS,IAAA,IAAQ,EAAC,EAAG,IAAI,CAAA,EAAG,QAAQ,CAAA,EAAG,OAAO,KAAA;AAAA,IACzE;AAAA,EACF;AACA,EAAA,OAAO,IAAA;AACT;AAEO,IAAM,gBAAN,MAA+C;AAAA,EAA/C,WAAA,GAAA;AAEL;AAAA,IAAA,IAAA,CAAQ,SAAA,uBAAgB,GAAA,EAA8B;AAEtD;AAAA,IAAA,IAAA,CAAQ,SAAA,uBAAgB,GAAA,EAA8B;AAAA,EAAA;AAAA,EAEtD,MAAM,aAAa,QAAA,EAA2C;AAC5D,IAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,CAAA,EAAG,QAAA,CAAS,QAAQ,CAAA,CAAA,EAAI,QAAA,CAAS,IAAI,CAAA,CAAA,EAAI,SAAA,CAAU,QAAQ,CAAC,CAAA;AAAA,EACjF;AAAA,EAEA,MAAM,WAAA,CAAY,QAAA,EAAkB,IAAA,EAAgD;AAClF,IAAA,MAAM,QAAA,GAAW,KAAK,SAAA,CAAU,GAAA,CAAI,GAAG,QAAQ,CAAA,CAAA,EAAI,IAAI,CAAA,CAAE,CAAA;AACzD,IAAA,OAAO,QAAA,GAAW,mBAAA,CAAoB,SAAA,CAAU,QAAQ,CAAC,CAAA,GAAI,IAAA;AAAA,EAC/D;AAAA,EAEA,MAAM,cAAc,QAAA,EAA+C;AACjE,IAAA,MAAM,SAA6B,EAAC;AACpC,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,QAAQ,CAAA,IAAK,KAAK,SAAA,EAAW;AAC5C,MAAA,IAAI,GAAA,CAAI,UAAA,CAAW,CAAA,EAAG,QAAQ,GAAG,CAAA,EAAG;AAClC,QAAA,MAAA,CAAO,IAAA,CAAK,mBAAA,CAAoB,SAAA,CAAU,QAAQ,CAAC,CAAC,CAAA;AAAA,MACtD;AAAA,IACF;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AAAA,EAEA,MAAM,aAAa,QAAA,EAA2C;AAC5D,IAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,CAAA,EAAG,QAAA,CAAS,QAAQ,CAAA,CAAA,EAAI,QAAA,CAAS,EAAE,CAAA,CAAA,EAAI,SAAA,CAAU,QAAQ,CAAC,CAAA;AAAA,EAC/E;AAAA,EAEA,MAAM,cAAA,CAAe,QAAA,EAA4B,eAAA,EAAwC;AACvF,IAAA,MAAM,MAAM,CAAA,EAAG,QAAA,CAAS,QAAQ,CAAA,CAAA,EAAI,SAAS,EAAE,CAAA,CAAA;AAC/C,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,GAAG,CAAA;AACrC,IAAA,IAAI,CAAC,MAAA,EAAQ,MAAM,IAAI,qBAAA,CAAsB,SAAS,EAAE,CAAA;AACxD,IAAA,IAAI,OAAO,OAAA,KAAY,eAAA,QAAuB,IAAI,qBAAA,CAAsB,SAAS,EAAE,CAAA;AACnF,IAAA,MAAM,OAAA,GAAU,UAAU,QAAQ,CAAA;AAClC,IAAA,OAAA,CAAQ,UAAU,eAAA,GAAkB,CAAA;AACpC,IAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,GAAA,EAAK,OAAO,CAAA;AAAA,EACjC;AAAA,EAEA,MAAM,WAAA,CAAY,QAAA,EAAkB,EAAA,EAA8C;AAChF,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,CAAU,GAAA,CAAI,GAAG,QAAQ,CAAA,CAAA,EAAI,EAAE,CAAA,CAAE,CAAA;AAClD,IAAA,IAAI,CAAC,KAAK,OAAO,IAAA;AACjB,IAAA,OAAO,WAAA,CAAY,SAAA,CAAU,GAAG,CAAC,CAAA;AAAA,EACnC;AAAA,EAEA,MAAM,sBAAA,CACJ,QAAA,EACA,UAAA,EACA,IAAA,EAC4C;AAC5C,IAAA,MAAM,GAAA,GAAM,CAAC,GAAG,IAAA,CAAK,SAAA,CAAU,QAAQ,CAAA,CAAE,MAAA,CAAO,CAAC,CAAA,KAAM;AACrD,MAAA,IAAI,EAAE,QAAA,KAAa,QAAA,IAAY,CAAA,CAAE,MAAA,KAAW,WAAW,OAAO,KAAA;AAE9D,MAAA,MAAM,YAAA,GAAe,EAAE,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,KAAA,KAAU,CAAA,CAAE,YAAY,CAAA;AACpE,MAAA,OAAO,YAAA,EAAc,WAAA,CAAY,QAAA,CAAS,UAAU,CAAA,IAAK,KAAA;AAAA,IAC3D,CAAC,CAAA;AACD,IAAA,OAAO,QAAA;AAAA,MACL,GAAA,CAAI,IAAI,CAAC,CAAA,KAAM,YAAY,SAAA,CAAU,CAAC,CAAC,CAAC,CAAA;AAAA,MACxC;AAAA,KACF;AAAA,EACF;AAAA,EAEA,MAAM,oBAAA,CACJ,QAAA,EACA,MAAA,EACA,IAAA,EAC4C;AAC5C,IAAA,MAAM,MAAM,CAAC,GAAG,KAAK,SAAA,CAAU,MAAA,EAAQ,CAAA,CAAE,MAAA;AAAA,MACvC,CAAC,CAAA,KAAM,CAAA,CAAE,aAAa,QAAA,IAAY,WAAA,CAAY,GAAG,MAAM;AAAA,KACzD;AACA,IAAA,OAAO,QAAA;AAAA,MACL,GAAA,CAAI,IAAI,CAAC,CAAA,KAAM,YAAY,SAAA,CAAU,CAAC,CAAC,CAAC,CAAA;AAAA,MACxC;AAAA,KACF;AAAA,EACF;AAAA,EAEA,MAAM,mBAAA,CACJ,QAAA,EACA,IAAA,EACA,MAAA,GAAyB,EAAC,EACG;AAC7B,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,SAAA,CAAU,QAAQ,CAAA,CAC/B,MAAA,CAAO,CAAC,CAAA,KAAM;AACb,MAAA,IAAI,EAAE,QAAA,KAAa,QAAA,IAAY,CAAA,CAAE,MAAA,KAAW,WAAW,OAAO,KAAA;AAC9D,MAAA,IAAI,OAAO,YAAA,IAAgB,CAAA,CAAE,YAAA,KAAiB,MAAA,CAAO,cAAc,OAAO,KAAA;AAC1E,MAAA,IAAI,OAAO,WAAA,IAAe,CAAA,CAAE,WAAA,KAAgB,MAAA,CAAO,aAAa,OAAO,KAAA;AAKvE,MAAA,MAAM,oBAAA,GAAuB,EAAE,MAAA,CAAO,IAAA;AAAA,QACpC,CAAC,MAAM,CAAA,CAAE,eAAA,IAAmB,QAAQ,IAAI,IAAA,CAAK,CAAA,CAAE,eAAe,CAAA,IAAK;AAAA,OACrE;AAEA,MAAA,MAAM,SAAA,GAAY,EAAE,SAAA,IAAa,IAAA,IAAQ,IAAI,IAAA,CAAK,CAAA,CAAE,SAAS,CAAA,IAAK,IAAA;AAElE,MAAA,MAAM,YAAA,GACJ,CAAA,CAAE,aAAA,IAAiB,IAAA,IAAQ,IAAI,IAAA,CAAK,CAAA,CAAE,aAAa,CAAA,IAAK,IAAA,IAAQ,CAAC,CAAA,CAAE,aAAA;AAErE,MAAA,MAAM,mBAAA,GAAsB,EAAE,MAAA,CAAO,IAAA;AAAA,QACnC,CAAC,CAAA,KACC,CAAA,CAAE,MAAA,KAAW,aACb,CAAA,CAAE,cAAA,IAAkB,IAAA,IACpB,IAAI,KAAK,CAAA,CAAE,cAAc,CAAA,IAAK,IAAA,IAC9B,EAAE,aAAA,IAAiB;AAAA,OACvB;AAGA,MAAA,MAAM,cAAA,GAAiB,EAAE,MAAA,CAAO,IAAA;AAAA,QAC9B,CAAC,CAAA,KACC,CAAA,CAAE,MAAA,KAAW,SAAA,IAAa,CAAA,CAAE,aAAA,IAAiB,IAAA,IAAQ,IAAI,IAAA,CAAK,CAAA,CAAE,aAAa,CAAA,IAAK;AAAA,OACtF;AACA,MAAA,OACE,oBAAA,IAAwB,SAAA,IAAa,YAAA,IAAgB,mBAAA,IAAuB,cAAA;AAAA,IAEhF,CAAC,EACA,GAAA,CAAI,CAAC,MAAM,WAAA,CAAY,SAAA,CAAU,CAAC,CAAC,CAAC,CAAA;AAAA,EACzC;AAAA,EAEA,MAAM,oBAAA,CACJ,QAAA,EACA,MAAA,EACA,IAAA,EACkD;AAClD,IAAA,MAAM,GAAA,GAAM,CAAC,GAAG,IAAA,CAAK,SAAA,CAAU,MAAA,EAAQ,CAAA,CACpC,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,aAAa,QAAA,IAAY,WAAA,CAAY,CAAA,EAAG,MAAM,CAAC,CAAA,CAC/D,GAAA,CAAI,CAAC,MAAM,WAAA,CAAY,SAAA,CAAU,CAAC,CAAC,CAAC,CAAA,CACpC,IAAA,CAAK,CAAC,GAAG,CAAA,KAAM;AACd,MAAA,MAAM,EAAA,GAAK,CAAA,CAAE,SAAA,CAAU,OAAA,EAAQ;AAC/B,MAAA,MAAM,EAAA,GAAK,CAAA,CAAE,SAAA,CAAU,OAAA,EAAQ;AAC/B,MAAA,OAAO,EAAA,KAAO,KAAK,EAAA,GAAK,EAAA,GAAK,EAAE,EAAA,CAAG,aAAA,CAAc,EAAE,EAAE,CAAA;AAAA,IACtD,CAAC,CAAA;AAEH,IAAA,MAAM,EAAE,MAAA,EAAQ,KAAA,EAAO,SAAA,GAAY,WAAU,GAAI,IAAA;AACjD,IAAA,IAAI,QAAA,GAAW,CAAA;AAEf,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,MAAM,CAAC,EAAA,EAAI,EAAE,CAAA,GAAI,aAAa,MAAM,CAAA;AACpC,MAAA,MAAM,MAAM,GAAA,CAAI,SAAA;AAAA,QACd,CAAC,CAAA,KAAM,CAAA,CAAE,SAAA,CAAU,OAAA,EAAQ,GAAI,EAAA,IAAO,CAAA,CAAE,SAAA,CAAU,OAAA,EAAQ,KAAM,EAAA,IAAM,EAAE,EAAA,GAAK;AAAA,OAC/E;AACA,MAAA,QAAA,GAAW,GAAA,KAAQ,EAAA,GAAK,GAAA,CAAI,MAAA,GAAS,GAAA;AAAA,IACvC;AAEA,IAAA,IAAI,SAAA,KAAc,UAAA,IAAc,QAAA,GAAW,CAAA,EAAG;AAC5C,MAAA,QAAA,GAAW,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,QAAA,GAAW,QAAQ,CAAC,CAAA;AAAA,IAC7C;AAEA,IAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,KAAA,CAAM,QAAA,EAAU,WAAW,KAAK,CAAA;AAClD,IAAA,MAAM,OAAA,GAAU,QAAA,GAAW,KAAA,GAAQ,GAAA,CAAI,MAAA;AACvC,IAAA,MAAM,UAAA,GAAa,UAAU,YAAA,CAAa,KAAA,CAAM,MAAM,MAAA,GAAS,CAAC,CAAE,CAAA,GAAI,MAAA;AACtE,IAAA,MAAM,UAAA,GAAa,WAAW,CAAA,GAAI,YAAA,CAAa,IAAI,QAAA,GAAW,CAAC,CAAE,CAAA,GAAI,MAAA;AAErE,IAAA,OAAO,EAAE,KAAA,EAAO,KAAA,EAAO,UAAA,EAAY,YAAY,OAAA,EAAQ;AAAA,EACzD;AAAA,EAEA,MAAM,qBAAA,CACJ,QAAA,EACA,cAAA,EACkC;AAClC,IAAA,KAAA,MAAW,QAAA,IAAY,IAAA,CAAK,SAAA,CAAU,MAAA,EAAO,EAAG;AAC9C,MAAA,IAAI,QAAA,CAAS,QAAA,KAAa,QAAA,IAAY,QAAA,CAAS,mBAAmB,cAAA,EAAgB;AAChF,QAAA,OAAO,WAAA,CAAY,SAAA,CAAU,QAAQ,CAAC,CAAA;AAAA,MACxC;AAAA,IACF;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,MAAM,gBAAA,CACJ,SAAA,EACA,WAAA,EACA,MAAA,EACe;AAAA,EAMjB;AAAA;AAAA,EAGA,IAAI,IAAA,GAAe;AACjB,IAAA,OAAO,KAAK,SAAA,CAAU,IAAA;AAAA,EACxB;AACF;AAEA,SAAS,QAAA,CAAY,OAAY,IAAA,EAA2C;AAC1E,EAAA,MAAM,QAAQ,KAAA,CAAM,MAAA;AACpB,EAAA,IAAI,CAAC,IAAA,EAAM,OAAO,EAAE,OAAO,KAAA,EAAM;AACjC,EAAA,OAAO,EAAE,KAAA,EAAO,KAAA,CAAM,KAAA,CAAM,IAAA,CAAK,MAAA,EAAQ,IAAA,CAAK,MAAA,GAAS,IAAA,CAAK,KAAK,CAAA,EAAG,KAAA,EAAM;AAC5E;AAEA,SAAS,aAAa,QAAA,EAAoC;AACxD,EAAA,OAAO,MAAA,CAAO,IAAA,CAAK,CAAA,EAAG,QAAA,CAAS,SAAA,CAAU,OAAA,EAAS,CAAA,CAAA,EAAI,QAAA,CAAS,EAAE,CAAA,CAAE,CAAA,CAAE,SAAS,QAAQ,CAAA;AACxF;AAEA,SAAS,aAAa,MAAA,EAAkC;AACtD,EAAA,MAAM,UAAU,MAAA,CAAO,IAAA,CAAK,QAAQ,QAAQ,CAAA,CAAE,SAAS,MAAM,CAAA;AAC7D,EAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,OAAA,CAAQ,GAAG,CAAA;AACnC,EAAA,OAAO,CAAC,MAAA,CAAO,OAAA,CAAQ,KAAA,CAAM,CAAA,EAAG,OAAO,CAAC,CAAA,EAAG,OAAA,CAAQ,KAAA,CAAM,OAAA,GAAU,CAAC,CAAC,CAAA;AACvE","file":"MemoryAdapter.cjs","sourcesContent":["export class ApprovalError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n  ) {\n    super(message);\n    this.name = 'ApprovalError';\n  }\n\n  toJSON(): { code: string; message: string; name: string } {\n    return { code: this.code, message: this.message, name: this.name };\n  }\n\n  toHttpStatus(): number {\n    const map: Record<string, number> = {\n      NOT_FOUND: 404,\n      CONFLICT: 409,\n      FORBIDDEN: 403,\n      VALIDATION: 422,\n      TEMPLATE_NOT_FOUND: 404,\n    };\n    return map[this.code] ?? 500;\n  }\n}\n\nexport class ApprovalNotFoundError extends ApprovalError {\n  constructor(resource: string, id: string) {\n    super(`${resource} \"${id}\" not found.`, 'NOT_FOUND');\n    this.name = 'ApprovalNotFoundError';\n  }\n}\n\nexport class ApprovalConflictError extends ApprovalError {\n  constructor(instanceId: string) {\n    super(\n      `Concurrent modification detected on instance \"${instanceId}\". The record was updated by another process. Please retry.`,\n      'CONFLICT',\n    );\n    this.name = 'ApprovalConflictError';\n  }\n}\n\nexport class ApprovalForbiddenError extends ApprovalError {\n  constructor(message: string) {\n    super(message, 'FORBIDDEN');\n    this.name = 'ApprovalForbiddenError';\n  }\n}\n\nexport class ApprovalValidationError extends ApprovalError {\n  constructor(\n    message: string,\n    public readonly cause?: unknown,\n  ) {\n    super(message, 'VALIDATION');\n    this.name = 'ApprovalValidationError';\n  }\n}\n\nexport class ApprovalTemplateNotFoundError extends ApprovalError {\n  constructor(name: string) {\n    super(`Template \"${name}\" not found.`, 'TEMPLATE_NOT_FOUND');\n    this.name = 'ApprovalTemplateNotFoundError';\n  }\n}\n","import type {\n  IStorageAdapter,\n  PaginationOpts,\n  PaginatedResult,\n  InstanceFilter,\n  CursorPaginationOpts,\n  CursorPaginatedResult,\n} from './IStorageAdapter.js';\nimport type { ApprovalTemplate, ApprovalInstance, AuditEntry } from '../types/index.js';\nimport { ApprovalConflictError } from '../errors.js';\n\nfunction deepClone<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\nfunction reviveDates(instance: ApprovalInstance): ApprovalInstance {\n  return {\n    ...instance,\n    createdAt: new Date(instance.createdAt),\n    updatedAt: new Date(instance.updatedAt),\n    expiresAt: instance.expiresAt ? new Date(instance.expiresAt) : undefined,\n    slaDeadlineAt: instance.slaDeadlineAt ? new Date(instance.slaDeadlineAt) : undefined,\n    slaBreachedAt: instance.slaBreachedAt ? new Date(instance.slaBreachedAt) : undefined,\n    auditLog: instance.auditLog.map((e) => ({ ...e, timestamp: new Date(e.timestamp) })),\n    levels: instance.levels.map((l) => {\n      const level: typeof l = { ...l };\n      if (l.escalationDueAt) level.escalationDueAt = new Date(l.escalationDueAt);\n      if (l.delegatedUntil) level.delegatedUntil = new Date(l.delegatedUntil);\n      return level;\n    }),\n  };\n}\n\nfunction reviveTemplateDates(template: ApprovalTemplate): ApprovalTemplate {\n  return { ...template, createdAt: new Date(template.createdAt) };\n}\n\n/**\n * Read a dot-path from a document, over **own** properties only.\n *\n * Mirrors how conditions resolve field paths, so a filter and a condition\n * written against the same path agree about what that path means — and an\n * inherited prototype member can never make an instance match a query.\n */\nfunction readPath(data: Record<string, unknown>, path: string): unknown {\n  return path.split('.').reduce<unknown>((obj, key) => {\n    if (obj !== null && typeof obj === 'object' && Object.prototype.hasOwnProperty.call(obj, key)) {\n      return (obj as Record<string, unknown>)[key];\n    }\n    return undefined;\n  }, data);\n}\n\n/** Structural equality, so a filter can match an object or array value. */\nfunction deepEquals(a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return true;\n  if (a === null || b === null || typeof a !== 'object' || typeof b !== 'object') return false;\n  if (Array.isArray(a) !== Array.isArray(b)) return false;\n  const aKeys = Object.keys(a as Record<string, unknown>);\n  const bKeys = Object.keys(b as Record<string, unknown>);\n  if (aKeys.length !== bKeys.length) return false;\n  return aKeys.every(\n    (k) =>\n      Object.prototype.hasOwnProperty.call(b, k) &&\n      deepEquals((a as Record<string, unknown>)[k], (b as Record<string, unknown>)[k]),\n  );\n}\n\nfunction applyFilter(instance: ApprovalInstance, filter: InstanceFilter): boolean {\n  if (filter.status && instance.status !== filter.status) return false;\n  if (filter.documentType && instance.documentType !== filter.documentType) return false;\n  if (filter.submittedBy && instance.submittedBy !== filter.submittedBy) return false;\n  if (filter.templateName && instance.templateName !== filter.templateName) return false;\n  // Stored instances carry string dates (deepClone JSON round-trip), so wrap before comparing.\n  if (filter.fromDate && new Date(instance.createdAt) < filter.fromDate) return false;\n  if (filter.toDate && new Date(instance.createdAt) > filter.toDate) return false;\n  if (filter.data) {\n    for (const [path, expected] of Object.entries(filter.data)) {\n      if (!deepEquals(readPath(instance.data ?? {}, path), expected)) return false;\n    }\n  }\n  return true;\n}\n\nexport class MemoryAdapter implements IStorageAdapter {\n  // keyed by `${tenantId}:${template.name}`\n  private templates = new Map<string, ApprovalTemplate>();\n  // keyed by `${tenantId}:${instance.id}`\n  private instances = new Map<string, ApprovalInstance>();\n\n  async saveTemplate(template: ApprovalTemplate): Promise<void> {\n    this.templates.set(`${template.tenantId}:${template.name}`, deepClone(template));\n  }\n\n  async getTemplate(tenantId: string, name: string): Promise<ApprovalTemplate | null> {\n    const template = this.templates.get(`${tenantId}:${name}`);\n    return template ? reviveTemplateDates(deepClone(template)) : null;\n  }\n\n  async listTemplates(tenantId: string): Promise<ApprovalTemplate[]> {\n    const result: ApprovalTemplate[] = [];\n    for (const [key, template] of this.templates) {\n      if (key.startsWith(`${tenantId}:`)) {\n        result.push(reviveTemplateDates(deepClone(template)));\n      }\n    }\n    return result;\n  }\n\n  async saveInstance(instance: ApprovalInstance): Promise<void> {\n    this.instances.set(`${instance.tenantId}:${instance.id}`, deepClone(instance));\n  }\n\n  async updateInstance(instance: ApprovalInstance, expectedVersion: number): Promise<void> {\n    const key = `${instance.tenantId}:${instance.id}`;\n    const stored = this.instances.get(key);\n    if (!stored) throw new ApprovalConflictError(instance.id);\n    if (stored.version !== expectedVersion) throw new ApprovalConflictError(instance.id);\n    const updated = deepClone(instance);\n    updated.version = expectedVersion + 1;\n    this.instances.set(key, updated);\n  }\n\n  async getInstance(tenantId: string, id: string): Promise<ApprovalInstance | null> {\n    const raw = this.instances.get(`${tenantId}:${id}`);\n    if (!raw) return null;\n    return reviveDates(deepClone(raw));\n  }\n\n  async getInstancesByApprover(\n    tenantId: string,\n    approverId: string,\n    opts?: PaginationOpts,\n  ): Promise<PaginatedResult<ApprovalInstance>> {\n    const all = [...this.instances.values()].filter((i) => {\n      if (i.tenantId !== tenantId || i.status !== 'pending') return false;\n      // Use .find() by level number, not array index (level numbers may not be consecutive)\n      const currentLevel = i.levels.find((l) => l.level === i.currentLevel);\n      return currentLevel?.approverIds.includes(approverId) ?? false;\n    });\n    return paginate(\n      all.map((i) => reviveDates(deepClone(i))),\n      opts,\n    );\n  }\n\n  async getInstancesByFilter(\n    tenantId: string,\n    filter: InstanceFilter,\n    opts?: PaginationOpts,\n  ): Promise<PaginatedResult<ApprovalInstance>> {\n    const all = [...this.instances.values()].filter(\n      (i) => i.tenantId === tenantId && applyFilter(i, filter),\n    );\n    return paginate(\n      all.map((i) => reviveDates(deepClone(i))),\n      opts,\n    );\n  }\n\n  async getOverdueInstances(\n    tenantId: string,\n    asOf: Date,\n    filter: InstanceFilter = {},\n  ): Promise<ApprovalInstance[]> {\n    return [...this.instances.values()]\n      .filter((i) => {\n        if (i.tenantId !== tenantId || i.status !== 'pending') return false;\n        if (filter.documentType && i.documentType !== filter.documentType) return false;\n        if (filter.submittedBy && i.submittedBy !== filter.submittedBy) return false;\n        // Escalation overdue on ANY open branch. Filtering to i.currentLevel\n        // would miss the upper branches of a parallel group entirely, and left\n        // this adapter disagreeing with PostgresAdapter, which already scans\n        // every level.\n        const hasOverdueEscalation = i.levels.some(\n          (l) => l.escalationDueAt != null && new Date(l.escalationDueAt) <= asOf,\n        );\n        // Instance deadline expired\n        const isExpired = i.expiresAt != null && new Date(i.expiresAt) <= asOf;\n        // SLA breach (not yet recorded)\n        const hasSLABreach =\n          i.slaDeadlineAt != null && new Date(i.slaDeadlineAt) <= asOf && !i.slaBreachedAt;\n        // Delegation expiry on any pending level\n        const hasDelegationExpiry = i.levels.some(\n          (l) =>\n            l.status === 'pending' &&\n            l.delegatedUntil != null &&\n            new Date(l.delegatedUntil) <= asOf &&\n            l.delegatedFrom != null,\n        );\n        // Reminder due on any open branch. Without this the scheduler never\n        // sees the instance and no reminder is ever sent.\n        const hasDueReminder = i.levels.some(\n          (l) =>\n            l.status === 'pending' && l.reminderDueAt != null && new Date(l.reminderDueAt) <= asOf,\n        );\n        return (\n          hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry || hasDueReminder\n        );\n      })\n      .map((i) => reviveDates(deepClone(i)));\n  }\n\n  async getInstancesByCursor(\n    tenantId: string,\n    filter: InstanceFilter,\n    opts: CursorPaginationOpts,\n  ): Promise<CursorPaginatedResult<ApprovalInstance>> {\n    const all = [...this.instances.values()]\n      .filter((i) => i.tenantId === tenantId && applyFilter(i, filter))\n      .map((i) => reviveDates(deepClone(i)))\n      .sort((a, b) => {\n        const ta = a.updatedAt.getTime();\n        const tb = b.updatedAt.getTime();\n        return ta !== tb ? ta - tb : a.id.localeCompare(b.id);\n      });\n\n    const { cursor, limit, direction = 'forward' } = opts;\n    let startIdx = 0;\n\n    if (cursor) {\n      const [ts, id] = decodeCursor(cursor);\n      const idx = all.findIndex(\n        (i) => i.updatedAt.getTime() > ts || (i.updatedAt.getTime() === ts && i.id > id),\n      );\n      startIdx = idx === -1 ? all.length : idx;\n    }\n\n    if (direction === 'backward' && startIdx > 0) {\n      startIdx = Math.max(0, startIdx - limit - 1);\n    }\n\n    const slice = all.slice(startIdx, startIdx + limit);\n    const hasMore = startIdx + limit < all.length;\n    const nextCursor = hasMore ? encodeCursor(slice[slice.length - 1]!) : undefined;\n    const prevCursor = startIdx > 0 ? encodeCursor(all[startIdx - 1]!) : undefined;\n\n    return { items: slice, nextCursor, prevCursor, hasMore };\n  }\n\n  async getIdempotentInstance(\n    tenantId: string,\n    idempotencyKey: string,\n  ): Promise<ApprovalInstance | null> {\n    for (const instance of this.instances.values()) {\n      if (instance.tenantId === tenantId && instance.idempotencyKey === idempotencyKey) {\n        return reviveDates(deepClone(instance));\n      }\n    }\n    return null;\n  }\n\n  async appendAuditEntry(\n    _tenantId: string,\n    _instanceId: string,\n    _entry: AuditEntry,\n  ): Promise<void> {\n    // No-op by design. The engine already pushes each entry onto instance.auditLog\n    // and persists the whole instance via saveInstance()/updateInstance(), so the\n    // embedded log is the source of truth for this adapter. Pushing here too would\n    // duplicate every entry (as a dedicated, append-only audit table would in\n    // PostgresAdapter, this method exists to satisfy that separate-sink contract).\n  }\n\n  /** Test helper — total stored instances across all tenants. */\n  get size(): number {\n    return this.instances.size;\n  }\n}\n\nfunction paginate<T>(items: T[], opts?: PaginationOpts): PaginatedResult<T> {\n  const total = items.length;\n  if (!opts) return { items, total };\n  return { items: items.slice(opts.offset, opts.offset + opts.limit), total };\n}\n\nfunction encodeCursor(instance: ApprovalInstance): string {\n  return Buffer.from(`${instance.updatedAt.getTime()}|${instance.id}`).toString('base64');\n}\n\nfunction decodeCursor(cursor: string): [number, string] {\n  const decoded = Buffer.from(cursor, 'base64').toString('utf8');\n  const pipeIdx = decoded.indexOf('|');\n  return [Number(decoded.slice(0, pipeIdx)), decoded.slice(pipeIdx + 1)];\n}\n"]}
+{"version":3,"sources":["../../src/errors.ts","../../src/adapters/MemoryAdapter.ts"],"names":[],"mappings":"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","file":"MemoryAdapter.cjs","sourcesContent":["export class ApprovalError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n  ) {\n    super(message);\n    this.name = 'ApprovalError';\n  }\n\n  toJSON(): { code: string; message: string; name: string } {\n    return { code: this.code, message: this.message, name: this.name };\n  }\n\n  toHttpStatus(): number {\n    const map: Record<string, number> = {\n      NOT_FOUND: 404,\n      CONFLICT: 409,\n      FORBIDDEN: 403,\n      VALIDATION: 422,\n      TEMPLATE_NOT_FOUND: 404,\n    };\n    return map[this.code] ?? 500;\n  }\n}\n\nexport class ApprovalNotFoundError extends ApprovalError {\n  constructor(resource: string, id: string) {\n    super(`${resource} \"${id}\" not found.`, 'NOT_FOUND');\n    this.name = 'ApprovalNotFoundError';\n  }\n}\n\nexport class ApprovalConflictError extends ApprovalError {\n  constructor(instanceId: string) {\n    super(\n      `Concurrent modification detected on instance \"${instanceId}\". The record was updated by another process. Please retry.`,\n      'CONFLICT',\n    );\n    this.name = 'ApprovalConflictError';\n  }\n}\n\nexport class ApprovalForbiddenError extends ApprovalError {\n  constructor(message: string) {\n    super(message, 'FORBIDDEN');\n    this.name = 'ApprovalForbiddenError';\n  }\n}\n\nexport class ApprovalValidationError extends ApprovalError {\n  constructor(\n    message: string,\n    public readonly cause?: unknown,\n  ) {\n    super(message, 'VALIDATION');\n    this.name = 'ApprovalValidationError';\n  }\n}\n\nexport class ApprovalTemplateNotFoundError extends ApprovalError {\n  constructor(name: string) {\n    super(`Template \"${name}\" not found.`, 'TEMPLATE_NOT_FOUND');\n    this.name = 'ApprovalTemplateNotFoundError';\n  }\n}\n","import type {\n  IStorageAdapter,\n  PaginationOpts,\n  PaginatedResult,\n  InstanceFilter,\n  CursorPaginationOpts,\n  CursorPaginatedResult,\n} from './IStorageAdapter.js';\nimport type { ApprovalTemplate, ApprovalInstance, AuditEntry } from '../types/index.js';\nimport { ApprovalConflictError } from '../errors.js';\n\nfunction deepClone<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\nfunction reviveDates(instance: ApprovalInstance): ApprovalInstance {\n  return {\n    ...instance,\n    createdAt: new Date(instance.createdAt),\n    updatedAt: new Date(instance.updatedAt),\n    expiresAt: instance.expiresAt ? new Date(instance.expiresAt) : undefined,\n    slaDeadlineAt: instance.slaDeadlineAt ? new Date(instance.slaDeadlineAt) : undefined,\n    slaBreachedAt: instance.slaBreachedAt ? new Date(instance.slaBreachedAt) : undefined,\n    auditLog: instance.auditLog.map((e) => ({ ...e, timestamp: new Date(e.timestamp) })),\n    levels: instance.levels.map((l) => {\n      const level: typeof l = { ...l };\n      if (l.escalationDueAt) level.escalationDueAt = new Date(l.escalationDueAt);\n      if (l.delegatedUntil) level.delegatedUntil = new Date(l.delegatedUntil);\n      return level;\n    }),\n  };\n}\n\nfunction reviveTemplateDates(template: ApprovalTemplate): ApprovalTemplate {\n  return { ...template, createdAt: new Date(template.createdAt) };\n}\n\n/**\n * Read a dot-path from a document, over **own** properties only.\n *\n * Mirrors how conditions resolve field paths, so a filter and a condition\n * written against the same path agree about what that path means — and an\n * inherited prototype member can never make an instance match a query.\n */\nfunction readPath(data: Record<string, unknown>, path: string): unknown {\n  return path.split('.').reduce<unknown>((obj, key) => {\n    if (obj !== null && typeof obj === 'object' && Object.prototype.hasOwnProperty.call(obj, key)) {\n      return (obj as Record<string, unknown>)[key];\n    }\n    return undefined;\n  }, data);\n}\n\n/** Structural equality, so a filter can match an object or array value. */\nfunction deepEquals(a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return true;\n  if (a === null || b === null || typeof a !== 'object' || typeof b !== 'object') return false;\n  if (Array.isArray(a) !== Array.isArray(b)) return false;\n  const aKeys = Object.keys(a as Record<string, unknown>);\n  const bKeys = Object.keys(b as Record<string, unknown>);\n  if (aKeys.length !== bKeys.length) return false;\n  return aKeys.every(\n    (k) =>\n      Object.prototype.hasOwnProperty.call(b, k) &&\n      deepEquals((a as Record<string, unknown>)[k], (b as Record<string, unknown>)[k]),\n  );\n}\n\nfunction applyFilter(instance: ApprovalInstance, filter: InstanceFilter): boolean {\n  if (filter.status && instance.status !== filter.status) return false;\n  if (filter.documentType && instance.documentType !== filter.documentType) return false;\n  if (filter.submittedBy && instance.submittedBy !== filter.submittedBy) return false;\n  if (filter.templateName && instance.templateName !== filter.templateName) return false;\n  // Stored instances carry string dates (deepClone JSON round-trip), so wrap before comparing.\n  if (filter.fromDate && new Date(instance.createdAt) < filter.fromDate) return false;\n  if (filter.toDate && new Date(instance.createdAt) > filter.toDate) return false;\n  if (filter.data) {\n    for (const [path, expected] of Object.entries(filter.data)) {\n      if (!deepEquals(readPath(instance.data ?? {}, path), expected)) return false;\n    }\n  }\n  return true;\n}\n\nexport class MemoryAdapter implements IStorageAdapter {\n  // keyed by `${tenantId}:${template.name}`\n  private templates = new Map<string, ApprovalTemplate>();\n  // keyed by `${tenantId}:${instance.id}`\n  private instances = new Map<string, ApprovalInstance>();\n\n  async saveTemplate(template: ApprovalTemplate): Promise<void> {\n    this.templates.set(`${template.tenantId}:${template.name}`, deepClone(template));\n  }\n\n  async getTemplate(tenantId: string, name: string): Promise<ApprovalTemplate | null> {\n    const template = this.templates.get(`${tenantId}:${name}`);\n    return template ? reviveTemplateDates(deepClone(template)) : null;\n  }\n\n  async listTemplates(tenantId: string): Promise<ApprovalTemplate[]> {\n    const result: ApprovalTemplate[] = [];\n    for (const [key, template] of this.templates) {\n      if (key.startsWith(`${tenantId}:`)) {\n        result.push(reviveTemplateDates(deepClone(template)));\n      }\n    }\n    return result;\n  }\n\n  async saveInstance(instance: ApprovalInstance): Promise<void> {\n    this.instances.set(`${instance.tenantId}:${instance.id}`, deepClone(instance));\n  }\n\n  async updateInstance(instance: ApprovalInstance, expectedVersion: number): Promise<void> {\n    const key = `${instance.tenantId}:${instance.id}`;\n    const stored = this.instances.get(key);\n    if (!stored) throw new ApprovalConflictError(instance.id);\n    if (stored.version !== expectedVersion) throw new ApprovalConflictError(instance.id);\n    const updated = deepClone(instance);\n    updated.version = expectedVersion + 1;\n    this.instances.set(key, updated);\n  }\n\n  async getInstance(tenantId: string, id: string): Promise<ApprovalInstance | null> {\n    const raw = this.instances.get(`${tenantId}:${id}`);\n    if (!raw) return null;\n    return reviveDates(deepClone(raw));\n  }\n\n  async getInstancesByApprover(\n    tenantId: string,\n    approverId: string,\n    opts?: PaginationOpts,\n  ): Promise<PaginatedResult<ApprovalInstance>> {\n    const all = [...this.instances.values()].filter((i) => {\n      if (i.tenantId !== tenantId || i.status !== 'pending') return false;\n      // Use .find() by level number, not array index (level numbers may not be consecutive)\n      const currentLevel = i.levels.find((l) => l.level === i.currentLevel);\n      return currentLevel?.approverIds.includes(approverId) ?? false;\n    });\n    return paginate(\n      all.map((i) => reviveDates(deepClone(i))),\n      opts,\n    );\n  }\n\n  async getInstancesByFilter(\n    tenantId: string,\n    filter: InstanceFilter,\n    opts?: PaginationOpts,\n  ): Promise<PaginatedResult<ApprovalInstance>> {\n    const all = [...this.instances.values()].filter(\n      (i) => i.tenantId === tenantId && applyFilter(i, filter),\n    );\n    return paginate(\n      all.map((i) => reviveDates(deepClone(i))),\n      opts,\n    );\n  }\n\n  async getOverdueInstances(\n    tenantId: string,\n    asOf: Date,\n    filter: InstanceFilter = {},\n  ): Promise<ApprovalInstance[]> {\n    return [...this.instances.values()]\n      .filter((i) => {\n        if (i.tenantId !== tenantId || i.status !== 'pending') return false;\n        if (filter.documentType && i.documentType !== filter.documentType) return false;\n        if (filter.submittedBy && i.submittedBy !== filter.submittedBy) return false;\n        // Escalation overdue on ANY open branch. Filtering to i.currentLevel\n        // would miss the upper branches of a parallel group entirely, and left\n        // this adapter disagreeing with PostgresAdapter, which already scans\n        // every level.\n        const hasOverdueEscalation = i.levels.some(\n          (l) => l.escalationDueAt != null && new Date(l.escalationDueAt) <= asOf,\n        );\n        // Instance deadline expired\n        const isExpired = i.expiresAt != null && new Date(i.expiresAt) <= asOf;\n        // SLA breach (not yet recorded)\n        const hasSLABreach =\n          i.slaDeadlineAt != null && new Date(i.slaDeadlineAt) <= asOf && !i.slaBreachedAt;\n        // Delegation expiry on any pending level\n        const hasDelegationExpiry = i.levels.some(\n          (l) =>\n            l.status === 'pending' &&\n            l.delegatedUntil != null &&\n            new Date(l.delegatedUntil) <= asOf &&\n            l.delegatedFrom != null,\n        );\n        // Reminder due on any open branch. Without this the scheduler never\n        // sees the instance and no reminder is ever sent.\n        const hasDueReminder = i.levels.some(\n          (l) =>\n            l.status === 'pending' && l.reminderDueAt != null && new Date(l.reminderDueAt) <= asOf,\n        );\n        return (\n          hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry || hasDueReminder\n        );\n      })\n      .map((i) => reviveDates(deepClone(i)));\n  }\n\n  async countInstances(tenantId: string, filter: InstanceFilter): Promise<number> {\n    let count = 0;\n    for (const instance of this.instances.values()) {\n      if (instance.tenantId === tenantId && applyFilter(instance, filter)) count++;\n    }\n    return count;\n  }\n\n  async getInstancesByCursor(\n    tenantId: string,\n    filter: InstanceFilter,\n    opts: CursorPaginationOpts,\n  ): Promise<CursorPaginatedResult<ApprovalInstance>> {\n    const all = [...this.instances.values()]\n      .filter((i) => i.tenantId === tenantId && applyFilter(i, filter))\n      .map((i) => reviveDates(deepClone(i)))\n      .sort((a, b) => {\n        const ta = a.updatedAt.getTime();\n        const tb = b.updatedAt.getTime();\n        return ta !== tb ? ta - tb : a.id.localeCompare(b.id);\n      });\n\n    const { cursor, limit, direction = 'forward' } = opts;\n    let startIdx = 0;\n\n    if (cursor) {\n      const [ts, id] = decodeCursor(cursor);\n      const idx = all.findIndex(\n        (i) => i.updatedAt.getTime() > ts || (i.updatedAt.getTime() === ts && i.id > id),\n      );\n      startIdx = idx === -1 ? all.length : idx;\n    }\n\n    if (direction === 'backward' && startIdx > 0) {\n      startIdx = Math.max(0, startIdx - limit - 1);\n    }\n\n    const slice = all.slice(startIdx, startIdx + limit);\n    const hasMore = startIdx + limit < all.length;\n    const nextCursor = hasMore ? encodeCursor(slice[slice.length - 1]!) : undefined;\n    const prevCursor = startIdx > 0 ? encodeCursor(all[startIdx - 1]!) : undefined;\n\n    return { items: slice, nextCursor, prevCursor, hasMore };\n  }\n\n  async getIdempotentInstance(\n    tenantId: string,\n    idempotencyKey: string,\n  ): Promise<ApprovalInstance | null> {\n    for (const instance of this.instances.values()) {\n      if (instance.tenantId === tenantId && instance.idempotencyKey === idempotencyKey) {\n        return reviveDates(deepClone(instance));\n      }\n    }\n    return null;\n  }\n\n  async appendAuditEntry(\n    _tenantId: string,\n    _instanceId: string,\n    _entry: AuditEntry,\n  ): Promise<void> {\n    // No-op by design. The engine already pushes each entry onto instance.auditLog\n    // and persists the whole instance via saveInstance()/updateInstance(), so the\n    // embedded log is the source of truth for this adapter. Pushing here too would\n    // duplicate every entry (as a dedicated, append-only audit table would in\n    // PostgresAdapter, this method exists to satisfy that separate-sink contract).\n  }\n\n  /** Test helper — total stored instances across all tenants. */\n  get size(): number {\n    return this.instances.size;\n  }\n}\n\nfunction paginate<T>(items: T[], opts?: PaginationOpts): PaginatedResult<T> {\n  const total = items.length;\n  if (!opts) return { items, total };\n  return { items: items.slice(opts.offset, opts.offset + opts.limit), total };\n}\n\nfunction encodeCursor(instance: ApprovalInstance): string {\n  return Buffer.from(`${instance.updatedAt.getTime()}|${instance.id}`).toString('base64');\n}\n\nfunction decodeCursor(cursor: string): [number, string] {\n  const decoded = Buffer.from(cursor, 'base64').toString('utf8');\n  const pipeIdx = decoded.indexOf('|');\n  return [Number(decoded.slice(0, pipeIdx)), decoded.slice(pipeIdx + 1)];\n}\n"]}