import type { Zero } from '../../../zero-client/src/client/zero.ts';
import type { Schema } from '../../../zero-schema/src/builder/schema-builder.ts';
export interface BatchOp {
    type: 'upsert' | 'delete';
    table: string;
    row?: Record<string, unknown>;
    pkValue?: unknown;
}
export type ConvexBatchCrudFn = (ops: BatchOp[], orgId: string, lmid?: {
    clientGroupID: string;
    clientID: string;
    mutationID: number;
}) => Promise<Array<{
    success: boolean;
    error?: string;
}>>;
/** Query response includes row data + LMID map from zeroClients table */
export type ConvexQueryResult = Record<string, unknown[]> & {
    lastMutationIDChanges?: Record<string, number>;
};
export type ConvexQueryFn = () => Promise<ConvexQueryResult | null>;
export interface ConvexSyncAdapterOptions<S extends Schema> {
    zero: Zero<S>;
    orgId: string;
    /**
     * Tables owned by this adapter. Tables omitted from a query result are left
     * untouched; tables present with an empty array are authoritatively cleared.
     */
    tables: readonly string[];
    /** Primary-key field for every table in `tables`. */
    primaryKeys: Readonly<Record<string, string>>;
    convexBatchCrud: ConvexBatchCrudFn;
    convexQuery: ConvexQueryFn;
}
/**
 * ConvexSyncAdapter — bridges Zero (Replicache) with Convex backend.
 *
 * KEY INSIGHT from Zero cache server analysis:
 * Replicache snapshots are built incrementally on top of the PREVIOUS snapshot.
 * When a poke confirms mutations via lastMutationIDChanges, those mutations
 * are dropped from the replay chain. If the patch doesn't include the data
 * those mutations produced, that data VANISHES.
 *
 * Therefore: every poke that confirms mutations MUST include the full current
 * state via all {op: "put"} rows. This ensures the snapshot is always a
 * complete replacement from Convex truth.
 */
export declare class ConvexSyncAdapter<S extends Schema> {
    #private;
    constructor(options: ConvexSyncAdapterOptions<S>);
    init(): Promise<void>;
    destroy(): void;
    /**
     * Called by Convex subscription when data changes (from any client).
     *
     * Uses LMID-change detection instead of a pending flag:
     * - If server LMIDs contain new confirmations → FULL patch (safe for rebase)
     * - If only row data changed → diff patch (efficient)
     * - If nothing changed → skip entirely
     */
    syncFromConvexData(data: ConvexQueryResult): Promise<boolean>;
}
//# sourceMappingURL=convex.d.ts.map