Something went wrong. Try again.
Explore blocks, labels, lists, and posts on Bluesky. skytrace.aly.town
typescript react bluesky atproto
Something went wrong. Try again.
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283import { ok } from '@atcute/client'import type { Did, GenericUri } from '@atcute/lexicons/syntax'import { isGenericUri } from '@atcute/lexicons/syntax'import * as v from '@atcute/lexicons/validations'import { BlueMicrocosmLinksGetBacklinks, BlueMicrocosmLinksGetBacklinksCount } from '@atcute/microcosm'import type { Page } from '../../types'import { SERVICE_URLS } from '../../config/serviceUrls'import { dedupeBy } from '../../lib/collections'import { isDid } from '@atcute/lexicons/syntax'import { hydrationRequests, paginationRequests } from '../runtime/requestScheduler'import { clientFor } from './client'
const backlinkSources = [ 'app.bsky.graph.block:subject', 'app.bsky.graph.listblock:subject', 'app.bsky.graph.listitem:list', 'app.bsky.graph.listitem:subject',] as consttype BacklinkSource = (typeof backlinkSources)[number]
// The deployed endpoint also accepts cursor and reverse, absent from the published params.const backlinksSchema = v.query(BlueMicrocosmLinksGetBacklinks.mainSchema.nsid, { params: v.object({ ...BlueMicrocosmLinksGetBacklinks.mainSchema.params.shape, cursor: v.optional(v.string()), reverse: v.optional(v.boolean()), }), output: BlueMicrocosmLinksGetBacklinks.mainSchema.output,})
export async function getBacklinks(options: { subject: string source: BacklinkSource did?: string limit?: number cursor?: string signal?: AbortSignal}): Promise<Page<{ uri: string }>> { if (!isGenericUri(options.subject)) throw new Error('Cannot fetch backlinks for an invalid subject URI.') if (!backlinkSources.includes(options.source)) throw new Error('Cannot fetch backlinks for an unsupported source.') if (options.did && !isDid(options.did)) throw new Error('Cannot filter backlinks for an invalid DID.') const data = await paginationRequests.run( () => ok( clientFor(SERVICE_URLS.constellation).call(backlinksSchema, { params: { did: options.did ? [options.did as Did] : undefined, subject: options.subject as GenericUri, source: options.source, limit: options.limit ?? (options.did ? 1 : 100), reverse: false, cursor: options.cursor, }, signal: options.signal, }), ), options.signal, ) const items = data.records.map((record) => ({ uri: `at://${record.did}/${record.collection}/${record.rkey}` })) return { items: dedupeBy(items, (item) => item.uri), cursor: data.cursor ?? undefined }}
/** An index total for display badges, not evidence for individual relationships or privacy decisions. */export async function getBacklinksCount(options: { subject: string source: BacklinkSource signal?: AbortSignal}): Promise<number> { if (!isGenericUri(options.subject)) throw new Error('Cannot count backlinks for an invalid subject URI.') if (!backlinkSources.includes(options.source)) throw new Error('Cannot count backlinks from an unsupported source.') const data = await hydrationRequests.run( () => ok( clientFor(SERVICE_URLS.constellation).call(BlueMicrocosmLinksGetBacklinksCount, { params: { subject: options.subject as GenericUri, source: options.source }, signal: options.signal, }), ), options.signal, ) return data.total}