@aturi.to/waypoints 0.1.1 → 0.1.2

package/README.md

@@ -1,6 +1,6 @@
 # @aturi.to/waypoints
 
-Aturi's curated catalog of Atmosphere (AT Protocol) clients — "waypoints" — plus
+Aturi's curated catalog of Atmosphere (AT Protocol) clients ("waypoints") plus
 the logic to turn an AT URI into per-client "Open in…" links, recommend the best
 client for a record type, and reverse-resolve a pasted URL back into an AT URI.
 
@@ -9,7 +9,7 @@ Ships ESM + CJS with full type definitions.
 
 For a drop-in React picker UI, see [`@aturi.to/waypoints-react`](../waypoints-react).
 
-> **Beta — early release.** This is a `0.x` package that hasn't been
+> **Beta: early release.** This is a `0.x` package that hasn't been
 > thoroughly tested in production yet. Expect rough edges, and possible
 > breaking changes between minor versions while the API settles. Bug reports
 > and feedback are very welcome at
@@ -48,20 +48,20 @@ const fromUrl = await resolveUrl('https://bsky.app/profile/alice.bsky.social/pos
   - `buildWaypointsForParsed(parsed, { did?, excludeSourceId? })`
   - `resolveAtUri(uri)`
   - `resolveUrl(url, { fetchHead?, resolveHandle? })`
-  - `resolveViaApi(input, { endpoint? })` — typed client for the hosted
+  - `resolveViaApi(input, { endpoint? })`: typed client for the hosted
     `aturi.to/api/resolve` endpoint.
 
 ### DID-only waypoints
 
 A handful of destinations (`pdsls`, `atptools`, `margin`, `grain`, `popfeed`)
 only produce useful URLs when a DID is known. They're filtered out unless a DID
-is available — pass one in, or supply a `resolveHandle` to `resolveUrl`.
+is available: pass one in, or supply a `resolveHandle` to `resolveUrl`.
 
 ### Hosted vs. local resolution
 
 `resolveUrl` matches URL patterns locally (no network). The optional `fetchHead`
 flag and `resolveViaApi` let you fall back to fetching the page and probing for a
-`<link href="at://…">` — useful for sites without a recognizable URL shape.
+`<link href="at://…">`, useful for sites without a recognizable URL shape.
 `resolveViaApi` is the right choice from a browser, where fetching arbitrary
 pages is blocked by CORS.
 

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,7 +74,8 @@ var COMPAT_FAMILY_ORDER = [
   "streamplace",
   "popfeed",
   "sifa",
-  "blento"
+  "blento",
+  "atproto-explorer"
 ];
 var WAYPOINT_DESTINATIONS_DATA = {
   aturi: {
@@ -195,7 +201,32 @@ var WAYPOINT_DESTINATIONS_DATA = {
       return `https://reddwarf.app/profile/${handle}`;
     },
     supportedTypes: ["post", "profile", "list", "record"],
-    category: "blueskyForks",
+    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: "blueskyClients",
     redirectCompat: ["bluesky-social"],
     expectedCollections: ["app.bsky."]
   },
@@ -224,7 +255,7 @@ var WAYPOINT_DESTINATIONS_DATA = {
     },
     supportedTypes: ["post", "profile", "list", "record"],
     category: "devTools",
-    redirectCompat: []
+    redirectCompat: ["atproto-explorer"]
   },
   aturiExplore: {
     id: "aturiExplore",
@@ -245,7 +276,7 @@ var WAYPOINT_DESTINATIONS_DATA = {
     },
     supportedTypes: ["post", "profile", "list", "record"],
     category: "devTools",
-    redirectCompat: []
+    redirectCompat: ["atproto-explorer"]
   },
   atptools: {
     id: "atptools",
@@ -260,7 +291,7 @@ var WAYPOINT_DESTINATIONS_DATA = {
     },
     supportedTypes: ["post", "profile", "list", "record"],
     category: "devTools",
-    redirectCompat: []
+    redirectCompat: ["atproto-explorer"]
   },
   bluepy: {
     id: "bluepy",
@@ -305,44 +336,44 @@ var WAYPOINT_DESTINATIONS_DATA = {
     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}`;
+        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",
     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}`;
+        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",
@@ -555,14 +586,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,12 +647,14 @@ var WAYPOINT_ORDER = [
   "anisotaReader",
   "offprint",
   "pckt",
+  "standardReader",
   "aturiExplore",
   "pdsls",
   "tangled",
   "atptools",
+  "taproot",
   "witchsky",
-  "catsky",
+  "mu",
   "deer"
 ];
 function getWaypointDataForType(type) {
@@ -676,13 +749,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": {
@@ -750,6 +823,26 @@ function waypointActivity(waypoint, repoCollections) {
   return "absent";
 }
 
+// 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) {
   if (!handle) {
@@ -791,25 +884,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 +919,28 @@ var BLUESKY_FAMILY = [
   { source: "bluesky", hosts: ["bsky.app"] },
   { source: "blacksky", hosts: ["blacksky.community"] },
   { source: "reddwarf", hosts: ["reddwarf.app"] },
+  { source: "impro", hosts: ["impro.social"] },
   { source: "witchsky", hosts: ["witchsky.app"] },
-  { source: "catsky", hosts: ["catsky.social"] },
   { source: "deer", hosts: ["deer.social"] },
-  { source: "anisota", hosts: ["anisota.net"] }
+  { 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 +982,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 +1265,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 = (seg) => !!seg && (seg.startsWith("did:") || seg.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 +1448,7 @@ function parseAtUri(uri) {
   };
 }
 var SUPPORTED_HOSTS = [
+  "aturi.to",
   ...BLUESKY_FAMILY.flatMap((e) => e.hosts),
   "pinkleap.app",
   "leaflet.pub",
@@ -1190,8 +1462,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([
@@ -1339,11 +1620,13 @@ exports.getFeaturedWaypointData = getFeaturedWaypointData;
 exports.getRecommendedWaypointsData = getRecommendedWaypointsData;
 exports.getWaypointCountData = getWaypointCountData;
 exports.getWaypointDataForType = getWaypointDataForType;
+exports.isSupportedHost = isSupportedHost;
 exports.matchSupportedUrl = matchSupportedUrl;
 exports.parseAtUri = parseAtUri;
 exports.parseURI = parseURI;
 exports.resolveAtUri = resolveAtUri;
 exports.resolveHandle = resolveHandle;
+exports.resolveHandleStatus = resolveHandleStatus;
 exports.resolveUrl = resolveUrl;
 exports.resolveViaApi = resolveViaApi;
 exports.waypointActivity = waypointActivity;