@plotday/twister 0.62.0 → 0.63.0

package/dist/utils/markdown-html.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Convert Markdown to an HTML fragment suitable for an email body.
+ *
+ * - Plot mentions `[Name](#@UUID)` render as plain `@Name` text rather than a
+ *   broken link to the internal `#@UUID` href.
+ * - GitHub-flavoured Markdown is enabled, and single newlines become `<br>`
+ *   (`breaks: true`) so a message reads the way the author wrote it — the same
+ *   convention chat-style products (Slack, GitHub comments) use.
+ *
+ * Returns an HTML fragment (e.g. `<p>…</p>`), not a full document; the caller
+ * wraps it for its transport (a `text/html` MIME part, a Graph `body`, etc.).
+ * Empty/blank input yields an empty string.
+ */
+export declare function markdownToHtml(markdown: string | null | undefined): string;
+//# sourceMappingURL=markdown-html.d.ts.map

package/dist/utils/markdown-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-html.d.ts","sourceRoot":"","sources":["../../src/utils/markdown-html.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAiB1E"}

package/dist/utils/markdown-html.js

@@ -0,0 +1,35 @@
+/**
+ * Render Plot Markdown note content to HTML, for connectors that send the
+ * note out to a system whose native format is HTML email (Gmail, Outlook
+ * Mail). Kept separate from {@link markdownToPlainText} so connectors that
+ * only need the plain-text path don't pull the Markdown parser into their
+ * bundle (`sideEffects: false` lets the unused module tree-shake away).
+ */
+import { marked } from "marked";
+/**
+ * Convert Markdown to an HTML fragment suitable for an email body.
+ *
+ * - Plot mentions `[Name](#@UUID)` render as plain `@Name` text rather than a
+ *   broken link to the internal `#@UUID` href.
+ * - GitHub-flavoured Markdown is enabled, and single newlines become `<br>`
+ *   (`breaks: true`) so a message reads the way the author wrote it — the same
+ *   convention chat-style products (Slack, GitHub comments) use.
+ *
+ * Returns an HTML fragment (e.g. `<p>…</p>`), not a full document; the caller
+ * wraps it for its transport (a `text/html` MIME part, a Graph `body`, etc.).
+ * Empty/blank input yields an empty string.
+ */
+export function markdownToHtml(markdown) {
+    if (!markdown || markdown.trim() === "")
+        return "";
+    // Render mentions as "@Name" text before parsing so marked doesn't emit an
+    // anchor pointing at the internal "#@UUID" href.
+    const withMentions = markdown.replace(/\[([^\]]+)\]\(#@[^)]+\)/g, (_m, name) => `@${name}`);
+    const html = marked.parse(withMentions, {
+        async: false,
+        gfm: true,
+        breaks: true,
+    });
+    return html.trim();
+}
+//# sourceMappingURL=markdown-html.js.map

package/dist/utils/markdown-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-html.js","sourceRoot":"","sources":["../../src/utils/markdown-html.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,QAAmC;IAChE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAEnD,2EAA2E;IAC3E,iDAAiD;IACjD,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CACnC,0BAA0B,EAC1B,CAAC,EAAE,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CACjC,CAAC;IAEF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE;QACtC,KAAK,EAAE,KAAK;QACZ,GAAG,EAAE,IAAI;QACT,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IAEH,OAAQ,IAAe,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plotday/twister",
-  "version": "0.62.0",
+  "version": "0.63.0",
   "description": "Plot Twist Creator - Build intelligent extensions that integrate and automate",
   "type": "module",
   "main": "./dist/index.js",
@@ -124,6 +124,11 @@
       "types": "./dist/utils/markdown.d.ts",
       "default": "./dist/utils/markdown.js"
     },
+    "./utils/markdown-html": {
+      "@plotday/connector": "./src/utils/markdown-html.ts",
+      "types": "./dist/utils/markdown-html.d.ts",
+      "default": "./dist/utils/markdown-html.js"
+    },
     "./utils/uuid": {
       "@plotday/connector": "./src/utils/uuid.ts",
       "types": "./dist/utils/uuid.d.ts",
@@ -231,6 +236,7 @@
     "commander": "^12.0.0",
     "dotenv": "^16.4.5",
     "esbuild": "^0.24.0",
+    "marked": "^18.0.5",
     "prompts": "^2.4.2",
     "typebox": "^1.0.35",
     "uuid": "^11.0.5"

package/src/utils/markdown-html.ts

@@ -0,0 +1,40 @@
+/**
+ * Render Plot Markdown note content to HTML, for connectors that send the
+ * note out to a system whose native format is HTML email (Gmail, Outlook
+ * Mail). Kept separate from {@link markdownToPlainText} so connectors that
+ * only need the plain-text path don't pull the Markdown parser into their
+ * bundle (`sideEffects: false` lets the unused module tree-shake away).
+ */
+import { marked } from "marked";
+
+/**
+ * Convert Markdown to an HTML fragment suitable for an email body.
+ *
+ * - Plot mentions `[Name](#@UUID)` render as plain `@Name` text rather than a
+ *   broken link to the internal `#@UUID` href.
+ * - GitHub-flavoured Markdown is enabled, and single newlines become `<br>`
+ *   (`breaks: true`) so a message reads the way the author wrote it — the same
+ *   convention chat-style products (Slack, GitHub comments) use.
+ *
+ * Returns an HTML fragment (e.g. `<p>…</p>`), not a full document; the caller
+ * wraps it for its transport (a `text/html` MIME part, a Graph `body`, etc.).
+ * Empty/blank input yields an empty string.
+ */
+export function markdownToHtml(markdown: string | null | undefined): string {
+  if (!markdown || markdown.trim() === "") return "";
+
+  // Render mentions as "@Name" text before parsing so marked doesn't emit an
+  // anchor pointing at the internal "#@UUID" href.
+  const withMentions = markdown.replace(
+    /\[([^\]]+)\]\(#@[^)]+\)/g,
+    (_m, name: string) => `@${name}`
+  );
+
+  const html = marked.parse(withMentions, {
+    async: false,
+    gfm: true,
+    breaks: true,
+  });
+
+  return (html as string).trim();
+}