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

package/src/markdown/providers/direct.cjs

@@ -0,0 +1,49 @@
+const {
+  cleanId,
+  createEmbedRecord,
+  defineMarkdownPlugin,
+  directRenderMode,
+  firstMatch,
+  hostEndsWith,
+  hostIs,
+  mediaKindFromPath,
+  normalizeUrl,
+  pathParts,
+  safeHostname,
+  simpleProvider
+} = require("../../shared/index.cjs");
+
+function directFilePlugin({ id, provider, aliases, extensions, kind, title, renderMode }) {
+  const pattern = new RegExp(`\\.(?:${extensions.join("|")})$`, "i");
+  return defineMarkdownPlugin({
+    id,
+    provider,
+    aliases,
+    matchUrl(url) { return pattern.test(new URL(url).pathname); },
+    toEmbed(url, ctx = {}) { return createEmbedRecord({ provider, kind, title: ctx.title || title, url, embedUrl: url, renderMode, metadata: { extension: new URL(url).pathname.split(".").pop().toLowerCase() } }); }
+  });
+}
+const directImageMarkdownPlugin = directFilePlugin({ id: "markdown.embed.direct-image", provider: "image", aliases: ["image", "img"], extensions: ["png", "jpe?g", "webp", "gif", "avif", "svg"], kind: "image", title: "Image", renderMode: "image" });
+const directVideoMarkdownPlugin = directFilePlugin({ id: "markdown.embed.direct-video", provider: "video", aliases: ["video", "mp4"], extensions: ["mp4", "webm", "mov", "m4v"], kind: "video", title: "Video", renderMode: "video" });
+const directAudioMarkdownPlugin = directFilePlugin({ id: "markdown.embed.direct-audio", provider: "audio", aliases: ["audio"], extensions: ["mp3", "wav", "ogg", "m4a", "flac"], kind: "audio", title: "Audio", renderMode: "audio" });
+const directDocumentMarkdownPlugin = directFilePlugin({ id: "markdown.embed.direct-document", provider: "document", aliases: ["pdf", "doc"], extensions: ["pdf"], kind: "document", title: "Document", renderMode: "file-preview" });
+
+const genericLinkMarkdownPlugin = defineMarkdownPlugin({
+  id: "markdown.embed.generic-link",
+  provider: "link",
+  aliases: ["embed", "link", "url"],
+  matchUrl() { return true; },
+  toEmbed(url, ctx = {}) {
+    const parsed = new URL(url);
+    return createEmbedRecord({ provider: "link", kind: "link", title: ctx.title || parsed.hostname.replace(/^www\./, ""), url, renderMode: "card", metadata: { host: parsed.hostname.toLowerCase() } });
+  }
+
+});
+
+module.exports = {
+  directAudioMarkdownPlugin,
+  directDocumentMarkdownPlugin,
+  directImageMarkdownPlugin,
+  directVideoMarkdownPlugin,
+  genericLinkMarkdownPlugin
+};

package/src/markdown/providers/games.cjs

@@ -0,0 +1,26 @@
+const {
+  cleanId,
+  createEmbedRecord,
+  defineMarkdownPlugin,
+  directRenderMode,
+  firstMatch,
+  hostEndsWith,
+  hostIs,
+  mediaKindFromPath,
+  normalizeUrl,
+  pathParts,
+  safeHostname,
+  simpleProvider
+} = require("../../shared/index.cjs");
+
+const steamMarkdownPlugin = simpleProvider({ id: "markdown.embed.steam", provider: "steam", aliases: ["steam", "steampowered", "steamcommunity"], hosts: ["store.steampowered.com", "steamcommunity.com"], kind: "game", title: "Steam item", renderMode: "external-link" });
+const xboxDvrMarkdownPlugin = simpleProvider({ id: "markdown.embed.xboxdvr", provider: "xboxdvr", aliases: ["xboxdvr"], hostSuffixes: ["xboxdvr.com", "gamerdvr.com"], kind: "game-clip", title: "Game clip", renderMode: "external-link" });
+const xkcdMarkdownPlugin = simpleProvider({ id: "markdown.embed.xkcd", provider: "xkcd", aliases: ["xkcd"], hosts: ["xkcd.com", "www.xkcd.com"], kind: "comic", title: (parsed) => `xkcd ${pathParts(parsed.toString())[0] || "comic"}`, renderMode: "external-link" });
+const strawpollMarkdownPlugin = simpleProvider({ id: "markdown.embed.strawpoll", provider: "strawpoll", aliases: ["strawpoll", "poll"], hostSuffixes: ["strawpoll.com", "strawpoll.me"], kind: "poll", title: "Strawpoll", renderMode: "external-link" });
+
+module.exports = {
+  steamMarkdownPlugin,
+  strawpollMarkdownPlugin,
+  xboxDvrMarkdownPlugin,
+  xkcdMarkdownPlugin
+};

package/src/markdown/providers/images.cjs

@@ -0,0 +1,88 @@
+const {
+  cleanId,
+  createEmbedRecord,
+  defineMarkdownPlugin,
+  directRenderMode,
+  firstMatch,
+  hostEndsWith,
+  hostIs,
+  mediaKindFromPath,
+  normalizeUrl,
+  pathParts,
+  safeHostname,
+  simpleProvider
+} = require("../../shared/index.cjs");
+
+const imgurMarkdownPlugin = defineMarkdownPlugin({
+  id: "markdown.embed.imgur",
+  provider: "imgur",
+  aliases: ["imgur"],
+  matchUrl(url) { return hostEndsWith(url, ["imgur.com"]); },
+  toEmbed(url, ctx = {}) {
+    const parsed = new URL(url);
+    const host = safeHostname(url);
+    const parts = pathParts(url);
+    const direct = host === "i.imgur.com" || /\.(?:png|jpe?g|gifv?|mp4|webm)$/i.test(parsed.pathname);
+    const albumId = parts[0] === "a" || parts[0] === "gallery" ? parts[1] : null;
+    const rawId = albumId || (direct ? parts.at(-1)?.replace(/\.(?:png|jpe?g|gifv?|mp4|webm)$/i, "") : parts[0]);
+    if (!rawId) throw new Error("Imgur URL is missing an id");
+    let embedUrl;
+    let renderMode = "external-link";
+    let kind = albumId ? "gallery" : mediaKindFromPath(parsed.pathname);
+    if (direct && kind === "image") { embedUrl = host === "i.imgur.com" ? url : `https://i.imgur.com/${cleanId(rawId)}.jpg`; renderMode = "image"; }
+    else if (direct && (kind === "video" || parsed.pathname.endsWith(".gifv"))) { embedUrl = `https://i.imgur.com/${cleanId(rawId)}.mp4`; renderMode = "video"; kind = "video"; }
+    return createEmbedRecord({ provider: "imgur", kind, title: ctx.title || (albumId ? "Imgur album" : "Imgur media"), url, ...(embedUrl ? { embedUrl } : {}), renderMode, metadata: { imgurId: rawId, albumId: albumId || null } });
+  }
+});
+
+const giphyMarkdownPlugin = defineMarkdownPlugin({
+  id: "markdown.embed.giphy",
+  provider: "giphy",
+  aliases: ["giphy"],
+  matchUrl(url) { return hostEndsWith(url, ["giphy.com"]); },
+  toEmbed(url, ctx = {}) {
+    const parsed = new URL(url);
+    const id = firstMatch([/\/gifs\/(?:[^/]+-)?([A-Za-z0-9]+)$/, /\/media\/([^/]+)\//], parsed.pathname)?.[1] || pathParts(url).at(-1);
+    return createEmbedRecord({ provider: "giphy", kind: "gif", title: ctx.title || "Giphy GIF", url, embedUrl: `https://media.giphy.com/media/${cleanId(id)}/giphy.gif`, renderMode: "image", metadata: { gifId: id } });
+  }
+});
+
+const tenorMarkdownPlugin = defineMarkdownPlugin({
+  id: "markdown.embed.tenor",
+  provider: "tenor",
+  aliases: ["tenor"],
+  matchUrl(url) { return hostEndsWith(url, ["tenor.com", "tenor.co", "media.tenor.com"]); },
+  toEmbed(url, ctx = {}) {
+    const parsed = new URL(url);
+    const kind = safeHostname(url).startsWith("media.tenor") ? mediaKindFromPath(parsed.pathname) : "gif";
+    return createEmbedRecord({ provider: "tenor", kind, title: ctx.title || "Tenor GIF", url, ...(kind === "image" || kind === "video" ? { embedUrl: url } : {}), renderMode: kind === "image" ? "image" : kind === "video" ? "video" : "external-link", metadata: { host: safeHostname(url) } });
+  }
+});
+
+const redgifsMarkdownPlugin = simpleProvider({ id: "markdown.embed.redgifs", provider: "redgifs", aliases: ["redgifs"], hosts: ["redgifs.com", "www.redgifs.com"], kind: "video", title: "Redgifs video", renderMode: "external-link", metadata: (parsed) => ({ slug: pathParts(parsed.toString()).at(-1) || null }) });
+const gfycatMarkdownPlugin = simpleProvider({ id: "markdown.embed.gfycat", provider: "gfycat", aliases: ["gfycat"], hosts: ["gfycat.com", "www.gfycat.com"], kind: "video", title: "Gfycat video", renderMode: "external-link", metadata: (parsed) => ({ slug: pathParts(parsed.toString()).at(-1) || null }) });
+const gyazoMarkdownPlugin = simpleProvider({ id: "markdown.embed.gyazo", provider: "gyazo", aliases: ["gyazo"], hosts: ["gyazo.com", "i.gyazo.com"], kind: (parsed) => mediaKindFromPath(parsed.pathname) === "file" ? "image" : mediaKindFromPath(parsed.pathname), title: "Gyazo capture", renderMode: (_parsed, kind) => directRenderMode(kind) });
+
+const flickrMarkdownPlugin = simpleProvider({ id: "markdown.embed.flickr", provider: "flickr", aliases: ["flickr"], hostSuffixes: ["flickr.com", "staticflickr.com"], kind: "photo", title: "Flickr photo", renderMode: "external-link" });
+const fiveHundredPxMarkdownPlugin = simpleProvider({ id: "markdown.embed.500px", provider: "500px", aliases: ["500px", "fivehundredpx"], hosts: ["500px.com"], kind: "photo", title: "500px photo", renderMode: "external-link" });
+const deviantArtMarkdownPlugin = simpleProvider({ id: "markdown.embed.deviantart", provider: "deviantart", aliases: ["deviantart"], hostSuffixes: ["deviantart.com", "deviantart.net"], kind: "artwork", title: "DeviantArt artwork", renderMode: "external-link" });
+const photobucketMarkdownPlugin = simpleProvider({ id: "markdown.embed.photobucket", provider: "photobucket", aliases: ["photobucket"], hostSuffixes: ["photobucket.com"], kind: "photo", title: "Photobucket image", renderMode: "external-link" });
+const pixivMarkdownPlugin = simpleProvider({ id: "markdown.embed.pixiv", provider: "pixiv", aliases: ["pixiv"], hosts: ["pixiv.net", "www.pixiv.net"], kind: "artwork", title: "Pixiv artwork", renderMode: "external-link" });
+const tumblrMarkdownPlugin = simpleProvider({ id: "markdown.embed.tumblr", provider: "tumblr", aliases: ["tumblr"], hostSuffixes: ["tumblr.com"], kind: "post", title: "Tumblr post", renderMode: "external-link" });
+const twimgMarkdownPlugin = simpleProvider({ id: "markdown.embed.twimg", provider: "twimg", aliases: ["twimg"], hostSuffixes: ["twimg.com"], kind: (parsed) => mediaKindFromPath(parsed.pathname), title: "Twitter media", renderMode: (_parsed, kind) => directRenderMode(kind) });
+
+module.exports = {
+  deviantArtMarkdownPlugin,
+  fiveHundredPxMarkdownPlugin,
+  flickrMarkdownPlugin,
+  gfycatMarkdownPlugin,
+  giphyMarkdownPlugin,
+  gyazoMarkdownPlugin,
+  imgurMarkdownPlugin,
+  photobucketMarkdownPlugin,
+  pixivMarkdownPlugin,
+  redgifsMarkdownPlugin,
+  tenorMarkdownPlugin,
+  tumblrMarkdownPlugin,
+  twimgMarkdownPlugin
+};

package/src/markdown/providers/index.cjs

@@ -0,0 +1,97 @@
+const { RES_INSPIRED_EMBED_PROVIDERS } = require("./res-inspired.cjs");
+const video = require("./video.cjs");
+const audio = require("./audio.cjs");
+const cloud = require("./cloud.cjs");
+const images = require("./images.cjs");
+const social = require("./social.cjs");
+const developer = require("./developer.cjs");
+const maps = require("./maps.cjs");
+const productivity = require("./productivity.cjs");
+const games = require("./games.cjs");
+const direct = require("./direct.cjs");
+
+const DEFAULT_MARKDOWN_PLUGINS = Object.freeze([
+  video.youtubeMarkdownPlugin,
+  audio.spotifyMarkdownPlugin,
+  cloud.googleDriveMarkdownPlugin,
+  cloud.googlePhotosMarkdownPlugin,
+  cloud.dropboxMarkdownPlugin,
+  video.vimeoMarkdownPlugin,
+  audio.soundcloudMarkdownPlugin,
+  audio.bandcampMarkdownPlugin,
+  audio.appleMusicMarkdownPlugin,
+  video.twitchMarkdownPlugin,
+  video.dailymotionMarkdownPlugin,
+  video.streamableMarkdownPlugin,
+  video.streamjaMarkdownPlugin,
+  video.coubMarkdownPlugin,
+  images.imgurMarkdownPlugin,
+  images.giphyMarkdownPlugin,
+  images.tenorMarkdownPlugin,
+  images.redgifsMarkdownPlugin,
+  images.gfycatMarkdownPlugin,
+  images.gyazoMarkdownPlugin,
+  images.flickrMarkdownPlugin,
+  images.fiveHundredPxMarkdownPlugin,
+  images.deviantArtMarkdownPlugin,
+  images.photobucketMarkdownPlugin,
+  images.pixivMarkdownPlugin,
+  images.tumblrMarkdownPlugin,
+  images.twimgMarkdownPlugin,
+  social.instagramMarkdownPlugin,
+  social.facebookVideoMarkdownPlugin,
+  social.tiktokMarkdownPlugin,
+  social.twitterMarkdownPlugin,
+  social.blueskyMarkdownPlugin,
+  social.redditMarkdownPlugin,
+  social.imgflipMarkdownPlugin,
+  developer.codepenMarkdownPlugin,
+  developer.jsfiddleMarkdownPlugin,
+  developer.githubMarkdownPlugin,
+  developer.gistMarkdownPlugin,
+  developer.pastebinMarkdownPlugin,
+  developer.hastebinMarkdownPlugin,
+  developer.wikipediaMarkdownPlugin,
+  maps.googleMapsMarkdownPlugin,
+  maps.openStreetMapMarkdownPlugin,
+  maps.rideWithGpsMarkdownPlugin,
+  cloud.onedriveMarkdownPlugin,
+  productivity.figmaMarkdownPlugin,
+  productivity.notionMarkdownPlugin,
+  productivity.loomMarkdownPlugin,
+  productivity.canvaMarkdownPlugin,
+  productivity.miroMarkdownPlugin,
+  productivity.excalidrawMarkdownPlugin,
+  games.steamMarkdownPlugin,
+  games.xboxDvrMarkdownPlugin,
+  games.xkcdMarkdownPlugin,
+  games.strawpollMarkdownPlugin,
+  video.peertubeMarkdownPlugin,
+  audio.clypMarkdownPlugin,
+  video.getyarnMarkdownPlugin,
+  direct.directImageMarkdownPlugin,
+  direct.directVideoMarkdownPlugin,
+  direct.directAudioMarkdownPlugin,
+  direct.directDocumentMarkdownPlugin,
+  direct.genericLinkMarkdownPlugin
+]);
+
+const EMBED_PROVIDER_KEYS = Object.freeze(DEFAULT_MARKDOWN_PLUGINS.map((plugin) => plugin.provider));
+const EMBED_PROVIDER_CAPABILITIES = Object.freeze(EMBED_PROVIDER_KEYS.map((provider) => `embed.${provider}`));
+
+module.exports = {
+  ...video,
+  ...audio,
+  ...cloud,
+  ...images,
+  ...social,
+  ...developer,
+  ...maps,
+  ...productivity,
+  ...games,
+  ...direct,
+  DEFAULT_MARKDOWN_PLUGINS,
+  EMBED_PROVIDER_CAPABILITIES,
+  EMBED_PROVIDER_KEYS,
+  RES_INSPIRED_EMBED_PROVIDERS
+};

package/src/markdown/providers/maps.cjs

@@ -0,0 +1,24 @@
+const {
+  cleanId,
+  createEmbedRecord,
+  defineMarkdownPlugin,
+  directRenderMode,
+  firstMatch,
+  hostEndsWith,
+  hostIs,
+  mediaKindFromPath,
+  normalizeUrl,
+  pathParts,
+  safeHostname,
+  simpleProvider
+} = require("../../shared/index.cjs");
+
+const googleMapsMarkdownPlugin = simpleProvider({ id: "markdown.embed.google-maps", provider: "google-maps", aliases: ["maps", "googlemaps", "map"], hosts: ["maps.google.com", "google.com", "goo.gl"], kind: "map", title: "Google Maps location", renderMode: "external-link", matchPath: (parsed) => parsed.hostname === "maps.google.com" || parsed.pathname.startsWith("/maps") || parsed.hostname === "goo.gl" });
+const openStreetMapMarkdownPlugin = simpleProvider({ id: "markdown.embed.openstreetmap", provider: "openstreetmap", aliases: ["osm", "openstreetmap"], hosts: ["openstreetmap.org", "www.openstreetmap.org"], kind: "map", title: "OpenStreetMap location", renderMode: "external-link" });
+const rideWithGpsMarkdownPlugin = simpleProvider({ id: "markdown.embed.ridewithgps", provider: "ridewithgps", aliases: ["ridewithgps"], hosts: ["ridewithgps.com", "www.ridewithgps.com"], kind: "route", title: "Ride with GPS route", renderMode: "external-link" });
+
+module.exports = {
+  googleMapsMarkdownPlugin,
+  openStreetMapMarkdownPlugin,
+  rideWithGpsMarkdownPlugin
+};

package/src/markdown/providers/productivity.cjs

@@ -0,0 +1,30 @@
+const {
+  cleanId,
+  createEmbedRecord,
+  defineMarkdownPlugin,
+  directRenderMode,
+  firstMatch,
+  hostEndsWith,
+  hostIs,
+  mediaKindFromPath,
+  normalizeUrl,
+  pathParts,
+  safeHostname,
+  simpleProvider
+} = require("../../shared/index.cjs");
+
+const figmaMarkdownPlugin = simpleProvider({ id: "markdown.embed.figma", provider: "figma", aliases: ["figma"], hosts: ["figma.com", "www.figma.com"], kind: "design", title: "Figma file", renderMode: "external-link" });
+const notionMarkdownPlugin = simpleProvider({ id: "markdown.embed.notion", provider: "notion", aliases: ["notion"], hostSuffixes: ["notion.site", "notion.so"], kind: "document", title: "Notion page", renderMode: "external-link" });
+const loomMarkdownPlugin = simpleProvider({ id: "markdown.embed.loom", provider: "loom", aliases: ["loom"], hosts: ["loom.com", "www.loom.com"], kind: "video", title: "Loom video", renderMode: "external-link" });
+const canvaMarkdownPlugin = simpleProvider({ id: "markdown.embed.canva", provider: "canva", aliases: ["canva"], hosts: ["canva.com", "www.canva.com"], kind: "design", title: "Canva design", renderMode: "external-link" });
+const miroMarkdownPlugin = simpleProvider({ id: "markdown.embed.miro", provider: "miro", aliases: ["miro"], hostSuffixes: ["miro.com"], kind: "whiteboard", title: "Miro board", renderMode: "external-link" });
+const excalidrawMarkdownPlugin = simpleProvider({ id: "markdown.embed.excalidraw", provider: "excalidraw", aliases: ["excalidraw"], hosts: ["excalidraw.com"], kind: "whiteboard", title: "Excalidraw drawing", renderMode: "external-link" });
+
+module.exports = {
+  canvaMarkdownPlugin,
+  excalidrawMarkdownPlugin,
+  figmaMarkdownPlugin,
+  loomMarkdownPlugin,
+  miroMarkdownPlugin,
+  notionMarkdownPlugin
+};

package/src/markdown/providers/res-inspired.cjs

@@ -0,0 +1,11 @@
+const RES_INSPIRED_EMBED_PROVIDERS = Object.freeze([
+  "aarli", "adultswim", "archilogic", "archiveis", "bime", "bluesky", "clyp", "codepen", "coub", "dailymotion",
+  "defaultImage", "defaultAudio", "defaultVideo", "deviantart", "dropbox", "facebookvideo", "fiveHundredPx", "flickr",
+  "gamerdvr", "getyarn", "gfycat", "giphy", "github", "googlemaps", "gyazo", "hastebin", "imgflip", "imgur",
+  "instagram", "ireddit", "jsfiddle", "onedrive", "pastebin", "peertube", "photobucket", "pixiv", "redditgallery",
+  "redditmedia", "redditpoll", "redgifs", "ridewithgps", "soundcloud", "spotify", "steamcommunity", "steampowered",
+  "strawpoll", "streamable", "streamja", "tenor", "tumblr", "twimg", "twitch", "twitchclips", "twitter", "vimeo",
+  "wikipedia", "xboxdvr", "xkcd", "youtube"
+]);
+
+module.exports = { RES_INSPIRED_EMBED_PROVIDERS };

package/src/markdown/providers/social.cjs

@@ -0,0 +1,33 @@
+const {
+  cleanId,
+  createEmbedRecord,
+  defineMarkdownPlugin,
+  directRenderMode,
+  firstMatch,
+  hostEndsWith,
+  hostIs,
+  mediaKindFromPath,
+  normalizeUrl,
+  pathParts,
+  safeHostname,
+  simpleProvider
+} = require("../../shared/index.cjs");
+
+const instagramMarkdownPlugin = simpleProvider({ id: "markdown.embed.instagram", provider: "instagram", aliases: ["instagram", "ig"], hosts: ["instagram.com"], kind: "social-post", title: "Instagram post", renderMode: "external-link", matchPath: (parsed) => ["p", "reel", "tv"].includes(pathParts(parsed.toString())[0]) });
+const facebookVideoMarkdownPlugin = simpleProvider({ id: "markdown.embed.facebook-video", provider: "facebook-video", aliases: ["facebook", "fb"], hostSuffixes: ["facebook.com", "fb.watch"], kind: "video", title: "Facebook video", renderMode: "external-link" });
+const tiktokMarkdownPlugin = simpleProvider({ id: "markdown.embed.tiktok", provider: "tiktok", aliases: ["tiktok"], hostSuffixes: ["tiktok.com"], kind: "video", title: "TikTok video", renderMode: "external-link" });
+const twitterMarkdownPlugin = simpleProvider({ id: "markdown.embed.twitter", provider: "twitter", aliases: ["twitter", "x", "tweet"], hosts: ["twitter.com", "x.com", "mobile.twitter.com"], kind: "social-post", title: "Social post", renderMode: "external-link", matchPath: (parsed) => pathParts(parsed.toString()).includes("status") });
+const blueskyMarkdownPlugin = simpleProvider({ id: "markdown.embed.bluesky", provider: "bluesky", aliases: ["bluesky", "bsky"], hosts: ["bsky.app"], kind: "social-post", title: "Bluesky post", renderMode: "external-link", matchPath: (parsed) => pathParts(parsed.toString()).includes("post") });
+
+const redditMarkdownPlugin = simpleProvider({ id: "markdown.embed.reddit", provider: "reddit", aliases: ["reddit", "ireddit", "vreddit", "redditgallery", "redditpoll"], hostSuffixes: ["reddit.com", "redd.it", "i.redd.it", "v.redd.it", "redditmedia.com", "redditstatic.com"], kind: (parsed) => parsed.hostname.includes("i.redd.it") ? mediaKindFromPath(parsed.pathname) : parsed.hostname.includes("v.redd.it") ? "video" : parsed.pathname.startsWith("/gallery/") ? "gallery" : "reddit-post", title: "Reddit item", renderMode: (_parsed, kind) => directRenderMode(kind) === "card" ? "external-link" : directRenderMode(kind) });
+const imgflipMarkdownPlugin = simpleProvider({ id: "markdown.embed.imgflip", provider: "imgflip", aliases: ["imgflip"], hosts: ["imgflip.com", "i.imgflip.com"], kind: "meme", title: "Imgflip meme", renderMode: "external-link" });
+
+module.exports = {
+  blueskyMarkdownPlugin,
+  facebookVideoMarkdownPlugin,
+  imgflipMarkdownPlugin,
+  instagramMarkdownPlugin,
+  redditMarkdownPlugin,
+  tiktokMarkdownPlugin,
+  twitterMarkdownPlugin
+};

package/src/markdown/providers/video.cjs

@@ -0,0 +1,139 @@
+const {
+  cleanId,
+  createEmbedRecord,
+  defineMarkdownPlugin,
+  directRenderMode,
+  firstMatch,
+  hostEndsWith,
+  hostIs,
+  mediaKindFromPath,
+  normalizeUrl,
+  pathParts,
+  safeHostname,
+  simpleProvider
+} = require("../../shared/index.cjs");
+
+const youtubeMarkdownPlugin = defineMarkdownPlugin({
+  id: "markdown.embed.youtube",
+  provider: "youtube",
+  aliases: ["youtube", "yt", "youtu"],
+  matchUrl(url) {
+    const parsed = new URL(url);
+    const host = parsed.hostname.toLowerCase().replace(/^www\./, "");
+    return ["youtube.com", "m.youtube.com", "youtu.be", "youtube-nocookie.com", "music.youtube.com"].includes(host);
+  },
+  toEmbed(url, ctx = {}) {
+    const parsed = new URL(url);
+    const host = parsed.hostname.toLowerCase().replace(/^www\./, "");
+    const id = host === "youtu.be"
+      ? parsed.pathname.split("/").filter(Boolean)[0]
+      : parsed.searchParams.get("v") || firstMatch([/^\/shorts\/([^/?#]+)/, /^\/embed\/([^/?#]+)/, /^\/live\/([^/?#]+)/], parsed.pathname)?.[1];
+    const playlistId = parsed.searchParams.get("list");
+    if (!id && playlistId) {
+      return createEmbedRecord({
+        provider: "youtube",
+        kind: "video-playlist",
+        title: ctx.title || "YouTube playlist",
+        url,
+        embedUrl: `https://www.youtube-nocookie.com/embed/videoseries?list=${encodeURIComponent(playlistId)}`,
+        renderMode: "iframe",
+        metadata: { playlistId }
+      });
+    }
+    if (!id || !/^[A-Za-z0-9_-]{6,}$/.test(id)) throw new Error("YouTube URL is missing a video id");
+    return createEmbedRecord({
+      provider: "youtube",
+      kind: "video",
+      title: ctx.title || "YouTube video",
+      url,
+      embedUrl: `https://www.youtube-nocookie.com/embed/${id}`,
+      thumbnailUrl: `https://i.ytimg.com/vi/${id}/hqdefault.jpg`,
+      renderMode: "iframe",
+      metadata: { videoId: id, playlistId: playlistId || null }
+    });
+  }
+});
+
+const vimeoMarkdownPlugin = defineMarkdownPlugin({
+  id: "markdown.embed.vimeo",
+  provider: "vimeo",
+  aliases: ["vimeo"],
+  matchUrl(url) { return hostIs(url, ["vimeo.com", "player.vimeo.com"]) && Boolean(firstMatch([/^\/(?:video\/)?([0-9]+)/], new URL(url).pathname)); },
+  toEmbed(url, ctx = {}) {
+    const id = firstMatch([/^\/(?:video\/)?([0-9]+)/], new URL(url).pathname)?.[1];
+    return createEmbedRecord({ provider: "vimeo", kind: "video", title: ctx.title || "Vimeo video", url, embedUrl: `https://player.vimeo.com/video/${id}`, renderMode: "iframe", metadata: { videoId: id } });
+  }
+});
+
+const twitchMarkdownPlugin = defineMarkdownPlugin({
+  id: "markdown.embed.twitch",
+  provider: "twitch",
+  aliases: ["twitch", "twitchclips", "clip"],
+  matchUrl(url) { return hostIs(url, ["twitch.tv", "m.twitch.tv", "clips.twitch.tv"]); },
+  toEmbed(url, ctx = {}) {
+    const parsed = new URL(url);
+    const parts = pathParts(url);
+    const host = safeHostname(url);
+    let embedUrl;
+    let kind = "livestream";
+    const clipSlug = host === "clips.twitch.tv" ? parts[0] : (parts[1] === "clip" ? parts[2] : null);
+    if (parts[0] === "videos" && parts[1]) { kind = "video"; embedUrl = `https://player.twitch.tv/?video=${cleanId(parts[1])}&parent=matterhorn.gg&autoplay=false`; }
+    else if (clipSlug) { kind = "clip"; embedUrl = `https://clips.twitch.tv/embed?clip=${cleanId(clipSlug)}&parent=matterhorn.gg&autoplay=false`; }
+    else if (parts[0]) { embedUrl = `https://player.twitch.tv/?channel=${cleanId(parts[0])}&parent=matterhorn.gg&autoplay=false`; }
+    else throw new Error("Twitch URL is missing a channel, video, or clip id");
+    return createEmbedRecord({ provider: "twitch", kind, title: ctx.title || "Twitch stream", url, embedUrl, renderMode: "iframe", metadata: { kind, channel: parts[0] || null, clipSlug: clipSlug || null } });
+  }
+});
+
+const dailymotionMarkdownPlugin = defineMarkdownPlugin({
+  id: "markdown.embed.dailymotion",
+  provider: "dailymotion",
+  aliases: ["dailymotion", "daily"],
+  matchUrl(url) { return hostIs(url, ["dailymotion.com", "dai.ly"]); },
+  toEmbed(url, ctx = {}) {
+    const parsed = new URL(url);
+    const id = safeHostname(url) === "dai.ly" ? pathParts(url)[0] : firstMatch([/\/video\/([^_/?#]+)/], parsed.pathname)?.[1];
+    if (!id) throw new Error("Dailymotion URL is missing a video id");
+    return createEmbedRecord({ provider: "dailymotion", kind: "video", title: ctx.title || "Dailymotion video", url, embedUrl: `https://www.dailymotion.com/embed/video/${cleanId(id)}`, renderMode: "iframe", metadata: { videoId: id } });
+  }
+});
+
+const streamableMarkdownPlugin = defineMarkdownPlugin({
+  id: "markdown.embed.streamable",
+  provider: "streamable",
+  aliases: ["streamable"],
+  matchUrl(url) { return hostIs(url, ["streamable.com"]) && pathParts(url)[0]; },
+  toEmbed(url, ctx = {}) { const id = pathParts(url)[0]; return createEmbedRecord({ provider: "streamable", kind: "video", title: ctx.title || "Streamable video", url, embedUrl: `https://streamable.com/e/${cleanId(id)}`, renderMode: "iframe", metadata: { videoId: id } }); }
+});
+
+const streamjaMarkdownPlugin = defineMarkdownPlugin({
+  id: "markdown.embed.streamja",
+  provider: "streamja",
+  aliases: ["streamja"],
+  matchUrl(url) { return hostIs(url, ["streamja.com"]) && pathParts(url)[0]; },
+  toEmbed(url, ctx = {}) { const id = pathParts(url)[0]; return createEmbedRecord({ provider: "streamja", kind: "video", title: ctx.title || "Streamja video", url, embedUrl: `https://streamja.com/embed/${cleanId(id)}`, renderMode: "iframe", metadata: { videoId: id } }); }
+});
+
+const coubMarkdownPlugin = defineMarkdownPlugin({
+  id: "markdown.embed.coub",
+  provider: "coub",
+  aliases: ["coub"],
+  matchUrl(url) { return hostIs(url, ["coub.com"]) && pathParts(url)[0] === "view" && pathParts(url)[1]; },
+  toEmbed(url, ctx = {}) { const id = pathParts(url)[1]; return createEmbedRecord({ provider: "coub", kind: "video-loop", title: ctx.title || "Coub", url, embedUrl: `https://coub.com/embed/${cleanId(id)}`, renderMode: "iframe", metadata: { coubId: id } }); }
+});
+
+const peertubeMarkdownPlugin = simpleProvider({ id: "markdown.embed.peertube", provider: "peertube", aliases: ["peertube"], hostSuffixes: ["joinpeertube.org"], kind: "video", title: "PeerTube video", renderMode: "external-link", matchPath: (parsed) => /\/(w|videos\/watch)\//.test(parsed.pathname) });
+const clypMarkdownPlugin = simpleProvider({ id: "markdown.embed.clyp", provider: "clyp", aliases: ["clyp"], hostSuffixes: ["clyp.it"], kind: "audio", title: "Clyp audio", renderMode: "external-link" });
+const getyarnMarkdownPlugin = simpleProvider({ id: "markdown.embed.getyarn", provider: "getyarn", aliases: ["getyarn", "yarn"], hosts: ["getyarn.io", "yarn.co"], kind: "video-clip", title: "Yarn clip", renderMode: "external-link" });
+
+module.exports = {
+  coubMarkdownPlugin,
+  dailymotionMarkdownPlugin,
+  getyarnMarkdownPlugin,
+  peertubeMarkdownPlugin,
+  streamableMarkdownPlugin,
+  streamjaMarkdownPlugin,
+  twitchMarkdownPlugin,
+  vimeoMarkdownPlugin,
+  youtubeMarkdownPlugin
+};

package/src/markdown/resolve.cjs

@@ -0,0 +1,87 @@
+const { normalizeUrl } = require("../shared/index.cjs");
+const {
+  DEFAULT_MARKDOWN_PLUGINS,
+  genericLinkMarkdownPlugin
+} = require("./providers/index.cjs");
+
+function pluginForUrl(url, plugins = DEFAULT_MARKDOWN_PLUGINS) {
+  const clean = normalizeUrl(url);
+  for (const plugin of plugins) {
+    try {
+      if (plugin.matchUrl(clean)) return plugin;
+    } catch {
+      // Keep trying other resolvers.
+    }
+  }
+  return genericLinkMarkdownPlugin;
+}
+
+function pluginForDirective(name, plugins = DEFAULT_MARKDOWN_PLUGINS) {
+  const key = String(name || "embed").toLowerCase();
+  const found = plugins.find((plugin) => plugin.provider === key || plugin.id === key || (plugin.aliases || []).includes(key));
+  return found || (key === "embed" ? genericLinkMarkdownPlugin : null);
+}
+
+function resolveEmbed(url, options = {}) {
+  const clean = normalizeUrl(url);
+  const plugins = options.plugins || DEFAULT_MARKDOWN_PLUGINS;
+  const requested = options.provider ? pluginForDirective(options.provider, plugins) : null;
+  const plugin = requested || pluginForUrl(clean, plugins);
+  if (!plugin) throw new Error(`No markdown embed plugin for ${options.provider}`);
+  const embed = plugin.toEmbed(clean, { title: options.title, directive: options.provider });
+  return { ...embed, pluginId: plugin.id };
+}
+function cleanUrlToken(raw) {
+  return String(raw || "")
+    .trim()
+    .replace(/[\]}>.,!?;:'"]+$/g, "")
+    .replace(/\)+$/g, (suffix, offset, full) => {
+      const before = full.slice(0, offset);
+      const opens = (before.match(/\(/g) || []).length;
+      const closes = (before.match(/\)/g) || []).length;
+      const keep = Math.max(0, opens - closes);
+      return suffix.slice(0, keep);
+    });
+}
+
+function extractUrlsFromText(text) {
+  if (typeof text !== "string") throw new Error("text must be a string");
+  const urls = [];
+  const pattern = /https?:\/\/[^\s<>'"`]+/g;
+  for (const match of text.matchAll(pattern)) {
+    const raw = cleanUrlToken(match[0]);
+    if (!raw) continue;
+    try {
+      urls.push({ url: normalizeUrl(raw), index: match.index });
+    } catch {
+      // Ignore malformed URLs while keeping detection resilient for chat text.
+    }
+  }
+  return urls;
+}
+
+function autoDetectEmbeds(text, options = {}) {
+  const seen = new Set();
+  const detected = [];
+  for (const candidate of extractUrlsFromText(text)) {
+    if (seen.has(candidate.url)) continue;
+    seen.add(candidate.url);
+    try {
+      const embed = resolveEmbed(candidate.url, options);
+      if (options.includeGeneric === false && embed.provider === "link") continue;
+      detected.push({ ...embed, sourceIndex: candidate.index, autoDetected: true });
+    } catch {
+      // Detection should not make message parsing fail.
+    }
+  }
+  return detected;
+}
+
+module.exports = {
+  autoDetectEmbeds,
+  cleanUrlToken,
+  extractUrlsFromText,
+  pluginForDirective,
+  pluginForUrl,
+  resolveEmbed
+};