hierarchical-approval 2.8.0 → 2.9.0

package/dist/index.cjs

@@ -122,6 +122,266 @@ var UpdateDataOptionsSchema = zod.z.object({
   /** Re-evaluate template conditions against the new data (default true). */
   recomputeChain: zod.z.boolean().default(true)
 });
+
+// src/errors.ts
+var ApprovalError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "ApprovalError";
+  }
+  toJSON() {
+    return { code: this.code, message: this.message, name: this.name };
+  }
+  toHttpStatus() {
+    const map = {
+      NOT_FOUND: 404,
+      CONFLICT: 409,
+      FORBIDDEN: 403,
+      VALIDATION: 422,
+      TEMPLATE_NOT_FOUND: 404
+    };
+    return map[this.code] ?? 500;
+  }
+};
+var ApprovalNotFoundError = class extends ApprovalError {
+  constructor(resource, id) {
+    super(`${resource} "${id}" not found.`, "NOT_FOUND");
+    this.name = "ApprovalNotFoundError";
+  }
+};
+var ApprovalConflictError = class extends ApprovalError {
+  constructor(instanceId) {
+    super(
+      `Concurrent modification detected on instance "${instanceId}". The record was updated by another process. Please retry.`,
+      "CONFLICT"
+    );
+    this.name = "ApprovalConflictError";
+  }
+};
+var ApprovalForbiddenError = class extends ApprovalError {
+  constructor(message) {
+    super(message, "FORBIDDEN");
+    this.name = "ApprovalForbiddenError";
+  }
+};
+var ApprovalValidationError = class extends ApprovalError {
+  constructor(message, cause) {
+    super(message, "VALIDATION");
+    this.cause = cause;
+    this.name = "ApprovalValidationError";
+  }
+};
+var ApprovalTemplateNotFoundError = class extends ApprovalError {
+  constructor(name) {
+    super(`Template "${name}" not found.`, "TEMPLATE_NOT_FOUND");
+    this.name = "ApprovalTemplateNotFoundError";
+  }
+};
+
+// src/adapters/MemoryAdapter.ts
+function deepClone(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+function reviveDates(instance) {
+  return {
+    ...instance,
+    createdAt: new Date(instance.createdAt),
+    updatedAt: new Date(instance.updatedAt),
+    expiresAt: instance.expiresAt ? new Date(instance.expiresAt) : void 0,
+    slaDeadlineAt: instance.slaDeadlineAt ? new Date(instance.slaDeadlineAt) : void 0,
+    slaBreachedAt: instance.slaBreachedAt ? new Date(instance.slaBreachedAt) : void 0,
+    auditLog: instance.auditLog.map((e) => ({ ...e, timestamp: new Date(e.timestamp) })),
+    infoRequest: instance.infoRequest ? { ...instance.infoRequest, askedAt: new Date(instance.infoRequest.askedAt) } : void 0,
+    attachments: instance.attachments ? instance.attachments.map((a) => ({ ...a, addedAt: new Date(a.addedAt) })) : void 0,
+    comments: instance.comments ? instance.comments.map((c) => ({ ...c, createdAt: new Date(c.createdAt) })) : void 0,
+    levels: instance.levels.map((l) => {
+      const level = { ...l };
+      if (l.escalationDueAt) level.escalationDueAt = new Date(l.escalationDueAt);
+      if (l.delegatedUntil) level.delegatedUntil = new Date(l.delegatedUntil);
+      if (l.reminderDueAt) level.reminderDueAt = new Date(l.reminderDueAt);
+      return level;
+    })
+  };
+}
+function reviveTemplateDates(template) {
+  return { ...template, createdAt: new Date(template.createdAt) };
+}
+function readPath(data, path) {
+  return path.split(".").reduce((obj, key) => {
+    if (obj !== null && typeof obj === "object" && Object.prototype.hasOwnProperty.call(obj, key)) {
+      return obj[key];
+    }
+    return void 0;
+  }, data);
+}
+function deepEquals(a, b) {
+  if (Object.is(a, b)) return true;
+  if (a === null || b === null || typeof a !== "object" || typeof b !== "object") return false;
+  if (Array.isArray(a) !== Array.isArray(b)) return false;
+  const aKeys = Object.keys(a);
+  const bKeys = Object.keys(b);
+  if (aKeys.length !== bKeys.length) return false;
+  return aKeys.every(
+    (k) => Object.prototype.hasOwnProperty.call(b, k) && deepEquals(a[k], b[k])
+  );
+}
+function applyFilter(instance, filter) {
+  if (filter.status && instance.status !== filter.status) return false;
+  if (filter.documentType && instance.documentType !== filter.documentType) return false;
+  if (filter.submittedBy && instance.submittedBy !== filter.submittedBy) return false;
+  if (filter.templateName && instance.templateName !== filter.templateName) return false;
+  if (filter.fromDate && new Date(instance.createdAt) < filter.fromDate) return false;
+  if (filter.toDate && new Date(instance.createdAt) > filter.toDate) return false;
+  if (filter.data) {
+    for (const [path, expected] of Object.entries(filter.data)) {
+      if (!deepEquals(readPath(instance.data ?? {}, path), expected)) return false;
+    }
+  }
+  return true;
+}
+var MemoryAdapter = class {
+  constructor() {
+    // keyed by `${tenantId}:${template.name}`
+    this.templates = /* @__PURE__ */ new Map();
+    // keyed by `${tenantId}:${instance.id}`
+    this.instances = /* @__PURE__ */ new Map();
+  }
+  async saveTemplate(template) {
+    this.templates.set(`${template.tenantId}:${template.name}`, deepClone(template));
+  }
+  async getTemplate(tenantId, name) {
+    const template = this.templates.get(`${tenantId}:${name}`);
+    return template ? reviveTemplateDates(deepClone(template)) : null;
+  }
+  async listTemplates(tenantId) {
+    const result = [];
+    for (const [key, template] of this.templates) {
+      if (key.startsWith(`${tenantId}:`)) {
+        result.push(reviveTemplateDates(deepClone(template)));
+      }
+    }
+    return result;
+  }
+  async saveInstance(instance) {
+    this.instances.set(`${instance.tenantId}:${instance.id}`, deepClone(instance));
+  }
+  async updateInstance(instance, expectedVersion) {
+    const key = `${instance.tenantId}:${instance.id}`;
+    const stored = this.instances.get(key);
+    if (!stored) throw new ApprovalConflictError(instance.id);
+    if (stored.version !== expectedVersion) throw new ApprovalConflictError(instance.id);
+    const updated = deepClone(instance);
+    updated.version = expectedVersion + 1;
+    this.instances.set(key, updated);
+  }
+  async getInstance(tenantId, id) {
+    const raw = this.instances.get(`${tenantId}:${id}`);
+    if (!raw) return null;
+    return reviveDates(deepClone(raw));
+  }
+  async getInstancesByApprover(tenantId, approverId, opts) {
+    const all = [...this.instances.values()].filter((i) => {
+      if (i.tenantId !== tenantId || i.status !== "pending") return false;
+      const currentLevel = i.levels.find((l) => l.level === i.currentLevel);
+      return currentLevel?.approverIds.includes(approverId) ?? false;
+    });
+    return paginate(
+      all.map((i) => reviveDates(deepClone(i))),
+      opts
+    );
+  }
+  async getInstancesByFilter(tenantId, filter, opts) {
+    const all = [...this.instances.values()].filter(
+      (i) => i.tenantId === tenantId && applyFilter(i, filter)
+    );
+    return paginate(
+      all.map((i) => reviveDates(deepClone(i))),
+      opts
+    );
+  }
+  async getOverdueInstances(tenantId, asOf, filter = {}) {
+    return [...this.instances.values()].filter((i) => {
+      if (i.tenantId !== tenantId || i.status !== "pending") return false;
+      if (filter.documentType && i.documentType !== filter.documentType) return false;
+      if (filter.submittedBy && i.submittedBy !== filter.submittedBy) return false;
+      const hasOverdueEscalation = i.levels.some(
+        (l) => l.escalationDueAt != null && new Date(l.escalationDueAt) <= asOf
+      );
+      const isExpired = i.expiresAt != null && new Date(i.expiresAt) <= asOf;
+      const hasSLABreach = i.slaDeadlineAt != null && new Date(i.slaDeadlineAt) <= asOf && !i.slaBreachedAt;
+      const hasDelegationExpiry = i.levels.some(
+        (l) => l.status === "pending" && l.delegatedUntil != null && new Date(l.delegatedUntil) <= asOf && l.delegatedFrom != null
+      );
+      const hasDueReminder = i.levels.some(
+        (l) => l.status === "pending" && l.reminderDueAt != null && new Date(l.reminderDueAt) <= asOf
+      );
+      return hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry || hasDueReminder;
+    }).map((i) => reviveDates(deepClone(i)));
+  }
+  async deleteInstance(tenantId, id) {
+    const key = `${tenantId}:${id}`;
+    return this.instances.delete(key);
+  }
+  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();
+      const tb = b.updatedAt.getTime();
+      return ta !== tb ? ta - tb : a.id.localeCompare(b.id);
+    });
+    const { cursor, limit, direction = "forward" } = opts;
+    let startIdx = 0;
+    if (cursor) {
+      const [ts, id] = decodeCursor(cursor);
+      const idx = all.findIndex(
+        (i) => i.updatedAt.getTime() > ts || i.updatedAt.getTime() === ts && i.id > id
+      );
+      startIdx = idx === -1 ? all.length : idx;
+    }
+    if (direction === "backward" && startIdx > 0) {
+      startIdx = Math.max(0, startIdx - limit - 1);
+    }
+    const slice = all.slice(startIdx, startIdx + limit);
+    const hasMore = startIdx + limit < all.length;
+    const nextCursor = hasMore ? encodeCursor(slice[slice.length - 1]) : void 0;
+    const prevCursor = startIdx > 0 ? encodeCursor(all[startIdx - 1]) : void 0;
+    return { items: slice, nextCursor, prevCursor, hasMore };
+  }
+  async getIdempotentInstance(tenantId, idempotencyKey) {
+    for (const instance of this.instances.values()) {
+      if (instance.tenantId === tenantId && instance.idempotencyKey === idempotencyKey) {
+        return reviveDates(deepClone(instance));
+      }
+    }
+    return null;
+  }
+  async appendAuditEntry(_tenantId, _instanceId, _entry) {
+  }
+  /** Test helper — total stored instances across all tenants. */
+  get size() {
+    return this.instances.size;
+  }
+};
+function paginate(items, opts) {
+  const total = items.length;
+  if (!opts) return { items, total };
+  return { items: items.slice(opts.offset, opts.offset + opts.limit), total };
+}
+function encodeCursor(instance) {
+  return Buffer.from(`${instance.updatedAt.getTime()}|${instance.id}`).toString("base64");
+}
+function decodeCursor(cursor) {
+  const decoded = Buffer.from(cursor, "base64").toString("utf8");
+  const pipeIdx = decoded.indexOf("|");
+  return [Number(decoded.slice(0, pipeIdx)), decoded.slice(pipeIdx + 1)];
+}
 var EventBus = class {
   constructor() {
     this.emitter = new EventEmitter__default.default();
@@ -179,89 +439,33 @@ var EventBus = class {
     return wrapped;
   }
   forget(event, listener) {
-    const perEvent = this.wrappers.get(event);
-    if (!perEvent) return;
-    perEvent.delete(listener);
-    if (perEvent.size === 0) this.wrappers.delete(event);
-  }
-};
-
-// src/utils/Logger.ts
-var noopLogger = {
-  info: () => {
-  },
-  warn: () => {
-  },
-  error: () => {
-  },
-  fatal: () => {
-  },
-  debug: () => {
-  }
-};
-
-// src/utils/Clock.ts
-var systemClock = { now: () => /* @__PURE__ */ new Date() };
-
-// src/utils/IdGenerator.ts
-var defaultIdGenerator = (prefix) => `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
-
-// src/errors.ts
-var ApprovalError = class extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "ApprovalError";
-  }
-  toJSON() {
-    return { code: this.code, message: this.message, name: this.name };
-  }
-  toHttpStatus() {
-    const map = {
-      NOT_FOUND: 404,
-      CONFLICT: 409,
-      FORBIDDEN: 403,
-      VALIDATION: 422,
-      TEMPLATE_NOT_FOUND: 404
-    };
-    return map[this.code] ?? 500;
-  }
-};
-var ApprovalNotFoundError = class extends ApprovalError {
-  constructor(resource, id) {
-    super(`${resource} "${id}" not found.`, "NOT_FOUND");
-    this.name = "ApprovalNotFoundError";
-  }
-};
-var ApprovalConflictError = class extends ApprovalError {
-  constructor(instanceId) {
-    super(
-      `Concurrent modification detected on instance "${instanceId}". The record was updated by another process. Please retry.`,
-      "CONFLICT"
-    );
-    this.name = "ApprovalConflictError";
-  }
-};
-var ApprovalForbiddenError = class extends ApprovalError {
-  constructor(message) {
-    super(message, "FORBIDDEN");
-    this.name = "ApprovalForbiddenError";
-  }
-};
-var ApprovalValidationError = class extends ApprovalError {
-  constructor(message, cause) {
-    super(message, "VALIDATION");
-    this.cause = cause;
-    this.name = "ApprovalValidationError";
+    const perEvent = this.wrappers.get(event);
+    if (!perEvent) return;
+    perEvent.delete(listener);
+    if (perEvent.size === 0) this.wrappers.delete(event);
   }
 };
-var ApprovalTemplateNotFoundError = class extends ApprovalError {
-  constructor(name) {
-    super(`Template "${name}" not found.`, "TEMPLATE_NOT_FOUND");
-    this.name = "ApprovalTemplateNotFoundError";
+
+// src/utils/Logger.ts
+var noopLogger = {
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  },
+  fatal: () => {
+  },
+  debug: () => {
   }
 };
 
+// src/utils/Clock.ts
+var systemClock = { now: () => /* @__PURE__ */ new Date() };
+
+// src/utils/IdGenerator.ts
+var defaultIdGenerator = (prefix) => `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+
 // src/engine/TemplateRegistry.ts
 var TemplateRegistry = class {
   constructor(adapter, tenantId, opts) {
@@ -389,6 +593,17 @@ var LevelResolver = class {
   registerApproverType(typeName, fn) {
     this.approverTypes.set(typeName, fn);
   }
+  /**
+   * Copy every custom resolver and approver type onto another resolver.
+   *
+   * Used when the engine builds a throwaway copy of itself for a simulation: a
+   * simulation that could not resolve the caller's own `dynamic` approvers
+   * would answer a different question from the one asked.
+   */
+  copyRegistrationsTo(target) {
+    for (const [name, fn] of this.resolvers) target.register(name, fn);
+    for (const [name, fn] of this.approverTypes) target.registerApproverType(name, fn);
+  }
   async resolveApprovers(approvers, submittedBy, data, orgProvider, outOfOffice, at) {
     const resolved = [];
     for (const approver of approvers) {
@@ -2837,6 +3052,112 @@ var ApprovalEngine = class _ApprovalEngine {
     })).sort((a, b) => a.level - b.level);
     return { templateName: template.name, levels, skipped, rules };
   }
+  /**
+   * Run a document through a template against scripted decisions, without
+   * persisting anything.
+   *
+   * `explainChain()` says what the chain will be; this says what happens to it —
+   * "if the CFO rejects at level 3, does it go back to the submitter or die?" —
+   * which previously meant submitting a real approval into a real store and
+   * cleaning it up afterwards, or reasoning about the state machine by hand.
+   *
+   * The run executes against a private in-memory store seeded with a copy of
+   * the template, so the caller's storage is untouched and no events reach the
+   * caller's notification adapters. Custom resolvers and approver types are
+   * copied across, because a simulation that could not resolve the caller's own
+   * `dynamic` approvers would answer a different question from the one asked.
+   *
+   * A refused decision — wrong approver, wrong level, already acted — stops the
+   * run and is reported in the transcript rather than thrown: the refusal is
+   * usually the answer the caller was looking for.
+   *
+   * @param opts - Template, document data, submitter and the decisions to play.
+   */
+  async simulate(opts) {
+    const template = await this.registry.get(opts.templateName);
+    const scratch = new _ApprovalEngine({
+      ...this.opts,
+      adapter: new MemoryAdapter(),
+      // A simulation must not page anybody, write anybody's audit log, or move
+      // anybody's metrics.
+      notificationAdapter: void 0,
+      auditAdapter: void 0,
+      metricsAdapter: void 0,
+      authorizationPolicy: void 0,
+      middleware: void 0,
+      escalationPollIntervalMs: void 0
+    });
+    this.resolver.copyRegistrationsTo(scratch.resolver);
+    try {
+      const {
+        id: _id,
+        tenantId: _t,
+        createdAt: _c,
+        version: _v,
+        previousVersionId: _p,
+        ...config
+      } = template;
+      await scratch.registry.define(config);
+      const instance = await scratch.submit({
+        templateName: opts.templateName,
+        documentId: `simulation-${opts.templateName}`,
+        documentType: template.documentType,
+        submittedBy: opts.submittedBy,
+        data: opts.data,
+        metadata: {}
+      });
+      const transcript = [];
+      let current = instance;
+      for (const [i, decision] of (opts.decisions ?? []).entries()) {
+        const isApprove = "approve" in decision;
+        const actorId = isApprove ? decision.approve : decision.reject;
+        try {
+          current = isApprove ? await scratch.approve(current.id, {
+            approverId: actorId,
+            level: decision.level,
+            comment: decision.comment
+          }) : await scratch.reject(current.id, {
+            approverId: actorId,
+            level: decision.level,
+            reason: decision.reason ?? "simulated rejection"
+          });
+          transcript.push({
+            step: i + 1,
+            action: isApprove ? "approve" : "reject",
+            actorId,
+            level: decision.level,
+            status: current.status
+          });
+        } catch (err) {
+          transcript.push({
+            step: i + 1,
+            action: isApprove ? "approve" : "reject",
+            actorId,
+            level: decision.level,
+            status: current.status,
+            error: err.message
+          });
+          break;
+        }
+        if (TERMINAL_STATUSES.has(current.status)) break;
+      }
+      const finalInstance = await scratch.getInstance(current.id);
+      return {
+        finalStatus: finalInstance.status,
+        levels: finalInstance.levels.map((l) => ({
+          level: l.level,
+          name: l.name,
+          status: l.status,
+          approvers: l.approverIds
+        })),
+        transcript,
+        unreachedLevels: finalInstance.levels.filter((l) => l.status === "waiting").map((l) => l.level),
+        incomplete: finalInstance.status === "pending"
+      };
+    } finally {
+      await scratch.shutdown();
+    }
+  }
   async canApprove(instanceId, userId) {
     let instance;
     try {
@@ -4307,210 +4628,6 @@ function parseOrThrow(fn) {
   }
 }
 
-// src/adapters/MemoryAdapter.ts
-function deepClone(value) {
-  return JSON.parse(JSON.stringify(value));
-}
-function reviveDates(instance) {
-  return {
-    ...instance,
-    createdAt: new Date(instance.createdAt),
-    updatedAt: new Date(instance.updatedAt),
-    expiresAt: instance.expiresAt ? new Date(instance.expiresAt) : void 0,
-    slaDeadlineAt: instance.slaDeadlineAt ? new Date(instance.slaDeadlineAt) : void 0,
-    slaBreachedAt: instance.slaBreachedAt ? new Date(instance.slaBreachedAt) : void 0,
-    auditLog: instance.auditLog.map((e) => ({ ...e, timestamp: new Date(e.timestamp) })),
-    infoRequest: instance.infoRequest ? { ...instance.infoRequest, askedAt: new Date(instance.infoRequest.askedAt) } : void 0,
-    attachments: instance.attachments ? instance.attachments.map((a) => ({ ...a, addedAt: new Date(a.addedAt) })) : void 0,
-    comments: instance.comments ? instance.comments.map((c) => ({ ...c, createdAt: new Date(c.createdAt) })) : void 0,
-    levels: instance.levels.map((l) => {
-      const level = { ...l };
-      if (l.escalationDueAt) level.escalationDueAt = new Date(l.escalationDueAt);
-      if (l.delegatedUntil) level.delegatedUntil = new Date(l.delegatedUntil);
-      if (l.reminderDueAt) level.reminderDueAt = new Date(l.reminderDueAt);
-      return level;
-    })
-  };
-}
-function reviveTemplateDates(template) {
-  return { ...template, createdAt: new Date(template.createdAt) };
-}
-function readPath(data, path) {
-  return path.split(".").reduce((obj, key) => {
-    if (obj !== null && typeof obj === "object" && Object.prototype.hasOwnProperty.call(obj, key)) {
-      return obj[key];
-    }
-    return void 0;
-  }, data);
-}
-function deepEquals(a, b) {
-  if (Object.is(a, b)) return true;
-  if (a === null || b === null || typeof a !== "object" || typeof b !== "object") return false;
-  if (Array.isArray(a) !== Array.isArray(b)) return false;
-  const aKeys = Object.keys(a);
-  const bKeys = Object.keys(b);
-  if (aKeys.length !== bKeys.length) return false;
-  return aKeys.every(
-    (k) => Object.prototype.hasOwnProperty.call(b, k) && deepEquals(a[k], b[k])
-  );
-}
-function applyFilter(instance, filter) {
-  if (filter.status && instance.status !== filter.status) return false;
-  if (filter.documentType && instance.documentType !== filter.documentType) return false;
-  if (filter.submittedBy && instance.submittedBy !== filter.submittedBy) return false;
-  if (filter.templateName && instance.templateName !== filter.templateName) return false;
-  if (filter.fromDate && new Date(instance.createdAt) < filter.fromDate) return false;
-  if (filter.toDate && new Date(instance.createdAt) > filter.toDate) return false;
-  if (filter.data) {
-    for (const [path, expected] of Object.entries(filter.data)) {
-      if (!deepEquals(readPath(instance.data ?? {}, path), expected)) return false;
-    }
-  }
-  return true;
-}
-var MemoryAdapter = class {
-  constructor() {
-    // keyed by `${tenantId}:${template.name}`
-    this.templates = /* @__PURE__ */ new Map();
-    // keyed by `${tenantId}:${instance.id}`
-    this.instances = /* @__PURE__ */ new Map();
-  }
-  async saveTemplate(template) {
-    this.templates.set(`${template.tenantId}:${template.name}`, deepClone(template));
-  }
-  async getTemplate(tenantId, name) {
-    const template = this.templates.get(`${tenantId}:${name}`);
-    return template ? reviveTemplateDates(deepClone(template)) : null;
-  }
-  async listTemplates(tenantId) {
-    const result = [];
-    for (const [key, template] of this.templates) {
-      if (key.startsWith(`${tenantId}:`)) {
-        result.push(reviveTemplateDates(deepClone(template)));
-      }
-    }
-    return result;
-  }
-  async saveInstance(instance) {
-    this.instances.set(`${instance.tenantId}:${instance.id}`, deepClone(instance));
-  }
-  async updateInstance(instance, expectedVersion) {
-    const key = `${instance.tenantId}:${instance.id}`;
-    const stored = this.instances.get(key);
-    if (!stored) throw new ApprovalConflictError(instance.id);
-    if (stored.version !== expectedVersion) throw new ApprovalConflictError(instance.id);
-    const updated = deepClone(instance);
-    updated.version = expectedVersion + 1;
-    this.instances.set(key, updated);
-  }
-  async getInstance(tenantId, id) {
-    const raw = this.instances.get(`${tenantId}:${id}`);
-    if (!raw) return null;
-    return reviveDates(deepClone(raw));
-  }
-  async getInstancesByApprover(tenantId, approverId, opts) {
-    const all = [...this.instances.values()].filter((i) => {
-      if (i.tenantId !== tenantId || i.status !== "pending") return false;
-      const currentLevel = i.levels.find((l) => l.level === i.currentLevel);
-      return currentLevel?.approverIds.includes(approverId) ?? false;
-    });
-    return paginate(
-      all.map((i) => reviveDates(deepClone(i))),
-      opts
-    );
-  }
-  async getInstancesByFilter(tenantId, filter, opts) {
-    const all = [...this.instances.values()].filter(
-      (i) => i.tenantId === tenantId && applyFilter(i, filter)
-    );
-    return paginate(
-      all.map((i) => reviveDates(deepClone(i))),
-      opts
-    );
-  }
-  async getOverdueInstances(tenantId, asOf, filter = {}) {
-    return [...this.instances.values()].filter((i) => {
-      if (i.tenantId !== tenantId || i.status !== "pending") return false;
-      if (filter.documentType && i.documentType !== filter.documentType) return false;
-      if (filter.submittedBy && i.submittedBy !== filter.submittedBy) return false;
-      const hasOverdueEscalation = i.levels.some(
-        (l) => l.escalationDueAt != null && new Date(l.escalationDueAt) <= asOf
-      );
-      const isExpired = i.expiresAt != null && new Date(i.expiresAt) <= asOf;
-      const hasSLABreach = i.slaDeadlineAt != null && new Date(i.slaDeadlineAt) <= asOf && !i.slaBreachedAt;
-      const hasDelegationExpiry = i.levels.some(
-        (l) => l.status === "pending" && l.delegatedUntil != null && new Date(l.delegatedUntil) <= asOf && l.delegatedFrom != null
-      );
-      const hasDueReminder = i.levels.some(
-        (l) => l.status === "pending" && l.reminderDueAt != null && new Date(l.reminderDueAt) <= asOf
-      );
-      return hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry || hasDueReminder;
-    }).map((i) => reviveDates(deepClone(i)));
-  }
-  async deleteInstance(tenantId, id) {
-    const key = `${tenantId}:${id}`;
-    return this.instances.delete(key);
-  }
-  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();
-      const tb = b.updatedAt.getTime();
-      return ta !== tb ? ta - tb : a.id.localeCompare(b.id);
-    });
-    const { cursor, limit, direction = "forward" } = opts;
-    let startIdx = 0;
-    if (cursor) {
-      const [ts, id] = decodeCursor(cursor);
-      const idx = all.findIndex(
-        (i) => i.updatedAt.getTime() > ts || i.updatedAt.getTime() === ts && i.id > id
-      );
-      startIdx = idx === -1 ? all.length : idx;
-    }
-    if (direction === "backward" && startIdx > 0) {
-      startIdx = Math.max(0, startIdx - limit - 1);
-    }
-    const slice = all.slice(startIdx, startIdx + limit);
-    const hasMore = startIdx + limit < all.length;
-    const nextCursor = hasMore ? encodeCursor(slice[slice.length - 1]) : void 0;
-    const prevCursor = startIdx > 0 ? encodeCursor(all[startIdx - 1]) : void 0;
-    return { items: slice, nextCursor, prevCursor, hasMore };
-  }
-  async getIdempotentInstance(tenantId, idempotencyKey) {
-    for (const instance of this.instances.values()) {
-      if (instance.tenantId === tenantId && instance.idempotencyKey === idempotencyKey) {
-        return reviveDates(deepClone(instance));
-      }
-    }
-    return null;
-  }
-  async appendAuditEntry(_tenantId, _instanceId, _entry) {
-  }
-  /** Test helper — total stored instances across all tenants. */
-  get size() {
-    return this.instances.size;
-  }
-};
-function paginate(items, opts) {
-  const total = items.length;
-  if (!opts) return { items, total };
-  return { items: items.slice(opts.offset, opts.offset + opts.limit), total };
-}
-function encodeCursor(instance) {
-  return Buffer.from(`${instance.updatedAt.getTime()}|${instance.id}`).toString("base64");
-}
-function decodeCursor(cursor) {
-  const decoded = Buffer.from(cursor, "base64").toString("utf8");
-  const pipeIdx = decoded.indexOf("|");
-  return [Number(decoded.slice(0, pipeIdx)), decoded.slice(pipeIdx + 1)];
-}
-
 // src/utils/BusinessCalendar.ts
 var DAY_MS = 864e5;
 function dayKey(d) {