hierarchical-approval 0.2.0 → 0.3.0

package/dist/{ApprovalEngine-CSxLWZ5h.d.cts → ApprovalEngine-DLyhejR-.d.ts}

@@ -1,87 +1,12 @@
-import { a as ApprovalInstance, d as AuditEntry, g as ApprovalLevelInstance, I as IStorageAdapter, q as ResolverFn, j as ApprovalTemplateConfig, A as ApprovalTemplate, m as AuditContext, h as ApprovalMode, P as PaginationOpts, b as PaginatedResult, c as InstanceFilter, 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-EdwtErKD.js';
+import { m as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, j as AuditContext, a as ApprovalInstance, e as ApprovalMode, b as AuditEntry } from './instance-D8D7b07N.js';
+import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-BdfVjYa8.js';
 import { z } from 'zod';
-
-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;
-}
+import { L as Logger } from './Logger-CIzvalFc.js';
+import { C as Clock } from './Clock-3FnOczFJ.js';
+import { I as IAuthorizationPolicy, g as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-Dk_xOKxR.js';
+import { I as IAuditAdapter } from './IAuditAdapter-B3vvU09m.js';
+import { I as IMetricsAdapter } from './IMetricsAdapter-D9PUz4tM.js';
 
 declare const SubmitOptionsSchema: z.ZodObject<{
     templateName: z.ZodString;
@@ -151,19 +76,6 @@ type ResubmitOptions = z.infer<typeof ResubmitOptionsSchema>;
 type AddCommentOptions = z.infer<typeof AddCommentOptionsSchema>;
 type OverrideOptions = z.infer<typeof OverrideOptionsSchema>;
 
-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;
-
-interface Clock {
-    now(): Date;
-}
-declare const systemClock: Clock;
-
 /**
  * Computes deadline dates from a number of days. The default engine behaviour
  * treats day offsets (escalationAfterDays, slaDeadlineDays) as plain calendar
@@ -216,67 +128,6 @@ type ApproverResolverFn = (config: Record<string, unknown>, ctx: {
 
 type ConditionOperatorFn = (actual: unknown, expected: unknown) => boolean;
 
-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 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>;
-}
-
-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>;
-}
-
-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;
-}
-
 interface ISchedulerAdapter {
     /**
      * Schedule a one-shot callback to run at the given date.
@@ -289,38 +140,6 @@ interface ISchedulerAdapter {
     shutdown(): Promise<void>;
 }
 
-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;
-}
-
 interface ValidationResult {
     valid: boolean;
     errors: Array<{
@@ -501,4 +320,4 @@ declare class ApprovalEngine {
     private runExternalAudit;
 }
 
-export { type ResubmitOptions as $, type AddCommentOptions as A, type BulkResult as B, type Clock as C, type DelegateOptions as D, type EscalateOptions as E, type IMetricsAdapter as F, type INotificationAdapter as G, type HealthResult as H, type IAuditAdapter as I, type IOperationMiddleware as J, type ISchedulerAdapter as K, type Logger as L, type IdGeneratorFn as M, type IdempotencyKeyFn as N, type LevelAdvancedEvent as O, type MetricName as P, type NotificationEvent as Q, type OperationContext as R, type OrgProvider as S, type OverriddenEvent as T, type OverrideOptions as U, type PreviewChainLevel as V, type PreviewResult as W, type ReassignOptions as X, type ReassignedEvent as Y, type RejectOptions as Z, type RejectedEvent as _, ApprovalConflictError as a, type ResubmittedEvent as a0, type RetryPolicy as a1, type SlaBreachedEvent as a2, type SubmitOptions as a3, type SubmittedEvent as a4, type ValidationResult as a5, type WeekendCalendarOptions as a6, defaultIdGenerator as a7, noopLogger as a8, systemClock as a9, weekendCalendar as aa, ApprovalEngine as b, type ApprovalEngineOptions as c, ApprovalError as d, type ApprovalEvent as e, type ApprovalEventMap as f, type ApprovalEventName as g, ApprovalForbiddenError as h, ApprovalNotFoundError as i, type ApprovalStatistics as j, ApprovalTemplateNotFoundError as k, ApprovalValidationError as l, type ApproveOptions as m, type ApprovedEvent as n, type ApproverResolverFn as o, type AuthorizationContext as p, type BusinessCalendar as q, type CanApproveResult as r, type CancelOptions as s, type CancelledEvent as t, type ConditionOperatorFn as u, type DelegatedEvent as v, type EscalatedEvent as w, type ExpiredEvent as x, type HistoryEntry as y, type IAuthorizationPolicy as z };
+export { type AddCommentOptions as A, type BulkResult as B, type CanApproveResult as C, type DelegateOptions as D, type EscalateOptions as E, type HealthResult as H, type ISchedulerAdapter as I, type OrgProvider as O, type PreviewChainLevel as P, type ReassignOptions as R, type SubmitOptions as S, type ValidationResult as V, type WeekendCalendarOptions as W, ApprovalEngine as a, type ApprovalEngineOptions as b, type ApprovalStatistics as c, type ApproveOptions as d, type ApproverResolverFn as e, type BusinessCalendar as f, type CancelOptions as g, type ConditionOperatorFn as h, type IdGeneratorFn as i, type IdempotencyKeyFn as j, type OverrideOptions as k, type PreviewResult as l, type RejectOptions as m, type ResubmitOptions as n, type RetryPolicy as o, defaultIdGenerator as p, weekendCalendar as w };

package/dist/Clock-3FnOczFJ.d.cts

@@ -0,0 +1,6 @@
+interface Clock {
+    now(): Date;
+}
+declare const systemClock: Clock;
+
+export { type Clock as C, systemClock as s };

package/dist/Clock-3FnOczFJ.d.ts

@@ -0,0 +1,6 @@
+interface Clock {
+    now(): Date;
+}
+declare const systemClock: Clock;
+
+export { type Clock as C, systemClock as s };

package/dist/IAuditAdapter-B3vvU09m.d.ts

@@ -0,0 +1,12 @@
+import { b as AuditEntry, a as ApprovalInstance } from './instance-D8D7b07N.js';
+
+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/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 };