/**
 * module: trigger —— 本模块要外界提供的能力(编码规范 §10.1 / §5.3)。
 */
import type { TriggerConfig } from '@contracts';
export type Clock = {
    now(): Date;
};
export type IdGenerator = {
    next(): string;
};
export type TriggerStore = {
    list(): Promise<TriggerConfig[]>;
    get(id: string): Promise<TriggerConfig | undefined>;
    upsert(config: TriggerConfig): Promise<TriggerConfig>;
    setEnabled(id: string, enabled: boolean): Promise<void>;
    remove(id: string): Promise<void>;
    /** 幂等:同一键至多起一单 */
    claim(key: string): Promise<boolean>;
    lastFiredAt(id: string): Promise<Date | undefined>;
    markFired(id: string, at: Date): Promise<void>;
};
/** 起单 —— app 注入 `process`(L7 同层?否:trigger 在 process 之上同层,经 app 装配) */
export type ProcessGateway = {
    start(input: {
        packageId: string;
        subject: string;
        source: {
            kind: 'periodic' | 'event' | 'registration';
            ref: string;
            by?: string;
        };
        data: Record<string, unknown>;
    }): Promise<{
        id: string;
    }>;
    /** 调用接口的必填字段 —— 装配缺项即起单失败 */
    requiredInputs(packageId: string): Promise<string[]>;
};
export type Sfeel = {
    condition(expression: string, scope: Readonly<Record<string, unknown>>): boolean;
    expression(expression: string, scope: Readonly<Record<string, unknown>>): unknown;
};
/** 死信 —— app 注入 `message`(L2):起单失败入死信 */
export type DeadLetterSink = {
    report(input: {
        triggerId: string;
        reason: string;
        detail: Record<string, unknown>;
    }): Promise<void>;
};
/** 数据日历型要读台账 —— app 注入 `ledger`(L1) */
export type LedgerScanner = {
    scan(input: {
        domain: string;
        object: string;
        dateField: string;
        filter?: string;
    }): Promise<Array<{
        key: Record<string, string | number>;
        date: string;
        row: Record<string, unknown>;
    }>>;
};