@fluxfiles/node 0.1.14 → 0.1.16

package/dist/index.d.mts

@@ -104,6 +104,15 @@ interface BaseTokenOptions {
     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. */
@@ -111,6 +120,21 @@ interface BaseTokenOptions {
     /** 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;
+    /** Edition preset that defaults a tier's claims (`pro`/`agency`/`enterprise`).
+     *  DX sugar — explicit claim options still win, and the license gates the code. */
+    edition?: 'free' | 'pro' | 'agency' | 'enterprise';
+    /** Paid-module claims (3-layer gate: code installed + licensed + this claim).
+     *  All default off; inert unless the module is installed & licensed on the server. */
+    allowShare?: boolean;
+    allowAiVision?: boolean;
+    allowOcr?: boolean;
+    allowVirusScan?: boolean;
+    allowBackup?: boolean;
+    allowC2pa?: 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

@@ -104,6 +104,15 @@ interface BaseTokenOptions {
     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. */
@@ -111,6 +120,21 @@ interface BaseTokenOptions {
     /** 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;
+    /** Edition preset that defaults a tier's claims (`pro`/`agency`/`enterprise`).
+     *  DX sugar — explicit claim options still win, and the license gates the code. */
+    edition?: 'free' | 'pro' | 'agency' | 'enterprise';
+    /** Paid-module claims (3-layer gate: code installed + licensed + this claim).
+     *  All default off; inert unless the module is installed & licensed on the server. */
+    allowShare?: boolean;
+    allowAiVision?: boolean;
+    allowOcr?: boolean;
+    allowVirusScan?: boolean;
+    allowBackup?: boolean;
+    allowC2pa?: 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

@@ -136,7 +136,16 @@ function sanitizeVariants(v) {
   }
   return Object.keys(out).length ? out : null;
 }
+var EDITION_PRESETS = {
+  pro: { allow_optimize: true, allow_share: true },
+  agency: { allow_optimize: true, allow_share: true },
+  enterprise: { allow_optimize: true, allow_share: true, allow_virus_scan: true }
+};
 function applyTenantOverrides(payload, opts) {
+  const preset = opts.edition ? EDITION_PRESETS[String(opts.edition).toLowerCase()] : void 0;
+  if (preset) {
+    for (const [k, v] of Object.entries(preset)) if (!(k in payload)) payload[k] = v;
+  }
   if (opts.aiAutoTag !== void 0) payload.ai_auto_tag = !!opts.aiAutoTag;
   if (opts.rateRead && opts.rateRead > 0) payload.rate_read = Math.trunc(opts.rateRead);
   if (opts.rateWrite && opts.rateWrite > 0) payload.rate_write = Math.trunc(opts.rateWrite);
@@ -163,12 +172,25 @@ 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.allowShare !== void 0) payload.allow_share = !!opts.allowShare;
+  if (opts.allowAiVision !== void 0) payload.allow_ai_vision = !!opts.allowAiVision;
+  if (opts.allowOcr !== void 0) payload.allow_ocr = !!opts.allowOcr;
+  if (opts.allowVirusScan !== void 0) payload.allow_virus_scan = !!opts.allowVirusScan;
+  if (opts.allowBackup !== void 0) payload.allow_backup = !!opts.allowBackup;
+  if (opts.allowC2pa !== void 0) payload.allow_c2pa = !!opts.allowC2pa;
   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

@@ -114,7 +114,16 @@ function sanitizeVariants(v) {
   }
   return Object.keys(out).length ? out : null;
 }
+var EDITION_PRESETS = {
+  pro: { allow_optimize: true, allow_share: true },
+  agency: { allow_optimize: true, allow_share: true },
+  enterprise: { allow_optimize: true, allow_share: true, allow_virus_scan: true }
+};
 function applyTenantOverrides(payload, opts) {
+  const preset = opts.edition ? EDITION_PRESETS[String(opts.edition).toLowerCase()] : void 0;
+  if (preset) {
+    for (const [k, v] of Object.entries(preset)) if (!(k in payload)) payload[k] = v;
+  }
   if (opts.aiAutoTag !== void 0) payload.ai_auto_tag = !!opts.aiAutoTag;
   if (opts.rateRead && opts.rateRead > 0) payload.rate_read = Math.trunc(opts.rateRead);
   if (opts.rateWrite && opts.rateWrite > 0) payload.rate_write = Math.trunc(opts.rateWrite);
@@ -141,12 +150,25 @@ 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.allowShare !== void 0) payload.allow_share = !!opts.allowShare;
+  if (opts.allowAiVision !== void 0) payload.allow_ai_vision = !!opts.allowAiVision;
+  if (opts.allowOcr !== void 0) payload.allow_ocr = !!opts.allowOcr;
+  if (opts.allowVirusScan !== void 0) payload.allow_virus_scan = !!opts.allowVirusScan;
+  if (opts.allowBackup !== void 0) payload.allow_backup = !!opts.allowBackup;
+  if (opts.allowC2pa !== void 0) payload.allow_c2pa = !!opts.allowC2pa;
   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.14",
+  "version": "0.1.16",
   "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

@@ -97,8 +97,17 @@ function sanitizeVariants(v: BaseTokenOptions['variants']): Record<string, numbe
   return Object.keys(out).length ? out : null;
 }
 
+/** Edition preset (DX sugar): default a tier's claims; explicit opts below win. */
+const EDITION_PRESETS: Record<string, Record<string, boolean>> = {
+  pro: { allow_optimize: true, allow_share: true },
+  agency: { allow_optimize: true, allow_share: true },
+  enterprise: { allow_optimize: true, allow_share: true, allow_virus_scan: true },
+};
+
 /** Copy the optional per-tenant override claims into a payload when set. */
 function applyTenantOverrides(payload: Record<string, unknown>, opts: BaseTokenOptions): void {
+  const preset = opts.edition ? EDITION_PRESETS[String(opts.edition).toLowerCase()] : undefined;
+  if (preset) for (const [k, v] of Object.entries(preset)) if (!(k in payload)) payload[k] = v;
   if (opts.aiAutoTag !== undefined) payload.ai_auto_tag = !!opts.aiAutoTag;
   if (opts.rateRead && opts.rateRead > 0) payload.rate_read = Math.trunc(opts.rateRead);
   if (opts.rateWrite && opts.rateWrite > 0) payload.rate_write = Math.trunc(opts.rateWrite);
@@ -133,12 +142,26 @@ 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;
+  // Other paid-module claims (inert unless the module is installed + licensed).
+  if (opts.allowShare !== undefined) payload.allow_share = !!opts.allowShare;
+  if (opts.allowAiVision !== undefined) payload.allow_ai_vision = !!opts.allowAiVision;
+  if (opts.allowOcr !== undefined) payload.allow_ocr = !!opts.allowOcr;
+  if (opts.allowVirusScan !== undefined) payload.allow_virus_scan = !!opts.allowVirusScan;
+  if (opts.allowBackup !== undefined) payload.allow_backup = !!opts.allowBackup;
+  if (opts.allowC2pa !== undefined) payload.allow_c2pa = !!opts.allowC2pa;
   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

@@ -108,6 +108,15 @@ export interface BaseTokenOptions {
   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. */
@@ -115,6 +124,21 @@ export interface BaseTokenOptions {
   /** 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;
+  /** Edition preset that defaults a tier's claims (`pro`/`agency`/`enterprise`).
+   *  DX sugar — explicit claim options still win, and the license gates the code. */
+  edition?: 'free' | 'pro' | 'agency' | 'enterprise';
+  /** Paid-module claims (3-layer gate: code installed + licensed + this claim).
+   *  All default off; inert unless the module is installed & licensed on the server. */
+  allowShare?: boolean;
+  allowAiVision?: boolean;
+  allowOcr?: boolean;
+  allowVirusScan?: boolean;
+  allowBackup?: boolean;
+  allowC2pa?: 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. */