@atomic-chat/core 0.5.1

package/dist/downloads/downloader.js

@@ -0,0 +1,479 @@
+/**
+ * Resumable multi-file downloader. Port of `_download_files_internal` / `download_single_file` in
+ * `src-tauri/src/core/downloads/helpers.rs` and the task registry in `commands.rs`.
+ *
+ * Behaviour that is a contract with the app (PLAN.md §8.2 "Downloads"):
+ * - `save_path` is relative to `<data>` and must stay inside it (symlinked prefixes compared resolved)
+ * - `.tmp` + `.url` sidecars; resume only when `resume` is set, the `.tmp` exists and `.url` matches
+ * - `Range: bytes=N-` → 206 + validated `Content-Range`; 200/416 → restart from 0; 408/429/5xx retry
+ * - 5 retries per stall, counter reset after every 1 MiB of fresh progress
+ * - combined progress `{transferred,total}` after resume, every 10 MiB per file, per file end, task end
+ * - verification (size, sha256) after all files; on failure the file and its directory (non-recursive)
+ *   are removed and the task fails; cancel keeps every partial and finished file
+ * - preflight: Windows path limit, free space with 512 MiB headroom (skipped when unknown)
+ * - every fs error is rendered `Error: [disk_*] …`
+ *
+ * I/O is injected (`fetch`, fs, free-space probe, sleep) so the whole flow is testable against a
+ * scripted HTTP server without touching the network or the real data folder.
+ */
+import { createWriteStream } from 'node:fs';
+import { mkdir, readFile, realpath, rename, rm, rmdir, stat, statfs, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
+import { checkFreeSpace, checkPathWithinLimit, diskErrToString, remainingBytes } from './disk.js';
+import { classifyDownloadStatus, classifyResumeStatus, DownloadRequestError, downloadStage, expectedDownloadSize, HEAD_TIMEOUT_MS, MAX_STREAM_RETRIES, PROGRESS_EMIT_INTERVAL_BYTES, RETRY_RESET_PROGRESS_BYTES, retryDelayMs, shouldBypassProxy, sidecarPath, validateContentRange, validateProxyConfig, } from './protocol.js';
+import { policyFetchFor } from './proxy-fetch.js';
+import { verifyDownloadedFile } from './verify.js';
+export const DOWNLOAD_CANCELLED = 'Download cancelled';
+export async function defaultAvailableSpace(path) {
+    let probe = path;
+    for (;;) {
+        try {
+            const s = await statfs(probe);
+            return Number(s.bavail) * Number(s.bsize);
+        }
+        catch {
+            const parent = dirname(probe);
+            if (parent === probe)
+                return undefined;
+            probe = parent;
+        }
+    }
+}
+export function defaultSleep(ms, signal) {
+    return new Promise((res, rej) => {
+        if (signal.aborted)
+            return rej(new Error(DOWNLOAD_CANCELLED));
+        const t = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            res();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(t);
+            rej(new Error(DOWNLOAD_CANCELLED));
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/** Resolve the longest existing prefix through symlinks, then re-append the rest (Rust `canonicalize_existing_prefix`). */
+export async function canonicalizeExistingPrefix(path) {
+    const abs = resolve(path);
+    let head = abs;
+    const tail = [];
+    for (;;) {
+        try {
+            const real = await realpath(head);
+            return tail.length ? join(real, ...tail.reverse()) : real;
+        }
+        catch {
+            const parent = dirname(head);
+            if (parent === head)
+                return abs;
+            tail.push(head.slice(parent.length).replace(/^[\\/]/, ''));
+            head = parent;
+        }
+    }
+}
+const isInside = (child, parent) => {
+    const rel = relative(parent, child);
+    return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel));
+};
+export class Downloader {
+    tasks = new Map();
+    deps;
+    constructor(deps) {
+        this.deps = {
+            fetchFor: policyFetchFor,
+            availableSpace: defaultAvailableSpace,
+            sleep: defaultSleep,
+            retryBaseMs: 1000,
+            log: () => { },
+            ...deps,
+        };
+    }
+    /** Task ids currently running. */
+    active() {
+        return [...this.tasks.keys()];
+    }
+    /** Cancel a running task. Keeps partials and finished files. */
+    cancel(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return false;
+        this.tasks.delete(taskId);
+        task.controller.abort();
+        return true;
+    }
+    /**
+     * Download every item of `taskId`. A second call with the same id supersedes the first (which
+     * observes a cancellation but leaves the files to the newcomer).
+     */
+    async download(taskId, items, options = {}) {
+        const existing = this.tasks.get(taskId);
+        if (existing) {
+            existing.superseded = true;
+            existing.controller.abort();
+        }
+        const task = { controller: new AbortController(), superseded: false };
+        this.tasks.set(taskId, task);
+        try {
+            await this.run(taskId, items, options, task.controller.signal);
+        }
+        finally {
+            if (this.tasks.get(taskId) === task)
+                this.tasks.delete(taskId);
+        }
+    }
+    async run(taskId, items, options, signal) {
+        const { dataFolder, platform, log } = this.deps;
+        const resume = options.resume ?? false;
+        const headers = options.headers ?? {};
+        // Built before the preflight on purpose: that loop is where a download against an unreachable
+        // host spends its first silent minute.
+        const reportStage = (kind, attempt) => this.deps.emit('download:stage', { taskId, stage: downloadStage(kind, attempt) });
+        for (const item of items) {
+            if (item.proxy) {
+                const problem = validateProxyConfig(item.proxy);
+                if (problem)
+                    throw new Error(`Error: ${problem}`);
+            }
+        }
+        // Preflight sizes (catalog size or HEAD; HEAD failures degrade to unknown).
+        const sizes = new Map();
+        for (const item of items)
+            sizes.set(item.url, await this.preflightSize(item, headers, signal, reportStage));
+        const totalSize = [...sizes.values()].reduce((a, b) => a + b, 0);
+        // Preflight paths: containment, Windows limit, free space.
+        const resolvedRoot = await canonicalizeExistingPrefix(dataFolder);
+        const partialSizes = [];
+        const savePaths = [];
+        for (const item of items) {
+            const savePath = resolve(dataFolder, item.save_path);
+            const limit = checkPathWithinLimit(savePath, platform);
+            if (limit)
+                throw new Error(limit);
+            if (!isInside(await canonicalizeExistingPrefix(savePath), resolvedRoot)) {
+                throw new Error(`Path ${savePath} is outside of Jan data folder ${dataFolder}`);
+            }
+            savePaths.push(savePath);
+            if (resume) {
+                try {
+                    partialSizes.push((await stat(sidecarPath(savePath, 'tmp'))).size);
+                }
+                catch {
+                    // no partial yet
+                }
+            }
+        }
+        const space = checkFreeSpace(await this.deps.availableSpace(dataFolder), remainingBytes(totalSize, partialSizes));
+        if (space)
+            throw new Error(space);
+        const progress = new Map();
+        const emitProgress = () => {
+            const transferred = [...progress.values()].reduce((a, b) => a + b, 0);
+            const percent = totalSize > 0 ? Math.min(100, (transferred / totalSize) * 100) : 0;
+            this.deps.emit('download:progress', { taskId, transferred, total: totalSize, percent });
+        };
+        const results = await Promise.all(items.map((item, i) => this.downloadOne(item, savePaths[i], `${taskId}-${i}`, sizes.get(item.url) ?? 0, {
+            headers,
+            resume,
+            signal,
+            progress,
+            emitProgress,
+            reportStage,
+        })));
+        if (items.some((it) => it.sha256 != null || it.size != null)) {
+            const modelId = items.find((it) => it.model_id != null)?.model_id ??
+                (items[0] ? (dirname(items[0].save_path).split(/[\\/]/).pop() ?? 'unknown') : 'unknown');
+            this.deps.emit('model:validation-started', { modelId });
+            log('info', `Starting validation for model: ${modelId}`);
+        }
+        const verifications = await Promise.allSettled(items.map((item, i) => verifyDownloadedFile(item, results[i], this.deps.verify, signal)));
+        for (let i = 0; i < verifications.length; i++) {
+            const v = verifications[i];
+            if (v && v.status === 'rejected') {
+                const savePath = results[i];
+                log('warn', `Validation failed (${v.reason.message}); removing ${savePath}`);
+                await rm(savePath, { force: true }).catch(() => { });
+                await rmdir(dirname(savePath)).catch(() => { });
+                throw v.reason;
+            }
+        }
+        emitProgress();
+    }
+    async preflightSize(item, headers, signal, reportStage) {
+        if (signal.aborted)
+            throw new Error(DOWNLOAD_CANCELLED);
+        if (item.size != null && item.size > 0)
+            return item.size;
+        const fetchImpl = this.deps.fetchFor(item, this.deps.fetch);
+        let retry = 0;
+        // Only when a HEAD is actually made: a size from the catalog means no connection yet.
+        reportStage('connecting', 0);
+        for (;;) {
+            try {
+                const res = await fetchImpl(item.url, {
+                    method: 'HEAD',
+                    headers,
+                    signal: AbortSignal.any([signal, AbortSignal.timeout(HEAD_TIMEOUT_MS)]),
+                });
+                if (!res.ok) {
+                    const err = classifyDownloadStatus(res.status, '');
+                    err.message = `Failed to get file size: HTTP status ${res.status}`;
+                    throw err;
+                }
+                return Number(res.headers.get('content-length') ?? '0') || 0;
+            }
+            catch (e) {
+                if (signal.aborted)
+                    throw new Error(DOWNLOAD_CANCELLED);
+                const retryable = !(e instanceof DownloadRequestError) || e.kind === 'retryable';
+                if (retryable && retry < MAX_STREAM_RETRIES) {
+                    reportStage('retrying', retry + 1);
+                    await this.deps.sleep(retryDelayMs(retry, this.deps.retryBaseMs), signal);
+                    retry++;
+                    continue;
+                }
+                this.deps.log('warn', `Preflight HEAD for '${item.url}' failed: ${e.message}. Continuing with unknown size`);
+                return 0;
+            }
+        }
+    }
+    async request(fetchImpl, item, headers, startBytes, expectedSize, signal) {
+        let res;
+        try {
+            res = await fetchImpl(item.url, {
+                headers: startBytes > 0 ? { ...headers, Range: `bytes=${startBytes}-` } : headers,
+                signal,
+            });
+        }
+        catch (e) {
+            if (signal.aborted)
+                throw new Error(DOWNLOAD_CANCELLED);
+            throw new DownloadRequestError('retryable', e.message);
+        }
+        if (startBytes > 0) {
+            if (res.status === 206) {
+                validateContentRange(res.headers.get('content-range'), startBytes, expectedSize);
+                return res;
+            }
+            const body = res.status === 200 || res.status === 416 || (res.status >= 500 && res.status < 600)
+                ? ''
+                : await res.text().catch(() => '');
+            throw classifyResumeStatus(res.status, body);
+        }
+        if (!res.ok)
+            throw classifyDownloadStatus(res.status, await res.text().catch(() => ''));
+        return res;
+    }
+    async requestWithRetry(fetchImpl, item, headers, startBytes, expectedSize, signal, reportStage) {
+        let retry = 0;
+        for (;;) {
+            try {
+                return await this.request(fetchImpl, item, headers, startBytes, expectedSize, signal);
+            }
+            catch (e) {
+                if (e instanceof DownloadRequestError && e.kind === 'retryable' && retry < MAX_STREAM_RETRIES) {
+                    if (signal.aborted)
+                        throw new Error(DOWNLOAD_CANCELLED);
+                    this.deps.log('warn', `Download request for '${item.url}' failed: ${e.message}. Retry ${retry + 1}/${MAX_STREAM_RETRIES}`);
+                    reportStage('retrying', retry + 1);
+                    await this.deps.sleep(retryDelayMs(retry, this.deps.retryBaseMs), signal);
+                    retry++;
+                    continue;
+                }
+                throw e;
+            }
+        }
+    }
+    async downloadOne(item, savePath, fileId, fileSize, ctx) {
+        const { signal, headers, progress, emitProgress, reportStage } = ctx;
+        const disk = (e) => new Error(diskErrToString(e));
+        const fetchImpl = this.deps.fetchFor(item, this.deps.fetch);
+        if (item.proxy && shouldBypassProxy(item.url, item.proxy.no_proxy ?? []))
+            this.deps.log('info', `Bypassing proxy for URL ${item.url}`);
+        await mkdir(dirname(savePath), { recursive: true }).catch((e) => {
+            throw disk(e);
+        });
+        const tmpPath = sidecarPath(savePath, 'tmp');
+        const urlPath = sidecarPath(savePath, 'url');
+        let shouldResume = ctx.resume &&
+            (await stat(tmpPath).then(() => true, () => false)) &&
+            (await readFile(urlPath, 'utf8').then((u) => u === item.url, () => false));
+        await writeFile(urlPath, item.url).catch((e) => {
+            throw disk(e);
+        });
+        const expectedSize = expectedDownloadSize(item.size, fileSize);
+        let res;
+        let totalTransferred = 0;
+        if (shouldResume) {
+            const downloaded = (await stat(tmpPath).catch((e) => {
+                throw disk(e);
+            })).size;
+            if (expectedSize > 0 && downloaded === expectedSize) {
+                progress.set(fileId, downloaded);
+                await rename(tmpPath, savePath).catch((e) => {
+                    throw disk(e);
+                });
+                await rm(urlPath, { force: true }).catch(() => { });
+                this.deps.log('info', `Completed download was already present for '${item.url}'`);
+                return savePath;
+            }
+            if (expectedSize > 0 && downloaded > expectedSize) {
+                this.deps.log('warn', `Partial file for '${item.url}' is larger than expected (${downloaded} > ${expectedSize}); restarting`);
+                shouldResume = false;
+                res = await this.requestWithRetry(fetchImpl, item, headers, 0, expectedSize, signal, reportStage).catch(rethrowAsString);
+            }
+            else {
+                try {
+                    res = await this.requestWithRetry(fetchImpl, item, headers, downloaded, expectedSize, signal, reportStage);
+                    totalTransferred = downloaded;
+                    progress.set(fileId, downloaded);
+                    emitProgress();
+                }
+                catch (e) {
+                    if (e instanceof DownloadRequestError && e.kind === 'restart') {
+                        this.deps.log('warn', `Resume is unavailable for '${item.url}': ${e.message}`);
+                        shouldResume = false;
+                        res = await this.requestWithRetry(fetchImpl, item, headers, 0, expectedSize, signal, reportStage).catch(rethrowAsString);
+                    }
+                    else
+                        throw rethrowAsString(e);
+                }
+            }
+        }
+        else {
+            res = await this.requestWithRetry(fetchImpl, item, headers, 0, expectedSize, signal, reportStage).catch(rethrowAsString);
+        }
+        let writer = createWriteStream(tmpPath, { flags: shouldResume ? 'a' : 'w' });
+        const write = (chunk) => new Promise((ok, fail) => {
+            writer.write(chunk, (e) => (e ? fail(disk(e)) : ok()));
+        });
+        const close = () => new Promise((ok, fail) => writer.end((e) => (e ? fail(disk(e)) : ok())));
+        let body = res.body ?? new ReadableStream({ start: (c) => c.close() });
+        let reader = body.getReader();
+        let delta = 0;
+        let retryCount = 0;
+        let sinceReset = 0;
+        for (;;) {
+            let streamError;
+            try {
+                const { done, value } = await reader.read();
+                if (done) {
+                    if (expectedSize > 0 && totalTransferred < expectedSize) {
+                        streamError = `stream ended after ${totalTransferred} of ${expectedSize} bytes`;
+                    }
+                    else
+                        break;
+                }
+                else if (value) {
+                    if (signal.aborted) {
+                        await close().catch(() => { });
+                        this.deps.log('info', `Download cancelled: ${item.url}`);
+                        throw new Error(DOWNLOAD_CANCELLED);
+                    }
+                    await write(value);
+                    delta += value.byteLength;
+                    totalTransferred += value.byteLength;
+                    sinceReset += value.byteLength;
+                    if (sinceReset >= RETRY_RESET_PROGRESS_BYTES) {
+                        retryCount = 0;
+                        sinceReset = 0;
+                    }
+                    if (delta >= PROGRESS_EMIT_INTERVAL_BYTES) {
+                        progress.set(fileId, totalTransferred);
+                        emitProgress();
+                        delta = 0;
+                    }
+                }
+            }
+            catch (e) {
+                if (e.message === DOWNLOAD_CANCELLED || e.message.startsWith('Error: ['))
+                    throw e;
+                if (signal.aborted)
+                    throw new Error(DOWNLOAD_CANCELLED);
+                streamError = e.message;
+            }
+            if (streamError === undefined)
+                continue;
+            await close().catch((e) => {
+                throw new Error(`${e.message} (failed to flush partial download before retrying '${item.url}')`);
+            });
+            const durable = (await stat(tmpPath).catch((e) => {
+                throw disk(e);
+            })).size;
+            if (durable !== totalTransferred) {
+                throw new Error(`Partial download size mismatch for '${item.url}': tracked ${totalTransferred} bytes but persisted ${durable} bytes`);
+            }
+            for (;;) {
+                if (retryCount >= MAX_STREAM_RETRIES) {
+                    throw new Error(`Download failed after ${MAX_STREAM_RETRIES} retries at byte ${durable}: ${streamError}`);
+                }
+                if (signal.aborted)
+                    throw new Error(DOWNLOAD_CANCELLED);
+                this.deps.log('warn', `Stream error at byte ${durable} for '${item.url}': ${streamError}. Retry ${retryCount + 1}/${MAX_STREAM_RETRIES}`);
+                await this.deps.sleep(retryDelayMs(retryCount, this.deps.retryBaseMs), signal);
+                retryCount++;
+                try {
+                    res = await this.request(fetchImpl, item, headers, durable, expectedSize, signal);
+                    writer = createWriteStream(tmpPath, { flags: 'a' });
+                    break;
+                }
+                catch (e) {
+                    if (e instanceof DownloadRequestError && e.kind === 'restart') {
+                        try {
+                            res = await this.request(fetchImpl, item, headers, 0, expectedSize, signal);
+                            writer = createWriteStream(tmpPath, { flags: 'w' });
+                            progress.set(fileId, 0);
+                            totalTransferred = 0;
+                            delta = 0;
+                            sinceReset = 0;
+                            this.deps.log('warn', `Server cannot resume '${item.url}' (${e.message}); restarted from byte 0`);
+                            break;
+                        }
+                        catch (e2) {
+                            if (e2 instanceof DownloadRequestError && e2.kind === 'retryable') {
+                                this.deps.log('warn', `Full-download reconnect for '${item.url}' failed: ${e2.message}`);
+                                continue;
+                            }
+                            throw rethrowAsString(e2);
+                        }
+                    }
+                    if (e instanceof DownloadRequestError && e.kind === 'retryable') {
+                        this.deps.log('warn', `Range reconnect at byte ${durable} for '${item.url}' failed: ${e.message}`);
+                        continue;
+                    }
+                    throw rethrowAsString(e);
+                }
+            }
+            body = res.body ?? new ReadableStream({ start: (c) => c.close() });
+            reader = body.getReader();
+        }
+        await close();
+        const persisted = (await stat(tmpPath).catch((e) => {
+            throw disk(e);
+        })).size;
+        if (persisted !== totalTransferred) {
+            throw new Error(`Downloaded file size mismatch for '${item.url}': tracked ${totalTransferred} bytes but persisted ${persisted} bytes`);
+        }
+        if (expectedSize > 0 && persisted !== expectedSize) {
+            throw new Error(`Incomplete download for '${item.url}': expected ${expectedSize} bytes but received ${persisted} bytes; partial file was kept for resume`);
+        }
+        progress.set(fileId, totalTransferred);
+        emitProgress();
+        await rename(tmpPath, savePath).catch((e) => {
+            throw disk(e);
+        });
+        await rm(urlPath, { force: true }).catch((e) => {
+            throw disk(e);
+        });
+        this.deps.log('info', `Finished downloading: ${item.url}`);
+        return savePath;
+    }
+}
+/** Request errors reach the caller as plain `Error`s with the Rust message text. */
+function rethrowAsString(e) {
+    if (e instanceof DownloadRequestError)
+        throw new Error(e.message);
+    throw e;
+}
+//# sourceMappingURL=downloader.js.map

package/dist/downloads/downloader.js.map

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

package/dist/downloads/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resumable downloads (.tmp/.url, Range/206), sha256 verification, disk-error tags, tar.gz/zip
+ * extraction, normalizeBackendLayout.
+ *
+ * Ported from: src-tauri/src/core/downloads/{helpers,disk,models,commands}.rs,
+ * core/filesystem/commands.rs:335-515. See PLAN.md §3.2.
+ */
+export * from './disk.js';
+export * from './protocol.js';
+export * from './verify.js';
+export * from './downloader.js';
+export * from './disk-space.js';
+export * from './archive.js';
+export * from './proxy-fetch.js';

package/dist/downloads/index.js

@@ -0,0 +1,15 @@
+/**
+ * Resumable downloads (.tmp/.url, Range/206), sha256 verification, disk-error tags, tar.gz/zip
+ * extraction, normalizeBackendLayout.
+ *
+ * Ported from: src-tauri/src/core/downloads/{helpers,disk,models,commands}.rs,
+ * core/filesystem/commands.rs:335-515. See PLAN.md §3.2.
+ */
+export * from './disk.js';
+export * from './protocol.js';
+export * from './verify.js';
+export * from './downloader.js';
+export * from './disk-space.js';
+export * from './archive.js';
+export * from './proxy-fetch.js';
+//# sourceMappingURL=index.js.map

package/dist/downloads/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/downloads/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA"}

package/dist/downloads/protocol.d.ts

@@ -0,0 +1,52 @@
+/**
+ * HTTP-level rules of the resumable downloader: sidecar names, retry policy, status classification,
+ * `Content-Range` validation and proxy rules. Port of the pure parts of
+ * `src-tauri/src/core/downloads/helpers.rs`.
+ */
+import type { DownloadStage } from '../contracts/index.js';
+export declare const MAX_STREAM_RETRIES = 5;
+export declare const RETRY_BASE_DELAY_MS = 1000;
+/** Fresh progress that resets the retry counter — the limit is per stall, not per file. */
+export declare const RETRY_RESET_PROGRESS_BYTES: number;
+/** Combined progress is reported every 10 MiB per file. */
+export declare const PROGRESS_EMIT_INTERVAL_BYTES: number;
+export declare const HEAD_TIMEOUT_MS = 30000;
+export declare const CONNECT_TIMEOUT_MS = 30000;
+/** `model.gguf` → `model.gguf.tmp`: the extension is appended, so `a.bin` and `a.gguf` differ. */
+export declare function sidecarPath(savePath: string, ext: string): string;
+/** Exponential backoff, capped at 2^6 × base. */
+export declare function retryDelayMs(retryCount: number, baseMs?: number): number;
+/**
+ * The stage a retry ladder reports. `attempt` counts requests already made — 0 for the first,
+ * then 1…`MAX_STREAM_RETRIES` before each backoff wait — as the app's `StageReporter` does.
+ */
+export declare function downloadStage(kind: DownloadStage['kind'], attempt: number): DownloadStage;
+export type DownloadRequestErrorKind = 'retryable' | 'restart' | 'fatal';
+export declare class DownloadRequestError extends Error {
+    readonly kind: DownloadRequestErrorKind;
+    constructor(kind: DownloadRequestErrorKind, message: string);
+}
+/** 408, 429 and 5xx are worth retrying; everything else that is not success is fatal. */
+export declare function isRetryableStatus(status: number): boolean;
+/**
+ * Validate the `Content-Range` of a 206 resume response against the offset we asked for and the
+ * size we expect. Any mismatch means "restart from byte 0", never a silent append.
+ */
+export declare function validateContentRange(header: string | null | undefined, requestedStart: number, expectedSize: number): void;
+/** Classify a non-206 answer to a ranged request. */
+export declare function classifyResumeStatus(status: number, body: string): DownloadRequestError;
+/** Classify a non-2xx answer to a plain request. */
+export declare function classifyDownloadStatus(status: number, body: string): DownloadRequestError;
+export interface ProxyConfig {
+    url: string;
+    username?: string | null;
+    password?: string | null;
+    no_proxy?: string[] | null;
+    ignore_ssl?: boolean | null;
+}
+/** Same rules as `validate_proxy_config`; returns the error text or `undefined`. */
+export declare function validateProxyConfig(config: ProxyConfig): string | undefined;
+/** `*` matches everything, `*.domain` matches by suffix, otherwise exact host match. */
+export declare function shouldBypassProxy(url: string, noProxy: string[]): boolean;
+/** Size to expect: the catalog size when known, else what the HEAD reported (0 = unknown). */
+export declare function expectedDownloadSize(catalogSize: number | undefined | null, responseSize: number): number;