import { z } from 'zod';
import { ListRowsResponse, SeaTableRow, SeaTableTable } from './types.js';
export interface SeaTableClientConfig {
    serverUrl: string;
    apiToken: string;
    timeoutMs?: number;
}
declare const ListRowsQuerySchema: z.ZodObject<{
    table: z.ZodString;
    page: z.ZodDefault<z.ZodNumber>;
    page_size: z.ZodDefault<z.ZodNumber>;
}, "strip", z.ZodTypeAny, {
    table: string;
    page: number;
    page_size: number;
}, {
    table: string;
    page?: number | undefined;
    page_size?: number | undefined;
}>;
export type ListRowsQuery = z.infer<typeof ListRowsQuerySchema>;
/** Escape backticks in SQL identifiers to prevent injection. */
export declare function sanitizeIdentifier(name: string): string;
export declare class SeaTableClient {
    private readonly tokenManager;
    private readonly limiter;
    private readonly serverUrl;
    private readonly apiToken;
    private readonly timeoutMs;
    private http?;
    private initialized;
    private initializing?;
    private metadataCache?;
    private static readonly METADATA_CACHE_TTL_MS;
    constructor(config: SeaTableClientConfig);
    /** Returns dtable_uuid and app_name from the last token exchange (available after first API call). */
    getBaseInfo(): {
        dtableUuid?: string;
        appName?: string;
    };
    private ensureInitialized;
    private init;
    private request;
    getMetadata(): Promise<any>;
    clearMetadataCache(): void;
    listTables(): Promise<SeaTableTable[]>;
    listRows(query: {
        table: string;
        page?: number;
        page_size?: number;
    }): Promise<ListRowsResponse>;
    getRow(table: string, rowId: string): Promise<SeaTableRow>;
    addRow(table: string, row: Record<string, unknown>): Promise<SeaTableRow>;
    addRows(table: string, rows: Array<Record<string, unknown>>): Promise<SeaTableRow[]>;
    updateRow(table: string, rowId: string, row: Record<string, unknown>): Promise<any>;
    updateRows(table: string, updates: Array<{
        row_id: string;
        row: Record<string, unknown>;
    }>): Promise<{
        success: boolean;
    }>;
    deleteRow(table: string, rowId: string): Promise<{
        success: boolean;
    }>;
    deleteRows(table: string, rowIds: string[]): Promise<{
        success: boolean;
    }>;
    searchRows(table: string, query: Record<string, unknown>): Promise<ListRowsResponse>;
    querySql(sql: string, parameters?: any[]): Promise<{
        metadata: any;
        results: any[];
    }>;
    listCollaborators(): Promise<Array<{
        email: string;
        name: string;
    }>>;
    private resolveLinkColumn;
    createLinks(args: {
        table: string;
        linkColumn: string;
        pairs: Array<{
            fromRowId: string;
            toRowId: string;
        }>;
    }): Promise<any>;
    deleteLinks(args: {
        table: string;
        linkColumn: string;
        pairs: Array<{
            fromRowId: string;
            toRowId: string;
        }>;
    }): Promise<any>;
    addColumnOptions(args: {
        table: string;
        column: string;
        options: Array<{
            name: string;
            color?: string;
            textColor?: string;
        }>;
    }): Promise<any>;
    uploadFile(args: {
        table: string;
        column: string;
        rowId: string;
        fileName: string;
        fileData: string;
        replace?: boolean;
    }): Promise<{
        file_name: string;
        file_size: number;
        asset_url: string;
        column_type: string;
    }>;
    getRowActivities(rowId: string, page?: number): Promise<{
        activities: any[];
        total_count: number;
    }>;
    createSnapshot(): Promise<{
        status: string;
        snapshot: {
            dtable_uuid: string;
            dtable_name: string;
            commit_id: string;
            ctime: number;
        };
    }>;
    private static readonly TEXT_EXTENSIONS;
    private static readonly MAX_FILE_SIZE;
    downloadFile(args: {
        table: string;
        column: string;
        rowId: string;
        fileName?: string;
    }): Promise<{
        file_name: string;
        file_size: number;
        content: string;
        content_type: 'text' | 'pdf_text' | 'binary_url';
        download_link?: string;
    }>;
}
/** Create a client from environment variables (selfhosted mode). */
export declare function createClientFromEnv(): SeaTableClient;
/** Create a client from a provided API token (managed mode). Server URL from env. */
export declare function createClientFromToken(apiToken: string): SeaTableClient;
export {};
//# sourceMappingURL=client.d.ts.map