@fluxfiles/node 0.1.13 → 0.1.15

package/dist/index.d.mts

@@ -99,6 +99,31 @@ interface BaseTokenOptions {
     /** Allow the paid Optimization module (POST /api/fm/optimize). Default **false** — opt-in.
      *  Even when true, the optimize module must be installed + licensed on the server. */
     allowOptimize?: boolean;
+    /** Auto-optimize images on upload (recompress to WebP in the pipeline). Default false;
+     *  only effective when the optimize module is installed + licensed on the server. */
+    autoOptimize?: boolean;
+    /** WebP quality for optimization, 40–95. `0`/omitted = inherit the server default (82). */
+    optimizeQuality?: number;
+    /** Target format for optimization: `'webp'` (default) or `'avif'` (falls back to
+     *  WebP when the server build lacks AVIF). */
+    optimizeFormat?: 'webp' | 'avif';
+    /** Keep the original file when optimizing (default false = replace in place). */
+    optimizeKeepOriginal?: boolean;
+    /** Skip optimizing a file larger than this many MB (0/omitted = no limit). */
+    optimizeMaxMb?: number;
+    /** Ghostscript preset for PDF optimization. Default `'ebook'`. */
+    pdfLevel?: 'screen' | 'ebook' | 'printer' | 'prepress' | 'default';
+    /** How an upload whose NAME collides with an existing different file is handled
+     *  (content dedup is separate, by hash): `'rename'` keep both `<name>-1.<ext>`
+     *  (default), `'overwrite'` replace in place, `'reject'` 409 for the host to prompt. */
+    uploadCollision?: 'rename' | 'overwrite' | 'reject';
+    /** Show dotfiles (.env, .gitignore, …) in listings + search. Default **false** —
+     *  dotfiles are hidden, matching Finder / cPanel / Nextcloud. */
+    showHidden?: boolean;
+    /** Refuse byte-for-byte duplicate uploads (SHA-256). Default **false** — an
+     *  identical re-upload is kept as a copy (like Finder / Drive / Dropbox); set true
+     *  to save storage by blocking duplicates. */
+    dedupeUploads?: boolean;
     /** Allow downloading a multi-file/-folder selection as a zip (POST /api/fm/zip). Default true. */
     allowZip?: boolean;
     /** Allow extracting a zip in place (POST /api/fm/extract). Default true. */

package/dist/index.d.ts

@@ -99,6 +99,31 @@ interface BaseTokenOptions {
     /** Allow the paid Optimization module (POST /api/fm/optimize). Default **false** — opt-in.
      *  Even when true, the optimize module must be installed + licensed on the server. */
     allowOptimize?: boolean;
+    /** Auto-optimize images on upload (recompress to WebP in the pipeline). Default false;
+     *  only effective when the optimize module is installed + licensed on the server. */
+    autoOptimize?: boolean;
+    /** WebP quality for optimization, 40–95. `0`/omitted = inherit the server default (82). */
+    optimizeQuality?: number;
+    /** Target format for optimization: `'webp'` (default) or `'avif'` (falls back to
+     *  WebP when the server build lacks AVIF). */
+    optimizeFormat?: 'webp' | 'avif';
+    /** Keep the original file when optimizing (default false = replace in place). */
+    optimizeKeepOriginal?: boolean;
+    /** Skip optimizing a file larger than this many MB (0/omitted = no limit). */
+    optimizeMaxMb?: number;
+    /** Ghostscript preset for PDF optimization. Default `'ebook'`. */
+    pdfLevel?: 'screen' | 'ebook' | 'printer' | 'prepress' | 'default';
+    /** How an upload whose NAME collides with an existing different file is handled
+     *  (content dedup is separate, by hash): `'rename'` keep both `<name>-1.<ext>`
+     *  (default), `'overwrite'` replace in place, `'reject'` 409 for the host to prompt. */
+    uploadCollision?: 'rename' | 'overwrite' | 'reject';
+    /** Show dotfiles (.env, .gitignore, …) in listings + search. Default **false** —
+     *  dotfiles are hidden, matching Finder / cPanel / Nextcloud. */
+    showHidden?: boolean;
+    /** Refuse byte-for-byte duplicate uploads (SHA-256). Default **false** — an
+     *  identical re-upload is kept as a copy (like Finder / Drive / Dropbox); set true
+     *  to save storage by blocking duplicates. */
+    dedupeUploads?: boolean;
     /** Allow downloading a multi-file/-folder selection as a zip (POST /api/fm/zip). Default true. */
     allowZip?: boolean;
     /** Allow extracting a zip in place (POST /api/fm/extract). Default true. */

package/dist/index.js

@@ -163,6 +163,19 @@ function applyTenantOverrides(payload, opts) {
   if (opts.allowChmod !== void 0) payload.allow_chmod = !!opts.allowChmod;
   if (opts.allowCodeEdit !== void 0) payload.allow_code_edit = !!opts.allowCodeEdit;
   if (opts.allowOptimize !== void 0) payload.allow_optimize = !!opts.allowOptimize;
+  if (opts.autoOptimize !== void 0) payload.auto_optimize = !!opts.autoOptimize;
+  if (opts.optimizeQuality && opts.optimizeQuality > 0) payload.optimize_quality = Math.trunc(opts.optimizeQuality);
+  if (opts.optimizeFormat === "avif") payload.optimize_format = "avif";
+  if (opts.optimizeKeepOriginal !== void 0) payload.optimize_keep_original = !!opts.optimizeKeepOriginal;
+  if (opts.optimizeMaxMb && opts.optimizeMaxMb > 0) payload.optimize_max_mb = Math.trunc(opts.optimizeMaxMb);
+  if (opts.pdfLevel && ["screen", "ebook", "printer", "prepress", "default"].includes(opts.pdfLevel)) {
+    payload.pdf_level = opts.pdfLevel;
+  }
+  if (opts.uploadCollision && ["rename", "overwrite", "reject"].includes(opts.uploadCollision)) {
+    payload.upload_collision = opts.uploadCollision;
+  }
+  if (opts.showHidden !== void 0) payload.show_hidden = !!opts.showHidden;
+  if (opts.dedupeUploads !== void 0) payload.dedupe_uploads = !!opts.dedupeUploads;
   if (opts.allowZip !== void 0) payload.allow_zip = !!opts.allowZip;
   if (opts.allowExtract !== void 0) payload.allow_extract = !!opts.allowExtract;
   if (opts.zipMaxMb && opts.zipMaxMb > 0) payload.zip_max_mb = Math.trunc(opts.zipMaxMb);

package/dist/index.mjs

@@ -141,6 +141,19 @@ function applyTenantOverrides(payload, opts) {
   if (opts.allowChmod !== void 0) payload.allow_chmod = !!opts.allowChmod;
   if (opts.allowCodeEdit !== void 0) payload.allow_code_edit = !!opts.allowCodeEdit;
   if (opts.allowOptimize !== void 0) payload.allow_optimize = !!opts.allowOptimize;
+  if (opts.autoOptimize !== void 0) payload.auto_optimize = !!opts.autoOptimize;
+  if (opts.optimizeQuality && opts.optimizeQuality > 0) payload.optimize_quality = Math.trunc(opts.optimizeQuality);
+  if (opts.optimizeFormat === "avif") payload.optimize_format = "avif";
+  if (opts.optimizeKeepOriginal !== void 0) payload.optimize_keep_original = !!opts.optimizeKeepOriginal;
+  if (opts.optimizeMaxMb && opts.optimizeMaxMb > 0) payload.optimize_max_mb = Math.trunc(opts.optimizeMaxMb);
+  if (opts.pdfLevel && ["screen", "ebook", "printer", "prepress", "default"].includes(opts.pdfLevel)) {
+    payload.pdf_level = opts.pdfLevel;
+  }
+  if (opts.uploadCollision && ["rename", "overwrite", "reject"].includes(opts.uploadCollision)) {
+    payload.upload_collision = opts.uploadCollision;
+  }
+  if (opts.showHidden !== void 0) payload.show_hidden = !!opts.showHidden;
+  if (opts.dedupeUploads !== void 0) payload.dedupe_uploads = !!opts.dedupeUploads;
   if (opts.allowZip !== void 0) payload.allow_zip = !!opts.allowZip;
   if (opts.allowExtract !== void 0) payload.allow_extract = !!opts.allowExtract;
   if (opts.zipMaxMb && opts.zipMaxMb > 0) payload.zip_max_mb = Math.trunc(opts.zipMaxMb);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluxfiles/node",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Server-side Node/TypeScript SDK for minting FluxFiles JWTs (plain + BYOB), byte-compatible with the PHP core",
   "license": "MIT",
   "sideEffects": false,

package/src/token.ts

@@ -133,6 +133,19 @@ function applyTenantOverrides(payload: Record<string, unknown>, opts: BaseTokenO
   if (opts.allowChmod !== undefined) payload.allow_chmod = !!opts.allowChmod;
   if (opts.allowCodeEdit !== undefined) payload.allow_code_edit = !!opts.allowCodeEdit;
   if (opts.allowOptimize !== undefined) payload.allow_optimize = !!opts.allowOptimize;
+  if (opts.autoOptimize !== undefined) payload.auto_optimize = !!opts.autoOptimize;
+  if (opts.optimizeQuality && opts.optimizeQuality > 0) payload.optimize_quality = Math.trunc(opts.optimizeQuality);
+  if (opts.optimizeFormat === 'avif') payload.optimize_format = 'avif';
+  if (opts.optimizeKeepOriginal !== undefined) payload.optimize_keep_original = !!opts.optimizeKeepOriginal;
+  if (opts.optimizeMaxMb && opts.optimizeMaxMb > 0) payload.optimize_max_mb = Math.trunc(opts.optimizeMaxMb);
+  if (opts.pdfLevel && ['screen', 'ebook', 'printer', 'prepress', 'default'].includes(opts.pdfLevel)) {
+    payload.pdf_level = opts.pdfLevel;
+  }
+  if (opts.uploadCollision && ['rename', 'overwrite', 'reject'].includes(opts.uploadCollision)) {
+    payload.upload_collision = opts.uploadCollision;
+  }
+  if (opts.showHidden !== undefined) payload.show_hidden = !!opts.showHidden;
+  if (opts.dedupeUploads !== undefined) payload.dedupe_uploads = !!opts.dedupeUploads;
   if (opts.allowZip !== undefined) payload.allow_zip = !!opts.allowZip;
   if (opts.allowExtract !== undefined) payload.allow_extract = !!opts.allowExtract;
   if (opts.zipMaxMb && opts.zipMaxMb > 0) payload.zip_max_mb = Math.trunc(opts.zipMaxMb);

package/src/types.ts

@@ -103,6 +103,31 @@ export interface BaseTokenOptions {
   /** Allow the paid Optimization module (POST /api/fm/optimize). Default **false** — opt-in.
    *  Even when true, the optimize module must be installed + licensed on the server. */
   allowOptimize?: boolean;
+  /** Auto-optimize images on upload (recompress to WebP in the pipeline). Default false;
+   *  only effective when the optimize module is installed + licensed on the server. */
+  autoOptimize?: boolean;
+  /** WebP quality for optimization, 40–95. `0`/omitted = inherit the server default (82). */
+  optimizeQuality?: number;
+  /** Target format for optimization: `'webp'` (default) or `'avif'` (falls back to
+   *  WebP when the server build lacks AVIF). */
+  optimizeFormat?: 'webp' | 'avif';
+  /** Keep the original file when optimizing (default false = replace in place). */
+  optimizeKeepOriginal?: boolean;
+  /** Skip optimizing a file larger than this many MB (0/omitted = no limit). */
+  optimizeMaxMb?: number;
+  /** Ghostscript preset for PDF optimization. Default `'ebook'`. */
+  pdfLevel?: 'screen' | 'ebook' | 'printer' | 'prepress' | 'default';
+  /** How an upload whose NAME collides with an existing different file is handled
+   *  (content dedup is separate, by hash): `'rename'` keep both `<name>-1.<ext>`
+   *  (default), `'overwrite'` replace in place, `'reject'` 409 for the host to prompt. */
+  uploadCollision?: 'rename' | 'overwrite' | 'reject';
+  /** Show dotfiles (.env, .gitignore, …) in listings + search. Default **false** —
+   *  dotfiles are hidden, matching Finder / cPanel / Nextcloud. */
+  showHidden?: boolean;
+  /** Refuse byte-for-byte duplicate uploads (SHA-256). Default **false** — an
+   *  identical re-upload is kept as a copy (like Finder / Drive / Dropbox); set true
+   *  to save storage by blocking duplicates. */
+  dedupeUploads?: boolean;
   /** Allow downloading a multi-file/-folder selection as a zip (POST /api/fm/zip). Default true. */
   allowZip?: boolean;
   /** Allow extracting a zip in place (POST /api/fm/extract). Default true. */