@fluxfiles/node 0.1.20 → 0.1.22

package/dist/index.d.mts

@@ -105,6 +105,9 @@ interface BaseTokenOptions {
      *  true interactive terminal instead of the built-in command-runner. Free; must be http(s).
      *  Core-standalone only (like `allowTerminal`). */
     terminalPtyUrl?: string;
+    /** Optional self-hosted PDF-tools URL (Stirling-PDF, or any web PDF toolkit). When set, the
+     *  UI shows a "PDF tools" action that embeds it (merge/split/OCR/convert/…). Free; http(s). */
+    pdfToolsUrl?: string;
     /** Allow the Optimization feature (POST /api/fm/optimize) — recompress images to WebP +
      *  compress PDFs. **Free/core**; default **false** because it replaces/deletes originals, so
      *  it's an opt-in capability. */
@@ -148,6 +151,14 @@ interface BaseTokenOptions {
     versioningMax?: number;
     /** Skip versioning files bigger than this many MB. `0`/omitted = default (25). */
     versioningMaxMb?: number;
+    /** Webhooks module: fire a signed HTTP POST on file events. */
+    allowWebhooks?: boolean;
+    /** Endpoint the signed event is POSTed to (http/s only). */
+    webhookUrl?: string;
+    /** Only these event names fire the webhook (e.g. `['upload','delete']`). Empty = all. */
+    webhookEvents?: string[];
+    /** HMAC signing secret for the payload (`X-FluxFiles-Signature`). Empty = server secret. */
+    webhookSecret?: string;
     /** 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

@@ -105,6 +105,9 @@ interface BaseTokenOptions {
      *  true interactive terminal instead of the built-in command-runner. Free; must be http(s).
      *  Core-standalone only (like `allowTerminal`). */
     terminalPtyUrl?: string;
+    /** Optional self-hosted PDF-tools URL (Stirling-PDF, or any web PDF toolkit). When set, the
+     *  UI shows a "PDF tools" action that embeds it (merge/split/OCR/convert/…). Free; http(s). */
+    pdfToolsUrl?: string;
     /** Allow the Optimization feature (POST /api/fm/optimize) — recompress images to WebP +
      *  compress PDFs. **Free/core**; default **false** because it replaces/deletes originals, so
      *  it's an opt-in capability. */
@@ -148,6 +151,14 @@ interface BaseTokenOptions {
     versioningMax?: number;
     /** Skip versioning files bigger than this many MB. `0`/omitted = default (25). */
     versioningMaxMb?: number;
+    /** Webhooks module: fire a signed HTTP POST on file events. */
+    allowWebhooks?: boolean;
+    /** Endpoint the signed event is POSTed to (http/s only). */
+    webhookUrl?: string;
+    /** Only these event names fire the webhook (e.g. `['upload','delete']`). Empty = all. */
+    webhookEvents?: string[];
+    /** HMAC signing secret for the payload (`X-FluxFiles-Signature`). Empty = server secret. */
+    webhookSecret?: string;
     /** 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

@@ -173,12 +173,17 @@ function applyTenantOverrides(payload, opts) {
   if (opts.allowCodeEdit !== void 0) payload.allow_code_edit = !!opts.allowCodeEdit;
   if (opts.allowTerminal !== void 0) payload.allow_terminal = !!opts.allowTerminal;
   if (opts.terminalPtyUrl) payload.terminal_pty_url = String(opts.terminalPtyUrl);
+  if (opts.pdfToolsUrl) payload.pdf_tools_url = String(opts.pdfToolsUrl);
   if (opts.allowOptimize !== void 0) payload.allow_optimize = !!opts.allowOptimize;
   if (opts.allowShare !== void 0) payload.allow_share = !!opts.allowShare;
   if (opts.allowIntake !== void 0) payload.allow_intake = !!opts.allowIntake;
   if (opts.allowVersioning !== void 0) payload.allow_versioning = !!opts.allowVersioning;
   if (opts.versioningMax && opts.versioningMax > 0) payload.versioning_max = Math.trunc(opts.versioningMax);
   if (opts.versioningMaxMb && opts.versioningMaxMb > 0) payload.versioning_max_mb = Math.trunc(opts.versioningMaxMb);
+  if (opts.allowWebhooks !== void 0) payload.allow_webhooks = !!opts.allowWebhooks;
+  if (opts.webhookUrl) payload.webhook_url = String(opts.webhookUrl);
+  if (opts.webhookEvents && opts.webhookEvents.length) payload.webhook_events = opts.webhookEvents;
+  if (opts.webhookSecret) payload.webhook_secret = String(opts.webhookSecret);
   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;

package/dist/index.mjs

@@ -151,12 +151,17 @@ function applyTenantOverrides(payload, opts) {
   if (opts.allowCodeEdit !== void 0) payload.allow_code_edit = !!opts.allowCodeEdit;
   if (opts.allowTerminal !== void 0) payload.allow_terminal = !!opts.allowTerminal;
   if (opts.terminalPtyUrl) payload.terminal_pty_url = String(opts.terminalPtyUrl);
+  if (opts.pdfToolsUrl) payload.pdf_tools_url = String(opts.pdfToolsUrl);
   if (opts.allowOptimize !== void 0) payload.allow_optimize = !!opts.allowOptimize;
   if (opts.allowShare !== void 0) payload.allow_share = !!opts.allowShare;
   if (opts.allowIntake !== void 0) payload.allow_intake = !!opts.allowIntake;
   if (opts.allowVersioning !== void 0) payload.allow_versioning = !!opts.allowVersioning;
   if (opts.versioningMax && opts.versioningMax > 0) payload.versioning_max = Math.trunc(opts.versioningMax);
   if (opts.versioningMaxMb && opts.versioningMaxMb > 0) payload.versioning_max_mb = Math.trunc(opts.versioningMaxMb);
+  if (opts.allowWebhooks !== void 0) payload.allow_webhooks = !!opts.allowWebhooks;
+  if (opts.webhookUrl) payload.webhook_url = String(opts.webhookUrl);
+  if (opts.webhookEvents && opts.webhookEvents.length) payload.webhook_events = opts.webhookEvents;
+  if (opts.webhookSecret) payload.webhook_secret = String(opts.webhookSecret);
   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;

package/package.json

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

@@ -145,6 +145,7 @@ function applyTenantOverrides(payload: Record<string, unknown>, opts: BaseTokenO
   // (Node mints for one), not a proxy adapter that doesn't serve /api/fm/terminal.
   if (opts.allowTerminal !== undefined) payload.allow_terminal = !!opts.allowTerminal;
   if (opts.terminalPtyUrl) payload.terminal_pty_url = String(opts.terminalPtyUrl);
+  if (opts.pdfToolsUrl) payload.pdf_tools_url = String(opts.pdfToolsUrl);
   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;
@@ -152,6 +153,10 @@ function applyTenantOverrides(payload: Record<string, unknown>, opts: BaseTokenO
   if (opts.allowVersioning !== undefined) payload.allow_versioning = !!opts.allowVersioning;
   if (opts.versioningMax && opts.versioningMax > 0) payload.versioning_max = Math.trunc(opts.versioningMax);
   if (opts.versioningMaxMb && opts.versioningMaxMb > 0) payload.versioning_max_mb = Math.trunc(opts.versioningMaxMb);
+  if (opts.allowWebhooks !== undefined) payload.allow_webhooks = !!opts.allowWebhooks;
+  if (opts.webhookUrl) payload.webhook_url = String(opts.webhookUrl);
+  if (opts.webhookEvents && opts.webhookEvents.length) payload.webhook_events = opts.webhookEvents;
+  if (opts.webhookSecret) payload.webhook_secret = String(opts.webhookSecret);
   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;

package/src/types.ts

@@ -109,6 +109,9 @@ export interface BaseTokenOptions {
    *  true interactive terminal instead of the built-in command-runner. Free; must be http(s).
    *  Core-standalone only (like `allowTerminal`). */
   terminalPtyUrl?: string;
+  /** Optional self-hosted PDF-tools URL (Stirling-PDF, or any web PDF toolkit). When set, the
+   *  UI shows a "PDF tools" action that embeds it (merge/split/OCR/convert/…). Free; http(s). */
+  pdfToolsUrl?: string;
   /** Allow the Optimization feature (POST /api/fm/optimize) — recompress images to WebP +
    *  compress PDFs. **Free/core**; default **false** because it replaces/deletes originals, so
    *  it's an opt-in capability. */
@@ -152,6 +155,14 @@ export interface BaseTokenOptions {
   versioningMax?: number;
   /** Skip versioning files bigger than this many MB. `0`/omitted = default (25). */
   versioningMaxMb?: number;
+  /** Webhooks module: fire a signed HTTP POST on file events. */
+  allowWebhooks?: boolean;
+  /** Endpoint the signed event is POSTed to (http/s only). */
+  webhookUrl?: string;
+  /** Only these event names fire the webhook (e.g. `['upload','delete']`). Empty = all. */
+  webhookEvents?: string[];
+  /** HMAC signing secret for the payload (`X-FluxFiles-Signature`). Empty = server secret. */
+  webhookSecret?: string;
   /** 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. */