hierarchical-approval 0.2.1 → 0.3.0

package/dist/IAuditAdapter-B_DhuPsU.d.cts

@@ -0,0 +1,12 @@
+import { b as AuditEntry, a as ApprovalInstance } from './instance-D8D7b07N.cjs';
+
+interface IAuditAdapter {
+    /**
+     * Called after every state-mutating operation, in addition to the primary storage adapter.
+     * Intended for write-once sinks: Kafka, S3, CloudTrail, WORM stores.
+     * Must not throw — errors are logged and swallowed.
+     */
+    append(tenantId: string, instanceId: string, entry: AuditEntry, instance: Readonly<ApprovalInstance>): Promise<void>;
+}
+
+export type { IAuditAdapter as I };

package/dist/IMetricsAdapter-D9PUz4tM.d.cts

@@ -0,0 +1,9 @@
+type MetricName = 'approval.submitted' | 'approval.approved' | 'approval.rejected' | 'approval.cancelled' | 'approval.expired' | 'approval.sla_breached' | 'approval.escalated' | 'approval.reassigned' | 'approval.overridden' | 'approval.conflict_retry' | 'approval.operation_duration_ms';
+interface IMetricsAdapter {
+    /** Increment a counter. Synchronous — never awaited. */
+    increment(metric: MetricName, labels?: Record<string, string>): void;
+    /** Record a timing measurement in milliseconds. Synchronous — never awaited. */
+    timing(metric: MetricName, durationMs: number, labels?: Record<string, string>): void;
+}
+
+export type { IMetricsAdapter as I, MetricName as M };

package/dist/IMetricsAdapter-D9PUz4tM.d.ts

@@ -0,0 +1,9 @@
+type MetricName = 'approval.submitted' | 'approval.approved' | 'approval.rejected' | 'approval.cancelled' | 'approval.expired' | 'approval.sla_breached' | 'approval.escalated' | 'approval.reassigned' | 'approval.overridden' | 'approval.conflict_retry' | 'approval.operation_duration_ms';
+interface IMetricsAdapter {
+    /** Increment a counter. Synchronous — never awaited. */
+    increment(metric: MetricName, labels?: Record<string, string>): void;
+    /** Record a timing measurement in milliseconds. Synchronous — never awaited. */
+    timing(metric: MetricName, durationMs: number, labels?: Record<string, string>): void;
+}
+
+export type { IMetricsAdapter as I, MetricName as M };

package/dist/INotificationAdapter-BdfVjYa8.d.ts

@@ -0,0 +1,102 @@
+import { a as ApprovalInstance, b as AuditEntry } from './instance-D8D7b07N.js';
+
+interface ApprovalEvent {
+    instanceId: string;
+    documentId: string;
+    documentType: string;
+    timestamp: Date;
+}
+interface SubmittedEvent extends ApprovalEvent {
+    submittedBy: string;
+    currentApprovers: string[];
+}
+interface ApprovedEvent extends ApprovalEvent {
+    approverId: string;
+    level: number;
+    comment?: string;
+    isFinal: boolean;
+}
+interface RejectedEvent extends ApprovalEvent {
+    approverId: string;
+    level: number;
+    reason: string;
+    returnTo: 'originator' | 'previous' | null;
+}
+interface DelegatedEvent extends ApprovalEvent {
+    fromApprover: string;
+    toApprover: string;
+    level: number;
+    reason: string;
+}
+interface ReassignedEvent extends ApprovalEvent {
+    reassignedBy: string;
+    fromApprover: string;
+    toApprover: string;
+    level: number;
+    reason: string;
+}
+interface EscalatedEvent extends ApprovalEvent {
+    level: number;
+    escalatedTo: string;
+}
+interface CancelledEvent extends ApprovalEvent {
+    cancelledBy: string;
+    reason: string;
+}
+interface LevelAdvancedEvent extends ApprovalEvent {
+    fromLevel: number;
+    toLevel: number;
+    newApprovers: string[];
+}
+interface ResubmittedEvent extends ApprovalEvent {
+    resubmittedBy: string;
+    originalInstanceId: string;
+}
+interface OverriddenEvent extends ApprovalEvent {
+    overriddenBy: string;
+    justification: string;
+}
+interface ExpiredEvent extends ApprovalEvent {
+    deadlineAction: 'cancel' | 'reject';
+}
+interface SlaBreachedEvent extends ApprovalEvent {
+    slaDeadlineAt: Date;
+}
+interface ApprovalEventMap {
+    'approval:submitted': SubmittedEvent;
+    'approval:approved': ApprovedEvent;
+    'approval:rejected': RejectedEvent;
+    'approval:delegated': DelegatedEvent;
+    'approval:reassigned': ReassignedEvent;
+    'approval:escalated': EscalatedEvent;
+    'approval:cancelled': CancelledEvent;
+    'approval:completed': ApprovalInstance;
+    'approval:level_advanced': LevelAdvancedEvent;
+    'approval:resubmitted': ResubmittedEvent;
+    'approval:overridden': OverriddenEvent;
+    'approval:expired': ExpiredEvent;
+    'approval:sla_breached': SlaBreachedEvent;
+}
+type ApprovalEventName = keyof ApprovalEventMap;
+interface HistoryEntry extends AuditEntry {
+    instanceId: string;
+}
+
+interface NotificationEvent {
+    type: ApprovalEventName;
+    instanceId: string;
+    documentId: string;
+    documentType: string;
+    timestamp: Date;
+    /** Current-level approver IDs; empty for non-level events (cancelled, expired, etc.). */
+    recipients: string[];
+    templateName: string;
+    tenantId: string;
+    payload: ApprovalEventMap[ApprovalEventName];
+}
+interface INotificationAdapter {
+    /** Called after every emitted approval event. Must not throw — errors are logged and swallowed. */
+    notify(event: NotificationEvent): Promise<void>;
+}
+
+export type { ApprovalEvent as A, CancelledEvent as C, DelegatedEvent 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, ExpiredEvent as d, RejectedEvent as e, ResubmittedEvent as f, SubmittedEvent as g };

package/dist/INotificationAdapter-DVVmXU6a.d.cts

@@ -0,0 +1,102 @@
+import { a as ApprovalInstance, b as AuditEntry } from './instance-D8D7b07N.cjs';
+
+interface ApprovalEvent {
+    instanceId: string;
+    documentId: string;
+    documentType: string;
+    timestamp: Date;
+}
+interface SubmittedEvent extends ApprovalEvent {
+    submittedBy: string;
+    currentApprovers: string[];
+}
+interface ApprovedEvent extends ApprovalEvent {
+    approverId: string;
+    level: number;
+    comment?: string;
+    isFinal: boolean;
+}
+interface RejectedEvent extends ApprovalEvent {
+    approverId: string;
+    level: number;
+    reason: string;
+    returnTo: 'originator' | 'previous' | null;
+}
+interface DelegatedEvent extends ApprovalEvent {
+    fromApprover: string;
+    toApprover: string;
+    level: number;
+    reason: string;
+}
+interface ReassignedEvent extends ApprovalEvent {
+    reassignedBy: string;
+    fromApprover: string;
+    toApprover: string;
+    level: number;
+    reason: string;
+}
+interface EscalatedEvent extends ApprovalEvent {
+    level: number;
+    escalatedTo: string;
+}
+interface CancelledEvent extends ApprovalEvent {
+    cancelledBy: string;
+    reason: string;
+}
+interface LevelAdvancedEvent extends ApprovalEvent {
+    fromLevel: number;
+    toLevel: number;
+    newApprovers: string[];
+}
+interface ResubmittedEvent extends ApprovalEvent {
+    resubmittedBy: string;
+    originalInstanceId: string;
+}
+interface OverriddenEvent extends ApprovalEvent {
+    overriddenBy: string;
+    justification: string;
+}
+interface ExpiredEvent extends ApprovalEvent {
+    deadlineAction: 'cancel' | 'reject';
+}
+interface SlaBreachedEvent extends ApprovalEvent {
+    slaDeadlineAt: Date;
+}
+interface ApprovalEventMap {
+    'approval:submitted': SubmittedEvent;
+    'approval:approved': ApprovedEvent;
+    'approval:rejected': RejectedEvent;
+    'approval:delegated': DelegatedEvent;
+    'approval:reassigned': ReassignedEvent;
+    'approval:escalated': EscalatedEvent;
+    'approval:cancelled': CancelledEvent;
+    'approval:completed': ApprovalInstance;
+    'approval:level_advanced': LevelAdvancedEvent;
+    'approval:resubmitted': ResubmittedEvent;
+    'approval:overridden': OverriddenEvent;
+    'approval:expired': ExpiredEvent;
+    'approval:sla_breached': SlaBreachedEvent;
+}
+type ApprovalEventName = keyof ApprovalEventMap;
+interface HistoryEntry extends AuditEntry {
+    instanceId: string;
+}
+
+interface NotificationEvent {
+    type: ApprovalEventName;
+    instanceId: string;
+    documentId: string;
+    documentType: string;
+    timestamp: Date;
+    /** Current-level approver IDs; empty for non-level events (cancelled, expired, etc.). */
+    recipients: string[];
+    templateName: string;
+    tenantId: string;
+    payload: ApprovalEventMap[ApprovalEventName];
+}
+interface INotificationAdapter {
+    /** Called after every emitted approval event. Must not throw — errors are logged and swallowed. */
+    notify(event: NotificationEvent): Promise<void>;
+}
+
+export type { ApprovalEvent as A, CancelledEvent as C, DelegatedEvent 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, ExpiredEvent as d, RejectedEvent as e, ResubmittedEvent as f, SubmittedEvent as g };

package/dist/IOperationMiddleware-CkRh93Wf.d.cts

@@ -0,0 +1,62 @@
+import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-D8D7b07N.cjs';
+
+declare class ApprovalError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+    toJSON(): {
+        code: string;
+        message: string;
+        name: string;
+    };
+    toHttpStatus(): number;
+}
+declare class ApprovalNotFoundError extends ApprovalError {
+    constructor(resource: string, id: string);
+}
+declare class ApprovalConflictError extends ApprovalError {
+    constructor(instanceId: string);
+}
+declare class ApprovalForbiddenError extends ApprovalError {
+    constructor(message: string);
+}
+declare class ApprovalValidationError extends ApprovalError {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+declare class ApprovalTemplateNotFoundError extends ApprovalError {
+    constructor(name: string);
+}
+
+interface AuthorizationContext {
+    operation: 'submit' | 'approve' | 'reject' | 'delegate' | 'reassign' | 'cancel' | 'escalate' | 'override' | 'resubmit' | 'addComment';
+    actorId: string;
+    instance: Readonly<ApprovalInstance>;
+    level?: Readonly<ApprovalLevelInstance>;
+    opts: Record<string, unknown>;
+}
+interface IAuthorizationPolicy {
+    /**
+     * Return undefined to allow the operation.
+     * Return a non-empty string to deny — the engine throws ApprovalForbiddenError(message).
+     * Throwing ApprovalForbiddenError directly is also permitted.
+     */
+    authorize(ctx: AuthorizationContext): Promise<string | undefined> | string | undefined;
+}
+
+interface OperationContext<T = unknown> {
+    operation: string;
+    instanceId?: string;
+    actorId?: string;
+    tenantId: string;
+    input: T;
+}
+interface IOperationMiddleware {
+    /** Runs after authorization and input validation, before state mutations. */
+    before?(ctx: OperationContext): Promise<void> | void;
+    /** Runs after successful completion of the operation. */
+    after?(ctx: OperationContext, result: ApprovalInstance | void): Promise<void> | void;
+    /** Runs when an ApprovalError is thrown. Does not suppress the error. */
+    onError?(ctx: OperationContext, error: ApprovalError): Promise<void> | void;
+}
+
+export { ApprovalConflictError as A, type IAuthorizationPolicy as I, type OperationContext as O, ApprovalError as a, ApprovalForbiddenError as b, ApprovalNotFoundError as c, ApprovalTemplateNotFoundError as d, ApprovalValidationError as e, type AuthorizationContext as f, type IOperationMiddleware as g };

package/dist/IOperationMiddleware-Dk_xOKxR.d.ts

@@ -0,0 +1,62 @@
+import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-D8D7b07N.js';
+
+declare class ApprovalError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+    toJSON(): {
+        code: string;
+        message: string;
+        name: string;
+    };
+    toHttpStatus(): number;
+}
+declare class ApprovalNotFoundError extends ApprovalError {
+    constructor(resource: string, id: string);
+}
+declare class ApprovalConflictError extends ApprovalError {
+    constructor(instanceId: string);
+}
+declare class ApprovalForbiddenError extends ApprovalError {
+    constructor(message: string);
+}
+declare class ApprovalValidationError extends ApprovalError {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+declare class ApprovalTemplateNotFoundError extends ApprovalError {
+    constructor(name: string);
+}
+
+interface AuthorizationContext {
+    operation: 'submit' | 'approve' | 'reject' | 'delegate' | 'reassign' | 'cancel' | 'escalate' | 'override' | 'resubmit' | 'addComment';
+    actorId: string;
+    instance: Readonly<ApprovalInstance>;
+    level?: Readonly<ApprovalLevelInstance>;
+    opts: Record<string, unknown>;
+}
+interface IAuthorizationPolicy {
+    /**
+     * Return undefined to allow the operation.
+     * Return a non-empty string to deny — the engine throws ApprovalForbiddenError(message).
+     * Throwing ApprovalForbiddenError directly is also permitted.
+     */
+    authorize(ctx: AuthorizationContext): Promise<string | undefined> | string | undefined;
+}
+
+interface OperationContext<T = unknown> {
+    operation: string;
+    instanceId?: string;
+    actorId?: string;
+    tenantId: string;
+    input: T;
+}
+interface IOperationMiddleware {
+    /** Runs after authorization and input validation, before state mutations. */
+    before?(ctx: OperationContext): Promise<void> | void;
+    /** Runs after successful completion of the operation. */
+    after?(ctx: OperationContext, result: ApprovalInstance | void): Promise<void> | void;
+    /** Runs when an ApprovalError is thrown. Does not suppress the error. */
+    onError?(ctx: OperationContext, error: ApprovalError): Promise<void> | void;
+}
+
+export { ApprovalConflictError as A, type IAuthorizationPolicy as I, type OperationContext as O, ApprovalError as a, ApprovalForbiddenError as b, ApprovalNotFoundError as c, ApprovalTemplateNotFoundError as d, ApprovalValidationError as e, type AuthorizationContext as f, type IOperationMiddleware as g };

package/dist/IStorageAdapter-DbeWhtCG.d.cts

@@ -0,0 +1,47 @@
+import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-D8D7b07N.cjs';
+
+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 { CursorPaginationOpts as C, IStorageAdapter as I, PaginationOpts as P, PaginatedResult as a, InstanceFilter as b, CursorPaginatedResult as c };

package/dist/IStorageAdapter-EdwtErKD.d.ts

@@ -0,0 +1,47 @@
+import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-D8D7b07N.js';
+
+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 { CursorPaginationOpts as C, IStorageAdapter as I, PaginationOpts as P, PaginatedResult as a, InstanceFilter as b, CursorPaginatedResult as c };

package/dist/Logger-CIzvalFc.d.cts

@@ -0,0 +1,9 @@
+interface Logger {
+    info(msg: string, context?: Record<string, unknown>): void;
+    warn(msg: string, context?: Record<string, unknown>): void;
+    error(msg: string, err?: unknown, context?: Record<string, unknown>): void;
+    debug(msg: string, context?: Record<string, unknown>): void;
+}
+declare const noopLogger: Logger;
+
+export { type Logger as L, noopLogger as n };

package/dist/Logger-CIzvalFc.d.ts

@@ -0,0 +1,9 @@
+interface Logger {
+    info(msg: string, context?: Record<string, unknown>): void;
+    warn(msg: string, context?: Record<string, unknown>): void;
+    error(msg: string, err?: unknown, context?: Record<string, unknown>): void;
+    debug(msg: string, context?: Record<string, unknown>): void;
+}
+declare const noopLogger: Logger;
+
+export { type Logger as L, noopLogger as n };

package/dist/adapters/MemoryAdapter.d.cts

@@ -1,4 +1,5 @@
-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-B2xGuaKi.cjs';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-DbeWhtCG.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-D8D7b07N.cjs';
 
 declare class MemoryAdapter implements IStorageAdapter {
     private templates;

package/dist/adapters/MemoryAdapter.d.ts

@@ -1,4 +1,5 @@
-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-B2xGuaKi.js';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-EdwtErKD.js';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-D8D7b07N.js';
 
 declare class MemoryAdapter implements IStorageAdapter {
     private templates;

package/dist/adapters/PostgresAdapter.d.cts

@@ -1,6 +1,7 @@
 import * as tls from 'tls';
 import * as pg from 'pg';
-import { I as IStorageAdapter, A as ApprovalTemplate, a as ApprovalInstance, P as PaginationOpts, b as PaginatedResult, c as InstanceFilter, d as AuditEntry, C as CursorPaginationOpts, e as CursorPaginatedResult } from '../IStorageAdapter-B2xGuaKi.cjs';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-DbeWhtCG.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-D8D7b07N.cjs';
 
 interface PostgresAdapterOptions {
     connectionString?: string;

package/dist/adapters/PostgresAdapter.d.ts

@@ -1,6 +1,7 @@
 import * as tls from 'tls';
 import * as pg from 'pg';
-import { I as IStorageAdapter, A as ApprovalTemplate, a as ApprovalInstance, P as PaginationOpts, b as PaginatedResult, c as InstanceFilter, d as AuditEntry, C as CursorPaginationOpts, e as CursorPaginatedResult } from '../IStorageAdapter-B2xGuaKi.js';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-EdwtErKD.js';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-D8D7b07N.js';
 
 interface PostgresAdapterOptions {
     connectionString?: string;

package/dist/index.d.cts

@@ -1,8 +1,16 @@
-import { L as Logger, C as Clock } from './ApprovalEngine-CSxLWZ5h.cjs';
-export { A as AddCommentOptions, a as ApprovalConflictError, b as ApprovalEngine, c as ApprovalEngineOptions, d as ApprovalError, e as ApprovalEvent, f as ApprovalEventMap, g as ApprovalEventName, h as ApprovalForbiddenError, i as ApprovalNotFoundError, j as ApprovalStatistics, k as ApprovalTemplateNotFoundError, l as ApprovalValidationError, m as ApproveOptions, n as ApprovedEvent, o as ApproverResolverFn, p as AuthorizationContext, B as BulkResult, q as BusinessCalendar, r as CanApproveResult, s as CancelOptions, t as CancelledEvent, u as ConditionOperatorFn, D as DelegateOptions, v as DelegatedEvent, E as EscalateOptions, w as EscalatedEvent, x as ExpiredEvent, H as HealthResult, y as HistoryEntry, I as IAuditAdapter, z as IAuthorizationPolicy, F as IMetricsAdapter, G as INotificationAdapter, J as IOperationMiddleware, K as ISchedulerAdapter, M as IdGeneratorFn, N as IdempotencyKeyFn, O as LevelAdvancedEvent, P as MetricName, Q as NotificationEvent, R as OperationContext, S as OrgProvider, T as OverriddenEvent, U as OverrideOptions, V as PreviewChainLevel, W as PreviewResult, X as ReassignOptions, Y as ReassignedEvent, Z as RejectOptions, _ as RejectedEvent, $ as ResubmitOptions, a0 as ResubmittedEvent, a1 as RetryPolicy, a2 as SlaBreachedEvent, a3 as SubmitOptions, a4 as SubmittedEvent, a5 as ValidationResult, a6 as WeekendCalendarOptions, a7 as defaultIdGenerator, a8 as noopLogger, a9 as systemClock, aa as weekendCalendar } from './ApprovalEngine-CSxLWZ5h.cjs';
-import { I as IStorageAdapter } from './IStorageAdapter-B2xGuaKi.cjs';
-export { a as ApprovalInstance, f as ApprovalLevelConfig, g as ApprovalLevelInstance, h as ApprovalMode, i as ApprovalStatus, A as ApprovalTemplate, j as ApprovalTemplateConfig, k as ApproverConfig, l as AuditAction, m as AuditContext, d as AuditEntry, n as Condition, o as ConditionOperator, p as ConditionRule, e as CursorPaginatedResult, C as CursorPaginationOpts, E as EscalationConfig, c as InstanceFilter, L as LevelStatus, b as PaginatedResult, P as PaginationOpts, R as ResolvedApprover, q as ResolverFn, T as TemplateSnapshot } from './IStorageAdapter-B2xGuaKi.cjs';
+export { A as AddCommentOptions, a as ApprovalEngine, b as ApprovalEngineOptions, c as ApprovalStatistics, d as ApproveOptions, e as ApproverResolverFn, B as BulkResult, f as BusinessCalendar, C as CanApproveResult, g as CancelOptions, h as ConditionOperatorFn, D as DelegateOptions, E as EscalateOptions, H as HealthResult, I as ISchedulerAdapter, i as IdGeneratorFn, j as IdempotencyKeyFn, O as OrgProvider, k as OverrideOptions, P as PreviewChainLevel, l as PreviewResult, R as ReassignOptions, m as RejectOptions, n as ResubmitOptions, o as RetryPolicy, S as SubmitOptions, V as ValidationResult, W as WeekendCalendarOptions, p as defaultIdGenerator, w as weekendCalendar } from './ApprovalEngine-Bmg1bbrd.cjs';
+import { I as IStorageAdapter } from './IStorageAdapter-DbeWhtCG.cjs';
+export { c as CursorPaginatedResult, C as CursorPaginationOpts, b as InstanceFilter, a as PaginatedResult, P as PaginationOpts } from './IStorageAdapter-DbeWhtCG.cjs';
+import { L as Logger } from './Logger-CIzvalFc.cjs';
+export { n as noopLogger } from './Logger-CIzvalFc.cjs';
+import { C as Clock } from './Clock-3FnOczFJ.cjs';
+export { s as systemClock } from './Clock-3FnOczFJ.cjs';
+export { A as ApprovalConflictError, a as ApprovalError, b as ApprovalForbiddenError, c as ApprovalNotFoundError, d as ApprovalTemplateNotFoundError, e as ApprovalValidationError, f as AuthorizationContext, I as IAuthorizationPolicy, g as IOperationMiddleware, O as OperationContext } from './IOperationMiddleware-CkRh93Wf.cjs';
 export { MemoryAdapter } from './adapters/MemoryAdapter.cjs';
+export { A as ApprovalEvent, a as ApprovalEventMap, b as ApprovalEventName, c as ApprovedEvent, C as CancelledEvent, D as DelegatedEvent, E as EscalatedEvent, d as ExpiredEvent, H as HistoryEntry, I as INotificationAdapter, L as LevelAdvancedEvent, N as NotificationEvent, O as OverriddenEvent, R as ReassignedEvent, e as RejectedEvent, f as ResubmittedEvent, S as SlaBreachedEvent, g as SubmittedEvent } from './INotificationAdapter-DVVmXU6a.cjs';
+export { I as IAuditAdapter } from './IAuditAdapter-B_DhuPsU.cjs';
+export { I as IMetricsAdapter, M as MetricName } from './IMetricsAdapter-D9PUz4tM.cjs';
+export { a as ApprovalInstance, c as ApprovalLevelConfig, d as ApprovalLevelInstance, e as ApprovalMode, f as ApprovalStatus, A as ApprovalTemplate, g as ApprovalTemplateConfig, h as ApproverConfig, i as AuditAction, j as AuditContext, b as AuditEntry, C as Condition, k as ConditionOperator, l as ConditionRule, E as EscalationConfig, L as LevelStatus, R as ResolvedApprover, m as ResolverFn, T as TemplateSnapshot } from './instance-D8D7b07N.cjs';
 import 'zod';
 
 interface EscalationSchedulerOpts {

package/dist/index.d.ts

@@ -1,8 +1,16 @@
-import { L as Logger, C as Clock } from './ApprovalEngine-DICBgdIp.js';
-export { A as AddCommentOptions, a as ApprovalConflictError, b as ApprovalEngine, c as ApprovalEngineOptions, d as ApprovalError, e as ApprovalEvent, f as ApprovalEventMap, g as ApprovalEventName, h as ApprovalForbiddenError, i as ApprovalNotFoundError, j as ApprovalStatistics, k as ApprovalTemplateNotFoundError, l as ApprovalValidationError, m as ApproveOptions, n as ApprovedEvent, o as ApproverResolverFn, p as AuthorizationContext, B as BulkResult, q as BusinessCalendar, r as CanApproveResult, s as CancelOptions, t as CancelledEvent, u as ConditionOperatorFn, D as DelegateOptions, v as DelegatedEvent, E as EscalateOptions, w as EscalatedEvent, x as ExpiredEvent, H as HealthResult, y as HistoryEntry, I as IAuditAdapter, z as IAuthorizationPolicy, F as IMetricsAdapter, G as INotificationAdapter, J as IOperationMiddleware, K as ISchedulerAdapter, M as IdGeneratorFn, N as IdempotencyKeyFn, O as LevelAdvancedEvent, P as MetricName, Q as NotificationEvent, R as OperationContext, S as OrgProvider, T as OverriddenEvent, U as OverrideOptions, V as PreviewChainLevel, W as PreviewResult, X as ReassignOptions, Y as ReassignedEvent, Z as RejectOptions, _ as RejectedEvent, $ as ResubmitOptions, a0 as ResubmittedEvent, a1 as RetryPolicy, a2 as SlaBreachedEvent, a3 as SubmitOptions, a4 as SubmittedEvent, a5 as ValidationResult, a6 as WeekendCalendarOptions, a7 as defaultIdGenerator, a8 as noopLogger, a9 as systemClock, aa as weekendCalendar } from './ApprovalEngine-DICBgdIp.js';
-import { I as IStorageAdapter } from './IStorageAdapter-B2xGuaKi.js';
-export { a as ApprovalInstance, f as ApprovalLevelConfig, g as ApprovalLevelInstance, h as ApprovalMode, i as ApprovalStatus, A as ApprovalTemplate, j as ApprovalTemplateConfig, k as ApproverConfig, l as AuditAction, m as AuditContext, d as AuditEntry, n as Condition, o as ConditionOperator, p as ConditionRule, e as CursorPaginatedResult, C as CursorPaginationOpts, E as EscalationConfig, c as InstanceFilter, L as LevelStatus, b as PaginatedResult, P as PaginationOpts, R as ResolvedApprover, q as ResolverFn, T as TemplateSnapshot } from './IStorageAdapter-B2xGuaKi.js';
+export { A as AddCommentOptions, a as ApprovalEngine, b as ApprovalEngineOptions, c as ApprovalStatistics, d as ApproveOptions, e as ApproverResolverFn, B as BulkResult, f as BusinessCalendar, C as CanApproveResult, g as CancelOptions, h as ConditionOperatorFn, D as DelegateOptions, E as EscalateOptions, H as HealthResult, I as ISchedulerAdapter, i as IdGeneratorFn, j as IdempotencyKeyFn, O as OrgProvider, k as OverrideOptions, P as PreviewChainLevel, l as PreviewResult, R as ReassignOptions, m as RejectOptions, n as ResubmitOptions, o as RetryPolicy, S as SubmitOptions, V as ValidationResult, W as WeekendCalendarOptions, p as defaultIdGenerator, w as weekendCalendar } from './ApprovalEngine-DLyhejR-.js';
+import { I as IStorageAdapter } from './IStorageAdapter-EdwtErKD.js';
+export { c as CursorPaginatedResult, C as CursorPaginationOpts, b as InstanceFilter, a as PaginatedResult, P as PaginationOpts } from './IStorageAdapter-EdwtErKD.js';
+import { L as Logger } from './Logger-CIzvalFc.js';
+export { n as noopLogger } from './Logger-CIzvalFc.js';
+import { C as Clock } from './Clock-3FnOczFJ.js';
+export { s as systemClock } from './Clock-3FnOczFJ.js';
+export { A as ApprovalConflictError, a as ApprovalError, b as ApprovalForbiddenError, c as ApprovalNotFoundError, d as ApprovalTemplateNotFoundError, e as ApprovalValidationError, f as AuthorizationContext, I as IAuthorizationPolicy, g as IOperationMiddleware, O as OperationContext } from './IOperationMiddleware-Dk_xOKxR.js';
 export { MemoryAdapter } from './adapters/MemoryAdapter.js';
+export { A as ApprovalEvent, a as ApprovalEventMap, b as ApprovalEventName, c as ApprovedEvent, C as CancelledEvent, D as DelegatedEvent, E as EscalatedEvent, d as ExpiredEvent, H as HistoryEntry, I as INotificationAdapter, L as LevelAdvancedEvent, N as NotificationEvent, O as OverriddenEvent, R as ReassignedEvent, e as RejectedEvent, f as ResubmittedEvent, S as SlaBreachedEvent, g as SubmittedEvent } from './INotificationAdapter-BdfVjYa8.js';
+export { I as IAuditAdapter } from './IAuditAdapter-B3vvU09m.js';
+export { I as IMetricsAdapter, M as MetricName } from './IMetricsAdapter-D9PUz4tM.js';
+export { a as ApprovalInstance, c as ApprovalLevelConfig, d as ApprovalLevelInstance, e as ApprovalMode, f as ApprovalStatus, A as ApprovalTemplate, g as ApprovalTemplateConfig, h as ApproverConfig, i as AuditAction, j as AuditContext, b as AuditEntry, C as Condition, k as ConditionOperator, l as ConditionRule, E as EscalationConfig, L as LevelStatus, R as ResolvedApprover, m as ResolverFn, T as TemplateSnapshot } from './instance-D8D7b07N.js';
 import 'zod';
 
 interface EscalationSchedulerOpts {

package/dist/{IStorageAdapter-B2xGuaKi.d.cts → instance-D8D7b07N.d.cts}

@@ -168,48 +168,4 @@ interface ApprovalInstance {
     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 };
+export type { ApprovalTemplate as A, Condition as C, EscalationConfig as E, LevelStatus as L, ResolvedApprover as R, TemplateSnapshot as T, ApprovalInstance as a, AuditEntry as b, ApprovalLevelConfig as c, ApprovalLevelInstance as d, ApprovalMode as e, ApprovalStatus as f, ApprovalTemplateConfig as g, ApproverConfig as h, AuditAction as i, AuditContext as j, ConditionOperator as k, ConditionRule as l, ResolverFn as m };