@atproto/bsky 0.0.201 → 0.0.202

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atproto/bsky",
-  "version": "0.0.201",
+  "version": "0.0.202",
   "license": "MIT",
   "description": "Reference implementation of app.bsky App View (Bluesky API)",
   "keywords": [
@@ -53,15 +53,15 @@
     "zod": "3.23.8",
     "@atproto-labs/fetch-node": "0.2.0",
     "@atproto-labs/xrpc-utils": "0.0.24",
-    "@atproto/api": "^0.18.6",
+    "@atproto/api": "^0.18.7",
     "@atproto/common": "^0.5.3",
     "@atproto/crypto": "^0.4.5",
     "@atproto/did": "^0.2.3",
     "@atproto/identity": "^0.4.10",
     "@atproto/lexicon": "^0.6.0",
     "@atproto/repo": "^0.8.12",
-    "@atproto/syntax": "^0.4.2",
     "@atproto/sync": "^0.1.39",
+    "@atproto/syntax": "^0.4.2",
     "@atproto/xrpc-server": "^0.10.3"
   },
   "devDependencies": {
@@ -78,10 +78,10 @@
     "jest": "^28.1.2",
     "ts-node": "^10.8.2",
     "typescript": "^5.6.3",
-    "@atproto/lex-cli": "^0.9.8",
-    "@atproto/api": "^0.18.6",
+    "@atproto/api": "^0.18.7",
+    "@atproto/xrpc": "^0.7.7",
     "@atproto/pds": "^0.4.199",
-    "@atproto/xrpc": "^0.7.7"
+    "@atproto/lex-cli": "^0.9.8"
   },
   "scripts": {
     "codegen": "lex gen-server --yes ./src/lexicon ../../lexicons/com/atproto/*/* ../../lexicons/app/bsky/*/* ../../lexicons/chat/bsky/*/*",

package/proto/bsky.proto

@@ -1310,6 +1310,33 @@ message GetFollowsFollowingResponse {
   repeated FollowsFollowing results = 1;
 }
 
+message GetSitemapIndexRequest {
+  SitemapPageType type = 1;
+}
+
+message GetSitemapIndexResponse {
+  // GZIP compressed XML sitemap
+  bytes sitemap = 1;
+}
+
+// Sitemap HTTP paths are typically of the form `/type/yyyy-mm-dd/N.xml.gz`, i.e. `/users/2025-01-01/1.xml.gz`
+message GetSitemapPageRequest {
+  SitemapPageType type = 1;
+  google.protobuf.Timestamp date = 2;
+  // One-indexed
+  int32 bucket = 3;
+}
+
+enum SitemapPageType {
+  SITEMAP_PAGE_TYPE_UNSPECIFIED = 0;
+  SITEMAP_PAGE_TYPE_USER = 1;
+}
+
+message GetSitemapPageResponse {
+  // GZIP compressed XML sitemap
+  bytes sitemap = 1;
+}
+
 // Ping
 message PingRequest {}
 message PingResponse {}
@@ -1470,6 +1497,10 @@ service Service {
   // Graph
   rpc GetFollowsFollowing(GetFollowsFollowingRequest) returns (GetFollowsFollowingResponse);
 
+  // Sitemaps
+  rpc GetSitemapIndex(GetSitemapIndexRequest) returns (GetSitemapIndexResponse);
+  rpc GetSitemapPage(GetSitemapPageRequest) returns (GetSitemapPageResponse);
+
   // Ping
   rpc Ping(PingRequest) returns (PingResponse);
 

package/src/api/app/bsky/ageassurance/begin.ts

@@ -37,14 +37,14 @@ export default function (server: Server, ctx: AppContext) {
 
       const actorDid = auth.credentials.iss
       const actorInfo = await getAgeVerificationState(ctx, actorDid)
+      const existingStatus = actorInfo?.ageAssuranceStatus?.status
+      const existingAccess = actorInfo?.ageAssuranceStatus?.access
 
-      if (actorInfo?.ageAssuranceStatus) {
-        if (actorInfo.ageAssuranceStatus.status === 'blocked') {
-          throw new InvalidRequestError(
-            `Cannot initiate age assurance flow from current state: ${actorInfo.ageAssuranceStatus.status}`,
-            'InvalidInitiation',
-          )
-        }
+      if (existingStatus === 'blocked') {
+        throw new InvalidRequestError(
+          `Cannot initiate age assurance flow from current state: ${existingStatus}`,
+          'InvalidInitiation',
+        )
       }
 
       const attemptId = crypto.randomUUID()
@@ -107,14 +107,24 @@ export default function (server: Server, ctx: AppContext) {
         })
       }
 
+      // If we have existing status/access for this region, retain it.
+      const nextStatus =
+        existingStatus && existingStatus !== 'unknown'
+          ? existingStatus
+          : 'pending'
+      const nextAccess =
+        existingAccess && existingAccess !== 'unknown'
+          ? existingAccess
+          : 'unknown'
+
       const event = await createEvent(ctx, actorDid, {
         attemptId,
         email,
         // Assumes `app.set('trust proxy', ...)` configured with `true` or specific values.
         initIp: req.ip,
         initUa: getClientUa(req),
-        status: 'pending',
-        access: 'unknown',
+        status: nextStatus,
+        access: nextAccess,
         countryCode,
         regionCode,
       })
@@ -123,8 +133,8 @@ export default function (server: Server, ctx: AppContext) {
         encoding: 'application/json',
         body: {
           lastInitiatedAt: event.createdAt,
-          status: 'pending',
-          access: 'unknown',
+          status: nextStatus,
+          access: nextAccess,
         },
       }
     },

package/src/api/index.ts

@@ -95,6 +95,8 @@ export * as blobResolver from './blob-resolver'
 
 export * as external from './external'
 
+export * as sitemap from './sitemap'
+
 export default function (server: Server, ctx: AppContext) {
   // app.bsky
   getTimeline(server, ctx)

package/src/api/sitemap.ts

@@ -0,0 +1,76 @@
+import { Readable } from 'node:stream'
+import { Timestamp } from '@bufbuild/protobuf'
+import { Code, ConnectError } from '@connectrpc/connect'
+import express, { RequestHandler, Router } from 'express'
+import { AppContext } from '../context'
+import { httpLogger as log } from '../logger'
+import { SitemapPageType } from '../proto/bsky_pb'
+
+export const createRouter = (ctx: AppContext): Router => {
+  const router = Router()
+  router.get('/external/sitemap/users.xml.gz', userIndexHandler(ctx))
+  router.get(
+    '/external/sitemap/users/:date/:bucket.xml.gz',
+    userPageHandler(ctx),
+  )
+  return router
+}
+
+const userIndexHandler =
+  (ctx: AppContext): RequestHandler =>
+  async (_req: express.Request, res: express.Response) => {
+    try {
+      const result = await ctx.dataplane.getSitemapIndex({
+        type: SitemapPageType.USER,
+      })
+      res.set('Content-Type', 'application/gzip')
+      res.set('Content-Encoding', 'gzip')
+      Readable.from(Buffer.from(result.sitemap)).pipe(res)
+    } catch (err) {
+      log.error({ err }, 'failed to get sitemap index')
+      return res.status(500).send('Internal Server Error')
+    }
+  }
+
+const userPageHandler =
+  (ctx: AppContext): RequestHandler =>
+  async (req: express.Request, res: express.Response) => {
+    const { date, bucket } = req.params
+
+    // Parse date (YYYY-MM-DD format)
+    const dateParts = date.split('-')
+    if (dateParts.length !== 3) {
+      return res.status(400).send('Invalid date format. Expected YYYY-MM-DD')
+    }
+
+    const year = parseInt(dateParts[0], 10)
+    const month = parseInt(dateParts[1], 10)
+    const day = parseInt(dateParts[2], 10)
+
+    if (isNaN(year) || isNaN(month) || isNaN(day)) {
+      return res.status(400).send('Invalid date format. Expected YYYY-MM-DD')
+    }
+
+    // Parse bucket (1-indexed)
+    const bucketNum = parseInt(bucket, 10)
+    if (isNaN(bucketNum) || bucketNum < 1) {
+      return res.status(400).send('Invalid bucket number')
+    }
+
+    try {
+      const result = await ctx.dataplane.getSitemapPage({
+        type: SitemapPageType.USER,
+        date: Timestamp.fromDate(new Date(year, month - 1, day)),
+        bucket: bucketNum,
+      })
+      res.set('Content-Type', 'application/gzip')
+      res.set('Content-Encoding', 'gzip')
+      Readable.from(Buffer.from(result.sitemap)).pipe(res)
+    } catch (err) {
+      if (err instanceof ConnectError && err.code === Code.NotFound) {
+        return res.status(404).send('Sitemap page not found')
+      }
+      log.error({ err }, 'failed to get sitemap page')
+      return res.status(500).send('Internal Server Error')
+    }
+  }

package/src/data-plane/server/routes/index.ts

@@ -22,6 +22,7 @@ import records from './records'
 import relationships from './relationships'
 import reposts from './reposts'
 import search from './search'
+import sitemap from './sitemap'
 import starterPacks from './starter-packs'
 import suggestions from './suggestions'
 import sync from './sync'
@@ -50,6 +51,7 @@ export default (db: Database, idResolver: IdResolver) =>
       ...relationships(db),
       ...reposts(db),
       ...search(db),
+      ...sitemap(),
       ...suggestions(db),
       ...sync(db),
       ...threads(db),

package/src/data-plane/server/routes/profile.ts

@@ -136,12 +136,14 @@ export default (db: Database): Partial<ServiceImpl<typeof Service>> => ({
 
         const status = row?.ageAssuranceStatus ?? 'unknown'
         let access = row?.ageAssuranceAccess
-        if (status === 'assured') {
-          access = 'full'
-        } else if (status === 'blocked') {
-          access = 'none'
-        } else {
-          access = 'unknown'
+        if (!access || access === 'unknown') {
+          if (status === 'assured') {
+            access = 'full'
+          } else if (status === 'blocked') {
+            access = 'none'
+          } else {
+            access = 'unknown'
+          }
         }
 
         return {

package/src/data-plane/server/routes/sitemap.ts

@@ -0,0 +1,43 @@
+import { gzipSync } from 'node:zlib'
+import { Code, ConnectError, ServiceImpl } from '@connectrpc/connect'
+import { Service } from '../../../proto/bsky_connect'
+import { GetSitemapPageRequest } from '../../../proto/bsky_pb'
+
+const MOCK_SITEMAP_INDEX = `<?xml version="1.0" encoding="UTF-8"?>
+<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <sitemap>
+    <loc>https://bsky.app/sitemap/users/2025-01-01/1.xml.gz</loc>
+  </sitemap>
+</sitemapindex>`
+
+const MOCK_SITEMAP_PAGE = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://bsky.app/profile/test.bsky.social</loc>
+  </url>
+</urlset>`
+
+export default (): Partial<ServiceImpl<typeof Service>> => ({
+  async getSitemapIndex() {
+    return {
+      sitemap: gzipSync(Buffer.from(MOCK_SITEMAP_INDEX)),
+    }
+  },
+  async getSitemapPage(req: GetSitemapPageRequest) {
+    const date = req.date?.toDate()
+    const isExpectedDate =
+      date &&
+      date.getFullYear() === 2025 &&
+      date.getMonth() === 0 &&
+      date.getDate() === 1
+    const isExpectedBucket = req.bucket === 1
+
+    if (!isExpectedDate || !isExpectedBucket) {
+      throw new ConnectError('Sitemap page not found', Code.NotFound)
+    }
+
+    return {
+      sitemap: gzipSync(Buffer.from(MOCK_SITEMAP_PAGE)),
+    }
+  },
+})

package/src/index.ts

@@ -10,7 +10,7 @@ import { AtpAgent } from '@atproto/api'
 import { DAY, SECOND } from '@atproto/common'
 import { Keypair } from '@atproto/crypto'
 import { IdResolver } from '@atproto/identity'
-import API, { blobResolver, external, health, wellKnown } from './api'
+import API, { blobResolver, external, health, sitemap, wellKnown } from './api'
 import { createBlobDispatcher } from './api/blob-dispatcher'
 import { AuthVerifier, createPublicKeyObject } from './auth-verifier'
 import { authWithApiKey as bsyncAuth, createBsyncClient } from './bsync'
@@ -225,6 +225,11 @@ export class BskyAppView {
     app.use(wellKnown.createRouter(ctx))
     app.use(blobResolver.createMiddleware(ctx))
     app.use(imageServer.createMiddleware(ctx, { prefix: '/img/' }))
+
+    if (config.dataplaneUrls.length > 0 || config.dataplaneUrlsEtcdKeyPrefix) {
+      app.use(sitemap.createRouter(ctx))
+    }
+
     app.use(server.xrpc.router)
     app.use(error.handler)
     app.use('/external', external.createRouter(ctx))

package/src/lexicon/lexicons.ts

@@ -6803,6 +6803,7 @@ export const schemaDict = {
               'like-via-repost',
               'repost-via-repost',
               'subscribed-post',
+              'contact-match',
             ],
           },
           reasonSubject: {

package/src/lexicon/types/app/bsky/notification/listNotifications.ts

@@ -67,6 +67,7 @@ export interface Notification {
     | 'like-via-repost'
     | 'repost-via-repost'
     | 'subscribed-post'
+    | 'contact-match'
     | (string & {})
   reasonSubject?: string
   record: { [_ in string]: unknown }

package/src/proto/bsky_connect.ts

@@ -3,7 +3,7 @@
 /* eslint-disable */
 // @ts-nocheck
 
-import { ClearActorMutelistSubscriptionsRequest, ClearActorMutelistSubscriptionsResponse, ClearActorMutesRequest, ClearActorMutesResponse, ClearThreadMutesRequest, ClearThreadMutesResponse, CreateActorMutelistSubscriptionRequest, CreateActorMutelistSubscriptionResponse, CreateActorMuteRequest, CreateActorMuteResponse, CreateThreadMuteRequest, CreateThreadMuteResponse, DeleteActorMutelistSubscriptionRequest, DeleteActorMutelistSubscriptionResponse, DeleteActorMuteRequest, DeleteActorMuteResponse, DeleteThreadMuteRequest, DeleteThreadMuteResponse, GetActivitySubscriptionDidsRequest, GetActivitySubscriptionDidsResponse, GetActivitySubscriptionsByActorAndSubjectsRequest, GetActivitySubscriptionsByActorAndSubjectsResponse, GetActorBookmarksRequest, GetActorBookmarksResponse, GetActorChatDeclarationRecordsRequest, GetActorChatDeclarationRecordsResponse, GetActorFeedsRequest, GetActorFeedsResponse, GetActorFollowsActorsRequest, GetActorFollowsActorsResponse, GetActorLikesRequest, GetActorLikesResponse, GetActorListsRequest, GetActorListsResponse, GetActorMutesActorRequest, GetActorMutesActorResponse, GetActorMutesActorViaListRequest, GetActorMutesActorViaListResponse, GetActorRepostsRequest, GetActorRepostsResponse, GetActorsRequest, GetActorsResponse, GetActorStarterPacksRequest, GetActorStarterPacksResponse, GetActorTakedownRequest, GetActorTakedownResponse, GetAllLabelersRequest, GetAllLabelersResponse, GetAuthorFeedRequest, GetAuthorFeedResponse, GetBidirectionalBlockRequest, GetBidirectionalBlockResponse, GetBidirectionalBlockViaListRequest, GetBidirectionalBlockViaListResponse, GetBlobTakedownRequest, GetBlobTakedownResponse, GetBlockExistenceRequest, GetBlockExistenceResponse, GetBlocklistSubscriptionRequest, GetBlocklistSubscriptionResponse, GetBlocklistSubscriptionsRequest, GetBlocklistSubscriptionsResponse, GetBlockRecordsRequest, GetBlockRecordsResponse, GetBlocksRequest, GetBlocksResponse, GetBookmarksByActorAndSubjectsRequest, GetBookmarksByActorAndSubjectsResponse, GetCountsForUsersRequest, GetCountsForUsersResponse, GetDidsByHandlesRequest, GetDidsByHandlesResponse, GetFeedGeneratorRecordsRequest, GetFeedGeneratorRecordsResponse, GetFeedGeneratorStatusRequest, GetFeedGeneratorStatusResponse, GetFollowersRequest, GetFollowersResponse, GetFollowRecordsRequest, GetFollowRecordsResponse, GetFollowsFollowingRequest, GetFollowsFollowingResponse, GetFollowsRequest, GetFollowsResponse, GetFollowSuggestionsRequest, GetFollowSuggestionsResponse, GetIdentityByDidRequest, GetIdentityByDidResponse, GetIdentityByHandleRequest, GetIdentityByHandleResponse, GetInteractionCountsRequest, GetInteractionCountsResponse, GetLabelerRecordsRequest, GetLabelerRecordsResponse, GetLabelsRequest, GetLabelsResponse, GetLatestRevRequest, GetLatestRevResponse, GetLikeRecordsRequest, GetLikeRecordsResponse, GetLikesByActorAndSubjectsRequest, GetLikesByActorAndSubjectsResponse, GetLikesBySubjectRequest, GetLikesBySubjectResponse, GetLikesBySubjectSortedRequest, GetLikesBySubjectSortedResponse, GetListBlockRecordsRequest, GetListBlockRecordsResponse, GetListCountRequest, GetListCountResponse, GetListCountsRequest, GetListCountsResponse, GetListFeedRequest, GetListFeedResponse, GetListItemRecordsRequest, GetListItemRecordsResponse, GetListMembershipRequest, GetListMembershipResponse, GetListMembersRequest, GetListMembersResponse, GetListRecordsRequest, GetListRecordsResponse, GetMutelistSubscriptionRequest, GetMutelistSubscriptionResponse, GetMutelistSubscriptionsRequest, GetMutelistSubscriptionsResponse, GetMutesRequest, GetMutesResponse, GetNewUserCountForRangeRequest, GetNewUserCountForRangeResponse, GetNotificationDeclarationRecordsRequest, GetNotificationDeclarationRecordsResponse, GetNotificationPreferencesRequest, GetNotificationPreferencesResponse, GetNotificationSeenRequest, GetNotificationSeenResponse, GetNotificationsRequest, GetNotificationsResponse, GetPostgateRecordsRequest, GetPostgateRecordsResponse, GetPostRecordsRequest, GetPostRecordsResponse, GetProfileRecordsRequest, GetProfileRecordsResponse, GetQuotesBySubjectSortedRequest, GetQuotesBySubjectSortedResponse, GetRecordTakedownRequest, GetRecordTakedownResponse, GetRelationshipsRequest, GetRelationshipsResponse, GetRepostRecordsRequest, GetRepostRecordsResponse, GetRepostsByActorAndSubjectsRequest, GetRepostsByActorAndSubjectsResponse, GetRepostsBySubjectRequest, GetRepostsBySubjectResponse, GetStarterPackCountsRequest, GetStarterPackCountsResponse, GetStarterPackRecordsRequest, GetStarterPackRecordsResponse, GetStatusRecordsRequest, GetStatusRecordsResponse, GetSuggestedEntitiesRequest, GetSuggestedEntitiesResponse, GetSuggestedFeedsRequest, GetSuggestedFeedsResponse, GetThreadGateRecordsRequest, GetThreadGateRecordsResponse, GetThreadMutesOnSubjectsRequest, GetThreadMutesOnSubjectsResponse, GetThreadRequest, GetThreadResponse, GetTimelineRequest, GetTimelineResponse, GetUnreadNotificationCountRequest, GetUnreadNotificationCountResponse, GetVerificationRecordsRequest, GetVerificationRecordsResponse, GetVerificationsIssuedRequest, GetVerificationsIssuedResponse, GetVerificationsReceivedRequest, GetVerificationsReceivedResponse, PingRequest, PingResponse, SearchActorsRequest, SearchActorsResponse, SearchFeedGeneratorsRequest, SearchFeedGeneratorsResponse, SearchPostsRequest, SearchPostsResponse, SearchStarterPacksRequest, SearchStarterPacksResponse, TakedownActorRequest, TakedownActorResponse, TakedownBlobRequest, TakedownBlobResponse, TakedownRecordRequest, TakedownRecordResponse, UntakedownActorRequest, UntakedownActorResponse, UntakedownBlobRequest, UntakedownBlobResponse, UntakedownRecordRequest, UntakedownRecordResponse, UpdateActorUpstreamStatusRequest, UpdateActorUpstreamStatusResponse, UpdateNotificationSeenRequest, UpdateNotificationSeenResponse } from "./bsky_pb";
+import { ClearActorMutelistSubscriptionsRequest, ClearActorMutelistSubscriptionsResponse, ClearActorMutesRequest, ClearActorMutesResponse, ClearThreadMutesRequest, ClearThreadMutesResponse, CreateActorMutelistSubscriptionRequest, CreateActorMutelistSubscriptionResponse, CreateActorMuteRequest, CreateActorMuteResponse, CreateThreadMuteRequest, CreateThreadMuteResponse, DeleteActorMutelistSubscriptionRequest, DeleteActorMutelistSubscriptionResponse, DeleteActorMuteRequest, DeleteActorMuteResponse, DeleteThreadMuteRequest, DeleteThreadMuteResponse, GetActivitySubscriptionDidsRequest, GetActivitySubscriptionDidsResponse, GetActivitySubscriptionsByActorAndSubjectsRequest, GetActivitySubscriptionsByActorAndSubjectsResponse, GetActorBookmarksRequest, GetActorBookmarksResponse, GetActorChatDeclarationRecordsRequest, GetActorChatDeclarationRecordsResponse, GetActorFeedsRequest, GetActorFeedsResponse, GetActorFollowsActorsRequest, GetActorFollowsActorsResponse, GetActorLikesRequest, GetActorLikesResponse, GetActorListsRequest, GetActorListsResponse, GetActorMutesActorRequest, GetActorMutesActorResponse, GetActorMutesActorViaListRequest, GetActorMutesActorViaListResponse, GetActorRepostsRequest, GetActorRepostsResponse, GetActorsRequest, GetActorsResponse, GetActorStarterPacksRequest, GetActorStarterPacksResponse, GetActorTakedownRequest, GetActorTakedownResponse, GetAllLabelersRequest, GetAllLabelersResponse, GetAuthorFeedRequest, GetAuthorFeedResponse, GetBidirectionalBlockRequest, GetBidirectionalBlockResponse, GetBidirectionalBlockViaListRequest, GetBidirectionalBlockViaListResponse, GetBlobTakedownRequest, GetBlobTakedownResponse, GetBlockExistenceRequest, GetBlockExistenceResponse, GetBlocklistSubscriptionRequest, GetBlocklistSubscriptionResponse, GetBlocklistSubscriptionsRequest, GetBlocklistSubscriptionsResponse, GetBlockRecordsRequest, GetBlockRecordsResponse, GetBlocksRequest, GetBlocksResponse, GetBookmarksByActorAndSubjectsRequest, GetBookmarksByActorAndSubjectsResponse, GetCountsForUsersRequest, GetCountsForUsersResponse, GetDidsByHandlesRequest, GetDidsByHandlesResponse, GetFeedGeneratorRecordsRequest, GetFeedGeneratorRecordsResponse, GetFeedGeneratorStatusRequest, GetFeedGeneratorStatusResponse, GetFollowersRequest, GetFollowersResponse, GetFollowRecordsRequest, GetFollowRecordsResponse, GetFollowsFollowingRequest, GetFollowsFollowingResponse, GetFollowsRequest, GetFollowsResponse, GetFollowSuggestionsRequest, GetFollowSuggestionsResponse, GetIdentityByDidRequest, GetIdentityByDidResponse, GetIdentityByHandleRequest, GetIdentityByHandleResponse, GetInteractionCountsRequest, GetInteractionCountsResponse, GetLabelerRecordsRequest, GetLabelerRecordsResponse, GetLabelsRequest, GetLabelsResponse, GetLatestRevRequest, GetLatestRevResponse, GetLikeRecordsRequest, GetLikeRecordsResponse, GetLikesByActorAndSubjectsRequest, GetLikesByActorAndSubjectsResponse, GetLikesBySubjectRequest, GetLikesBySubjectResponse, GetLikesBySubjectSortedRequest, GetLikesBySubjectSortedResponse, GetListBlockRecordsRequest, GetListBlockRecordsResponse, GetListCountRequest, GetListCountResponse, GetListCountsRequest, GetListCountsResponse, GetListFeedRequest, GetListFeedResponse, GetListItemRecordsRequest, GetListItemRecordsResponse, GetListMembershipRequest, GetListMembershipResponse, GetListMembersRequest, GetListMembersResponse, GetListRecordsRequest, GetListRecordsResponse, GetMutelistSubscriptionRequest, GetMutelistSubscriptionResponse, GetMutelistSubscriptionsRequest, GetMutelistSubscriptionsResponse, GetMutesRequest, GetMutesResponse, GetNewUserCountForRangeRequest, GetNewUserCountForRangeResponse, GetNotificationDeclarationRecordsRequest, GetNotificationDeclarationRecordsResponse, GetNotificationPreferencesRequest, GetNotificationPreferencesResponse, GetNotificationSeenRequest, GetNotificationSeenResponse, GetNotificationsRequest, GetNotificationsResponse, GetPostgateRecordsRequest, GetPostgateRecordsResponse, GetPostRecordsRequest, GetPostRecordsResponse, GetProfileRecordsRequest, GetProfileRecordsResponse, GetQuotesBySubjectSortedRequest, GetQuotesBySubjectSortedResponse, GetRecordTakedownRequest, GetRecordTakedownResponse, GetRelationshipsRequest, GetRelationshipsResponse, GetRepostRecordsRequest, GetRepostRecordsResponse, GetRepostsByActorAndSubjectsRequest, GetRepostsByActorAndSubjectsResponse, GetRepostsBySubjectRequest, GetRepostsBySubjectResponse, GetSitemapIndexRequest, GetSitemapIndexResponse, GetSitemapPageRequest, GetSitemapPageResponse, GetStarterPackCountsRequest, GetStarterPackCountsResponse, GetStarterPackRecordsRequest, GetStarterPackRecordsResponse, GetStatusRecordsRequest, GetStatusRecordsResponse, GetSuggestedEntitiesRequest, GetSuggestedEntitiesResponse, GetSuggestedFeedsRequest, GetSuggestedFeedsResponse, GetThreadGateRecordsRequest, GetThreadGateRecordsResponse, GetThreadMutesOnSubjectsRequest, GetThreadMutesOnSubjectsResponse, GetThreadRequest, GetThreadResponse, GetTimelineRequest, GetTimelineResponse, GetUnreadNotificationCountRequest, GetUnreadNotificationCountResponse, GetVerificationRecordsRequest, GetVerificationRecordsResponse, GetVerificationsIssuedRequest, GetVerificationsIssuedResponse, GetVerificationsReceivedRequest, GetVerificationsReceivedResponse, PingRequest, PingResponse, SearchActorsRequest, SearchActorsResponse, SearchFeedGeneratorsRequest, SearchFeedGeneratorsResponse, SearchPostsRequest, SearchPostsResponse, SearchStarterPacksRequest, SearchStarterPacksResponse, TakedownActorRequest, TakedownActorResponse, TakedownBlobRequest, TakedownBlobResponse, TakedownRecordRequest, TakedownRecordResponse, UntakedownActorRequest, UntakedownActorResponse, UntakedownBlobRequest, UntakedownBlobResponse, UntakedownRecordRequest, UntakedownRecordResponse, UpdateActorUpstreamStatusRequest, UpdateActorUpstreamStatusResponse, UpdateNotificationSeenRequest, UpdateNotificationSeenResponse } from "./bsky_pb";
 import { MethodKind } from "@bufbuild/protobuf";
 
 /**
@@ -858,6 +858,26 @@ export const Service = {
       O: GetFollowsFollowingResponse,
       kind: MethodKind.Unary,
     },
+    /**
+     * Sitemaps
+     *
+     * @generated from rpc bsky.Service.GetSitemapIndex
+     */
+    getSitemapIndex: {
+      name: "GetSitemapIndex",
+      I: GetSitemapIndexRequest,
+      O: GetSitemapIndexResponse,
+      kind: MethodKind.Unary,
+    },
+    /**
+     * @generated from rpc bsky.Service.GetSitemapPage
+     */
+    getSitemapPage: {
+      name: "GetSitemapPage",
+      I: GetSitemapPageRequest,
+      O: GetSitemapPageResponse,
+      kind: MethodKind.Unary,
+    },
     /**
      * Ping
      *

package/src/proto/bsky_pb.ts

@@ -96,6 +96,26 @@ proto3.util.setEnumType(FeedType, "bsky.FeedType", [
   { no: 4, name: "FEED_TYPE_POSTS_WITH_VIDEO" },
 ]);
 
+/**
+ * @generated from enum bsky.SitemapPageType
+ */
+export enum SitemapPageType {
+  /**
+   * @generated from enum value: SITEMAP_PAGE_TYPE_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * @generated from enum value: SITEMAP_PAGE_TYPE_USER = 1;
+   */
+  USER = 1,
+}
+// Retrieve enum metadata with: proto3.getEnumType(SitemapPageType)
+proto3.util.setEnumType(SitemapPageType, "bsky.SitemapPageType", [
+  { no: 0, name: "SITEMAP_PAGE_TYPE_UNSPECIFIED" },
+  { no: 1, name: "SITEMAP_PAGE_TYPE_USER" },
+]);
+
 /**
  * @generated from message bsky.Record
  */
@@ -9391,6 +9411,174 @@ export class GetFollowsFollowingResponse extends Message<GetFollowsFollowingResp
   }
 }
 
+/**
+ * @generated from message bsky.GetSitemapIndexRequest
+ */
+export class GetSitemapIndexRequest extends Message<GetSitemapIndexRequest> {
+  /**
+   * @generated from field: bsky.SitemapPageType type = 1;
+   */
+  type = SitemapPageType.UNSPECIFIED;
+
+  constructor(data?: PartialMessage<GetSitemapIndexRequest>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "bsky.GetSitemapIndexRequest";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "type", kind: "enum", T: proto3.getEnumType(SitemapPageType) },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetSitemapIndexRequest {
+    return new GetSitemapIndexRequest().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetSitemapIndexRequest {
+    return new GetSitemapIndexRequest().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetSitemapIndexRequest {
+    return new GetSitemapIndexRequest().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: GetSitemapIndexRequest | PlainMessage<GetSitemapIndexRequest> | undefined, b: GetSitemapIndexRequest | PlainMessage<GetSitemapIndexRequest> | undefined): boolean {
+    return proto3.util.equals(GetSitemapIndexRequest, a, b);
+  }
+}
+
+/**
+ * @generated from message bsky.GetSitemapIndexResponse
+ */
+export class GetSitemapIndexResponse extends Message<GetSitemapIndexResponse> {
+  /**
+   * GZIP compressed XML sitemap
+   *
+   * @generated from field: bytes sitemap = 1;
+   */
+  sitemap = new Uint8Array(0);
+
+  constructor(data?: PartialMessage<GetSitemapIndexResponse>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "bsky.GetSitemapIndexResponse";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "sitemap", kind: "scalar", T: 12 /* ScalarType.BYTES */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetSitemapIndexResponse {
+    return new GetSitemapIndexResponse().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetSitemapIndexResponse {
+    return new GetSitemapIndexResponse().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetSitemapIndexResponse {
+    return new GetSitemapIndexResponse().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: GetSitemapIndexResponse | PlainMessage<GetSitemapIndexResponse> | undefined, b: GetSitemapIndexResponse | PlainMessage<GetSitemapIndexResponse> | undefined): boolean {
+    return proto3.util.equals(GetSitemapIndexResponse, a, b);
+  }
+}
+
+/**
+ * Sitemap HTTP paths are typically of the form `/type/yyyy-mm-dd/N.xml.gz`, i.e. `/users/2025-01-01/1.xml.gz`
+ *
+ * @generated from message bsky.GetSitemapPageRequest
+ */
+export class GetSitemapPageRequest extends Message<GetSitemapPageRequest> {
+  /**
+   * @generated from field: bsky.SitemapPageType type = 1;
+   */
+  type = SitemapPageType.UNSPECIFIED;
+
+  /**
+   * @generated from field: google.protobuf.Timestamp date = 2;
+   */
+  date?: Timestamp;
+
+  /**
+   * One-indexed
+   *
+   * @generated from field: int32 bucket = 3;
+   */
+  bucket = 0;
+
+  constructor(data?: PartialMessage<GetSitemapPageRequest>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "bsky.GetSitemapPageRequest";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "type", kind: "enum", T: proto3.getEnumType(SitemapPageType) },
+    { no: 2, name: "date", kind: "message", T: Timestamp },
+    { no: 3, name: "bucket", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetSitemapPageRequest {
+    return new GetSitemapPageRequest().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetSitemapPageRequest {
+    return new GetSitemapPageRequest().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetSitemapPageRequest {
+    return new GetSitemapPageRequest().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: GetSitemapPageRequest | PlainMessage<GetSitemapPageRequest> | undefined, b: GetSitemapPageRequest | PlainMessage<GetSitemapPageRequest> | undefined): boolean {
+    return proto3.util.equals(GetSitemapPageRequest, a, b);
+  }
+}
+
+/**
+ * @generated from message bsky.GetSitemapPageResponse
+ */
+export class GetSitemapPageResponse extends Message<GetSitemapPageResponse> {
+  /**
+   * GZIP compressed XML sitemap
+   *
+   * @generated from field: bytes sitemap = 1;
+   */
+  sitemap = new Uint8Array(0);
+
+  constructor(data?: PartialMessage<GetSitemapPageResponse>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "bsky.GetSitemapPageResponse";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "sitemap", kind: "scalar", T: 12 /* ScalarType.BYTES */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetSitemapPageResponse {
+    return new GetSitemapPageResponse().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetSitemapPageResponse {
+    return new GetSitemapPageResponse().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetSitemapPageResponse {
+    return new GetSitemapPageResponse().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: GetSitemapPageResponse | PlainMessage<GetSitemapPageResponse> | undefined, b: GetSitemapPageResponse | PlainMessage<GetSitemapPageResponse> | undefined): boolean {
+    return proto3.util.equals(GetSitemapPageResponse, a, b);
+  }
+}
+
 /**
  * Ping
  *