@fluxfiles/node 0.1.10 → 0.1.12

package/dist/index.d.mts

@@ -82,6 +82,12 @@ interface BaseTokenOptions {
     webpMaxWidth?: number;
     /** Default WebP quality when a request omits it. `0`/omitted = inherit (80). */
     webpDefaultQuality?: number;
+    /** Responsive `srcset` width ladder (px); list() emits these as `img_srcset` on images.
+     *  Snapped to 100px and clamped to webpMaxWidth on decode. Omit to inherit the default
+     *  `[320, 640, 768, 1024, 1366, 1920]`. */
+    srcsetWidths?: number[];
+    /** Optional `sizes` attribute surfaced as `img_sizes` (omit to let the host supply its own). */
+    srcsetSizes?: string;
     /** May this token mint clean original download URLs? Default true. `false` = preview-only
      *  (list withholds url/permanent_url/variants; GET presign is denied — only watermarked img_base). */
     allowDownload?: boolean;
@@ -90,6 +96,14 @@ interface BaseTokenOptions {
     /** Allow editing a file's text content (GET/PUT /api/fm/content). Default **false** — editing
      *  config/executable files (wp-config.php, .env, nginx.conf, deploy.sh) is powerful, so it's opt-in. */
     allowCodeEdit?: 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. */
+    allowExtract?: boolean;
+    /** Max total uncompressed size (MB) for a zip/extract. `0`/omitted = inherit (1024). */
+    zipMaxMb?: number;
+    /** Max file count for a zip/extract. `0`/omitted = inherit (10000). */
+    zipMaxFiles?: number;
     /** Enable on-the-fly watermark on `/api/fm/img` (source file is never modified). Default off. */
     watermarkEnabled?: boolean;
     /** Watermark kind: 'text' or 'logo' (a PNG path in storage). Default 'text'. */

package/dist/index.d.ts

@@ -82,6 +82,12 @@ interface BaseTokenOptions {
     webpMaxWidth?: number;
     /** Default WebP quality when a request omits it. `0`/omitted = inherit (80). */
     webpDefaultQuality?: number;
+    /** Responsive `srcset` width ladder (px); list() emits these as `img_srcset` on images.
+     *  Snapped to 100px and clamped to webpMaxWidth on decode. Omit to inherit the default
+     *  `[320, 640, 768, 1024, 1366, 1920]`. */
+    srcsetWidths?: number[];
+    /** Optional `sizes` attribute surfaced as `img_sizes` (omit to let the host supply its own). */
+    srcsetSizes?: string;
     /** May this token mint clean original download URLs? Default true. `false` = preview-only
      *  (list withholds url/permanent_url/variants; GET presign is denied — only watermarked img_base). */
     allowDownload?: boolean;
@@ -90,6 +96,14 @@ interface BaseTokenOptions {
     /** Allow editing a file's text content (GET/PUT /api/fm/content). Default **false** — editing
      *  config/executable files (wp-config.php, .env, nginx.conf, deploy.sh) is powerful, so it's opt-in. */
     allowCodeEdit?: 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. */
+    allowExtract?: boolean;
+    /** Max total uncompressed size (MB) for a zip/extract. `0`/omitted = inherit (1024). */
+    zipMaxMb?: number;
+    /** Max file count for a zip/extract. `0`/omitted = inherit (10000). */
+    zipMaxFiles?: number;
     /** Enable on-the-fly watermark on `/api/fm/img` (source file is never modified). Default off. */
     watermarkEnabled?: boolean;
     /** Watermark kind: 'text' or 'logo' (a PNG path in storage). Default 'text'. */

package/dist/index.js

@@ -157,9 +157,15 @@ function applyTenantOverrides(payload, opts) {
   if (opts.webpEnabled !== void 0) payload.webp_enabled = !!opts.webpEnabled;
   if (opts.webpMaxWidth && opts.webpMaxWidth > 0) payload.webp_max_width = Math.trunc(opts.webpMaxWidth);
   if (opts.webpDefaultQuality && opts.webpDefaultQuality > 0) payload.webp_default_quality = Math.trunc(opts.webpDefaultQuality);
+  if (Array.isArray(opts.srcsetWidths)) payload.srcset_widths = opts.srcsetWidths.map((w) => Math.trunc(w));
+  if (opts.srcsetSizes) payload.srcset_sizes = String(opts.srcsetSizes);
   if (opts.allowDownload !== void 0) payload.allow_download = !!opts.allowDownload;
   if (opts.allowChmod !== void 0) payload.allow_chmod = !!opts.allowChmod;
   if (opts.allowCodeEdit !== void 0) payload.allow_code_edit = !!opts.allowCodeEdit;
+  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);
+  if (opts.zipMaxFiles && opts.zipMaxFiles > 0) payload.zip_max_files = Math.trunc(opts.zipMaxFiles);
   if (opts.watermarkEnabled) {
     payload.watermark_enabled = true;
     if (opts.watermarkType) payload.watermark_type = opts.watermarkType;

package/dist/index.mjs

@@ -135,9 +135,15 @@ function applyTenantOverrides(payload, opts) {
   if (opts.webpEnabled !== void 0) payload.webp_enabled = !!opts.webpEnabled;
   if (opts.webpMaxWidth && opts.webpMaxWidth > 0) payload.webp_max_width = Math.trunc(opts.webpMaxWidth);
   if (opts.webpDefaultQuality && opts.webpDefaultQuality > 0) payload.webp_default_quality = Math.trunc(opts.webpDefaultQuality);
+  if (Array.isArray(opts.srcsetWidths)) payload.srcset_widths = opts.srcsetWidths.map((w) => Math.trunc(w));
+  if (opts.srcsetSizes) payload.srcset_sizes = String(opts.srcsetSizes);
   if (opts.allowDownload !== void 0) payload.allow_download = !!opts.allowDownload;
   if (opts.allowChmod !== void 0) payload.allow_chmod = !!opts.allowChmod;
   if (opts.allowCodeEdit !== void 0) payload.allow_code_edit = !!opts.allowCodeEdit;
+  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);
+  if (opts.zipMaxFiles && opts.zipMaxFiles > 0) payload.zip_max_files = Math.trunc(opts.zipMaxFiles);
   if (opts.watermarkEnabled) {
     payload.watermark_enabled = true;
     if (opts.watermarkType) payload.watermark_type = opts.watermarkType;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluxfiles/node",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "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

@@ -125,11 +125,17 @@ function applyTenantOverrides(payload: Record<string, unknown>, opts: BaseTokenO
   if (opts.webpEnabled !== undefined) payload.webp_enabled = !!opts.webpEnabled;
   if (opts.webpMaxWidth && opts.webpMaxWidth > 0) payload.webp_max_width = Math.trunc(opts.webpMaxWidth);
   if (opts.webpDefaultQuality && opts.webpDefaultQuality > 0) payload.webp_default_quality = Math.trunc(opts.webpDefaultQuality);
+  if (Array.isArray(opts.srcsetWidths)) payload.srcset_widths = opts.srcsetWidths.map((w) => Math.trunc(w));
+  if (opts.srcsetSizes) payload.srcset_sizes = String(opts.srcsetSizes);
 
   // Download gate + watermark.
   if (opts.allowDownload !== undefined) payload.allow_download = !!opts.allowDownload;
   if (opts.allowChmod !== undefined) payload.allow_chmod = !!opts.allowChmod;
   if (opts.allowCodeEdit !== undefined) payload.allow_code_edit = !!opts.allowCodeEdit;
+  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);
+  if (opts.zipMaxFiles && opts.zipMaxFiles > 0) payload.zip_max_files = Math.trunc(opts.zipMaxFiles);
   if (opts.watermarkEnabled) {
     payload.watermark_enabled = true;
     if (opts.watermarkType) payload.watermark_type = opts.watermarkType;

package/src/types.ts

@@ -86,6 +86,12 @@ export interface BaseTokenOptions {
   webpMaxWidth?: number;
   /** Default WebP quality when a request omits it. `0`/omitted = inherit (80). */
   webpDefaultQuality?: number;
+  /** Responsive `srcset` width ladder (px); list() emits these as `img_srcset` on images.
+   *  Snapped to 100px and clamped to webpMaxWidth on decode. Omit to inherit the default
+   *  `[320, 640, 768, 1024, 1366, 1920]`. */
+  srcsetWidths?: number[];
+  /** Optional `sizes` attribute surfaced as `img_sizes` (omit to let the host supply its own). */
+  srcsetSizes?: string;
   /** May this token mint clean original download URLs? Default true. `false` = preview-only
    *  (list withholds url/permanent_url/variants; GET presign is denied — only watermarked img_base). */
   allowDownload?: boolean;
@@ -94,6 +100,14 @@ export interface BaseTokenOptions {
   /** Allow editing a file's text content (GET/PUT /api/fm/content). Default **false** — editing
    *  config/executable files (wp-config.php, .env, nginx.conf, deploy.sh) is powerful, so it's opt-in. */
   allowCodeEdit?: 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. */
+  allowExtract?: boolean;
+  /** Max total uncompressed size (MB) for a zip/extract. `0`/omitted = inherit (1024). */
+  zipMaxMb?: number;
+  /** Max file count for a zip/extract. `0`/omitted = inherit (10000). */
+  zipMaxFiles?: number;
   /** Enable on-the-fly watermark on `/api/fm/img` (source file is never modified). Default off. */
   watermarkEnabled?: boolean;
   /** Watermark kind: 'text' or 'logo' (a PNG path in storage). Default 'text'. */