@nodegx/mcp 0.2.1 → 0.2.3

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodegx-mcp-bundles",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "private": true,
   "description": "Build metadata for the bundled CLIs beside it. See build-cloud-bundle.mjs: @noodl/platform reads it."
 }

package/dist/render-harness/data/node-catalog-enriched.json

@@ -37470,6 +37470,18 @@
           "isSignal": false,
           "description": "Object path inside the bucket, such as avatars/me.png. Supabase only. Leave blank to use the file's own name"
         },
+        {
+          "name": "photoQuality",
+          "displayName": "Photo Quality",
+          "group": "Shrink Photos",
+          "plug": "input",
+          "type": {
+            "name": "number"
+          },
+          "isSignal": false,
+          "default": 80,
+          "description": "How much detail a shrunk JPEG or WebP keeps, from 1 to 100; PNG keeps every pixel and its transparency, GIF and SVG are never shrunk"
+        },
         {
           "name": "private",
           "displayName": "Private",
@@ -37482,6 +37494,17 @@
           "default": false,
           "description": "Restricts the stored file to whoever uploaded it, so reading it later needs a Sign File URL node"
         },
+        {
+          "name": "readers",
+          "displayName": "Readers",
+          "group": "General",
+          "plug": "input",
+          "type": {
+            "name": "string"
+          },
+          "isSignal": false,
+          "description": "Roles that may read the file as well as whoever uploaded it, such as role:member, separated by commas; setting it makes the file private. NodeGX backends only"
+        },
         {
           "name": "recordId",
           "displayName": "Record ID (PocketBase)",
@@ -37493,6 +37516,18 @@
           "isSignal": false,
           "description": "Existing record to attach the file to. PocketBase only. Leave blank to create a new record as part of the upload"
         },
+        {
+          "name": "shrinkTo",
+          "displayName": "Shrink To",
+          "group": "Shrink Photos",
+          "plug": "input",
+          "type": {
+            "name": "number"
+          },
+          "isSignal": false,
+          "default": 0,
+          "description": "Makes a photo smaller in the browser before sending it, so its longer side is at most this many pixels; 0 sends every file as picked"
+        },
         {
           "name": "upload",
           "displayName": "Upload",
@@ -37635,6 +37670,15 @@
         "private": [
           "always: held as handed; read when the next Upload goes"
         ],
+        "readers": [
+          "always: held as handed; read when the next Upload goes — set, those roles may read the file as well as whoever uploaded it, and the file is private"
+        ],
+        "shrinkTo": [
+          "always: held as handed; read when the next Upload goes — above 0, a photo (not a GIF or an SVG) is drawn smaller in the browser first, its longer side at most this many pixels, and the smaller file is what goes; it goes as picked when it is already that small, when the smaller one would weigh more, or when the browser cannot read it"
+        ],
+        "photoQuality": [
+          "always: held as handed; read when the next Upload goes, and only when a photo is shrunk — 1 to 100 for a JPEG or WebP, anything else is 80; a PNG keeps every pixel"
+        ],
         "bucket": [
           "always: held as handed; read when the next Upload goes — set, the file goes to this bucket at Path (or under the file's own name)"
         ],
@@ -37651,7 +37695,7 @@
           "always: held as handed; read when the next Upload goes, and only with Collection — a half-filled group is no location at all"
         ],
         "upload": [
-          "always: its own upload at the frame's end — two presses are two uploads — with File, Private and the File Location held then: no File, or a Backend the project does not have, is Error, Error Status Code 0 and Failure at once; otherwise the backend answers with Cloud File then Done, or Error, Error Status Code and Failure"
+          "always: its own upload at the frame's end — two presses are two uploads — with File, Private, Readers and the File Location held then: no File, or a Backend the project does not have, is Error, Error Status Code 0 and Failure at once; otherwise the backend answers with Cloud File then Done, or Error, Error Status Code and Failure"
         ]
       },
       "enrichment": {

package/dist/render-harness/data/node-catalog.json

@@ -34883,6 +34883,18 @@
           "isSignal": false,
           "description": "Object path inside the bucket, such as avatars/me.png. Supabase only. Leave blank to use the file's own name"
         },
+        {
+          "name": "photoQuality",
+          "displayName": "Photo Quality",
+          "group": "Shrink Photos",
+          "plug": "input",
+          "type": {
+            "name": "number"
+          },
+          "isSignal": false,
+          "default": 80,
+          "description": "How much detail a shrunk JPEG or WebP keeps, from 1 to 100; PNG keeps every pixel and its transparency, GIF and SVG are never shrunk"
+        },
         {
           "name": "private",
           "displayName": "Private",
@@ -34895,6 +34907,17 @@
           "default": false,
           "description": "Restricts the stored file to whoever uploaded it, so reading it later needs a Sign File URL node"
         },
+        {
+          "name": "readers",
+          "displayName": "Readers",
+          "group": "General",
+          "plug": "input",
+          "type": {
+            "name": "string"
+          },
+          "isSignal": false,
+          "description": "Roles that may read the file as well as whoever uploaded it, such as role:member, separated by commas; setting it makes the file private. NodeGX backends only"
+        },
         {
           "name": "recordId",
           "displayName": "Record ID (PocketBase)",
@@ -34906,6 +34929,18 @@
           "isSignal": false,
           "description": "Existing record to attach the file to. PocketBase only. Leave blank to create a new record as part of the upload"
         },
+        {
+          "name": "shrinkTo",
+          "displayName": "Shrink To",
+          "group": "Shrink Photos",
+          "plug": "input",
+          "type": {
+            "name": "number"
+          },
+          "isSignal": false,
+          "default": 0,
+          "description": "Makes a photo smaller in the browser before sending it, so its longer side is at most this many pixels; 0 sends every file as picked"
+        },
         {
           "name": "upload",
           "displayName": "Upload",
@@ -35048,6 +35083,15 @@
         "private": [
           "always: held as handed; read when the next Upload goes"
         ],
+        "readers": [
+          "always: held as handed; read when the next Upload goes — set, those roles may read the file as well as whoever uploaded it, and the file is private"
+        ],
+        "shrinkTo": [
+          "always: held as handed; read when the next Upload goes — above 0, a photo (not a GIF or an SVG) is drawn smaller in the browser first, its longer side at most this many pixels, and the smaller file is what goes; it goes as picked when it is already that small, when the smaller one would weigh more, or when the browser cannot read it"
+        ],
+        "photoQuality": [
+          "always: held as handed; read when the next Upload goes, and only when a photo is shrunk — 1 to 100 for a JPEG or WebP, anything else is 80; a PNG keeps every pixel"
+        ],
         "bucket": [
           "always: held as handed; read when the next Upload goes — set, the file goes to this bucket at Path (or under the file's own name)"
         ],
@@ -35064,7 +35108,7 @@
           "always: held as handed; read when the next Upload goes, and only with Collection — a half-filled group is no location at all"
         ],
         "upload": [
-          "always: its own upload at the frame's end — two presses are two uploads — with File, Private and the File Location held then: no File, or a Backend the project does not have, is Error, Error Status Code 0 and Failure at once; otherwise the backend answers with Cloud File then Done, or Error, Error Status Code and Failure"
+          "always: its own upload at the frame's end — two presses are two uploads — with File, Private, Readers and the File Location held then: no File, or a Backend the project does not have, is Error, Error Status Code 0 and Failure at once; otherwise the backend answers with Cloud File then Done, or Error, Error Status Code and Failure"
         ]
       }
     },

package/dist/render-harness/drive-steps.js

@@ -551,7 +551,10 @@ var require_src = __commonJS({
       // two parts, a centred heading block and a toggle-and-price group ~260 px left of it.
       const byTop = [...inks].sort((a, b) => a.top - b.top);
       if (!byTop.every((k, i) => i === 0 || k.top >= byTop[i - 1].bottom - 2)) continue;
-      if (byTop.some((k) => k.height > 240)) continue;
+      // Two or more tall parts, not one: RL1's waitlist is eyebrow, heading, line and a 290 px form card in ONE group,
+      // and "any part > 240" skipped it \u2014 Richard saw the eyebrow off the centred heading (s6). A page of sections
+      // has many tall children; a section with one card has one.
+      if (byTop.filter((k) => k.height > 240).length > 1) continue;
       const centre = pr.left + pr.width / 2;
       const offOf = (k) => k.left + k.width / 2 - centre;
       const centred = byTop.filter((k) => Math.abs(offOf(k)) <= 12 && k.width < pr.width * 0.9);
@@ -564,6 +567,47 @@ var require_src = __commonJS({
     }
   }
 
+  // P112-OWN019-LETTEREDGE \u2014 words hard against the edge of the box that frames them. Richard on TL2's hero: seven
+  // outlined day chips, each letter pressed to its chip's left edge. The chip Group centred its child the way CSS
+  // would, but a Text stretches to its Group's width and sets its letters left, so the centring moved nothing. The
+  // frame is the nearest of the text's first four ancestors with a border or a fill (a page-wide band is not a frame,
+  // nor an inline highlight); the reading is the gap between the words' own ink (a Range) and the frame's inner left
+  // and right edges. Every width: a chip is a chip on a phone too. Raw numbers here; the judgement is summarise's.
+  layout.edgeTexts = [];
+  const EDGE_TEXT_MAX_GAP = 3;
+  if (typeof document.createRange === 'function' && typeof document.createTreeWalker === 'function') {
+    const shown = new Set(visible);
+    const range = document.createRange();
+    const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+    const framed = (el) => {
+      const cs = styleOf(el);
+      if (cs.display === 'inline') return false;
+      const bg = cs.backgroundColor;
+      return (bg && bg !== 'transparent' && !/rgba\\([^)]*,\\s*0\\)$/.test(bg)) || cs.backgroundImage !== 'none' ||
+        parseFloat(cs.borderLeftWidth) > 0 || parseFloat(cs.borderRightWidth) > 0;
+    };
+    const frames = new Set();
+    for (let n = walker.nextNode(); n; n = walker.nextNode()) {
+      const text = n.textContent.trim();
+      if (!text || !shown.has(n.parentElement)) continue;
+      let frame = null;
+      for (let e = n.parentElement, i = 0; e && e !== document.body && i < 4; e = e.parentElement, i++) {
+        if (framed(e)) { frame = e; break; }
+      }
+      if (!frame || frames.has(frame)) continue;
+      const fr = frame.getBoundingClientRect();
+      if (fr.width < 16 || fr.width >= vw * 0.98) continue;
+      range.selectNodeContents(n);
+      const r = range.getBoundingClientRect();
+      if (!(r.width > 0 && r.height > 0)) continue;
+      const fcs = styleOf(frame);
+      const left = r.left - (fr.left + (parseFloat(fcs.borderLeftWidth) || 0));
+      const right = fr.right - (parseFloat(fcs.borderRightWidth) || 0) - r.right;
+      frames.add(frame);
+      if (Math.min(left, right) < EDGE_TEXT_MAX_GAP) layout.edgeTexts.push({ cls: cls(frame), text: text.slice(0, 50), left: round(left), right: round(right), frameWidth: round(fr.width), frameHeight: round(fr.height) });
+    }
+  }
+
   const contentBottom = visible.reduce((lowest, el) => {
     const r = el.getBoundingClientRect();
     return r.width > 0 && r.height > 0 && r.bottom > lowest ? r.bottom : lowest;
@@ -718,7 +762,12 @@ var require_src = __commonJS({
        */
       RowGap: "row-gap",
       /** P112-OWN019-LAPTOPGAPS — a section that centres its heading and leaves another part off that centre (L1's price). */
-      AlignmentDrift: "alignment-drift"
+      AlignmentDrift: "alignment-drift",
+      /**
+       * P112-OWN019-LETTEREDGE (Richard 2026-10-15, TL2's hero). Words within 3 px of the inner left or right edge of the
+       * box that frames them (a border or a fill) — a letter in an outlined chip set left because its Text stretched.
+       */
+      TextAgainstEdge: "text-against-edge"
     };
     var SEVERITY_ORDER = { error: 0, warning: 1, info: 2 };
     var ROW_GAP_MIN_TALLEST = 48;
@@ -939,7 +988,7 @@ var require_src = __commonJS({
           });
         }
         if (isDesktop && v.layout) {
-          const gaps = (v.layout.rowGaps || []).filter((g) => g.tallest >= ROW_GAP_MIN_TALLEST && g.gap >= g.rowWidth * ROW_GAP_MIN_SHARE);
+          const gaps = (v.layout.rowGaps || []).filter((g) => (g.left || g.right) && g.tallest >= ROW_GAP_MIN_TALLEST && g.gap >= g.rowWidth * ROW_GAP_MIN_SHARE);
           const seen2 = /* @__PURE__ */ new Set();
           for (const g of gaps) {
             const key = `${g.left}|${g.right}`;
@@ -964,6 +1013,17 @@ var require_src = __commonJS({
             });
           }
         }
+        const edges = v.layout && v.layout.edgeTexts || [];
+        if (edges.length) {
+          const named = edges.slice(0, 3).map((e) => `"${e.text}" ${Math.max(0, Math.min(e.left, e.right))}px from the ${e.left <= e.right ? "left" : "right"} edge of its ${e.frameWidth}\xD7${e.frameHeight}px box`);
+          add({
+            code: RenderFinding.TextAgainstEdge,
+            severity: "warning",
+            viewport: name,
+            message: `${plural(edges.length, "text sits", "texts sit")} hard against the edge of the outlined or filled box that frames ${edges.length === 1 ? "it" : "them"}: ${named.join("; ")}. Centring a Group does not centre a Text's letters \u2014 the Text stretches to the Group's width and sets them left \u2014 so give the Text textAlignX: center, or give the box padding. Look at this width's screenshot.`,
+            evidence: edges.slice(0, 6)
+          });
+        }
         if (v.consoleErrors && v.consoleErrors.length) {
           add({
             code: RenderFinding.ConsoleError,
@@ -1970,6 +2030,11 @@ var require_render_report = __commonJS({
           "--no-default-browser-check",
           "--hide-scrollbars",
           "--disable-gpu",
+          // PARKED-THREE-S3-NOWEBGL: `--disable-gpu` alone leaves no WebGL, so a three.js scene (three-kit, garden-3d-kit)
+          // drew its "No WebGL here" fallback to the agent. Software GL brings WebGL back with no GPU (measured 2026-10-19 in
+          // this harness: gl false → true, the three-kit fixture's 12 meshes drawn); a page with no WebGL never touches it.
+          "--use-angle=swiftshader",
+          "--enable-unsafe-swiftshader",
           // P112-S14-KEYCHAIN: on macOS a page that touches storage makes Chrome open the login keychain. With no
           // keychain where `HOME` points (an empty HOME, a CI user) the OS shows "Keychain Not Found" on the person's
           // screen and Chrome waits for the answer, so the render hangs until its 240 s kill. A throwaway profile
@@ -2761,7 +2826,11 @@ async function runSteps(page, steps, { outDir, stubs = routeStubs(page), network
       } else if (verb === "watch") {
         const w = step.watch && typeof step.watch === "object" ? step.watch : {};
         if (w.look === void 0) throw new UsageError(`Step ${i + 1}: watch takes { look: T } or { look: [T, T, \u2026] }.`);
-        const forMs = Math.min(1e4, Math.max(100, Number(step.for_ms ?? 1500)));
+        const unknown = Object.keys(w).filter((k) => !["look", "for_ms", "expect"].includes(k));
+        if (unknown.length) throw new UsageError(`Step ${i + 1}: watch does not take ${unknown.map((k) => JSON.stringify(k)).join(", ")} \u2014 it takes look, for_ms and expect.`);
+        if (step.expect !== void 0 && w.expect !== void 0) throw new UsageError(`Step ${i + 1}: give watch one expect, beside it or inside it, not both.`);
+        const forMs = Math.min(1e4, Math.max(100, Number(step.for_ms ?? w.for_ms ?? 1500)));
+        const expect = step.expect !== void 0 ? step.expect : w.expect;
         const many = Array.isArray(w.look);
         const targets = many ? w.look : [w.look];
         if (targets.length === 0 || targets.length > 8) throw new UsageError(`Step ${i + 1}: watch looks at 1 to 8 targets.`);
@@ -2782,7 +2851,7 @@ async function runSteps(page, steps, { outDir, stubs = routeStubs(page), network
         }
         const shown = (list) => list.map(({ from, until, look }) => ({ from, until, look }));
         row.value = many ? targets.map((t, k) => ({ target: t, states: shown(states[k]) })) : shown(states[0]);
-        const never = step.expect && typeof step.expect === "object" ? step.expect.never : void 0;
+        const never = expect && typeof expect === "object" ? expect.never : void 0;
         if (never && typeof never === "object") {
           for (let k = 0; k < targets.length && row.ok; k++) {
             const hit = states[k].find((st) => st.look && Object.keys(never).every((key) => matches(st.look[key], never[key])));

package/dist/render-harness/measure-from-disk.js

@@ -551,7 +551,10 @@ var require_src = __commonJS({
       // two parts, a centred heading block and a toggle-and-price group ~260 px left of it.
       const byTop = [...inks].sort((a, b) => a.top - b.top);
       if (!byTop.every((k, i) => i === 0 || k.top >= byTop[i - 1].bottom - 2)) continue;
-      if (byTop.some((k) => k.height > 240)) continue;
+      // Two or more tall parts, not one: RL1's waitlist is eyebrow, heading, line and a 290 px form card in ONE group,
+      // and "any part > 240" skipped it \u2014 Richard saw the eyebrow off the centred heading (s6). A page of sections
+      // has many tall children; a section with one card has one.
+      if (byTop.filter((k) => k.height > 240).length > 1) continue;
       const centre = pr.left + pr.width / 2;
       const offOf = (k) => k.left + k.width / 2 - centre;
       const centred = byTop.filter((k) => Math.abs(offOf(k)) <= 12 && k.width < pr.width * 0.9);
@@ -564,6 +567,47 @@ var require_src = __commonJS({
     }
   }
 
+  // P112-OWN019-LETTEREDGE \u2014 words hard against the edge of the box that frames them. Richard on TL2's hero: seven
+  // outlined day chips, each letter pressed to its chip's left edge. The chip Group centred its child the way CSS
+  // would, but a Text stretches to its Group's width and sets its letters left, so the centring moved nothing. The
+  // frame is the nearest of the text's first four ancestors with a border or a fill (a page-wide band is not a frame,
+  // nor an inline highlight); the reading is the gap between the words' own ink (a Range) and the frame's inner left
+  // and right edges. Every width: a chip is a chip on a phone too. Raw numbers here; the judgement is summarise's.
+  layout.edgeTexts = [];
+  const EDGE_TEXT_MAX_GAP = 3;
+  if (typeof document.createRange === 'function' && typeof document.createTreeWalker === 'function') {
+    const shown = new Set(visible);
+    const range = document.createRange();
+    const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+    const framed = (el) => {
+      const cs = styleOf(el);
+      if (cs.display === 'inline') return false;
+      const bg = cs.backgroundColor;
+      return (bg && bg !== 'transparent' && !/rgba\\([^)]*,\\s*0\\)$/.test(bg)) || cs.backgroundImage !== 'none' ||
+        parseFloat(cs.borderLeftWidth) > 0 || parseFloat(cs.borderRightWidth) > 0;
+    };
+    const frames = new Set();
+    for (let n = walker.nextNode(); n; n = walker.nextNode()) {
+      const text = n.textContent.trim();
+      if (!text || !shown.has(n.parentElement)) continue;
+      let frame = null;
+      for (let e = n.parentElement, i = 0; e && e !== document.body && i < 4; e = e.parentElement, i++) {
+        if (framed(e)) { frame = e; break; }
+      }
+      if (!frame || frames.has(frame)) continue;
+      const fr = frame.getBoundingClientRect();
+      if (fr.width < 16 || fr.width >= vw * 0.98) continue;
+      range.selectNodeContents(n);
+      const r = range.getBoundingClientRect();
+      if (!(r.width > 0 && r.height > 0)) continue;
+      const fcs = styleOf(frame);
+      const left = r.left - (fr.left + (parseFloat(fcs.borderLeftWidth) || 0));
+      const right = fr.right - (parseFloat(fcs.borderRightWidth) || 0) - r.right;
+      frames.add(frame);
+      if (Math.min(left, right) < EDGE_TEXT_MAX_GAP) layout.edgeTexts.push({ cls: cls(frame), text: text.slice(0, 50), left: round(left), right: round(right), frameWidth: round(fr.width), frameHeight: round(fr.height) });
+    }
+  }
+
   const contentBottom = visible.reduce((lowest, el) => {
     const r = el.getBoundingClientRect();
     return r.width > 0 && r.height > 0 && r.bottom > lowest ? r.bottom : lowest;
@@ -718,7 +762,12 @@ var require_src = __commonJS({
        */
       RowGap: "row-gap",
       /** P112-OWN019-LAPTOPGAPS — a section that centres its heading and leaves another part off that centre (L1's price). */
-      AlignmentDrift: "alignment-drift"
+      AlignmentDrift: "alignment-drift",
+      /**
+       * P112-OWN019-LETTEREDGE (Richard 2026-10-15, TL2's hero). Words within 3 px of the inner left or right edge of the
+       * box that frames them (a border or a fill) — a letter in an outlined chip set left because its Text stretched.
+       */
+      TextAgainstEdge: "text-against-edge"
     };
     var SEVERITY_ORDER = { error: 0, warning: 1, info: 2 };
     var ROW_GAP_MIN_TALLEST = 48;
@@ -939,7 +988,7 @@ var require_src = __commonJS({
           });
         }
         if (isDesktop && v.layout) {
-          const gaps = (v.layout.rowGaps || []).filter((g) => g.tallest >= ROW_GAP_MIN_TALLEST && g.gap >= g.rowWidth * ROW_GAP_MIN_SHARE);
+          const gaps = (v.layout.rowGaps || []).filter((g) => (g.left || g.right) && g.tallest >= ROW_GAP_MIN_TALLEST && g.gap >= g.rowWidth * ROW_GAP_MIN_SHARE);
           const seen2 = /* @__PURE__ */ new Set();
           for (const g of gaps) {
             const key = `${g.left}|${g.right}`;
@@ -964,6 +1013,17 @@ var require_src = __commonJS({
             });
           }
         }
+        const edges = v.layout && v.layout.edgeTexts || [];
+        if (edges.length) {
+          const named = edges.slice(0, 3).map((e) => `"${e.text}" ${Math.max(0, Math.min(e.left, e.right))}px from the ${e.left <= e.right ? "left" : "right"} edge of its ${e.frameWidth}\xD7${e.frameHeight}px box`);
+          add({
+            code: RenderFinding.TextAgainstEdge,
+            severity: "warning",
+            viewport: name,
+            message: `${plural(edges.length, "text sits", "texts sit")} hard against the edge of the outlined or filled box that frames ${edges.length === 1 ? "it" : "them"}: ${named.join("; ")}. Centring a Group does not centre a Text's letters \u2014 the Text stretches to the Group's width and sets them left \u2014 so give the Text textAlignX: center, or give the box padding. Look at this width's screenshot.`,
+            evidence: edges.slice(0, 6)
+          });
+        }
         if (v.consoleErrors && v.consoleErrors.length) {
           add({
             code: RenderFinding.ConsoleError,
@@ -1970,6 +2030,11 @@ var require_render_report = __commonJS({
           "--no-default-browser-check",
           "--hide-scrollbars",
           "--disable-gpu",
+          // PARKED-THREE-S3-NOWEBGL: `--disable-gpu` alone leaves no WebGL, so a three.js scene (three-kit, garden-3d-kit)
+          // drew its "No WebGL here" fallback to the agent. Software GL brings WebGL back with no GPU (measured 2026-10-19 in
+          // this harness: gl false → true, the three-kit fixture's 12 meshes drawn); a page with no WebGL never touches it.
+          "--use-angle=swiftshader",
+          "--enable-unsafe-swiftshader",
           // P112-S14-KEYCHAIN: on macOS a page that touches storage makes Chrome open the login keychain. With no
           // keychain where `HOME` points (an empty HOME, a CI user) the OS shows "Keychain Not Found" on the person's
           // screen and Chrome waits for the answer, so the render hangs until its 240 s kill. A throwaway profile

package/dist/src/external/viewer/global.d.ts.keep

@@ -592,6 +592,19 @@ declare namespace Noodl {
         onProgress?: (progress: number) => void;
       }
     ): Promise<CloudFile>;
+
+    /**
+     * A link an image can use for a private file, the way the Sign File URL node mints one.
+     * Takes a CloudFile, a record's file (or an item of a list of them), or the stored name.
+     * Rejects for someone who could not read the file itself.
+     *
+     * Example:
+     * ```ts
+     *  const link = await Noodl.Files.sign(post.photos[0])
+     *  console.log(link.url, link.expiresAt)
+     * ```
+     */
+    sign(file: CloudFile | { name: string } | string): Promise<{ url: string; kind: string; expiresAt?: string; ttlSeconds?: number }>;
   }
 
   /**