@ainc/fs 0.1.20 → 0.1.22

package/README.md

@@ -1,26 +1,12 @@
-# @ainc/esb
-Let's do something nice with @ainc/esb!
+# @ainc/fs
+Let's do something nice with @ainc/fs!
 
 ## Install
 ``` shell
-$ yarn global add @ainc/esb
+$ pnpm add @ainc/fs
 ```
 
 ## Usage
-``` shell
-$ esb -p ./src
-```
-
-## VS Code
-``` json
-{
-  "name": "Launch Script",
-  "type": "node",
-  "request": "launch",
-  "autoAttachChildProcesses": true,
-  "runtimeExecutable": "esb",
-  "args": [
-    "${file}"
-  ]
-}
+``` javascript
+import * as fs from '@ainc/fs';
 ```

package/bin/download.mjs

@@ -0,0 +1,76 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-01 12:25:56
+ *****************************************
+ */
+'use strict';
+
+
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { downloadFile } from '../esm/downloadFile.mjs';
+
+
+/**
+ *****************************************
+ * 执行脚本
+ *****************************************
+ */
+main();
+
+
+/**
+ *****************************************
+ * 主函数
+ *****************************************
+ */
+async function main() {
+  const args = process.argv.slice(2);
+  if (!args.length) {
+    return;
+  }
+
+  // 下载多个文件
+  if (isURL(args[0])) {
+    return Promise.all(args.map(url => downloadFile(resolvePath(url), url)));
+  }
+
+  // 下载文件
+  if (isURL(args[1])) {
+    await downloadFile(args[0], args[1]);
+  }
+}
+
+
+/**
+ *****************************************
+ * 判断是否为 URL
+ *****************************************
+ * @param {string} url
+ */
+function isURL(url) {
+  if (url) {
+    return url.startsWith('http://') || url.startsWith('https://');
+  }
+}
+
+
+/**
+ *****************************************
+ * 解析下载路径
+ *****************************************
+ * @param {string} url
+ */
+function resolvePath(url) {
+  const idx = url.lastIndexOf('/');
+  if (idx !== -1) {
+    return '.' + url.slice(idx);
+  } else {
+    return Math.random().toString(16).slice(2);
+  }
+}
+

package/dist/concurrency.d.ts

@@ -0,0 +1,43 @@
+/**
+ *****************************************
+ * 任务类型
+ *****************************************
+ */
+export type Handler<T, P> = (data: T) => P | Promise<P>;
+export type Result<T> = {
+    value: T | Promise<T>;
+    err?: unknown;
+};
+/**
+ *****************************************
+ * 并发控制
+ *****************************************
+ */
+export declare class Concurrency<T, P> {
+    /** 并发容量 */
+    private _capacity;
+    /** 处理函数 */
+    private _handler;
+    /** 待处理任务 */
+    private _pending;
+    /** 正在执行的任务数 */
+    private _running;
+    /** 结果缓存队列 */
+    private _results;
+    /** 当前值 */
+    private _value?;
+    /** 初始化 */
+    constructor(capacity: number, handler: Handler<T, P>);
+    /** 添加任务 */
+    add(data: T): this;
+    /** 执行处理 */
+    execute<R = P>(handler?: Handler<P, R>): Promise<R[]>;
+    /** 读取值 */
+    value(): P;
+    /** 执行处理 */
+    next(): Promise<boolean>;
+    /** 执行任务 */
+    private _execute;
+    /** 处理任务 */
+    private _process;
+}

package/dist/concurrency.js

@@ -0,0 +1,99 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-14 13:42:34
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Concurrency = void 0;
+/**
+ *****************************************
+ * 并发控制
+ *****************************************
+ */
+class Concurrency {
+    /** 初始化 */
+    constructor(capacity, handler) {
+        /** 待处理任务 */
+        this._pending = [];
+        /** 正在执行的任务数 */
+        this._running = 0;
+        /** 结果缓存队列 */
+        this._results = [];
+        this._capacity = Math.max(1, capacity);
+        this._handler = handler;
+    }
+    /** 添加任务 */
+    add(data) {
+        this._pending.push(data);
+        return this;
+    }
+    /** 执行处理 */
+    async execute(handler) {
+        const results = [];
+        const fn = handler || (v => v);
+        // 遍历结果
+        while (await this.next()) {
+            results.push(await fn(this._value));
+        }
+        // 返回结果
+        return results;
+    }
+    /** 读取值 */
+    value() {
+        return this._value;
+    }
+    /** 执行处理 */
+    async next() {
+        if (this._pending.length) {
+            this._execute();
+        }
+        // 不存在结果，已经处理完
+        if (!this._results.length) {
+            return false;
+        }
+        // 等待结果
+        const res = this._results.shift();
+        await res.value;
+        if (res.err) {
+            throw res.err;
+        }
+        else {
+            this._value = res.value;
+        }
+        // 返回结果
+        return true;
+    }
+    /** 执行任务 */
+    async _execute() {
+        while (this._running < this._capacity) {
+            if (this._pending.length) {
+                this._process(this._pending.shift());
+            }
+            else {
+                break;
+            }
+        }
+    }
+    /** 处理任务 */
+    _process(data) {
+        const res = {};
+        // 添加到结果集
+        this._results.push(res);
+        // 执行任务
+        try {
+            const value = res.value = this._handler(data);
+            if (value instanceof Promise) {
+                this._running++;
+                value
+                    .then(val => res.value = val, err => res.err = err)
+                    .finally(() => (this._running--, this._execute()));
+            }
+        }
+        catch (err) {
+            res.err = err;
+        }
+    }
+}
+exports.Concurrency = Concurrency;

package/dist/dirname.js

@@ -19,9 +19,10 @@ const node_path_1 = require("node:path");
  *****************************************
  */
 function dirname(path) {
-    const parent = (0, node_path_1.dirname)(path);
+    const dest = (0, node_path_1.isAbsolute)(path) ? path : (0, node_path_1.resolve)(path);
+    const parent = (0, node_path_1.dirname)(dest);
     // 校验目录
-    if (parent && parent !== path) {
+    if (parent && parent !== dest) {
         return parent;
     }
 }

package/dist/download.d.ts

@@ -0,0 +1,30 @@
+/**
+ *****************************************
+ * 下载选项
+ *****************************************
+ */
+export interface DownloadOptions {
+    /** 并发下载数（默认 8） */
+    concurrency: number;
+    /** 每个分片大小（默认 1MB） */
+    chunkSize: number;
+    /** 重试次数（默认 3） */
+    retryTimes: number;
+    /** 是否强制下载 */
+    force?: boolean;
+    /** 下载进度 */
+    onProgress?(size: number, total: number): void;
+}
+/**
+ *****************************************
+ * 下载选项
+ *****************************************
+ */
+export interface Options extends RequestInit, Partial<DownloadOptions> {
+}
+/**
+ *****************************************
+ * 下载文件
+ *****************************************
+ */
+export declare function download(dest: string, url: string | URL | Request, options?: Options): Promise<string>;

package/dist/download.js

@@ -0,0 +1,205 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-02-25 16:26:38
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.download = download;
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const promises_1 = require("node:fs/promises");
+const node_fs_1 = require("node:fs");
+const node_stream_1 = require("node:stream");
+const promises_2 = require("node:stream/promises");
+const retry_1 = require("./retry");
+const md5_1 = require("./md5");
+const concurrency_1 = require("./concurrency");
+/**
+ *****************************************
+ * 下载文件
+ *****************************************
+ */
+async function download(dest, url, options = {}) {
+    const { concurrency, chunkSize, retryTimes, force, onProgress, ...init } = options;
+    const path = (0, node_path_1.resolve)(dest);
+    const opts = {
+        concurrency: concurrency && concurrency >= 1 ? concurrency : 8,
+        chunkSize: chunkSize && chunkSize >= 1 ? chunkSize : 1 * 1024 * 1024,
+        retryTimes: retryTimes && retryTimes >= 1 ? retryTimes : 3,
+        force,
+        onProgress,
+    };
+    // 创建下载目录
+    await (0, promises_1.mkdir)((0, node_path_1.dirname)(path), { recursive: true });
+    // 尝试分片下载
+    if (await downloadFileByChunk(path, url, init, opts)) {
+        return path;
+    }
+    else {
+        return (0, retry_1.retry)(opts.retryTimes, () => downloadFile(path, url, init, opts));
+    }
+}
+/**
+ *****************************************
+ * 获取文件大小
+ *****************************************
+ */
+async function downloadFileByChunk(dest, url, init, options) {
+    const stats = await (0, promises_1.stat)(dest).catch(err => err.code === 'ENOENT' ? null : Promise.reject(err));
+    // 已经存在文件，不再下载
+    if (stats && stats.isFile() && !options.force) {
+        options.onProgress && options.onProgress(stats.size, stats.size);
+        return dest;
+    }
+    // 发起获取文件信息请求
+    const resp = await fetch(url, { method: 'HEAD' });
+    if (!resp.ok || resp.headers.get('accept-ranges') !== 'bytes') {
+        return;
+    }
+    // 获取文件总大小
+    const totalSize = parseInt(resp.headers.get('content-length') || '0', 10);
+    if (!totalSize) {
+        return;
+    }
+    // 获取分片配置
+    const chunkConcurrency = new concurrency_1.Concurrency(options.concurrency, downloadChunk);
+    const chunkSize = options.chunkSize;
+    const chunkCount = Math.ceil(totalSize / chunkSize);
+    const downloadedSize = [0];
+    const downloadedTempFile = dest + '.download';
+    const dir = getDownloadDir(url, options);
+    const stream = (0, node_fs_1.createWriteStream)(downloadedTempFile);
+    // 生成任务
+    for (let idx = 0; idx < chunkCount; idx++) {
+        chunkConcurrency.add({
+            start: idx * chunkSize,
+            end: Math.min((idx + 1) * chunkSize - 1, totalSize - 1),
+            idx,
+            url,
+            dir,
+            init,
+            options,
+            totalSize,
+            downloadedSize,
+        });
+    }
+    // 创建下载目录
+    await (0, promises_1.mkdir)(dir, { recursive: true });
+    // 合并文件
+    await chunkConcurrency.execute(path => pipe(path, stream));
+    // 结束传输
+    stream.end();
+    // 重命名临时文件
+    await (0, promises_1.rename)(downloadedTempFile, dest);
+    await (0, promises_1.rm)(dir, { recursive: true });
+    // 返回文件路径
+    return dest;
+}
+/**
+ *****************************************
+ * 下载分片
+ *****************************************
+ */
+async function downloadChunk(downloadChunkOptions) {
+    const { idx, start, end, url, dir, init, options, downloadedSize, totalSize } = downloadChunkOptions;
+    const path = (0, node_path_1.join)(dir, idx + '');
+    const opts = { ...options };
+    const requestInit = {
+        ...init,
+        headers: { ...init.headers, Range: `bytes=${start}-${end}` },
+    };
+    // 添加进度监听
+    if (options.onProgress) {
+        opts.onProgress = size => {
+            downloadedSize[idx] = size;
+            options.onProgress(downloadedSize.reduce((a, b) => a + b, 0), totalSize);
+        };
+    }
+    // 执行下载
+    return (0, retry_1.retry)(options.retryTimes, () => downloadFile(path, url, requestInit, opts));
+}
+/**
+ *****************************************
+ * 生成下载 ID
+ *****************************************
+ */
+function generateDownloadID(url, options) {
+    const now = new Date();
+    now.setHours(0, 0, 0, 0);
+    return (0, md5_1.md5)(`${url}?chunkSize=${options.chunkSize || 0}&t=${now.getTime()}`);
+}
+/**
+ *****************************************
+ * 获取下载 URL
+ *****************************************
+ */
+function getDownloadURL(url) {
+    if (typeof url === 'string') {
+        return url;
+    }
+    else {
+        return url instanceof URL ? url.href : url.url;
+    }
+}
+/**
+ *****************************************
+ * 获取下载目录
+ *****************************************
+ */
+function getDownloadDir(url, options) {
+    return (0, node_path_1.join)((0, node_os_1.tmpdir)(), 'downloads', generateDownloadID(getDownloadURL(url), options));
+}
+/**
+ *****************************************
+ * 写入文件流
+ *****************************************
+ */
+function pipe(src, dest) {
+    return new Promise((resolve, reject) => {
+        const stream = (0, node_fs_1.createReadStream)(src);
+        stream.once('close', resolve);
+        stream.once('error', reject);
+        stream.pipe(dest, { end: false });
+    });
+}
+/**
+ *****************************************
+ * 下载文件
+ *****************************************
+ */
+async function downloadFile(dest, url, init, options) {
+    const stats = await (0, promises_1.stat)(dest).catch(err => err.code === 'ENOENT' ? null : Promise.reject(err));
+    // 已经存在文件，不再下载
+    if (stats && stats.isFile() && !options.force) {
+        options.onProgress && options.onProgress(stats.size, stats.size);
+        return dest;
+    }
+    // 发送请求
+    const resp = await fetch(url, init);
+    if (!resp.ok) {
+        throw new Error(`${resp.status} ${resp.statusText}`);
+    }
+    // 设置流的大小（如果 Content-Length 头存在）
+    const totalSize = parseInt(resp.headers.get('Content-Length') || '0', 10);
+    const stream = node_stream_1.Readable.from(resp.body || '');
+    const downloadedTempFile = dest + '.download';
+    const progress = options.onProgress;
+    // 添加进度监听
+    if (progress) {
+        let size = 0;
+        stream.on('data', chunk => progress(size += chunk.length, totalSize));
+        stream.on('end', () => size <= totalSize && progress(totalSize, totalSize));
+    }
+    // 下载文件
+    await (0, promises_2.pipeline)(stream, (0, node_fs_1.createWriteStream)(downloadedTempFile));
+    await (0, promises_1.rename)(downloadedTempFile, dest);
+    // 返回文件路径
+    return dest;
+}

package/dist/downloadFile.d.ts

@@ -0,0 +1,6 @@
+/**
+ *****************************************
+ * 下载文件
+ *****************************************
+ */
+export declare function downloadFile(dest: string, url: string): Promise<void>;

package/dist/downloadFile.js

@@ -0,0 +1,83 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-14 10:51:52
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadFile = downloadFile;
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+const download_1 = require("./download");
+/**
+ *****************************************
+ * 下载文件
+ *****************************************
+ */
+async function downloadFile(dest, url) {
+    const print = stdout();
+    // 打印日志
+    console.log('[download]:', url);
+    // 下载文件
+    await (0, download_1.download)(dest, url, {
+        onProgress(size, total) {
+            if (size < total) {
+                print(`  -> ${((size / total) * 100).toFixed(2)}% (${format(size)}/${format(total)})`);
+            }
+            else {
+                print('[download]: done', true);
+            }
+        },
+    });
+}
+/**
+ *****************************************
+ * 格式化字节大小为易读格式（B/KB/MB/GB）
+ *****************************************
+ */
+function format(bytes) {
+    let limit = 1;
+    // 遍历单位
+    for (let unit of ['B', 'KB', 'MB', 'GB']) {
+        const next = 1024 * limit;
+        if (bytes < next) {
+            return `${(bytes / limit).toFixed(2)} ${unit}`;
+        }
+        else {
+            limit = next;
+        }
+    }
+    // 返回默认
+    return `${(bytes / limit).toFixed(2)} TB`;
+}
+/**
+ *****************************************
+ * 进度条
+ *****************************************
+ */
+function stdout() {
+    let progressContent = '';
+    let progressSize = 0;
+    let progressTime = 0;
+    return function print(content, flush) {
+        const now = Date.now();
+        if ((content === progressContent || now - progressTime < 600) && !flush) {
+            return;
+        }
+        const size = content.length;
+        const diff = progressSize - size;
+        progressContent = content;
+        progressTime = now;
+        progressSize = size;
+        if (diff > 0) {
+            process.stdout.write(`\r${content}${' '.repeat(diff)}`);
+        }
+        else {
+            process.stdout.write(`\r${content}`);
+        }
+    };
+}

package/dist/index.d.ts

@@ -3,15 +3,17 @@
  * 导出接口
  *****************************************
  */
+export { resolve, join, isAbsolute } from 'node:path';
+export { relative, isRelative } from './relative';
 export { dirname } from './dirname';
-export { mkdir } from './mkdir';
 export { stat, isDir, isFile } from './stat';
-export { relative, isRelative } from './relative';
 export { resolveFile } from './resolveFile';
 export { readFile } from './readFile';
 export { writeFile } from './writeFile';
 export { copy } from './copy';
 export { rm } from './rm';
 export { lookup } from './lookup';
+export { md5 } from './md5';
 export { json, jsonc } from './jsonc';
 export { findUp } from './findUp';
+export { download } from './download';

package/dist/index.js

@@ -6,23 +6,25 @@
  */
 'use strict';
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findUp = exports.jsonc = exports.json = exports.lookup = exports.rm = exports.copy = exports.writeFile = exports.readFile = exports.resolveFile = exports.isRelative = exports.relative = exports.isFile = exports.isDir = exports.stat = exports.mkdir = exports.dirname = void 0;
+exports.download = exports.findUp = exports.jsonc = exports.json = exports.md5 = exports.lookup = exports.rm = exports.copy = exports.writeFile = exports.readFile = exports.resolveFile = exports.isFile = exports.isDir = exports.stat = exports.dirname = exports.isRelative = exports.relative = exports.isAbsolute = exports.join = exports.resolve = void 0;
 /**
  *****************************************
  * 导出接口
  *****************************************
  */
+var node_path_1 = require("node:path");
+Object.defineProperty(exports, "resolve", { enumerable: true, get: function () { return node_path_1.resolve; } });
+Object.defineProperty(exports, "join", { enumerable: true, get: function () { return node_path_1.join; } });
+Object.defineProperty(exports, "isAbsolute", { enumerable: true, get: function () { return node_path_1.isAbsolute; } });
+var relative_1 = require("./relative");
+Object.defineProperty(exports, "relative", { enumerable: true, get: function () { return relative_1.relative; } });
+Object.defineProperty(exports, "isRelative", { enumerable: true, get: function () { return relative_1.isRelative; } });
 var dirname_1 = require("./dirname");
 Object.defineProperty(exports, "dirname", { enumerable: true, get: function () { return dirname_1.dirname; } });
-var mkdir_1 = require("./mkdir");
-Object.defineProperty(exports, "mkdir", { enumerable: true, get: function () { return mkdir_1.mkdir; } });
 var stat_1 = require("./stat");
 Object.defineProperty(exports, "stat", { enumerable: true, get: function () { return stat_1.stat; } });
 Object.defineProperty(exports, "isDir", { enumerable: true, get: function () { return stat_1.isDir; } });
 Object.defineProperty(exports, "isFile", { enumerable: true, get: function () { return stat_1.isFile; } });
-var relative_1 = require("./relative");
-Object.defineProperty(exports, "relative", { enumerable: true, get: function () { return relative_1.relative; } });
-Object.defineProperty(exports, "isRelative", { enumerable: true, get: function () { return relative_1.isRelative; } });
 var resolveFile_1 = require("./resolveFile");
 Object.defineProperty(exports, "resolveFile", { enumerable: true, get: function () { return resolveFile_1.resolveFile; } });
 var readFile_1 = require("./readFile");
@@ -35,8 +37,12 @@ var rm_1 = require("./rm");
 Object.defineProperty(exports, "rm", { enumerable: true, get: function () { return rm_1.rm; } });
 var lookup_1 = require("./lookup");
 Object.defineProperty(exports, "lookup", { enumerable: true, get: function () { return lookup_1.lookup; } });
+var md5_1 = require("./md5");
+Object.defineProperty(exports, "md5", { enumerable: true, get: function () { return md5_1.md5; } });
 var jsonc_1 = require("./jsonc");
 Object.defineProperty(exports, "json", { enumerable: true, get: function () { return jsonc_1.json; } });
 Object.defineProperty(exports, "jsonc", { enumerable: true, get: function () { return jsonc_1.jsonc; } });
 var findUp_1 = require("./findUp");
 Object.defineProperty(exports, "findUp", { enumerable: true, get: function () { return findUp_1.findUp; } });
+var download_1 = require("./download");
+Object.defineProperty(exports, "download", { enumerable: true, get: function () { return download_1.download; } });

package/dist/jsonc.js

@@ -13,7 +13,7 @@ exports.jsonc = jsonc;
  * 加载依赖
  *****************************************
  */
-const stripComments_1 = require("./utils/stripComments");
+const stripComments_1 = require("./stripComments");
 /**
  *****************************************
  * 解析 JSON

package/dist/md5.d.ts

@@ -0,0 +1,6 @@
+/**
+ *****************************************
+ * 生成 md5 签名
+ *****************************************
+ */
+export declare function md5(str: string): string;