@ainc/fs 0.1.23 → 0.1.24

package/dist/download.js

@@ -20,6 +20,7 @@ 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 promises_3 = require("./promises");
 const concurrency_1 = require("./concurrency");
 /**
  *****************************************
@@ -52,7 +53,7 @@ async function download(dest, url, options = {}) {
  *****************************************
  */
 async function downloadFileByChunk(dest, url, init, options) {
-    const stats = await (0, promises_1.stat)(dest).catch(err => err.code === 'ENOENT' ? null : Promise.reject(err));
+    const stats = await (0, promises_3.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);
@@ -93,7 +94,7 @@ async function downloadFileByChunk(dest, url, init, options) {
     // 创建下载目录
     await (0, promises_1.mkdir)(dir, { recursive: true });
     // 合并文件
-    await chunkConcurrency.execute(path => pipe(path, stream));
+    await chunkConcurrency.execute(path => (0, promises_3.pipe)((0, node_fs_1.createReadStream)(path), stream, { end: false }));
     // 结束传输
     stream.end();
     // 重命名临时文件
@@ -156,26 +157,13 @@ function getDownloadURL(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));
+    const stats = await (0, promises_3.stat)(dest);
     // 已经存在文件，不再下载
     if (stats && stats.isFile() && !options.force) {
         options.onProgress && options.onProgress(stats.size, stats.size);

package/dist/gzip.d.ts

@@ -0,0 +1,13 @@
+import { ZlibOptions } from 'node:zlib';
+/**
+ *****************************************
+ * gzip
+ *****************************************
+ */
+export declare function gzip(src: string, dest: string, options?: ZlibOptions): Promise<string>;
+/**
+ *****************************************
+ * ungzip
+ *****************************************
+ */
+export declare function ungzip(src: string, dest: string, options?: ZlibOptions): Promise<string>;

package/dist/gzip.js

@@ -0,0 +1,50 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-20 23:07:36
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gzip = gzip;
+exports.ungzip = ungzip;
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+const node_fs_1 = require("node:fs");
+const node_zlib_1 = require("node:zlib");
+const promises_1 = require("./promises");
+/**
+ *****************************************
+ * gzip
+ *****************************************
+ */
+function gzip(src, dest, options) {
+    return new Promise((resolve, reject) => {
+        const readable = (0, node_fs_1.createReadStream)(src);
+        const gzip = (0, node_zlib_1.createGzip)(options);
+        const writable = (0, node_fs_1.createWriteStream)(dest);
+        readable.pipe(gzip)
+            .pipe(writable)
+            .once('finish', () => resolve(dest))
+            .once('error', err => (0, promises_1.rm)(dest).then(() => reject(err)));
+    });
+}
+/**
+ *****************************************
+ * ungzip
+ *****************************************
+ */
+function ungzip(src, dest, options) {
+    return new Promise((resolve, reject) => {
+        const readable = (0, node_fs_1.createReadStream)(src);
+        const gzip = (0, node_zlib_1.createGunzip)(options);
+        const writable = (0, node_fs_1.createWriteStream)(dest);
+        readable.pipe(gzip)
+            .pipe(writable)
+            .once('finish', () => resolve(dest))
+            .once('error', err => (0, promises_1.rm)(dest).then(() => reject(err)));
+    });
+}

package/dist/index.d.ts

@@ -41,7 +41,7 @@ export { md5 } from './md5';
 export { json, jsonc } from './jsonc';
 export { findUp } from './findUp';
 export { download } from './download';
-export { downloadFile } from './downloadFile';
+export { gzip, ungzip } from './gzip';
 export { loadPackageDescription, resolvePackageDescription } from './loadPackageDescription';
 export { loadTsConfig, loadCompilerOptions, resolveTsConfig } from './loadTsConfig';
 export { resolveAlias, resolveDict } from './resolveAlias';

package/dist/index.exports.json

@@ -19,7 +19,7 @@
     {"path": "./jsonc", "names": ["json", "jsonc"]},
     {"path": "./findUp", "names": ["findUp"]},
     {"path": "./download", "names": ["download"]},
-    {"path": "./downloadFile", "names": ["downloadFile"]},
+    {"path": "./gzip", "names": ["gzip", "ungzip"]},
     {"path": "./loadPackageDescription", "names": ["loadPackageDescription", "resolvePackageDescription"]},
     {"path": "./loadTsConfig", "names": ["loadTsConfig", "loadCompilerOptions", "resolveTsConfig"]},
     {"path": "./resolveAlias", "names": ["resolveAlias", "resolveDict"]},

package/dist/index.js

@@ -6,7 +6,7 @@
  */
 'use strict';
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveModuleId = exports.resolveModuleDirs = exports.resolveModuleDir = exports.resolveExports = exports.resolveImports = exports.resolveDirect = exports.resolveFile = exports.resolvePath = exports.resolvePaths = exports.resolveDict = exports.resolveAlias = exports.resolveTsConfig = exports.loadCompilerOptions = exports.loadTsConfig = exports.resolvePackageDescription = exports.loadPackageDescription = exports.downloadFile = exports.download = exports.findUp = exports.jsonc = exports.json = exports.md5 = exports.lookup = exports.rm = exports.copy = exports.writeFile = exports.readFile = exports.isFile = exports.isDir = exports.stat = exports.isEsmPackage = exports.isEsmFile = exports.isEsmModule = exports.dirname = exports.isRelative = exports.relative = exports.isAbsolute = exports.join = exports.resolve = exports.Dict = exports.retry = exports.cache = exports.split = exports.match = exports.nil = exports.noop = exports.unary = exports.sys = void 0;
+exports.resolveModuleId = exports.resolveModuleDirs = exports.resolveModuleDir = exports.resolveExports = exports.resolveImports = exports.resolveDirect = exports.resolveFile = exports.resolvePath = exports.resolvePaths = exports.resolveDict = exports.resolveAlias = exports.resolveTsConfig = exports.loadCompilerOptions = exports.loadTsConfig = exports.resolvePackageDescription = exports.loadPackageDescription = exports.ungzip = exports.gzip = exports.download = exports.findUp = exports.jsonc = exports.json = exports.md5 = exports.lookup = exports.rm = exports.copy = exports.writeFile = exports.readFile = exports.isFile = exports.isDir = exports.stat = exports.isEsmPackage = exports.isEsmFile = exports.isEsmModule = exports.dirname = exports.isRelative = exports.relative = exports.isAbsolute = exports.join = exports.resolve = exports.Dict = exports.retry = exports.cache = exports.split = exports.match = exports.nil = exports.noop = exports.unary = exports.sys = void 0;
 /**
  *****************************************
  * 文件系统
@@ -73,8 +73,9 @@ 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; } });
-var downloadFile_1 = require("./downloadFile");
-Object.defineProperty(exports, "downloadFile", { enumerable: true, get: function () { return downloadFile_1.downloadFile; } });
+var gzip_1 = require("./gzip");
+Object.defineProperty(exports, "gzip", { enumerable: true, get: function () { return gzip_1.gzip; } });
+Object.defineProperty(exports, "ungzip", { enumerable: true, get: function () { return gzip_1.ungzip; } });
 var loadPackageDescription_1 = require("./loadPackageDescription");
 Object.defineProperty(exports, "loadPackageDescription", { enumerable: true, get: function () { return loadPackageDescription_1.loadPackageDescription; } });
 Object.defineProperty(exports, "resolvePackageDescription", { enumerable: true, get: function () { return loadPackageDescription_1.resolvePackageDescription; } });

package/dist/promises.d.ts

@@ -0,0 +1,69 @@
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { Readable, Writable, PipeOptions } from 'node:stream';
+import { Mode, RmOptions, StatOptions as IStatOptions } from 'node:fs';
+/**
+ *****************************************
+ * 状态选项
+ *****************************************
+ */
+export interface StatOptions extends IStatOptions {
+    bigint?: false | undefined;
+}
+/**
+ *****************************************
+ * 获取文件状态
+ *****************************************
+ */
+export declare function stat(path: string, options?: StatOptions): Promise<import("node:fs").Stats | null>;
+/**
+ *****************************************
+ * 删除文件
+ *****************************************
+ */
+export declare function rm(path: string, options?: RmOptions): Promise<void>;
+/**
+ *****************************************
+ * 选项
+ *****************************************
+ */
+export interface MkdirOptions {
+    force?: boolean;
+    mode?: Mode | undefined;
+    recursive?: boolean;
+}
+/**
+ *****************************************
+ * 创建文件目录
+ *****************************************
+ */
+export declare function mkdir(path: string, options?: MkdirOptions): Promise<boolean>;
+/**
+ *****************************************
+ * pipe
+ *****************************************
+ */
+export declare function pipe(src: Readable, dest: Writable, options?: PipeOptions): Promise<unknown>;
+/**
+ *****************************************
+ * 读取文件
+ *****************************************
+ */
+export declare function readFile(path: string): Promise<string | undefined>;
+/**
+ *****************************************
+ * 选项
+ *****************************************
+ */
+export interface WriteFileOptions {
+    force?: boolean;
+}
+/**
+ *****************************************
+ * 写入文件
+ *****************************************
+ */
+export declare function writeFile(path: string, content: string, options?: WriteFileOptions): Promise<boolean>;

package/dist/promises.js

@@ -0,0 +1,103 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-21 12:37:59
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stat = stat;
+exports.rm = rm;
+exports.mkdir = mkdir;
+exports.pipe = pipe;
+exports.readFile = readFile;
+exports.writeFile = writeFile;
+const node_path_1 = require("node:path");
+const fs = require("node:fs/promises");
+/**
+ *****************************************
+ * 获取文件状态
+ *****************************************
+ */
+async function stat(path, options) {
+    return fs.stat(path, options).catch(err => err.code === 'ENOENT' ? null : Promise.reject(err));
+}
+/**
+ *****************************************
+ * 删除文件
+ *****************************************
+ */
+async function rm(path, options) {
+    if (await stat(path)) {
+        await fs.rm(path, { force: true, recursive: true, ...options });
+    }
+}
+/**
+ *****************************************
+ * 创建文件目录
+ *****************************************
+ */
+async function mkdir(path, options) {
+    const stats = await stat(path);
+    const opts = { recursive: true, ...options };
+    // 创建目录
+    if (!stats) {
+        await fs.mkdir(path, opts);
+        return true;
+    }
+    else if (stats.isDirectory()) {
+        return true;
+    }
+    else if (!opts.force) {
+        return false;
+    }
+    else {
+        await fs.unlink(path);
+        await fs.mkdir(path, opts);
+        return true;
+    }
+}
+/**
+ *****************************************
+ * pipe
+ *****************************************
+ */
+async function pipe(src, dest, options) {
+    return new Promise((resolve, reject) => {
+        src.once('close', resolve);
+        src.once('error', reject);
+        src.pipe(dest, options);
+    });
+}
+/**
+ *****************************************
+ * 读取文件
+ *****************************************
+ */
+async function readFile(path) {
+    const stats = await stat(path);
+    if (stats && !stats.isDirectory()) {
+        return fs.readFile(path, 'utf8');
+    }
+}
+/**
+ *****************************************
+ * 写入文件
+ *****************************************
+ */
+async function writeFile(path, content, options) {
+    const stats = await stat(path);
+    if (stats) {
+        if (!options || !options.force) {
+            return false;
+        }
+        else {
+            await rm(path);
+        }
+    }
+    // 写入文件内容
+    await fs.mkdir((0, node_path_1.dirname)(path), { recursive: true });
+    await fs.writeFile(path, content);
+    // 返回结果
+    return true;
+}

package/esm/download.mjs

@@ -12,12 +12,13 @@
  */
 import { tmpdir } from 'node:os';
 import { resolve, join, dirname } from 'node:path';
-import { stat, mkdir, rm, rename } from 'node:fs/promises';
+import { 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 { stat, pipe } from './promises.mjs';
 import { Concurrency } from './concurrency.mjs';
 /**
  *****************************************
@@ -91,7 +92,7 @@ async function downloadFileByChunk(dest, url, init, options) {
     // 创建下载目录
     await mkdir(dir, { recursive: true });
     // 合并文件
-    await chunkConcurrency.execute(path => pipe(path, stream));
+    await chunkConcurrency.execute(path => pipe(createReadStream(path), stream, { end: false }));
     // 结束传输
     stream.end();
     // 重命名临时文件
@@ -154,26 +155,13 @@ function getDownloadURL(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));
+    const stats = await stat(dest);
     // 已经存在文件，不再下载
     if (stats && stats.isFile() && !options.force) {
         options.onProgress && options.onProgress(stats.size, stats.size);

package/esm/gzip.mjs

@@ -0,0 +1,47 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-20 23:07:36
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { createReadStream, createWriteStream } from 'node:fs';
+import { createGzip, createGunzip } from 'node:zlib';
+import { rm } from './promises.mjs';
+/**
+ *****************************************
+ * gzip
+ *****************************************
+ */
+export function gzip(src, dest, options) {
+    return new Promise((resolve, reject) => {
+        const readable = createReadStream(src);
+        const gzip = createGzip(options);
+        const writable = createWriteStream(dest);
+        readable.pipe(gzip)
+            .pipe(writable)
+            .once('finish', () => resolve(dest))
+            .once('error', err => rm(dest).then(() => reject(err)));
+    });
+}
+/**
+ *****************************************
+ * ungzip
+ *****************************************
+ */
+export function ungzip(src, dest, options) {
+    return new Promise((resolve, reject) => {
+        const readable = createReadStream(src);
+        const gzip = createGunzip(options);
+        const writable = createWriteStream(dest);
+        readable.pipe(gzip)
+            .pipe(writable)
+            .once('finish', () => resolve(dest))
+            .once('error', err => rm(dest).then(() => reject(err)));
+    });
+}

package/esm/index.exports.json

@@ -19,7 +19,7 @@
     {"path": "./jsonc", "names": ["json", "jsonc"]},
     {"path": "./findUp", "names": ["findUp"]},
     {"path": "./download", "names": ["download"]},
-    {"path": "./downloadFile", "names": ["downloadFile"]},
+    {"path": "./gzip", "names": ["gzip", "ungzip"]},
     {"path": "./loadPackageDescription", "names": ["loadPackageDescription", "resolvePackageDescription"]},
     {"path": "./loadTsConfig", "names": ["loadTsConfig", "loadCompilerOptions", "resolveTsConfig"]},
     {"path": "./resolveAlias", "names": ["resolveAlias", "resolveDict"]},

package/esm/index.mjs

@@ -40,7 +40,7 @@ export { md5 } from './md5.mjs';
 export { json, jsonc } from './jsonc.mjs';
 export { findUp } from './findUp.mjs';
 export { download } from './download.mjs';
-export { downloadFile } from './downloadFile.mjs';
+export { gzip, ungzip } from './gzip.mjs';
 export { loadPackageDescription, resolvePackageDescription } from './loadPackageDescription.mjs';
 export { loadTsConfig, loadCompilerOptions, resolveTsConfig } from './loadTsConfig.mjs';
 export { resolveAlias, resolveDict } from './resolveAlias.mjs';

package/esm/promises.mjs

@@ -0,0 +1,96 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-21 12:37:59
+ *****************************************
+ */
+'use strict';
+import { dirname } from 'node:path';
+import * as fs from 'node:fs/promises';
+/**
+ *****************************************
+ * 获取文件状态
+ *****************************************
+ */
+export async function stat(path, options) {
+    return fs.stat(path, options).catch(err => err.code === 'ENOENT' ? null : Promise.reject(err));
+}
+/**
+ *****************************************
+ * 删除文件
+ *****************************************
+ */
+export async function rm(path, options) {
+    if (await stat(path)) {
+        await fs.rm(path, { force: true, recursive: true, ...options });
+    }
+}
+/**
+ *****************************************
+ * 创建文件目录
+ *****************************************
+ */
+export async function mkdir(path, options) {
+    const stats = await stat(path);
+    const opts = { recursive: true, ...options };
+    // 创建目录
+    if (!stats) {
+        await fs.mkdir(path, opts);
+        return true;
+    }
+    else if (stats.isDirectory()) {
+        return true;
+    }
+    else if (!opts.force) {
+        return false;
+    }
+    else {
+        await fs.unlink(path);
+        await fs.mkdir(path, opts);
+        return true;
+    }
+}
+/**
+ *****************************************
+ * pipe
+ *****************************************
+ */
+export async function pipe(src, dest, options) {
+    return new Promise((resolve, reject) => {
+        src.once('close', resolve);
+        src.once('error', reject);
+        src.pipe(dest, options);
+    });
+}
+/**
+ *****************************************
+ * 读取文件
+ *****************************************
+ */
+export async function readFile(path) {
+    const stats = await stat(path);
+    if (stats && !stats.isDirectory()) {
+        return fs.readFile(path, 'utf8');
+    }
+}
+/**
+ *****************************************
+ * 写入文件
+ *****************************************
+ */
+export async function writeFile(path, content, options) {
+    const stats = await stat(path);
+    if (stats) {
+        if (!options || !options.force) {
+            return false;
+        }
+        else {
+            await rm(path);
+        }
+    }
+    // 写入文件内容
+    await fs.mkdir(dirname(path), { recursive: true });
+    await fs.writeFile(path, content);
+    // 返回结果
+    return true;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainc/fs",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Let's do something nice with @ainc/esb!",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
@@ -32,15 +32,13 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "typescript": "^5.9.3"
-  },
   "devDependencies": {
     "@jest/globals": "30.2.0",
     "@swc/core": "^1.15.8",
     "@swc/jest": "^0.2.39",
     "@types/node": "^25.0.3",
-    "jest": "^30.2.0"
+    "jest": "^30.2.0",
+    "typescript": "^5.9.3"
   },
   "scripts": {
     "build": "pnpm clean && pnpm compile && pnpm esm && pnpm exports",