hierarchical-approval 0.1.0

package/dist/IStorageAdapter-RAiLF8bc.d.ts

@@ -0,0 +1,192 @@
+type ApproverConfig = {
+    type: 'user';
+    userId: string;
+} | {
+    type: 'role';
+    role: string;
+} | {
+    type: 'dynamic';
+    resolver: string;
+}
+/** Custom approver type registered via engine.registerApproverType(). */
+ | {
+    type: string;
+    [key: string]: unknown;
+};
+interface ResolvedApprover {
+    userId: string;
+    source: ApproverConfig;
+}
+type ResolverFn = (submittedBy: string, data: Record<string, unknown>) => Promise<string> | string;
+
+type ApprovalMode = 'all' | 'any' | 'majority';
+/** Built-in operators. Use engine.registerConditionOperator() to add custom ones. */
+type ConditionOperator = '>' | '<' | '>=' | '<=' | '==' | '!=' | 'in' | 'not_in' | (string & {});
+interface Condition {
+    field: string;
+    operator: ConditionOperator;
+    value: unknown;
+}
+interface ApprovalLevelConfig {
+    level: number;
+    name: string;
+    approvers: ApproverConfig[];
+    mode: ApprovalMode;
+    escalationAfterDays?: number;
+}
+interface ConditionRule {
+    when: Condition | Condition[];
+    addLevels?: ApprovalLevelConfig[];
+    skipLevels?: number[];
+}
+interface EscalationConfig {
+    afterDays: number;
+    escalateTo: ApproverConfig;
+}
+interface ApprovalTemplateConfig {
+    name: string;
+    documentType: string;
+    levels: ApprovalLevelConfig[];
+    conditions?: ConditionRule[];
+    escalation?: EscalationConfig;
+    /** Overall SLA for the entire workflow in days. Emits approval:sla_breached when elapsed. */
+    slaDeadlineDays?: number;
+    /** Allow emergency override (bypass remaining levels). Must be true to use engine.override(). */
+    allowOverride?: boolean;
+}
+interface ApprovalTemplate extends ApprovalTemplateConfig {
+    id: string;
+    tenantId: string;
+    createdAt: Date;
+    /** Starts at 1; incremented on each call to engine.updateTemplate(). */
+    version: number;
+    /** ID of the previous version of this template, for audit trail. */
+    previousVersionId?: string;
+}
+
+type ApprovalStatus = 'pending' | 'approved' | 'rejected' | 'cancelled' | 'expired';
+type LevelStatus = 'waiting' | 'pending' | 'approved' | 'rejected' | 'skipped';
+type AuditAction = 'submitted' | 'approved' | 'rejected' | 'delegated' | 'escalated' | 'cancelled' | 'level_advanced' | 'commented' | 'resubmitted' | 'overridden' | 'expired';
+interface AuditEntry {
+    action: AuditAction;
+    actorId: string;
+    actorRole?: string;
+    actorIp?: string;
+    actorUserAgent?: string;
+    level: number;
+    timestamp: Date;
+    traceId?: string;
+    comment?: string;
+    reason?: string;
+    delegateTo?: string;
+    oldValue?: Record<string, unknown>;
+    newValue?: Record<string, unknown>;
+}
+/** Context injected by the caller on each mutating operation (for SOX/SOC2 compliance). */
+interface AuditContext {
+    actorRole?: string;
+    actorIp?: string;
+    actorUserAgent?: string;
+    traceId?: string;
+}
+interface ApprovalLevelInstance {
+    level: number;
+    name: string;
+    mode: ApprovalMode;
+    approverConfigs: ApproverConfig[];
+    approverIds: string[];
+    approvedBy: string[];
+    rejectedBy: string[];
+    status: LevelStatus;
+    escalationDueAt?: Date;
+    escalationAfterDays?: number;
+    /** Set when a delegation has a time limit — the original approver is restored when this date passes. */
+    delegatedUntil?: Date;
+    /** The approver who delegated away from this slot; used to revert when delegatedUntil expires. */
+    delegatedFrom?: string;
+    /** The delegate who received this slot; used to revert when delegatedUntil expires. */
+    delegatedTo?: string;
+}
+/** Snapshot of template configuration captured at submit time to insulate in-flight instances from template updates. */
+interface TemplateSnapshot {
+    escalation?: EscalationConfig;
+    slaDeadlineDays?: number;
+    allowOverride?: boolean;
+}
+interface ApprovalInstance {
+    id: string;
+    tenantId: string;
+    templateId: string;
+    templateName: string;
+    documentId: string;
+    documentType: string;
+    submittedBy: string;
+    status: ApprovalStatus;
+    currentLevel: number;
+    version: number;
+    idempotencyKey?: string;
+    levels: ApprovalLevelInstance[];
+    auditLog: AuditEntry[];
+    data: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+    /** Snapshot of template config at submit time — prevents template changes from affecting in-flight instances. */
+    templateSnapshot?: TemplateSnapshot;
+    /** ID of the rejected instance this was resubmitted from. */
+    parentInstanceId?: string;
+    /** Auto-cancel or auto-reject if not resolved by this time. */
+    expiresAt?: Date;
+    /** What happens when expiresAt is reached (default: 'cancel'). */
+    deadlineAction?: 'cancel' | 'reject';
+    /** Set from template.slaDeadlineDays at submit time; breached when passed without resolution. */
+    slaDeadlineAt?: Date;
+    /** Timestamp when the SLA deadline was first breached; set by the scheduler. */
+    slaBreachedAt?: Date;
+}
+
+interface PaginationOpts {
+    limit: number;
+    offset: number;
+}
+interface PaginatedResult<T> {
+    items: T[];
+    total: number;
+}
+/** Opaque cursor: base64(updatedAt_iso:id). Use the value from nextCursor/prevCursor. */
+interface CursorPaginationOpts {
+    cursor?: string;
+    limit: number;
+    direction?: 'forward' | 'backward';
+}
+interface CursorPaginatedResult<T> {
+    items: T[];
+    nextCursor?: string;
+    prevCursor?: string;
+    hasMore: boolean;
+}
+interface InstanceFilter {
+    status?: ApprovalStatus;
+    documentType?: string;
+    submittedBy?: string;
+    fromDate?: Date;
+    toDate?: Date;
+}
+interface IStorageAdapter {
+    saveTemplate(template: ApprovalTemplate): Promise<void>;
+    getTemplate(tenantId: string, name: string): Promise<ApprovalTemplate | null>;
+    listTemplates(tenantId: string): Promise<ApprovalTemplate[]>;
+    saveInstance(instance: ApprovalInstance): Promise<void>;
+    /** Conditional update — throws ApprovalConflictError if stored version !== expectedVersion. */
+    updateInstance(instance: ApprovalInstance, expectedVersion: number): Promise<void>;
+    getInstance(tenantId: string, id: string): Promise<ApprovalInstance | null>;
+    getInstancesByApprover(tenantId: string, approverId: string, opts?: PaginationOpts): Promise<PaginatedResult<ApprovalInstance>>;
+    getInstancesByFilter(tenantId: string, filter: InstanceFilter, opts?: PaginationOpts): Promise<PaginatedResult<ApprovalInstance>>;
+    /** 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): Promise<ApprovalInstance[]>;
+    getIdempotentInstance(tenantId: string, idempotencyKey: string): Promise<ApprovalInstance | null>;
+    appendAuditEntry(tenantId: string, instanceId: string, entry: AuditEntry): Promise<void>;
+}
+
+export type { ApprovalTemplate as A, CursorPaginationOpts as C, EscalationConfig as E, IStorageAdapter as I, LevelStatus as L, PaginationOpts as P, ResolvedApprover as R, TemplateSnapshot as T, ApprovalInstance as a, PaginatedResult as b, InstanceFilter as c, AuditEntry as d, CursorPaginatedResult as e, ApprovalLevelConfig as f, ApprovalLevelInstance as g, ApprovalMode as h, ApprovalStatus as i, ApprovalTemplateConfig as j, ApproverConfig as k, AuditAction as l, AuditContext as m, Condition as n, ConditionOperator as o, ConditionRule as p, ResolverFn as q };

package/dist/adapters/MemoryAdapter.cjs

@@ -0,0 +1,189 @@
+'use strict';
+
+// 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 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";
+  }
+};
+
+// 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) })),
+    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);
+      return level;
+    })
+  };
+}
+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.fromDate && instance.createdAt < filter.fromDate) return false;
+  if (filter.toDate && instance.createdAt > filter.toDate) 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) {
+    return deepClone(this.templates.get(`${tenantId}:${name}`) ?? null);
+  }
+  async listTemplates(tenantId) {
+    const result = [];
+    for (const [key, template] of this.templates) {
+      if (key.startsWith(`${tenantId}:`)) {
+        result.push(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) {
+    return [...this.instances.values()].filter((i) => {
+      if (i.tenantId !== tenantId || i.status !== "pending") return false;
+      const currentLevel = i.levels.find((l) => l.level === i.currentLevel);
+      const hasOverdueEscalation = currentLevel?.escalationDueAt != null && new Date(currentLevel.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
+      );
+      return hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry;
+    }).map((i) => reviveDates(deepClone(i)));
+  }
+  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) {
+    const key = `${tenantId}:${instanceId}`;
+    const instance = this.instances.get(key);
+    if (!instance) return;
+    instance.auditLog.push(deepClone(entry));
+    instance.updatedAt = new Date(entry.timestamp);
+  }
+  /** 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)];
+}
+
+exports.MemoryAdapter = MemoryAdapter;
+//# sourceMappingURL=MemoryAdapter.cjs.map
+//# sourceMappingURL=MemoryAdapter.cjs.map

package/dist/adapters/MemoryAdapter.cjs.map

@@ -0,0 +1 @@
+{"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 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.fromDate && instance.createdAt < filter.fromDate) return false;\n  if (filter.toDate && instance.createdAt > filter.toDate) return false;\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    return deepClone(this.templates.get(`${tenantId}:${name}`) ?? 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(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(all.map((i) => reviveDates(deepClone(i))), opts);\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(all.map((i) => reviveDates(deepClone(i))), opts);\n  }\n\n  async getOverdueInstances(tenantId: string, asOf: Date): Promise<ApprovalInstance[]> {\n    return [...this.instances.values()]\n      .filter((i) => {\n        if (i.tenantId !== tenantId || i.status !== 'pending') return false;\n        // Escalation overdue\n        const currentLevel = i.levels.find((l) => l.level === i.currentLevel);\n        const hasOverdueEscalation =\n          currentLevel?.escalationDueAt != null && new Date(currentLevel.escalationDueAt) <= asOf;\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        return hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry;\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(tenantId: string, instanceId: string, entry: AuditEntry): Promise<void> {\n    const key = `${tenantId}:${instanceId}`;\n    const instance = this.instances.get(key);\n    if (!instance) return;\n    instance.auditLog.push(deepClone(entry));\n    instance.updatedAt = new Date(entry.timestamp);\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"]}

package/dist/adapters/MemoryAdapter.d.cts

@@ -0,0 +1,22 @@
+import { I as IStorageAdapter, A as ApprovalTemplate, a as ApprovalInstance, P as PaginationOpts, b as PaginatedResult, c as InstanceFilter, C as CursorPaginationOpts, e as CursorPaginatedResult, d as AuditEntry } from '../IStorageAdapter-RAiLF8bc.cjs';
+
+declare class MemoryAdapter implements IStorageAdapter {
+    private templates;
+    private instances;
+    saveTemplate(template: ApprovalTemplate): Promise<void>;
+    getTemplate(tenantId: string, name: string): Promise<ApprovalTemplate | null>;
+    listTemplates(tenantId: string): Promise<ApprovalTemplate[]>;
+    saveInstance(instance: ApprovalInstance): Promise<void>;
+    updateInstance(instance: ApprovalInstance, expectedVersion: number): Promise<void>;
+    getInstance(tenantId: string, id: string): Promise<ApprovalInstance | null>;
+    getInstancesByApprover(tenantId: string, approverId: string, opts?: PaginationOpts): Promise<PaginatedResult<ApprovalInstance>>;
+    getInstancesByFilter(tenantId: string, filter: InstanceFilter, opts?: PaginationOpts): Promise<PaginatedResult<ApprovalInstance>>;
+    getOverdueInstances(tenantId: string, asOf: Date): Promise<ApprovalInstance[]>;
+    getInstancesByCursor(tenantId: string, filter: InstanceFilter, opts: CursorPaginationOpts): Promise<CursorPaginatedResult<ApprovalInstance>>;
+    getIdempotentInstance(tenantId: string, idempotencyKey: string): Promise<ApprovalInstance | null>;
+    appendAuditEntry(tenantId: string, instanceId: string, entry: AuditEntry): Promise<void>;
+    /** Test helper — total stored instances across all tenants. */
+    get size(): number;
+}
+
+export { MemoryAdapter };

package/dist/adapters/MemoryAdapter.d.ts

@@ -0,0 +1,22 @@
+import { I as IStorageAdapter, A as ApprovalTemplate, a as ApprovalInstance, P as PaginationOpts, b as PaginatedResult, c as InstanceFilter, C as CursorPaginationOpts, e as CursorPaginatedResult, d as AuditEntry } from '../IStorageAdapter-RAiLF8bc.js';
+
+declare class MemoryAdapter implements IStorageAdapter {
+    private templates;
+    private instances;
+    saveTemplate(template: ApprovalTemplate): Promise<void>;
+    getTemplate(tenantId: string, name: string): Promise<ApprovalTemplate | null>;
+    listTemplates(tenantId: string): Promise<ApprovalTemplate[]>;
+    saveInstance(instance: ApprovalInstance): Promise<void>;
+    updateInstance(instance: ApprovalInstance, expectedVersion: number): Promise<void>;
+    getInstance(tenantId: string, id: string): Promise<ApprovalInstance | null>;
+    getInstancesByApprover(tenantId: string, approverId: string, opts?: PaginationOpts): Promise<PaginatedResult<ApprovalInstance>>;
+    getInstancesByFilter(tenantId: string, filter: InstanceFilter, opts?: PaginationOpts): Promise<PaginatedResult<ApprovalInstance>>;
+    getOverdueInstances(tenantId: string, asOf: Date): Promise<ApprovalInstance[]>;
+    getInstancesByCursor(tenantId: string, filter: InstanceFilter, opts: CursorPaginationOpts): Promise<CursorPaginatedResult<ApprovalInstance>>;
+    getIdempotentInstance(tenantId: string, idempotencyKey: string): Promise<ApprovalInstance | null>;
+    appendAuditEntry(tenantId: string, instanceId: string, entry: AuditEntry): Promise<void>;
+    /** Test helper — total stored instances across all tenants. */
+    get size(): number;
+}
+
+export { MemoryAdapter };

package/dist/adapters/MemoryAdapter.js

@@ -0,0 +1,187 @@
+// 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 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";
+  }
+};
+
+// 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) })),
+    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);
+      return level;
+    })
+  };
+}
+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.fromDate && instance.createdAt < filter.fromDate) return false;
+  if (filter.toDate && instance.createdAt > filter.toDate) 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) {
+    return deepClone(this.templates.get(`${tenantId}:${name}`) ?? null);
+  }
+  async listTemplates(tenantId) {
+    const result = [];
+    for (const [key, template] of this.templates) {
+      if (key.startsWith(`${tenantId}:`)) {
+        result.push(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) {
+    return [...this.instances.values()].filter((i) => {
+      if (i.tenantId !== tenantId || i.status !== "pending") return false;
+      const currentLevel = i.levels.find((l) => l.level === i.currentLevel);
+      const hasOverdueEscalation = currentLevel?.escalationDueAt != null && new Date(currentLevel.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
+      );
+      return hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry;
+    }).map((i) => reviveDates(deepClone(i)));
+  }
+  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) {
+    const key = `${tenantId}:${instanceId}`;
+    const instance = this.instances.get(key);
+    if (!instance) return;
+    instance.auditLog.push(deepClone(entry));
+    instance.updatedAt = new Date(entry.timestamp);
+  }
+  /** 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)];
+}
+
+export { MemoryAdapter };
+//# sourceMappingURL=MemoryAdapter.js.map
+//# sourceMappingURL=MemoryAdapter.js.map