/**
 * Event batching glue for SkillsmithApiClient
 * @module api/client.events
 *
 * SMI-4119: Keeps batcher wiring out of client.ts to stay under the 500-line cap.
 *
 * This module exposes a small helper that builds a flush function bound to a
 * client's base URL / auth headers and posts batches to `POST /events`.
 */
import type { TelemetryEvent } from './client.js';
import { type EventBatcher } from './event-batcher.js';
/**
 * Inputs required to POST a batch to `/events`.
 * Kept narrow so we don't expose private client fields.
 */
export interface BatchPostContext {
    baseUrl: string;
    anonKey: string | undefined;
    apiKey: string | undefined;
    /** Request timeout in ms. */
    timeout: number;
}
/**
 * Build a flush function that POSTs a batch to `${baseUrl}/events`.
 *
 * Emits `X-Skillsmith-Batched: true` so the edge function can stamp
 * `audit_logs.metadata.batched` and post-deploy SQL can distinguish
 * batched vs stale single-client traffic.
 *
 * Throws on non-2xx responses so the batcher can retry.
 */
export declare function createBatchFlushFn(ctx: () => BatchPostContext): (events: TelemetryEvent[]) => Promise<void>;
/**
 * Build an EventBatcher that POSTs to `${baseUrl}/events` using the live
 * auth context returned by `ctx()`. Lazily re-reads context on each flush so
 * config changes (e.g. API key rotation) are honored.
 */
export declare function buildClientEventBatcher(ctx: () => BatchPostContext): EventBatcher;
//# sourceMappingURL=client.events.d.ts.map