@atproto/api 0.18.3 → 0.18.5

package/dist/index.d.ts

@@ -16,6 +16,7 @@ export * from './rich-text/util';
 export * from './moderation';
 export * from './moderation/types';
 export * from './mocker';
+export * from './age-assurance';
 export { DEFAULT_LABEL_SETTINGS, LABELS } from './moderation/const/labels';
 export { Agent } from './agent';
 export { AtpAgent, type AtpAgentOptions } from './atp-agent';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAG3C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EACL,OAAO,EACP,eAAe,EACf,SAAS,EACT,SAAS,EACT,YAAY,GACb,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC3C,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,UAAU,CAAA;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAE/B,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO;AACL,kBAAkB;AAClB,QAAQ,IAAI,OAAO,GACpB,MAAM,aAAa,CAAA;AAIpB,eAAO,MAAM,QAAQ,UAAiC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAG3C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EACL,OAAO,EACP,eAAe,EACf,SAAS,EACT,SAAS,EACT,YAAY,GACb,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC3C,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAE/B,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO;AACL,kBAAkB;AAClB,QAAQ,IAAI,OAAO,GACpB,MAAM,aAAa,CAAA;AAIpB,eAAO,MAAM,QAAQ,UAAiC,CAAA"}

package/dist/index.js

@@ -42,6 +42,7 @@ __exportStar(require("./rich-text/util"), exports);
 __exportStar(require("./moderation"), exports);
 __exportStar(require("./moderation/types"), exports);
 __exportStar(require("./mocker"), exports);
+__exportStar(require("./age-assurance"), exports);
 var labels_1 = require("./moderation/const/labels");
 Object.defineProperty(exports, "DEFAULT_LABEL_SETTINGS", { enumerable: true, get: function () { return labels_1.DEFAULT_LABEL_SETTINGS; } });
 Object.defineProperty(exports, "LABELS", { enumerable: true, get: function () { return labels_1.LABELS; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,8CAA2C;AAC3C,gDAAgE;AAEhE,0CAAuC;AAA9B,+FAAA,KAAK,OAAA;AACd,4CAMyB;AALvB,kGAAA,OAAO,OAAA;AACP,0GAAA,eAAe,OAAA;AACf,oGAAA,SAAS,OAAA;AACT,oGAAA,SAAS,OAAA;AACT,uGAAA,YAAY,OAAA;AAEd,kDAAmD;AAA1C,2GAAA,aAAa,OAAA;AACtB,0CAAuB;AACvB,0CAAuB;AACvB,yCAAsB;AACtB,2CAAwB;AACxB,8CAA2C;AAAlC,mGAAA,OAAO,OAAA;AAEhB,sCAA2C;AAAlC,mGAAA,WAAW,OAAA;AACpB,wDAAqC;AACrC,2DAAwC;AACxC,sDAAmC;AACnC,mDAAgC;AAChC,+CAA4B;AAC5B,qDAAkC;AAClC,2CAAwB;AACxB,oDAA0E;AAAjE,gHAAA,sBAAsB,OAAA;AAAE,gGAAA,MAAM,OAAA;AACvC,iCAA+B;AAAtB,8FAAA,KAAK,OAAA;AAEd,yCAA4D;AAAnD,qGAAA,QAAQ,OAAA;AACjB,yCAA+C;AAAtC,8GAAA,iBAAiB,OAAA;AAC1B,2CAAwC;AAA/B,uGAAA,SAAS,OAAA;AAElB,yCAGoB;AAFlB,kBAAkB;AAClB,oGAAA,QAAQ,OAAW;AAGrB,+EAA+E;AAC/E,2BAA2B;AACd,QAAA,QAAQ,GAAG,IAAI,kBAAQ,CAAC,mBAAgB,CAAC,CAAA","sourcesContent":["import { Lexicons } from '@atproto/lexicon'\nimport { lexicons as internalLexicons } from './client/lexicons'\n\nexport { AtUri } from '@atproto/syntax'\nexport {\n  BlobRef,\n  jsonStringToLex,\n  jsonToLex,\n  lexToJson,\n  stringifyLex,\n} from '@atproto/lexicon'\nexport { parseLanguage } from '@atproto/common-web'\nexport * from './types'\nexport * from './const'\nexport * from './util'\nexport * from './client'\nexport { schemas } from './client/lexicons'\nexport type { $Typed, Un$Typed } from './client/util'\nexport { asPredicate } from './client/util'\nexport * from './rich-text/rich-text'\nexport * from './rich-text/sanitization'\nexport * from './rich-text/unicode'\nexport * from './rich-text/util'\nexport * from './moderation'\nexport * from './moderation/types'\nexport * from './mocker'\nexport { DEFAULT_LABEL_SETTINGS, LABELS } from './moderation/const/labels'\nexport { Agent } from './agent'\n\nexport { AtpAgent, type AtpAgentOptions } from './atp-agent'\nexport { CredentialSession } from './atp-agent'\nexport { BskyAgent } from './bsky-agent'\n\nexport {\n  /** @deprecated */\n  AtpAgent as default,\n} from './atp-agent'\n\n// Expose a copy to prevent alteration of the internal Lexicon instance used by\n// the AtpBaseClient class.\nexport const lexicons = new Lexicons(internalLexicons)\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,8CAA2C;AAC3C,gDAAgE;AAEhE,0CAAuC;AAA9B,+FAAA,KAAK,OAAA;AACd,4CAMyB;AALvB,kGAAA,OAAO,OAAA;AACP,0GAAA,eAAe,OAAA;AACf,oGAAA,SAAS,OAAA;AACT,oGAAA,SAAS,OAAA;AACT,uGAAA,YAAY,OAAA;AAEd,kDAAmD;AAA1C,2GAAA,aAAa,OAAA;AACtB,0CAAuB;AACvB,0CAAuB;AACvB,yCAAsB;AACtB,2CAAwB;AACxB,8CAA2C;AAAlC,mGAAA,OAAO,OAAA;AAEhB,sCAA2C;AAAlC,mGAAA,WAAW,OAAA;AACpB,wDAAqC;AACrC,2DAAwC;AACxC,sDAAmC;AACnC,mDAAgC;AAChC,+CAA4B;AAC5B,qDAAkC;AAClC,2CAAwB;AACxB,kDAA+B;AAC/B,oDAA0E;AAAjE,gHAAA,sBAAsB,OAAA;AAAE,gGAAA,MAAM,OAAA;AACvC,iCAA+B;AAAtB,8FAAA,KAAK,OAAA;AAEd,yCAA4D;AAAnD,qGAAA,QAAQ,OAAA;AACjB,yCAA+C;AAAtC,8GAAA,iBAAiB,OAAA;AAC1B,2CAAwC;AAA/B,uGAAA,SAAS,OAAA;AAElB,yCAGoB;AAFlB,kBAAkB;AAClB,oGAAA,QAAQ,OAAW;AAGrB,+EAA+E;AAC/E,2BAA2B;AACd,QAAA,QAAQ,GAAG,IAAI,kBAAQ,CAAC,mBAAgB,CAAC,CAAA","sourcesContent":["import { Lexicons } from '@atproto/lexicon'\nimport { lexicons as internalLexicons } from './client/lexicons'\n\nexport { AtUri } from '@atproto/syntax'\nexport {\n  BlobRef,\n  jsonStringToLex,\n  jsonToLex,\n  lexToJson,\n  stringifyLex,\n} from '@atproto/lexicon'\nexport { parseLanguage } from '@atproto/common-web'\nexport * from './types'\nexport * from './const'\nexport * from './util'\nexport * from './client'\nexport { schemas } from './client/lexicons'\nexport type { $Typed, Un$Typed } from './client/util'\nexport { asPredicate } from './client/util'\nexport * from './rich-text/rich-text'\nexport * from './rich-text/sanitization'\nexport * from './rich-text/unicode'\nexport * from './rich-text/util'\nexport * from './moderation'\nexport * from './moderation/types'\nexport * from './mocker'\nexport * from './age-assurance'\nexport { DEFAULT_LABEL_SETTINGS, LABELS } from './moderation/const/labels'\nexport { Agent } from './agent'\n\nexport { AtpAgent, type AtpAgentOptions } from './atp-agent'\nexport { CredentialSession } from './atp-agent'\nexport { BskyAgent } from './bsky-agent'\n\nexport {\n  /** @deprecated */\n  AtpAgent as default,\n} from './atp-agent'\n\n// Expose a copy to prevent alteration of the internal Lexicon instance used by\n// the AtpBaseClient class.\nexport const lexicons = new Lexicons(internalLexicons)\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atproto/api",
-  "version": "0.18.3",
+  "version": "0.18.5",
   "license": "MIT",
   "description": "Client library for atproto and Bluesky",
   "keywords": [
@@ -21,16 +21,17 @@
     "multiformats": "^9.9.0",
     "tlds": "^1.234.0",
     "zod": "^3.23.8",
-    "@atproto/common-web": "^0.4.5",
-    "@atproto/lexicon": "^0.5.2",
-    "@atproto/syntax": "^0.4.1",
-    "@atproto/xrpc": "^0.7.6"
+    "@atproto/common-web": "^0.4.7",
+    "@atproto/lexicon": "^0.6.0",
+    "@atproto/syntax": "^0.4.2",
+    "@atproto/xrpc": "^0.7.7"
   },
   "devDependencies": {
+    "@jest/globals": "^28.1.3",
     "jest": "^28.1.2",
     "prettier": "^3.2.5",
     "typescript": "^5.6.3",
-    "@atproto/lex-cli": "^0.9.7"
+    "@atproto/lex-cli": "^0.9.8"
   },
   "scripts": {
     "codegen": "node ./scripts/generate-code.mjs && lex gen-api --yes ./src/client ../../lexicons/com/atproto/*/* ../../lexicons/app/bsky/*/* ../../lexicons/chat/bsky/*/* ../../lexicons/tools/ozone/*/*",

package/src/age-assurance.test.ts

@@ -0,0 +1,213 @@
+import { describe, expect, it } from '@jest/globals'
+import {
+  ageAssuranceRuleIDs,
+  computeAgeAssuranceRegionAccess,
+  getAgeAssuranceRegionConfig,
+} from './age-assurance'
+import { AppBskyAgeassuranceDefs } from './client'
+
+describe('age-assurance', () => {
+  describe('getAgeAssuranceRegionConfig', () => {
+    const config: AppBskyAgeassuranceDefs.Config = {
+      regions: [
+        {
+          countryCode: 'US',
+          regionCode: 'CA',
+          rules: [],
+        },
+        {
+          countryCode: 'US',
+          rules: [],
+        },
+      ],
+    }
+
+    it('should find region by country code only', () => {
+      const result = getAgeAssuranceRegionConfig(config, {
+        countryCode: 'US',
+      })
+
+      expect(result).toEqual({
+        countryCode: 'US',
+        rules: [],
+      })
+    })
+
+    it('should find region by country code and region code', () => {
+      const result = getAgeAssuranceRegionConfig(config, {
+        countryCode: 'US',
+        regionCode: 'CA',
+      })
+
+      expect(result).toEqual({
+        countryCode: 'US',
+        regionCode: 'CA',
+        rules: [],
+      })
+    })
+
+    it('should return undefined when no matching region found', () => {
+      const result = getAgeAssuranceRegionConfig(config, {
+        countryCode: 'GB',
+      })
+
+      expect(result).toBeUndefined()
+    })
+  })
+
+  describe('computeAgeAssuranceRegionAccess', () => {
+    const region: AppBskyAgeassuranceDefs.ConfigRegion = {
+      countryCode: 'US',
+      rules: [
+        {
+          $type: ageAssuranceRuleIDs.IfAccountNewerThan,
+          date: '2025-12-10T00:00:00Z',
+          access: 'none',
+        },
+        {
+          $type: ageAssuranceRuleIDs.IfAssuredOverAge,
+          age: 18,
+          access: 'full',
+        },
+        {
+          $type: ageAssuranceRuleIDs.IfAssuredOverAge,
+          age: 16,
+          access: 'safe',
+        },
+        {
+          $type: ageAssuranceRuleIDs.IfDeclaredOverAge,
+          age: 16,
+          access: 'safe',
+        },
+        {
+          $type: ageAssuranceRuleIDs.Default,
+          access: 'none',
+        },
+      ],
+    }
+
+    it('should apply default if no data provided', () => {
+      const result = computeAgeAssuranceRegionAccess(region, {})
+
+      expect(result).toEqual({
+        access: 'none',
+        reason: ageAssuranceRuleIDs.Default,
+      })
+    })
+
+    describe('IfAccountNewerThan', () => {
+      it('should block accounts created after threshold', () => {
+        const result = computeAgeAssuranceRegionAccess(region, {
+          accountCreatedAt: new Date(2025, 11, 15).toISOString(),
+          declaredAge: 18,
+        })
+        expect(result).toEqual({
+          access: 'none',
+          reason: ageAssuranceRuleIDs.IfAccountNewerThan,
+        })
+      })
+
+      it('should allow accounts created before threshold', () => {
+        const result = computeAgeAssuranceRegionAccess(region, {
+          accountCreatedAt: new Date(2025, 10, 1).toISOString(),
+          declaredAge: 18,
+        })
+        expect(result).toEqual({
+          access: 'safe',
+          reason: ageAssuranceRuleIDs.IfDeclaredOverAge,
+        })
+      })
+
+      it('should allow accounts created exactly at threshold', () => {
+        const result = computeAgeAssuranceRegionAccess(region, {
+          accountCreatedAt: new Date(2025, 11, 1).toISOString(),
+          declaredAge: 18,
+        })
+        expect(result).toEqual({
+          access: 'safe',
+          reason: ageAssuranceRuleIDs.IfDeclaredOverAge,
+        })
+      })
+
+      it('should not apply rule when accountCreatedAt is not provided', () => {
+        const result = computeAgeAssuranceRegionAccess(region, {
+          declaredAge: 15,
+        })
+        expect(result).toEqual({
+          access: 'none',
+          reason: ageAssuranceRuleIDs.Default,
+        })
+      })
+
+      it('should not apply rule when assuredAge is present', () => {
+        const result = computeAgeAssuranceRegionAccess(region, {
+          accountCreatedAt: new Date(2025, 11, 15).toISOString(),
+          assuredAge: 20,
+        })
+        expect(result).toEqual({
+          access: 'full',
+          reason: ageAssuranceRuleIDs.IfAssuredOverAge,
+        })
+      })
+    })
+
+    describe('IfDeclaredOverAge rule', () => {
+      it('should allow users at or above age threshold', () => {
+        const result = computeAgeAssuranceRegionAccess(region, {
+          declaredAge: 18,
+        })
+
+        expect(result).toEqual({
+          access: 'safe',
+          reason: ageAssuranceRuleIDs.IfDeclaredOverAge,
+        })
+      })
+
+      it('should allow users above age threshold', () => {
+        const result = computeAgeAssuranceRegionAccess(region, {
+          declaredAge: 25,
+        })
+
+        expect(result).toEqual({
+          access: 'safe',
+          reason: ageAssuranceRuleIDs.IfDeclaredOverAge,
+        })
+      })
+
+      it('should not allow users below age threshold', () => {
+        const result = computeAgeAssuranceRegionAccess(region, {
+          declaredAge: 17,
+        })
+
+        expect(result).toEqual({
+          access: 'safe',
+          reason: ageAssuranceRuleIDs.IfDeclaredOverAge,
+        })
+      })
+    })
+
+    describe('IfAssuredOverAge rule', () => {
+      it('should allow users at or above assured age threshold', () => {
+        const result = computeAgeAssuranceRegionAccess(region, {
+          assuredAge: 18,
+        })
+
+        expect(result).toEqual({
+          access: 'full',
+          reason: ageAssuranceRuleIDs.IfAssuredOverAge,
+        })
+      })
+
+      it('should not allow users below assured age threshold', () => {
+        const result = computeAgeAssuranceRegionAccess(region, {
+          assuredAge: 17,
+        })
+
+        expect(result).toEqual({
+          access: 'safe',
+          reason: ageAssuranceRuleIDs.IfAssuredOverAge,
+        })
+      })
+    })
+  })
+})

package/src/age-assurance.ts

@@ -0,0 +1,137 @@
+import { AppBskyAgeassuranceDefs } from './client'
+import { ids } from './client/lexicons'
+
+export type AgeAssuranceRuleID = Exclude<
+  | AppBskyAgeassuranceDefs.ConfigRegionRuleDefault['$type']
+  | AppBskyAgeassuranceDefs.ConfigRegionRuleIfDeclaredOverAge['$type']
+  | AppBskyAgeassuranceDefs.ConfigRegionRuleIfDeclaredUnderAge['$type']
+  | AppBskyAgeassuranceDefs.ConfigRegionRuleIfAssuredOverAge['$type']
+  | AppBskyAgeassuranceDefs.ConfigRegionRuleIfAssuredUnderAge['$type']
+  | AppBskyAgeassuranceDefs.ConfigRegionRuleIfAccountNewerThan['$type']
+  | AppBskyAgeassuranceDefs.ConfigRegionRuleIfAccountOlderThan['$type'],
+  undefined
+>
+
+export const ageAssuranceRuleIDs: Record<string, AgeAssuranceRuleID> = {
+  Default: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleDefault`,
+  IfDeclaredOverAge: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleIfDeclaredOverAge`,
+  IfDeclaredUnderAge: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleIfDeclaredUnderAge`,
+  IfAssuredOverAge: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleIfAssuredOverAge`,
+  IfAssuredUnderAge: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleIfAssuredUnderAge`,
+  IfAccountNewerThan: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleIfAccountNewerThan`,
+  IfAccountOlderThan: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleIfAccountOlderThan`,
+}
+
+/**
+ * Returns the first matched region configuration based on the provided geolocation.
+ */
+export function getAgeAssuranceRegionConfig(
+  config: AppBskyAgeassuranceDefs.Config,
+  geolocation: {
+    countryCode: string
+    regionCode?: string
+  },
+): AppBskyAgeassuranceDefs.ConfigRegion | undefined {
+  const { regions } = config
+  return regions.find(({ countryCode, regionCode }) => {
+    if (countryCode === geolocation.countryCode) {
+      return !regionCode || regionCode === geolocation.regionCode
+    }
+  })
+}
+
+export function computeAgeAssuranceRegionAccess(
+  region: AppBskyAgeassuranceDefs.ConfigRegion,
+  data:
+    | {
+        /**
+         * The account creation date in ISO 8601 format. Only checked if we
+         * don't have an assured age, such as on the client.
+         */
+        accountCreatedAt?: string
+        /**
+         * The user's declared age
+         */
+        declaredAge?: number
+        /**
+         * The user's minimum age as assured by a trusted third party.
+         */
+        assuredAge?: number
+      }
+    | undefined,
+):
+  | {
+      access: AppBskyAgeassuranceDefs.Access
+      reason: AgeAssuranceRuleID
+    }
+  | undefined {
+  // first match wins
+  for (const rule of region.rules) {
+    if (AppBskyAgeassuranceDefs.isConfigRegionRuleIfAccountNewerThan(rule)) {
+      if (data?.accountCreatedAt && !data?.assuredAge) {
+        const accountCreatedAt = new Date(data.accountCreatedAt)
+        const threshold = new Date(rule.date)
+        if (accountCreatedAt >= threshold) {
+          return {
+            access: rule.access,
+            reason: rule.$type,
+          }
+        }
+      }
+    } else if (
+      AppBskyAgeassuranceDefs.isConfigRegionRuleIfAccountOlderThan(rule)
+    ) {
+      if (data?.accountCreatedAt && !data?.assuredAge) {
+        const accountCreatedAt = new Date(data.accountCreatedAt)
+        const threshold = new Date(rule.date)
+        if (accountCreatedAt < threshold) {
+          return {
+            access: rule.access,
+            reason: rule.$type,
+          }
+        }
+      }
+    } else if (
+      AppBskyAgeassuranceDefs.isConfigRegionRuleIfDeclaredOverAge(rule)
+    ) {
+      if (data?.declaredAge !== undefined && data.declaredAge >= rule.age) {
+        return {
+          access: rule.access,
+          reason: rule.$type,
+        }
+      }
+    } else if (
+      AppBskyAgeassuranceDefs.isConfigRegionRuleIfDeclaredUnderAge(rule)
+    ) {
+      if (data?.declaredAge !== undefined && data.declaredAge < rule.age) {
+        return {
+          access: rule.access,
+          reason: rule.$type,
+        }
+      }
+    } else if (
+      AppBskyAgeassuranceDefs.isConfigRegionRuleIfAssuredOverAge(rule)
+    ) {
+      if (data?.assuredAge && data.assuredAge >= rule.age) {
+        return {
+          access: rule.access,
+          reason: rule.$type,
+        }
+      }
+    } else if (
+      AppBskyAgeassuranceDefs.isConfigRegionRuleIfAssuredUnderAge(rule)
+    ) {
+      if (data?.assuredAge && data.assuredAge < rule.age) {
+        return {
+          access: rule.access,
+          reason: rule.$type,
+        }
+      }
+    } else if (AppBskyAgeassuranceDefs.isConfigRegionRuleDefault(rule)) {
+      return {
+        access: rule.access,
+        reason: rule.$type,
+      }
+    }
+  }
+}

package/src/client/index.ts

@@ -27,6 +27,14 @@ import * as AppBskyBookmarkCreateBookmark from './types/app/bsky/bookmark/create
 import * as AppBskyBookmarkDefs from './types/app/bsky/bookmark/defs.js'
 import * as AppBskyBookmarkDeleteBookmark from './types/app/bsky/bookmark/deleteBookmark.js'
 import * as AppBskyBookmarkGetBookmarks from './types/app/bsky/bookmark/getBookmarks.js'
+import * as AppBskyContactDefs from './types/app/bsky/contact/defs.js'
+import * as AppBskyContactDismissMatch from './types/app/bsky/contact/dismissMatch.js'
+import * as AppBskyContactGetMatches from './types/app/bsky/contact/getMatches.js'
+import * as AppBskyContactGetSyncStatus from './types/app/bsky/contact/getSyncStatus.js'
+import * as AppBskyContactImportContacts from './types/app/bsky/contact/importContacts.js'
+import * as AppBskyContactRemoveData from './types/app/bsky/contact/removeData.js'
+import * as AppBskyContactStartPhoneVerification from './types/app/bsky/contact/startPhoneVerification.js'
+import * as AppBskyContactVerifyPhone from './types/app/bsky/contact/verifyPhone.js'
 import * as AppBskyEmbedDefs from './types/app/bsky/embed/defs.js'
 import * as AppBskyEmbedExternal from './types/app/bsky/embed/external.js'
 import * as AppBskyEmbedImages from './types/app/bsky/embed/images.js'
@@ -325,6 +333,14 @@ export * as AppBskyBookmarkCreateBookmark from './types/app/bsky/bookmark/create
 export * as AppBskyBookmarkDefs from './types/app/bsky/bookmark/defs.js'
 export * as AppBskyBookmarkDeleteBookmark from './types/app/bsky/bookmark/deleteBookmark.js'
 export * as AppBskyBookmarkGetBookmarks from './types/app/bsky/bookmark/getBookmarks.js'
+export * as AppBskyContactDefs from './types/app/bsky/contact/defs.js'
+export * as AppBskyContactDismissMatch from './types/app/bsky/contact/dismissMatch.js'
+export * as AppBskyContactGetMatches from './types/app/bsky/contact/getMatches.js'
+export * as AppBskyContactGetSyncStatus from './types/app/bsky/contact/getSyncStatus.js'
+export * as AppBskyContactImportContacts from './types/app/bsky/contact/importContacts.js'
+export * as AppBskyContactRemoveData from './types/app/bsky/contact/removeData.js'
+export * as AppBskyContactStartPhoneVerification from './types/app/bsky/contact/startPhoneVerification.js'
+export * as AppBskyContactVerifyPhone from './types/app/bsky/contact/verifyPhone.js'
 export * as AppBskyEmbedDefs from './types/app/bsky/embed/defs.js'
 export * as AppBskyEmbedExternal from './types/app/bsky/embed/external.js'
 export * as AppBskyEmbedImages from './types/app/bsky/embed/images.js'
@@ -748,6 +764,7 @@ export class AppBskyNS {
   actor: AppBskyActorNS
   ageassurance: AppBskyAgeassuranceNS
   bookmark: AppBskyBookmarkNS
+  contact: AppBskyContactNS
   embed: AppBskyEmbedNS
   feed: AppBskyFeedNS
   graph: AppBskyGraphNS
@@ -762,6 +779,7 @@ export class AppBskyNS {
     this.actor = new AppBskyActorNS(client)
     this.ageassurance = new AppBskyAgeassuranceNS(client)
     this.bookmark = new AppBskyBookmarkNS(client)
+    this.contact = new AppBskyContactNS(client)
     this.embed = new AppBskyEmbedNS(client)
     this.feed = new AppBskyFeedNS(client)
     this.graph = new AppBskyGraphNS(client)
@@ -1122,6 +1140,91 @@ export class AppBskyBookmarkNS {
   }
 }
 
+export class AppBskyContactNS {
+  _client: XrpcClient
+
+  constructor(client: XrpcClient) {
+    this._client = client
+  }
+
+  dismissMatch(
+    data?: AppBskyContactDismissMatch.InputSchema,
+    opts?: AppBskyContactDismissMatch.CallOptions,
+  ): Promise<AppBskyContactDismissMatch.Response> {
+    return this._client
+      .call('app.bsky.contact.dismissMatch', opts?.qp, data, opts)
+      .catch((e) => {
+        throw AppBskyContactDismissMatch.toKnownErr(e)
+      })
+  }
+
+  getMatches(
+    params?: AppBskyContactGetMatches.QueryParams,
+    opts?: AppBskyContactGetMatches.CallOptions,
+  ): Promise<AppBskyContactGetMatches.Response> {
+    return this._client
+      .call('app.bsky.contact.getMatches', params, undefined, opts)
+      .catch((e) => {
+        throw AppBskyContactGetMatches.toKnownErr(e)
+      })
+  }
+
+  getSyncStatus(
+    params?: AppBskyContactGetSyncStatus.QueryParams,
+    opts?: AppBskyContactGetSyncStatus.CallOptions,
+  ): Promise<AppBskyContactGetSyncStatus.Response> {
+    return this._client
+      .call('app.bsky.contact.getSyncStatus', params, undefined, opts)
+      .catch((e) => {
+        throw AppBskyContactGetSyncStatus.toKnownErr(e)
+      })
+  }
+
+  importContacts(
+    data?: AppBskyContactImportContacts.InputSchema,
+    opts?: AppBskyContactImportContacts.CallOptions,
+  ): Promise<AppBskyContactImportContacts.Response> {
+    return this._client
+      .call('app.bsky.contact.importContacts', opts?.qp, data, opts)
+      .catch((e) => {
+        throw AppBskyContactImportContacts.toKnownErr(e)
+      })
+  }
+
+  removeData(
+    data?: AppBskyContactRemoveData.InputSchema,
+    opts?: AppBskyContactRemoveData.CallOptions,
+  ): Promise<AppBskyContactRemoveData.Response> {
+    return this._client
+      .call('app.bsky.contact.removeData', opts?.qp, data, opts)
+      .catch((e) => {
+        throw AppBskyContactRemoveData.toKnownErr(e)
+      })
+  }
+
+  startPhoneVerification(
+    data?: AppBskyContactStartPhoneVerification.InputSchema,
+    opts?: AppBskyContactStartPhoneVerification.CallOptions,
+  ): Promise<AppBskyContactStartPhoneVerification.Response> {
+    return this._client
+      .call('app.bsky.contact.startPhoneVerification', opts?.qp, data, opts)
+      .catch((e) => {
+        throw AppBskyContactStartPhoneVerification.toKnownErr(e)
+      })
+  }
+
+  verifyPhone(
+    data?: AppBskyContactVerifyPhone.InputSchema,
+    opts?: AppBskyContactVerifyPhone.CallOptions,
+  ): Promise<AppBskyContactVerifyPhone.Response> {
+    return this._client
+      .call('app.bsky.contact.verifyPhone', opts?.qp, data, opts)
+      .catch((e) => {
+        throw AppBskyContactVerifyPhone.toKnownErr(e)
+      })
+  }
+}
+
 export class AppBskyEmbedNS {
   _client: XrpcClient