@fluxfiles/node 0.1.3 → 0.1.5

package/dist/index.d.mts

@@ -52,6 +52,20 @@ interface BaseTokenOptions {
     /** Import-specific rate limit (req/min) and max concurrent imports. `0`/omitted = inherit. */
     importRateLimit?: number;
     importConcurrency?: number;
+    /** Enable inline video/audio preview for this tenant. Omit to inherit the default (true). */
+    mediaPreview?: boolean;
+    /** Presigned media-URL TTL (seconds) — longer so a long video doesn't expire mid-play. `0`/omitted = inherit (7200). */
+    previewUrlTtl?: number;
+    /** Max file size (MB) eligible for inline preview; larger media shows a download placeholder. `0`/omitted = inherit (500). */
+    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;
 }
 interface CreateTokenOptions extends BaseTokenOptions {
     /** Disk names the token may access. */

package/dist/index.d.ts

@@ -52,6 +52,20 @@ interface BaseTokenOptions {
     /** Import-specific rate limit (req/min) and max concurrent imports. `0`/omitted = inherit. */
     importRateLimit?: number;
     importConcurrency?: number;
+    /** Enable inline video/audio preview for this tenant. Omit to inherit the default (true). */
+    mediaPreview?: boolean;
+    /** Presigned media-URL TTL (seconds) — longer so a long video doesn't expire mid-play. `0`/omitted = inherit (7200). */
+    previewUrlTtl?: number;
+    /** Max file size (MB) eligible for inline preview; larger media shows a download placeholder. `0`/omitted = inherit (500). */
+    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;
 }
 interface CreateTokenOptions extends BaseTokenOptions {
     /** Disk names the token may access. */

package/dist/index.js

@@ -150,6 +150,13 @@ function applyTenantOverrides(payload, opts) {
   if (Array.isArray(opts.importUrlAllowlist) && opts.importUrlAllowlist.length) {
     payload.import_url_allowlist = opts.importUrlAllowlist.map((h) => String(h));
   }
+  if (opts.mediaPreview !== void 0) payload.media_preview = !!opts.mediaPreview;
+  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);
 }
 function validateByobDisk(name, config) {
   if (!config || config.driver !== "s3") {

package/dist/index.mjs

@@ -128,6 +128,13 @@ function applyTenantOverrides(payload, opts) {
   if (Array.isArray(opts.importUrlAllowlist) && opts.importUrlAllowlist.length) {
     payload.import_url_allowlist = opts.importUrlAllowlist.map((h) => String(h));
   }
+  if (opts.mediaPreview !== void 0) payload.media_preview = !!opts.mediaPreview;
+  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);
 }
 function validateByobDisk(name, config) {
   if (!config || config.driver !== "s3") {

package/package.json

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

@@ -114,6 +114,17 @@ function applyTenantOverrides(payload: Record<string, unknown>, opts: BaseTokenO
   if (Array.isArray(opts.importUrlAllowlist) && opts.importUrlAllowlist.length) {
     payload.import_url_allowlist = opts.importUrlAllowlist.map((h) => String(h));
   }
+
+  // Media-preview claims (the server sanitizes/clamps these on decode).
+  if (opts.mediaPreview !== undefined) payload.media_preview = !!opts.mediaPreview;
+  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);
 }
 
 /**

package/src/types.ts

@@ -54,6 +54,20 @@ export interface BaseTokenOptions {
   /** Import-specific rate limit (req/min) and max concurrent imports. `0`/omitted = inherit. */
   importRateLimit?: number;
   importConcurrency?: number;
+  /** Enable inline video/audio preview for this tenant. Omit to inherit the default (true). */
+  mediaPreview?: boolean;
+  /** Presigned media-URL TTL (seconds) — longer so a long video doesn't expire mid-play. `0`/omitted = inherit (7200). */
+  previewUrlTtl?: number;
+  /** Max file size (MB) eligible for inline preview; larger media shows a download placeholder. `0`/omitted = inherit (500). */
+  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;
 }
 
 export interface CreateTokenOptions extends BaseTokenOptions {