@ainc/fs 0.1.20 → 0.1.21

package/dist/resolveFile.js

@@ -12,6 +12,7 @@ exports.resolveFile = resolveFile;
  * 加载依赖
  *****************************************
  */
+const node_path_1 = require("node:path");
 const stat_1 = require("./stat");
 /**
  *****************************************
@@ -19,10 +20,9 @@ const stat_1 = require("./stat");
  *****************************************
  */
 function resolveFile(path, extensions) {
-    const stats = (0, stat_1.stat)(path);
-    // 找到文件
-    if (stats && stats.isFile()) {
-        return path;
+    const dest = (0, node_path_1.resolve)(path);
+    if ((0, stat_1.isFile)(dest)) {
+        return dest;
     }
     // 不再查找
     if (!extensions || !extensions.length) {
@@ -30,10 +30,8 @@ function resolveFile(path, extensions) {
     }
     // 遍历扩展名
     for (let i = 0; i < extensions.length; ++i) {
-        const file = path + extensions[i];
-        const stats = (0, stat_1.stat)(file);
-        // 查找到文件
-        if (stats === null || stats === void 0 ? void 0 : stats.isFile()) {
+        const file = dest + extensions[i];
+        if ((0, stat_1.isFile)(file)) {
             return file;
         }
     }

package/dist/retry.d.ts

@@ -0,0 +1,6 @@
+/**
+ *****************************************
+ * 重试
+ *****************************************
+ */
+export declare function retry<T>(times: number, handler: () => T): T;

package/dist/retry.js

@@ -0,0 +1,50 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-01 20:06:58
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retry = retry;
+/**
+ *****************************************
+ * 重试
+ *****************************************
+ */
+function retry(times, handler) {
+    let count = 1;
+    // 重试处理
+    for (;;) {
+        try {
+            const res = handler();
+            if (res instanceof Promise) {
+                return res.catch(tryPromise);
+            }
+            else {
+                return res;
+            }
+        }
+        catch (err) {
+            if (count++ >= times) {
+                throw err;
+            }
+        }
+    }
+    // 异步重试
+    async function tryPromise(err) {
+        if (count++ >= times) {
+            throw err;
+        }
+        for (;;) {
+            try {
+                return await handler();
+            }
+            catch (err) {
+                if (count++ >= times) {
+                    throw err;
+                }
+            }
+        }
+    }
+}

package/dist/stat.d.ts

@@ -3,7 +3,7 @@
  * 获取文件状态
  *****************************************
  */
-export declare function stat(path: string): import("fs").Stats | undefined;
+export declare function stat(path: string): import("node:fs").Stats | undefined;
 /**
  *****************************************
  * 判断为目录

package/esm/concurrency.mjs

@@ -0,0 +1,96 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-14 13:42:34
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 并发控制
+ *****************************************
+ */
+export 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;
+        }
+    }
+}

package/esm/copy.mjs

@@ -0,0 +1,49 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-25 11:02:21
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { cpSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { stat } from './stat.mjs';
+import { mkdir } from './mkdir.mjs';
+import { rm } from './rm.mjs';
+/**
+ *****************************************
+ * 复制文件
+ *****************************************
+ */
+export function copy(src, dest, options) {
+    const srcStats = stat(src);
+    if (!srcStats) {
+        return false;
+    }
+    // 处理目标文件
+    const destStats = stat(dest);
+    if (destStats) {
+        if (!options || !options.force) {
+            return false;
+        }
+        else {
+            rm(dest);
+        }
+    }
+    // 创建目录
+    if (!mkdir(dirname(dest), options)) {
+        return false;
+    }
+    // 执行拷贝
+    if (srcStats.isDirectory()) {
+        return (cpSync(src, dest, { ...options, recursive: true }), true);
+    }
+    else {
+        return (writeFileSync(dest, readFileSync(src)), true);
+    }
+}

package/esm/dirname.mjs

@@ -0,0 +1,26 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-25 09:35:01
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { dirname as dir, resolve, isAbsolute } from 'node:path';
+/**
+ *****************************************
+ * 获取父级目录
+ *****************************************
+ */
+export function dirname(path) {
+    const dest = isAbsolute(path) ? path : resolve(path);
+    const parent = dir(dest);
+    // 校验目录
+    if (parent && parent !== dest) {
+        return parent;
+    }
+}

package/esm/download.mjs

@@ -0,0 +1,203 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-02-25 16:26:38
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { tmpdir } from 'node:os';
+import { resolve, join, dirname } from 'node:path';
+import { stat, mkdir, rm, rename } from 'node:fs/promises';
+import { createReadStream, createWriteStream } from 'node:fs';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { retry } from './retry.mjs';
+import { md5 } from './md5.mjs';
+import { Concurrency } from './concurrency.mjs';
+/**
+ *****************************************
+ * 下载文件
+ *****************************************
+ */
+export async function download(dest, url, options = {}) {
+    const { concurrency, chunkSize, retryTimes, force, onProgress, ...init } = options;
+    const path = 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 mkdir(dirname(path), { recursive: true });
+    // 尝试分片下载
+    if (await downloadFileByChunk(path, url, init, opts)) {
+        return path;
+    }
+    else {
+        return retry(opts.retryTimes, () => downloadFile(path, url, init, opts));
+    }
+}
+/**
+ *****************************************
+ * 获取文件大小
+ *****************************************
+ */
+async function downloadFileByChunk(dest, url, init, options) {
+    const stats = await 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(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 = 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 mkdir(dir, { recursive: true });
+    // 合并文件
+    await chunkConcurrency.execute(path => pipe(path, stream));
+    // 结束传输
+    stream.end();
+    // 重命名临时文件
+    await rename(downloadedTempFile, dest);
+    await rm(dir, { recursive: true });
+    // 返回文件路径
+    return dest;
+}
+/**
+ *****************************************
+ * 下载分片
+ *****************************************
+ */
+async function downloadChunk(downloadChunkOptions) {
+    const { idx, start, end, url, dir, init, options, downloadedSize, totalSize } = downloadChunkOptions;
+    const path = 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 retry(options.retryTimes, () => downloadFile(path, url, requestInit, opts));
+}
+/**
+ *****************************************
+ * 生成下载 ID
+ *****************************************
+ */
+function generateDownloadID(url, options) {
+    const now = new Date();
+    now.setHours(0, 0, 0, 0);
+    return 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 join(tmpdir(), 'downloads', generateDownloadID(getDownloadURL(url), options));
+}
+/**
+ *****************************************
+ * 写入文件流
+ *****************************************
+ */
+function pipe(src, dest) {
+    return new Promise((resolve, reject) => {
+        const stream = 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 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 = 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 pipeline(stream, createWriteStream(downloadedTempFile));
+    await rename(downloadedTempFile, dest);
+    // 返回文件路径
+    return dest;
+}

package/esm/downloadFile.mjs

@@ -0,0 +1,81 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-14 10:51:52
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { download } from './download.mjs';
+/**
+ *****************************************
+ * 下载文件
+ *****************************************
+ */
+export async function downloadFile(dest, url) {
+    const print = stdout();
+    // 打印日志
+    console.log('[download]:', url);
+    // 下载文件
+    await download(dest, url, {
+        onProgress(size, total) {
+            if (size < total) {
+                print(`  -> ${((size / total) * 100).toFixed(2)}% (${format(size)}/${format(total)})`);
+            }
+            else {
+                print('[download]: done');
+            }
+        },
+    });
+}
+/**
+ *****************************************
+ * 格式化字节大小为易读格式（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) {
+        const now = Date.now();
+        if (content === progressContent || now - progressTime < 1000) {
+            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/esm/findUp.mjs

@@ -0,0 +1,33 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-31 09:32:31
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { dirname } from 'node:path';
+/**
+ *****************************************
+ * 向上查找
+ *****************************************
+ */
+export function findUp(from, handler) {
+    let latest = '';
+    let current = from;
+    // 遍历目录
+    while (current !== latest) {
+        const result = handler(current);
+        // 存在结果
+        if (result !== undefined) {
+            return result;
+        }
+        // 获取上级目录
+        latest = current;
+        current = dirname(current);
+    }
+}

package/esm/index.mjs

@@ -0,0 +1,26 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-31 09:11:10
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 导出接口
+ *****************************************
+ */
+export { resolve, join, isAbsolute } from 'node:path';
+export { relative, isRelative } from './relative.mjs';
+export { dirname } from './dirname.mjs';
+export { stat, isDir, isFile } from './stat.mjs';
+export { resolveFile } from './resolveFile.mjs';
+export { readFile } from './readFile.mjs';
+export { writeFile } from './writeFile.mjs';
+export { copy } from './copy.mjs';
+export { rm } from './rm.mjs';
+export { lookup } from './lookup.mjs';
+export { md5 } from './md5.mjs';
+export { json, jsonc } from './jsonc.mjs';
+export { findUp } from './findUp.mjs';
+export { download } from './download.mjs';

package/esm/jsonc.mjs

@@ -0,0 +1,29 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-31 10:16:56
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { stripComments } from './stripComments.mjs';
+/**
+ *****************************************
+ * 解析 JSON
+ *****************************************
+ */
+export function json(content) {
+    return JSON.parse(content);
+}
+/**
+ *****************************************
+ * 解析 JSONC
+ *****************************************
+ */
+export function jsonc(content) {
+    return JSON.parse(stripComments(content));
+}

package/esm/lookup.mjs

@@ -0,0 +1,48 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-29 20:56:24
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { resolve as resolvePath } from 'node:path';
+import { isFile } from './stat.mjs';
+import { dirname } from './dirname.mjs';
+/**
+ *****************************************
+ * 查找最近的文件
+ *****************************************
+ */
+export function lookup(name, options) {
+    const opts = { cache: new Map(), resolve: isFile, ...options };
+    const dir = opts.from ? resolvePath(opts.from) : process.cwd();
+    // 查找文件
+    return find(name, dir, opts);
+}
+/**
+ *****************************************
+ * 查找最近的文件
+ *****************************************
+ */
+function find(name, dir, options) {
+    const { cache, resolve } = options;
+    if (!dir) {
+        return;
+    }
+    // 解析路径
+    const path = resolvePath(dir, name);
+    if (cache.has(path)) {
+        return cache.get(path);
+    }
+    // 查找文件
+    const result = resolve(path, dir) || find(name, dirname(dir), options);
+    // 缓存结果
+    cache.set(path, result);
+    // 返回结果
+    return result;
+}