@chkit/plugin-backfill 0.1.0-beta.2 → 0.1.0-beta.21

package/README.md

@@ -0,0 +1,170 @@
+# @chkit/plugin-backfill
+
+Plugin for data backfill operations in chkit.
+
+Part of the [chkit](https://github.com/obsessiondb/chkit) monorepo. This plugin extends the [`chkit`](https://www.npmjs.com/package/chkit) CLI with data backfill commands.
+
+## Install
+
+```bash
+bun add -d @chkit/plugin-backfill
+```
+
+## Usage
+
+Register the plugin in your config:
+
+```ts
+// clickhouse.config.ts
+import { defineConfig } from '@chkit/core'
+import { backfill } from '@chkit/plugin-backfill'
+
+export default defineConfig({
+  schema: './src/db/schema/**/*.ts',
+  outDir: './chkit',
+  plugins: [
+    backfill(),
+  ],
+  clickhouse: {
+    url: process.env.CLICKHOUSE_URL ?? 'http://localhost:8123',
+  },
+})
+```
+
+## Documentation
+
+See the [chkit documentation](https://chkit.obsessiondb.com).
+
+## SDK
+
+The package root is limited to the plugin registration API. Everything used by the CLI itself — the chunk planner, SQL builders, async executor, logging — is also exported from the `@chkit/plugin-backfill/sdk` subpath so you can build your own backfill scripts without going through the CLI.
+
+```ts
+import {
+  generateChunkPlan,
+  buildChunkExecutionSql,
+  executeBackfill,
+  getBackfillLogger,
+  type ChunkPlan,
+  type PlannerQuery,
+} from '@chkit/plugin-backfill/sdk'
+```
+
+The pipeline has three stages, and you can use any subset:
+
+1. **Plan** — `generateChunkPlan(...)` introspects a table and returns a `ChunkPlan` describing how to partition the work into roughly equal-sized chunks.
+2. **Build SQL** — `buildChunkExecutionSql(...)` turns a single `Chunk` into an `INSERT … SELECT` statement.
+3. **Execute** — `executeBackfill(...)` submits chunks against a real `ClickHouseExecutor` with deterministic query IDs, polling, and resume support.
+
+### Plan a backfill
+
+`generateChunkPlan` is decoupled from any ClickHouse client. You pass in a `query` function with the `PlannerQuery` shape and the planner uses it for every introspection / probe / split query. This makes the planner trivial to instrument or run against alternative clients.
+
+```ts
+import { createClient } from '@clickhouse/client'
+import { generateChunkPlan, type PlannerQuery } from '@chkit/plugin-backfill/sdk'
+
+const client = createClient({ url: process.env.CLICKHOUSE_URL })
+
+const query: PlannerQuery = async (sql, settings) => {
+  const result = await client.query({
+    query: sql,
+    format: 'JSONEachRow',
+    clickhouse_settings: settings as Record<string, string | number | boolean>,
+  })
+  return result.json()
+}
+
+const plan = await generateChunkPlan({
+  database: 'analytics',
+  table: 'events',
+  from: '2025-01-01T00:00:00Z',
+  to: '2025-02-01T00:00:00Z',
+  targetChunkBytes: 1_000_000_000, // ~1 GiB per chunk
+  query,
+  // 'count' is exact but slower; 'explain-estimate' is faster but approximate
+  rowProbeStrategy: 'count',
+})
+
+console.log(`${plan.chunks.length} chunks, ${plan.totalRows.toLocaleString()} rows`)
+```
+
+### Execute chunks against a target
+
+`buildChunkExecutionSql` produces the per-chunk `INSERT … SELECT` and `executeBackfill` runs them with concurrency, polling, and progress callbacks. Persist the `progress` argument anywhere you like to support resume.
+
+```ts
+import { createClickHouseExecutor } from '@chkit/clickhouse'
+import {
+  buildChunkExecutionSql,
+  executeBackfill,
+  type BackfillProgress,
+} from '@chkit/plugin-backfill/sdk'
+
+const executor = createClickHouseExecutor({
+  url: process.env.CLICKHOUSE_URL!,
+  username: 'default',
+  password: process.env.CLICKHOUSE_PASSWORD!,
+  database: 'analytics',
+})
+
+const chunksById = new Map(plan.chunks.map((chunk) => [chunk.id, chunk]))
+let saved: BackfillProgress | undefined // load from disk for resume
+
+const result = await executeBackfill({
+  executor,
+  planId: plan.planId,
+  chunks: plan.chunks,
+  buildQuery: ({ id }) =>
+    buildChunkExecutionSql({
+      planId: plan.planId,
+      chunk: chunksById.get(id)!,
+      target: 'analytics.events_backfill',
+      table: plan.table,
+    }),
+  concurrency: 4,
+  pollIntervalMs: 5_000,
+  resumeFrom: saved,
+  onProgress: async (progress) => {
+    saved = progress
+    // persist to disk / state store
+  },
+})
+
+console.log(`done=${result.completed} failed=${result.failed}`)
+```
+
+### Plan persistence
+
+Plans contain string boundaries that may include non-UTF-8 bytes (the planner uses `latin1`-encoded byte ranges for string sort keys), so JSON-serializing a `ChunkPlan` directly will lose information. Use the codec helpers when you need to round-trip a plan through storage:
+
+```ts
+import {
+  encodeChunkPlanForPersistence,
+  decodeChunkPlanFromPersistence,
+} from '@chkit/plugin-backfill/sdk'
+
+const json = JSON.stringify(encodeChunkPlanForPersistence(plan))
+// later …
+const plan2 = decodeChunkPlanFromPersistence(JSON.parse(json))
+```
+
+### Logging
+
+The planner emits structured logs via [`@logtape/logtape`](https://logtape.org/) under the `['chkit', 'backfill']` category. Configure a sink at process start to see them — slow-query warnings (>5 s) are emitted at `warning` level, planning progress at `info`, and per-strategy decisions at `debug`.
+
+```ts
+import { configureSync, getConsoleSink, getTextFormatter } from '@chkit/plugin-backfill/sdk'
+
+configureSync({
+  sinks: { console: getConsoleSink({ formatter: getTextFormatter({ timestamp: 'time' }) }) },
+  loggers: [{ category: 'chkit', sinks: ['console'], lowestLevel: 'info' }],
+  reset: true,
+})
+```
+
+To capture every SQL statement the planner runs (with timing, server-side stats, and per-strategy classification), wrap your `query` function instead of relying solely on logging — the wrapper sees the raw SQL and settings on every call and can record query IDs, response headers, and durations alongside the structured logs.
+
+## License
+
+[MIT](../../LICENSE)

package/dist/args.d.ts

@@ -1,8 +1,111 @@
+import { type ParsedFlags } from '@chkit/core';
 import type { ParsedCancelArgs, ParsedDoctorArgs, ParsedPlanArgs, ParsedResumeArgs, ParsedRunArgs, ParsedStatusArgs } from './types.js';
-export declare function parsePlanArgs(args: string[]): ParsedPlanArgs;
-export declare function parseRunArgs(args: string[]): ParsedRunArgs;
-export declare function parseResumeArgs(args: string[]): ParsedResumeArgs;
-export declare function parseStatusArgs(args: string[]): ParsedStatusArgs;
-export declare function parseCancelArgs(args: string[]): ParsedCancelArgs;
-export declare function parseDoctorArgs(args: string[]): ParsedDoctorArgs;
+export declare const PLAN_FLAGS: readonly [{
+    readonly name: "--target";
+    readonly type: "string";
+    readonly description: "Target table (database.table)";
+    readonly placeholder: "<database.table>";
+}, {
+    readonly name: "--from";
+    readonly type: "string";
+    readonly description: "Start timestamp";
+    readonly placeholder: "<timestamp>";
+}, {
+    readonly name: "--to";
+    readonly type: "string";
+    readonly description: "End timestamp";
+    readonly placeholder: "<timestamp>";
+}, {
+    readonly name: "--chunk-hours";
+    readonly type: "string";
+    readonly description: "Hours per chunk";
+    readonly placeholder: "<hours>";
+}, {
+    readonly name: "--time-column";
+    readonly type: "string";
+    readonly description: "Time column for WHERE clause";
+    readonly placeholder: "<column>";
+}, {
+    readonly name: "--force-large-window";
+    readonly type: "boolean";
+    readonly description: "Allow large time windows without confirmation";
+}, {
+    readonly name: "--force";
+    readonly type: "boolean";
+    readonly description: "Delete existing plan and regenerate from scratch";
+}];
+export declare const RUN_FLAGS: readonly [{
+    readonly name: "--plan-id";
+    readonly type: "string";
+    readonly description: "Plan ID to execute";
+    readonly placeholder: "<id>";
+}, {
+    readonly name: "--replay-done";
+    readonly type: "boolean";
+    readonly description: "Re-execute already completed chunks";
+}, {
+    readonly name: "--replay-failed";
+    readonly type: "boolean";
+    readonly description: "Re-execute failed chunks";
+}, {
+    readonly name: "--force-overlap";
+    readonly type: "boolean";
+    readonly description: "Allow overlapping runs";
+}, {
+    readonly name: "--force-compatibility";
+    readonly type: "boolean";
+    readonly description: "Skip compatibility checks";
+}, {
+    readonly name: "--force-environment";
+    readonly type: "boolean";
+    readonly description: "Skip environment mismatch checks";
+}, {
+    readonly name: "--simulate-fail-chunk";
+    readonly type: "string";
+    readonly description: "Simulate failure on chunk";
+    readonly placeholder: "<chunk-id>";
+}, {
+    readonly name: "--simulate-fail-count";
+    readonly type: "string";
+    readonly description: "Number of simulated failures";
+    readonly placeholder: "<count>";
+}];
+export declare const RESUME_FLAGS: readonly [{
+    readonly name: "--plan-id";
+    readonly type: "string";
+    readonly description: "Plan ID to resume";
+    readonly placeholder: "<id>";
+}, {
+    readonly name: "--replay-done";
+    readonly type: "boolean";
+    readonly description: "Re-execute already completed chunks";
+}, {
+    readonly name: "--replay-failed";
+    readonly type: "boolean";
+    readonly description: "Re-execute failed chunks";
+}, {
+    readonly name: "--force-overlap";
+    readonly type: "boolean";
+    readonly description: "Allow overlapping runs";
+}, {
+    readonly name: "--force-compatibility";
+    readonly type: "boolean";
+    readonly description: "Skip compatibility checks";
+}, {
+    readonly name: "--force-environment";
+    readonly type: "boolean";
+    readonly description: "Skip environment mismatch checks";
+}];
+export declare const PLAN_ID_FLAGS: readonly [{
+    readonly name: "--plan-id";
+    readonly type: "string";
+    readonly description: "Plan ID";
+    readonly placeholder: "<id>";
+}];
+export declare function parsePlanArgs(flags: ParsedFlags): ParsedPlanArgs;
+export declare function parseRunArgs(flags: ParsedFlags): ParsedRunArgs;
+export declare function parseResumeArgs(flags: ParsedFlags): ParsedResumeArgs;
+export declare function parseStatusArgs(flags: ParsedFlags): ParsedStatusArgs;
+export declare function parseCancelArgs(flags: ParsedFlags): ParsedCancelArgs;
+export declare function parseDoctorArgs(flags: ParsedFlags): ParsedDoctorArgs;
 //# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAgCnB,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,CAgD5D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAoE1D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAShE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAkBhE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAEhE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAEhE"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAGvE,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQZ,CAAA;AAEX,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASX,CAAA;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;EAOd,CAAA;AAEX,eAAO,MAAM,aAAa;;;;;EAEf,CAAA;AAgCX,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAgChE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,aAAa,CAgC9D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CAUpE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CAKpE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CAEpE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CAEpE"}

package/dist/args.js

@@ -1,4 +1,35 @@
+import { defineFlags, typedFlags } from '@chkit/core';
 import { BackfillConfigError } from './errors.js';
+export const PLAN_FLAGS = defineFlags([
+    { name: '--target', type: 'string', description: 'Target table (database.table)', placeholder: '<database.table>' },
+    { name: '--from', type: 'string', description: 'Start timestamp', placeholder: '<timestamp>' },
+    { name: '--to', type: 'string', description: 'End timestamp', placeholder: '<timestamp>' },
+    { name: '--chunk-hours', type: 'string', description: 'Hours per chunk', placeholder: '<hours>' },
+    { name: '--time-column', type: 'string', description: 'Time column for WHERE clause', placeholder: '<column>' },
+    { name: '--force-large-window', type: 'boolean', description: 'Allow large time windows without confirmation' },
+    { name: '--force', type: 'boolean', description: 'Delete existing plan and regenerate from scratch' },
+]);
+export const RUN_FLAGS = defineFlags([
+    { name: '--plan-id', type: 'string', description: 'Plan ID to execute', placeholder: '<id>' },
+    { name: '--replay-done', type: 'boolean', description: 'Re-execute already completed chunks' },
+    { name: '--replay-failed', type: 'boolean', description: 'Re-execute failed chunks' },
+    { name: '--force-overlap', type: 'boolean', description: 'Allow overlapping runs' },
+    { name: '--force-compatibility', type: 'boolean', description: 'Skip compatibility checks' },
+    { name: '--force-environment', type: 'boolean', description: 'Skip environment mismatch checks' },
+    { name: '--simulate-fail-chunk', type: 'string', description: 'Simulate failure on chunk', placeholder: '<chunk-id>' },
+    { name: '--simulate-fail-count', type: 'string', description: 'Number of simulated failures', placeholder: '<count>' },
+]);
+export const RESUME_FLAGS = defineFlags([
+    { name: '--plan-id', type: 'string', description: 'Plan ID to resume', placeholder: '<id>' },
+    { name: '--replay-done', type: 'boolean', description: 'Re-execute already completed chunks' },
+    { name: '--replay-failed', type: 'boolean', description: 'Re-execute failed chunks' },
+    { name: '--force-overlap', type: 'boolean', description: 'Allow overlapping runs' },
+    { name: '--force-compatibility', type: 'boolean', description: 'Skip compatibility checks' },
+    { name: '--force-environment', type: 'boolean', description: 'Skip environment mismatch checks' },
+]);
+export const PLAN_ID_FLAGS = defineFlags([
+    { name: '--plan-id', type: 'string', description: 'Plan ID', placeholder: '<id>' },
+]);
 function normalizeTimestamp(raw, flagName) {
     const value = raw.trim();
     if (value.length === 0) {
@@ -24,40 +55,22 @@ function normalizePlanId(raw) {
     }
     return value;
 }
-export function parsePlanArgs(args) {
-    let target;
-    let from;
-    let to;
+export function parsePlanArgs(flags) {
+    const f = typedFlags(flags, PLAN_FLAGS);
+    const target = f['--target'];
+    const from = f['--from'];
+    const to = f['--to'];
+    const rawChunkHours = f['--chunk-hours'];
+    const timeColumn = f['--time-column'];
+    const forceLargeWindow = f['--force-large-window'] === true;
+    const force = f['--force'] === true;
     let chunkHours;
-    let forceLargeWindow = false;
-    for (let i = 0; i < args.length; i += 1) {
-        const token = args[i];
-        if (!token)
-            continue;
-        if (token === '--force-large-window') {
-            forceLargeWindow = true;
-            continue;
-        }
-        if (token === '--target' || token === '--from' || token === '--to' || token === '--chunk-hours') {
-            const nextValue = args[i + 1];
-            if (!nextValue || nextValue.startsWith('--')) {
-                throw new BackfillConfigError(`Missing value for ${token}`);
-            }
-            if (token === '--target')
-                target = nextValue;
-            if (token === '--from')
-                from = nextValue;
-            if (token === '--to')
-                to = nextValue;
-            if (token === '--chunk-hours') {
-                const parsed = Number(nextValue);
-                if (!Number.isFinite(parsed) || parsed <= 0) {
-                    throw new BackfillConfigError('Invalid value for --chunk-hours. Expected a positive number.');
-                }
-                chunkHours = parsed;
-            }
-            i += 1;
+    if (rawChunkHours !== undefined) {
+        const parsed = Number(rawChunkHours);
+        if (!Number.isFinite(parsed) || parsed <= 0) {
+            throw new BackfillConfigError('Invalid value for --chunk-hours. Expected a positive number.');
         }
+        chunkHours = parsed;
     }
     if (!target)
         throw new BackfillConfigError('Missing required --target <database.table>');
@@ -70,57 +83,28 @@ export function parsePlanArgs(args) {
         from: normalizeTimestamp(from, '--from'),
         to: normalizeTimestamp(to, '--to'),
         chunkHours,
+        timeColumn: timeColumn?.trim() || undefined,
         forceLargeWindow,
+        force,
     };
 }
-export function parseRunArgs(args) {
-    let planId;
-    let replayDone = false;
-    let replayFailed = false;
-    let forceOverlap = false;
-    let forceCompatibility = false;
-    let simulateFailChunk;
+export function parseRunArgs(flags) {
+    const f = typedFlags(flags, RUN_FLAGS);
+    const planId = f['--plan-id'];
+    const replayDone = f['--replay-done'] === true;
+    const replayFailed = f['--replay-failed'] === true;
+    const forceOverlap = f['--force-overlap'] === true;
+    const forceCompatibility = f['--force-compatibility'] === true;
+    const forceEnvironment = f['--force-environment'] === true;
+    const simulateFailChunk = f['--simulate-fail-chunk'];
     let simulateFailCount = 1;
-    for (let i = 0; i < args.length; i += 1) {
-        const token = args[i];
-        if (!token)
-            continue;
-        if (token === '--replay-done') {
-            replayDone = true;
-            continue;
-        }
-        if (token === '--replay-failed') {
-            replayFailed = true;
-            continue;
-        }
-        if (token === '--force-overlap') {
-            forceOverlap = true;
-            continue;
-        }
-        if (token === '--force-compatibility') {
-            forceCompatibility = true;
-            continue;
-        }
-        if (token === '--plan-id' ||
-            token === '--simulate-fail-chunk' ||
-            token === '--simulate-fail-count') {
-            const nextValue = args[i + 1];
-            if (!nextValue || nextValue.startsWith('--')) {
-                throw new BackfillConfigError(`Missing value for ${token}`);
-            }
-            if (token === '--plan-id')
-                planId = nextValue;
-            if (token === '--simulate-fail-chunk')
-                simulateFailChunk = nextValue;
-            if (token === '--simulate-fail-count') {
-                const parsed = Number(nextValue);
-                if (!Number.isFinite(parsed) || parsed <= 0 || !Number.isInteger(parsed)) {
-                    throw new BackfillConfigError('Invalid value for --simulate-fail-count. Expected integer > 0.');
-                }
-                simulateFailCount = parsed;
-            }
-            i += 1;
+    const rawSimulateFailCount = f['--simulate-fail-count'];
+    if (rawSimulateFailCount !== undefined) {
+        const parsed = Number(rawSimulateFailCount);
+        if (!Number.isFinite(parsed) || parsed <= 0 || !Number.isInteger(parsed)) {
+            throw new BackfillConfigError('Invalid value for --simulate-fail-count. Expected integer > 0.');
         }
+        simulateFailCount = parsed;
     }
     if (!planId)
         throw new BackfillConfigError('Missing required --plan-id <id>');
@@ -130,41 +114,33 @@ export function parseRunArgs(args) {
         replayFailed,
         forceOverlap,
         forceCompatibility,
+        forceEnvironment,
         simulateFailChunk,
         simulateFailCount,
     };
 }
-export function parseResumeArgs(args) {
-    const parsed = parseRunArgs(args);
+export function parseResumeArgs(flags) {
+    const parsed = parseRunArgs(flags);
     return {
         planId: parsed.planId,
         replayDone: parsed.replayDone,
         replayFailed: parsed.replayFailed,
         forceOverlap: parsed.forceOverlap,
         forceCompatibility: parsed.forceCompatibility,
+        forceEnvironment: parsed.forceEnvironment,
     };
 }
-export function parseStatusArgs(args) {
-    let planId;
-    for (let i = 0; i < args.length; i += 1) {
-        const token = args[i];
-        if (token !== '--plan-id')
-            continue;
-        const nextValue = args[i + 1];
-        if (!nextValue || nextValue.startsWith('--')) {
-            throw new BackfillConfigError('Missing value for --plan-id');
-        }
-        planId = nextValue;
-        i += 1;
-    }
+export function parseStatusArgs(flags) {
+    const f = typedFlags(flags, PLAN_ID_FLAGS);
+    const planId = f['--plan-id'];
     if (!planId)
         throw new BackfillConfigError('Missing required --plan-id <id>');
     return { planId: normalizePlanId(planId) };
 }
-export function parseCancelArgs(args) {
-    return parseStatusArgs(args);
+export function parseCancelArgs(flags) {
+    return parseStatusArgs(flags);
 }
-export function parseDoctorArgs(args) {
-    return parseStatusArgs(args);
+export function parseDoctorArgs(flags) {
+    return parseStatusArgs(flags);
 }
 //# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}

package/dist/async-backfill.d.ts

@@ -0,0 +1,64 @@
+import type { ClickHouseExecutor } from '@chkit/clickhouse';
+export interface BackfillOptions {
+    /** The executor to submit queries to (target ClickHouse) */
+    executor: ClickHouseExecutor;
+    /** Plan ID used as a namespace in deterministic query IDs */
+    planId: string;
+    /** The chunks to process (from buildChunks) */
+    chunks: Array<{
+        id: string;
+        from?: string;
+        to?: string;
+        [key: string]: unknown;
+    }>;
+    /** Build the SQL for a given chunk. Called once per chunk at submit time. */
+    buildQuery: (chunk: {
+        id: string;
+        from?: string;
+        to?: string;
+    }) => string;
+    /** Max concurrent queries running on the server. Default: 3 */
+    concurrency?: number;
+    /** Polling interval in ms. Default: 5000 */
+    pollIntervalMs?: number;
+    /** Max consecutive poll errors before marking a chunk as failed. Default: 10 */
+    maxPollErrors?: number;
+    /** Called whenever progress changes. Use this to persist state. */
+    onProgress?: (progress: BackfillProgress) => void | Promise<void>;
+    /** Previously saved progress to resume from. */
+    resumeFrom?: BackfillProgress;
+    /** When true, reset chunks confirmed failed (both locally and on server) back to pending. */
+    replayFailed?: boolean;
+}
+export interface BackfillChunkState {
+    status: 'pending' | 'submitted' | 'running' | 'done' | 'failed';
+    queryId?: string;
+    submittedAt?: string;
+    finishedAt?: string;
+    readRows?: number;
+    readBytes?: number;
+    writtenRows?: number;
+    writtenBytes?: number;
+    elapsedMs?: number;
+    durationMs?: number;
+    error?: string;
+}
+export type BackfillProgress = Record<string, BackfillChunkState>;
+export interface BackfillResult {
+    total: number;
+    completed: number;
+    failed: number;
+    progress: BackfillProgress;
+}
+/**
+ * Reconcile local progress with server-side state.
+ *
+ * Queries system.processes and system.query_log for all chunk query IDs
+ * to discover queries that were submitted but whose status was never
+ * persisted locally (e.g. client crash between submit and state write).
+ */
+export declare function syncProgress(executor: ClickHouseExecutor, planId: string, chunks: Array<{
+    id: string;
+}>, progress: BackfillProgress): Promise<BackfillProgress>;
+export declare function executeBackfill(options: BackfillOptions): Promise<BackfillResult>;
+//# sourceMappingURL=async-backfill.d.ts.map

package/dist/async-backfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-backfill.d.ts","sourceRoot":"","sources":["../src/async-backfill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,mBAAmB,CAAA;AAGxE,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAA;IACjF,6EAA6E;IAC7E,UAAU,EAAE,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IACzE,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mEAAmE;IACnE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,gDAAgD;IAChD,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,6FAA6F;IAC7F,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;AAEjE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,gBAAgB,CAAA;CAC3B;AA2ED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,EAC7B,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAoF3B;AA2CD,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAsGvF"}