@atproto/pds 0.4.198 → 0.4.200

package/src/lexicon/lexicons.ts

@@ -401,6 +401,7 @@ export const schemaDict = {
             'lex:app.bsky.actor.defs#savedFeedsPref',
             'lex:app.bsky.actor.defs#savedFeedsPrefV2',
             'lex:app.bsky.actor.defs#personalDetailsPref',
+            'lex:app.bsky.actor.defs#declaredAgePref',
             'lex:app.bsky.actor.defs#feedViewPref',
             'lex:app.bsky.actor.defs#threadViewPref',
             'lex:app.bsky.actor.defs#interestsPref',
@@ -507,6 +508,28 @@ export const schemaDict = {
           },
         },
       },
+      declaredAgePref: {
+        type: 'object',
+        description:
+          "Read-only preference containing value(s) inferred from the user's declared birthdate. Absence of this preference object in the response indicates that the user has not made a declaration.",
+        properties: {
+          isOverAge13: {
+            type: 'boolean',
+            description:
+              'Indicates if the user has declared that they are over 13 years of age.',
+          },
+          isOverAge16: {
+            type: 'boolean',
+            description:
+              'Indicates if the user has declared that they are over 16 years of age.',
+          },
+          isOverAge18: {
+            type: 'boolean',
+            description:
+              'Indicates if the user has declared that they are over 18 years of age.',
+          },
+        },
+      },
       feedViewPref: {
         type: 'object',
         required: ['feed'],
@@ -1776,6 +1799,24 @@ export const schemaDict = {
           },
         },
       },
+      notification: {
+        description:
+          'A stash object to be sent via bsync representing a notification to be created.',
+        type: 'object',
+        required: ['from', 'to'],
+        properties: {
+          from: {
+            description: 'The DID of who this notification comes from.',
+            type: 'string',
+            format: 'did',
+          },
+          to: {
+            description: 'The DID of who this notification should go to.',
+            type: 'string',
+            format: 'did',
+          },
+        },
+      },
     },
   },
   AppBskyContactDismissMatch: {
@@ -1785,7 +1826,7 @@ export const schemaDict = {
       main: {
         type: 'procedure',
         description:
-          "WARNING: This is unstable and under active development, don't use it while this warning is here. Removes a match that was found via contact import. It shouldn't appear again if the same contact is re-imported. Requires authentication.",
+          "Removes a match that was found via contact import. It shouldn't appear again if the same contact is re-imported. Requires authentication.",
         input: {
           encoding: 'application/json',
           schema: {
@@ -1809,8 +1850,10 @@ export const schemaDict = {
         },
         errors: [
           {
-            name: 'TODO',
-            description: 'TODO',
+            name: 'InvalidDid',
+          },
+          {
+            name: 'InternalError',
           },
         ],
       },
@@ -1823,7 +1866,7 @@ export const schemaDict = {
       main: {
         type: 'query',
         description:
-          "WARNING: This is unstable and under active development, don't use it while this warning is here. Returns the matched contacts (contacts that were mutually imported). Excludes dismissed matches. Requires authentication.",
+          'Returns the matched contacts (contacts that were mutually imported). Excludes dismissed matches. Requires authentication.',
         parameters: {
           type: 'params',
           properties: {
@@ -1859,8 +1902,16 @@ export const schemaDict = {
         },
         errors: [
           {
-            name: 'TODO',
-            description: 'TODO',
+            name: 'InvalidDid',
+          },
+          {
+            name: 'InvalidLimit',
+          },
+          {
+            name: 'InvalidCursor',
+          },
+          {
+            name: 'InternalError',
           },
         ],
       },
@@ -1873,7 +1924,7 @@ export const schemaDict = {
       main: {
         type: 'query',
         description:
-          "WARNING: This is unstable and under active development, don't use it while this warning is here. Gets the user's current contact import status. Requires authentication.",
+          "Gets the user's current contact import status. Requires authentication.",
         parameters: {
           type: 'params',
           properties: {},
@@ -1894,8 +1945,10 @@ export const schemaDict = {
         },
         errors: [
           {
-            name: 'TODO',
-            description: 'TODO',
+            name: 'InvalidDid',
+          },
+          {
+            name: 'InternalError',
           },
         ],
       },
@@ -1908,7 +1961,7 @@ export const schemaDict = {
       main: {
         type: 'procedure',
         description:
-          "WARNING: This is unstable and under active development, don't use it while this warning is here. Import contacts for securely matching with other users. This follows the protocol explained in https://docs.bsky.app/blog/contact-import-rfc. Requires authentication.",
+          'Import contacts for securely matching with other users. This follows the protocol explained in https://docs.bsky.app/blog/contact-import-rfc. Requires authentication.',
         input: {
           encoding: 'application/json',
           schema: {
@@ -1953,8 +2006,19 @@ export const schemaDict = {
         },
         errors: [
           {
-            name: 'TODO',
-            description: 'TODO',
+            name: 'InvalidDid',
+          },
+          {
+            name: 'InvalidContacts',
+          },
+          {
+            name: 'TooManyContacts',
+          },
+          {
+            name: 'InvalidToken',
+          },
+          {
+            name: 'InternalError',
           },
         ],
       },
@@ -1967,7 +2031,7 @@ export const schemaDict = {
       main: {
         type: 'procedure',
         description:
-          "WARNING: This is unstable and under active development, don't use it while this warning is here. Removes all stored hashes used for contact matching, existing matches, and sync status. Requires authentication.",
+          'Removes all stored hashes used for contact matching, existing matches, and sync status. Requires authentication.',
         input: {
           encoding: 'application/json',
           schema: {
@@ -1984,13 +2048,52 @@ export const schemaDict = {
         },
         errors: [
           {
-            name: 'TODO',
-            description: 'TODO',
+            name: 'InvalidDid',
+          },
+          {
+            name: 'InternalError',
           },
         ],
       },
     },
   },
+  AppBskyContactSendNotification: {
+    lexicon: 1,
+    id: 'app.bsky.contact.sendNotification',
+    defs: {
+      main: {
+        type: 'procedure',
+        description:
+          'System endpoint to send notifications related to contact imports. Requires role authentication.',
+        input: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['from', 'to'],
+            properties: {
+              from: {
+                description: 'The DID of who this notification comes from.',
+                type: 'string',
+                format: 'did',
+              },
+              to: {
+                description: 'The DID of who this notification should go to.',
+                type: 'string',
+                format: 'did',
+              },
+            },
+          },
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            properties: {},
+          },
+        },
+      },
+    },
+  },
   AppBskyContactStartPhoneVerification: {
     lexicon: 1,
     id: 'app.bsky.contact.startPhoneVerification',
@@ -1998,7 +2101,7 @@ export const schemaDict = {
       main: {
         type: 'procedure',
         description:
-          "WARNING: This is unstable and under active development, don't use it while this warning is here. Starts a phone verification flow. The phone passed will receive a code via SMS that should be passed to `app.bsky.contact.verifyPhone`. Requires authentication.",
+          'Starts a phone verification flow. The phone passed will receive a code via SMS that should be passed to `app.bsky.contact.verifyPhone`. Requires authentication.',
         input: {
           encoding: 'application/json',
           schema: {
@@ -2021,8 +2124,16 @@ export const schemaDict = {
         },
         errors: [
           {
-            name: 'TODO',
-            description: 'TODO',
+            name: 'RateLimitExceeded',
+          },
+          {
+            name: 'InvalidDid',
+          },
+          {
+            name: 'InvalidPhone',
+          },
+          {
+            name: 'InternalError',
           },
         ],
       },
@@ -2035,7 +2146,7 @@ export const schemaDict = {
       main: {
         type: 'procedure',
         description:
-          "WARNING: This is unstable and under active development, don't use it while this warning is here. Verifies control over a phone number with a code received via SMS and starts a contact import session. Requires authentication.",
+          'Verifies control over a phone number with a code received via SMS and starts a contact import session. Requires authentication.',
         input: {
           encoding: 'application/json',
           schema: {
@@ -2071,8 +2182,19 @@ export const schemaDict = {
         },
         errors: [
           {
-            name: 'TODO',
-            description: 'TODO',
+            name: 'RateLimitExceeded',
+          },
+          {
+            name: 'InvalidDid',
+          },
+          {
+            name: 'InvalidPhone',
+          },
+          {
+            name: 'InvalidCode',
+          },
+          {
+            name: 'InternalError',
           },
         ],
       },
@@ -6725,6 +6847,7 @@ export const schemaDict = {
               'like-via-repost',
               'repost-via-repost',
               'subscribed-post',
+              'contact-match',
             ],
           },
           reasonSubject: {
@@ -12896,7 +13019,16 @@ export const schemaDict = {
     defs: {
       main: {
         type: 'procedure',
-        description: 'Delete the current session. Requires auth.',
+        description:
+          "Delete the current session. Requires auth using the 'refreshJwt' (not the 'accessJwt').",
+        errors: [
+          {
+            name: 'InvalidToken',
+          },
+          {
+            name: 'ExpiredToken',
+          },
+        ],
       },
     },
   },
@@ -13095,6 +13227,9 @@ export const schemaDict = {
                 type: 'string',
                 format: 'did',
               },
+              didDoc: {
+                type: 'unknown',
+              },
               email: {
                 type: 'string',
               },
@@ -13104,9 +13239,6 @@ export const schemaDict = {
               emailAuthFactor: {
                 type: 'boolean',
               },
-              didDoc: {
-                type: 'unknown',
-              },
               active: {
                 type: 'boolean',
               },
@@ -13200,6 +13332,15 @@ export const schemaDict = {
               didDoc: {
                 type: 'unknown',
               },
+              email: {
+                type: 'string',
+              },
+              emailConfirmed: {
+                type: 'boolean',
+              },
+              emailAuthFactor: {
+                type: 'boolean',
+              },
               active: {
                 type: 'boolean',
               },
@@ -13216,6 +13357,12 @@ export const schemaDict = {
           {
             name: 'AccountTakedown',
           },
+          {
+            name: 'InvalidToken',
+          },
+          {
+            name: 'ExpiredToken',
+          },
         ],
       },
     },
@@ -19949,6 +20096,7 @@ export const ids = {
   AppBskyContactGetSyncStatus: 'app.bsky.contact.getSyncStatus',
   AppBskyContactImportContacts: 'app.bsky.contact.importContacts',
   AppBskyContactRemoveData: 'app.bsky.contact.removeData',
+  AppBskyContactSendNotification: 'app.bsky.contact.sendNotification',
   AppBskyContactStartPhoneVerification:
     'app.bsky.contact.startPhoneVerification',
   AppBskyContactVerifyPhone: 'app.bsky.contact.verifyPhone',

package/src/lexicon/types/app/bsky/actor/defs.ts

@@ -259,6 +259,7 @@ export type Preferences = (
   | $Typed<SavedFeedsPref>
   | $Typed<SavedFeedsPrefV2>
   | $Typed<PersonalDetailsPref>
+  | $Typed<DeclaredAgePref>
   | $Typed<FeedViewPref>
   | $Typed<ThreadViewPref>
   | $Typed<InterestsPref>
@@ -370,6 +371,27 @@ export function validatePersonalDetailsPref<V>(v: V) {
   return validate<PersonalDetailsPref & V>(v, id, hashPersonalDetailsPref)
 }
 
+/** Read-only preference containing value(s) inferred from the user's declared birthdate. Absence of this preference object in the response indicates that the user has not made a declaration. */
+export interface DeclaredAgePref {
+  $type?: 'app.bsky.actor.defs#declaredAgePref'
+  /** Indicates if the user has declared that they are over 13 years of age. */
+  isOverAge13?: boolean
+  /** Indicates if the user has declared that they are over 16 years of age. */
+  isOverAge16?: boolean
+  /** Indicates if the user has declared that they are over 18 years of age. */
+  isOverAge18?: boolean
+}
+
+const hashDeclaredAgePref = 'declaredAgePref'
+
+export function isDeclaredAgePref<V>(v: V) {
+  return is$typed(v, id, hashDeclaredAgePref)
+}
+
+export function validateDeclaredAgePref<V>(v: V) {
+  return validate<DeclaredAgePref & V>(v, id, hashDeclaredAgePref)
+}
+
 export interface FeedViewPref {
   $type?: 'app.bsky.actor.defs#feedViewPref'
   /** The URI of the feed, or an identifier which describes the feed. */

package/src/lexicon/types/app/bsky/contact/defs.ts

@@ -50,3 +50,22 @@ export function isSyncStatus<V>(v: V) {
 export function validateSyncStatus<V>(v: V) {
   return validate<SyncStatus & V>(v, id, hashSyncStatus)
 }
+
+/** A stash object to be sent via bsync representing a notification to be created. */
+export interface Notification {
+  $type?: 'app.bsky.contact.defs#notification'
+  /** The DID of who this notification comes from. */
+  from: string
+  /** The DID of who this notification should go to. */
+  to: string
+}
+
+const hashNotification = 'notification'
+
+export function isNotification<V>(v: V) {
+  return is$typed(v, id, hashNotification)
+}
+
+export function validateNotification<V>(v: V) {
+  return validate<Notification & V>(v, id, hashNotification)
+}

package/src/lexicon/types/app/bsky/contact/dismissMatch.ts

@@ -37,7 +37,7 @@ export interface HandlerSuccess {
 export interface HandlerError {
   status: number
   message?: string
-  error?: 'TODO'
+  error?: 'InvalidDid' | 'InternalError'
 }
 
 export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/app/bsky/contact/getMatches.ts

@@ -37,7 +37,7 @@ export interface HandlerSuccess {
 export interface HandlerError {
   status: number
   message?: string
-  error?: 'TODO'
+  error?: 'InvalidDid' | 'InvalidLimit' | 'InvalidCursor' | 'InternalError'
 }
 
 export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/app/bsky/contact/getSyncStatus.ts

@@ -33,7 +33,7 @@ export interface HandlerSuccess {
 export interface HandlerError {
   status: number
   message?: string
-  error?: 'TODO'
+  error?: 'InvalidDid' | 'InternalError'
 }
 
 export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/app/bsky/contact/importContacts.ts

@@ -43,7 +43,12 @@ export interface HandlerSuccess {
 export interface HandlerError {
   status: number
   message?: string
-  error?: 'TODO'
+  error?:
+    | 'InvalidDid'
+    | 'InvalidContacts'
+    | 'TooManyContacts'
+    | 'InvalidToken'
+    | 'InternalError'
 }
 
 export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/app/bsky/contact/removeData.ts

@@ -34,7 +34,7 @@ export interface HandlerSuccess {
 export interface HandlerError {
   status: number
   message?: string
-  error?: 'TODO'
+  error?: 'InvalidDid' | 'InternalError'
 }
 
 export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/app/bsky/contact/sendNotification.ts

@@ -0,0 +1,44 @@
+/**
+ * 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.contact.sendNotification'
+
+export type QueryParams = {}
+
+export interface InputSchema {
+  /** The DID of who this notification comes from. */
+  from: string
+  /** The DID of who this notification should go to. */
+  to: string
+}
+
+export interface OutputSchema {}
+
+export interface HandlerInput {
+  encoding: 'application/json'
+  body: InputSchema
+}
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/app/bsky/contact/startPhoneVerification.ts

@@ -37,7 +37,7 @@ export interface HandlerSuccess {
 export interface HandlerError {
   status: number
   message?: string
-  error?: 'TODO'
+  error?: 'RateLimitExceeded' | 'InvalidDid' | 'InvalidPhone' | 'InternalError'
 }
 
 export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/app/bsky/contact/verifyPhone.ts

@@ -42,7 +42,12 @@ export interface HandlerSuccess {
 export interface HandlerError {
   status: number
   message?: string
-  error?: 'TODO'
+  error?:
+    | 'RateLimitExceeded'
+    | 'InvalidDid'
+    | 'InvalidPhone'
+    | 'InvalidCode'
+    | 'InternalError'
 }
 
 export type HandlerOutput = HandlerError | HandlerSuccess

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/lexicon/types/com/atproto/server/deleteSession.ts

@@ -21,6 +21,7 @@ export type HandlerInput = void
 export interface HandlerError {
   status: number
   message?: string
+  error?: 'InvalidToken' | 'ExpiredToken'
 }
 
 export type HandlerOutput = HandlerError | void

package/src/lexicon/types/com/atproto/server/getSession.ts

@@ -20,10 +20,10 @@ export type InputSchema = undefined
 export interface OutputSchema {
   handle: string
   did: string
+  didDoc?: { [_ in string]: unknown }
   email?: string
   emailConfirmed?: boolean
   emailAuthFactor?: boolean
-  didDoc?: { [_ in string]: unknown }
   active?: boolean
   /** If active=false, this optional field indicates a possible reason for why the account is not active. If active=false and no status is supplied, then the host makes no claim for why the repository is no longer being hosted. */
   status?: 'takendown' | 'suspended' | 'deactivated' | (string & {})

package/src/lexicon/types/com/atproto/server/refreshSession.ts

@@ -23,6 +23,9 @@ export interface OutputSchema {
   handle: string
   did: string
   didDoc?: { [_ in string]: unknown }
+  email?: string
+  emailConfirmed?: boolean
+  emailAuthFactor?: boolean
   active?: boolean
   /** Hosting status of the account. If not specified, then assume 'active'. */
   status?: 'takendown' | 'suspended' | 'deactivated' | (string & {})
@@ -39,7 +42,7 @@ export interface HandlerSuccess {
 export interface HandlerError {
   status: number
   message?: string
-  error?: 'AccountTakedown'
+  error?: 'AccountTakedown' | 'InvalidToken' | 'ExpiredToken'
 }
 
 export type HandlerOutput = HandlerError | HandlerSuccess

package/tests/_puppeteer.ts

@@ -0,0 +1,87 @@
+import assert from 'node:assert'
+import { type Browser, type Page } from 'puppeteer'
+
+export class PageHelper implements AsyncDisposable {
+  constructor(protected readonly page: Page) {}
+
+  async goto(url: string) {
+    await this.page.goto(url)
+  }
+
+  async waitForNetworkIdle() {
+    await this.page.waitForNetworkIdle()
+  }
+
+  async navigationAction(run: () => Promise<unknown>): Promise<void> {
+    const promise = this.page.waitForNavigation()
+    await run()
+    await promise
+    await this.waitForNetworkIdle()
+  }
+
+  async checkTitle(expected: string) {
+    await this.waitForNetworkIdle()
+    await expect(this.page.title()).resolves.toBe(expected)
+  }
+
+  async clickOn(selector: string) {
+    const elementHandle = await this.getVisibleElement(selector)
+    await elementHandle.click()
+    return elementHandle
+  }
+
+  async clickOnButton(text: string) {
+    return this.clickOn(`button::-p-text(${JSON.stringify(text)})`)
+  }
+
+  async typeIn(selector: string, text: string) {
+    const elementHandle = await this.getVisibleElement(selector)
+    elementHandle.focus()
+    await elementHandle.type(text)
+    return elementHandle
+  }
+
+  async typeInInput(name: string, text: string) {
+    return this.typeIn(`input[name=${JSON.stringify(name)}]`, text)
+  }
+
+  async ensureTextVisibility(text: string, tag = 'p') {
+    await this.page.waitForSelector(`${tag}::-p-text(${JSON.stringify(text)})`)
+  }
+
+  protected async getVisibleElement(selector: string) {
+    const elementHandle = await this.page.waitForSelector(selector)
+
+    expect(elementHandle).not.toBeNull()
+    assert(elementHandle)
+
+    await expect(elementHandle.isVisible()).resolves.toBe(true)
+
+    return elementHandle
+  }
+
+  async [Symbol.asyncDispose]() {
+    return this.page.close()
+  }
+
+  static async from(
+    browser: Browser,
+    options?: { languages?: readonly string[] },
+  ) {
+    const page = await browser.newPage()
+
+    if (options?.languages?.length) {
+      // Spoof navigator language settings
+      await page.evaluateOnNewDocument(`
+        Object.defineProperty(navigator, 'languages', {
+          get: () => ${JSON.stringify(options.languages)},
+        })
+        Object.defineProperty(navigator, 'language', {
+          get: () => ${JSON.stringify(options.languages[0])},
+        })
+      `)
+    }
+
+    return new PageHelper(page)
+  }
+}