@atproto/api 0.19.4 → 0.19.6

package/src/agent.ts

@@ -1,6 +1,6 @@
 import AwaitLock from 'await-lock'
 import { TID, retry } from '@atproto/common-web'
-import { AtUri, ensureValidDid } from '@atproto/syntax'
+import { AtUri, DidString, ensureValidDidRegex } from '@atproto/syntax'
 import {
   FetchHandler,
   FetchHandlerOptions,
@@ -63,7 +63,7 @@ const THREAD_VIEW_PREF_DEFAULTS = {
   sort: 'hotness',
 }
 
-export type { FetchHandler }
+export type { DidString, FetchHandler }
 
 /**
  * An {@link Agent} is an {@link AtpBaseClient} with the following
@@ -207,8 +207,11 @@ export class Agent extends XrpcClient {
   /**
    * Get the authenticated user's DID, if any.
    */
-  get did() {
-    return this.sessionManager.did
+  get did(): DidString | undefined {
+    const { did } = this.sessionManager
+    if (!did) return undefined
+    ensureValidDidRegex(did)
+    return did
   }
 
   /** @deprecated Use {@link Agent.assertDid} instead */
@@ -219,7 +222,7 @@ export class Agent extends XrpcClient {
   /**
    * Get the authenticated user's DID, or throw an error if not authenticated.
    */
-  get assertDid(): string {
+  get assertDid(): DidString {
     this.assertAuthenticated()
     return this.did
   }
@@ -227,7 +230,7 @@ export class Agent extends XrpcClient {
   /**
    * Assert that the user is authenticated.
    */
-  public assertAuthenticated(): asserts this is { did: string } {
+  public assertAuthenticated(): asserts this is { did: DidString } {
     if (!this.did) throw new Error('Not logged in')
   }
 
@@ -890,7 +893,7 @@ export class Agent extends XrpcClient {
     labelerDid?: string,
   ) {
     if (labelerDid) {
-      ensureValidDid(labelerDid)
+      ensureValidDidRegex(labelerDid)
     }
     await this.updatePreferences((prefs) => {
       const labelPref = prefs

package/src/atp-agent.ts

@@ -88,10 +88,6 @@ export class AtpAgent extends Agent {
     return this.sessionManager.hasSession
   }
 
-  get did() {
-    return this.sessionManager.did
-  }
-
   get serviceUrl() {
     return this.sessionManager.serviceUrl
   }

package/src/client/index.ts

@@ -134,6 +134,12 @@ import * as AppBskyUnspeccedGetSuggestedOnboardingUsers from './types/app/bsky/u
 import * as AppBskyUnspeccedGetSuggestedStarterPacks from './types/app/bsky/unspecced/getSuggestedStarterPacks.js'
 import * as AppBskyUnspeccedGetSuggestedStarterPacksSkeleton from './types/app/bsky/unspecced/getSuggestedStarterPacksSkeleton.js'
 import * as AppBskyUnspeccedGetSuggestedUsers from './types/app/bsky/unspecced/getSuggestedUsers.js'
+import * as AppBskyUnspeccedGetSuggestedUsersForDiscover from './types/app/bsky/unspecced/getSuggestedUsersForDiscover.js'
+import * as AppBskyUnspeccedGetSuggestedUsersForDiscoverSkeleton from './types/app/bsky/unspecced/getSuggestedUsersForDiscoverSkeleton.js'
+import * as AppBskyUnspeccedGetSuggestedUsersForExplore from './types/app/bsky/unspecced/getSuggestedUsersForExplore.js'
+import * as AppBskyUnspeccedGetSuggestedUsersForExploreSkeleton from './types/app/bsky/unspecced/getSuggestedUsersForExploreSkeleton.js'
+import * as AppBskyUnspeccedGetSuggestedUsersForSeeMore from './types/app/bsky/unspecced/getSuggestedUsersForSeeMore.js'
+import * as AppBskyUnspeccedGetSuggestedUsersForSeeMoreSkeleton from './types/app/bsky/unspecced/getSuggestedUsersForSeeMoreSkeleton.js'
 import * as AppBskyUnspeccedGetSuggestedUsersSkeleton from './types/app/bsky/unspecced/getSuggestedUsersSkeleton.js'
 import * as AppBskyUnspeccedGetSuggestionsSkeleton from './types/app/bsky/unspecced/getSuggestionsSkeleton.js'
 import * as AppBskyUnspeccedGetTaggedSuggestions from './types/app/bsky/unspecced/getTaggedSuggestions.js'
@@ -449,6 +455,12 @@ export * as AppBskyUnspeccedGetSuggestedOnboardingUsers from './types/app/bsky/u
 export * as AppBskyUnspeccedGetSuggestedStarterPacks from './types/app/bsky/unspecced/getSuggestedStarterPacks.js'
 export * as AppBskyUnspeccedGetSuggestedStarterPacksSkeleton from './types/app/bsky/unspecced/getSuggestedStarterPacksSkeleton.js'
 export * as AppBskyUnspeccedGetSuggestedUsers from './types/app/bsky/unspecced/getSuggestedUsers.js'
+export * as AppBskyUnspeccedGetSuggestedUsersForDiscover from './types/app/bsky/unspecced/getSuggestedUsersForDiscover.js'
+export * as AppBskyUnspeccedGetSuggestedUsersForDiscoverSkeleton from './types/app/bsky/unspecced/getSuggestedUsersForDiscoverSkeleton.js'
+export * as AppBskyUnspeccedGetSuggestedUsersForExplore from './types/app/bsky/unspecced/getSuggestedUsersForExplore.js'
+export * as AppBskyUnspeccedGetSuggestedUsersForExploreSkeleton from './types/app/bsky/unspecced/getSuggestedUsersForExploreSkeleton.js'
+export * as AppBskyUnspeccedGetSuggestedUsersForSeeMore from './types/app/bsky/unspecced/getSuggestedUsersForSeeMore.js'
+export * as AppBskyUnspeccedGetSuggestedUsersForSeeMoreSkeleton from './types/app/bsky/unspecced/getSuggestedUsersForSeeMoreSkeleton.js'
 export * as AppBskyUnspeccedGetSuggestedUsersSkeleton from './types/app/bsky/unspecced/getSuggestedUsersSkeleton.js'
 export * as AppBskyUnspeccedGetSuggestionsSkeleton from './types/app/bsky/unspecced/getSuggestionsSkeleton.js'
 export * as AppBskyUnspeccedGetTaggedSuggestions from './types/app/bsky/unspecced/getTaggedSuggestions.js'
@@ -3345,6 +3357,78 @@ export class AppBskyUnspeccedNS {
     )
   }
 
+  getSuggestedUsersForDiscover(
+    params?: AppBskyUnspeccedGetSuggestedUsersForDiscover.QueryParams,
+    opts?: AppBskyUnspeccedGetSuggestedUsersForDiscover.CallOptions,
+  ): Promise<AppBskyUnspeccedGetSuggestedUsersForDiscover.Response> {
+    return this._client.call(
+      'app.bsky.unspecced.getSuggestedUsersForDiscover',
+      params,
+      undefined,
+      opts,
+    )
+  }
+
+  getSuggestedUsersForDiscoverSkeleton(
+    params?: AppBskyUnspeccedGetSuggestedUsersForDiscoverSkeleton.QueryParams,
+    opts?: AppBskyUnspeccedGetSuggestedUsersForDiscoverSkeleton.CallOptions,
+  ): Promise<AppBskyUnspeccedGetSuggestedUsersForDiscoverSkeleton.Response> {
+    return this._client.call(
+      'app.bsky.unspecced.getSuggestedUsersForDiscoverSkeleton',
+      params,
+      undefined,
+      opts,
+    )
+  }
+
+  getSuggestedUsersForExplore(
+    params?: AppBskyUnspeccedGetSuggestedUsersForExplore.QueryParams,
+    opts?: AppBskyUnspeccedGetSuggestedUsersForExplore.CallOptions,
+  ): Promise<AppBskyUnspeccedGetSuggestedUsersForExplore.Response> {
+    return this._client.call(
+      'app.bsky.unspecced.getSuggestedUsersForExplore',
+      params,
+      undefined,
+      opts,
+    )
+  }
+
+  getSuggestedUsersForExploreSkeleton(
+    params?: AppBskyUnspeccedGetSuggestedUsersForExploreSkeleton.QueryParams,
+    opts?: AppBskyUnspeccedGetSuggestedUsersForExploreSkeleton.CallOptions,
+  ): Promise<AppBskyUnspeccedGetSuggestedUsersForExploreSkeleton.Response> {
+    return this._client.call(
+      'app.bsky.unspecced.getSuggestedUsersForExploreSkeleton',
+      params,
+      undefined,
+      opts,
+    )
+  }
+
+  getSuggestedUsersForSeeMore(
+    params?: AppBskyUnspeccedGetSuggestedUsersForSeeMore.QueryParams,
+    opts?: AppBskyUnspeccedGetSuggestedUsersForSeeMore.CallOptions,
+  ): Promise<AppBskyUnspeccedGetSuggestedUsersForSeeMore.Response> {
+    return this._client.call(
+      'app.bsky.unspecced.getSuggestedUsersForSeeMore',
+      params,
+      undefined,
+      opts,
+    )
+  }
+
+  getSuggestedUsersForSeeMoreSkeleton(
+    params?: AppBskyUnspeccedGetSuggestedUsersForSeeMoreSkeleton.QueryParams,
+    opts?: AppBskyUnspeccedGetSuggestedUsersForSeeMoreSkeleton.CallOptions,
+  ): Promise<AppBskyUnspeccedGetSuggestedUsersForSeeMoreSkeleton.Response> {
+    return this._client.call(
+      'app.bsky.unspecced.getSuggestedUsersForSeeMoreSkeleton',
+      params,
+      undefined,
+      opts,
+    )
+  }
+
   getSuggestedUsersSkeleton(
     params?: AppBskyUnspeccedGetSuggestedUsersSkeleton.QueryParams,
     opts?: AppBskyUnspeccedGetSuggestedUsersSkeleton.CallOptions,

package/src/client/lexicons.ts

@@ -6243,21 +6243,21 @@ export const schemaDict = {
                   ref: 'lex:app.bsky.actor.defs#profileView',
                 },
               },
+              recIdStr: {
+                type: 'string',
+                description:
+                  'Snowflake for this recommendation, use when submitting recommendation events.',
+              },
               isFallback: {
                 type: 'boolean',
                 description:
-                  'If true, response has fallen-back to generic results, and is not scoped using relativeToDid',
+                  'DEPRECATED, unused. Previously: if true, response has fallen-back to generic results, and is not scoped using relativeToDid',
                 default: false,
               },
               recId: {
                 type: 'integer',
                 description: 'DEPRECATED: use recIdStr instead.',
               },
-              recIdStr: {
-                type: 'string',
-                description:
-                  'Snowflake for this recommendation, use when submitting recommendation events.',
-              },
             },
           },
         },
@@ -8594,6 +8594,295 @@ export const schemaDict = {
       },
     },
   },
+  AppBskyUnspeccedGetSuggestedUsersForDiscover: {
+    lexicon: 1,
+    id: 'app.bsky.unspecced.getSuggestedUsersForDiscover',
+    defs: {
+      main: {
+        type: 'query',
+        description: 'Get a list of suggested users for the Discover page',
+        parameters: {
+          type: 'params',
+          properties: {
+            limit: {
+              type: 'integer',
+              minimum: 1,
+              maximum: 50,
+              default: 25,
+            },
+          },
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['actors'],
+            properties: {
+              actors: {
+                type: 'array',
+                items: {
+                  type: 'ref',
+                  ref: 'lex:app.bsky.actor.defs#profileView',
+                },
+              },
+              recIdStr: {
+                type: 'string',
+                description:
+                  'Snowflake for this recommendation, use when submitting recommendation events.',
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+  AppBskyUnspeccedGetSuggestedUsersForDiscoverSkeleton: {
+    lexicon: 1,
+    id: 'app.bsky.unspecced.getSuggestedUsersForDiscoverSkeleton',
+    defs: {
+      main: {
+        type: 'query',
+        description:
+          'Get a skeleton of suggested users for the Discover page. Intended to be called and hydrated by app.bsky.unspecced.getSuggestedUsersForDiscover',
+        parameters: {
+          type: 'params',
+          properties: {
+            viewer: {
+              type: 'string',
+              format: 'did',
+              description:
+                'DID of the account making the request (not included for public/unauthenticated queries).',
+            },
+            limit: {
+              type: 'integer',
+              minimum: 1,
+              maximum: 50,
+              default: 25,
+            },
+          },
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['dids'],
+            properties: {
+              dids: {
+                type: 'array',
+                items: {
+                  type: 'string',
+                  format: 'did',
+                },
+              },
+              recIdStr: {
+                type: 'string',
+                description:
+                  'Snowflake for this recommendation, use when submitting recommendation events.',
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+  AppBskyUnspeccedGetSuggestedUsersForExplore: {
+    lexicon: 1,
+    id: 'app.bsky.unspecced.getSuggestedUsersForExplore',
+    defs: {
+      main: {
+        type: 'query',
+        description: 'Get a list of suggested users for the Explore page',
+        parameters: {
+          type: 'params',
+          properties: {
+            category: {
+              type: 'string',
+              description: 'Category of users to get suggestions for.',
+            },
+            limit: {
+              type: 'integer',
+              minimum: 1,
+              maximum: 50,
+              default: 25,
+            },
+          },
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['actors'],
+            properties: {
+              actors: {
+                type: 'array',
+                items: {
+                  type: 'ref',
+                  ref: 'lex:app.bsky.actor.defs#profileView',
+                },
+              },
+              recIdStr: {
+                type: 'string',
+                description:
+                  'Snowflake for this recommendation, use when submitting recommendation events.',
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+  AppBskyUnspeccedGetSuggestedUsersForExploreSkeleton: {
+    lexicon: 1,
+    id: 'app.bsky.unspecced.getSuggestedUsersForExploreSkeleton',
+    defs: {
+      main: {
+        type: 'query',
+        description:
+          'Get a skeleton of suggested users for the Explore page. Intended to be called and hydrated by app.bsky.unspecced.getSuggestedUsersForExplore',
+        parameters: {
+          type: 'params',
+          properties: {
+            viewer: {
+              type: 'string',
+              format: 'did',
+              description:
+                'DID of the account making the request (not included for public/unauthenticated queries).',
+            },
+            category: {
+              type: 'string',
+              description: 'Category of users to get suggestions for.',
+            },
+            limit: {
+              type: 'integer',
+              minimum: 1,
+              maximum: 50,
+              default: 25,
+            },
+          },
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['dids'],
+            properties: {
+              dids: {
+                type: 'array',
+                items: {
+                  type: 'string',
+                  format: 'did',
+                },
+              },
+              recIdStr: {
+                type: 'string',
+                description:
+                  'Snowflake for this recommendation, use when submitting recommendation events.',
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+  AppBskyUnspeccedGetSuggestedUsersForSeeMore: {
+    lexicon: 1,
+    id: 'app.bsky.unspecced.getSuggestedUsersForSeeMore',
+    defs: {
+      main: {
+        type: 'query',
+        description: 'Get a list of suggested users for the See More page',
+        parameters: {
+          type: 'params',
+          properties: {
+            category: {
+              type: 'string',
+              description: 'Category of users to get suggestions for.',
+            },
+            limit: {
+              type: 'integer',
+              minimum: 1,
+              maximum: 50,
+              default: 25,
+            },
+          },
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['actors'],
+            properties: {
+              actors: {
+                type: 'array',
+                items: {
+                  type: 'ref',
+                  ref: 'lex:app.bsky.actor.defs#profileView',
+                },
+              },
+              recIdStr: {
+                type: 'string',
+                description:
+                  'Snowflake for this recommendation, use when submitting recommendation events.',
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+  AppBskyUnspeccedGetSuggestedUsersForSeeMoreSkeleton: {
+    lexicon: 1,
+    id: 'app.bsky.unspecced.getSuggestedUsersForSeeMoreSkeleton',
+    defs: {
+      main: {
+        type: 'query',
+        description:
+          'Get a skeleton of suggested users for the See More page. Intended to be called and hydrated by app.bsky.unspecced.getSuggestedUsersForSeeMore',
+        parameters: {
+          type: 'params',
+          properties: {
+            viewer: {
+              type: 'string',
+              format: 'did',
+              description:
+                'DID of the account making the request (not included for public/unauthenticated queries).',
+            },
+            category: {
+              type: 'string',
+              description: 'Category of users to get suggestions for.',
+            },
+            limit: {
+              type: 'integer',
+              minimum: 1,
+              maximum: 50,
+              default: 25,
+            },
+          },
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['dids'],
+            properties: {
+              dids: {
+                type: 'array',
+                items: {
+                  type: 'string',
+                  format: 'did',
+                },
+              },
+              recIdStr: {
+                type: 'string',
+                description:
+                  'Snowflake for this recommendation, use when submitting recommendation events.',
+              },
+            },
+          },
+        },
+      },
+    },
+  },
   AppBskyUnspeccedGetSuggestedUsersSkeleton: {
     lexicon: 1,
     id: 'app.bsky.unspecced.getSuggestedUsersSkeleton',
@@ -11842,16 +12131,13 @@ export const schemaDict = {
         type: 'string',
         knownValues: [
           '!hide',
-          '!no-promote',
           '!warn',
           '!no-unauthenticated',
-          'dmca-violation',
-          'doxxing',
           'porn',
           'sexual',
           'nudity',
-          'nsfl',
-          'gore',
+          'graphic-media',
+          'bot',
         ],
       },
     },
@@ -20887,6 +21173,18 @@ export const ids = {
   AppBskyUnspeccedGetSuggestedStarterPacksSkeleton:
     'app.bsky.unspecced.getSuggestedStarterPacksSkeleton',
   AppBskyUnspeccedGetSuggestedUsers: 'app.bsky.unspecced.getSuggestedUsers',
+  AppBskyUnspeccedGetSuggestedUsersForDiscover:
+    'app.bsky.unspecced.getSuggestedUsersForDiscover',
+  AppBskyUnspeccedGetSuggestedUsersForDiscoverSkeleton:
+    'app.bsky.unspecced.getSuggestedUsersForDiscoverSkeleton',
+  AppBskyUnspeccedGetSuggestedUsersForExplore:
+    'app.bsky.unspecced.getSuggestedUsersForExplore',
+  AppBskyUnspeccedGetSuggestedUsersForExploreSkeleton:
+    'app.bsky.unspecced.getSuggestedUsersForExploreSkeleton',
+  AppBskyUnspeccedGetSuggestedUsersForSeeMore:
+    'app.bsky.unspecced.getSuggestedUsersForSeeMore',
+  AppBskyUnspeccedGetSuggestedUsersForSeeMoreSkeleton:
+    'app.bsky.unspecced.getSuggestedUsersForSeeMoreSkeleton',
   AppBskyUnspeccedGetSuggestedUsersSkeleton:
     'app.bsky.unspecced.getSuggestedUsersSkeleton',
   AppBskyUnspeccedGetSuggestionsSkeleton:

package/src/client/types/app/bsky/graph/getSuggestedFollowsByActor.ts

@@ -23,12 +23,12 @@ export type InputSchema = undefined
 
 export interface OutputSchema {
   suggestions: AppBskyActorDefs.ProfileView[]
-  /** If true, response has fallen-back to generic results, and is not scoped using relativeToDid */
+  /** Snowflake for this recommendation, use when submitting recommendation events. */
+  recIdStr?: string
+  /** DEPRECATED, unused. Previously: if true, response has fallen-back to generic results, and is not scoped using relativeToDid */
   isFallback: boolean
   /** DEPRECATED: use recIdStr instead. */
   recId?: number
-  /** Snowflake for this recommendation, use when submitting recommendation events. */
-  recIdStr?: string
 }
 
 export interface CallOptions {

package/src/client/types/app/bsky/unspecced/getSuggestedUsersForDiscover.ts

@@ -0,0 +1,43 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import { HeadersMap, XRPCError } from '@atproto/xrpc'
+import { type ValidationResult, BlobRef } from '@atproto/lexicon'
+import { CID } from 'multiformats/cid'
+import { validate as _validate } from '../../../../lexicons'
+import {
+  type $Typed,
+  is$typed as _is$typed,
+  type OmitKey,
+} from '../../../../util'
+import type * as AppBskyActorDefs from '../actor/defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'app.bsky.unspecced.getSuggestedUsersForDiscover'
+
+export type QueryParams = {
+  limit?: number
+}
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  actors: AppBskyActorDefs.ProfileView[]
+  /** Snowflake for this recommendation, use when submitting recommendation events. */
+  recIdStr?: string
+}
+
+export interface CallOptions {
+  signal?: AbortSignal
+  headers?: HeadersMap
+}
+
+export interface Response {
+  success: boolean
+  headers: HeadersMap
+  data: OutputSchema
+}
+
+export function toKnownErr(e: any) {
+  return e
+}

package/src/client/types/app/bsky/unspecced/getSuggestedUsersForDiscoverSkeleton.ts

@@ -0,0 +1,44 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import { HeadersMap, XRPCError } from '@atproto/xrpc'
+import { type ValidationResult, BlobRef } from '@atproto/lexicon'
+import { CID } from 'multiformats/cid'
+import { validate as _validate } from '../../../../lexicons'
+import {
+  type $Typed,
+  is$typed as _is$typed,
+  type OmitKey,
+} from '../../../../util'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'app.bsky.unspecced.getSuggestedUsersForDiscoverSkeleton'
+
+export type QueryParams = {
+  /** DID of the account making the request (not included for public/unauthenticated queries). */
+  viewer?: string
+  limit?: number
+}
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  dids: string[]
+  /** Snowflake for this recommendation, use when submitting recommendation events. */
+  recIdStr?: string
+}
+
+export interface CallOptions {
+  signal?: AbortSignal
+  headers?: HeadersMap
+}
+
+export interface Response {
+  success: boolean
+  headers: HeadersMap
+  data: OutputSchema
+}
+
+export function toKnownErr(e: any) {
+  return e
+}

package/src/client/types/app/bsky/unspecced/getSuggestedUsersForExplore.ts

@@ -0,0 +1,45 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import { HeadersMap, XRPCError } from '@atproto/xrpc'
+import { type ValidationResult, BlobRef } from '@atproto/lexicon'
+import { CID } from 'multiformats/cid'
+import { validate as _validate } from '../../../../lexicons'
+import {
+  type $Typed,
+  is$typed as _is$typed,
+  type OmitKey,
+} from '../../../../util'
+import type * as AppBskyActorDefs from '../actor/defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'app.bsky.unspecced.getSuggestedUsersForExplore'
+
+export type QueryParams = {
+  /** Category of users to get suggestions for. */
+  category?: string
+  limit?: number
+}
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  actors: AppBskyActorDefs.ProfileView[]
+  /** Snowflake for this recommendation, use when submitting recommendation events. */
+  recIdStr?: string
+}
+
+export interface CallOptions {
+  signal?: AbortSignal
+  headers?: HeadersMap
+}
+
+export interface Response {
+  success: boolean
+  headers: HeadersMap
+  data: OutputSchema
+}
+
+export function toKnownErr(e: any) {
+  return e
+}