trove-cli 0.0.0-stage → 0.2.0

package/dist/remote/s3-store.js

@@ -0,0 +1,438 @@
+import { open, readFile, stat, writeFile } from 'node:fs/promises';
+import { request as httpRequest, Agent as HttpAgent } from 'node:http';
+import { request as httpsRequest, Agent as HttpsAgent } from 'node:https';
+import { mapLimit } from '../core/concurrency.js';
+import { canonicalQuery, canonicalUri, signRequest } from './s3-sigv4.js';
+const REQUEST_TIMEOUT_MS = 120_000;
+const MAX_ATTEMPTS = 3;
+/**
+ * 并发上传块数。OSS 官方性能最佳实践建议高吞吐时用多连接并发
+ * (大批量小文件场景建议 -j 100~500),这里取一个保守起点。
+ */
+const DEFAULT_CONCURRENCY = 8;
+/** 超过这个大小走 Multipart Upload;以下单 PUT 更省请求。 */
+const MULTIPART_THRESHOLD = 16 * 1024 * 1024;
+/** Multipart 分片大小:满足 S3 对非末尾分片的 5 MiB 下限。 */
+const PART_SIZE = 8 * 1024 * 1024;
+/** 下载分段大小:避免整个对象进内存。 */
+const READ_PART_SIZE = 8 * 1024 * 1024;
+function strip(p) {
+    return p.replace(/^\/+|\/+$/g, '');
+}
+/** S3 key 不能以 / 开头,也不能含空段。 */
+function toKey(path) {
+    return strip(path);
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function statusOf(err) {
+    const e = err;
+    return e?.status ?? e?.statusCode ?? e?.response?.status;
+}
+/** 5xx 与 429 视为可重试;4xx 是配置或权限问题,立即失败。 */
+function retryable(err) {
+    const status = statusOf(err);
+    if (status !== undefined)
+        return status >= 500 || status === 429;
+    const code = err?.code;
+    return ['ECONNRESET', 'ECONNREFUSED', 'ETIMEDOUT', 'EPIPE', 'EAI_AGAIN'].includes(code ?? '');
+}
+export class S3Error extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'S3Error';
+    }
+}
+/** 从 S3 的 XML 错误体里取出 <Code> 与 <Message>。 */
+function parseErrorBody(body) {
+    const code = /<Code>([^<]*)<\/Code>/.exec(body)?.[1];
+    const message = /<Message>([^<]*)<\/Message>/.exec(body)?.[1];
+    return { code, message };
+}
+/**
+ * S3 存储实现:对象存储天然是扁平的 key,目录语义靠 ListObjectsV2 的 delimiter 模拟。
+ *
+ * 与 WebDAV 实现的差异:
+ * - 目录不用创建(PutObject 自动建"目录")
+ * - 索引写入直接覆盖同 key,天然原子(S3 的 PutObject 对同 key 是原子的)
+ * - 允许并发:WebDAV 实测并发 PUT 会 ECONNRESET,对象存储不会
+ */
+export class S3Store {
+    endpoint;
+    region;
+    bucket;
+    accessKeyId;
+    secretAccessKey;
+    forcePathStyle;
+    timeoutMs;
+    maxSockets;
+    concurrency;
+    /** keep-alive 连接池:对象存储允许并发,默认 8 条。 */
+    agents;
+    constructor(opts) {
+        this.endpoint = opts.endpoint.replace(/\/+$/, '');
+        this.region = opts.region;
+        this.bucket = opts.bucket;
+        this.accessKeyId = opts.accessKeyId;
+        this.secretAccessKey = opts.secretAccessKey;
+        this.forcePathStyle = opts.forcePathStyle ?? false;
+        this.timeoutMs = opts.timeoutMs ?? REQUEST_TIMEOUT_MS;
+        this.maxSockets = opts.maxSockets ?? DEFAULT_CONCURRENCY;
+        this.concurrency = opts.concurrency ?? DEFAULT_CONCURRENCY;
+        this.agents = {
+            http: new HttpAgent({ keepAlive: true, maxSockets: this.maxSockets }),
+            https: new HttpsAgent({ keepAlive: true, maxSockets: this.maxSockets }),
+        };
+    }
+    /** virtual-hosted:bucket 放主机名;path-style:bucket 放路径。 */
+    hostAndPath(key) {
+        const u = new URL(this.endpoint);
+        if (this.forcePathStyle) {
+            return { host: u.host, path: `/${this.bucket}/${key}` };
+        }
+        return { host: `${this.bucket}.${u.host}`, path: `/${key}` };
+    }
+    async raw(method, key, opts = {}) {
+        const { host, path } = this.hostAndPath(key);
+        const url = new URL(this.endpoint);
+        url.host = host;
+        url.pathname = path;
+        for (const [k, v] of Object.entries(opts.query ?? {}))
+            url.searchParams.set(k, v);
+        const body = opts.body ?? Buffer.alloc(0);
+        const signed = signRequest({
+            method,
+            url: url.toString(),
+            pathname: path,
+            headers: { host, ...opts.headers },
+            body,
+            region: this.region,
+            service: 's3',
+            accessKeyId: this.accessKeyId,
+            secretAccessKey: this.secretAccessKey,
+            date: new Date(),
+        });
+        const isHttps = url.protocol === 'https:';
+        const reqFn = isHttps ? httpsRequest : httpRequest;
+        // 发送路径必须与签名用的 canonical URI 完全一致。
+        // WHATWG URL 会保留 ( ) ! * + 等字符,而 SigV4 要求按 RFC3986 编码,
+        // 混用会导致 SignatureDoesNotMatch(对象路径含这些字符时必现)。
+        const query = canonicalQuery(opts.query ?? {});
+        const sendPath = `${canonicalUri(path)}${query ? `?${query}` : ''}`;
+        return new Promise((resolve, reject) => {
+            const req = reqFn({
+                protocol: url.protocol,
+                hostname: url.hostname,
+                port: url.port || (isHttps ? 443 : 80),
+                method,
+                path: sendPath,
+                headers: { ...signed.headers, 'content-length': String(body.length) },
+                agent: isHttps ? this.agents.https : this.agents.http,
+            }, (res) => {
+                const chunks = [];
+                res.on('data', (c) => chunks.push(c));
+                res.on('end', () => {
+                    resolve({
+                        status: res.statusCode ?? 0,
+                        headers: res.headers,
+                        body: Buffer.concat(chunks),
+                    });
+                });
+                res.on('error', reject);
+            });
+            req.setTimeout(this.timeoutMs, () => {
+                req.destroy(new Error(`S3 请求超时(${this.timeoutMs}ms): ${method} ${key}`));
+            });
+            req.on('error', reject);
+            if (body.length)
+                req.write(body);
+            req.end();
+        });
+    }
+    /** 带重试的请求;5xx/429 退避重试,4xx 立即抛。 */
+    async call(method, key, opts = {}) {
+        let lastErr;
+        for (let i = 0; i < MAX_ATTEMPTS; i++) {
+            try {
+                const res = await this.raw(method, key, opts);
+                if (res.status === 404) {
+                    if (opts.allow404)
+                        return null;
+                    const { code, message } = parseErrorBody(res.body.toString('utf8'));
+                    throw new S3Error(`对象不存在: ${key}${message ? ` (${message})` : ''}`, 404, code);
+                }
+                if (res.status >= 400) {
+                    const { code, message } = parseErrorBody(res.body.toString('utf8'));
+                    const err = new S3Error(`S3 ${method} 失败 (${res.status})${code ? ` ${code}` : ''}${message ? `: ${message}` : ''}`, res.status, code);
+                    if (!retryable(err) || i === MAX_ATTEMPTS - 1)
+                        throw err;
+                    lastErr = err;
+                }
+                else {
+                    return res;
+                }
+            }
+            catch (err) {
+                lastErr = err;
+                if (!retryable(err) || i === MAX_ATTEMPTS - 1)
+                    throw err;
+            }
+            await sleep(500 * 2 ** i * (0.7 + Math.random() * 0.6));
+        }
+        throw lastErr;
+    }
+    /** 列一层:prefix 下的直接子项;delimiter='/' 时把子目录折叠成目录项,空串表示递归。 */
+    async listPage(prefix, delimiter = '/') {
+        const out = [];
+        let token;
+        do {
+            const query = {
+                'list-type': '2',
+                prefix,
+            };
+            if (delimiter)
+                query['delimiter'] = delimiter;
+            if (token)
+                query['continuation-token'] = token;
+            const res = await this.call('GET', '', { query });
+            const xml = res.body.toString('utf8');
+            const contentRe = /<Contents>([\s\S]*?)<\/Contents>/g;
+            let m;
+            while ((m = contentRe.exec(xml))) {
+                const key = /<Key>([\s\S]*?)<\/Key>/.exec(m[1])?.[1];
+                if (!key)
+                    continue;
+                const size = Number(/<Size>(\d+)<\/Size>/.exec(m[1])?.[1] ?? '0');
+                const modified = /<LastModified>([\s\S]*?)<\/LastModified>/.exec(m[1])?.[1];
+                const mtime = modified ? Date.parse(modified) : NaN;
+                out.push({ key, size, isDir: false, ...(Number.isFinite(mtime) ? { mtime } : {}) });
+            }
+            const prefixRe = /<CommonPrefixes>([\s\S]*?)<\/CommonPrefixes>/g;
+            while ((m = prefixRe.exec(xml))) {
+                const p = /<Prefix>([\s\S]*?)<\/Prefix>/.exec(m[1])?.[1];
+                if (!p)
+                    continue;
+                out.push({ key: p, size: 0, isDir: true });
+            }
+            const truncated = /<IsTruncated>true<\/IsTruncated>/.test(xml);
+            token = truncated
+                ? /<NextContinuationToken>([\s\S]*?)<\/NextContinuationToken>/.exec(xml)?.[1]
+                : undefined;
+        } while (token);
+        return out;
+    }
+    async list(path, signal) {
+        if (signal?.aborted)
+            return [];
+        const prefix = strip(path);
+        const fullPrefix = prefix ? `${prefix}/` : '';
+        const items = await this.listPage(fullPrefix);
+        const out = [];
+        for (const it of items) {
+            const name = it.isDir
+                ? strip(it.key).split('/').pop() ?? ''
+                : it.key.slice(fullPrefix.length);
+            if (!name)
+                continue;
+            out.push({
+                name,
+                type: it.isDir ? 'directory' : 'file',
+                size: it.size,
+                ...(it.mtime !== undefined ? { mtime: it.mtime } : {}),
+            });
+        }
+        return out;
+    }
+    /** 递归列前缀下所有文件(不带 delimiter,一次分页拉完)。 */
+    async listAll(prefix, signal) {
+        if (signal?.aborted)
+            return [];
+        const items = await this.listPage(strip(prefix), '');
+        return items
+            .filter((it) => !it.isDir)
+            .map((it) => ({
+            name: it.key,
+            type: 'file',
+            size: it.size,
+            ...(it.mtime !== undefined ? { mtime: it.mtime } : {}),
+        }));
+    }
+    async listDevices() {
+        const items = await this.listPage('raw/');
+        const out = new Set();
+        for (const it of items) {
+            if (!it.isDir)
+                continue;
+            const name = strip(it.key).split('/').pop();
+            if (name && name !== '.')
+                out.add(name);
+        }
+        return [...out].sort();
+    }
+    async readJson(path, signal) {
+        if (signal?.aborted)
+            return null;
+        const res = await this.call('GET', toKey(path), { allow404: true });
+        if (!res)
+            return null;
+        const text = res.body.toString('utf8');
+        if (!text.trim())
+            return null;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            // 远端索引写一半/被破坏:忽略它,让 push 从本地状态重建索引
+            console.warn(`[trove] 远端 JSON 损坏,已忽略: ${path}`);
+            return null;
+        }
+    }
+    async writeJson(path, value) {
+        const body = Buffer.from(JSON.stringify(value), 'utf8');
+        // S3 的 PutObject 对同 key 是原子覆盖,天然满足"索引是唯一提交点"
+        await this.call('PUT', toKey(path), { body });
+    }
+    async writeFile(path, localPath, range) {
+        const key = toKey(path);
+        // 区间上传是应用层分块(旧 chunk 布局),按区间读后单独 PUT
+        if (range) {
+            const body = await this.readRange(localPath, range);
+            await this.call('PUT', key, { body });
+            return;
+        }
+        const size = (await stat(localPath)).size;
+        if (size > MULTIPART_THRESHOLD) {
+            await this.multipart(key, localPath, size);
+            return;
+        }
+        // 读整个文件到内存再发:控制在 16MiB 以内
+        await this.call('PUT', key, { body: await readFile(localPath) });
+    }
+    /** 逐段落读本地文件,避免整个大文件进内存。 */
+    async readPart(fh, offset, length) {
+        const buf = Buffer.allocUnsafe(length);
+        let read = 0;
+        while (read < length) {
+            const { bytesRead } = await fh.read(buf, read, length - read, offset + read);
+            if (bytesRead === 0)
+                break;
+            read += bytesRead;
+        }
+        return buf.subarray(0, read);
+    }
+    /**
+     * S3 Multipart Upload:分片只在协议层,最终仍是一个对象。
+     * 失败时尽力 Abort,避免桶里留下未完成的分片。
+     */
+    async multipart(key, localPath, size) {
+        const created = await this.call('POST', key, { query: { uploads: '' } });
+        const uploadId = /<UploadId>([\s\S]*?)<\/UploadId>/.exec(created.body.toString('utf8'))?.[1];
+        if (!uploadId)
+            throw new S3Error(`创建分片上传失败(缺少 UploadId): ${key}`);
+        const fh = await open(localPath, 'r');
+        try {
+            // shortcut: 8 MiB × 10000 片 = 78 GiB 上限,会话文件远小于此;真超了再动态放大分片
+            const count = Math.ceil(size / PART_SIZE);
+            const parts = await mapLimit(Array.from({ length: count }, (_, i) => i + 1), this.concurrency, async (partNumber) => {
+                const offset = (partNumber - 1) * PART_SIZE;
+                const length = Math.min(PART_SIZE, size - offset);
+                const body = await this.readPart(fh, offset, length);
+                const res = await this.call('PUT', key, {
+                    query: { partNumber: String(partNumber), uploadId },
+                    body,
+                });
+                const raw = res.headers.etag;
+                const etag = Array.isArray(raw) ? raw[0] : raw;
+                if (!etag)
+                    throw new S3Error(`分片 ${partNumber} 缺少 ETag: ${key}`);
+                return { partNumber, etag };
+            });
+            parts.sort((a, b) => a.partNumber - b.partNumber);
+            const xml = [
+                '<CompleteMultipartUpload>',
+                ...parts.map((p) => `<Part><PartNumber>${p.partNumber}</PartNumber><ETag>${p.etag}</ETag></Part>`),
+                '</CompleteMultipartUpload>',
+            ].join('');
+            const res = await this.call('POST', key, {
+                query: { uploadId },
+                body: Buffer.from(xml, 'utf8'),
+                headers: { 'content-type': 'application/xml' },
+            });
+            // COS 的 Complete 可能返回 200 但响应体内嵌 <Error>
+            const text = res.body.toString('utf8');
+            if (/<Error>/.test(text))
+                throw new S3Error(`分片上传合并失败: ${text.slice(0, 300)}`);
+        }
+        catch (err) {
+            await this.call('DELETE', key, { query: { uploadId }, allow404: true }).catch(() => { });
+            throw err;
+        }
+        finally {
+            await fh.close();
+        }
+    }
+    async readRange(localPath, range) {
+        if (!range) {
+            return readFile(localPath);
+        }
+        const fh = await open(localPath, 'r');
+        try {
+            return await this.readPart(fh, range.offset, range.length);
+        }
+        finally {
+            await fh.close();
+        }
+    }
+    async readFile(path, localPath) {
+        const key = toKey(path);
+        // HEAD 拿长度后分段 GET:单对象布局下文件可能很大,不能整段进内存
+        const size = await this.call('HEAD', key, { allow404: true })
+            .then((res) => {
+            const raw = res?.headers['content-length'];
+            const n = Number(Array.isArray(raw) ? raw[0] : raw);
+            return Number.isFinite(n) ? n : null;
+        })
+            .catch(() => null);
+        if (size === null) {
+            const res = await this.call('GET', key);
+            await writeFile(localPath, res.body);
+            return;
+        }
+        const fh = await open(localPath, 'w');
+        try {
+            for (let offset = 0; offset < size; offset += READ_PART_SIZE) {
+                const end = Math.min(offset + READ_PART_SIZE, size) - 1;
+                const res = await this.call('GET', key, {
+                    headers: { range: `bytes=${offset}-${end}` },
+                });
+                // 服务端忽略 Range 会回 200 全量:直接整份落盘,不能按偏移写
+                if (res.status !== 206) {
+                    await fh.write(res.body, 0, res.body.length, 0);
+                    return;
+                }
+                await fh.write(res.body, 0, res.body.length, offset);
+            }
+        }
+        finally {
+            await fh.close();
+        }
+    }
+    async delete(path) {
+        // S3 删除不存在的对象也返回 204,不需要处理 404
+        await this.call('DELETE', toKey(path), { allow404: true });
+    }
+    /** 对象存储允许并发上传;OSS 官方建议大批量小文件用较高并发。 */
+    concurrencyHint() {
+        return this.concurrency;
+    }
+    /** 对象存储:一个文件一个对象,控制台可直接浏览。 */
+    layoutHint() {
+        return 'object';
+    }
+}
+//# sourceMappingURL=s3-store.js.map

package/dist/remote/s3-store.js.map

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

package/dist/remote/s3-vendors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * S3 厂商预设。
+ *
+ * 两家都提供 AWS S3 兼容 API,差别只在 endpoint 形态与寻址方式:
+ * - 阿里云 OSS:官方文档要求 addressing_style=virtual、pathStyleAccessEnabled(false)、
+ *   chunkedEncodingEnabled(false);走 path-style 会 403。
+ * - 腾讯云 COS:兼容 S3,桶名形如 <name>-<appid>。
+ */
+export type S3VendorId = 'aliyun' | 'tencent';
+export interface S3Vendor {
+    id: S3VendorId;
+    label: string;
+    /** 交互引导里的提示文案。 */
+    hint: string;
+    defaultRegion: string;
+    /** 该厂商的 S3 兼容 endpoint 形态。 */
+    endpoint: (region: string) => string;
+    /** 阿里云 OSS 默认 virtual-hosted;path-style 会被拒。 */
+    forcePathStyle: boolean;
+}
+export declare const S3_VENDORS: Record<S3VendorId, S3Vendor>;
+export declare function vendorById(id: string): S3Vendor;
+export interface EndpointSpec {
+    provider?: S3VendorId;
+    region?: string;
+    endpoint?: string;
+}
+/**
+ * 解析实际使用的 endpoint:手填优先,否则按厂商 + 地域推导。
+ */
+export declare function resolveEndpoint(spec: EndpointSpec): string;

package/dist/remote/s3-vendors.js

@@ -0,0 +1,47 @@
+/**
+ * S3 厂商预设。
+ *
+ * 两家都提供 AWS S3 兼容 API,差别只在 endpoint 形态与寻址方式:
+ * - 阿里云 OSS:官方文档要求 addressing_style=virtual、pathStyleAccessEnabled(false)、
+ *   chunkedEncodingEnabled(false);走 path-style 会 403。
+ * - 腾讯云 COS:兼容 S3,桶名形如 <name>-<appid>。
+ */
+export const S3_VENDORS = {
+    aliyun: {
+        id: 'aliyun',
+        label: '阿里云 OSS',
+        hint: '需要 AccessKey ID / Secret,以及 Bucket 名与地域(如 cn-hangzhou)。',
+        defaultRegion: 'cn-hangzhou',
+        endpoint: (region) => `https://s3.oss-${region}.aliyuncs.com`,
+        forcePathStyle: false,
+    },
+    tencent: {
+        id: 'tencent',
+        label: '腾讯云 COS',
+        hint: '需要 SecretId / SecretKey,以及完整 Bucket 名(含 -<appid> 后缀)与地域(如 ap-guangzhou)。',
+        defaultRegion: 'ap-guangzhou',
+        endpoint: (region) => `https://cos.${region}.myqcloud.com`,
+        forcePathStyle: false,
+    },
+};
+export function vendorById(id) {
+    const v = S3_VENDORS[id];
+    if (!v) {
+        throw new Error(`不支持的 S3 厂商: ${id}(目前支持 ${Object.keys(S3_VENDORS).join(' / ')})`);
+    }
+    return v;
+}
+/**
+ * 解析实际使用的 endpoint:手填优先,否则按厂商 + 地域推导。
+ */
+export function resolveEndpoint(spec) {
+    if (spec.endpoint && spec.endpoint.trim()) {
+        return spec.endpoint.trim().replace(/\/+$/, '');
+    }
+    if (spec.provider) {
+        const v = vendorById(spec.provider);
+        return v.endpoint(spec.region || v.defaultRegion);
+    }
+    throw new Error('缺少 S3 endpoint:请指定厂商(provider)或直接填 endpoint。');
+}
+//# sourceMappingURL=s3-vendors.js.map

package/dist/remote/s3-vendors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-vendors.js","sourceRoot":"","sources":["../../src/remote/s3-vendors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH,MAAM,CAAC,MAAM,UAAU,GAAiC;IACtD,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,yDAAyD;QAC/D,aAAa,EAAE,aAAa;QAC5B,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,MAAM,eAAe;QAC7D,cAAc,EAAE,KAAK;KACtB;IACD,OAAO,EAAE;QACP,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,0EAA0E;QAChF,aAAa,EAAE,cAAc;QAC7B,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,MAAM,eAAe;QAC1D,cAAc,EAAE,KAAK;KACtB;CACF,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,MAAM,CAAC,GAAG,UAAU,CAAC,EAAgB,CAAC,CAAC;IACvC,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE,SAAS,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAQD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;AAClE,CAAC"}

package/dist/remote/store.d.ts

@@ -0,0 +1,44 @@
+export interface RemoteEntry {
+    name: string;
+    type: 'file' | 'directory';
+    size: number;
+    /** 最后修改时间(ms);后端不提供时缺省,清理逻辑对缺失值一律不删。 */
+    mtime?: number;
+}
+/** 远端只要求 7 个原语;WebDAV/内存实现同一接口,编排逻辑可单测。 */
+export interface RemoteStore {
+    /** 列出某个目录的直接子项(不递归);目录不存在返回空数组。signal 用于短超时探测。 */
+    list(path: string, signal?: AbortSignal): Promise<RemoteEntry[]>;
+    /**
+     * 递归列出前缀下所有文件,name 为完整路径。对象存储一次 ListObjectsV2 即可,
+     * 避免逐目录几千次往返。不实现时调用方回退为逐层 list。
+     */
+    listAll?(prefix: string, signal?: AbortSignal): Promise<RemoteEntry[]>;
+    /** 远端根下的设备目录名(无嵌套)。 */
+    listDevices(): Promise<string[]>;
+    /** 读取 JSON;不存在返回 null。 */
+    readJson(path: string, signal?: AbortSignal): Promise<unknown | null>;
+    /** 原子写入 JSON(实现负责覆盖)。 */
+    writeJson(path: string, value: unknown): Promise<void>;
+    /** 上传本地文件(实现自动建父目录);range 用于只传一个块。 */
+    writeFile(path: string, localPath: string, range?: {
+        offset: number;
+        length: number;
+    }): Promise<void>;
+    /** 下载远端文件到本地路径(字节一致)。 */
+    readFile(path: string, localPath: string): Promise<void>;
+    /** 删除单个文件;不存在时忽略。 */
+    delete(path: string): Promise<void>;
+    /**
+     * 该后端建议的并发上传数。
+     * WebDAV 实测并发 PUT 会 ECONNRESET,返回 1;对象存储允许并发,返回更高值。
+     * 不实现则按 1 处理。
+     */
+    concurrencyHint?(): number;
+    /**
+     * 该后端偏好的文件布局。
+     * object:一个文件一个对象(对象存储,控制台可读);chunk:应用层分块(WebDAV)。
+     * 不实现则按 chunk 处理。
+     */
+    layoutHint?(): 'chunk' | 'object';
+}

package/dist/remote/store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.js.map

package/dist/remote/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/remote/store.ts"],"names":[],"mappings":""}

package/dist/remote/webdav-store.d.ts

@@ -0,0 +1,41 @@
+import type { RemoteEntry, RemoteStore } from './store.js';
+export interface WebDavOptions {
+    url: string;
+    username?: string;
+    password?: string;
+}
+/**
+ * WebDAV 存储实现。块是 8MiB 级小对象,目录按需创建并缓存,
+ * 避免老实现"每个文件逐级 MKCOL"的数千次多余往返。
+ */
+export declare class WebDavStore implements RemoteStore {
+    private client;
+    private ensured;
+    private lastRequestAt;
+    constructor(opts: WebDavOptions);
+    /** 限速:相邻请求至少间隔 REQUEST_MIN_INTERVAL_MS,给 frpc 隧道留缓冲。 */
+    private throttle;
+    /** 调用方信号(如 SIGTERM)与统一超时取最早;半开连接超时后自动放弃,重试才有意义。 */
+    private scope;
+    listDevices(): Promise<string[]>;
+    list(path: string, signal?: AbortSignal): Promise<Array<{
+        name: string;
+        type: 'file' | 'directory';
+        size: number;
+        mtime?: number;
+    }>>;
+    /** 递归列前缀下所有文件(WebDAV 的 deep 列举一次返回)。 */
+    listAll(prefix: string, signal?: AbortSignal): Promise<RemoteEntry[]>;
+    readJson(path: string, signal?: AbortSignal): Promise<unknown | null>;
+    writeJson(path: string, value: unknown): Promise<void>;
+    writeFile(path: string, localPath: string, range?: {
+        offset: number;
+        length: number;
+    }): Promise<void>;
+    readFile(path: string, localPath: string): Promise<void>;
+    delete(path: string): Promise<void>;
+    /** WebDAV 实测并发 PUT 会 ECONNRESET,保持单连接顺序上传。 */
+    concurrencyHint(): number;
+    /** 逐段建父目录;已建过的段落直接跳过(缓存跨文件生效)。 */
+    private ensureDir;
+}