\n \n

🧭 ATProto Repo Viewer

Browse the public collections and records stored in any AT Protocol repository.

\n \n\n \n \n\n \n\n \n\n

API

Repository description and collection list:

GET /api/{handle-or-did}

Paginated records:

GET /api/{handle-or-did}/{collection}?limit=25&cursor=…

Responses are JSON with CORS enabled.

\n\n \n

\n\n \n\n`;\n}\n",[],[188,179],"lib","b6ad0448-b26c-4bc2-9e6d-43e4eeb3bac4","atproto.ts","334e5ab8-a122-11f1-998d-1607ee4eb77e",2,["D",1787730368679],"type DidDocument = {\n service?: Array<{ id?: string; type?: string; serviceEndpoint?: unknown }>;\n};\n\ntype ListOptions = {\n limit: number;\n cursor?: string;\n reverse: boolean;\n};\n\nconst HANDLE_PATTERN = /^(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i;\nconst NSID_PATTERN = /^(?:[a-z][a-z0-9-]*\\.)+[a-z][a-z0-9-]*$/i;\n\nfunction assertPublicHttpsUrl(value: string): URL {\n const url = new URL(value);\n const host = url.hostname.toLowerCase();\n if (\n url.protocol !== \"https:\" ||\n host === \"localhost\" ||\n host.endsWith(\".localhost\") ||\n host.endsWith(\".local\") ||\n host === \"0.0.0.0\" ||\n /^127\\./.test(host) ||\n /^10\\./.test(host) ||\n /^192\\.168\\./.test(host) ||\n /^169\\.254\\./.test(host) ||\n /^172\\.(1[6-9]|2\\d|3[01])\\./.test(host) ||\n /^\\d+\\.\\d+\\.\\d+\\.\\d+$/.test(host) ||\n host === \"[::1]\"\n ) {\n throw new Error(\"Invalid or non-public PDS endpoint.\");\n }\n return url;\n}\n\nasync function fetchJson(url: URL | string): Promise {\n const response = await fetch(url, { signal: AbortSignal.timeout(10_000) });\n if (!response.ok) {\n let detail = response.statusText;\n try {\n const body = await response.json();\n if (typeof body?.message === \"string\") detail = body.message;\n else if (typeof body?.error === \"string\") detail = body.error;\n } catch {\n // Keep the HTTP status text for non-JSON upstream errors.\n }\n throw new Error(`AT Protocol request failed (${response.status}): ${detail}`);\n }\n return response.json();\n}\n\nasync function resolveDid(actor: string): Promise {\n const value = actor.trim().replace(/^@/, \"\");\n if (value.startsWith(\"did:plc:\") || value.startsWith(\"did:web:\")) return value;\n if (!HANDLE_PATTERN.test(value)) throw new Error(\"Enter a valid AT Protocol handle or DID.\");\n\n const endpoint = new URL(\"https://public.api.bsky.app/xrpc/com.atproto.identity.resolveHandle\");\n endpoint.searchParams.set(\"handle\", value);\n const result = await fetchJson<{ did?: unknown }>(endpoint);\n if (typeof result.did !== \"string\") throw new Error(\"Handle resolution returned no DID.\");\n return result.did;\n}\n\nfunction didDocumentUrl(did: string): URL {\n if (did.startsWith(\"did:plc:\")) {\n return new URL(`https://plc.directory/${encodeURIComponent(did)}`);\n }\n if (did.startsWith(\"did:web:\")) {\n const segments = did.slice(\"did:web:\".length).split(\":\").map(decodeURIComponent);\n const host = segments.shift();\n if (!host) throw new Error(\"Invalid did:web identifier.\");\n const path = segments.length ? `/${segments.join(\"/\")}/did.json` : \"/.well-known/did.json\";\n return assertPublicHttpsUrl(`https://${host}${path}`);\n }\n throw new Error(\"Invalid or unsupported DID method.\");\n}\n\nasync function resolveRepo(actor: string): Promise<{ did: string; pds: string }> {\n const did = await resolveDid(actor);\n const document = await fetchJson(didDocumentUrl(did));\n const service = document.service?.find(\n (entry) => entry.id?.endsWith(\"#atproto_pds\") || entry.type === \"AtprotoPersonalDataServer\",\n );\n if (typeof service?.serviceEndpoint !== \"string\") {\n throw new Error(\"No personal data server was found in the DID document.\");\n }\n const pds = assertPublicHttpsUrl(service.serviceEndpoint).origin;\n return { did, pds };\n}\n\nfunction xrpc(pds: string, method: string, params: Record): URL {\n const endpoint = new URL(`/xrpc/${method}`, pds);\n for (const [name, value] of Object.entries(params)) {\n if (value !== undefined) endpoint.searchParams.set(name, String(value));\n }\n return endpoint;\n}\n\nexport async function describeActor(actor: string) {\n const { did, pds } = await resolveRepo(actor);\n const data = await fetchJson>(\n xrpc(pds, \"com.atproto.repo.describeRepo\", { repo: did }),\n );\n return { ...data, pds };\n}\n\nexport async function listCollection(actor: string, collection: string, options: ListOptions) {\n if (!NSID_PATTERN.test(collection)) throw new Error(\"Invalid AT Protocol collection NSID.\");\n const { did, pds } = await resolveRepo(actor);\n return fetchJson>(\n xrpc(pds, \"com.atproto.repo.listRecords\", {\n repo: did,\n collection,\n limit: options.limit,\n cursor: options.cursor,\n reverse: options.reverse,\n }),\n );\n}\n",[],[188,190],"20c0e18e-9458-4b63-910b-74d21e09848a",["D",1787730368679],"directory",[163,164],[188],["D",1787730368162],{"_11":12,"_121":69},{"_11":12,"_116":117,"_68":69,"_30":67,"_118":119,"_120":24},{"_38":107,"_13":16,"_32":35,"_108":71,"_109":-5,"_110":-5,"_111":-5,"_112":-5,"_113":-5,"_114":14,"_115":12},"ctx",{"_53":-5,"_140":239,"_240":241,"_242":243,"_244":24,"_245":24,"_246":24,"_247":84,"_248":-5,"_249":-7,"_250":-7,"_251":26,"_252":24,"_253":24,"_254":-5,"_255":24,"_256":24,"_257":24,"_258":-5},"ENV",{"_210":211,"_212":213,"_214":16,"_215":216,"_217":218,"_219":220,"_221":222,"_223":224,"_225":226,"_227":228,"_229":230,"_231":232,"_233":234,"_235":236,"_237":238},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

History · README.md