@aturi.to/waypoints 0.1.2 → 0.1.3

package/dist/index.js

@@ -75,6 +75,9 @@ var COMPAT_FAMILY_ORDER = [
   "blento",
   "atproto-explorer"
 ];
+function socialAppComposeIntent(origin) {
+  return { url: `${origin}/intent/compose`, textParam: "text" };
+}
 var WAYPOINT_DESTINATIONS_DATA = {
   aturi: {
     id: "aturi",
@@ -134,6 +137,11 @@ var WAYPOINT_DESTINATIONS_DATA = {
     },
     supportedTypes: ["post", "profile", "list", "record"],
     category: "blueskyClients",
+    // Anisota implements the Bluesky shape deliberately, then extends it with
+    // `url`, `tags`, `channel`, and `title` (and answers `/post` with the same
+    // query). What's declared here is the interoperable subset every caller can
+    // rely on; the extras are Anisota-only and unrepresentable in this field.
+    composeIntent: socialAppComposeIntent("https://anisota.net"),
     redirectCompat: ["bluesky-social", "standard-site"],
     expectedCollections: ["app.bsky.", "net.anisota."]
   },
@@ -150,12 +158,19 @@ var WAYPOINT_DESTINATIONS_DATA = {
         if (collection === "app.bsky.feed.post") {
           return `https://bsky.app/profile/${handle}/post/${rkey}`;
         }
+        if (collection === "app.bsky.graph.list") {
+          return `https://bsky.app/profile/${handle}/lists/${rkey}`;
+        }
         return `https://bsky.app/profile/${handle}`;
       }
       return `https://bsky.app/profile/${handle}`;
     },
     supportedTypes: ["post", "profile", "list", "record"],
     category: "blueskyClients",
+    composeIntent: {
+      ...socialAppComposeIntent("https://bsky.app"),
+      appUrl: "bluesky://intent/compose"
+    },
     redirectCompat: ["bluesky-social"],
     expectedCollections: ["app.bsky."]
   },
@@ -172,12 +187,16 @@ var WAYPOINT_DESTINATIONS_DATA = {
         if (collection === "app.bsky.feed.post") {
           return `https://blacksky.community/profile/${handle}/post/${rkey}`;
         }
+        if (collection === "app.bsky.graph.list") {
+          return `https://blacksky.community/profile/${handle}/lists/${rkey}`;
+        }
         return `https://blacksky.community/profile/${handle}`;
       }
       return `https://blacksky.community/profile/${handle}`;
     },
     supportedTypes: ["post", "profile", "list", "record"],
     category: "blueskyForks",
+    composeIntent: socialAppComposeIntent("https://blacksky.community"),
     redirectCompat: ["bluesky-social"],
     expectedCollections: ["app.bsky."]
   },
@@ -186,7 +205,6 @@ var WAYPOINT_DESTINATIONS_DATA = {
     name: "Red Dwarf",
     description: (collection) => {
       if (collection === "app.bsky.feed.post") return "View post on reddwarf.app";
-      if (collection === "app.bsky.graph.list") return "View list on reddwarf.app";
       return "View profile on reddwarf.app";
     },
     getUrl: (handle, collection, rkey) => {
@@ -198,7 +216,10 @@ var WAYPOINT_DESTINATIONS_DATA = {
       }
       return `https://reddwarf.app/profile/${handle}`;
     },
-    supportedTypes: ["post", "profile", "list", "record"],
+    // No `list`: unlike the social-app forks in this family, Red Dwarf has no
+    // `/profile/:handle/lists/:rkey` route, so offering it for a list would
+    // silently land the user on the list's author instead.
+    supportedTypes: ["post", "profile", "record"],
     category: "blueskyClients",
     redirectCompat: ["bluesky-social"],
     expectedCollections: ["app.bsky."]
@@ -225,6 +246,33 @@ var WAYPOINT_DESTINATIONS_DATA = {
     },
     supportedTypes: ["post", "profile", "list", "record"],
     category: "blueskyClients",
+    // Impro routes /intent/compose to its home view, which opens the composer
+    // for a signed-in user — but it never reads `?text`, so no textParam here.
+    composeIntent: { url: "https://impro.social/intent/compose" },
+    redirectCompat: ["bluesky-social"],
+    expectedCollections: ["app.bsky."]
+  },
+  lea: {
+    id: "lea",
+    name: "Lea",
+    description: (collection) => {
+      if (collection === "app.bsky.feed.post") return "View post on lea.ac";
+      return "View profile on lea.ac";
+    },
+    getUrl: (handle, collection, rkey) => {
+      if (collection && rkey) {
+        if (collection === "app.bsky.feed.post") {
+          return `https://lea.ac/profile/${handle}/post/${rkey}`;
+        }
+        return `https://lea.ac/profile/${handle}`;
+      }
+      return `https://lea.ac/profile/${handle}`;
+    },
+    // No `list`: like Red Dwarf, Lea serves only `/profile/:handle` and
+    // `/profile/:handle/post/:rkey` — `/lists/:rkey` 404s — so claiming list
+    // support would drop the user on an error page instead of the list.
+    supportedTypes: ["post", "profile", "record"],
+    category: "blueskyClients",
     redirectCompat: ["bluesky-social"],
     expectedCollections: ["app.bsky."]
   },
@@ -325,12 +373,16 @@ var WAYPOINT_DESTINATIONS_DATA = {
         if (collection === "app.bsky.feed.post") {
           return `https://witchsky.app/profile/${handle}/post/${rkey}`;
         }
+        if (collection === "app.bsky.graph.list") {
+          return `https://witchsky.app/profile/${handle}/lists/${rkey}`;
+        }
         return `https://witchsky.app/profile/${handle}`;
       }
       return `https://witchsky.app/profile/${handle}`;
     },
     supportedTypes: ["post", "profile", "list", "record"],
     category: "blueskyForks",
+    composeIntent: socialAppComposeIntent("https://witchsky.app"),
     redirectCompat: ["bluesky-social"],
     expectedCollections: ["app.bsky."]
   },
@@ -347,12 +399,16 @@ var WAYPOINT_DESTINATIONS_DATA = {
         if (collection === "app.bsky.feed.post") {
           return `https://deer.social/profile/${handle}/post/${rkey}`;
         }
+        if (collection === "app.bsky.graph.list") {
+          return `https://deer.social/profile/${handle}/lists/${rkey}`;
+        }
         return `https://deer.social/profile/${handle}`;
       }
       return `https://deer.social/profile/${handle}`;
     },
     supportedTypes: ["post", "profile", "list", "record"],
     category: "blueskyForks",
+    composeIntent: socialAppComposeIntent("https://deer.social"),
     redirectCompat: ["bluesky-social"],
     expectedCollections: ["app.bsky."]
   },
@@ -369,12 +425,42 @@ var WAYPOINT_DESTINATIONS_DATA = {
         if (collection === "app.bsky.feed.post") {
           return `https://mu.social/profile/${handle}/post/${rkey}`;
         }
+        if (collection === "app.bsky.graph.list") {
+          return `https://mu.social/profile/${handle}/lists/${rkey}`;
+        }
         return `https://mu.social/profile/${handle}`;
       }
       return `https://mu.social/profile/${handle}`;
     },
     supportedTypes: ["post", "profile", "list", "record"],
     category: "blueskyForks",
+    composeIntent: socialAppComposeIntent("https://mu.social"),
+    redirectCompat: ["bluesky-social"],
+    expectedCollections: ["app.bsky."]
+  },
+  northsky: {
+    id: "northsky",
+    name: "Northsky",
+    description: (collection) => {
+      if (collection === "app.bsky.feed.post") return "View post on northsky.app";
+      if (collection === "app.bsky.graph.list") return "View list on northsky.app";
+      return "View profile on northsky.app";
+    },
+    getUrl: (handle, collection, rkey) => {
+      if (collection && rkey) {
+        if (collection === "app.bsky.feed.post") {
+          return `https://northsky.app/profile/${handle}/post/${rkey}`;
+        }
+        if (collection === "app.bsky.graph.list") {
+          return `https://northsky.app/profile/${handle}/lists/${rkey}`;
+        }
+        return `https://northsky.app/profile/${handle}`;
+      }
+      return `https://northsky.app/profile/${handle}`;
+    },
+    supportedTypes: ["post", "profile", "list", "record"],
+    category: "blueskyForks",
+    composeIntent: socialAppComposeIntent("https://northsky.app"),
     redirectCompat: ["bluesky-social"],
     expectedCollections: ["app.bsky."]
   },
@@ -653,7 +739,9 @@ var WAYPOINT_ORDER = [
   "taproot",
   "witchsky",
   "mu",
-  "deer"
+  "deer",
+  "lea",
+  "northsky"
 ];
 function getWaypointDataForType(type) {
   return WAYPOINT_ORDER.map((id) => WAYPOINT_DESTINATIONS_DATA[id]).filter((waypoint) => waypoint.supportedTypes.includes(type));
@@ -820,6 +908,47 @@ function waypointActivity(waypoint, repoCollections) {
   }
   return "absent";
 }
+var COMPOSE_INTENT_TEXT_PLACEHOLDER = "{text}";
+function supportsComposeIntent(waypoint) {
+  return !!waypoint.composeIntent;
+}
+function getComposeIntentUrl(waypoint, text) {
+  const intent = waypoint.composeIntent;
+  if (!intent) return null;
+  return appendComposeText(intent.url, intent.textParam, text);
+}
+function getComposeIntentAppUrl(waypoint, text) {
+  const intent = waypoint.composeIntent;
+  if (!intent?.appUrl) return null;
+  return appendComposeText(intent.appUrl, intent.textParam, text);
+}
+function getComposeIntentTemplate(waypoint) {
+  const intent = waypoint.composeIntent;
+  if (!intent) return null;
+  if (!intent.textParam) return intent.url;
+  return `${intent.url}?${intent.textParam}=${COMPOSE_INTENT_TEXT_PLACEHOLDER}`;
+}
+function getComposeIntentWaypoints(type) {
+  const waypoints = type ? getWaypointDataForType(type) : WAYPOINT_ORDER.map((id) => WAYPOINT_DESTINATIONS_DATA[id]).filter(Boolean);
+  return waypoints.filter(supportsComposeIntent);
+}
+function describeComposeIntent(waypoint, text) {
+  const intent = waypoint.composeIntent;
+  if (!intent) return null;
+  const descriptor = {
+    url: getComposeIntentUrl(waypoint, text),
+    urlTemplate: getComposeIntentTemplate(waypoint),
+    textParam: intent.textParam ?? null,
+    prefillsText: !!intent.textParam
+  };
+  const appUrl = getComposeIntentAppUrl(waypoint, text);
+  if (appUrl) descriptor.appUrl = appUrl;
+  return descriptor;
+}
+function appendComposeText(base, textParam, text) {
+  if (!textParam || !text) return base;
+  return `${base}?${textParam}=${encodeURIComponent(text)}`;
+}
 
 // src/upstreamFetch.ts
 var RETRY_DELAY_MS = 250;
@@ -918,8 +1047,10 @@ var BLUESKY_FAMILY = [
   { source: "blacksky", hosts: ["blacksky.community"] },
   { source: "reddwarf", hosts: ["reddwarf.app"] },
   { source: "impro", hosts: ["impro.social"] },
+  { source: "lea", hosts: ["lea.ac"] },
   { source: "witchsky", hosts: ["witchsky.app"] },
   { source: "deer", hosts: ["deer.social"] },
+  { source: "northsky", hosts: ["northsky.app"] },
   { source: "mu", hosts: ["mu.social"] },
   { source: "anisota", hosts: ["anisota.net"], matchSubdomains: true }
 ];
@@ -1339,7 +1470,7 @@ function matchTaproot(host, pathname) {
 }
 function matchAturi(host, parts) {
   if (host !== "aturi.to") return null;
-  const isIdentifier = (seg) => !!seg && (seg.startsWith("did:") || seg.includes("."));
+  const isIdentifier = (seg2) => !!seg2 && (seg2.startsWith("did:") || seg2.includes("."));
   if (parts[0] === "explore" && isIdentifier(parts[1])) {
     const handle = parts[1];
     const did = handle.startsWith("did:") ? handle : void 0;
@@ -1488,18 +1619,26 @@ function buildWaypointsForParsed(parsed, options = {}) {
     if (DID_REQUIRED_WAYPOINTS.has(w.id) && !did) return null;
     const url = w.getUrl(parsed.handle, parsed.collection, parsed.rkey, did);
     if (!url) return null;
-    return { id: w.id, name: w.name, category: w.category, url };
+    return {
+      id: w.id,
+      name: w.name,
+      category: w.category,
+      url,
+      composeIntent: describeComposeIntent(w, options.composeText)
+    };
   }).filter((w) => !!w);
   const recommendedRaw = getRecommendedWaypointsData(type, parsed.collection);
   const availableIds = new Set(waypoints.map((w) => w.id));
   const ids = recommendedRaw.waypoints.map((w) => w.id).filter((id) => id !== exclude && availableIds.has(id));
   return { waypoints, recommended: { ids, label: recommendedRaw.label } };
 }
-function resolveAtUri(uri) {
+function resolveAtUri(uri, options = {}) {
   const match = parseAtUri(uri);
   if (!match) return null;
   const { parsed, source } = match;
-  const { waypoints, recommended } = buildWaypointsForParsed(parsed);
+  const { waypoints, recommended } = buildWaypointsForParsed(parsed, {
+    composeText: options.composeText
+  });
   return {
     parsed,
     source,
@@ -1541,7 +1680,8 @@ async function resolveUrl(url, options = {}) {
   }
   const { waypoints, recommended } = buildWaypointsForParsed(parsed, {
     did,
-    excludeSourceId: source
+    excludeSourceId: source,
+    composeText: options.composeText
   });
   return {
     parsed: { ...parsed, did },
@@ -1564,6 +1704,7 @@ async function resolveViaApi(input, options = {}) {
     throw new Error("resolveViaApi requires either `url` or `atUri`");
   }
   if (input.headDetect === false) params.set("headDetect", "false");
+  if (input.composeText) params.set("composeText", input.composeText);
   const res = await fetchImpl(`${endpoint}?${params.toString()}`, {
     method: "GET",
     headers: { Accept: "application/json" },
@@ -1603,6 +1744,226 @@ async function detectAtUriInHead(url, timeoutMs) {
   }
 }
 
-export { CATEGORY_ORDER, COMPAT_FAMILIES, COMPAT_FAMILY_ORDER, DID_REQUIRED_WAYPOINTS, SUPPORTED_HOSTS, WAYPOINT_CATEGORIES_DATA, WAYPOINT_DESTINATIONS_DATA, WAYPOINT_ORDER, buildWaypointsForParsed, getCategorizedWaypointsData, getDisplayName, getFeaturedWaypointData, getRecommendedWaypointsData, getWaypointCountData, getWaypointDataForType, isSupportedHost, matchSupportedUrl, parseAtUri, parseURI, resolveAtUri, resolveHandle, resolveHandleStatus, resolveUrl, resolveViaApi, waypointActivity };
+// src/universalLinks.ts
+var UNIVERSAL_LINK_ORIGIN = "https://aturi.to";
+var OEMBED_PATH = "/api/oembed";
+var OEMBED_COLLECTION = "app.bsky.feed.post";
+var OEMBED_LINK_TYPE = "application/json+oembed";
+function buildUniversalLink(input, options = {}) {
+  const parsed = parseTarget(input);
+  if (!parsed) return null;
+  const origin = normalizeOrigin(options.origin);
+  const did = options.did ?? parsed.did;
+  const { collection, rkey } = parsed;
+  const identifier = options.preferDid && did ? did : parsed.handle;
+  let path;
+  if (collection && rkey) {
+    if (collection === "app.bsky.feed.post") {
+      path = `/profile/${seg(identifier)}/post/${seg(rkey)}`;
+    } else if (collection === "app.bsky.graph.list") {
+      path = `/profile/${seg(identifier)}/lists/${seg(rkey)}`;
+    } else {
+      path = `/profile/${seg(did || parsed.handle)}/${seg(collection)}/${seg(rkey)}`;
+    }
+  } else {
+    path = `/profile/${seg(identifier)}`;
+  }
+  return `${origin}${path}${queryString(options.params)}`;
+}
+function parseUniversalLink(url, options = {}) {
+  let target;
+  try {
+    target = typeof url === "string" ? new URL(url.trim()) : url;
+  } catch {
+    return null;
+  }
+  if (!/^https?:$/.test(target.protocol)) return null;
+  let expectedHost;
+  try {
+    expectedHost = bareHost(new URL(normalizeOrigin(options.origin)).hostname);
+  } catch {
+    return null;
+  }
+  if (bareHost(target.hostname) !== expectedHost) return null;
+  const probe = new URL(target.toString());
+  probe.protocol = "https:";
+  probe.hostname = "aturi.to";
+  probe.port = "";
+  const match = matchSupportedUrl(probe);
+  if (match && (match.source === "aturi" || match.source === "aturiExplore")) {
+    return normalizeParsed(match.parsed);
+  }
+  return parseEmbeddedAtUri(probe.pathname) ?? parsePath(probe.pathname);
+}
+function isUniversalLink(url, options = {}) {
+  return parseUniversalLink(url, options) !== null;
+}
+function describeUniversalLink(input, options = {}) {
+  const parsed = parseTarget(input);
+  if (!parsed) return null;
+  const url = buildUniversalLink(parsed, options);
+  if (!url) return null;
+  const did = options.did ?? parsed.did ?? null;
+  const collection = parsed.collection ?? null;
+  const rkey = parsed.rkey ?? null;
+  const authority = did ?? parsed.handle;
+  const atUri = collection && rkey ? `at://${authority}/${collection}/${rkey}` : `at://${authority}`;
+  const label = describeTarget(parsed);
+  return {
+    url,
+    atUri,
+    type: parsed.type,
+    handle: parsed.handle,
+    did,
+    collection,
+    rkey,
+    label,
+    share: {
+      title: options.title ?? label,
+      text: options.text ?? label,
+      url
+    },
+    snippets: {
+      url,
+      atUri,
+      markdown: `[${label}](${url})`,
+      html: `<a href="${escapeHtml(url)}">${escapeHtml(label)}</a>`
+    },
+    oembedUrl: buildOEmbedUrl(url, collection, options.origin)
+  };
+}
+function buildUniversalLinkTags(input, options = {}) {
+  const described = describeUniversalLink(input, options);
+  if (!described) return null;
+  const meta = [
+    { name: "at:canonical", content: described.atUri }
+  ];
+  if (described.collection && described.rkey) {
+    meta.push({
+      name: "at:author",
+      content: `at://${described.did ?? described.handle}`
+    });
+  }
+  const link = [
+    { rel: "alternate", href: described.atUri }
+  ];
+  if (described.oembedUrl) {
+    link.push({
+      rel: "alternate",
+      type: OEMBED_LINK_TYPE,
+      href: described.oembedUrl
+    });
+  }
+  const html = [
+    ...meta.map(
+      (tag) => `<meta name="${escapeHtml(tag.name)}" content="${escapeHtml(tag.content)}" />`
+    ),
+    ...link.map((tag) => {
+      const type = tag.type ? ` type="${escapeHtml(tag.type)}"` : "";
+      return `<link rel="${escapeHtml(tag.rel)}"${type} href="${escapeHtml(tag.href)}" />`;
+    })
+  ].join("\n");
+  return { meta, link, html };
+}
+function parseTarget(input) {
+  if (typeof input !== "string") {
+    return input && input.handle ? normalizeParsed(input) : null;
+  }
+  const trimmed = input.trim();
+  if (!trimmed) return null;
+  if (trimmed.toLowerCase().startsWith("at://")) {
+    const parsed = parseAtUri(trimmed)?.parsed;
+    return parsed ? normalizeParsed(parsed) : null;
+  }
+  if (/^https?:\/\//i.test(trimmed)) {
+    let target;
+    try {
+      target = new URL(trimmed);
+    } catch {
+      return null;
+    }
+    const embedded = parseEmbeddedAtUri(target.pathname);
+    if (embedded) return embedded;
+    const matched = matchSupportedUrl(target)?.parsed;
+    return matched ? normalizeParsed(matched) : null;
+  }
+  return parsePath(trimmed.startsWith("@") ? trimmed.slice(1) : trimmed);
+}
+function parsePath(path) {
+  const segments = path.split("/").filter(Boolean);
+  const handle = decodeSegment(segments[0] ?? "");
+  if (!handle) return null;
+  if (!handle.startsWith("did:") && !handle.includes(".")) return null;
+  const parsed = parseAtUri(`at://${segments.join("/")}`)?.parsed;
+  if (!parsed) return null;
+  const collection = parsed.collection ? decodeSegment(parsed.collection) : void 0;
+  const rkey = parsed.rkey ? decodeSegment(parsed.rkey) : void 0;
+  return {
+    ...parsed,
+    handle,
+    did: handle.startsWith("did:") ? handle : void 0,
+    collection,
+    rkey,
+    uri: collection && rkey ? `at://${handle}/${collection}/${rkey}` : `at://${handle}`
+  };
+}
+function normalizeParsed(parsed) {
+  if (!parsed.handle.startsWith("@")) return parsed;
+  const handle = parsed.handle.slice(1);
+  if (!handle) return parsed;
+  return {
+    ...parsed,
+    handle,
+    uri: parsed.collection && parsed.rkey ? `at://${handle}/${parsed.collection}/${parsed.rkey}` : `at://${handle}`
+  };
+}
+function parseEmbeddedAtUri(pathname) {
+  const match = /^\/at:\/{1,2}(.+)$/i.exec(pathname);
+  if (!match) return null;
+  return parsePath(match[1]);
+}
+function buildOEmbedUrl(url, collection, origin) {
+  if (collection !== OEMBED_COLLECTION) return null;
+  return `${normalizeOrigin(origin)}${OEMBED_PATH}?url=${encodeURIComponent(url)}`;
+}
+function describeTarget(parsed) {
+  const who = parsed.handle.startsWith("did:") ? parsed.handle : `@${parsed.handle}`;
+  if (parsed.type === "post") return `Post by ${who}`;
+  if (parsed.type === "list") return `List by ${who}`;
+  if (parsed.collection) return `${parsed.collection} record by ${who}`;
+  return who;
+}
+function normalizeOrigin(origin) {
+  if (!origin) return UNIVERSAL_LINK_ORIGIN;
+  return origin.trim().replace(/\/+$/, "") || UNIVERSAL_LINK_ORIGIN;
+}
+function bareHost(hostname) {
+  return hostname.toLowerCase().replace(/^www\./, "");
+}
+function seg(value) {
+  return encodeURIComponent(value).replace(/%3A/gi, ":");
+}
+function decodeSegment(value) {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+function queryString(params) {
+  if (!params) return "";
+  const search = new URLSearchParams();
+  for (const [key, value] of Object.entries(params)) {
+    if (value === null || value === void 0 || value === "") continue;
+    search.set(key, String(value));
+  }
+  const query = search.toString();
+  return query ? `?${query}` : "";
+}
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+
+export { CATEGORY_ORDER, COMPAT_FAMILIES, COMPAT_FAMILY_ORDER, COMPOSE_INTENT_TEXT_PLACEHOLDER, DID_REQUIRED_WAYPOINTS, OEMBED_LINK_TYPE, SUPPORTED_HOSTS, UNIVERSAL_LINK_ORIGIN, WAYPOINT_CATEGORIES_DATA, WAYPOINT_DESTINATIONS_DATA, WAYPOINT_ORDER, buildUniversalLink, buildUniversalLinkTags, buildWaypointsForParsed, describeComposeIntent, describeUniversalLink, getCategorizedWaypointsData, getComposeIntentAppUrl, getComposeIntentTemplate, getComposeIntentUrl, getComposeIntentWaypoints, getDisplayName, getFeaturedWaypointData, getRecommendedWaypointsData, getWaypointCountData, getWaypointDataForType, isSupportedHost, isUniversalLink, matchSupportedUrl, parseAtUri, parseURI, parseUniversalLink, resolveAtUri, resolveHandle, resolveHandleStatus, resolveUrl, resolveViaApi, supportsComposeIntent, waypointActivity };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map