@atproto/bsky 0.0.172 → 0.0.174

package/src/lexicon/index.ts

@@ -109,8 +109,8 @@ import * as AppBskyFeedGetFeedGenerators from './types/app/bsky/feed/getFeedGene
 import * as AppBskyFeedGetFeedSkeleton from './types/app/bsky/feed/getFeedSkeleton.js'
 import * as AppBskyFeedGetLikes from './types/app/bsky/feed/getLikes.js'
 import * as AppBskyFeedGetListFeed from './types/app/bsky/feed/getListFeed.js'
-import * as AppBskyFeedGetPostThread from './types/app/bsky/feed/getPostThread.js'
 import * as AppBskyFeedGetPosts from './types/app/bsky/feed/getPosts.js'
+import * as AppBskyFeedGetPostThread from './types/app/bsky/feed/getPostThread.js'
 import * as AppBskyFeedGetQuotes from './types/app/bsky/feed/getQuotes.js'
 import * as AppBskyFeedGetRepostedBy from './types/app/bsky/feed/getRepostedBy.js'
 import * as AppBskyFeedGetSuggestedFeeds from './types/app/bsky/feed/getSuggestedFeeds.js'
@@ -149,6 +149,7 @@ import * as AppBskyNotificationPutPreferencesV2 from './types/app/bsky/notificat
 import * as AppBskyNotificationRegisterPush from './types/app/bsky/notification/registerPush.js'
 import * as AppBskyNotificationUnregisterPush from './types/app/bsky/notification/unregisterPush.js'
 import * as AppBskyNotificationUpdateSeen from './types/app/bsky/notification/updateSeen.js'
+import * as AppBskyUnspeccedCheckHandleAvailability from './types/app/bsky/unspecced/checkHandleAvailability.js'
 import * as AppBskyUnspeccedGetAgeAssuranceState from './types/app/bsky/unspecced/getAgeAssuranceState.js'
 import * as AppBskyUnspeccedGetConfig from './types/app/bsky/unspecced/getConfig.js'
 import * as AppBskyUnspeccedGetPopularFeedGenerators from './types/app/bsky/unspecced/getPopularFeedGenerators.js'
@@ -1600,27 +1601,27 @@ export class AppBskyFeedNS {
     return this._server.xrpc.method(nsid, cfg)
   }
 
-  getPostThread<A extends Auth = void>(
+  getPosts<A extends Auth = void>(
     cfg: MethodConfigOrHandler<
       A,
-      AppBskyFeedGetPostThread.QueryParams,
-      AppBskyFeedGetPostThread.HandlerInput,
-      AppBskyFeedGetPostThread.HandlerOutput
+      AppBskyFeedGetPosts.QueryParams,
+      AppBskyFeedGetPosts.HandlerInput,
+      AppBskyFeedGetPosts.HandlerOutput
     >,
   ) {
-    const nsid = 'app.bsky.feed.getPostThread' // @ts-ignore
+    const nsid = 'app.bsky.feed.getPosts' // @ts-ignore
     return this._server.xrpc.method(nsid, cfg)
   }
 
-  getPosts<A extends Auth = void>(
+  getPostThread<A extends Auth = void>(
     cfg: MethodConfigOrHandler<
       A,
-      AppBskyFeedGetPosts.QueryParams,
-      AppBskyFeedGetPosts.HandlerInput,
-      AppBskyFeedGetPosts.HandlerOutput
+      AppBskyFeedGetPostThread.QueryParams,
+      AppBskyFeedGetPostThread.HandlerInput,
+      AppBskyFeedGetPostThread.HandlerOutput
     >,
   ) {
-    const nsid = 'app.bsky.feed.getPosts' // @ts-ignore
+    const nsid = 'app.bsky.feed.getPostThread' // @ts-ignore
     return this._server.xrpc.method(nsid, cfg)
   }
 
@@ -2120,6 +2121,18 @@ export class AppBskyUnspeccedNS {
     this._server = server
   }
 
+  checkHandleAvailability<A extends Auth = void>(
+    cfg: MethodConfigOrHandler<
+      A,
+      AppBskyUnspeccedCheckHandleAvailability.QueryParams,
+      AppBskyUnspeccedCheckHandleAvailability.HandlerInput,
+      AppBskyUnspeccedCheckHandleAvailability.HandlerOutput
+    >,
+  ) {
+    const nsid = 'app.bsky.unspecced.checkHandleAvailability' // @ts-ignore
+    return this._server.xrpc.method(nsid, cfg)
+  }
+
   getAgeAssuranceState<A extends Auth = void>(
     cfg: MethodConfigOrHandler<
       A,

package/src/lexicon/lexicons.ts

@@ -7282,6 +7282,48 @@ export const schemaDict = {
       },
     },
   },
+  AppBskyFeedGetPosts: {
+    lexicon: 1,
+    id: 'app.bsky.feed.getPosts',
+    defs: {
+      main: {
+        type: 'query',
+        description:
+          "Gets post views for a specified list of posts (by AT-URI). This is sometimes referred to as 'hydrating' a 'feed skeleton'.",
+        parameters: {
+          type: 'params',
+          required: ['uris'],
+          properties: {
+            uris: {
+              type: 'array',
+              description: 'List of post AT-URIs to return hydrated views for.',
+              items: {
+                type: 'string',
+                format: 'at-uri',
+              },
+              maxLength: 25,
+            },
+          },
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['posts'],
+            properties: {
+              posts: {
+                type: 'array',
+                items: {
+                  type: 'ref',
+                  ref: 'lex:app.bsky.feed.defs#postView',
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+  },
   AppBskyFeedGetPostThread: {
     lexicon: 1,
     id: 'app.bsky.feed.getPostThread',
@@ -7346,48 +7388,6 @@ export const schemaDict = {
       },
     },
   },
-  AppBskyFeedGetPosts: {
-    lexicon: 1,
-    id: 'app.bsky.feed.getPosts',
-    defs: {
-      main: {
-        type: 'query',
-        description:
-          "Gets post views for a specified list of posts (by AT-URI). This is sometimes referred to as 'hydrating' a 'feed skeleton'.",
-        parameters: {
-          type: 'params',
-          required: ['uris'],
-          properties: {
-            uris: {
-              type: 'array',
-              description: 'List of post AT-URIs to return hydrated views for.',
-              items: {
-                type: 'string',
-                format: 'at-uri',
-              },
-              maxLength: 25,
-            },
-          },
-        },
-        output: {
-          encoding: 'application/json',
-          schema: {
-            type: 'object',
-            required: ['posts'],
-            properties: {
-              posts: {
-                type: 'array',
-                items: {
-                  type: 'ref',
-                  ref: 'lex:app.bsky.feed.defs#postView',
-                },
-              },
-            },
-          },
-        },
-      },
-    },
-  },
   AppBskyFeedGetQuotes: {
     lexicon: 1,
     id: 'app.bsky.feed.getQuotes',
@@ -10511,6 +10511,104 @@ export const schemaDict = {
       },
     },
   },
+  AppBskyUnspeccedCheckHandleAvailability: {
+    lexicon: 1,
+    id: 'app.bsky.unspecced.checkHandleAvailability',
+    defs: {
+      main: {
+        type: 'query',
+        description:
+          'Checks whether the provided handle is available. If the handle is not available, available suggestions will be returned. Optional inputs will be used to generate suggestions.',
+        parameters: {
+          type: 'params',
+          required: ['handle'],
+          properties: {
+            handle: {
+              type: 'string',
+              format: 'handle',
+              description:
+                'Tentative handle. Will be checked for availability or used to build handle suggestions.',
+            },
+            email: {
+              type: 'string',
+              description:
+                'User-provided email. Might be used to build handle suggestions.',
+            },
+            birthDate: {
+              type: 'string',
+              format: 'datetime',
+              description:
+                'User-provided birth date. Might be used to build handle suggestions.',
+            },
+          },
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['handle', 'result'],
+            properties: {
+              handle: {
+                type: 'string',
+                format: 'handle',
+                description: 'Echo of the input handle.',
+              },
+              result: {
+                type: 'union',
+                refs: [
+                  'lex:app.bsky.unspecced.checkHandleAvailability#resultAvailable',
+                  'lex:app.bsky.unspecced.checkHandleAvailability#resultUnavailable',
+                ],
+              },
+            },
+          },
+        },
+        errors: [
+          {
+            name: 'InvalidEmail',
+            description: 'An invalid email was provided.',
+          },
+        ],
+      },
+      resultAvailable: {
+        type: 'object',
+        description: 'Indicates the provided handle is available.',
+        properties: {},
+      },
+      resultUnavailable: {
+        type: 'object',
+        description:
+          'Indicates the provided handle is unavailable and gives suggestions of available handles.',
+        required: ['suggestions'],
+        properties: {
+          suggestions: {
+            type: 'array',
+            description:
+              'List of suggested handles based on the provided inputs.',
+            items: {
+              type: 'ref',
+              ref: 'lex:app.bsky.unspecced.checkHandleAvailability#suggestion',
+            },
+          },
+        },
+      },
+      suggestion: {
+        type: 'object',
+        required: ['handle', 'method'],
+        properties: {
+          handle: {
+            type: 'string',
+            format: 'handle',
+          },
+          method: {
+            type: 'string',
+            description:
+              'Method used to build this suggestion. Should be considered opaque to clients. Can be used for metrics.',
+          },
+        },
+      },
+    },
+  },
   AppBskyUnspeccedDefs: {
     lexicon: 1,
     id: 'app.bsky.unspecced.defs',
@@ -11589,6 +11687,17 @@ export const schemaDict = {
             ref: 'lex:app.bsky.unspecced.defs#ageAssuranceState',
           },
         },
+        errors: [
+          {
+            name: 'InvalidEmail',
+          },
+          {
+            name: 'DidTooLong',
+          },
+          {
+            name: 'InvalidInitiation',
+          },
+        ],
       },
     },
   },
@@ -13460,8 +13569,8 @@ export const ids = {
   AppBskyFeedGetFeedSkeleton: 'app.bsky.feed.getFeedSkeleton',
   AppBskyFeedGetLikes: 'app.bsky.feed.getLikes',
   AppBskyFeedGetListFeed: 'app.bsky.feed.getListFeed',
-  AppBskyFeedGetPostThread: 'app.bsky.feed.getPostThread',
   AppBskyFeedGetPosts: 'app.bsky.feed.getPosts',
+  AppBskyFeedGetPostThread: 'app.bsky.feed.getPostThread',
   AppBskyFeedGetQuotes: 'app.bsky.feed.getQuotes',
   AppBskyFeedGetRepostedBy: 'app.bsky.feed.getRepostedBy',
   AppBskyFeedGetSuggestedFeeds: 'app.bsky.feed.getSuggestedFeeds',
@@ -13522,6 +13631,8 @@ export const ids = {
   AppBskyNotificationUnregisterPush: 'app.bsky.notification.unregisterPush',
   AppBskyNotificationUpdateSeen: 'app.bsky.notification.updateSeen',
   AppBskyRichtextFacet: 'app.bsky.richtext.facet',
+  AppBskyUnspeccedCheckHandleAvailability:
+    'app.bsky.unspecced.checkHandleAvailability',
   AppBskyUnspeccedDefs: 'app.bsky.unspecced.defs',
   AppBskyUnspeccedGetAgeAssuranceState:
     'app.bsky.unspecced.getAgeAssuranceState',

package/src/lexicon/types/app/bsky/unspecced/checkHandleAvailability.ts

@@ -0,0 +1,99 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+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.checkHandleAvailability'
+
+export type QueryParams = {
+  /** Tentative handle. Will be checked for availability or used to build handle suggestions. */
+  handle: string
+  /** User-provided email. Might be used to build handle suggestions. */
+  email?: string
+  /** User-provided birth date. Might be used to build handle suggestions. */
+  birthDate?: string
+}
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  /** Echo of the input handle. */
+  handle: string
+  result:
+    | $Typed<ResultAvailable>
+    | $Typed<ResultUnavailable>
+    | { $type: string }
+}
+
+export type HandlerInput = void
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+  error?: 'InvalidEmail'
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess
+
+/** Indicates the provided handle is available. */
+export interface ResultAvailable {
+  $type?: 'app.bsky.unspecced.checkHandleAvailability#resultAvailable'
+}
+
+const hashResultAvailable = 'resultAvailable'
+
+export function isResultAvailable<V>(v: V) {
+  return is$typed(v, id, hashResultAvailable)
+}
+
+export function validateResultAvailable<V>(v: V) {
+  return validate<ResultAvailable & V>(v, id, hashResultAvailable)
+}
+
+/** Indicates the provided handle is unavailable and gives suggestions of available handles. */
+export interface ResultUnavailable {
+  $type?: 'app.bsky.unspecced.checkHandleAvailability#resultUnavailable'
+  /** List of suggested handles based on the provided inputs. */
+  suggestions: Suggestion[]
+}
+
+const hashResultUnavailable = 'resultUnavailable'
+
+export function isResultUnavailable<V>(v: V) {
+  return is$typed(v, id, hashResultUnavailable)
+}
+
+export function validateResultUnavailable<V>(v: V) {
+  return validate<ResultUnavailable & V>(v, id, hashResultUnavailable)
+}
+
+export interface Suggestion {
+  $type?: 'app.bsky.unspecced.checkHandleAvailability#suggestion'
+  handle: string
+  /** Method used to build this suggestion. Should be considered opaque to clients. Can be used for metrics. */
+  method: string
+}
+
+const hashSuggestion = 'suggestion'
+
+export function isSuggestion<V>(v: V) {
+  return is$typed(v, id, hashSuggestion)
+}
+
+export function validateSuggestion<V>(v: V) {
+  return validate<Suggestion & V>(v, id, hashSuggestion)
+}

package/src/lexicon/types/app/bsky/unspecced/initAgeAssurance.ts

@@ -42,6 +42,7 @@ export interface HandlerSuccess {
 export interface HandlerError {
   status: number
   message?: string
+  error?: 'InvalidEmail' | 'DidTooLong' | 'InvalidInitiation'
 }
 
 export type HandlerOutput = HandlerError | HandlerSuccess

package/tests/views/age-assurance.test.ts

@@ -189,6 +189,50 @@ describe('age assurance views', () => {
     )
   })
 
+  it('ensures user cannot re-init flow from terminal state', async () => {
+    const actor = sc.dids.bob
+    const state0 = await getAgeAssurance(actor)
+    expect(state0).toStrictEqual({
+      status: 'unknown',
+    })
+
+    const init1 = await initAgeAssurance(actor)
+    expect(init1).toStrictEqual({
+      status: 'pending',
+      lastInitiatedAt: expect.any(String),
+    })
+
+    const init2 = await initAgeAssurance(actor)
+    expect(init2).toStrictEqual({
+      status: 'pending',
+      lastInitiatedAt: expect.any(String),
+    })
+
+    /**
+     * Can re-init flow if the state is pending.
+     */
+    expect(sendEmailMock).toHaveBeenCalledTimes(2)
+
+    const externalPayload: KwsExternalPayload = {
+      actorDid: actor,
+      attemptId,
+    }
+    const status = { verified: true }
+    await kwsServer.callVerificationResponse(network.bsky.url, {
+      externalPayload,
+      status,
+    })
+    const finalizedState = await getAgeAssurance(actor)
+    expect(finalizedState).toStrictEqual({
+      status: 'assured',
+      lastInitiatedAt: expect.any(String),
+    })
+
+    await expect(initAgeAssurance(actor)).rejects.toThrowError(
+      `Cannot initiate age assurance flow from current state: assured`,
+    )
+  })
+
   describe('verification response flow', () => {
     it('performs the AA flow', async () => {
       const state0 = await getAgeAssurance(actorDid)