@fluxfiles/node 0.1.23 → 0.1.25

package/dist/index.d.mts

@@ -111,6 +111,9 @@ interface BaseTokenOptions {
     /** Optional self-hosted office suite URL (Collabora/OnlyOffice) for .docx/.xlsx/.pptx…. May
      *  carry a `{url}` placeholder the UI substitutes with the selected file's URL. Free; http(s). */
     officeUrl?: string;
+    /** Optional self-hosted e-signature URL (DocuSeal) for signing PDFs/docs. May carry a `{url}`
+     *  placeholder the UI substitutes with the selected file's URL. Free; http(s). */
+    esignUrl?: 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. */
@@ -143,6 +146,17 @@ interface BaseTokenOptions {
     /** Paid-module claims (3-layer gate: code installed + licensed + this claim).
      *  All default off; inert unless the module is installed & licensed on the server. */
     allowShare?: boolean;
+    /** Share landing: TTL (seconds) of the presigned S3/R2 URL a download redirects to.
+     *  Clamped to [10, 300] by the core; `0`/omitted = 60. On S3/R2 the download cap
+     *  counts **grants**, not GETs — this bounds that window. */
+    shareUrlTtl?: number;
+    /** Public base the share create response builds the recipient link from
+     *  (e.g. `https://files.acme.com/public/share.html`). http(s) only; empty = the
+     *  request origin. */
+    shareBaseUrl?: string;
+    /** Allow the share landing to render an inline preview (images via /api/fm/img;
+     *  PDFs only on uncapped shares). Default true; false = download-only. */
+    sharePreview?: boolean;
     allowIntake?: boolean;
     allowVersioning?: boolean;
     allowAiVision?: boolean;

package/dist/index.d.ts

@@ -111,6 +111,9 @@ interface BaseTokenOptions {
     /** Optional self-hosted office suite URL (Collabora/OnlyOffice) for .docx/.xlsx/.pptx…. May
      *  carry a `{url}` placeholder the UI substitutes with the selected file's URL. Free; http(s). */
     officeUrl?: string;
+    /** Optional self-hosted e-signature URL (DocuSeal) for signing PDFs/docs. May carry a `{url}`
+     *  placeholder the UI substitutes with the selected file's URL. Free; http(s). */
+    esignUrl?: 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. */
@@ -143,6 +146,17 @@ interface BaseTokenOptions {
     /** Paid-module claims (3-layer gate: code installed + licensed + this claim).
      *  All default off; inert unless the module is installed & licensed on the server. */
     allowShare?: boolean;
+    /** Share landing: TTL (seconds) of the presigned S3/R2 URL a download redirects to.
+     *  Clamped to [10, 300] by the core; `0`/omitted = 60. On S3/R2 the download cap
+     *  counts **grants**, not GETs — this bounds that window. */
+    shareUrlTtl?: number;
+    /** Public base the share create response builds the recipient link from
+     *  (e.g. `https://files.acme.com/public/share.html`). http(s) only; empty = the
+     *  request origin. */
+    shareBaseUrl?: string;
+    /** Allow the share landing to render an inline preview (images via /api/fm/img;
+     *  PDFs only on uncapped shares). Default true; false = download-only. */
+    sharePreview?: boolean;
     allowIntake?: boolean;
     allowVersioning?: boolean;
     allowAiVision?: boolean;

package/dist/index.js

@@ -175,8 +175,12 @@ function applyTenantOverrides(payload, opts) {
   if (opts.terminalPtyUrl) payload.terminal_pty_url = String(opts.terminalPtyUrl);
   if (opts.pdfToolsUrl) payload.pdf_tools_url = String(opts.pdfToolsUrl);
   if (opts.officeUrl) payload.office_url = String(opts.officeUrl);
+  if (opts.esignUrl) payload.esign_url = String(opts.esignUrl);
   if (opts.allowOptimize !== void 0) payload.allow_optimize = !!opts.allowOptimize;
   if (opts.allowShare !== void 0) payload.allow_share = !!opts.allowShare;
+  if (opts.shareUrlTtl && opts.shareUrlTtl > 0) payload.share_url_ttl = Math.trunc(opts.shareUrlTtl);
+  if (opts.shareBaseUrl) payload.share_base_url = String(opts.shareBaseUrl);
+  if (opts.sharePreview !== void 0) payload.share_preview = !!opts.sharePreview;
   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);

package/dist/index.mjs

@@ -153,8 +153,12 @@ function applyTenantOverrides(payload, opts) {
   if (opts.terminalPtyUrl) payload.terminal_pty_url = String(opts.terminalPtyUrl);
   if (opts.pdfToolsUrl) payload.pdf_tools_url = String(opts.pdfToolsUrl);
   if (opts.officeUrl) payload.office_url = String(opts.officeUrl);
+  if (opts.esignUrl) payload.esign_url = String(opts.esignUrl);
   if (opts.allowOptimize !== void 0) payload.allow_optimize = !!opts.allowOptimize;
   if (opts.allowShare !== void 0) payload.allow_share = !!opts.allowShare;
+  if (opts.shareUrlTtl && opts.shareUrlTtl > 0) payload.share_url_ttl = Math.trunc(opts.shareUrlTtl);
+  if (opts.shareBaseUrl) payload.share_base_url = String(opts.shareBaseUrl);
+  if (opts.sharePreview !== void 0) payload.share_preview = !!opts.sharePreview;
   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);

package/package.json

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

@@ -147,9 +147,15 @@ function applyTenantOverrides(payload: Record<string, unknown>, opts: BaseTokenO
   if (opts.terminalPtyUrl) payload.terminal_pty_url = String(opts.terminalPtyUrl);
   if (opts.pdfToolsUrl) payload.pdf_tools_url = String(opts.pdfToolsUrl);
   if (opts.officeUrl) payload.office_url = String(opts.officeUrl);
+  if (opts.esignUrl) payload.esign_url = String(opts.esignUrl);
   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;
+  // Share landing config — read at create time and baked into the share record
+  // (the core clamps the TTL and drops a non-http(s) base URL on decode).
+  if (opts.shareUrlTtl && opts.shareUrlTtl > 0) payload.share_url_ttl = Math.trunc(opts.shareUrlTtl);
+  if (opts.shareBaseUrl) payload.share_base_url = String(opts.shareBaseUrl);
+  if (opts.sharePreview !== undefined) payload.share_preview = !!opts.sharePreview;
   if (opts.allowIntake !== undefined) payload.allow_intake = !!opts.allowIntake;
   if (opts.allowVersioning !== undefined) payload.allow_versioning = !!opts.allowVersioning;
   if (opts.versioningMax && opts.versioningMax > 0) payload.versioning_max = Math.trunc(opts.versioningMax);

package/src/types.ts

@@ -115,6 +115,9 @@ export interface BaseTokenOptions {
   /** Optional self-hosted office suite URL (Collabora/OnlyOffice) for .docx/.xlsx/.pptx…. May
    *  carry a `{url}` placeholder the UI substitutes with the selected file's URL. Free; http(s). */
   officeUrl?: string;
+  /** Optional self-hosted e-signature URL (DocuSeal) for signing PDFs/docs. May carry a `{url}`
+   *  placeholder the UI substitutes with the selected file's URL. Free; http(s). */
+  esignUrl?: 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. */
@@ -147,6 +150,17 @@ export interface BaseTokenOptions {
   /** Paid-module claims (3-layer gate: code installed + licensed + this claim).
    *  All default off; inert unless the module is installed & licensed on the server. */
   allowShare?: boolean;
+  /** Share landing: TTL (seconds) of the presigned S3/R2 URL a download redirects to.
+   *  Clamped to [10, 300] by the core; `0`/omitted = 60. On S3/R2 the download cap
+   *  counts **grants**, not GETs — this bounds that window. */
+  shareUrlTtl?: number;
+  /** Public base the share create response builds the recipient link from
+   *  (e.g. `https://files.acme.com/public/share.html`). http(s) only; empty = the
+   *  request origin. */
+  shareBaseUrl?: string;
+  /** Allow the share landing to render an inline preview (images via /api/fm/img;
+   *  PDFs only on uncapped shares). Default true; false = download-only. */
+  sharePreview?: boolean;
   allowIntake?: boolean;
   allowVersioning?: boolean;
   allowAiVision?: boolean;