trove-cli 0.0.0-stage → 0.2.0

package/dist/remote/prompt.js

@@ -0,0 +1,111 @@
+import { password as clackPassword, select, text } from '@clack/prompts';
+import { S3_VENDORS, vendorById } from './s3-vendors.js';
+const TYPE_OPTIONS = [
+    { value: 'webdav', label: 'WebDAV(自建/第三方网盘)' },
+    { value: 's3', label: 'S3 兼容对象存储(阿里云 OSS / 腾讯云 COS)' },
+];
+export function isCancel(v) {
+    return typeof v === 'symbol';
+}
+/** 问一个文本;返回 undefined 表示用户取消。 */
+async function askText(message, initialValue, placeholder) {
+    const v = await text({
+        message,
+        initialValue: initialValue ?? '',
+        ...(placeholder ? { placeholder } : {}),
+    });
+    return isCancel(v) ? undefined : v.trim();
+}
+async function askSecret(message) {
+    const v = await clackPassword({ message });
+    return isCancel(v) ? undefined : v.trim();
+}
+/**
+ * 交互式引导远端配置。
+ *
+ * @param existing 当前配置,用作默认值
+ * @param interactive 是否交互
+ * @param forcedType 强制指定类型(init 的 --type flag)
+ * @returns 远端配置;非交互模式返回 undefined
+ */
+export async function promptRemoteConfig(existing, interactive, forcedType) {
+    if (!interactive)
+        return undefined;
+    let type;
+    if (forcedType) {
+        type = forcedType;
+    }
+    else {
+        const picked = await select({
+            message: '远端类型',
+            options: TYPE_OPTIONS,
+            initialValue: existing?.type ?? 'webdav',
+        });
+        if (isCancel(picked))
+            return undefined;
+        type = picked;
+    }
+    if (type === 's3') {
+        return promptS3(existing?.type === 's3' ? existing : undefined);
+    }
+    return promptWebDav(existing?.type === 'webdav' ? existing : undefined);
+}
+async function promptWebDav(existing) {
+    const url = await askText('WebDAV 地址', existing?.url, 'https://dav.example.com/trove/');
+    if (url === undefined)
+        return undefined;
+    const username = await askText('WebDAV 用户名', existing?.username || 'webdav');
+    if (username === undefined)
+        return undefined;
+    const password = await askSecret('WebDAV 密码(留空 = 不变)');
+    if (password === undefined)
+        return undefined;
+    return {
+        type: 'webdav',
+        url,
+        username,
+        // 留空保留原密码
+        password: password === '' ? (existing?.password ?? '') : password,
+    };
+}
+async function promptS3(existing) {
+    const providerId = (existing?.provider ?? 'aliyun');
+    const picked = await select({
+        message: 'S3 厂商',
+        options: Object.values(S3_VENDORS).map((v) => ({
+            value: v.id,
+            label: `${v.label} — ${v.hint}`,
+        })),
+        initialValue: providerId,
+    });
+    if (isCancel(picked))
+        return undefined;
+    const vendor = vendorById(picked);
+    const region = await askText('地域', existing?.region ?? vendor.defaultRegion, vendor.defaultRegion);
+    if (region === undefined)
+        return undefined;
+    const bucket = await askText('Bucket', existing?.bucket, vendor.id === 'tencent' ? 'my-bucket-1250000000' : 'my-bucket');
+    if (bucket === undefined)
+        return undefined;
+    const accessKeyId = await askText('AccessKey ID', existing?.accessKeyId);
+    if (accessKeyId === undefined)
+        return undefined;
+    const secretAccessKey = await askSecret('Secret AccessKey(留空 = 不变)');
+    if (secretAccessKey === undefined)
+        return undefined;
+    // 自定义 endpoint:留空 = 按厂商推导;MinIO 等私有部署填自己的地址
+    const endpoint = await askText('自定义 Endpoint(留空 = 用厂商默认)', existing?.endpoint ?? '', vendor.endpoint(region));
+    if (endpoint === undefined)
+        return undefined;
+    return {
+        type: 's3',
+        provider: vendor.id,
+        region,
+        bucket,
+        accessKeyId,
+        secretAccessKey: secretAccessKey === '' ? (existing?.secretAccessKey ?? '') : secretAccessKey,
+        ...(endpoint ? { endpoint } : {}),
+        forcePathStyle: existing?.forcePathStyle ?? vendor.forcePathStyle,
+    };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/remote/prompt.js.map

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

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

@@ -0,0 +1,28 @@
+export interface SigV4Credentials {
+    accessKeyId: string;
+    secretAccessKey: string;
+    region: string;
+    service: string;
+}
+export interface SignRequestInput extends SigV4Credentials {
+    method: string;
+    url: string;
+    /** 未编码的原始路径;省略时从 url 解析。url.pathname 已被 WHATWG URL 预编码,直接喂给 canonicalUri 会二次编码。 */
+    pathname?: string;
+    headers: Record<string, string>;
+    body: Buffer;
+    date: Date;
+}
+export interface SignedRequest {
+    headers: Record<string, string>;
+}
+/** canonical URI:路径部分,/ 分隔符不编码。 */
+export declare function canonicalUri(pathname: string): string;
+/** canonical query:按 key 排序后逐项编码,= 与 & 分隔。 */
+export declare function canonicalQuery(params: Record<string, string>): string;
+/** payload 的 sha256 十六进制。 */
+export declare function payloadHash(body: Buffer): string;
+/**
+ * 对一个请求签名,返回带 Authorization / x-amz-date / x-amz-content-sha256 的头部。
+ */
+export declare function signRequest(input: SignRequestInput): SignedRequest;

package/dist/remote/s3-sigv4.js

@@ -0,0 +1,100 @@
+import { createHash, createHmac } from 'node:crypto';
+/**
+ * AWS Signature Version 4 签名。
+ *
+ * 只实现 S3 需要的部分:Get/Put/Delete + ListObjectsV2。
+ * 不引第三方 SDK —— 本项目只需要 4 个已签名请求,自己签省掉一整个依赖树。
+ */
+const ALGORITHM = 'AWS4-HMAC-SHA256';
+function sha256Hex(data) {
+    return createHash('sha256').update(data).digest('hex');
+}
+function hmac(key, data) {
+    return createHmac('sha256', key).update(data).digest();
+}
+/** S3 要求路径中这些字符原样保留,不参与百分号编码。 */
+const UNRESERVED = /[A-Za-z0-9\-._~]/;
+/**
+ * URI 编码:非保留字符原样,其余 UTF-8 百分号编码。
+ * AWS 的规则与 RFC3986 有两处差异:斜杠只在路径中保留,星号不编码。
+ */
+function uriEncode(value, encodeSlash) {
+    let out = '';
+    for (const ch of Buffer.from(value, 'utf8')) {
+        const s = String.fromCharCode(ch);
+        if (UNRESERVED.test(s)) {
+            out += s;
+        }
+        else if (s === '/') {
+            out += encodeSlash ? '%2F' : '/';
+        }
+        else {
+            out += `%${ch.toString(16).toUpperCase().padStart(2, '0')}`;
+        }
+    }
+    return out;
+}
+/** canonical URI:路径部分,/ 分隔符不编码。 */
+export function canonicalUri(pathname) {
+    const p = pathname.startsWith('/') ? pathname : `/${pathname}`;
+    return uriEncode(p, false);
+}
+/** canonical query:按 key 排序后逐项编码,= 与 & 分隔。 */
+export function canonicalQuery(params) {
+    return Object.keys(params)
+        .sort()
+        .map((k) => `${uriEncode(k, true)}=${uriEncode(params[k], true)}`)
+        .join('&');
+}
+/** payload 的 sha256 十六进制。 */
+export function payloadHash(body) {
+    return sha256Hex(body);
+}
+/** 头部名小写、按序拼接;每个头部值去除多余空白并折叠。 */
+function canonicalHeaders(headers) {
+    const entries = Object.entries(headers)
+        .map(([k, v]) => [k.toLowerCase(), v.trim().replace(/\s+/g, ' ')])
+        .sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0));
+    const canonical = entries.map(([k, v]) => `${k}:${v}\n`).join('');
+    const signed = entries.map(([k]) => k).join(';');
+    return { signed, canonical };
+}
+/**
+ * 对一个请求签名,返回带 Authorization / x-amz-date / x-amz-content-sha256 的头部。
+ */
+export function signRequest(input) {
+    const { method, url, body, date } = input;
+    const u = new URL(url);
+    const pathname = input.pathname ?? u.pathname;
+    const amzDate = date.toISOString().replace(/[:-]|\.\d{3}/g, '');
+    const dateStamp = amzDate.slice(0, 8);
+    const headers = {
+        ...input.headers,
+        'x-amz-date': amzDate,
+        'x-amz-content-sha256': payloadHash(body),
+    };
+    const { signed, canonical } = canonicalHeaders(headers);
+    const canonicalRequest = [
+        method.toUpperCase(),
+        canonicalUri(pathname),
+        canonicalQuery(Object.fromEntries(u.searchParams.entries())),
+        canonical,
+        signed,
+        payloadHash(body),
+    ].join('\n');
+    const scope = `${dateStamp}/${input.region}/${input.service}/aws4_request`;
+    const stringToSign = [ALGORITHM, amzDate, scope, sha256Hex(canonicalRequest)].join('\n');
+    const kDate = hmac(`AWS4${input.secretAccessKey}`, dateStamp);
+    const kRegion = hmac(kDate, input.region);
+    const kService = hmac(kRegion, input.service);
+    const kSigning = hmac(kService, 'aws4_request');
+    const signature = createHmac('sha256', kSigning).update(stringToSign).digest('hex');
+    return {
+        headers: {
+            ...headers,
+            authorization: `${ALGORITHM} Credential=${input.accessKeyId}/${scope}, ` +
+                `SignedHeaders=${signed}, Signature=${signature}`,
+        },
+    };
+}
+//# sourceMappingURL=s3-sigv4.js.map

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

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

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

@@ -0,0 +1,75 @@
+import type { RemoteEntry, RemoteStore } from './store.js';
+export interface S3Options {
+    /** S3 兼容 endpoint,例如 https://s3.oss-cn-hangzhou.aliyuncs.com */
+    endpoint: string;
+    region: string;
+    bucket: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    /** path-style 寻址(bucket 在路径里);virtual-hosted 时 bucket 在主机名里。 */
+    forcePathStyle?: boolean;
+    /** 并发连接数上限;对象存储允许并发,默认 8。 */
+    maxSockets?: number;
+    /** 并发上传块数;与连接池上限一致,默认 8。 */
+    concurrency?: number;
+    /** 单请求超时(ms)。 */
+    timeoutMs?: number;
+}
+export declare class S3Error extends Error {
+    readonly status?: number | undefined;
+    readonly code?: string | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined);
+}
+/**
+ * S3 存储实现:对象存储天然是扁平的 key,目录语义靠 ListObjectsV2 的 delimiter 模拟。
+ *
+ * 与 WebDAV 实现的差异:
+ * - 目录不用创建(PutObject 自动建"目录")
+ * - 索引写入直接覆盖同 key,天然原子(S3 的 PutObject 对同 key 是原子的)
+ * - 允许并发:WebDAV 实测并发 PUT 会 ECONNRESET,对象存储不会
+ */
+export declare class S3Store implements RemoteStore {
+    private endpoint;
+    private region;
+    private bucket;
+    private accessKeyId;
+    private secretAccessKey;
+    private forcePathStyle;
+    private timeoutMs;
+    private maxSockets;
+    private concurrency;
+    /** keep-alive 连接池:对象存储允许并发,默认 8 条。 */
+    private agents;
+    constructor(opts: S3Options);
+    /** virtual-hosted:bucket 放主机名;path-style:bucket 放路径。 */
+    private hostAndPath;
+    private raw;
+    /** 带重试的请求;5xx/429 退避重试,4xx 立即抛。 */
+    private call;
+    /** 列一层:prefix 下的直接子项;delimiter='/' 时把子目录折叠成目录项,空串表示递归。 */
+    private listPage;
+    list(path: string, signal?: AbortSignal): Promise<RemoteEntry[]>;
+    /** 递归列前缀下所有文件(不带 delimiter,一次分页拉完)。 */
+    listAll(prefix: string, signal?: AbortSignal): Promise<RemoteEntry[]>;
+    listDevices(): Promise<string[]>;
+    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>;
+    /** 逐段落读本地文件,避免整个大文件进内存。 */
+    private readPart;
+    /**
+     * S3 Multipart Upload:分片只在协议层,最终仍是一个对象。
+     * 失败时尽力 Abort,避免桶里留下未完成的分片。
+     */
+    private multipart;
+    private readRange;
+    readFile(path: string, localPath: string): Promise<void>;
+    delete(path: string): Promise<void>;
+    /** 对象存储允许并发上传;OSS 官方建议大批量小文件用较高并发。 */
+    concurrencyHint(): number;
+    /** 对象存储:一个文件一个对象,控制台可直接浏览。 */
+    layoutHint(): 'chunk' | 'object';
+}