import { SchemaBase } from './dsl.js';
import type { ControllerMethodSchema } from './controller.js';
import type { ThirdServiceMethodSchema, ThirdCallbackSchema } from './third-service.js';
import type { TaskSchema } from './task.js';
import type { TableSchema } from './db.js';
import type { PageSchema } from './page.js';
/** A beat of a journey: type + properties + input data. */
export interface ActionSchema extends SchemaBase {
    type: 'page' | 'controller' | 'third' | 'db' | 'task';
    /** Input data of this beat (blueprint: names first, refined to refs later). */
    data?: Record<string, unknown>;
}
/** Visit a page — `data` present means fill/submit a form, absent means pure view. */
export interface PageAction extends ActionSchema {
    type: 'page';
    /** Target page (PageFlow node). */
    page: PageSchema;
    /** Page url/path (e.g. '/bd/apply'). */
    url: string;
}
/** Call a backend controller method. */
export interface ControllerAction extends ActionSchema {
    type: 'controller';
    /** The controller method invoked (shared instance). */
    method: ControllerMethodSchema;
}
/** Invoke a third-party service method or receive its callback. */
export interface ThirdAction extends ActionSchema {
    type: 'third';
    /** The third-party method invoked (outbound). */
    method?: ThirdServiceMethodSchema;
    /** The third-party callback received (inbound) — mutually exclusive with method. */
    callback?: ThirdCallbackSchema;
    /** Wait for the async callback (inbound) before the journey continues. */
    async?: boolean;
}
/** Write to a database table. */
export interface DbAction extends ActionSchema {
    type: 'db';
    /** The table written (shared instance). */
    table: TableSchema;
    /** Write operation: insert | update | delete. */
    op: 'insert' | 'update' | 'delete';
}
/** Trigger a system task (scheduled or async). */
export interface TaskAction extends ActionSchema {
    type: 'task';
    /** The task triggered (shared instance). */
    task: TaskSchema;
}
/** Builder for a journey action. */
export declare const action: {
    page(options: {
        page: PageSchema;
        url: string;
        data?: Record<string, unknown>;
        description?: string;
    }): PageAction;
    controller(options: {
        method: ControllerMethodSchema;
        data?: Record<string, unknown>;
        description?: string;
    }): ControllerAction;
    third(options: {
        method?: ThirdServiceMethodSchema;
        callback?: ThirdCallbackSchema;
        data?: Record<string, unknown>;
        async?: boolean;
        description?: string;
    }): ThirdAction;
    db(options: {
        table: TableSchema;
        op: 'insert' | 'update' | 'delete';
        data?: Record<string, unknown>;
        description?: string;
    }): DbAction;
    task(options: {
        task: TaskSchema;
        data?: Record<string, unknown>;
        description?: string;
    }): TaskAction;
};