@mh-gg/base-plugins 0.1.1-alpha.20260613T085325975Z

package/test/embed-autodetect-providers.test.cjs

@@ -0,0 +1,138 @@
+const assert = require("node:assert/strict");
+const test = require("node:test");
+
+const {
+  DEFAULT_MARKDOWN_PLUGINS,
+  EMBED_PROVIDER_KEYS,
+  RES_INSPIRED_EMBED_PROVIDERS,
+  autoDetectEmbeds,
+  extractUrlsFromText,
+  parseMarkdown,
+  pluginForDirective,
+  resolveEmbed
+} = require("../src/index.cjs");
+
+const providerCases = [
+  ["https://youtu.be/dQw4w9WgXcQ", "youtube", "video", "iframe"],
+  ["https://www.youtube.com/playlist?list=PL1234567890abcdef", "youtube", "video-playlist", "iframe"],
+  ["https://open.spotify.com/track/4uLU6hMCjMI75M1A2tKUQC", "spotify", "audio", "iframe"],
+  ["https://drive.google.com/file/d/abc123/view", "google-drive", "file", "iframe"],
+  ["https://docs.google.com/document/d/doc123/edit", "google-drive", "document", "iframe"],
+  ["https://photos.app.goo.gl/share123", "google-photos", "photo-album", "external-link"],
+  ["https://www.dropbox.com/s/example/file.pdf?dl=0", "dropbox", "document", "file-preview"],
+  ["https://vimeo.com/123456789", "vimeo", "video", "iframe"],
+  ["https://soundcloud.com/artist/track", "soundcloud", "audio", "iframe"],
+  ["https://artist.bandcamp.com/track/song", "bandcamp", "audio", "external-link"],
+  ["https://music.apple.com/us/album/demo/123", "apple-music", "audio", "external-link"],
+  ["https://www.twitch.tv/videos/123456789", "twitch", "video", "iframe"],
+  ["https://clips.twitch.tv/FineClipSlug", "twitch", "clip", "iframe"],
+  ["https://www.dailymotion.com/video/x7tgcz", "dailymotion", "video", "iframe"],
+  ["https://dai.ly/x7tgcz", "dailymotion", "video", "iframe"],
+  ["https://streamable.com/abcd12", "streamable", "video", "iframe"],
+  ["https://streamja.com/abcde", "streamja", "video", "iframe"],
+  ["https://coub.com/view/abc123", "coub", "video-loop", "iframe"],
+  ["https://i.imgur.com/abc1234.png", "imgur", "image", "image"],
+  ["https://i.imgur.com/abc1234.gifv", "imgur", "video", "video"],
+  ["https://imgur.com/a/album123", "imgur", "gallery", "external-link"],
+  ["https://giphy.com/gifs/funny-cat-abc123", "giphy", "gif", "image"],
+  ["https://tenor.com/view/cat-wave-123456", "tenor", "gif", "external-link"],
+  ["https://redgifs.com/watch/sampleclip", "redgifs", "video", "external-link"],
+  ["https://gfycat.com/serpentineoldfrog", "gfycat", "video", "external-link"],
+  ["https://gyazo.com/abc123", "gyazo", "image", "image"],
+  ["https://www.flickr.com/photos/user/123456789", "flickr", "photo", "external-link"],
+  ["https://500px.com/photo/123456/demo", "500px", "photo", "external-link"],
+  ["https://www.deviantart.com/user/art/title-123456", "deviantart", "artwork", "external-link"],
+  ["https://example.photobucket.com/albums/item.jpg", "photobucket", "photo", "external-link"],
+  ["https://www.pixiv.net/en/artworks/123456", "pixiv", "artwork", "external-link"],
+  ["https://staff.tumblr.com/post/123/demo", "tumblr", "post", "external-link"],
+  ["https://pbs.twimg.com/media/example.jpg", "twimg", "image", "image"],
+  ["https://www.instagram.com/p/ABCDEF/", "instagram", "social-post", "external-link"],
+  ["https://www.facebook.com/watch/?v=123456789", "facebook-video", "video", "external-link"],
+  ["https://www.tiktok.com/@user/video/1234567890", "tiktok", "video", "external-link"],
+  ["https://x.com/matterhorn/status/1234567890", "twitter", "social-post", "external-link"],
+  ["https://bsky.app/profile/example.com/post/3abc", "bluesky", "social-post", "external-link"],
+  ["https://i.redd.it/example.png", "reddit", "image", "image"],
+  ["https://www.reddit.com/gallery/abc123", "reddit", "gallery", "external-link"],
+  ["https://imgflip.com/i/abc123", "imgflip", "meme", "external-link"],
+  ["https://codepen.io/user/pen/abc123", "codepen", "code-demo", "iframe"],
+  ["https://jsfiddle.net/user/abc123/", "jsfiddle", "code-demo", "iframe"],
+  ["https://github.com/matterhorn/example", "github", "repository", "external-link"],
+  ["https://gist.github.com/user/abcdef", "gist", "code-snippet", "external-link"],
+  ["https://pastebin.com/abc123", "pastebin", "code-snippet", "iframe"],
+  ["https://hastebin.com/share/abc123", "hastebin", "code-snippet", "external-link"],
+  ["https://en.wikipedia.org/wiki/Markdown", "wikipedia", "article", "external-link"],
+  ["https://www.google.com/maps/place/New+York", "google-maps", "map", "external-link"],
+  ["https://www.openstreetmap.org/relation/175905", "openstreetmap", "map", "external-link"],
+  ["https://ridewithgps.com/routes/123456", "ridewithgps", "route", "external-link"],
+  ["https://1drv.ms/f/s!abc123", "onedrive", "file", "external-link"],
+  ["https://www.figma.com/file/abc123/demo", "figma", "design", "external-link"],
+  ["https://demo.notion.site/Launch-Plan-abc123", "notion", "document", "external-link"],
+  ["https://www.loom.com/share/abc123", "loom", "video", "external-link"],
+  ["https://www.canva.com/design/abc123/view", "canva", "design", "external-link"],
+  ["https://miro.com/app/board/abc123/", "miro", "whiteboard", "external-link"],
+  ["https://excalidraw.com/#json=abc123", "excalidraw", "whiteboard", "external-link"],
+  ["https://store.steampowered.com/app/730/CounterStrike_2/", "steam", "game", "external-link"],
+  ["https://xboxdvr.com/gamer/user/video/123", "xboxdvr", "game-clip", "external-link"],
+  ["https://xkcd.com/303/", "xkcd", "comic", "external-link"],
+  ["https://strawpoll.com/polls/abc123", "strawpoll", "poll", "external-link"],
+  ["https://video.joinpeertube.org/w/abc123", "peertube", "video", "external-link"],
+  ["https://clyp.it/abc123", "clyp", "audio", "external-link"],
+  ["https://getyarn.io/yarn-clip/abc123", "getyarn", "video-clip", "external-link"],
+  ["https://cdn.example.test/photo.webp", "image", "image", "image"],
+  ["https://cdn.example.test/movie.mp4", "video", "video", "video"],
+  ["https://cdn.example.test/audio.mp3", "audio", "audio", "audio"],
+  ["https://cdn.example.test/runbook.pdf", "document", "document", "file-preview"]
+];
+
+test("default embed registry covers a broad RES-inspired provider set", () => {
+  assert.ok(DEFAULT_MARKDOWN_PLUGINS.length >= 60, `expected a large provider registry, got ${DEFAULT_MARKDOWN_PLUGINS.length}`);
+  assert.ok(RES_INSPIRED_EMBED_PROVIDERS.includes("imgur"));
+  assert.ok(RES_INSPIRED_EMBED_PROVIDERS.includes("twitch"));
+  assert.ok(RES_INSPIRED_EMBED_PROVIDERS.includes("bluesky"));
+  assert.ok(EMBED_PROVIDER_KEYS.includes("youtube"));
+  assert.ok(EMBED_PROVIDER_KEYS.includes("spotify"));
+  assert.ok(EMBED_PROVIDER_KEYS.includes("soundcloud"));
+  assert.ok(EMBED_PROVIDER_KEYS.includes("figma"));
+});
+
+test("resolveEmbed auto-detects common media providers", () => {
+  for (const [url, provider, kind, renderMode] of providerCases) {
+    const embed = resolveEmbed(url, { title: "Shared item" });
+    assert.equal(embed.provider, provider, url);
+    assert.equal(embed.kind, kind, url);
+    assert.equal(embed.renderMode, renderMode, url);
+    assert.equal(embed.title, "Shared item");
+  }
+});
+
+test("directives and aliases resolve to the expected provider plugins", () => {
+  assert.equal(pluginForDirective("yt").provider, "youtube");
+  assert.equal(pluginForDirective("drive").provider, "google-drive");
+  assert.equal(pluginForDirective("bsky").provider, "bluesky");
+  assert.equal(pluginForDirective("fiddle").provider, "jsfiddle");
+  assert.equal(pluginForDirective("screen")?.provider, undefined);
+});
+
+test("autoDetectEmbeds extracts bare links, strips punctuation, dedupes, and can skip generic links", () => {
+  const text = "Watch https://vimeo.com/123456789, listen https://soundcloud.com/artist/track! duplicate https://vimeo.com/123456789 and plain https://example.com/story.";
+  const detected = autoDetectEmbeds(text);
+  assert.deepEqual(detected.map((embed) => embed.provider), ["vimeo", "soundcloud", "link"]);
+  assert.deepEqual(detected.map((embed) => embed.autoDetected), [true, true, true]);
+
+  const richOnly = autoDetectEmbeds(text, { includeGeneric: false });
+  assert.deepEqual(richOnly.map((embed) => embed.provider), ["vimeo", "soundcloud"]);
+});
+
+test("parseMarkdown auto-detects embeddables in markdown links, bare URLs, and directives", () => {
+  const parsed = parseMarkdown([
+    "# Media roundup",
+    "Here is [a tweet](https://x.com/matterhorn/status/1234567890) and https://streamable.com/abcd12.",
+    "::codepen[Demo pen](https://codepen.io/user/pen/abc123)",
+    "::figma[Design](https://www.figma.com/file/abc123/demo)"
+  ].join("\n\n"));
+  assert.deepEqual(parsed.embeds.map((embed) => embed.provider), ["twitter", "streamable", "codepen", "figma"]);
+  assert.equal(parsed.nodes[1].children[0].type, "text");
+  assert.equal(parsed.nodes[2].type, "embed");
+  assert.equal(parsed.embedCount, 4);
+});
+

package/test/markdown-media-workflow-plugins.test.cjs

@@ -0,0 +1,201 @@
+const assert = require("node:assert/strict");
+const test = require("node:test");
+const { manifestHash } = require("@mh-gg/base");
+const { createSignedPartyEvent, generatePartyIdentity, partyEventToNostrEvent } = require("@mh-gg/event");
+const { HostPluginRuntime, createMemoryOperationLog, createMemoryRoomStore } = require("@mh-gg/host-runtime");
+const { ensureOperationIdentity } = require("@mh-gg/protocol");
+const { buildExampleMatterhornApp, createExampleActor, createExampleOperationFactory } = require("../../../examples/_shared/matterhornExample/index.cjs");
+const {
+  APPROVALS_PLUGIN_ID,
+  ATTACHMENTS_PLUGIN_ID,
+  CALENDAR_PLUGIN_ID,
+  CHECKLISTS_PLUGIN_ID,
+  COMMENTS_PLUGIN_ID,
+  EMBEDS_PLUGIN_ID,
+  FILES_PLUGIN_ID,
+  LABELS_PLUGIN_ID,
+  MARKDOWN_PLUGIN_ID,
+  REACTIONS_PLUGIN_ID,
+  createCollaborationPluginSuite,
+  defineMarkdownPlugin,
+  parseMarkdown,
+  resolveEmbed
+} = require("../src/index.cjs");
+
+const suite = createCollaborationPluginSuite("all");
+const built = buildExampleMatterhornApp({
+  slug: "content-workflow",
+  packageName: "@mh-gg/base-plugins",
+  appId: "com.matterhorn.examples.content-workflow",
+  name: "Content Workflow Plugin Tests",
+  hostPlugins: [suite]
+});
+
+function actor(overrides = {}) {
+  return createExampleActor({ memberId: "admin", role: "admin", displayName: "Admin", ...overrides });
+}
+
+function makeOps() {
+  return createExampleOperationFactory({ appPack: built.appPack, hostPlugin: suite.plugins[0], roomId: "room_content", actor: actor(), startTime: 3000 });
+}
+
+async function runtime() {
+  const rt = new HostPluginRuntime({
+    room: { id: "room_content", appPack: { id: built.appPack.id, version: built.appPack.version, hash: manifestHash(built.appPack), protocolHash: built.appPack.compatibility.appProtocolHash } },
+    plugins: suite.plugins,
+    store: createMemoryRoomStore(),
+    operationLog: createMemoryOperationLog(),
+    authenticateActor: async (auth, actorValue) => {
+      assert.equal(auth.signature, "sig");
+      return actorValue;
+    }
+  });
+  await rt.start();
+  return rt;
+}
+
+async function rejected(promise, pattern) {
+  const result = await promise;
+  assert.equal(result.ok, false);
+  assert.match(result.reason, pattern);
+}
+
+test("markdown parser supports extension resolvers, media directives, inline links, lists, and code", () => {
+  const custom = defineMarkdownPlugin({
+    id: "markdown.embed.example-video",
+    provider: "example-video",
+    aliases: ["example"],
+    matchUrl(url) { return new URL(url).hostname === "video.example.test"; },
+    toEmbed(url, ctx = {}) {
+      return { provider: "example-video", kind: "video", title: ctx.title || "Example", url, externalUrl: url, renderMode: "card", metadata: { custom: true } };
+    }
+  });
+  const parsed = parseMarkdown(`# Demo\n\nA [clip](https://video.example.test/watch/1) and a bare https://open.spotify.com/track/4uLU6hMCjMI75M1A2tKUQC\n\n::youtube[Launch video](https://youtu.be/dQw4w9WgXcQ)\n\n- task one\n- task two\n\n\`\`\`js\nconsole.log(1)\n\`\`\``, { plugins: [custom, ...require("../src/index.cjs").DEFAULT_MARKDOWN_PLUGINS] });
+
+  assert.equal(parsed.nodes[0].type, "heading");
+  assert.equal(parsed.nodes.some((node) => node.type === "list"), true);
+  assert.equal(parsed.nodes.some((node) => node.type === "code" && node.language === "js"), true);
+  assert.deepEqual(parsed.embeds.map((embed) => embed.provider), ["example-video", "spotify", "youtube"]);
+  assert.equal(parsed.embeds.find((embed) => embed.provider === "youtube").embedUrl, "https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ");
+});
+
+test("embed resolver supports YouTube, Spotify, Dropbox, Google Drive, Google Photos, and generic links", () => {
+  const cases = [
+    ["https://www.youtube.com/watch?v=dQw4w9WgXcQ", "youtube", "iframe"],
+    ["https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M", "spotify", "iframe"],
+    ["https://www.dropbox.com/s/example/file.png?dl=0", "dropbox", "file-preview"],
+    ["https://drive.google.com/file/d/abc123/view?usp=sharing", "google-drive", "iframe"],
+    ["https://photos.app.goo.gl/abc123", "google-photos", "external-link"],
+    ["https://example.com/story", "link", "card"]
+  ];
+
+  for (const [url, provider, renderMode] of cases) {
+    const embed = resolveEmbed(url, { title: "Shared media" });
+    assert.equal(embed.provider, provider);
+    assert.equal(embed.renderMode, renderMode);
+    assert.equal(embed.title, "Shared media");
+  }
+  assert.throws(() => resolveEmbed("http://evil.example/video"), /https/);
+});
+
+test("markdown, embeds, and attachments plugins store parsed content and reusable media cards", async () => {
+  const rt = await runtime();
+  const op = makeOps();
+  const member = actor({ memberId: "mina", role: "member", displayName: "Mina" });
+  await rt.handleOperation(op("markdown.document.upsert", {
+    scopeType: "wiki-page",
+    scopeId: "page_1",
+    title: "Launch Plan",
+    markdown: "# Launch\n\nWatch :: no-op paragraph\n\n::spotify[Playlist](https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M)",
+    tags: ["launch", "music"]
+  }, { id: "markdown_1", pluginId: MARKDOWN_PLUGIN_ID, actor: member }));
+  await rt.handleOperation(op("embed.add", { scopeType: "wiki-page", scopeId: "page_1", url: "https://drive.google.com/file/d/abc123/view", title: "Spec" }, { id: "embed_1", pluginId: EMBEDS_PLUGIN_ID, actor: member }));
+  await rt.handleOperation(op("attachment.add", { scopeType: "wiki-page", scopeId: "page_1", url: "https://www.dropbox.com/s/example/file.pdf?dl=0", title: "Runbook", mimeType: "application/pdf" }, { id: "attachment_1", pluginId: ATTACHMENTS_PLUGIN_ID, actor: member }));
+
+  const document = await rt.query(MARKDOWN_PLUGIN_ID, "documentForScope", { scopeType: "wiki-page", scopeId: "page_1" }, member);
+  const embeds = await rt.query(EMBEDS_PLUGIN_ID, "embedsForScope", { scopeType: "wiki-page", scopeId: "page_1" }, member);
+  const attachments = await rt.query(ATTACHMENTS_PLUGIN_ID, "attachmentsForScope", { scopeType: "wiki-page", scopeId: "page_1" }, member);
+
+  assert.equal(document.title, "Launch Plan");
+  assert.equal(document.embeds[0].provider, "spotify");
+  assert.equal(embeds[0].provider, "google-drive");
+  assert.equal(attachments[0].provider, "dropbox");
+
+  await rejected(rt.handleOperation(op("embed.remove", { embedId: embeds[0].id }, { id: "embed_2", pluginId: EMBEDS_PLUGIN_ID, actor: actor({ memberId: "lee", role: "member" }) })), /Only embed authors/);
+  await rt.handleOperation(op("embed.remove", { embedId: embeds[0].id }, { id: "embed_3", pluginId: EMBEDS_PLUGIN_ID, actor: member }));
+  assert.deepEqual(await rt.query(EMBEDS_PLUGIN_ID, "embedsForScope", { scopeType: "wiki-page", scopeId: "page_1" }, member), []);
+});
+
+test("files plugin stores encrypted Nostr upload events by scope", async () => {
+  const rt = await runtime();
+  const op = makeOps();
+  const member = actor({ memberId: "mina", role: "member", displayName: "Mina" });
+  const fileEvent = partyEventToNostrEvent(createSignedPartyEvent({
+    kind: "file.upload",
+    partyId: "room_content",
+    identity: generatePartyIdentity(1000),
+    roomSecret: "invite-secret",
+    payload: {
+      fileName: "runbook.txt",
+      mimeType: "text/plain",
+      sizeBytes: 11,
+      sha256: "64ec88ca00b268e5ba1a35678a1b5316d212f4f366b2477232534a8aeca37f3c",
+      dataBase64: Buffer.from("hello world").toString("base64")
+    },
+    createdAt: 3001
+  }));
+  const result = await rt.handleOperation(op("file.upload", {
+    scopeType: "wiki-page",
+    scopeId: "page_1",
+    event: fileEvent
+  }, { id: "file_1", pluginId: FILES_PLUGIN_ID, actor: member, createdAt: 3001 }));
+
+  assert.equal(result.ok, true, result.reason);
+  const scoped = await rt.query(FILES_PLUGIN_ID, "filesForScope", { scopeType: "wiki-page", scopeId: "page_1" }, member);
+  assert.equal(scoped[0].eventId, fileEvent.id);
+  const stored = JSON.stringify(scoped[0]);
+  assert.equal(stored.includes("hello world"), false);
+  assert.equal(stored.includes("runbook.txt"), false);
+  assert.equal(stored.includes("text/plain"), false);
+  assert.equal(stored.includes("64ec88ca00b268e5ba1a35678a1b5316d212f4f366b2477232534a8aeca37f3c"), false);
+  await rejected(rt.handleOperation(op("file.remove", { fileId: scoped[0].id }, { id: "file_2", pluginId: FILES_PLUGIN_ID, actor: actor({ memberId: "lee", role: "member" }) })), /Only file uploaders/);
+  await rt.handleOperation(op("file.remove", { fileId: scoped[0].id }, { id: "file_3", pluginId: FILES_PLUGIN_ID, actor: member }));
+  assert.deepEqual(await rt.query(FILES_PLUGIN_ID, "filesForScope", { scopeType: "wiki-page", scopeId: "page_1" }, member), []);
+});
+
+test("workflow plugins compose reactions, labels, approvals, checklists, and calendar events", async () => {
+  const rt = await runtime();
+  const op = makeOps();
+  const member = actor({ memberId: "mina", role: "member", displayName: "Mina" });
+  await rt.handleOperation(op("reaction.toggle", { scopeType: "card", scopeId: "card_1", emoji: "🚀" }, { id: "react_1", pluginId: REACTIONS_PLUGIN_ID, actor: member }));
+  assert.deepEqual((await rt.query(REACTIONS_PLUGIN_ID, "reactionsForScope", { scopeType: "card", scopeId: "card_1" }, member)).reactions["🚀"], ["mina"]);
+
+  await rt.handleOperation(op("label.create", { name: "Blocked", color: "red" }, { id: "label_1", pluginId: LABELS_PLUGIN_ID }));
+  const labelId = Object.keys((await rt.getState()).plugins[LABELS_PLUGIN_ID].labels)[0];
+  await rt.handleOperation(op("label.apply", { scopeType: "card", scopeId: "card_1", labelId }, { id: "label_2", pluginId: LABELS_PLUGIN_ID, actor: member }));
+  assert.equal((await rt.query(LABELS_PLUGIN_ID, "labelsForScope", { scopeType: "card", scopeId: "card_1" }, member))[0].name, "Blocked");
+
+  await rt.handleOperation(op("approval.request", { scopeType: "budget-expense", scopeId: "expense_1", title: "Approve venue deposit", requiredRole: "admin" }, { id: "approval_1", pluginId: APPROVALS_PLUGIN_ID, actor: member }));
+  const requestId = Object.keys((await rt.getState()).plugins[APPROVALS_PLUGIN_ID].requests)[0];
+  await rejected(rt.handleOperation(op("approval.decide", { requestId, decision: "approved" }, { id: "approval_2", pluginId: APPROVALS_PLUGIN_ID, actor: actor({ memberId: "mod", role: "moderator" }) })), /Admins only/);
+  await rt.handleOperation(op("approval.decide", { requestId, decision: "approved", note: "Paid" }, { id: "approval_3", pluginId: APPROVALS_PLUGIN_ID }));
+  assert.deepEqual(await rt.query(APPROVALS_PLUGIN_ID, "openApprovals", {}, member), []);
+
+  await rt.handleOperation(op("checklist.create", { scopeType: "event-task", scopeId: "task_1", title: "Launch checklist", items: ["Book room", "Send invite"] }, { id: "check_1", pluginId: CHECKLISTS_PLUGIN_ID, actor: member }));
+  const checklist = (await rt.query(CHECKLISTS_PLUGIN_ID, "checklistsForScope", { scopeType: "event-task", scopeId: "task_1" }, member))[0];
+  await rt.handleOperation(op("checklist.item.toggle", { checklistId: checklist.id, itemId: checklist.items[0].id, completed: true }, { id: "check_2", pluginId: CHECKLISTS_PLUGIN_ID, actor: member }));
+  assert.equal((await rt.query(CHECKLISTS_PLUGIN_ID, "checklistsForScope", { scopeType: "event-task", scopeId: "task_1" }, member))[0].items[0].completed, true);
+
+  await rt.handleOperation(op("calendar.event.create", { scopeType: "event", scopeId: "event_1", title: "Doors", startsAt: 1900000000000, location: "Main hall" }, { id: "cal_1", pluginId: CALENDAR_PLUGIN_ID, actor: member }));
+  const upcoming = await rt.query(CALENDAR_PLUGIN_ID, "upcomingEvents", { now: 1800000000000 }, member);
+  assert.equal(upcoming[0].title, "Doors");
+});
+
+test("composer exposes content, workflow, project, and community presets", () => {
+  assert.equal(suite.hasPlugin(MARKDOWN_PLUGIN_ID), true);
+  assert.equal(suite.hasCapability("embed.youtube"), true);
+  assert.equal(suite.hasCapability("workflow.checklists"), true);
+  assert.deepEqual(createCollaborationPluginSuite("content").selection, ["markdown", "embeds", "files"]);
+  assert.deepEqual(createCollaborationPluginSuite("workflow").selection, ["labels", "approvals", "checklists", "calendar"]);
+  assert.equal(createCollaborationPluginSuite("community").hasPlugin("screenShare"), true);
+});

package/test/markdown-parser-edge-cases.test.cjs

@@ -0,0 +1,86 @@
+const assert = require("node:assert/strict");
+const test = require("node:test");
+
+const {
+  autoDetectEmbeds,
+  cleanUrlToken,
+  defineMarkdownPlugin,
+  extractUrlsFromText,
+  parseMarkdown,
+  pluginForDirective,
+  pluginForUrl,
+  renderMarkdownToPlainText,
+  resolveEmbed
+} = require("../src/markdown/index.cjs");
+const { createEmbedRecord } = require("../src/shared/index.cjs");
+
+const widgetPlugin = defineMarkdownPlugin({
+  id: "com.matterhorn.embed.widget",
+  provider: "widget",
+  aliases: ["w"],
+  matchUrl(url) {
+    return new URL(url).hostname === "widgets.example.com";
+  },
+  toEmbed(url, ctx = {}) {
+    return createEmbedRecord({ provider: "widget", kind: "widget", title: ctx.title || "Widget", url, renderMode: "interactive", metadata: { directive: ctx.directive || null } });
+  }
+});
+
+test("markdown parser handles code fences, blockquotes, lists, headings, and plain text rendering", () => {
+  const parsed = parseMarkdown([
+    "# Launch Notes",
+    "",
+    "> Keep this scoped",
+    "> and readable",
+    "",
+    "- Item one",
+    "- Item two with https://youtu.be/dQw4w9WgXcQ",
+    "",
+    "```js",
+    "const safe = true;",
+    "```"
+  ].join("\n"));
+
+  assert.deepEqual(parsed.nodes.map((node) => node.type), ["heading", "blockquote", "list", "code"]);
+  assert.equal(parsed.nodes[0].depth, 1);
+  assert.equal(parsed.nodes[2].items.length, 2);
+  assert.equal(parsed.nodes[3].language, "js");
+  assert.equal(parsed.embeds[0].provider, "youtube");
+  assert.match(renderMarkdownToPlainText(parsed), /Launch Notes/);
+  assert.match(parsed.text, /const safe = true/);
+});
+
+test("markdown parser supports custom directive and URL plugins without global mutation", () => {
+  const parsed = parseMarkdown("::w[Widget demo](https://widgets.example.com/demo)", { plugins: [widgetPlugin] });
+
+  assert.equal(parsed.nodes[0].type, "embed");
+  assert.equal(parsed.nodes[0].provider, "widget");
+  assert.equal(parsed.embeds[0].renderMode, "interactive");
+  assert.equal(parsed.embeds[0].metadata.directive, "w");
+  assert.equal(pluginForDirective("w", [widgetPlugin]).provider, "widget");
+  assert.equal(pluginForUrl("https://widgets.example.com/demo", [widgetPlugin]).provider, "widget");
+  assert.throws(() => parseMarkdown("::unknown[Nope](https://example.com)", { plugins: [widgetPlugin] }), /Unknown markdown directive unknown/);
+});
+
+test("auto detection trims punctuation, balances trailing parentheses, dedupes URLs, and can suppress generic links", () => {
+  assert.equal(cleanUrlToken("https://example.com/a)."), "https://example.com/a");
+  assert.equal(cleanUrlToken("https://example.com/a_(b))"), "https://example.com/a_(b)");
+
+  const text = "Watch (https://vimeo.com/123456789), then https://vimeo.com/123456789 and https://plain.example/path.";
+  const urls = extractUrlsFromText(text).map((entry) => entry.url);
+  const embeds = autoDetectEmbeds(text);
+  const filtered = autoDetectEmbeds(text, { includeGeneric: false });
+
+  assert.deepEqual(urls, ["https://vimeo.com/123456789", "https://vimeo.com/123456789", "https://plain.example/path"]);
+  assert.deepEqual(embeds.map((embed) => embed.provider), ["vimeo", "link"]);
+  assert.deepEqual(filtered.map((embed) => embed.provider), ["vimeo"]);
+});
+
+test("embed resolution normalizes URLs and rejects insecure non-local URLs", () => {
+  const local = resolveEmbed("http://localhost:8080/demo");
+  assert.equal(local.provider, "link");
+  assert.equal(local.url, "http://localhost:8080/demo");
+
+  assert.throws(() => resolveEmbed("http://example.com/not-allowed"), /url must use https unless it is localhost/);
+  assert.equal(resolveEmbed("https://open.spotify.com/track/abc#fragment").url, "https://open.spotify.com/track/abc");
+});

package/test/plugin-structure.test.cjs

@@ -0,0 +1,69 @@
+const assert = require("node:assert/strict");
+const fs = require("node:fs");
+const path = require("node:path");
+const test = require("node:test");
+
+const srcRoot = path.join(__dirname, "..", "src");
+
+function sourceFiles(dir = srcRoot) {
+  return fs.readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
+    const entryPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) return sourceFiles(entryPath);
+    return entry.name.endsWith(".cjs") ? [entryPath] : [];
+  });
+}
+
+function lineCount(file) {
+  return fs.readFileSync(file, "utf8").split("\n").length;
+}
+
+test("example plugin package uses capability folders rather than generic catch-all files", () => {
+  for (const forbidden of ["plugins.cjs", "workflow.cjs", "markdown.cjs", "composer.cjs"]) {
+    assert.equal(fs.existsSync(path.join(srcRoot, forbidden)), false, `${forbidden} should not exist at src root`);
+  }
+
+  for (const folder of [
+    "comments",
+    "presence",
+    "media-rooms",
+    "screen-share",
+    "markdown",
+    "markdown/providers",
+    "embeds",
+    "attachments",
+    "files",
+    "reactions",
+    "labels",
+    "approvals",
+    "checklists",
+    "calendar",
+    "crdt",
+    "composer"
+  ]) {
+    assert.equal(fs.existsSync(path.join(srcRoot, folder, "index.cjs")), true, `${folder} should expose an index barrel`);
+  }
+});
+
+test("example plugin source files stay small enough to remain composable", () => {
+  const tooLarge = sourceFiles()
+    .map((file) => ({ file: path.relative(srcRoot, file), lines: lineCount(file) }))
+    .filter(({ file, lines }) => lines > 260 && file !== "shared/index.cjs");
+
+  assert.deepEqual(tooLarge, []);
+});
+
+test("root plugin barrel is only a thin export surface", () => {
+  assert.ok(lineCount(path.join(srcRoot, "index.cjs")) <= 30);
+});
+
+
+test("capability subpath exports load the same focused modules as the root barrel", () => {
+  const root = require("../src/index.cjs");
+  assert.equal(require("../src/comments/index.cjs").commentsHostPlugin, root.commentsHostPlugin);
+  assert.equal(require("../src/media-rooms/index.cjs").mediaRoomsHostPlugin, root.mediaRoomsHostPlugin);
+  assert.equal(require("../src/markdown/index.cjs").parseMarkdown, root.parseMarkdown);
+  assert.equal(require("../src/embeds/index.cjs").embedsHostPlugin, root.embedsHostPlugin);
+  assert.equal(require("../src/files/index.cjs").filesHostPlugin, root.filesHostPlugin);
+  assert.equal(require("../src/crdt/index.cjs").crdtHostPlugin, root.crdtHostPlugin);
+  assert.equal(require("../src/composer/index.cjs").createCollaborationPluginSuite, root.createCollaborationPluginSuite);
+});