import type { Response } from "express";
export interface ApiOk<T = unknown> {
    ok: true;
    data: T;
    meta?: Record<string, unknown>;
}
export interface ApiError {
    ok: false;
    error: string;
    message: string;
}
export type ApiResponse<T = unknown> = ApiOk<T> | ApiError;
export declare function ok<T>(res: Response, data: T, meta?: Record<string, unknown>, status?: number): Response<any, Record<string, any>>;
export declare function created<T>(res: Response, data: T): Response<any, Record<string, any>>;
export declare function notFound(res: Response, message?: string): Response<any, Record<string, any>>;
export declare function badRequest(res: Response, message: string): Response<any, Record<string, any>>;
export declare function serverError(res: Response, err: unknown): Response<any, Record<string, any>>;
export declare function noContent(res: Response): Response<any, Record<string, any>>;
/**
 * FR-D6: for a route that is mounted and routable but does no work.
 *
 * The alternative this replaces is the one that shipped: returning `ok:true`
 * with a state noun ("staged") for a payload that was parsed and discarded.
 * Every consumer of this API branches on `ok` — packages/engram-dashboard does
 * it at client.ts:59 — so a truthful `ok:false` is the only value that reaches
 * a user as the truth. 501 rather than 500 because nothing went wrong: the
 * feature is absent, which is a fact about the server, not an incident.
 */
export declare function notImplemented(res: Response, message: string): Response<any, Record<string, any>>;
//# sourceMappingURL=api-helpers.d.ts.map