@fluxfiles/node 0.1.6 → 0.1.7

package/dist/index.d.mts

@@ -83,6 +83,16 @@ interface BaseTokenOptions {
     watermarkOpacity?: number;
     /** Font size for text watermark. Default 24. */
     watermarkFontSize?: number;
+    /** Usage-summary cache TTL (seconds). `0`/omitted = inherit (900). */
+    usageCacheTtl?: number;
+    /** Percent at which quota status becomes "warning". `0`/omitted = inherit (70). */
+    usageWarningThreshold?: number;
+    /** Percent at which quota status becomes "critical". `0`/omitted = inherit (90). */
+    usageCriticalThreshold?: number;
+    /** Number of largest folders the usage dashboard returns. `0`/omitted = inherit (10). */
+    usageTopFoldersCount?: number;
+    /** Folder grouping depth for the usage breakdown. `0`/omitted = inherit (1). */
+    usageFolderDepth?: number;
 }
 interface CreateTokenOptions extends BaseTokenOptions {
     /** Disk names the token may access. */

package/dist/index.d.ts

@@ -83,6 +83,16 @@ interface BaseTokenOptions {
     watermarkOpacity?: number;
     /** Font size for text watermark. Default 24. */
     watermarkFontSize?: number;
+    /** Usage-summary cache TTL (seconds). `0`/omitted = inherit (900). */
+    usageCacheTtl?: number;
+    /** Percent at which quota status becomes "warning". `0`/omitted = inherit (70). */
+    usageWarningThreshold?: number;
+    /** Percent at which quota status becomes "critical". `0`/omitted = inherit (90). */
+    usageCriticalThreshold?: number;
+    /** Number of largest folders the usage dashboard returns. `0`/omitted = inherit (10). */
+    usageTopFoldersCount?: number;
+    /** Folder grouping depth for the usage breakdown. `0`/omitted = inherit (1). */
+    usageFolderDepth?: number;
 }
 interface CreateTokenOptions extends BaseTokenOptions {
     /** Disk names the token may access. */

package/dist/index.js

@@ -167,6 +167,11 @@ function applyTenantOverrides(payload, opts) {
     if (opts.watermarkOpacity !== void 0) payload.watermark_opacity = opts.watermarkOpacity;
     if (opts.watermarkFontSize && opts.watermarkFontSize > 0) payload.watermark_font_size = Math.trunc(opts.watermarkFontSize);
   }
+  if (opts.usageCacheTtl && opts.usageCacheTtl > 0) payload.usage_cache_ttl = Math.trunc(opts.usageCacheTtl);
+  if (opts.usageWarningThreshold && opts.usageWarningThreshold > 0) payload.usage_warning_threshold = Math.trunc(opts.usageWarningThreshold);
+  if (opts.usageCriticalThreshold && opts.usageCriticalThreshold > 0) payload.usage_critical_threshold = Math.trunc(opts.usageCriticalThreshold);
+  if (opts.usageTopFoldersCount && opts.usageTopFoldersCount > 0) payload.usage_top_folders_count = Math.trunc(opts.usageTopFoldersCount);
+  if (opts.usageFolderDepth && opts.usageFolderDepth > 0) payload.usage_folder_depth = Math.trunc(opts.usageFolderDepth);
 }
 function validateByobDisk(name, config) {
   if (!config || config.driver !== "s3") {

package/dist/index.mjs

@@ -145,6 +145,11 @@ function applyTenantOverrides(payload, opts) {
     if (opts.watermarkOpacity !== void 0) payload.watermark_opacity = opts.watermarkOpacity;
     if (opts.watermarkFontSize && opts.watermarkFontSize > 0) payload.watermark_font_size = Math.trunc(opts.watermarkFontSize);
   }
+  if (opts.usageCacheTtl && opts.usageCacheTtl > 0) payload.usage_cache_ttl = Math.trunc(opts.usageCacheTtl);
+  if (opts.usageWarningThreshold && opts.usageWarningThreshold > 0) payload.usage_warning_threshold = Math.trunc(opts.usageWarningThreshold);
+  if (opts.usageCriticalThreshold && opts.usageCriticalThreshold > 0) payload.usage_critical_threshold = Math.trunc(opts.usageCriticalThreshold);
+  if (opts.usageTopFoldersCount && opts.usageTopFoldersCount > 0) payload.usage_top_folders_count = Math.trunc(opts.usageTopFoldersCount);
+  if (opts.usageFolderDepth && opts.usageFolderDepth > 0) payload.usage_folder_depth = Math.trunc(opts.usageFolderDepth);
 }
 function validateByobDisk(name, config) {
   if (!config || config.driver !== "s3") {

package/package.json

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

@@ -137,6 +137,13 @@ function applyTenantOverrides(payload: Record<string, unknown>, opts: BaseTokenO
     if (opts.watermarkOpacity !== undefined) payload.watermark_opacity = opts.watermarkOpacity;
     if (opts.watermarkFontSize && opts.watermarkFontSize > 0) payload.watermark_font_size = Math.trunc(opts.watermarkFontSize);
   }
+
+  // Usage-dashboard claims.
+  if (opts.usageCacheTtl && opts.usageCacheTtl > 0) payload.usage_cache_ttl = Math.trunc(opts.usageCacheTtl);
+  if (opts.usageWarningThreshold && opts.usageWarningThreshold > 0) payload.usage_warning_threshold = Math.trunc(opts.usageWarningThreshold);
+  if (opts.usageCriticalThreshold && opts.usageCriticalThreshold > 0) payload.usage_critical_threshold = Math.trunc(opts.usageCriticalThreshold);
+  if (opts.usageTopFoldersCount && opts.usageTopFoldersCount > 0) payload.usage_top_folders_count = Math.trunc(opts.usageTopFoldersCount);
+  if (opts.usageFolderDepth && opts.usageFolderDepth > 0) payload.usage_folder_depth = Math.trunc(opts.usageFolderDepth);
 }
 
 /**

package/src/types.ts

@@ -85,6 +85,16 @@ export interface BaseTokenOptions {
   watermarkOpacity?: number;
   /** Font size for text watermark. Default 24. */
   watermarkFontSize?: number;
+  /** Usage-summary cache TTL (seconds). `0`/omitted = inherit (900). */
+  usageCacheTtl?: number;
+  /** Percent at which quota status becomes "warning". `0`/omitted = inherit (70). */
+  usageWarningThreshold?: number;
+  /** Percent at which quota status becomes "critical". `0`/omitted = inherit (90). */
+  usageCriticalThreshold?: number;
+  /** Number of largest folders the usage dashboard returns. `0`/omitted = inherit (10). */
+  usageTopFoldersCount?: number;
+  /** Folder grouping depth for the usage breakdown. `0`/omitted = inherit (1). */
+  usageFolderDepth?: number;
 }
 
 export interface CreateTokenOptions extends BaseTokenOptions {