@node-minify/utils 9.0.1 → 10.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Rodolphe Stoclin
+Copyright (c) 2025 Rodolphe Stoclin
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -6,14 +6,79 @@
   <br>
   <a href="https://npmjs.org/package/@node-minify/utils"><img src="https://img.shields.io/npm/v/@node-minify/utils.svg"></a>
   <a href="https://npmjs.org/package/@node-minify/utils"><img src="https://img.shields.io/npm/dm/@node-minify/utils.svg"></a>
-  <a href="https://github.com/srod/node-minify/actions"><img alt="Build Status" src="https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fsrod%2Fnode-minify%2Fbadge%3Fref%3Ddevelop&style=flat" /></a>
-  <a href="https://codecov.io/gh/srod/node-minify"><img src="https://codecov.io/gh/srod/node-minify/branch/develop/graph/badge.svg"></a>
+  <a href="https://github.com/srod/node-minify/actions"><img alt="Build Status" src="https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fsrod%2Fnode-minify%2Fbadge%3Fref%3Dmain&style=flat" /></a>
+  <a href="https://codecov.io/gh/srod/node-minify"><img src="https://codecov.io/gh/srod/node-minify/branch/main/graph/badge.svg"></a>
 </p>
 
-# utils
+# @node-minify/utils
 
-`utils` is parts of [`node-minify`](https://github.com/srod/node-minify).
+Shared utilities for [`node-minify`](https://github.com/srod/node-minify) compressor packages.
+
+This package provides common file operations, argument building, and helper functions used internally by node-minify compressors.
+
+## Installation
+
+```bash
+npm install @node-minify/utils
+```
+
+## Exported Functions
+
+### File Operations
+
+| Function | Description |
+|----------|-------------|
+| `readFile(filePath)` | Read file contents as a string |
+| `writeFile({ file, content, index })` | Write content to a file |
+| `deleteFile(file)` | Delete a file from the filesystem |
+| `isValidFile(filePath)` | Check if a file exists and is readable |
+| `getContentFromFiles(settings)` | Read and concatenate content from multiple files |
+
+### File Size Utilities
+
+| Function | Description |
+|----------|-------------|
+| `getFilesizeInBytes(filePath)` | Get human-readable file size (e.g., "1.5 kB") |
+| `getFilesizeGzippedInBytes(content)` | Get human-readable gzipped size |
+| `prettyBytes(bytes)` | Format bytes as human-readable string |
+
+### Compression Helpers
+
+| Function | Description |
+|----------|-------------|
+| `compressSingleFile(settings)` | Compress a single file using the configured compressor |
+| `run(settings)` | Execute compression with the provided settings |
+| `buildArgs(options)` | Build command line arguments from options object |
+| `toBuildArgsOptions(options, definitions)` | Convert options to buildArgs format |
+| `setFileNameMin(file, output, publicFolder, replaceInPlace)` | Generate output filename from input |
+
+### Deprecation Warnings
+
+| Function | Description |
+|----------|-------------|
+| `warnDeprecation(packageName, message)` | Display a deprecation warning (once per package) |
+| `resetDeprecationWarnings()` | Reset warning state (useful for testing) |
+
+## Usage Example
+
+```ts
+import { readFile, writeFile, getFilesizeInBytes } from '@node-minify/utils';
+
+// Read a file
+const content = await readFile('src/app.js');
+
+// Write minified content
+await writeFile({
+  file: 'dist/app.min.js',
+  content: minifiedContent,
+  index: 0
+});
+
+// Get file size
+const size = await getFilesizeInBytes('dist/app.min.js');
+console.log(`Output size: ${size}`); // "Output size: 2.3 kB"
+```
 
 ## License
 
-[MIT](https://github.com/srod/node-minify/blob/develop/LICENSE)
+[MIT](https://github.com/srod/node-minify/blob/main/LICENSE)

package/dist/buildArgs.d.ts

@@ -0,0 +1,24 @@
+import { BuildArgsOptions } from "./types.js";
+
+//#region src/buildArgs.d.ts
+
+/**
+ * Converts a generic options object to BuildArgsOptions by filtering out non-primitive values.
+ * Only keeps string, number, boolean, and undefined values.
+ * @param options - Generic options object
+ * @returns Filtered options compatible with buildArgs
+ */
+declare function toBuildArgsOptions(options: Record<string, unknown>): BuildArgsOptions;
+/**
+ * Builds arguments array based on an object.
+ * @param options Object containing command line arguments
+ * @returns Array of command line arguments
+ * @throws {ValidationError} If options is null or undefined
+ * @example
+ * buildArgs({ compress: true, output: 'file.min.js' })
+ * // returns ['--compress', '--output', 'file.min.js']
+ */
+declare function buildArgs(options: BuildArgsOptions): string[];
+//#endregion
+export { buildArgs, toBuildArgsOptions };
+//# sourceMappingURL=buildArgs.d.ts.map

package/dist/buildArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildArgs.d.ts","names":[],"sources":["../src/buildArgs.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;iBAegB,kBAAA,UACH,0BACV;;;;;;;;;;iBAwBa,SAAA,UAAmB"}

package/dist/buildArgs.js

@@ -0,0 +1,43 @@
+import { n as ValidationError } from "./error-B_uK-F18.js";
+
+//#region src/buildArgs.ts
+/*!
+* node-minify
+* Copyright(c) 2011-2025 Rodolphe Stoclin
+* MIT Licensed
+*/
+/**
+* Converts a generic options object to BuildArgsOptions by filtering out non-primitive values.
+* Only keeps string, number, boolean, and undefined values.
+* @param options - Generic options object
+* @returns Filtered options compatible with buildArgs
+*/
+function toBuildArgsOptions(options) {
+	const result = {};
+	for (const [key, value] of Object.entries(options)) if (typeof value === "string" || typeof value === "number" || typeof value === "boolean" || value === void 0) result[key] = value;
+	return result;
+}
+/**
+* Builds arguments array based on an object.
+* @param options Object containing command line arguments
+* @returns Array of command line arguments
+* @throws {ValidationError} If options is null or undefined
+* @example
+* buildArgs({ compress: true, output: 'file.min.js' })
+* // returns ['--compress', '--output', 'file.min.js']
+*/
+function buildArgs(options) {
+	if (!options || typeof options !== "object") throw new ValidationError("Options must be a valid object");
+	const args = [];
+	Object.entries(options).forEach(([key, value]) => {
+		if (value !== void 0 && value !== false) {
+			args.push(`--${key}`);
+			if (value !== true) args.push(String(value));
+		}
+	});
+	return args;
+}
+
+//#endregion
+export { buildArgs, toBuildArgsOptions };
+//# sourceMappingURL=buildArgs.js.map

package/dist/buildArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildArgs.js","names":["result: BuildArgsOptions","args: string[]"],"sources":["../src/buildArgs.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { ValidationError } from \"./error.ts\";\nimport type { BuildArgsOptions } from \"./types.ts\";\n\n/**\n * Converts a generic options object to BuildArgsOptions by filtering out non-primitive values.\n * Only keeps string, number, boolean, and undefined values.\n * @param options - Generic options object\n * @returns Filtered options compatible with buildArgs\n */\nexport function toBuildArgsOptions(\n    options: Record<string, unknown>\n): BuildArgsOptions {\n    const result: BuildArgsOptions = {};\n    for (const [key, value] of Object.entries(options)) {\n        if (\n            typeof value === \"string\" ||\n            typeof value === \"number\" ||\n            typeof value === \"boolean\" ||\n            value === undefined\n        ) {\n            result[key] = value;\n        }\n    }\n    return result;\n}\n\n/**\n * Builds arguments array based on an object.\n * @param options Object containing command line arguments\n * @returns Array of command line arguments\n * @throws {ValidationError} If options is null or undefined\n * @example\n * buildArgs({ compress: true, output: 'file.min.js' })\n * // returns ['--compress', '--output', 'file.min.js']\n */\nexport function buildArgs(options: BuildArgsOptions): string[] {\n    if (!options || typeof options !== \"object\") {\n        throw new ValidationError(\"Options must be a valid object\");\n    }\n\n    const args: string[] = [];\n    Object.entries(options).forEach(([key, value]) => {\n        if (value !== undefined && value !== false) {\n            args.push(`--${key}`);\n            if (value !== true) {\n                args.push(String(value));\n            }\n        }\n    });\n\n    return args;\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,mBACZ,SACgB;CAChB,MAAMA,SAA2B,EAAE;AACnC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,CAC9C,KACI,OAAO,UAAU,YACjB,OAAO,UAAU,YACjB,OAAO,UAAU,aACjB,UAAU,OAEV,QAAO,OAAO;AAGtB,QAAO;;;;;;;;;;;AAYX,SAAgB,UAAU,SAAqC;AAC3D,KAAI,CAAC,WAAW,OAAO,YAAY,SAC/B,OAAM,IAAI,gBAAgB,iCAAiC;CAG/D,MAAMC,OAAiB,EAAE;AACzB,QAAO,QAAQ,QAAQ,CAAC,SAAS,CAAC,KAAK,WAAW;AAC9C,MAAI,UAAU,UAAa,UAAU,OAAO;AACxC,QAAK,KAAK,KAAK,MAAM;AACrB,OAAI,UAAU,KACV,MAAK,KAAK,OAAO,MAAM,CAAC;;GAGlC;AAEF,QAAO"}

package/dist/compressSingleFile.d.ts

@@ -0,0 +1,12 @@
+import { t as Settings } from "./types-DtDQlx-T.js";
+
+//#region src/compressSingleFile.d.ts
+
+/**
+ * Compress a single file.
+ * @param settings Settings
+ */
+declare function compressSingleFile(settings: Settings): Promise<string>;
+//#endregion
+export { compressSingleFile };
+//# sourceMappingURL=compressSingleFile.d.ts.map

package/dist/compressSingleFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressSingleFile.d.ts","names":[],"sources":["../src/compressSingleFile.ts"],"sourcesContent":[],"mappings":";;;;;;;;iBAcsB,kBAAA,WAA6B,WAAW"}

package/dist/compressSingleFile.js

@@ -0,0 +1,28 @@
+import { getContentFromFiles } from "./getContentFromFiles.js";
+import { run } from "./run.js";
+
+//#region src/compressSingleFile.ts
+/**
+* Compress a single file.
+* @param settings Settings
+*/
+async function compressSingleFile(settings) {
+	return run({
+		settings,
+		content: determineContent(settings)
+	});
+}
+/**
+* Determine the content to minify.
+* @param settings - Minification settings
+* @returns Content string to minify
+*/
+function determineContent(settings) {
+	if (settings.content) return settings.content;
+	if (settings.input) return getContentFromFiles(settings.input);
+	return "";
+}
+
+//#endregion
+export { compressSingleFile };
+//# sourceMappingURL=compressSingleFile.js.map

package/dist/compressSingleFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressSingleFile.js","names":[],"sources":["../src/compressSingleFile.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport type { Settings } from \"@node-minify/types\";\nimport { getContentFromFiles } from \"./getContentFromFiles.ts\";\nimport { run } from \"./run.ts\";\n\n/**\n * Compress a single file.\n * @param settings Settings\n */\nexport async function compressSingleFile(settings: Settings): Promise<string> {\n    const content = determineContent(settings);\n    return run({ settings, content });\n}\n\n/**\n * Determine the content to minify.\n * @param settings - Minification settings\n * @returns Content string to minify\n */\nfunction determineContent(settings: Settings): string {\n    if (settings.content) {\n        return settings.content;\n    }\n\n    if (settings.input) {\n        return getContentFromFiles(settings.input);\n    }\n\n    return \"\";\n}\n"],"mappings":";;;;;;;;AAcA,eAAsB,mBAAmB,UAAqC;AAE1E,QAAO,IAAI;EAAE;EAAU,SADP,iBAAiB,SAAS;EACV,CAAC;;;;;;;AAQrC,SAAS,iBAAiB,UAA4B;AAClD,KAAI,SAAS,QACT,QAAO,SAAS;AAGpB,KAAI,SAAS,MACT,QAAO,oBAAoB,SAAS,MAAM;AAG9C,QAAO"}

package/dist/deleteFile.d.ts

@@ -0,0 +1,17 @@
+//#region src/deleteFile.d.ts
+/*!
+ * node-minify
+ * Copyright(c) 2011-2025 Rodolphe Stoclin
+ * MIT Licensed
+ */
+/**
+ * Delete file from the filesystem.
+ * @param file Path to the file to delete
+ * @throws {FileOperationError} If file doesn't exist or deletion fails
+ * @example
+ * deleteFile('path/to/file.js')
+ */
+declare function deleteFile(file: string): void;
+//#endregion
+export { deleteFile };
+//# sourceMappingURL=deleteFile.d.ts.map

package/dist/deleteFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteFile.d.ts","names":[],"sources":["../src/deleteFile.ts"],"sourcesContent":[],"mappings":";;AAgBA;;;;;;;;;;;iBAAgB,UAAA"}

package/dist/deleteFile.js

@@ -0,0 +1,28 @@
+import { t as FileOperationError } from "./error-B_uK-F18.js";
+import { existsSync, unlinkSync } from "node:fs";
+
+//#region src/deleteFile.ts
+/*!
+* node-minify
+* Copyright(c) 2011-2025 Rodolphe Stoclin
+* MIT Licensed
+*/
+/**
+* Delete file from the filesystem.
+* @param file Path to the file to delete
+* @throws {FileOperationError} If file doesn't exist or deletion fails
+* @example
+* deleteFile('path/to/file.js')
+*/
+function deleteFile(file) {
+	try {
+		if (!existsSync(file)) throw new Error("File does not exist");
+		unlinkSync(file);
+	} catch (error) {
+		throw new FileOperationError("delete", file, error);
+	}
+}
+
+//#endregion
+export { deleteFile };
+//# sourceMappingURL=deleteFile.js.map

package/dist/deleteFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteFile.js","names":[],"sources":["../src/deleteFile.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { existsSync, unlinkSync } from \"node:fs\";\nimport { FileOperationError } from \"./error.ts\";\n\n/**\n * Delete file from the filesystem.\n * @param file Path to the file to delete\n * @throws {FileOperationError} If file doesn't exist or deletion fails\n * @example\n * deleteFile('path/to/file.js')\n */\nexport function deleteFile(file: string): void {\n    try {\n        if (!existsSync(file)) {\n            throw new Error(\"File does not exist\");\n        }\n        unlinkSync(file);\n    } catch (error) {\n        throw new FileOperationError(\"delete\", file, error as Error);\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAgB,WAAW,MAAoB;AAC3C,KAAI;AACA,MAAI,CAAC,WAAW,KAAK,CACjB,OAAM,IAAI,MAAM,sBAAsB;AAE1C,aAAW,KAAK;UACX,OAAO;AACZ,QAAM,IAAI,mBAAmB,UAAU,MAAM,MAAe"}

package/dist/deprecation.d.ts

@@ -0,0 +1,31 @@
+//#region src/deprecation.d.ts
+/*!
+ * node-minify
+ * Copyright(c) 2011-2025 Rodolphe Stoclin
+ * MIT Licensed
+ */
+/**
+ * Show a deprecation warning for a package, but only once per process.
+ * Subsequent calls with the same package name will be ignored.
+ *
+ * @param packageName - The package name (e.g., "babel-minify", "uglify-es")
+ * @param message - The deprecation message explaining why and what to use instead
+ *
+ * @example
+ * ```ts
+ * warnDeprecation(
+ *   "babel-minify",
+ *   "babel-minify uses Babel 6 which is no longer maintained. " +
+ *   "Please migrate to @node-minify/terser for continued support."
+ * );
+ * ```
+ */
+declare function warnDeprecation(packageName: string, message: string): void;
+/**
+ * Reset the deprecation warning state.
+ * Only intended for testing purposes.
+ */
+declare function resetDeprecationWarnings(): void;
+//#endregion
+export { resetDeprecationWarnings, warnDeprecation };
+//# sourceMappingURL=deprecation.d.ts.map

package/dist/deprecation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecation.d.ts","names":[],"sources":["../src/deprecation.ts"],"sourcesContent":[],"mappings":";;AAwBA;AAaA;;;;;;;;;;;;;;;;;;;iBAbgB,eAAA;;;;;iBAaA,wBAAA,CAAA"}

package/dist/deprecation.js

@@ -0,0 +1,39 @@
+//#region src/deprecation.ts
+/*!
+* node-minify
+* Copyright(c) 2011-2025 Rodolphe Stoclin
+* MIT Licensed
+*/
+const warnedPackages = /* @__PURE__ */ new Set();
+/**
+* Show a deprecation warning for a package, but only once per process.
+* Subsequent calls with the same package name will be ignored.
+*
+* @param packageName - The package name (e.g., "babel-minify", "uglify-es")
+* @param message - The deprecation message explaining why and what to use instead
+*
+* @example
+* ```ts
+* warnDeprecation(
+*   "babel-minify",
+*   "babel-minify uses Babel 6 which is no longer maintained. " +
+*   "Please migrate to @node-minify/terser for continued support."
+* );
+* ```
+*/
+function warnDeprecation(packageName, message) {
+	if (warnedPackages.has(packageName)) return;
+	warnedPackages.add(packageName);
+	console.warn(`[@node-minify/${packageName}] DEPRECATED: ${message}`);
+}
+/**
+* Reset the deprecation warning state.
+* Only intended for testing purposes.
+*/
+function resetDeprecationWarnings() {
+	warnedPackages.clear();
+}
+
+//#endregion
+export { resetDeprecationWarnings, warnDeprecation };
+//# sourceMappingURL=deprecation.js.map

package/dist/deprecation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecation.js","names":[],"sources":["../src/deprecation.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nconst warnedPackages = new Set<string>();\n\n/**\n * Show a deprecation warning for a package, but only once per process.\n * Subsequent calls with the same package name will be ignored.\n *\n * @param packageName - The package name (e.g., \"babel-minify\", \"uglify-es\")\n * @param message - The deprecation message explaining why and what to use instead\n *\n * @example\n * ```ts\n * warnDeprecation(\n *   \"babel-minify\",\n *   \"babel-minify uses Babel 6 which is no longer maintained. \" +\n *   \"Please migrate to @node-minify/terser for continued support.\"\n * );\n * ```\n */\nexport function warnDeprecation(packageName: string, message: string): void {\n    if (warnedPackages.has(packageName)) {\n        return;\n    }\n\n    warnedPackages.add(packageName);\n    console.warn(`[@node-minify/${packageName}] DEPRECATED: ${message}`);\n}\n\n/**\n * Reset the deprecation warning state.\n * Only intended for testing purposes.\n */\nexport function resetDeprecationWarnings(): void {\n    warnedPackages.clear();\n}\n"],"mappings":";;;;;;AAMA,MAAM,iCAAiB,IAAI,KAAa;;;;;;;;;;;;;;;;;AAkBxC,SAAgB,gBAAgB,aAAqB,SAAuB;AACxE,KAAI,eAAe,IAAI,YAAY,CAC/B;AAGJ,gBAAe,IAAI,YAAY;AAC/B,SAAQ,KAAK,iBAAiB,YAAY,gBAAgB,UAAU;;;;;;AAOxE,SAAgB,2BAAiC;AAC7C,gBAAe,OAAO"}

package/dist/error-B_uK-F18.js

@@ -0,0 +1,30 @@
+//#region src/error.ts
+/*!
+* node-minify
+* Copyright(c) 2011-2025 Rodolphe Stoclin
+* MIT Licensed
+*/
+/**
+* Error class for file operation failures.
+* @extends Error
+*/
+var FileOperationError = class extends Error {
+	constructor(operation, path, originalError) {
+		super(`Failed to ${operation} file ${path}: ${originalError?.message || ""}`);
+		this.name = "FileOperationError";
+	}
+};
+/**
+* Error class for validation failures.
+* @extends Error
+*/
+var ValidationError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "ValidationError";
+	}
+};
+
+//#endregion
+export { ValidationError as n, FileOperationError as t };
+//# sourceMappingURL=error-B_uK-F18.js.map

package/dist/error-B_uK-F18.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-B_uK-F18.js","names":[],"sources":["../src/error.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\n/**\n * Error class for file operation failures.\n * @extends Error\n */\nexport class FileOperationError extends Error {\n    constructor(operation: string, path: string, originalError?: Error) {\n        super(\n            `Failed to ${operation} file ${path}: ${originalError?.message || \"\"}`\n        );\n        this.name = \"FileOperationError\";\n    }\n}\n\n/**\n * Error class for validation failures.\n * @extends Error\n */\nexport class ValidationError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ValidationError\";\n    }\n}\n"],"mappings":";;;;;;;;;;AAUA,IAAa,qBAAb,cAAwC,MAAM;CAC1C,YAAY,WAAmB,MAAc,eAAuB;AAChE,QACI,aAAa,UAAU,QAAQ,KAAK,IAAI,eAAe,WAAW,KACrE;AACD,OAAK,OAAO;;;;;;;AAQpB,IAAa,kBAAb,cAAqC,MAAM;CACvC,YAAY,SAAiB;AACzB,QAAM,QAAQ;AACd,OAAK,OAAO"}

package/dist/error.d.ts

@@ -0,0 +1,23 @@
+//#region src/error.d.ts
+/*!
+ * node-minify
+ * Copyright(c) 2011-2025 Rodolphe Stoclin
+ * MIT Licensed
+ */
+/**
+ * Error class for file operation failures.
+ * @extends Error
+ */
+declare class FileOperationError extends Error {
+  constructor(operation: string, path: string, originalError?: Error);
+}
+/**
+ * Error class for validation failures.
+ * @extends Error
+ */
+declare class ValidationError extends Error {
+  constructor(message: string);
+}
+//#endregion
+export { FileOperationError, ValidationError };
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","names":[],"sources":["../src/error.ts"],"sourcesContent":[],"mappings":";;AAUA;AAaA;;;;;;;cAba,kBAAA,SAA2B,KAAA;+DACyB;;;;;;cAYpD,eAAA,SAAwB,KAAA"}

package/dist/error.js

@@ -0,0 +1,3 @@
+import { n as ValidationError, t as FileOperationError } from "./error-B_uK-F18.js";
+
+export { FileOperationError, ValidationError };

package/dist/getContentFromFiles.d.ts

@@ -0,0 +1,19 @@
+//#region src/getContentFromFiles.d.ts
+/*!
+ * node-minify
+ * Copyright(c) 2011-2025 Rodolphe Stoclin
+ * MIT Licensed
+ */
+/**
+ * Concatenate all input files and get the data.
+ * @param input Single file path or array of file paths
+ * @returns Concatenated content of all files
+ * @throws {FileOperationError} If any file operation fails
+ * @example
+ * getContentFromFiles('file.js')
+ * getContentFromFiles(['file1.js', 'file2.js'])
+ */
+declare function getContentFromFiles(input: string | string[]): string;
+//#endregion
+export { getContentFromFiles };
+//# sourceMappingURL=getContentFromFiles.d.ts.map

package/dist/getContentFromFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getContentFromFiles.d.ts","names":[],"sources":["../src/getContentFromFiles.ts"],"sourcesContent":[],"mappings":";;AAuCA;;;;;;;;;;;;;iBAAgB,mBAAA"}

package/dist/getContentFromFiles.js

@@ -0,0 +1,49 @@
+import { t as FileOperationError } from "./error-B_uK-F18.js";
+import { t as isValidFile } from "./isValidFile-UAwceQud.js";
+import { existsSync, readFileSync } from "node:fs";
+
+//#region src/getContentFromFiles.ts
+/*!
+* node-minify
+* Copyright(c) 2011-2025 Rodolphe Stoclin
+* MIT Licensed
+*/
+/**
+* Read content from a single file with error handling.
+* @param path Path to the file
+* @returns Content of the file
+* @throws {FileOperationError} If file doesn't exist or reading fails
+*/
+function readFileContent(path) {
+	try {
+		if (!existsSync(path)) throw new Error("File does not exist");
+		if (!isValidFile(path)) throw new Error("Path is not a valid file");
+		return readFileSync(path, "utf8");
+	} catch (error) {
+		throw new FileOperationError("read", path, error);
+	}
+}
+/**
+* Concatenate all input files and get the data.
+* @param input Single file path or array of file paths
+* @returns Concatenated content of all files
+* @throws {FileOperationError} If any file operation fails
+* @example
+* getContentFromFiles('file.js')
+* getContentFromFiles(['file1.js', 'file2.js'])
+*/
+function getContentFromFiles(input) {
+	try {
+		if (!input) throw new Error("Input must be a string or array of strings");
+		if (!Array.isArray(input)) return readFileContent(input);
+		if (input.length === 0) return "";
+		return input.map(readFileContent).join("\n");
+	} catch (error) {
+		if (error instanceof FileOperationError) throw error;
+		throw new Error(`Failed to process input files: ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+
+//#endregion
+export { getContentFromFiles };
+//# sourceMappingURL=getContentFromFiles.js.map

package/dist/getContentFromFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getContentFromFiles.js","names":["error: unknown"],"sources":["../src/getContentFromFiles.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { FileOperationError } from \"./error.ts\";\nimport { isValidFile } from \"./isValidFile.ts\";\n\n/**\n * Read content from a single file with error handling.\n * @param path Path to the file\n * @returns Content of the file\n * @throws {FileOperationError} If file doesn't exist or reading fails\n */\nfunction readFileContent(path: string): string {\n    try {\n        if (!existsSync(path)) {\n            throw new Error(\"File does not exist\");\n        }\n        if (!isValidFile(path)) {\n            throw new Error(\"Path is not a valid file\");\n        }\n        return readFileSync(path, \"utf8\");\n    } catch (error) {\n        throw new FileOperationError(\"read\", path, error as Error);\n    }\n}\n\n/**\n * Concatenate all input files and get the data.\n * @param input Single file path or array of file paths\n * @returns Concatenated content of all files\n * @throws {FileOperationError} If any file operation fails\n * @example\n * getContentFromFiles('file.js')\n * getContentFromFiles(['file1.js', 'file2.js'])\n */\nexport function getContentFromFiles(input: string | string[]): string {\n    try {\n        if (!input) {\n            throw new Error(\"Input must be a string or array of strings\");\n        }\n\n        if (!Array.isArray(input)) {\n            return readFileContent(input);\n        }\n\n        if (input.length === 0) {\n            return \"\";\n        }\n\n        return input.map(readFileContent).join(\"\\n\");\n    } catch (error: unknown) {\n        if (error instanceof FileOperationError) {\n            throw error;\n        }\n        throw new Error(\n            `Failed to process input files: ${error instanceof Error ? error.message : String(error)}`\n        );\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAS,gBAAgB,MAAsB;AAC3C,KAAI;AACA,MAAI,CAAC,WAAW,KAAK,CACjB,OAAM,IAAI,MAAM,sBAAsB;AAE1C,MAAI,CAAC,YAAY,KAAK,CAClB,OAAM,IAAI,MAAM,2BAA2B;AAE/C,SAAO,aAAa,MAAM,OAAO;UAC5B,OAAO;AACZ,QAAM,IAAI,mBAAmB,QAAQ,MAAM,MAAe;;;;;;;;;;;;AAalE,SAAgB,oBAAoB,OAAkC;AAClE,KAAI;AACA,MAAI,CAAC,MACD,OAAM,IAAI,MAAM,6CAA6C;AAGjE,MAAI,CAAC,MAAM,QAAQ,MAAM,CACrB,QAAO,gBAAgB,MAAM;AAGjC,MAAI,MAAM,WAAW,EACjB,QAAO;AAGX,SAAO,MAAM,IAAI,gBAAgB,CAAC,KAAK,KAAK;UACvCA,OAAgB;AACrB,MAAI,iBAAiB,mBACjB,OAAM;AAEV,QAAM,IAAI,MACN,kCAAkC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAC3F"}

package/dist/getFilesizeGzippedInBytes.d.ts

@@ -0,0 +1,19 @@
+//#region src/getFilesizeGzippedInBytes.d.ts
+/*!
+ * node-minify
+ * Copyright(c) 2011-2025 Rodolphe Stoclin
+ * MIT Licensed
+ */
+/**
+ * Get the gzipped file size as a human-readable string.
+ * @param file - Path to the file
+ * @returns Formatted gzipped file size string (e.g., "1.5 kB")
+ * @throws {FileOperationError} If file doesn't exist or operation fails
+ * @example
+ * const size = await getFilesizeGzippedInBytes('file.js')
+ * console.log(size) // '1.5 kB'
+ */
+declare function getFilesizeGzippedInBytes(file: string): Promise<string>;
+//#endregion
+export { getFilesizeGzippedInBytes };
+//# sourceMappingURL=getFilesizeGzippedInBytes.d.ts.map

package/dist/getFilesizeGzippedInBytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFilesizeGzippedInBytes.d.ts","names":[],"sources":["../src/getFilesizeGzippedInBytes.ts"],"sourcesContent":[],"mappings":";;AAoBA;;;;;;;;;;;;;iBAAsB,yBAAA,gBAAyC"}

package/dist/getFilesizeGzippedInBytes.js

@@ -0,0 +1,37 @@
+import { t as FileOperationError } from "./error-B_uK-F18.js";
+import { t as isValidFile } from "./isValidFile-UAwceQud.js";
+import { prettyBytes } from "./prettyBytes.js";
+import { createReadStream, existsSync } from "node:fs";
+
+//#region src/getFilesizeGzippedInBytes.ts
+/*!
+* node-minify
+* Copyright(c) 2011-2025 Rodolphe Stoclin
+* MIT Licensed
+*/
+/**
+* Get the gzipped file size as a human-readable string.
+* @param file - Path to the file
+* @returns Formatted gzipped file size string (e.g., "1.5 kB")
+* @throws {FileOperationError} If file doesn't exist or operation fails
+* @example
+* const size = await getFilesizeGzippedInBytes('file.js')
+* console.log(size) // '1.5 kB'
+*/
+async function getFilesizeGzippedInBytes(file) {
+	try {
+		if (!existsSync(file)) throw new FileOperationError("access", file, /* @__PURE__ */ new Error("File does not exist"));
+		if (!isValidFile(file)) throw new FileOperationError("access", file, /* @__PURE__ */ new Error("Path is not a valid file"));
+		const { gzipSizeStream } = await import("gzip-size");
+		const source = createReadStream(file);
+		return prettyBytes(await new Promise((resolve, reject) => {
+			source.pipe(gzipSizeStream()).on("gzip-size", resolve).on("error", reject);
+		}));
+	} catch (error) {
+		throw new FileOperationError("get gzipped size of", file, error);
+	}
+}
+
+//#endregion
+export { getFilesizeGzippedInBytes };
+//# sourceMappingURL=getFilesizeGzippedInBytes.js.map

package/dist/getFilesizeGzippedInBytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFilesizeGzippedInBytes.js","names":[],"sources":["../src/getFilesizeGzippedInBytes.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { createReadStream, existsSync } from \"node:fs\";\nimport { FileOperationError } from \"./error.ts\";\nimport { isValidFile } from \"./isValidFile.ts\";\nimport { prettyBytes } from \"./prettyBytes.ts\";\n\n/**\n * Get the gzipped file size as a human-readable string.\n * @param file - Path to the file\n * @returns Formatted gzipped file size string (e.g., \"1.5 kB\")\n * @throws {FileOperationError} If file doesn't exist or operation fails\n * @example\n * const size = await getFilesizeGzippedInBytes('file.js')\n * console.log(size) // '1.5 kB'\n */\nexport async function getFilesizeGzippedInBytes(file: string): Promise<string> {\n    try {\n        if (!existsSync(file)) {\n            throw new FileOperationError(\n                \"access\",\n                file,\n                new Error(\"File does not exist\")\n            );\n        }\n\n        if (!isValidFile(file)) {\n            throw new FileOperationError(\n                \"access\",\n                file,\n                new Error(\"Path is not a valid file\")\n            );\n        }\n\n        const { gzipSizeStream } = await import(\"gzip-size\");\n        const source = createReadStream(file);\n\n        const size = await new Promise<number>((resolve, reject) => {\n            source\n                .pipe(gzipSizeStream())\n                .on(\"gzip-size\", resolve)\n                .on(\"error\", reject);\n        });\n\n        return prettyBytes(size);\n    } catch (error) {\n        throw new FileOperationError(\n            \"get gzipped size of\",\n            file,\n            error as Error\n        );\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,eAAsB,0BAA0B,MAA+B;AAC3E,KAAI;AACA,MAAI,CAAC,WAAW,KAAK,CACjB,OAAM,IAAI,mBACN,UACA,sBACA,IAAI,MAAM,sBAAsB,CACnC;AAGL,MAAI,CAAC,YAAY,KAAK,CAClB,OAAM,IAAI,mBACN,UACA,sBACA,IAAI,MAAM,2BAA2B,CACxC;EAGL,MAAM,EAAE,mBAAmB,MAAM,OAAO;EACxC,MAAM,SAAS,iBAAiB,KAAK;AASrC,SAAO,YAPM,MAAM,IAAI,SAAiB,SAAS,WAAW;AACxD,UACK,KAAK,gBAAgB,CAAC,CACtB,GAAG,aAAa,QAAQ,CACxB,GAAG,SAAS,OAAO;IAC1B,CAEsB;UACnB,OAAO;AACZ,QAAM,IAAI,mBACN,uBACA,MACA,MACH"}

package/dist/getFilesizeInBytes.d.ts

@@ -0,0 +1,17 @@
+//#region src/getFilesizeInBytes.d.ts
+/*!
+ * node-minify
+ * Copyright(c) 2011-2025 Rodolphe Stoclin
+ * MIT Licensed
+ */
+/**
+ * Get the file size as a human-readable string.
+ * @param file - Path to the file
+ * @returns Formatted file size string (e.g., "1.34 kB")
+ * @example
+ * getFilesizeInBytes('bundle.js') // '45.2 kB'
+ */
+declare const getFilesizeInBytes: (file: string) => string;
+//#endregion
+export { getFilesizeInBytes };
+//# sourceMappingURL=getFilesizeInBytes.d.ts.map

package/dist/getFilesizeInBytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFilesizeInBytes.d.ts","names":[],"sources":["../src/getFilesizeInBytes.ts"],"sourcesContent":[],"mappings":";;AAgBA;;;;;;;;;;;cAAa"}

package/dist/getFilesizeInBytes.js

@@ -0,0 +1,24 @@
+import { prettyBytes } from "./prettyBytes.js";
+import { statSync } from "node:fs";
+
+//#region src/getFilesizeInBytes.ts
+/*!
+* node-minify
+* Copyright(c) 2011-2025 Rodolphe Stoclin
+* MIT Licensed
+*/
+/**
+* Get the file size as a human-readable string.
+* @param file - Path to the file
+* @returns Formatted file size string (e.g., "1.34 kB")
+* @example
+* getFilesizeInBytes('bundle.js') // '45.2 kB'
+*/
+const getFilesizeInBytes = (file) => {
+	const fileSizeInBytes = statSync(file).size;
+	return prettyBytes(fileSizeInBytes);
+};
+
+//#endregion
+export { getFilesizeInBytes };
+//# sourceMappingURL=getFilesizeInBytes.js.map

package/dist/getFilesizeInBytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFilesizeInBytes.js","names":[],"sources":["../src/getFilesizeInBytes.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { statSync } from \"node:fs\";\nimport { prettyBytes } from \"./prettyBytes.ts\";\n\n/**\n * Get the file size as a human-readable string.\n * @param file - Path to the file\n * @returns Formatted file size string (e.g., \"1.34 kB\")\n * @example\n * getFilesizeInBytes('bundle.js') // '45.2 kB'\n */\nexport const getFilesizeInBytes = (file: string): string => {\n    const stats = statSync(file);\n    const fileSizeInBytes = stats.size;\n    return prettyBytes(fileSizeInBytes);\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,MAAa,sBAAsB,SAAyB;CAExD,MAAM,kBADQ,SAAS,KAAK,CACE;AAC9B,QAAO,YAAY,gBAAgB"}