@file-cabinet/web 0.0.1

package/dist/convert.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Converts bytes into a raw base64 string.
+ * Doesn't include a data URL prefix.
+ *
+ * @param bytes - The data to convert.
+ * @returns Raw base64 data string.
+**/
+export declare function bytesToBase64(bytes: Uint8Array): string;
+/**
+ * Converts raw base64 string into an array of bytes.
+ *
+ * @param data - The data to convert.
+ * @returns Array of bytes.
+**/
+export declare function base64ToBytes(data: string): Uint8Array;
+/**
+ * Converts a raw base64 string or data URL into a File object.
+ * If no MIME type is found, defaults to 'application/octet-stream'.
+ *
+ * @param data - The base64 data to convert.
+ * @param fileName - Name for the file (default = 'file')
+ * @returns File object.
+**/
+export declare function base64ToFile(data: string, fileName?: string): Promise<File>;
+/**
+ * Converts a buffer into a File object using MIME type detection.
+ * Infers file extension from binary content.
+ *
+ * @param buff - The data to convert.
+ * @param fileName - Name for the file (default = 'file')
+ * @returns File object.
+ * @throws If MIME type can't be determined.
+**/
+export declare function bufferToFile(buff: ArrayBuffer, fileName?: string): Promise<File>;
+/**
+ * Converts a File object to a base64 data URL.
+ *
+ * @param file - The File to convert.
+ * @returns Base64 data URL.
+**/
+export declare function fileToBase64(file: File): Promise<string | ArrayBuffer | null>;

package/dist/convert.js

@@ -0,0 +1,87 @@
+import { fileTypeFromBuffer } from "file-type";
+/**
+ * Converts bytes into a raw base64 string.
+ * Doesn't include a data URL prefix.
+ *
+ * @param bytes - The data to convert.
+ * @returns Raw base64 data string.
+**/
+export function bytesToBase64(bytes) {
+    const len = bytes.byteLength;
+    let binary = "";
+    for (let i = 0; i < len; i++)
+        binary += String.fromCharCode(bytes[i]);
+    return btoa(binary);
+}
+/**
+ * Converts raw base64 string into an array of bytes.
+ *
+ * @param data - The data to convert.
+ * @returns Array of bytes.
+**/
+export function base64ToBytes(data) {
+    const binary = atob(data);
+    const len = binary.length;
+    const bytes = new Uint8Array(len);
+    for (let i = 0; i < len; i++)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes;
+}
+/**
+ * Converts a raw base64 string or data URL into a File object.
+ * If no MIME type is found, defaults to 'application/octet-stream'.
+ *
+ * @param data - The base64 data to convert.
+ * @param fileName - Name for the file (default = 'file')
+ * @returns File object.
+**/
+export async function base64ToFile(data, fileName = "file") {
+    const matches = data.match(/^data:(.*?);base64,(.*)$/);
+    let mime;
+    let base64Data;
+    if (matches) {
+        mime = matches[1];
+        base64Data = matches[2];
+    }
+    else {
+        base64Data = data;
+    }
+    const byteArray = Uint8Array.from(atob(base64Data), c => c.charCodeAt(0));
+    return new File([byteArray], fileName, {
+        type: mime || "application/octet-stream",
+        lastModified: Date.now()
+    });
+}
+/**
+ * Converts a buffer into a File object using MIME type detection.
+ * Infers file extension from binary content.
+ *
+ * @param buff - The data to convert.
+ * @param fileName - Name for the file (default = 'file')
+ * @returns File object.
+ * @throws If MIME type can't be determined.
+**/
+export async function bufferToFile(buff, fileName = "file") {
+    const type = await fileTypeFromBuffer(buff);
+    if (!type)
+        throw new Error("Couldn't get file type from buffer.");
+    return new File([buff], `${fileName}.${type.ext}`, {
+        type: type.mime,
+        lastModified: Date.now()
+    });
+}
+/**
+ * Converts a File object to a base64 data URL.
+ *
+ * @param file - The File to convert.
+ * @returns Base64 data URL.
+**/
+export function fileToBase64(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(reader.result);
+        reader.onerror = () => reject(reader.error);
+        reader.readAsDataURL(file);
+    });
+}
+// 

package/dist/download.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Downloads a remote asset as a file in the browser.
+ * Attempts to infer file name from `Content-Disposition` header.
+ *
+ * @param url - Remote file URL to download.
+ * @returns Raw base64 data string.
+**/
+export declare function downloadAsset(url: string): Promise<void>;

package/dist/download.js

@@ -0,0 +1,27 @@
+/**
+ * Downloads a remote asset as a file in the browser.
+ * Attempts to infer file name from `Content-Disposition` header.
+ *
+ * @param url - Remote file URL to download.
+ * @returns Raw base64 data string.
+**/
+export async function downloadAsset(url) {
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`Failed to fetch asset: ${res.status} ${res.statusText}`);
+    const blob = await res.blob();
+    const downloadUrl = URL.createObjectURL(blob);
+    const cd = res.headers.get("content-disposition");
+    const match = cd?.match(/filename\*?=(?:UTF-8'')?["']?([^"';\n]+)["']?/i);
+    const fileName = match?.[1]
+        ? decodeURIComponent(match[1])
+        : "file";
+    const link = document.createElement("a");
+    link.href = downloadUrl;
+    link.download = fileName;
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+    URL.revokeObjectURL(downloadUrl);
+}
+// 

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * File-based utilities for browser separated into:
+ *
+ *  - Data conversion.
+ *  - Remote downloading.
+**/
+export * from "./convert.js";
+export * from "./download.js";

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * File-based utilities for browser separated into:
+ *
+ *  - Data conversion.
+ *  - Remote downloading.
+**/
+export * from "./convert.js";
+export * from "./download.js";
+// 

package/package.json

@@ -0,0 +1,56 @@
+{
+
+  "name": "@file-cabinet/web",
+
+  "version": "0.0.1",
+
+  "main": "./dist/index.js",
+
+  "types": "./dist/index.d.ts",
+
+  "type": "module",
+
+  "license": "MIT",
+
+  "files": [
+
+    "dist"
+
+  ],
+
+  "publishConfig": {
+
+    "access": "public"
+
+  },
+
+  "author": "Bouk",
+
+  "description": "Helper package for browser.",
+
+  "scripts": {
+
+    "build": "tsc"
+
+  },
+
+  "dependencies": {
+
+    "@bouko/ts": "^0.4.9",
+
+    "clsx": "^2.1.1",
+
+    "file-type": "^22.0.1",
+
+    "tailwind-merge": "^3.6.0"
+
+  },
+
+  "devDependencies": {
+
+    "typescript": "^5.9.2"
+
+  }
+
+}
+