@fluxfiles/node 0.1.4 → 0.1.6

package/dist/index.d.mts

@@ -60,6 +60,29 @@ interface BaseTokenOptions {
     maxPreviewMb?: number;
     /** TTL (seconds) for per-file gated-local stream tokens. `0`/omitted = inherit (3600). */
     streamTokenTtl?: number;
+    /** Expose the on-demand WebP endpoint (`/api/fm/img`) for images. Omit to inherit the default (true). */
+    webpEnabled?: boolean;
+    /** Max resize width (px) a transform request may ask for. `0`/omitted = inherit (2000). */
+    webpMaxWidth?: number;
+    /** Default WebP quality when a request omits it. `0`/omitted = inherit (80). */
+    webpDefaultQuality?: number;
+    /** 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;
+    /** 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'. */
+    watermarkType?: 'text' | 'logo';
+    /** Watermark text (for type 'text'). */
+    watermarkText?: string;
+    /** Storage path to the logo PNG (for type 'logo'); missing → text fallback. */
+    watermarkLogoPath?: string;
+    /** Position: top-left / top-right / bottom-left / bottom-right / center. Default bottom-right. */
+    watermarkPosition?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';
+    /** Opacity 0.0–1.0. Default 0.6. */
+    watermarkOpacity?: number;
+    /** Font size for text watermark. Default 24. */
+    watermarkFontSize?: number;
 }
 interface CreateTokenOptions extends BaseTokenOptions {
     /** Disk names the token may access. */

package/dist/index.d.ts

@@ -60,6 +60,29 @@ interface BaseTokenOptions {
     maxPreviewMb?: number;
     /** TTL (seconds) for per-file gated-local stream tokens. `0`/omitted = inherit (3600). */
     streamTokenTtl?: number;
+    /** Expose the on-demand WebP endpoint (`/api/fm/img`) for images. Omit to inherit the default (true). */
+    webpEnabled?: boolean;
+    /** Max resize width (px) a transform request may ask for. `0`/omitted = inherit (2000). */
+    webpMaxWidth?: number;
+    /** Default WebP quality when a request omits it. `0`/omitted = inherit (80). */
+    webpDefaultQuality?: number;
+    /** 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;
+    /** 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'. */
+    watermarkType?: 'text' | 'logo';
+    /** Watermark text (for type 'text'). */
+    watermarkText?: string;
+    /** Storage path to the logo PNG (for type 'logo'); missing → text fallback. */
+    watermarkLogoPath?: string;
+    /** Position: top-left / top-right / bottom-left / bottom-right / center. Default bottom-right. */
+    watermarkPosition?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';
+    /** Opacity 0.0–1.0. Default 0.6. */
+    watermarkOpacity?: number;
+    /** Font size for text watermark. Default 24. */
+    watermarkFontSize?: number;
 }
 interface CreateTokenOptions extends BaseTokenOptions {
     /** Disk names the token may access. */

package/dist/index.js

@@ -154,6 +154,19 @@ function applyTenantOverrides(payload, opts) {
   if (opts.previewUrlTtl && opts.previewUrlTtl > 0) payload.preview_url_ttl = Math.trunc(opts.previewUrlTtl);
   if (opts.maxPreviewMb && opts.maxPreviewMb > 0) payload.max_preview_mb = Math.trunc(opts.maxPreviewMb);
   if (opts.streamTokenTtl && opts.streamTokenTtl > 0) payload.stream_token_ttl = Math.trunc(opts.streamTokenTtl);
+  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 (opts.allowDownload !== void 0) payload.allow_download = !!opts.allowDownload;
+  if (opts.watermarkEnabled) {
+    payload.watermark_enabled = true;
+    if (opts.watermarkType) payload.watermark_type = opts.watermarkType;
+    if (opts.watermarkText) payload.watermark_text = String(opts.watermarkText);
+    if (opts.watermarkLogoPath) payload.watermark_logo_path = String(opts.watermarkLogoPath);
+    if (opts.watermarkPosition) payload.watermark_position = opts.watermarkPosition;
+    if (opts.watermarkOpacity !== void 0) payload.watermark_opacity = opts.watermarkOpacity;
+    if (opts.watermarkFontSize && opts.watermarkFontSize > 0) payload.watermark_font_size = Math.trunc(opts.watermarkFontSize);
+  }
 }
 function validateByobDisk(name, config) {
   if (!config || config.driver !== "s3") {

package/dist/index.mjs

@@ -132,6 +132,19 @@ function applyTenantOverrides(payload, opts) {
   if (opts.previewUrlTtl && opts.previewUrlTtl > 0) payload.preview_url_ttl = Math.trunc(opts.previewUrlTtl);
   if (opts.maxPreviewMb && opts.maxPreviewMb > 0) payload.max_preview_mb = Math.trunc(opts.maxPreviewMb);
   if (opts.streamTokenTtl && opts.streamTokenTtl > 0) payload.stream_token_ttl = Math.trunc(opts.streamTokenTtl);
+  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 (opts.allowDownload !== void 0) payload.allow_download = !!opts.allowDownload;
+  if (opts.watermarkEnabled) {
+    payload.watermark_enabled = true;
+    if (opts.watermarkType) payload.watermark_type = opts.watermarkType;
+    if (opts.watermarkText) payload.watermark_text = String(opts.watermarkText);
+    if (opts.watermarkLogoPath) payload.watermark_logo_path = String(opts.watermarkLogoPath);
+    if (opts.watermarkPosition) payload.watermark_position = opts.watermarkPosition;
+    if (opts.watermarkOpacity !== void 0) payload.watermark_opacity = opts.watermarkOpacity;
+    if (opts.watermarkFontSize && opts.watermarkFontSize > 0) payload.watermark_font_size = Math.trunc(opts.watermarkFontSize);
+  }
 }
 function validateByobDisk(name, config) {
   if (!config || config.driver !== "s3") {

package/package.json

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

@@ -120,6 +120,23 @@ function applyTenantOverrides(payload: Record<string, unknown>, opts: BaseTokenO
   if (opts.previewUrlTtl && opts.previewUrlTtl > 0) payload.preview_url_ttl = Math.trunc(opts.previewUrlTtl);
   if (opts.maxPreviewMb && opts.maxPreviewMb > 0) payload.max_preview_mb = Math.trunc(opts.maxPreviewMb);
   if (opts.streamTokenTtl && opts.streamTokenTtl > 0) payload.stream_token_ttl = Math.trunc(opts.streamTokenTtl);
+
+  // On-demand WebP claims.
+  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);
+
+  // Download gate + watermark.
+  if (opts.allowDownload !== undefined) payload.allow_download = !!opts.allowDownload;
+  if (opts.watermarkEnabled) {
+    payload.watermark_enabled = true;
+    if (opts.watermarkType) payload.watermark_type = opts.watermarkType;
+    if (opts.watermarkText) payload.watermark_text = String(opts.watermarkText);
+    if (opts.watermarkLogoPath) payload.watermark_logo_path = String(opts.watermarkLogoPath);
+    if (opts.watermarkPosition) payload.watermark_position = opts.watermarkPosition;
+    if (opts.watermarkOpacity !== undefined) payload.watermark_opacity = opts.watermarkOpacity;
+    if (opts.watermarkFontSize && opts.watermarkFontSize > 0) payload.watermark_font_size = Math.trunc(opts.watermarkFontSize);
+  }
 }
 
 /**

package/src/types.ts

@@ -62,6 +62,29 @@ export interface BaseTokenOptions {
   maxPreviewMb?: number;
   /** TTL (seconds) for per-file gated-local stream tokens. `0`/omitted = inherit (3600). */
   streamTokenTtl?: number;
+  /** Expose the on-demand WebP endpoint (`/api/fm/img`) for images. Omit to inherit the default (true). */
+  webpEnabled?: boolean;
+  /** Max resize width (px) a transform request may ask for. `0`/omitted = inherit (2000). */
+  webpMaxWidth?: number;
+  /** Default WebP quality when a request omits it. `0`/omitted = inherit (80). */
+  webpDefaultQuality?: number;
+  /** 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;
+  /** 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'. */
+  watermarkType?: 'text' | 'logo';
+  /** Watermark text (for type 'text'). */
+  watermarkText?: string;
+  /** Storage path to the logo PNG (for type 'logo'); missing → text fallback. */
+  watermarkLogoPath?: string;
+  /** Position: top-left / top-right / bottom-left / bottom-right / center. Default bottom-right. */
+  watermarkPosition?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';
+  /** Opacity 0.0–1.0. Default 0.6. */
+  watermarkOpacity?: number;
+  /** Font size for text watermark. Default 24. */
+  watermarkFontSize?: number;
 }
 
 export interface CreateTokenOptions extends BaseTokenOptions {