import type { RipplingSDK } from "../../../client.js";
import { FunctionResponse, type FunctionContext } from "../../../functions.js";
import type { FunctionExecution, FunctionExecutionsPageCursorURL, ExecutionListLogsResponse } from "../../../resources/functions/executions.js";
import type { APIPromise } from "../../../core/api-promise.js";
import type { PagePromise } from "../../../core/pagination.js";
import { ManifestFunction, type ManifestFunctionProps } from "../manifest-function.js";
import type { RequestOptions } from "../../../internal/request-options.js";
import type { ExecutionListParams, ExecutionListLogsParams } from "../../../resources/functions/executions.js";
/** Parser shared by a function's caller and handler. */
export interface ValueParser<TValue> {
    parse(value: unknown): TValue;
}
/** Authenticated execution resources supplied per call. */
export interface FunctionOperationsContext {
    readonly functions: {
        readonly executions: Pick<RipplingSDK['functions']['executions'], 'create' | 'list' | 'retrieve' | 'listLogs'>;
    };
}
export interface DefinedFunctionProps<TInput, TOutput> extends ManifestFunctionProps {
    /** Handler source file read unchanged by project export. Importing the definition performs no file I/O. */
    source?: URL;
    input?: ValueParser<TInput>;
    output?: ValueParser<TOutput>;
}
/** Execution returned by a function with its declared input/output contract. */
export type FunctionExecutionResult<TInput, TOutput> = Omit<FunctionExecution, 'inputs' | 'outputs'> & {
    inputs: TInput;
    outputs?: TOutput;
};
export interface FunctionExecutions {
    list(ctx: FunctionOperationsContext, params?: ExecutionListParams, options?: RequestOptions): PagePromise<FunctionExecutionsPageCursorURL, FunctionExecution>;
    retrieve(ctx: FunctionOperationsContext, executionID: string, options?: RequestOptions): APIPromise<FunctionExecution>;
    listLogs(ctx: FunctionOperationsContext, executionID: string, params?: Omit<ExecutionListLogsParams, 'function_api_name'>, options?: RequestOptions): APIPromise<ExecutionListLogsResponse>;
}
export interface FunctionClient<TInput, TOutput> {
    execute(input: TInput, options?: RequestOptions): Promise<FunctionExecutionResult<TInput, TOutput>>;
    executions: {
        list(params?: ExecutionListParams, options?: RequestOptions): PagePromise<FunctionExecutionsPageCursorURL, FunctionExecution>;
        retrieve(executionID: string, options?: RequestOptions): APIPromise<FunctionExecution>;
        listLogs(executionID: string, params?: Omit<ExecutionListLogsParams, 'function_api_name'>, options?: RequestOptions): APIPromise<ExecutionListLogsResponse>;
    };
}
export declare function defineFunction<TInput = unknown, TOutput = unknown>(props: DefinedFunctionProps<TInput, TOutput>): DefinedFunction<TInput, TOutput>;
/** A deployable function reference with the same input/output contract at each call site. */
export declare class DefinedFunction<TInput = unknown, TOutput = unknown> extends ManifestFunction {
    private _source;
    readonly input: ValueParser<TInput> | undefined;
    readonly output: ValueParser<TOutput> | undefined;
    readonly executions: FunctionExecutions;
    constructor(props: DefinedFunctionProps<TInput, TOutput>);
    get source(): URL | undefined;
    /** Replaces inline code or a file-backed source with the supplied code. */
    setCode(code: string): this;
    /** Wraps a handler with the shared contract. Deployed source must be standalone or use declared npm dependencies. */
    handler(handler: (input: TInput, context: FunctionContext) => TOutput | Promise<TOutput>): (event: TInput, context: FunctionContext) => Promise<FunctionResponse<TOutput>>;
    /** Starts an execution. Asynchronous executions may not have outputs yet. */
    execute(ctx: FunctionOperationsContext, input: TInput, options?: RequestOptions): Promise<FunctionExecutionResult<TInput, TOutput>>;
}
/** @internal Forward client helpers to the definition operations. */
export declare function createFunctionClient<TInput, TOutput>(ctx: FunctionOperationsContext, definition: DefinedFunction<TInput, TOutput>): FunctionClient<TInput, TOutput>;
//# sourceMappingURL=function.d.ts.map