@mgsoftwarebv/mcp-server-bridge 3.5.12 → 3.5.13

package/dist/index.js

@@ -106586,6 +106586,24 @@ var TOOLS = [
       required: ["id"]
     }
   },
+  {
+    name: "get-document-link",
+    description: "Get a safe, usable link for a document (use after create-document to share it). Never leaks an auth/session URL. Choose `linkType`:\n- dashboard (default): internal editor deep link for logged-in Refront users, plus the current PDF status and a public link when the document is already shared publicly.\n- pdf_signed (alias: pdf): a temporary signed PDF download URL when a compiled PDF exists; if it is still compiling it returns pdfStatus 'pending' with pdfUrl null and triggers a (re)compile instead of failing.\n- public_share: enables a public customer share (token + visibility=public, recompiling only when no fresh PDF exists) and returns the /p/<token> link. Only use when the document may be shared publicly. Revoke later from the dashboard.\nReturns a JSON object: { documentId, title, status, dashboardUrl, pdfStatus (ready|stale|pending|unavailable), pdfUrl, publicShareUrl, expiresAt }. Respects team/provider access; draft/private documents never expose a public share URL unless they are actually shared.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: teamIdProp,
+        documentId: { type: "string", description: "Document ID (UUID)" },
+        linkType: {
+          type: "string",
+          enum: ["dashboard", "pdf_signed", "pdf", "public_share"],
+          default: "dashboard",
+          description: "dashboard (default) = editor URL + PDF status; pdf_signed (alias pdf) = temporary signed PDF download URL; public_share = enable + return the public /p/<token> link."
+        }
+      },
+      required: ["documentId"]
+    }
+  },
   {
     name: "create-document",
     description: 'Create a document (proposal, report, deliverables/opleverdocument, ...) from an array of content blocks. Use type \'deliverables\' for a document describing what was delivered for a customer; optionally pass `invoiceId` to link it to an invoice so it can be sent along as a PDF attachment. Each block is `{ id?, type, data }` (ids are auto-generated when omitted). Supported block types and their `data` shapes:\n- cover: { title, subtitle?, showLogo: bool, showDate: bool, clientName?, clientCompany?, date? }\n- toc: { title, maxDepth: 1-6 }\n- heading: { text, level: 1|2|3, numbered: bool }\n- text: { content: TipTapDoc | plain string (auto-converted; supports paragraphs and "- " bullet lists) }\n- callout: { variant: "info"|"warning"|"tip"|"important", title?, content: TipTapDoc | string }\n- table: { title?, headers: string[], rows: string[][] }\n- chart: { title?, chartType: "bar"|"line"|"pie", points: [{label, value}], seriesName?, series?: [{name, color?, points: [{label, value}]}], unit? ("\u20AC"|"%"|...), showValues: bool, color? }. Multi-series (bar/line only): extra series values are matched to the primary points by index; a legend is rendered automatically.\n- pricing: { title?, items: [{description, quantity?, unit?, price}], currency: "EUR", showTotal: bool, vatRate?, includeVat: bool }\n- timeline: { title?, phases: [{name, description?, duration, deliverables?: string[]}] }\n- two_column: { left: TipTapDoc|string, right: TipTapDoc|string, ratio?: "50_50"|"60_40"|"40_60"|"70_30"|"30_70" }\n- divider: { style: "page_break"|"line"|"space" }\n- signature: { title?, description?, signers: [{id, label, name?, company?, role?}] }\nAll text content runs through a humanizer that strips AI-sounding patterns (em-dashes, clich\xE9s, filler phrases); control it with `humanize`. The result includes ready-to-use links (internal dashboard editor URL + PDF status). Use get-document-link afterwards for a PDF download link or to publish a public customer share link.',
@@ -109730,6 +109748,59 @@ function ensureTipTapFormat(text3) {
   if (isTipTapJson(text3)) return text3;
   return JSON.stringify(plainTextToTipTap(text3));
 }
+
+// src/tools/document-links.ts
+function derivePdfStatus(doc) {
+  const currentHash = computeDocumentContentHash({
+    blocks: doc.blocks,
+    branding: doc.branding,
+    pageSize: doc.pageSize,
+    locale: doc.locale,
+    title: doc.title
+  });
+  if (doc.filePath) {
+    if (doc.compiledHash && doc.compiledHash === currentHash) {
+      return { status: "ready", currentHash };
+    }
+    return { status: "stale", currentHash };
+  }
+  if (doc.compiledHash) return { status: "pending", currentHash };
+  return { status: "unavailable", currentHash };
+}
+function getDashboardBaseUrl() {
+  return (process.env.DASHBOARD_URL || "https://app.refront.nl").replace(
+    /\/+$/,
+    ""
+  );
+}
+function buildDashboardUrl(documentId) {
+  return `${getDashboardBaseUrl()}/quotations/documents?editDocument=true&documentId=${encodeURIComponent(
+    documentId
+  )}`;
+}
+function buildPublicShareUrl(token) {
+  return `${getDashboardBaseUrl()}/p/${encodeURIComponent(token)}`;
+}
+function isPubliclyShared(doc) {
+  return !!doc.token && doc.shareVisibility === "public";
+}
+function formatDocumentLinksSummary(doc) {
+  const { status: pdfStatus } = derivePdfStatus(doc);
+  const lines = [
+    "\u{1F517} Links:",
+    `- Dashboard: ${buildDashboardUrl(doc.id)}`,
+    `- PDF status: ${pdfStatus}`
+  ];
+  if (isPubliclyShared(doc) && doc.token) {
+    lines.push(`- Public share: ${buildPublicShareUrl(doc.token)}`);
+  }
+  lines.push(
+    "- Use get-document-link (linkType pdf_signed for a temporary PDF download URL, public_share to publish a public link)."
+  );
+  return lines.join("\n");
+}
+
+// src/tools/documents.ts
 var DOCUMENT_TYPES = [
   "proposal",
   "plan_of_action",
@@ -109771,7 +109842,6 @@ var PDF_STATUS_LABEL = {
 };
 function buildLinksSection(doc, opts) {
   let status = computePdfStatus(doc);
-  if (opts?.compileTriggered && status !== "ready") status = "pending";
   const lines = [
     "Links:",
     `- Dashboard (internal, login required): ${documentDashboardUrl(doc.id)}`,
@@ -109872,7 +109942,10 @@ var TRIGGER_API_URL = process.env.TRIGGER_API_URL || "https://trigger-dev.mgsoft
 async function maybeTriggerPdfCompile(documentId, teamId) {
   const secret = process.env.TRIGGER_SECRET_KEY;
   if (!secret) {
-    return "PDF: niet gecompileerd (TRIGGER_SECRET_KEY ontbreekt); de dashboard-editor compileert bij openen/delen.";
+    return {
+      triggered: false,
+      message: "PDF: niet gecompileerd (TRIGGER_SECRET_KEY ontbreekt); de dashboard-editor compileert bij openen/delen."
+    };
   }
   try {
     const response = await fetch(
@@ -109888,12 +109961,21 @@ async function maybeTriggerPdfCompile(documentId, teamId) {
     );
     if (!response.ok) {
       const body = await response.text();
-      return `PDF: compile-trigger mislukt (HTTP ${response.status}): ${body.slice(0, 200)}`;
+      return {
+        triggered: false,
+        message: `PDF: compile-trigger mislukt (HTTP ${response.status}): ${body.slice(0, 200)}`
+      };
     }
     const json5 = await response.json();
-    return `PDF: compile-document-pdf getriggerd (run ${json5.id ?? "?"}).`;
+    return {
+      triggered: true,
+      message: `PDF: compile-document-pdf getriggerd (run ${json5.id ?? "?"}).`
+    };
   } catch (error49) {
-    return `PDF: compile-trigger mislukt: ${error49 instanceof Error ? error49.message : String(error49)}`;
+    return {
+      triggered: false,
+      message: `PDF: compile-trigger mislukt: ${error49 instanceof Error ? error49.message : String(error49)}`
+    };
   }
 }
 async function applyBlockOps(existing, ops, humanize) {
@@ -110078,7 +110160,7 @@ Type: ${doc.type} | Status: ${doc.status} | Locale: ${doc.locale}
 Team: ${doc.teamId}${doc.customerId ? ` | Customer: ${doc.customerId}` : ""}${doc.invoiceId ? ` | Invoice: ${doc.invoiceId}` : ""}
 Blocks (${blocks.length}): ${blockTypeSummary(blocks) || "none"}
 
-${buildLinksSection(doc)}
+${formatDocumentLinksSummary(doc)}
 
 Blocks JSON:
 \`\`\`json
@@ -110265,22 +110347,19 @@ async function handleCreateDocument(input) {
       content: [{ type: "text", text: "Error: document insert failed." }]
     };
   }
-  const pdfLine = compilePdf ? await maybeTriggerPdfCompile(created.id, resolved.teamId) : null;
-  const linksSection = buildLinksSection(
-    {
-      id: created.id,
-      title: title.trim(),
-      blocks: humanized.blocks,
-      branding: {},
-      pageSize: "a4",
-      locale,
-      filePath: null,
-      compiledHash: null,
-      token: null,
-      shareVisibility: "private"
-    },
-    { compileTriggered: compilePdf && Boolean(process.env.TRIGGER_SECRET_KEY) }
-  );
+  const pdfResult = compilePdf ? await maybeTriggerPdfCompile(created.id, resolved.teamId) : null;
+  const linksSummary = formatDocumentLinksSummary({
+    id: created.id,
+    title: title.trim(),
+    blocks: humanized.blocks,
+    branding: {},
+    pageSize: "a4",
+    locale,
+    filePath: null,
+    compiledHash: null,
+    token: null,
+    shareVisibility: "private"
+  });
   return {
     content: [
       {
@@ -110294,10 +110373,10 @@ Team: ${resolved.teamId}${customerId ? ` | Customer: ${customerId}` : ""}
 ${invoiceLine ? `${invoiceLine}
 ` : ""}Blocks (${humanized.blocks.length}): ${blockTypeSummary(humanized.blocks)}
 
-${humanized.summary}${pdfLine ? `
-${pdfLine}` : ""}
+${humanized.summary}${pdfResult ? `
+${pdfResult.message}` : ""}
 
-` + linksSection
+${linksSummary}`
       }
     ]
   };
@@ -110459,23 +110538,20 @@ async function handleUpdateDocument(input) {
     };
   }
   await db.update(schema_exports.documents).set(patch).where(eq(schema_exports.documents.id, doc.id));
-  const pdfLine = compilePdf ? await maybeTriggerPdfCompile(doc.id, doc.teamId) : null;
-  const linksSection = buildLinksSection(
-    {
-      id: doc.id,
-      title: patch.title ?? doc.title,
-      status: patch.status ?? doc.status,
-      blocks: patch.blocks ?? doc.blocks,
-      branding: doc.branding,
-      pageSize: doc.pageSize,
-      locale: doc.locale,
-      filePath: doc.filePath,
-      compiledHash: doc.compiledHash,
-      token: doc.token,
-      shareVisibility: doc.shareVisibility
-    },
-    { compileTriggered: compilePdf && Boolean(process.env.TRIGGER_SECRET_KEY) }
-  );
+  const pdfResult = compilePdf ? await maybeTriggerPdfCompile(doc.id, doc.teamId) : null;
+  const linksSummary = formatDocumentLinksSummary({
+    id: doc.id,
+    title: patch.title ?? doc.title,
+    status: patch.status ?? doc.status,
+    blocks: "blocks" in patch ? patch.blocks : doc.blocks,
+    branding: doc.branding,
+    pageSize: doc.pageSize,
+    locale: doc.locale,
+    filePath: doc.filePath,
+    compiledHash: doc.compiledHash,
+    token: doc.token,
+    shareVisibility: doc.shareVisibility
+  });
   return {
     content: [
       {
@@ -110485,10 +110561,10 @@ async function handleUpdateDocument(input) {
 ID: ${doc.id}
 ${changeLines.map((l4) => `- ${l4}`).join("\n")}${humanizeSummary ? `
 
-${humanizeSummary}` : ""}${pdfLine ? `
-${pdfLine}` : ""}
+${humanizeSummary}` : ""}${pdfResult ? `
+${pdfResult.message}` : ""}
 
-` + linksSection
+${linksSummary}`
       }
     ]
   };