@aturi.to/waypoints 0.1.1 → 0.1.3

package/dist/index.cjs

@@ -56,6 +56,11 @@ var COMPAT_FAMILIES = {
     id: "blento",
     name: "Blento",
     description: "Blento profiles."
+  },
+  "atproto-explorer": {
+    id: "atproto-explorer",
+    name: "Record explorers",
+    description: "Raw AT Protocol record explorers (pdsls, atp.tools, Aturi Explore) that render any record by its AT URI."
   }
 };
 var COMPAT_FAMILY_ORDER = [
@@ -69,8 +74,12 @@ var COMPAT_FAMILY_ORDER = [
   "streamplace",
   "popfeed",
   "sifa",
-  "blento"
+  "blento",
+  "atproto-explorer"
 ];
+function socialAppComposeIntent(origin) {
+  return { url: `${origin}/intent/compose`, textParam: "text" };
+}
 var WAYPOINT_DESTINATIONS_DATA = {
   aturi: {
     id: "aturi",
@@ -130,6 +139,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."]
   },
@@ -146,12 +160,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."]
   },
@@ -168,12 +189,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."]
   },
@@ -182,7 +207,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) => {
@@ -194,8 +218,63 @@ var WAYPOINT_DESTINATIONS_DATA = {
       }
       return `https://reddwarf.app/profile/${handle}`;
     },
+    // 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."]
+  },
+  impro: {
+    id: "impro",
+    name: "Impro",
+    description: (collection) => {
+      if (collection === "app.bsky.feed.post") return "View post on impro.social";
+      if (collection === "app.bsky.graph.list") return "View list on impro.social";
+      return "View profile on impro.social";
+    },
+    getUrl: (handle, collection, rkey) => {
+      if (collection && rkey) {
+        if (collection === "app.bsky.feed.post") {
+          return `https://impro.social/profile/${handle}/post/${rkey}`;
+        }
+        if (collection === "app.bsky.graph.list") {
+          return `https://impro.social/profile/${handle}/lists/${rkey}`;
+        }
+        return `https://impro.social/profile/${handle}`;
+      }
+      return `https://impro.social/profile/${handle}`;
+    },
     supportedTypes: ["post", "profile", "list", "record"],
-    category: "blueskyForks",
+    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."]
   },
@@ -224,7 +303,7 @@ var WAYPOINT_DESTINATIONS_DATA = {
     },
     supportedTypes: ["post", "profile", "list", "record"],
     category: "devTools",
-    redirectCompat: []
+    redirectCompat: ["atproto-explorer"]
   },
   aturiExplore: {
     id: "aturiExplore",
@@ -245,7 +324,7 @@ var WAYPOINT_DESTINATIONS_DATA = {
     },
     supportedTypes: ["post", "profile", "list", "record"],
     category: "devTools",
-    redirectCompat: []
+    redirectCompat: ["atproto-explorer"]
   },
   atptools: {
     id: "atptools",
@@ -260,7 +339,7 @@ var WAYPOINT_DESTINATIONS_DATA = {
     },
     supportedTypes: ["post", "profile", "list", "record"],
     category: "devTools",
-    redirectCompat: []
+    redirectCompat: ["atproto-explorer"]
   },
   bluepy: {
     id: "bluepy",
@@ -296,56 +375,94 @@ 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."]
   },
-  catsky: {
-    id: "catsky",
-    name: "Catsky",
+  deer: {
+    id: "deer",
+    name: "Deer",
     description: (collection) => {
-      if (collection === "app.bsky.feed.post") return "View post on catsky.social";
-      if (collection === "app.bsky.graph.list") return "View list on catsky.social";
-      return "View profile on catsky.social";
+      if (collection === "app.bsky.feed.post") return "View post on deer.social";
+      if (collection === "app.bsky.graph.list") return "View list on deer.social";
+      return "View profile on deer.social";
     },
     getUrl: (handle, collection, rkey) => {
       if (collection && rkey) {
         if (collection === "app.bsky.feed.post") {
-          return `https://catsky.social/profile/${handle}/post/${rkey}`;
+          return `https://deer.social/profile/${handle}/post/${rkey}`;
         }
-        return `https://catsky.social/profile/${handle}`;
+        if (collection === "app.bsky.graph.list") {
+          return `https://deer.social/profile/${handle}/lists/${rkey}`;
+        }
+        return `https://deer.social/profile/${handle}`;
       }
-      return `https://catsky.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."]
   },
-  deer: {
-    id: "deer",
-    name: "Deer",
+  mu: {
+    id: "mu",
+    name: "Mu",
     description: (collection) => {
-      if (collection === "app.bsky.feed.post") return "View post on deer.social";
-      if (collection === "app.bsky.graph.list") return "View list on deer.social";
-      return "View profile on deer.social";
+      if (collection === "app.bsky.feed.post") return "View post on mu.social";
+      if (collection === "app.bsky.graph.list") return "View list on mu.social";
+      return "View profile on mu.social";
     },
     getUrl: (handle, collection, rkey) => {
       if (collection && rkey) {
         if (collection === "app.bsky.feed.post") {
-          return `https://deer.social/profile/${handle}/post/${rkey}`;
+          return `https://mu.social/profile/${handle}/post/${rkey}`;
         }
-        return `https://deer.social/profile/${handle}`;
+        if (collection === "app.bsky.graph.list") {
+          return `https://mu.social/profile/${handle}/lists/${rkey}`;
+        }
+        return `https://mu.social/profile/${handle}`;
       }
-      return `https://deer.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."]
   },
@@ -555,14 +672,54 @@ var WAYPOINT_DESTINATIONS_DATA = {
     category: "publications",
     redirectCompat: ["standard-site"],
     expectedCollections: ["pub.leaflet.", "site.standard."]
+  },
+  standardReader: {
+    id: "standardReader",
+    name: "Standard Reader",
+    description: (collection) => {
+      if (collection?.startsWith("site.standard.") || collection?.startsWith("pub.leaflet.")) {
+        return "Read document on standard-reader.app";
+      }
+      return "View documents on standard-reader.app";
+    },
+    getUrl: (handle, collection, rkey, did) => {
+      const identifier = did || handle;
+      if (collection && rkey && (collection.startsWith("site.standard.") || collection.startsWith("pub.leaflet."))) {
+        return `https://standard-reader.app/a/${identifier}/${rkey}`;
+      }
+      return `https://standard-reader.app/u/${identifier}`;
+    },
+    supportedTypes: ["post", "profile", "list", "record"],
+    category: "publications",
+    redirectCompat: ["standard-site"],
+    expectedCollections: ["pub.leaflet.", "site.standard."]
+  },
+  taproot: {
+    id: "taproot",
+    name: "Taproot",
+    description: (collection) => {
+      if (collection) return "Inspect record on atproto.at";
+      return "Browse repo on atproto.at";
+    },
+    getUrl: (handle, collection, rkey, did) => {
+      const identifier = did || handle;
+      if (collection && rkey) {
+        return `https://atproto.at/uri/at://${identifier}/${collection}/${rkey}`;
+      }
+      return `https://atproto.at/uri/at://${identifier}`;
+    },
+    supportedTypes: ["post", "profile", "list", "record"],
+    category: "devTools",
+    redirectCompat: []
   }
 };
 var WAYPOINT_ORDER = [
   "anisota",
   "bluesky",
   "bluepy",
-  "blacksky",
   "reddwarf",
+  "impro",
+  "blacksky",
   "leaflet",
   "aturi",
   "pinksky",
@@ -576,13 +733,17 @@ var WAYPOINT_ORDER = [
   "anisotaReader",
   "offprint",
   "pckt",
+  "standardReader",
   "aturiExplore",
   "pdsls",
   "tangled",
   "atptools",
+  "taproot",
   "witchsky",
-  "catsky",
-  "deer"
+  "mu",
+  "deer",
+  "lea",
+  "northsky"
 ];
 function getWaypointDataForType(type) {
   return WAYPOINT_ORDER.map((id) => WAYPOINT_DESTINATIONS_DATA[id]).filter((waypoint) => waypoint.supportedTypes.includes(type));
@@ -676,13 +837,13 @@ var RECOMMENDED_WAYPOINTS = {
     label: "Recommended for Repos"
   },
   "record": {
-    waypointIds: ["aturiExplore", "pdsls", "atptools"],
+    waypointIds: ["aturiExplore", "pdsls", "atptools", "taproot"],
     label: "Recommended for Records"
   }
 };
 var RECOMMENDED_NAMESPACE_PREFIXES = {
   "site.standard": {
-    waypointIds: ["leaflet", "anisotaReader", "offprint", "pckt", "pdsls"],
+    waypointIds: ["leaflet", "standardReader", "anisotaReader", "offprint", "pckt", "pdsls"],
     label: "Recommended for Publications"
   },
   "pub.leaflet": {
@@ -749,6 +910,67 @@ 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;
+async function upstreamFetch(url, { timeoutMs = 8e3, retries = 1, ...init } = {}) {
+  let lastError;
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    try {
+      return await fetch(url, {
+        ...init,
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+    } catch (error) {
+      lastError = error;
+      if (attempt < retries) {
+        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS));
+      }
+    }
+  }
+  throw lastError;
+}
 
 // src/uriParser.ts
 function parseURI(handle, collection, rkey) {
@@ -791,25 +1013,29 @@ function parseURI(handle, collection, rkey) {
     error: "Invalid URI structure"
   };
 }
-async function resolveHandle(handle) {
+async function resolveHandleStatus(handle) {
   if (handle.startsWith("did:")) {
-    return handle;
+    return { did: handle };
   }
   try {
     const apiUrl = process.env.NEXT_PUBLIC_BSKY_API_URL || "https://public.api.bsky.app";
-    const response = await fetch(
+    const response = await upstreamFetch(
       `${apiUrl}/xrpc/com.atproto.identity.resolveHandle?handle=${encodeURIComponent(handle)}`
     );
     if (!response.ok) {
-      return null;
+      return { did: null, reason: response.status >= 500 ? "unavailable" : "not-found" };
     }
     const data = await response.json();
-    return data.did || null;
+    if (data.did) return { did: data.did };
+    return { did: null, reason: "not-found" };
   } catch (error) {
     console.error("Error resolving handle:", error);
-    return null;
+    return { did: null, reason: "unavailable" };
   }
 }
+async function resolveHandle(handle) {
+  return (await resolveHandleStatus(handle)).did;
+}
 function getDisplayName(handle, did) {
   if (handle.startsWith("did:")) {
     return did ? `@${did.slice(0, 16)}...` : "Unknown";
@@ -822,16 +1048,30 @@ var BLUESKY_FAMILY = [
   { source: "bluesky", hosts: ["bsky.app"] },
   { 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: "catsky", hosts: ["catsky.social"] },
   { source: "deer", hosts: ["deer.social"] },
-  { source: "anisota", hosts: ["anisota.net"] }
+  { source: "northsky", hosts: ["northsky.app"] },
+  { source: "mu", hosts: ["mu.social"] },
+  { source: "anisota", hosts: ["anisota.net"], matchSubdomains: true }
 ];
+var SUBDOMAIN_HOSTS = BLUESKY_FAMILY.filter((f) => f.matchSubdomains).flatMap(
+  (f) => f.hosts
+);
 function normalizeHost(host) {
   return host.toLowerCase().replace(/^www\./, "");
 }
+function isSubdomainOf(host, base) {
+  return host.endsWith(`.${base}`);
+}
+function hostMatchesConfig(host, config) {
+  if (config.hosts.includes(host)) return true;
+  if (!config.matchSubdomains) return false;
+  return config.hosts.some((h) => isSubdomainOf(host, h));
+}
 function matchBlueskyFamily(host, parts) {
-  const entry = BLUESKY_FAMILY.find((f) => f.hosts.includes(host));
+  const entry = BLUESKY_FAMILY.find((f) => hostMatchesConfig(host, f));
   if (!entry) return null;
   if (parts[0] !== "profile" || !parts[1]) return null;
   const handle = parts[1];
@@ -873,6 +1113,19 @@ function matchBlueskyFamily(host, parts) {
       }
     };
   }
+  if (parts[2] === "document" && parts[3]) {
+    return {
+      source: entry.source,
+      parsed: {
+        type: "record",
+        uri: `at://${handle}/site.standard.document/${parts[3]}`,
+        handle,
+        did,
+        collection: "site.standard.document",
+        rkey: parts[3]
+      }
+    };
+  }
   return {
     source: entry.source,
     parsed: {
@@ -1143,11 +1396,160 @@ function matchBlento(host, parts) {
     parsed: { type: "profile", uri: `at://${handle}`, handle, did }
   };
 }
+function matchStandardReader(host, parts) {
+  if (host !== "standard-reader.app") return null;
+  if (parts[0] === "a" && parts[1] && parts[2]) {
+    const handle = parts[1];
+    const did = handle.startsWith("did:") ? handle : void 0;
+    const rkey = parts[2];
+    return {
+      source: "standardReader",
+      parsed: {
+        type: "record",
+        uri: `at://${handle}/site.standard.document/${rkey}`,
+        handle,
+        did,
+        collection: "site.standard.document",
+        rkey
+      }
+    };
+  }
+  if (parts[0] === "u" && parts[1]) {
+    const handle = parts[1];
+    const did = handle.startsWith("did:") ? handle : void 0;
+    return {
+      source: "standardReader",
+      parsed: { type: "profile", uri: `at://${handle}`, handle, did }
+    };
+  }
+  return null;
+}
+function matchFlatRecordHost(host, parts, target) {
+  if (host !== target.host) return null;
+  const [handle, collection, rkey] = parts;
+  if (!handle || !collection || !rkey) return null;
+  if (!collection.includes(".")) return null;
+  const did = handle.startsWith("did:") ? handle : void 0;
+  return {
+    source: target.source,
+    parsed: {
+      type: inferType(collection),
+      uri: `at://${handle}/${collection}/${rkey}`,
+      handle,
+      did,
+      collection,
+      rkey
+    }
+  };
+}
+function matchTaproot(host, pathname) {
+  if (host !== "atproto.at") return null;
+  const m = pathname.replace(/^\/+/, "").match(/^uri\/at:\/{1,2}(.+)$/);
+  if (!m) return null;
+  const segments = m[1].split("/").filter(Boolean);
+  if (segments.length === 0) return null;
+  const handle = segments[0];
+  const collection = segments[1];
+  const rkey = segments[2];
+  const did = handle.startsWith("did:") ? handle : void 0;
+  if (collection && rkey) {
+    return {
+      source: "taproot",
+      parsed: {
+        type: inferType(collection),
+        uri: `at://${handle}/${collection}/${rkey}`,
+        handle,
+        did,
+        collection,
+        rkey
+      }
+    };
+  }
+  return {
+    source: "taproot",
+    parsed: { type: "profile", uri: `at://${handle}`, handle, did }
+  };
+}
+function matchAturi(host, parts) {
+  if (host !== "aturi.to") return null;
+  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;
+    const collection = parts[2];
+    const rkey = parts[3];
+    if (collection && rkey) {
+      return {
+        source: "aturiExplore",
+        parsed: {
+          type: inferType(collection),
+          uri: `at://${handle}/${collection}/${rkey}`,
+          handle,
+          did,
+          collection,
+          rkey
+        }
+      };
+    }
+    return {
+      source: "aturiExplore",
+      parsed: { type: "profile", uri: `at://${handle}`, handle, did }
+    };
+  }
+  if (parts[0] === "profile" && isIdentifier(parts[1])) {
+    const handle = parts[1];
+    const did = handle.startsWith("did:") ? handle : void 0;
+    if (parts[2] === "post" && parts[3]) {
+      return {
+        source: "aturi",
+        parsed: {
+          type: "post",
+          uri: `at://${handle}/app.bsky.feed.post/${parts[3]}`,
+          handle,
+          did,
+          collection: "app.bsky.feed.post",
+          rkey: parts[3]
+        }
+      };
+    }
+    if (parts[2] === "lists" && parts[3]) {
+      return {
+        source: "aturi",
+        parsed: {
+          type: "list",
+          uri: `at://${handle}/app.bsky.graph.list/${parts[3]}`,
+          handle,
+          did,
+          collection: "app.bsky.graph.list",
+          rkey: parts[3]
+        }
+      };
+    }
+    if (parts[2] && parts[2].includes(".") && parts[3]) {
+      return {
+        source: "aturi",
+        parsed: {
+          type: inferType(parts[2]),
+          uri: `at://${handle}/${parts[2]}/${parts[3]}`,
+          handle,
+          did,
+          collection: parts[2],
+          rkey: parts[3]
+        }
+      };
+    }
+    return {
+      source: "aturi",
+      parsed: { type: "profile", uri: `at://${handle}`, handle, did }
+    };
+  }
+  return null;
+}
 function matchSupportedUrl(url) {
   const host = normalizeHost(url.hostname);
   const parts = url.pathname.split("/").filter(Boolean);
   const search = url.searchParams;
-  return matchBlueskyFamily(host, parts) || matchPinksky(host, parts, search) || matchLeaflet(host, parts) || matchTangled(host, parts) || matchMargin(host, parts) || matchPdsls(host, url.pathname) || matchAtpTools(host, url.pathname) || matchBluepy(host, url.pathname) || matchSemble(host, parts) || matchStreamplace(host, parts) || matchGrain(host, parts) || matchPopfeed(host, parts) || matchSifa(host, parts) || matchBlento(host, parts);
+  return matchAturi(host, parts) || matchBlueskyFamily(host, parts) || matchPinksky(host, parts, search) || matchLeaflet(host, parts) || matchTangled(host, parts) || matchMargin(host, parts) || matchPdsls(host, url.pathname) || matchAtpTools(host, url.pathname) || matchBluepy(host, url.pathname) || matchSemble(host, parts) || matchStreamplace(host, parts) || matchGrain(host, parts) || matchPopfeed(host, parts) || matchSifa(host, parts) || matchBlento(host, parts) || matchStandardReader(host, parts) || matchFlatRecordHost(host, parts, { host: "offprint.app", source: "offprint" }) || matchFlatRecordHost(host, parts, { host: "pckt.blog", source: "pckt" }) || matchTaproot(host, url.pathname);
 }
 function parseAtUri(uri) {
   if (!uri.startsWith("at://")) return null;
@@ -1177,6 +1579,7 @@ function parseAtUri(uri) {
   };
 }
 var SUPPORTED_HOSTS = [
+  "aturi.to",
   ...BLUESKY_FAMILY.flatMap((e) => e.hosts),
   "pinkleap.app",
   "leaflet.pub",
@@ -1190,8 +1593,17 @@ var SUPPORTED_HOSTS = [
   "grain.social",
   "popfeed.social",
   "sifa.id",
-  "blento.app"
+  "blento.app",
+  "standard-reader.app",
+  "offprint.app",
+  "pckt.blog",
+  "atproto.at"
 ];
+function isSupportedHost(host) {
+  const h = normalizeHost(host);
+  if (SUPPORTED_HOSTS.includes(h)) return true;
+  return SUBDOMAIN_HOSTS.some((base) => isSubdomainOf(h, base));
+}
 
 // src/resolve.ts
 var DID_REQUIRED_WAYPOINTS = /* @__PURE__ */ new Set([
@@ -1209,18 +1621,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,
@@ -1262,7 +1682,8 @@ async function resolveUrl(url, options = {}) {
   }
   const { waypoints, recommended } = buildWaypointsForParsed(parsed, {
     did,
-    excludeSourceId: source
+    excludeSourceId: source,
+    composeText: options.composeText
   });
   return {
     parsed: { ...parsed, did },
@@ -1285,6 +1706,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" },
@@ -1324,28 +1746,264 @@ async function detectAtUriInHead(url, timeoutMs) {
   }
 }
 
+// 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;");
+}
+
 exports.CATEGORY_ORDER = CATEGORY_ORDER;
 exports.COMPAT_FAMILIES = COMPAT_FAMILIES;
 exports.COMPAT_FAMILY_ORDER = COMPAT_FAMILY_ORDER;
+exports.COMPOSE_INTENT_TEXT_PLACEHOLDER = COMPOSE_INTENT_TEXT_PLACEHOLDER;
 exports.DID_REQUIRED_WAYPOINTS = DID_REQUIRED_WAYPOINTS;
+exports.OEMBED_LINK_TYPE = OEMBED_LINK_TYPE;
 exports.SUPPORTED_HOSTS = SUPPORTED_HOSTS;
+exports.UNIVERSAL_LINK_ORIGIN = UNIVERSAL_LINK_ORIGIN;
 exports.WAYPOINT_CATEGORIES_DATA = WAYPOINT_CATEGORIES_DATA;
 exports.WAYPOINT_DESTINATIONS_DATA = WAYPOINT_DESTINATIONS_DATA;
 exports.WAYPOINT_ORDER = WAYPOINT_ORDER;
+exports.buildUniversalLink = buildUniversalLink;
+exports.buildUniversalLinkTags = buildUniversalLinkTags;
 exports.buildWaypointsForParsed = buildWaypointsForParsed;
+exports.describeComposeIntent = describeComposeIntent;
+exports.describeUniversalLink = describeUniversalLink;
 exports.getCategorizedWaypointsData = getCategorizedWaypointsData;
+exports.getComposeIntentAppUrl = getComposeIntentAppUrl;
+exports.getComposeIntentTemplate = getComposeIntentTemplate;
+exports.getComposeIntentUrl = getComposeIntentUrl;
+exports.getComposeIntentWaypoints = getComposeIntentWaypoints;
 exports.getDisplayName = getDisplayName;
 exports.getFeaturedWaypointData = getFeaturedWaypointData;
 exports.getRecommendedWaypointsData = getRecommendedWaypointsData;
 exports.getWaypointCountData = getWaypointCountData;
 exports.getWaypointDataForType = getWaypointDataForType;
+exports.isSupportedHost = isSupportedHost;
+exports.isUniversalLink = isUniversalLink;
 exports.matchSupportedUrl = matchSupportedUrl;
 exports.parseAtUri = parseAtUri;
 exports.parseURI = parseURI;
+exports.parseUniversalLink = parseUniversalLink;
 exports.resolveAtUri = resolveAtUri;
 exports.resolveHandle = resolveHandle;
+exports.resolveHandleStatus = resolveHandleStatus;
 exports.resolveUrl = resolveUrl;
 exports.resolveViaApi = resolveViaApi;
+exports.supportsComposeIntent = supportsComposeIntent;
 exports.waypointActivity = waypointActivity;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map