@chkit/plugin-backfill 0.1.0-beta.0

package/dist/args.d.ts

@@ -0,0 +1,8 @@
+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;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +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"}

package/dist/args.js

@@ -0,0 +1,170 @@
+import { BackfillConfigError } from './errors.js';
+function normalizeTimestamp(raw, flagName) {
+    const value = raw.trim();
+    if (value.length === 0) {
+        throw new BackfillConfigError(`Missing value for ${flagName}`);
+    }
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new BackfillConfigError(`Invalid timestamp for ${flagName}: ${raw}`);
+    }
+    return date.toISOString();
+}
+function normalizeTarget(raw) {
+    const value = raw.trim();
+    if (!/^[A-Za-z0-9_]+\.[A-Za-z0-9_]+$/.test(value)) {
+        throw new BackfillConfigError('Invalid value for --target. Expected <database.table>.');
+    }
+    return value;
+}
+function normalizePlanId(raw) {
+    const value = raw.trim();
+    if (!/^[a-f0-9]{16}$/.test(value)) {
+        throw new BackfillConfigError('Invalid value for --plan-id. Expected a 16-char lowercase hex id.');
+    }
+    return value;
+}
+export function parsePlanArgs(args) {
+    let target;
+    let from;
+    let to;
+    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 (!target)
+        throw new BackfillConfigError('Missing required --target <database.table>');
+    if (!from)
+        throw new BackfillConfigError('Missing required --from <timestamp>');
+    if (!to)
+        throw new BackfillConfigError('Missing required --to <timestamp>');
+    return {
+        target: normalizeTarget(target),
+        from: normalizeTimestamp(from, '--from'),
+        to: normalizeTimestamp(to, '--to'),
+        chunkHours,
+        forceLargeWindow,
+    };
+}
+export function parseRunArgs(args) {
+    let planId;
+    let replayDone = false;
+    let replayFailed = false;
+    let forceOverlap = false;
+    let forceCompatibility = false;
+    let simulateFailChunk;
+    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;
+        }
+    }
+    if (!planId)
+        throw new BackfillConfigError('Missing required --plan-id <id>');
+    return {
+        planId: normalizePlanId(planId),
+        replayDone,
+        replayFailed,
+        forceOverlap,
+        forceCompatibility,
+        simulateFailChunk,
+        simulateFailCount,
+    };
+}
+export function parseResumeArgs(args) {
+    const parsed = parseRunArgs(args);
+    return {
+        planId: parsed.planId,
+        replayDone: parsed.replayDone,
+        replayFailed: parsed.replayFailed,
+        forceOverlap: parsed.forceOverlap,
+        forceCompatibility: parsed.forceCompatibility,
+    };
+}
+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;
+    }
+    if (!planId)
+        throw new BackfillConfigError('Missing required --plan-id <id>');
+    return { planId: normalizePlanId(planId) };
+}
+export function parseCancelArgs(args) {
+    return parseStatusArgs(args);
+}
+export function parseDoctorArgs(args) {
+    return parseStatusArgs(args);
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class BackfillConfigError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,7 @@
+export class BackfillConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BackfillConfigError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { backfill, createBackfillPlugin } from './plugin.js';
+export type { BackfillPlugin, BackfillPluginOptions, BackfillPluginRegistration } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAC5D,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { backfill, createBackfillPlugin } from './plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA"}

package/dist/options.d.ts

@@ -0,0 +1,5 @@
+import type { BackfillPluginOptions, NormalizedBackfillPluginOptions } from './types.js';
+export declare function normalizeBackfillOptions(options?: BackfillPluginOptions): NormalizedBackfillPluginOptions;
+export declare function mergeOptions(baseOptions: NormalizedBackfillPluginOptions, runtimeOptions: Record<string, unknown>): NormalizedBackfillPluginOptions;
+export declare function validateBaseOptions(options: NormalizedBackfillPluginOptions): void;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAA;AAiHxF,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,qBAA0B,GAClC,+BAA+B,CAgBjC;AAED,wBAAgB,YAAY,CAC1B,WAAW,EAAE,+BAA+B,EAC5C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,+BAA+B,CAiBjC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,+BAA+B,GAAG,IAAI,CAMlF"}

package/dist/options.js

@@ -0,0 +1,125 @@
+import { BackfillConfigError } from './errors.js';
+const DEFAULT_OPTIONS = {
+    defaults: {
+        chunkHours: 6,
+        maxParallelChunks: 1,
+        maxRetriesPerChunk: 3,
+        requireIdempotencyToken: true,
+    },
+    policy: {
+        requireDryRunBeforeRun: true,
+        requireExplicitWindow: true,
+        blockOverlappingRuns: true,
+        failCheckOnRequiredPendingBackfill: true,
+    },
+    limits: {
+        maxWindowHours: 24 * 30,
+        minChunkMinutes: 15,
+    },
+};
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function parsePositiveNumber(value, key) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
+        throw new BackfillConfigError(`Invalid plugin option "${key}". Expected a positive number.`);
+    }
+    return value;
+}
+function parseBoolean(value, key) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'boolean') {
+        throw new BackfillConfigError(`Invalid plugin option "${key}". Expected boolean.`);
+    }
+    return value;
+}
+function parseString(value, key) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new BackfillConfigError(`Invalid plugin option "${key}". Expected non-empty string.`);
+    }
+    return value;
+}
+function normalizeRuntimeOptions(options) {
+    const normalized = {};
+    const stateDir = parseString(options.stateDir, 'stateDir');
+    if (stateDir !== undefined)
+        normalized.stateDir = stateDir;
+    if (options.defaults !== undefined) {
+        if (!isRecord(options.defaults)) {
+            throw new BackfillConfigError('Invalid plugin option "defaults". Expected object.');
+        }
+        normalized.defaults = {
+            chunkHours: parsePositiveNumber(options.defaults.chunkHours, 'defaults.chunkHours'),
+            maxParallelChunks: parsePositiveNumber(options.defaults.maxParallelChunks, 'defaults.maxParallelChunks'),
+            maxRetriesPerChunk: parsePositiveNumber(options.defaults.maxRetriesPerChunk, 'defaults.maxRetriesPerChunk'),
+            requireIdempotencyToken: parseBoolean(options.defaults.requireIdempotencyToken, 'defaults.requireIdempotencyToken'),
+        };
+    }
+    if (options.policy !== undefined) {
+        if (!isRecord(options.policy)) {
+            throw new BackfillConfigError('Invalid plugin option "policy". Expected object.');
+        }
+        normalized.policy = {
+            requireDryRunBeforeRun: parseBoolean(options.policy.requireDryRunBeforeRun, 'policy.requireDryRunBeforeRun'),
+            requireExplicitWindow: parseBoolean(options.policy.requireExplicitWindow, 'policy.requireExplicitWindow'),
+            blockOverlappingRuns: parseBoolean(options.policy.blockOverlappingRuns, 'policy.blockOverlappingRuns'),
+            failCheckOnRequiredPendingBackfill: parseBoolean(options.policy.failCheckOnRequiredPendingBackfill, 'policy.failCheckOnRequiredPendingBackfill'),
+        };
+    }
+    if (options.limits !== undefined) {
+        if (!isRecord(options.limits)) {
+            throw new BackfillConfigError('Invalid plugin option "limits". Expected object.');
+        }
+        normalized.limits = {
+            maxWindowHours: parsePositiveNumber(options.limits.maxWindowHours, 'limits.maxWindowHours'),
+            minChunkMinutes: parsePositiveNumber(options.limits.minChunkMinutes, 'limits.minChunkMinutes'),
+        };
+    }
+    return normalized;
+}
+export function normalizeBackfillOptions(options = {}) {
+    return {
+        stateDir: options.stateDir,
+        defaults: {
+            ...DEFAULT_OPTIONS.defaults,
+            ...(options.defaults ?? {}),
+        },
+        policy: {
+            ...DEFAULT_OPTIONS.policy,
+            ...(options.policy ?? {}),
+        },
+        limits: {
+            ...DEFAULT_OPTIONS.limits,
+            ...(options.limits ?? {}),
+        },
+    };
+}
+export function mergeOptions(baseOptions, runtimeOptions) {
+    const fromRuntime = normalizeRuntimeOptions(runtimeOptions);
+    return normalizeBackfillOptions({
+        stateDir: fromRuntime.stateDir ?? baseOptions.stateDir,
+        defaults: {
+            ...baseOptions.defaults,
+            ...(fromRuntime.defaults ?? {}),
+        },
+        policy: {
+            ...baseOptions.policy,
+            ...(fromRuntime.policy ?? {}),
+        },
+        limits: {
+            ...baseOptions.limits,
+            ...(fromRuntime.limits ?? {}),
+        },
+    });
+}
+export function validateBaseOptions(options) {
+    if (options.defaults.chunkHours * 60 < options.limits.minChunkMinutes) {
+        throw new BackfillConfigError(`defaults.chunkHours (${options.defaults.chunkHours}) must be >= limits.minChunkMinutes (${options.limits.minChunkMinutes}m).`);
+    }
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

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

package/dist/payload.d.ts

@@ -0,0 +1,55 @@
+import type { BackfillDoctorReport, BackfillPlanStatus, BackfillStatusSummary, BuildBackfillPlanOutput, ExecuteBackfillRunOutput } from './types.js';
+export declare function planPayload(output: BuildBackfillPlanOutput): {
+    ok: true;
+    command: 'plan';
+    planId: string;
+    target: string;
+    from: string;
+    to: string;
+    chunkCount: number;
+    chunkHours: number;
+    planPath: string;
+    existed: boolean;
+};
+export declare function runPayload(output: ExecuteBackfillRunOutput): {
+    ok: boolean;
+    command: 'run' | 'resume';
+    planId: string;
+    status: BackfillPlanStatus;
+    chunkCounts: BackfillStatusSummary['totals'];
+    attempts: number;
+    runPath: string;
+    eventPath: string;
+    lastError?: string;
+};
+export declare function statusPayload(summary: BackfillStatusSummary): {
+    ok: boolean;
+    command: 'status';
+    planId: string;
+    status: BackfillPlanStatus;
+    chunkCounts: BackfillStatusSummary['totals'];
+    attempts: number;
+    runPath: string;
+    eventPath: string;
+    updatedAt: string;
+    lastError?: string;
+};
+export declare function cancelPayload(summary: BackfillStatusSummary): {
+    ok: boolean;
+    command: 'cancel';
+    planId: string;
+    status: BackfillPlanStatus;
+    chunkCounts: BackfillStatusSummary['totals'];
+    runPath: string;
+    eventPath: string;
+};
+export declare function doctorPayload(report: BackfillDoctorReport): {
+    ok: boolean;
+    command: 'doctor';
+    planId: string;
+    status: BackfillPlanStatus;
+    issueCodes: string[];
+    recommendations: string[];
+    failedChunkIds: string[];
+};
+//# sourceMappingURL=payload.d.ts.map

package/dist/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,YAAY,CAAA;AAEnB,wBAAgB,WAAW,CAAC,MAAM,EAAE,uBAAuB,GAAG;IAC5D,EAAE,EAAE,IAAI,CAAA;IACR,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;CACjB,CAaA;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,wBAAwB,GAAG;IAC5D,EAAE,EAAE,OAAO,CAAA;IACX,OAAO,EAAE,KAAK,GAAG,QAAQ,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,kBAAkB,CAAA;IAC1B,WAAW,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IAC5C,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAYA;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG;IAC7D,EAAE,EAAE,OAAO,CAAA;IACX,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,kBAAkB,CAAA;IAC1B,WAAW,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IAC5C,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAaA;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG;IAC7D,EAAE,EAAE,OAAO,CAAA;IACX,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,kBAAkB,CAAA;IAC1B,WAAW,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,CAUA;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG;IAC3D,EAAE,EAAE,OAAO,CAAA;IACX,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,kBAAkB,CAAA;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB,CAUA"}

package/dist/payload.js

@@ -0,0 +1,64 @@
+export function planPayload(output) {
+    return {
+        ok: true,
+        command: 'plan',
+        planId: output.plan.planId,
+        target: output.plan.target,
+        from: output.plan.from,
+        to: output.plan.to,
+        chunkCount: output.plan.chunks.length,
+        chunkHours: output.plan.options.chunkHours,
+        planPath: output.planPath,
+        existed: output.existed,
+    };
+}
+export function runPayload(output) {
+    return {
+        ok: output.status.status === 'completed',
+        command: 'run',
+        planId: output.run.planId,
+        status: output.status.status,
+        chunkCounts: output.status.totals,
+        attempts: output.status.attempts,
+        runPath: output.runPath,
+        eventPath: output.eventPath,
+        lastError: output.status.lastError,
+    };
+}
+export function statusPayload(summary) {
+    return {
+        ok: summary.status !== 'failed',
+        command: 'status',
+        planId: summary.planId,
+        status: summary.status,
+        chunkCounts: summary.totals,
+        attempts: summary.attempts,
+        runPath: summary.runPath,
+        eventPath: summary.eventPath,
+        updatedAt: summary.updatedAt,
+        lastError: summary.lastError,
+    };
+}
+export function cancelPayload(summary) {
+    return {
+        ok: summary.status === 'cancelled',
+        command: 'cancel',
+        planId: summary.planId,
+        status: summary.status,
+        chunkCounts: summary.totals,
+        runPath: summary.runPath,
+        eventPath: summary.eventPath,
+    };
+}
+export function doctorPayload(report) {
+    return {
+        ok: report.issueCodes.length === 0,
+        command: 'doctor',
+        planId: report.planId,
+        status: report.status,
+        issueCodes: report.issueCodes,
+        recommendations: report.recommendations,
+        failedChunkIds: report.failedChunkIds,
+    };
+}
+//# sourceMappingURL=payload.js.map

package/dist/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,WAAW,CAAC,MAA+B;IAYzD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;QAC1B,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;QAC1B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;QACtB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE;QAClB,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;QACrC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU;QAC1C,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAgC;IAWzD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW;QACxC,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;QAC5B,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;QACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;QAChC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS;KACnC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA8B;IAY1D,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,MAAM,KAAK,QAAQ;QAC/B,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW,EAAE,OAAO,CAAC,MAAM;QAC3B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA8B;IAS1D,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,MAAM,KAAK,WAAW;QAClC,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW,EAAE,OAAO,CAAC,MAAM;QAC3B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAA4B;IASxD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAClC,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAA;AACH,CAAC"}

package/dist/planner.d.ts

@@ -0,0 +1,13 @@
+import type { ResolvedChxConfig } from '@chkit/core';
+import type { BuildBackfillPlanOutput, NormalizedBackfillPluginOptions } from './types.js';
+export declare function buildBackfillPlan(input: {
+    target: string;
+    from: string;
+    to: string;
+    configPath: string;
+    config: Pick<ResolvedChxConfig, 'metaDir'>;
+    options: NormalizedBackfillPluginOptions;
+    chunkHours?: number;
+    forceLargeWindow?: boolean;
+}): Promise<BuildBackfillPlanOutput>;
+//# sourceMappingURL=planner.d.ts.map

package/dist/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAYpD,OAAO,KAAK,EAGV,uBAAuB,EACvB,+BAA+B,EAChC,MAAM,YAAY,CAAA;AAsFnB,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAA;IAC1C,OAAO,EAAE,+BAA+B,CAAA;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAiEnC"}

package/dist/planner.js

@@ -0,0 +1,113 @@
+import { BackfillConfigError } from './errors.js';
+import { backfillPaths, computeBackfillStateDir, hashId, planIdentity, readExistingPlan, stableSerialize, writeJson, } from './state.js';
+function ensureHoursWithinLimits(input) {
+    const fromMillis = new Date(input.from).getTime();
+    const toMillis = new Date(input.to).getTime();
+    if (toMillis <= fromMillis) {
+        throw new BackfillConfigError('Invalid backfill window. Expected --to to be after --from.');
+    }
+    const durationHours = (toMillis - fromMillis) / (1000 * 60 * 60);
+    if (durationHours > input.limits.maxWindowHours && !input.forceLargeWindow) {
+        throw new BackfillConfigError(`Requested window (${durationHours.toFixed(2)} hours) exceeds limits.maxWindowHours=${input.limits.maxWindowHours}. Retry with --force-large-window to acknowledge risk.`);
+    }
+}
+function buildChunkSqlTemplate(chunk) {
+    return [
+        `/* chx backfill plan=${chunk.planId} chunk=${chunk.chunkId} token=${chunk.token} */`,
+        `INSERT INTO ${chunk.target}`,
+        `SELECT *`,
+        `FROM ${chunk.target}`,
+        `WHERE event_time >= toDateTime('${chunk.from}')`,
+        `  AND event_time < toDateTime('${chunk.to}');`,
+    ].join('\n');
+}
+function buildChunks(input) {
+    const fromMillis = new Date(input.from).getTime();
+    const toMillis = new Date(input.to).getTime();
+    const chunkMillis = input.chunkHours * 60 * 60 * 1000;
+    const chunks = [];
+    let current = fromMillis;
+    while (current < toMillis) {
+        const next = Math.min(current + chunkMillis, toMillis);
+        const chunkFrom = new Date(current).toISOString();
+        const chunkTo = new Date(next).toISOString();
+        const idSeed = `${input.planId}:${chunkFrom}:${chunkTo}`;
+        const chunkId = hashId(`chunk:${idSeed}`).slice(0, 16);
+        const token = input.requireIdempotencyToken ? hashId(`token:${idSeed}`) : '';
+        chunks.push({
+            id: chunkId,
+            from: chunkFrom,
+            to: chunkTo,
+            status: 'pending',
+            attempts: 0,
+            idempotencyToken: token,
+            sqlTemplate: buildChunkSqlTemplate({
+                planId: input.planId,
+                chunkId,
+                token,
+                target: input.target,
+                from: chunkFrom,
+                to: chunkTo,
+            }),
+        });
+        current = next;
+    }
+    return chunks;
+}
+export async function buildBackfillPlan(input) {
+    const chunkHours = input.chunkHours ?? input.options.defaults.chunkHours;
+    if (chunkHours * 60 < input.options.limits.minChunkMinutes) {
+        throw new BackfillConfigError(`Chunk size ${chunkHours}h is below limits.minChunkMinutes=${input.options.limits.minChunkMinutes}.`);
+    }
+    ensureHoursWithinLimits({
+        from: input.from,
+        to: input.to,
+        limits: input.options.limits,
+        forceLargeWindow: input.forceLargeWindow ?? false,
+    });
+    const planId = hashId(planIdentity(input.target, input.from, input.to, chunkHours)).slice(0, 16);
+    const stateDir = computeBackfillStateDir(input.config, input.configPath, input.options);
+    const paths = backfillPaths(stateDir, planId);
+    const plan = {
+        planId,
+        target: input.target,
+        createdAt: '1970-01-01T00:00:00.000Z',
+        status: 'planned',
+        from: input.from,
+        to: input.to,
+        chunks: buildChunks({
+            planId,
+            target: input.target,
+            from: input.from,
+            to: input.to,
+            chunkHours,
+            requireIdempotencyToken: input.options.defaults.requireIdempotencyToken,
+        }),
+        options: {
+            chunkHours,
+            maxParallelChunks: input.options.defaults.maxParallelChunks,
+            maxRetriesPerChunk: input.options.defaults.maxRetriesPerChunk,
+            requireIdempotencyToken: input.options.defaults.requireIdempotencyToken,
+        },
+        policy: input.options.policy,
+        limits: input.options.limits,
+    };
+    const existing = await readExistingPlan(paths.planPath);
+    if (existing) {
+        if (stableSerialize(existing) !== stableSerialize(plan)) {
+            throw new BackfillConfigError(`Backfill plan already exists at ${paths.planPath} but differs from current planning output. Remove it if you intentionally changed planning parameters.`);
+        }
+        return {
+            plan: existing,
+            planPath: paths.planPath,
+            existed: true,
+        };
+    }
+    await writeJson(paths.planPath, plan);
+    return {
+        plan,
+        planPath: paths.planPath,
+        existed: false,
+    };
+}
+//# sourceMappingURL=planner.js.map

package/dist/planner.js.map

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