@stacksjs/storage 0.70.87 → 0.70.90

package/dist/uploaded-file.js

@@ -0,0 +1,114 @@
+import { basename, extname, join } from "node:path";
+import { Storage } from "./facade";
+
+export class UploadedFile {
+  _file;
+  _hashName = null;
+  constructor(file) {
+    this._file = file;
+  }
+  get name() {
+    return this._file.name;
+  }
+  get extension() {
+    return extname(this._file.name).slice(1).toLowerCase();
+  }
+  get mimeType() {
+    return this._file.type;
+  }
+  get size() {
+    return this._file.size;
+  }
+  get file() {
+    return this._file;
+  }
+  hashName(extension) {
+    if (!this._hashName) {
+      const hash = crypto.randomUUID().replace(/-/g, "").slice(0, 32), ext = extension || this.extension;
+      this._hashName = ext ? `${hash}.${ext}` : hash;
+    }
+    return this._hashName;
+  }
+  async arrayBuffer() {
+    return this._file.arrayBuffer();
+  }
+  async bytes() {
+    const buffer = await this._file.arrayBuffer();
+    return new Uint8Array(buffer);
+  }
+  async text() {
+    return this._file.text();
+  }
+  isValid() {
+    return this._file.size > 0;
+  }
+  async store(path = "", disk = "local") {
+    const filename = this.hashName(), fullPath = path ? join(path, filename) : filename, contents = await this.bytes();
+    await Storage.disk(disk).write(fullPath, contents);
+    return fullPath;
+  }
+  async storeAs(path, name, disk = "local") {
+    if (name.includes("..") || name.includes("/") || name.includes("\\"))
+      throw Error("Invalid filename: path traversal or directory separator detected");
+    const sanitizedName = basename(name), fullPath = path ? join(path, sanitizedName) : sanitizedName, contents = await this.bytes();
+    await Storage.disk(disk).write(fullPath, contents);
+    return fullPath;
+  }
+  async storePublicly(path = "") {
+    return this.store(path, "public");
+  }
+  async storePubliclyAs(path, name) {
+    return this.storeAs(path, name, "public");
+  }
+  async move(path, disk = "local") {
+    const contents = await this.bytes();
+    await Storage.disk(disk).write(path, contents);
+    return path;
+  }
+  getClientOriginalName() {
+    return basename(this._file.name, extname(this._file.name));
+  }
+  getClientOriginalExtension() {
+    return this.extension;
+  }
+  getClientMimeType() {
+    return this._file.type;
+  }
+  getSize() {
+    const bytes = this._file.size;
+    if (bytes < 1024)
+      return `${bytes} B`;
+    if (bytes < 1048576)
+      return `${(bytes / 1024).toFixed(2)} KB`;
+    if (bytes < 1073741824)
+      return `${(bytes / 1048576).toFixed(2)} MB`;
+    return `${(bytes / 1073741824).toFixed(2)} GB`;
+  }
+  isOneOf(mimeTypes) {
+    return mimeTypes.some((type) => {
+      if (type.endsWith("/*")) {
+        const category = type.slice(0, -2);
+        return this._file.type.startsWith(category);
+      }
+      return this._file.type === type;
+    });
+  }
+  isImage() {
+    return this._file.type.startsWith("image/");
+  }
+  isVideo() {
+    return this._file.type.startsWith("video/");
+  }
+  isAudio() {
+    return this._file.type.startsWith("audio/");
+  }
+  isPdf() {
+    return this._file.type === "application/pdf";
+  }
+}
+export function uploadedFile(file) {
+  return new UploadedFile(file);
+}
+export function uploadedFiles(files) {
+  return files.map((f) => new UploadedFile(f));
+}

package/dist/visibility.js

@@ -0,0 +1,3 @@
+export function setVisibility() {
+  return "wip";
+}

package/dist/zip.js

@@ -0,0 +1,41 @@
+import { runCommand } from "@stacksjs/cli";
+function shellEscape(_arg) {
+  return `'${_arg.replace(/'/g, "'\\''")}'`;
+}
+export async function zip(from, to, options) {
+  const toPath = to || "archive.zip";
+  if (Array.isArray(from)) {
+    const fromPath = from.map((f) => shellEscape(f)).join(" ");
+    return runCommand(`zip -r ${shellEscape(toPath)} ${fromPath}`, options);
+  }
+  return runCommand(`zip -r ${shellEscape(toPath)} ${shellEscape(from)}`, options);
+}
+export async function unzip(paths) {
+  if (Array.isArray(paths))
+    return runCommand(`unzip ${paths.map((p) => shellEscape(p)).join(" ")}`);
+  return runCommand(`unzip ${shellEscape(paths)}`);
+}
+export function archive(paths) {
+  return zip(paths);
+}
+export function unarchive(paths) {
+  return unzip(paths);
+}
+export function compress(paths) {
+  return zip(paths);
+}
+export function decompress(paths) {
+  return unzip(paths);
+}
+export function gzipSync(data, options) {
+  return Bun.gzipSync(data, options);
+}
+export function gunzipSync(data) {
+  return Bun.gunzipSync(data);
+}
+export function deflateSync(data, options) {
+  return Bun.deflateSync(data, options);
+}
+export function inflateSync(data) {
+  return Bun.inflateSync(data);
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/storage",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.87",
+  "version": "0.70.90",
   "description": "The Stacks file system.",
   "author": "Chris Breuer",
   "contributors": [
@@ -63,12 +63,12 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/arrays": "0.70.87",
+    "@stacksjs/arrays": "0.70.90",
     "better-dx": "^0.2.16",
-    "@stacksjs/error-handling": "0.70.87",
-    "@stacksjs/path": "0.70.87",
-    "@stacksjs/strings": "0.70.87",
-    "@stacksjs/types": "0.70.87",
+    "@stacksjs/error-handling": "0.70.90",
+    "@stacksjs/path": "0.70.90",
+    "@stacksjs/strings": "0.70.90",
+    "@stacksjs/types": "0.70.90",
     "sharp": "^0.35.3"
   }
 }