export type DeliveryState = "PENDING" | "CONFIRMED" | "PREPARING" | "READY_FOR_PICKUP" | "PICKED_UP" | "IN_TRANSIT" | "DELIVERED" | "CANCELLED" | "FAILED" | "REFUNDED";
export type DeliveryEvent = "CONFIRM" | "START_PREPARING" | "MARK_READY" | "ASSIGN_RIDER" | "PICKUP" | "START_TRANSIT" | "DELIVER" | "CANCEL" | "FAIL" | "REFUND";
/**
 * Maps each state to the events it accepts and the resulting next state.
 *
 * S = your state union  (e.g. "PENDING" | "PAID" | "SHIPPED")
 * E = your event union  (e.g. "PAY" | "SHIP" | "CANCEL")
 */
export type TransitionMap<S extends string, E extends string> = {
    [State in S]?: Partial<Record<E, S>>;
};
export interface TransitionContext<S extends string, E extends string> {
    orderId: string;
    from: S;
    to: S;
    event: E;
    timestamp: Date;
    metadata?: Record<string, unknown>;
}
export type TransitionHook<S extends string, E extends string> = (ctx: TransitionContext<S, E>) => void | Promise<void>;
export interface StateMachineHooks<S extends string, E extends string> {
    onTransition?: TransitionHook<S, E>;
    onEnter?: Partial<Record<S, TransitionHook<S, E>>>;
    onExit?: Partial<Record<S, TransitionHook<S, E>>>;
}
export interface HistoryEntry<S extends string, E extends string> {
    from: S;
    to: S;
    event: E;
    timestamp: Date;
    metadata?: Record<string, unknown>;
}
export interface StateMachineConfig<S extends string, E extends string> {
    orderId: string;
    initialState: S;
    transitions: TransitionMap<S, E>;
    hooks?: StateMachineHooks<S, E>;
    /** States where no further transitions are expected */
    terminalStates?: S[];
    /** States that represent an active, in-progress lifecycle */
    activeStates?: S[];
}
export type DeliveryStateMachineConfig = Omit<StateMachineConfig<DeliveryState, DeliveryEvent>, "initialState" | "transitions"> & {
    initialState?: DeliveryState;
    transitions?: TransitionMap<DeliveryState, DeliveryEvent>;
};
export declare class InvalidTransitionError<S extends string = string, E extends string = string> extends Error {
    readonly from: S;
    readonly event: E;
    constructor(from: S, event: E);
}
//# sourceMappingURL=types.d.ts.map