@kikiutils/shared 14.0.0 → 14.1.0

package/dist/buffer.d.ts

@@ -4,34 +4,33 @@ import { Buffer } from "node:buffer";
 //#region src/buffer.d.ts
 
 /**
- * Converts a Blob, Buffer, or File to a Buffer.
+ * Converts various binary data types to a Node.js Buffer.
  *
- * This function provides a unified way to convert various binary data types
- * to Node.js Buffer. If the input is already a Buffer, it returns it as-is.
- * For Blob or File inputs, it converts them to Buffer via ArrayBuffer.
+ * This function provides a unified, efficient way to convert different binary formats
+ * (Blob, Buffer, File, ArrayBuffer, or Uint8Array) into a Node.js Buffer.
+ * It prioritizes zero-copy conversions for TypedArrays and ArrayBuffers to ensure
+ * optimal performance.
  *
- * @param {Blob | Buffer | File} input - The input to convert to Buffer
+ * @param {ArrayBuffer | Blob | Buffer | File | Uint8Array} input - The binary data input to convert.
+ * Supports Blob, Buffer, File, ArrayBuffer, and Uint8Array.
  *
- * @returns {Promise<Buffer>} A Promise that resolves to a Buffer
+ * @returns {Promise<Buffer>} A promise that resolves to a Node.js Buffer.
  *
  * @example
  * ```typescript
- * import { toBuffer } from '@kikiutils/shared/general';
+ * import { toBuffer } from '@kikiutils/shared/buffer';
  *
- * // Convert a Buffer (returns as-is)
- * const buffer = Buffer.from('Hello World');
- * const result1 = await toBuffer(buffer);
- * console.log(result1); // <Buffer 48 65 6c 6c 6f 20 57 6f 72 6c 64>
+ * // From ArrayBuffer
+ * const ab = new ArrayBuffer(8);
+ * const bufferFromAB = await toBuffer(ab);
  *
- * // Convert a Blob
- * const blob = new Blob(['Hello from Blob'], { type: 'text/plain' });
- * const result2 = await toBuffer(blob);
- * console.log(result2.toString()); // 'Hello from Blob'
+ * // From Uint8Array (Zero-copy)
+ * const u8 = new Uint8Array([10, 20, 30]);
+ * const bufferFromU8 = await toBuffer(u8);
  *
- * // Convert a File
- * const file = new File(['File content'], 'test.txt', { type: 'text/plain' });
- * const result3 = await toBuffer(file);
- * console.log(result3.toString()); // 'File content'
+ * // From Blob or File
+ * const blob = new Blob(['data'], { type: 'text/plain' });
+ * const bufferFromBlob = await toBuffer(blob);
  * ```
  */
 declare function toBuffer(input: BinaryInput): Promise<Buffer<ArrayBufferLike>>;

package/dist/buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buffer.d.ts","names":[],"sources":["../src/buffer.ts"],"sourcesContent":[],"mappings":";;;;;;;AAmCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAsB,QAAA,QAAgB,cAAW,QAAA,OAAA"}
+{"version":3,"file":"buffer.d.ts","names":[],"sources":["../src/buffer.ts"],"sourcesContent":[],"mappings":";;;;;;;AAkCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAsB,QAAA,QAAgB,cAAW,QAAA,OAAA"}

package/dist/buffer.js

@@ -2,39 +2,41 @@ import { Buffer } from "node:buffer";
 
 //#region src/buffer.ts
 /**
-* Converts a Blob, Buffer, or File to a Buffer.
+* Converts various binary data types to a Node.js Buffer.
 *
-* This function provides a unified way to convert various binary data types
-* to Node.js Buffer. If the input is already a Buffer, it returns it as-is.
-* For Blob or File inputs, it converts them to Buffer via ArrayBuffer.
+* This function provides a unified, efficient way to convert different binary formats
+* (Blob, Buffer, File, ArrayBuffer, or Uint8Array) into a Node.js Buffer.
+* It prioritizes zero-copy conversions for TypedArrays and ArrayBuffers to ensure
+* optimal performance.
 *
-* @param {Blob | Buffer | File} input - The input to convert to Buffer
+* @param {ArrayBuffer | Blob | Buffer | File | Uint8Array} input - The binary data input to convert.
+* Supports Blob, Buffer, File, ArrayBuffer, and Uint8Array.
 *
-* @returns {Promise<Buffer>} A Promise that resolves to a Buffer
+* @returns {Promise<Buffer>} A promise that resolves to a Node.js Buffer.
 *
 * @example
 * ```typescript
-* import { toBuffer } from '@kikiutils/shared/general';
+* import { toBuffer } from '@kikiutils/shared/buffer';
 *
-* // Convert a Buffer (returns as-is)
-* const buffer = Buffer.from('Hello World');
-* const result1 = await toBuffer(buffer);
-* console.log(result1); // <Buffer 48 65 6c 6c 6f 20 57 6f 72 6c 64>
+* // From ArrayBuffer
+* const ab = new ArrayBuffer(8);
+* const bufferFromAB = await toBuffer(ab);
 *
-* // Convert a Blob
-* const blob = new Blob(['Hello from Blob'], { type: 'text/plain' });
-* const result2 = await toBuffer(blob);
-* console.log(result2.toString()); // 'Hello from Blob'
+* // From Uint8Array (Zero-copy)
+* const u8 = new Uint8Array([10, 20, 30]);
+* const bufferFromU8 = await toBuffer(u8);
 *
-* // Convert a File
-* const file = new File(['File content'], 'test.txt', { type: 'text/plain' });
-* const result3 = await toBuffer(file);
-* console.log(result3.toString()); // 'File content'
+* // From Blob or File
+* const blob = new Blob(['data'], { type: 'text/plain' });
+* const bufferFromBlob = await toBuffer(blob);
 * ```
 */
 async function toBuffer(input) {
 	if (Buffer.isBuffer(input)) return input;
-	return Buffer.from(await input.arrayBuffer());
+	if (input instanceof ArrayBuffer) return Buffer.from(input);
+	if (input instanceof Uint8Array) return Buffer.from(input.buffer, input.byteOffset, input.byteLength);
+	if (typeof input.arrayBuffer === "function") return Buffer.from(await input.arrayBuffer());
+	throw new TypeError("The provided input is not a supported binary type (Blob, Buffer, File, ArrayBuffer, or Uint8Array).");
 }
 
 //#endregion

package/dist/buffer.js.map

@@ -1 +1 @@
-{"version":3,"file":"buffer.js","names":[],"sources":["../src/buffer.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\n\nimport type { BinaryInput } from './types';\n\n/**\n * Converts a Blob, Buffer, or File to a Buffer.\n *\n * This function provides a unified way to convert various binary data types\n * to Node.js Buffer. If the input is already a Buffer, it returns it as-is.\n * For Blob or File inputs, it converts them to Buffer via ArrayBuffer.\n *\n * @param {Blob | Buffer | File} input - The input to convert to Buffer\n *\n * @returns {Promise<Buffer>} A Promise that resolves to a Buffer\n *\n * @example\n * ```typescript\n * import { toBuffer } from '@kikiutils/shared/general';\n *\n * // Convert a Buffer (returns as-is)\n * const buffer = Buffer.from('Hello World');\n * const result1 = await toBuffer(buffer);\n * console.log(result1); // <Buffer 48 65 6c 6c 6f 20 57 6f 72 6c 64>\n *\n * // Convert a Blob\n * const blob = new Blob(['Hello from Blob'], { type: 'text/plain' });\n * const result2 = await toBuffer(blob);\n * console.log(result2.toString()); // 'Hello from Blob'\n *\n * // Convert a File\n * const file = new File(['File content'], 'test.txt', { type: 'text/plain' });\n * const result3 = await toBuffer(file);\n * console.log(result3.toString()); // 'File content'\n * ```\n */\nexport async function toBuffer(input: BinaryInput) {\n    if (Buffer.isBuffer(input)) return input;\n    return Buffer.from(await input.arrayBuffer());\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,eAAsB,SAAS,OAAoB;AAC/C,KAAI,OAAO,SAAS,MAAM,CAAE,QAAO;AACnC,QAAO,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC"}
+{"version":3,"file":"buffer.js","names":[],"sources":["../src/buffer.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\n\nimport type { BinaryInput } from './types';\n\n/**\n * Converts various binary data types to a Node.js Buffer.\n *\n * This function provides a unified, efficient way to convert different binary formats\n * (Blob, Buffer, File, ArrayBuffer, or Uint8Array) into a Node.js Buffer.\n * It prioritizes zero-copy conversions for TypedArrays and ArrayBuffers to ensure\n * optimal performance.\n *\n * @param {ArrayBuffer | Blob | Buffer | File | Uint8Array} input - The binary data input to convert.\n * Supports Blob, Buffer, File, ArrayBuffer, and Uint8Array.\n *\n * @returns {Promise<Buffer>} A promise that resolves to a Node.js Buffer.\n *\n * @example\n * ```typescript\n * import { toBuffer } from '@kikiutils/shared/buffer';\n *\n * // From ArrayBuffer\n * const ab = new ArrayBuffer(8);\n * const bufferFromAB = await toBuffer(ab);\n *\n * // From Uint8Array (Zero-copy)\n * const u8 = new Uint8Array([10, 20, 30]);\n * const bufferFromU8 = await toBuffer(u8);\n *\n * // From Blob or File\n * const blob = new Blob(['data'], { type: 'text/plain' });\n * const bufferFromBlob = await toBuffer(blob);\n * ```\n */\nexport async function toBuffer(input: BinaryInput) {\n    if (Buffer.isBuffer(input)) return input;\n    if (input instanceof ArrayBuffer) return Buffer.from(input);\n    if (input instanceof Uint8Array) return Buffer.from(input.buffer, input.byteOffset, input.byteLength);\n    if (typeof input.arrayBuffer === 'function') return Buffer.from(await input.arrayBuffer());\n    // eslint-disable-next-line style/max-len\n    throw new TypeError('The provided input is not a supported binary type (Blob, Buffer, File, ArrayBuffer, or Uint8Array).');\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,eAAsB,SAAS,OAAoB;AAC/C,KAAI,OAAO,SAAS,MAAM,CAAE,QAAO;AACnC,KAAI,iBAAiB,YAAa,QAAO,OAAO,KAAK,MAAM;AAC3D,KAAI,iBAAiB,WAAY,QAAO,OAAO,KAAK,MAAM,QAAQ,MAAM,YAAY,MAAM,WAAW;AACrG,KAAI,OAAO,MAAM,gBAAgB,WAAY,QAAO,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAE1F,OAAM,IAAI,UAAU,sGAAsG"}

package/dist/classes/path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","names":[],"sources":["../../src/classes/path.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"path.d.ts","names":[],"sources":["../../src/classes/path.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -3,7 +3,7 @@ import { Blob as Blob$1, Buffer, File as File$1 } from "node:buffer";
 
 //#region src/types/index.d.ts
 type AnyRecord = Record<string, any>;
-type BinaryInput = Blob | Buffer | File | Blob$1 | File$1;
+type BinaryInput = ArrayBuffer | Blob | Buffer | File | Blob$1 | File$1 | Uint8Array;
 type Booleanish = 'false' | 'true' | boolean;
 type MaybePartial<T> = Partial<T> | T;
 type MaybeReadonly<T> = Readonly<T> | T;

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/types/index.ts"],"sourcesContent":[],"mappings":";;;;KAQY,SAAA,GAAY;KACZ,WAAA,GAAc,OAAO,SAAS,OAAO,SAAW;AADhD,KAEA,UAAA,GAFS,OAAG,GAAM,MAAA,GAAA,OAAA;AAClB,KAEA,YAFW,CAAA,CAAA,CAAA,GAEO,OAFP,CAEe,CAFf,CAAA,GAEoB,CAFpB;AAAG,KAGd,aAHc,CAAA,CAAA,CAAA,GAGK,QAHL,CAGc,CAHd,CAAA,GAGmB,CAHnB;AAAO,KAIrB,QAJqB,CAAA,CAAA,CAAA,GAAA,IAAA,GAIA,CAJA;AAAS,KAK9B,SAAA,GAL8B,MAAA,GAAA,MAAA;AAAO,KAMrC,aANqC,CAAA,UAAA,MAAA,GAAA,EAAA,CAAA,CAAA,GAMG,OANH,CAMW,MANX,CAMkB,CANlB,EAMqB,CANrB,CAAA,CAAA;AAAW,KAOhD,qBAPgD,CAAA,UAAA,MAAA,GAAA,EAAA,CAAA,CAAA,GAOA,QAPA,CAOS,aAPT,CAOuB,CAPvB,EAO0B,CAP1B,CAAA,CAAA;AAAQ,KAQxD,cARwD,CAAA,UAAA,MAAA,GAAA,EAAA,CAAA,CAAA,GAQf,QARe,CAQN,MARM,CAQC,CARD,EAQI,CARJ,CAAA,CAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/types/index.ts"],"sourcesContent":[],"mappings":";;;;KAQY,SAAA,GAAY;KACZ,WAAA,GAAc,cAAc,OAAO,SAAS,OAAO,SAAW,SAAW;AADzE,KAEA,UAAA,GAFS,OAAG,GAAM,MAAA,GAAA,OAAA;AAClB,KAEA,YAFW,CAAA,CAAA,CAAA,GAEO,OAFP,CAEe,CAFf,CAAA,GAEoB,CAFpB;AAAG,KAGd,aAHc,CAAA,CAAA,CAAA,GAGK,QAHL,CAGc,CAHd,CAAA,GAGmB,CAHnB;AAAc,KAI5B,QAJ4B,CAAA,CAAA,CAAA,GAAA,IAAA,GAIP,CAJO;AAAO,KAKnC,SAAA,GALmC,MAAA,GAAA,MAAA;AAAS,KAM5C,aAN4C,CAAA,UAAA,MAAA,GAAA,EAAA,CAAA,CAAA,GAMJ,OANI,CAMI,MANJ,CAMW,CANX,EAMc,CANd,CAAA,CAAA;AAAO,KAOnD,qBAPmD,CAAA,UAAA,MAAA,GAAA,EAAA,CAAA,CAAA,GAOH,QAPG,CAOM,aAPN,CAOoB,CAPpB,EAOuB,CAPvB,CAAA,CAAA;AAAW,KAQ9D,cAR8D,CAAA,UAAA,MAAA,GAAA,EAAA,CAAA,CAAA,GAQrB,QARqB,CAQZ,MARY,CAQL,CARK,EAQF,CARE,CAAA,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kikiutils/shared",
   "type": "module",
-  "version": "14.0.0",
+  "version": "14.1.0",
   "description": "A lightweight and modular utility library for modern JavaScript and TypeScript — includes secure hashing, flexible logging, datetime tools, Vue/web helpers, storage abstraction, and more.",
   "author": "kiki-kanri",
   "license": "MIT",
@@ -70,7 +70,7 @@
     "@noble/hashes": "^2.0.0",
     "@types/fs-extra": "^11.0.4",
     "@types/jsonfile": "^6.1.4",
-    "@types/node": "^24.5.2",
+    "@types/node": ">= 24",
     "@types/ssh2": "^1.15.5",
     "async-validator": "^4.2.5",
     "bson": "^7.0.0",
@@ -85,7 +85,6 @@
     "node-ssh": "^13.2.1",
     "pino": "^10.0.0",
     "pino-pretty": "^13.1.1",
-    "superjson": "^2.2.2",
     "vue": "^3.5.21",
     "vue-router": "^4.5.1"
   },
@@ -144,9 +143,6 @@
     "pino-pretty": {
       "optional": true
     },
-    "superjson": {
-      "optional": true
-    },
     "vue": {
       "optional": true
     },
@@ -155,15 +151,15 @@
     }
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^6.3.0",
+    "@antfu/eslint-config": "^6.7.3",
     "@kikiutils/eslint-config": "^5.0.0",
     "@kikiutils/tsconfigs": "^5.0.5",
     "@noble/hashes": "^2.0.1",
     "@types/fs-extra": "^11.0.4",
     "@types/jsonfile": "^6.1.4",
-    "@types/node": "^24.10.1",
+    "@types/node": "^25.0.3",
     "@types/ssh2": "^1.15.5",
-    "@vitest/coverage-v8": "^4.0.15",
+    "@vitest/coverage-v8": "^4.0.16",
     "async-validator": "^4.2.5",
     "bson": "^7.0.0",
     "changelogen": "^0.6.2",
@@ -172,24 +168,23 @@
     "date-fns": "^4.1.0",
     "decimal.js": "^10.6.0",
     "depcheck": "^1.4.7",
-    "element-plus": "^2.11.9",
-    "fs-extra": "^11.3.2",
-    "jsdom": "^27.2.0",
+    "element-plus": "^2.13.0",
+    "fs-extra": "^11.3.3",
+    "jsdom": "^27.4.0",
     "lru-cache": "^11.2.4",
     "millify": "^6.1.0",
-    "msgpackr": "^1.11.5",
+    "msgpackr": "^1.11.8",
     "node-ssh": "^13.2.1",
     "pino": "^10.1.0",
     "pino-pretty": "^13.1.3",
-    "publint": "^0.3.15",
-    "superjson": "^2.2.6",
+    "publint": "^0.3.16",
     "ts-unused-exports": "^11.0.1",
-    "tsdown": "^0.16.8",
+    "tsdown": "^0.18.4",
     "typescript": "^5.9.3",
     "unplugin-unused": "^0.5.6",
-    "vitest": "^4.0.15",
-    "vue": "^3.5.25",
-    "vue-router": "^4.6.3"
+    "vitest": "^4.0.16",
+    "vue": "^3.5.26",
+    "vue-router": "^4.6.4"
   },
   "pnpm": {
     "onlyBuiltDependencies": [

package/src/buffer.ts

@@ -3,37 +3,40 @@ import { Buffer } from 'node:buffer';
 import type { BinaryInput } from './types';
 
 /**
- * Converts a Blob, Buffer, or File to a Buffer.
+ * Converts various binary data types to a Node.js Buffer.
  *
- * This function provides a unified way to convert various binary data types
- * to Node.js Buffer. If the input is already a Buffer, it returns it as-is.
- * For Blob or File inputs, it converts them to Buffer via ArrayBuffer.
+ * This function provides a unified, efficient way to convert different binary formats
+ * (Blob, Buffer, File, ArrayBuffer, or Uint8Array) into a Node.js Buffer.
+ * It prioritizes zero-copy conversions for TypedArrays and ArrayBuffers to ensure
+ * optimal performance.
  *
- * @param {Blob | Buffer | File} input - The input to convert to Buffer
+ * @param {ArrayBuffer | Blob | Buffer | File | Uint8Array} input - The binary data input to convert.
+ * Supports Blob, Buffer, File, ArrayBuffer, and Uint8Array.
  *
- * @returns {Promise<Buffer>} A Promise that resolves to a Buffer
+ * @returns {Promise<Buffer>} A promise that resolves to a Node.js Buffer.
  *
  * @example
  * ```typescript
- * import { toBuffer } from '@kikiutils/shared/general';
+ * import { toBuffer } from '@kikiutils/shared/buffer';
  *
- * // Convert a Buffer (returns as-is)
- * const buffer = Buffer.from('Hello World');
- * const result1 = await toBuffer(buffer);
- * console.log(result1); // <Buffer 48 65 6c 6c 6f 20 57 6f 72 6c 64>
+ * // From ArrayBuffer
+ * const ab = new ArrayBuffer(8);
+ * const bufferFromAB = await toBuffer(ab);
  *
- * // Convert a Blob
- * const blob = new Blob(['Hello from Blob'], { type: 'text/plain' });
- * const result2 = await toBuffer(blob);
- * console.log(result2.toString()); // 'Hello from Blob'
+ * // From Uint8Array (Zero-copy)
+ * const u8 = new Uint8Array([10, 20, 30]);
+ * const bufferFromU8 = await toBuffer(u8);
  *
- * // Convert a File
- * const file = new File(['File content'], 'test.txt', { type: 'text/plain' });
- * const result3 = await toBuffer(file);
- * console.log(result3.toString()); // 'File content'
+ * // From Blob or File
+ * const blob = new Blob(['data'], { type: 'text/plain' });
+ * const bufferFromBlob = await toBuffer(blob);
  * ```
  */
 export async function toBuffer(input: BinaryInput) {
     if (Buffer.isBuffer(input)) return input;
-    return Buffer.from(await input.arrayBuffer());
+    if (input instanceof ArrayBuffer) return Buffer.from(input);
+    if (input instanceof Uint8Array) return Buffer.from(input.buffer, input.byteOffset, input.byteLength);
+    if (typeof input.arrayBuffer === 'function') return Buffer.from(await input.arrayBuffer());
+    // eslint-disable-next-line style/max-len
+    throw new TypeError('The provided input is not a supported binary type (Blob, Buffer, File, ArrayBuffer, or Uint8Array).');
 }

package/src/types/index.ts

@@ -7,7 +7,7 @@ import type {
 export type { FilteredKeyPath } from './filtered-key-path';
 
 export type AnyRecord = Record<string, any>;
-export type BinaryInput = Blob | Buffer | File | NodeBlob | NodeFile;
+export type BinaryInput = ArrayBuffer | Blob | Buffer | File | NodeBlob | NodeFile | Uint8Array;
 export type Booleanish = 'false' | 'true' | boolean;
 export type MaybePartial<T> = Partial<T> | T;
 export type MaybeReadonly<T> = Readonly<T> | T;