@atproto/api 0.0.0-spaces-alpha-20260818021221

package/dist/age-assurance.js

@@ -0,0 +1,98 @@
+import { AppBskyAgeassuranceDefs } from './client/index.js';
+import { ids } from './client/lexicons.js';
+export const ageAssuranceRuleIDs = {
+    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
+ * filters. Region configurations that declare `platforms` only match when the
+ * provided platform is included in that list. If no platform filter is
+ * provided, platform restrictions are ignored.
+ */
+export function getAgeAssuranceRegionConfig(config, filters) {
+    const { regions } = config;
+    return regions.find(({ countryCode, regionCode, platforms }) => {
+        if (filters.platform &&
+            platforms?.length &&
+            !platforms.includes(filters.platform)) {
+            return false;
+        }
+        if (countryCode === filters.countryCode) {
+            return !regionCode || regionCode === filters.regionCode;
+        }
+    });
+}
+export function computeAgeAssuranceRegionAccess(region, data) {
+    // 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,
+            };
+        }
+    }
+}
+//# sourceMappingURL=age-assurance.js.map

package/dist/age-assurance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"age-assurance.js","sourceRoot":"","sources":["../src/age-assurance.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppBskyAgeassuranceDefs } from './client/index.js'\nimport { ids } from './client/lexicons.js'\n\nexport type AgeAssuranceRuleID = Exclude<\n  | AppBskyAgeassuranceDefs.ConfigRegionRuleDefault['$type']\n  | AppBskyAgeassuranceDefs.ConfigRegionRuleIfDeclaredOverAge['$type']\n  | AppBskyAgeassuranceDefs.ConfigRegionRuleIfDeclaredUnderAge['$type']\n  | AppBskyAgeassuranceDefs.ConfigRegionRuleIfAssuredOverAge['$type']\n  | AppBskyAgeassuranceDefs.ConfigRegionRuleIfAssuredUnderAge['$type']\n  | AppBskyAgeassuranceDefs.ConfigRegionRuleIfAccountNewerThan['$type']\n  | AppBskyAgeassuranceDefs.ConfigRegionRuleIfAccountOlderThan['$type'],\n  undefined\n>\n\nexport const ageAssuranceRuleIDs: Record<string, AgeAssuranceRuleID> = {\n  Default: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleDefault`,\n  IfDeclaredOverAge: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleIfDeclaredOverAge`,\n  IfDeclaredUnderAge: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleIfDeclaredUnderAge`,\n  IfAssuredOverAge: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleIfAssuredOverAge`,\n  IfAssuredUnderAge: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleIfAssuredUnderAge`,\n  IfAccountNewerThan: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleIfAccountNewerThan`,\n  IfAccountOlderThan: `${ids.AppBskyAgeassuranceDefs}#configRegionRuleIfAccountOlderThan`,\n}\n\n/**\n * Returns the first matched region configuration based on the provided\n * filters. Region configurations that declare `platforms` only match when the\n * provided platform is included in that list. If no platform filter is\n * provided, platform restrictions are ignored.\n */\nexport function getAgeAssuranceRegionConfig(\n  config: AppBskyAgeassuranceDefs.Config,\n  filters: {\n    countryCode: string\n    regionCode?: string\n    platform?: string\n  },\n): AppBskyAgeassuranceDefs.ConfigRegion | undefined {\n  const { regions } = config\n  return regions.find(({ countryCode, regionCode, platforms }) => {\n    if (\n      filters.platform &&\n      platforms?.length &&\n      !platforms.includes(filters.platform)\n    ) {\n      return false\n    }\n    if (countryCode === filters.countryCode) {\n      return !regionCode || regionCode === filters.regionCode\n    }\n  })\n}\n\nexport function computeAgeAssuranceRegionAccess(\n  region: AppBskyAgeassuranceDefs.ConfigRegion,\n  data:\n    | {\n        /**\n         * The account creation date in ISO 8601 format. Only checked if we\n         * don't have an assured age, such as on the client.\n         */\n        accountCreatedAt?: string\n        /**\n         * The user's declared age\n         */\n        declaredAge?: number\n        /**\n         * The user's minimum age as assured by a trusted third party.\n         */\n        assuredAge?: number\n      }\n    | undefined,\n):\n  | {\n      access: AppBskyAgeassuranceDefs.Access\n      reason: AgeAssuranceRuleID\n    }\n  | undefined {\n  // first match wins\n  for (const rule of region.rules) {\n    if (AppBskyAgeassuranceDefs.isConfigRegionRuleIfAccountNewerThan(rule)) {\n      if (data?.accountCreatedAt && !data?.assuredAge) {\n        const accountCreatedAt = new Date(data.accountCreatedAt)\n        const threshold = new Date(rule.date)\n        if (accountCreatedAt >= threshold) {\n          return {\n            access: rule.access,\n            reason: rule.$type,\n          }\n        }\n      }\n    } else if (\n      AppBskyAgeassuranceDefs.isConfigRegionRuleIfAccountOlderThan(rule)\n    ) {\n      if (data?.accountCreatedAt && !data?.assuredAge) {\n        const accountCreatedAt = new Date(data.accountCreatedAt)\n        const threshold = new Date(rule.date)\n        if (accountCreatedAt < threshold) {\n          return {\n            access: rule.access,\n            reason: rule.$type,\n          }\n        }\n      }\n    } else if (\n      AppBskyAgeassuranceDefs.isConfigRegionRuleIfDeclaredOverAge(rule)\n    ) {\n      if (data?.declaredAge !== undefined && data.declaredAge >= rule.age) {\n        return {\n          access: rule.access,\n          reason: rule.$type,\n        }\n      }\n    } else if (\n      AppBskyAgeassuranceDefs.isConfigRegionRuleIfDeclaredUnderAge(rule)\n    ) {\n      if (data?.declaredAge !== undefined && data.declaredAge < rule.age) {\n        return {\n          access: rule.access,\n          reason: rule.$type,\n        }\n      }\n    } else if (\n      AppBskyAgeassuranceDefs.isConfigRegionRuleIfAssuredOverAge(rule)\n    ) {\n      if (data?.assuredAge && data.assuredAge >= rule.age) {\n        return {\n          access: rule.access,\n          reason: rule.$type,\n        }\n      }\n    } else if (\n      AppBskyAgeassuranceDefs.isConfigRegionRuleIfAssuredUnderAge(rule)\n    ) {\n      if (data?.assuredAge && data.assuredAge < rule.age) {\n        return {\n          access: rule.access,\n          reason: rule.$type,\n        }\n      }\n    } else if (AppBskyAgeassuranceDefs.isConfigRegionRuleDefault(rule)) {\n      return {\n        access: rule.access,\n        reason: rule.$type,\n      }\n    }\n  }\n}\n"]}

package/dist/age-assurance.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=age-assurance.test.d.ts.map

package/dist/age-assurance.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"age-assurance.test.d.ts","sourceRoot":"","sources":["../src/age-assurance.test.ts"],"names":[],"mappings":""}

package/dist/age-assurance.test.js

@@ -0,0 +1,236 @@
+import { describe, expect, it } from '@jest/globals';
+import { ageAssuranceRuleIDs, computeAgeAssuranceRegionAccess, getAgeAssuranceRegionConfig, } from './age-assurance.js';
+describe('age-assurance', () => {
+    describe('getAgeAssuranceRegionConfig', () => {
+        const config = {
+            regions: [
+                {
+                    countryCode: 'US',
+                    regionCode: 'CA',
+                    minAccessAge: 13,
+                    rules: [],
+                },
+                {
+                    platforms: ['ios', 'android'],
+                    countryCode: 'US',
+                    regionCode: 'TX',
+                    minAccessAge: 18,
+                    rules: [],
+                },
+                {
+                    countryCode: 'US',
+                    minAccessAge: 13,
+                    rules: [],
+                },
+            ],
+        };
+        it('should find region by country code only', () => {
+            const result = getAgeAssuranceRegionConfig(config, {
+                countryCode: 'US',
+            });
+            expect(result).toEqual({
+                countryCode: 'US',
+                minAccessAge: 13,
+                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',
+                minAccessAge: 13,
+                rules: [],
+            });
+        });
+        it('should return undefined when no matching region found', () => {
+            const result = getAgeAssuranceRegionConfig(config, {
+                countryCode: 'GB',
+            });
+            expect(result).toBeUndefined();
+        });
+        it('should find platform-restricted region when platform matches', () => {
+            const result = getAgeAssuranceRegionConfig(config, {
+                countryCode: 'US',
+                regionCode: 'TX',
+                platform: 'ios',
+            });
+            expect(result).toEqual({
+                platforms: ['ios', 'android'],
+                countryCode: 'US',
+                regionCode: 'TX',
+                minAccessAge: 18,
+                rules: [],
+            });
+        });
+        it('should skip platform-restricted region when platform does not match', () => {
+            const result = getAgeAssuranceRegionConfig(config, {
+                countryCode: 'US',
+                regionCode: 'TX',
+                platform: 'web',
+            });
+            // falls through to the country-wide US config
+            expect(result).toEqual({
+                countryCode: 'US',
+                minAccessAge: 13,
+                rules: [],
+            });
+        });
+        it('should ignore platform restrictions when platform is not provided', () => {
+            const result = getAgeAssuranceRegionConfig(config, {
+                countryCode: 'US',
+                regionCode: 'TX',
+            });
+            expect(result).toEqual({
+                platforms: ['ios', 'android'],
+                countryCode: 'US',
+                regionCode: 'TX',
+                minAccessAge: 18,
+                rules: [],
+            });
+        });
+    });
+    describe('computeAgeAssuranceRegionAccess', () => {
+        const region = {
+            countryCode: 'US',
+            minAccessAge: 13,
+            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,
+                });
+            });
+        });
+    });
+});
+//# sourceMappingURL=age-assurance.test.js.map

package/dist/age-assurance.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"age-assurance.test.js","sourceRoot":"","sources":["../src/age-assurance.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from '@jest/globals'\nimport {\n  ageAssuranceRuleIDs,\n  computeAgeAssuranceRegionAccess,\n  getAgeAssuranceRegionConfig,\n} from './age-assurance.js'\nimport type { AppBskyAgeassuranceDefs } from './client/index.js'\n\ndescribe('age-assurance', () => {\n  describe('getAgeAssuranceRegionConfig', () => {\n    const config: AppBskyAgeassuranceDefs.Config = {\n      regions: [\n        {\n          countryCode: 'US',\n          regionCode: 'CA',\n          minAccessAge: 13,\n          rules: [],\n        },\n        {\n          platforms: ['ios', 'android'],\n          countryCode: 'US',\n          regionCode: 'TX',\n          minAccessAge: 18,\n          rules: [],\n        },\n        {\n          countryCode: 'US',\n          minAccessAge: 13,\n          rules: [],\n        },\n      ],\n    }\n\n    it('should find region by country code only', () => {\n      const result = getAgeAssuranceRegionConfig(config, {\n        countryCode: 'US',\n      })\n\n      expect(result).toEqual({\n        countryCode: 'US',\n        minAccessAge: 13,\n        rules: [],\n      })\n    })\n\n    it('should find region by country code and region code', () => {\n      const result = getAgeAssuranceRegionConfig(config, {\n        countryCode: 'US',\n        regionCode: 'CA',\n      })\n\n      expect(result).toEqual({\n        countryCode: 'US',\n        regionCode: 'CA',\n        minAccessAge: 13,\n        rules: [],\n      })\n    })\n\n    it('should return undefined when no matching region found', () => {\n      const result = getAgeAssuranceRegionConfig(config, {\n        countryCode: 'GB',\n      })\n\n      expect(result).toBeUndefined()\n    })\n\n    it('should find platform-restricted region when platform matches', () => {\n      const result = getAgeAssuranceRegionConfig(config, {\n        countryCode: 'US',\n        regionCode: 'TX',\n        platform: 'ios',\n      })\n\n      expect(result).toEqual({\n        platforms: ['ios', 'android'],\n        countryCode: 'US',\n        regionCode: 'TX',\n        minAccessAge: 18,\n        rules: [],\n      })\n    })\n\n    it('should skip platform-restricted region when platform does not match', () => {\n      const result = getAgeAssuranceRegionConfig(config, {\n        countryCode: 'US',\n        regionCode: 'TX',\n        platform: 'web',\n      })\n\n      // falls through to the country-wide US config\n      expect(result).toEqual({\n        countryCode: 'US',\n        minAccessAge: 13,\n        rules: [],\n      })\n    })\n\n    it('should ignore platform restrictions when platform is not provided', () => {\n      const result = getAgeAssuranceRegionConfig(config, {\n        countryCode: 'US',\n        regionCode: 'TX',\n      })\n\n      expect(result).toEqual({\n        platforms: ['ios', 'android'],\n        countryCode: 'US',\n        regionCode: 'TX',\n        minAccessAge: 18,\n        rules: [],\n      })\n    })\n  })\n\n  describe('computeAgeAssuranceRegionAccess', () => {\n    const region: AppBskyAgeassuranceDefs.ConfigRegion = {\n      countryCode: 'US',\n      minAccessAge: 13,\n      rules: [\n        {\n          $type: ageAssuranceRuleIDs.IfAccountNewerThan,\n          date: '2025-12-10T00:00:00Z',\n          access: 'none',\n        },\n        {\n          $type: ageAssuranceRuleIDs.IfAssuredOverAge,\n          age: 18,\n          access: 'full',\n        },\n        {\n          $type: ageAssuranceRuleIDs.IfAssuredOverAge,\n          age: 16,\n          access: 'safe',\n        },\n        {\n          $type: ageAssuranceRuleIDs.IfDeclaredOverAge,\n          age: 16,\n          access: 'safe',\n        },\n        {\n          $type: ageAssuranceRuleIDs.Default,\n          access: 'none',\n        },\n      ],\n    }\n\n    it('should apply default if no data provided', () => {\n      const result = computeAgeAssuranceRegionAccess(region, {})\n\n      expect(result).toEqual({\n        access: 'none',\n        reason: ageAssuranceRuleIDs.Default,\n      })\n    })\n\n    describe('IfAccountNewerThan', () => {\n      it('should block accounts created after threshold', () => {\n        const result = computeAgeAssuranceRegionAccess(region, {\n          accountCreatedAt: new Date(2025, 11, 15).toISOString(),\n          declaredAge: 18,\n        })\n        expect(result).toEqual({\n          access: 'none',\n          reason: ageAssuranceRuleIDs.IfAccountNewerThan,\n        })\n      })\n\n      it('should allow accounts created before threshold', () => {\n        const result = computeAgeAssuranceRegionAccess(region, {\n          accountCreatedAt: new Date(2025, 10, 1).toISOString(),\n          declaredAge: 18,\n        })\n        expect(result).toEqual({\n          access: 'safe',\n          reason: ageAssuranceRuleIDs.IfDeclaredOverAge,\n        })\n      })\n\n      it('should allow accounts created exactly at threshold', () => {\n        const result = computeAgeAssuranceRegionAccess(region, {\n          accountCreatedAt: new Date(2025, 11, 1).toISOString(),\n          declaredAge: 18,\n        })\n        expect(result).toEqual({\n          access: 'safe',\n          reason: ageAssuranceRuleIDs.IfDeclaredOverAge,\n        })\n      })\n\n      it('should not apply rule when accountCreatedAt is not provided', () => {\n        const result = computeAgeAssuranceRegionAccess(region, {\n          declaredAge: 15,\n        })\n        expect(result).toEqual({\n          access: 'none',\n          reason: ageAssuranceRuleIDs.Default,\n        })\n      })\n\n      it('should not apply rule when assuredAge is present', () => {\n        const result = computeAgeAssuranceRegionAccess(region, {\n          accountCreatedAt: new Date(2025, 11, 15).toISOString(),\n          assuredAge: 20,\n        })\n        expect(result).toEqual({\n          access: 'full',\n          reason: ageAssuranceRuleIDs.IfAssuredOverAge,\n        })\n      })\n    })\n\n    describe('IfDeclaredOverAge rule', () => {\n      it('should allow users at or above age threshold', () => {\n        const result = computeAgeAssuranceRegionAccess(region, {\n          declaredAge: 18,\n        })\n\n        expect(result).toEqual({\n          access: 'safe',\n          reason: ageAssuranceRuleIDs.IfDeclaredOverAge,\n        })\n      })\n\n      it('should allow users above age threshold', () => {\n        const result = computeAgeAssuranceRegionAccess(region, {\n          declaredAge: 25,\n        })\n\n        expect(result).toEqual({\n          access: 'safe',\n          reason: ageAssuranceRuleIDs.IfDeclaredOverAge,\n        })\n      })\n\n      it('should not allow users below age threshold', () => {\n        const result = computeAgeAssuranceRegionAccess(region, {\n          declaredAge: 17,\n        })\n\n        expect(result).toEqual({\n          access: 'safe',\n          reason: ageAssuranceRuleIDs.IfDeclaredOverAge,\n        })\n      })\n    })\n\n    describe('IfAssuredOverAge rule', () => {\n      it('should allow users at or above assured age threshold', () => {\n        const result = computeAgeAssuranceRegionAccess(region, {\n          assuredAge: 18,\n        })\n\n        expect(result).toEqual({\n          access: 'full',\n          reason: ageAssuranceRuleIDs.IfAssuredOverAge,\n        })\n      })\n\n      it('should not allow users below assured age threshold', () => {\n        const result = computeAgeAssuranceRegionAccess(region, {\n          assuredAge: 17,\n        })\n\n        expect(result).toEqual({\n          access: 'safe',\n          reason: ageAssuranceRuleIDs.IfAssuredOverAge,\n        })\n      })\n    })\n  })\n})\n"]}

package/dist/agent.d.ts

@@ -0,0 +1,270 @@
+import { type DidString } from '@atproto/syntax';
+import { type FetchHandler, type FetchHandlerOptions, XrpcClient } from '@atproto/xrpc';
+import { AppBskyActorDefs, AppBskyActorProfile, type AppBskyFeedPost, AppNS, ChatNS, ComNS, ToolsNS } from './client/index.js';
+import type { MutedWord, Nux } from './client/types/app/bsky/actor/defs.js';
+import type { Un$Typed } from './client/util.js';
+import type { InterpretedLabelValueDefinition, LabelPreference, ModerationPrefs } from './moderation/types.js';
+import type { SessionManager } from './session-manager.js';
+import { type AtpAgentGlobalOpts, type AtprotoProxy, type AtprotoServiceType, type BskyFeedViewPreference, type BskyInterestsPreference, type BskyPreferences, type BskyThreadViewPreference } from './types.js';
+export type { DidString, FetchHandler };
+/**
+ * An {@link Agent} is an {@link AtpBaseClient} with the following
+ * additional features:
+ * - AT Protocol labelers configuration utilities
+ * - AT Protocol proxy configuration utilities
+ * - Cloning utilities
+ * - `app.bsky` syntactic sugar
+ * - `com.atproto` syntactic sugar
+ */
+export declare class Agent extends XrpcClient {
+    #private;
+    /**
+     * The labelers to be used across all requests with the takedown capability
+     */
+    static appLabelers: readonly string[];
+    /**
+     * Configures the Agent (or its sub classes) globally.
+     */
+    static configure(opts: AtpAgentGlobalOpts): void;
+    com: ComNS;
+    app: AppNS;
+    chat: ChatNS;
+    tools: ToolsNS;
+    /** @deprecated use `this` instead */
+    get xrpc(): XrpcClient;
+    readonly sessionManager: SessionManager;
+    constructor(options: SessionManager | FetchHandler | FetchHandlerOptions);
+    clone(): Agent;
+    copyInto<T extends Agent>(inst: T): T;
+    withProxy(serviceType: AtprotoServiceType, did: string): ReturnType<this['clone']>;
+    /**
+     * The labelers statically configured on the class of the current instance.
+     */
+    get appLabelers(): readonly string[];
+    labelers: readonly string[];
+    configureLabelers(labelerDids: readonly string[]): void;
+    /** @deprecated use {@link configureLabelers} instead */
+    configureLabelersHeader(labelerDids: readonly string[]): void;
+    proxy?: AtprotoProxy;
+    configureProxy(value: AtprotoProxy | null): void;
+    /** @deprecated use {@link configureProxy} instead */
+    configureProxyHeader(serviceType: AtprotoServiceType, did: string): void;
+    /**
+     * Get the authenticated user's DID, if any.
+     */
+    get did(): DidString | undefined;
+    /** @deprecated Use {@link Agent.assertDid} instead */
+    get accountDid(): `did:${string}:${string}`;
+    /**
+     * Get the authenticated user's DID, or throw an error if not authenticated.
+     */
+    get assertDid(): DidString;
+    /**
+     * Assert that the user is authenticated.
+     */
+    assertAuthenticated(): asserts this is {
+        did: DidString;
+    };
+    /** @deprecated use "this" instead */
+    get api(): this;
+    /**
+     * Upload a binary blob to the server
+     */
+    uploadBlob: typeof this.com.atproto.repo.uploadBlob;
+    /**
+     * Resolve a handle to a DID
+     */
+    resolveHandle: typeof this.com.atproto.identity.resolveHandle;
+    /**
+     * Change the user's handle
+     */
+    updateHandle: typeof this.com.atproto.identity.updateHandle;
+    /**
+     * Create a moderation report
+     */
+    createModerationReport: typeof this.com.atproto.moderation.createReport;
+    getTimeline: typeof this.app.bsky.feed.getTimeline;
+    getAuthorFeed: typeof this.app.bsky.feed.getAuthorFeed;
+    getActorLikes: typeof this.app.bsky.feed.getActorLikes;
+    getPostThread: typeof this.app.bsky.feed.getPostThread;
+    getPost: typeof this.app.bsky.feed.post.get;
+    getPosts: typeof this.app.bsky.feed.getPosts;
+    getLikes: typeof this.app.bsky.feed.getLikes;
+    getRepostedBy: typeof this.app.bsky.feed.getRepostedBy;
+    getFollows: typeof this.app.bsky.graph.getFollows;
+    getFollowers: typeof this.app.bsky.graph.getFollowers;
+    getProfile: typeof this.app.bsky.actor.getProfile;
+    getProfiles: typeof this.app.bsky.actor.getProfiles;
+    getSuggestions: typeof this.app.bsky.actor.getSuggestions;
+    searchActors: typeof this.app.bsky.actor.searchActors;
+    searchActorsTypeahead: typeof this.app.bsky.actor.searchActorsTypeahead;
+    listNotifications: typeof this.app.bsky.notification.listNotifications;
+    countUnreadNotifications: typeof this.app.bsky.notification.getUnreadCount;
+    getLabelers: typeof this.app.bsky.labeler.getServices;
+    getLabelDefinitions(prefs: BskyPreferences | ModerationPrefs | string[]): Promise<Record<string, InterpretedLabelValueDefinition[]>>;
+    post(record: Partial<AppBskyFeedPost.Record> & Omit<AppBskyFeedPost.Record, 'createdAt'>): Promise<{
+        uri: string;
+        cid: string;
+    }>;
+    deletePost(postUri: string): Promise<void>;
+    like(uri: string, cid: string, via?: {
+        uri: string;
+        cid: string;
+    }): Promise<{
+        uri: string;
+        cid: string;
+    }>;
+    deleteLike(likeUri: string): Promise<void>;
+    repost(uri: string, cid: string, via?: {
+        uri: string;
+        cid: string;
+    }): Promise<{
+        uri: string;
+        cid: string;
+    }>;
+    deleteRepost(repostUri: string): Promise<void>;
+    follow(subjectDid: string, via?: {
+        uri: string;
+        cid: string;
+    }): Promise<{
+        uri: string;
+        cid: string;
+    }>;
+    deleteFollow(followUri: string): Promise<void>;
+    /**
+     * @note: Using this method will reset the whole profile record if it
+     * previously contained invalid values (wrt to the profile lexicon).
+     */
+    upsertProfile(updateFn: (existing: AppBskyActorProfile.Record | undefined) => Un$Typed<AppBskyActorProfile.Record> | Promise<Un$Typed<AppBskyActorProfile.Record>>): Promise<void>;
+    mute(actor: string, options?: {
+        onlyReposts?: boolean;
+        onlyQuoteposts?: boolean;
+    }): Promise<import("./client/types/app/bsky/graph/muteActor.js").Response>;
+    unmute(actor: string): Promise<import("./client/types/app/bsky/graph/unmuteActor.js").Response>;
+    muteModList(uri: string): Promise<import("./client/types/app/bsky/graph/muteActorList.js").Response>;
+    unmuteModList(uri: string): Promise<import("./client/types/app/bsky/graph/unmuteActorList.js").Response>;
+    blockModList(uri: string): Promise<{
+        uri: string;
+        cid: string;
+    }>;
+    unblockModList(uri: string): Promise<void>;
+    updateSeenNotifications(seenAt?: string): Promise<import("./client/types/app/bsky/notification/updateSeen.js").Response>;
+    getPreferences(): Promise<BskyPreferences>;
+    overwriteSavedFeeds(savedFeeds: AppBskyActorDefs.SavedFeed[]): Promise<AppBskyActorDefs.SavedFeed[]>;
+    updateSavedFeeds(savedFeedsToUpdate: AppBskyActorDefs.SavedFeed[]): Promise<AppBskyActorDefs.SavedFeed[]>;
+    addSavedFeeds(savedFeeds: Pick<AppBskyActorDefs.SavedFeed, 'type' | 'value' | 'pinned'>[]): Promise<AppBskyActorDefs.SavedFeed[]>;
+    removeSavedFeeds(ids: string[]): Promise<AppBskyActorDefs.SavedFeed[]>;
+    /**
+     * @deprecated use `overwriteSavedFeeds`
+     */
+    setSavedFeeds(saved: string[], pinned: string[]): Promise<{
+        saved: string[];
+        pinned: string[];
+    }>;
+    /**
+     * @deprecated use `addSavedFeeds`
+     */
+    addSavedFeed(v: string): Promise<{
+        saved: string[];
+        pinned: string[];
+    }>;
+    /**
+     * @deprecated use `removeSavedFeeds`
+     */
+    removeSavedFeed(v: string): Promise<{
+        saved: string[];
+        pinned: string[];
+    }>;
+    /**
+     * @deprecated use `addSavedFeeds` or `updateSavedFeeds`
+     */
+    addPinnedFeed(v: string): Promise<{
+        saved: string[];
+        pinned: string[];
+    }>;
+    /**
+     * @deprecated use `updateSavedFeeds` or `removeSavedFeeds`
+     */
+    removePinnedFeed(v: string): Promise<{
+        saved: string[];
+        pinned: string[];
+    }>;
+    setAdultContentEnabled(v: boolean): Promise<void>;
+    setContentLabelPref(key: string, value: LabelPreference, labelerDid?: string): Promise<void>;
+    addLabeler(did: string): Promise<void>;
+    removeLabeler(did: string): Promise<void>;
+    setPersonalDetails({ birthDate, }: {
+        birthDate: string | Date | undefined;
+    }): Promise<void>;
+    setFeedViewPrefs(feed: string, pref: Partial<BskyFeedViewPreference>): Promise<void>;
+    setThreadViewPrefs(pref: Partial<BskyThreadViewPreference>): Promise<void>;
+    setInterestsPref(pref: Partial<BskyInterestsPreference>): Promise<void>;
+    /**
+     * Add a muted word to user preferences.
+     */
+    addMutedWord(mutedWord: Pick<MutedWord, 'value' | 'targets' | 'actorTarget' | 'expiresAt'>): Promise<void>;
+    /**
+     * Convenience method to add muted words to user preferences
+     */
+    addMutedWords(newMutedWords: AppBskyActorDefs.MutedWord[]): Promise<void>;
+    /**
+     * @deprecated use `addMutedWords` or `addMutedWord` instead
+     */
+    upsertMutedWords(mutedWords: Pick<MutedWord, 'value' | 'targets' | 'actorTarget' | 'expiresAt'>[]): Promise<void>;
+    /**
+     * Update a muted word in user preferences.
+     */
+    updateMutedWord(mutedWord: AppBskyActorDefs.MutedWord): Promise<void>;
+    /**
+     * Remove a muted word from user preferences.
+     */
+    removeMutedWord(mutedWord: AppBskyActorDefs.MutedWord): Promise<void>;
+    /**
+     * Convenience method to remove muted words from user preferences
+     */
+    removeMutedWords(mutedWords: AppBskyActorDefs.MutedWord[]): Promise<void>;
+    hidePost(postUri: string): Promise<void>;
+    unhidePost(postUri: string): Promise<void>;
+    bskyAppQueueNudges(nudges: string | string[]): Promise<void>;
+    bskyAppDismissNudges(nudges: string | string[]): Promise<void>;
+    bskyAppSetActiveProgressGuide(guide: AppBskyActorDefs.BskyAppProgressGuide | undefined): Promise<void>;
+    /**
+     * Set the flag for participating in the beta features program
+     */
+    setIsBetaUser(isBetaUser: boolean): Promise<void>;
+    /**
+     * Insert or update a NUX in user prefs
+     */
+    bskyAppUpsertNux(nux: Nux): Promise<void>;
+    /**
+     * Removes NUXs from user preferences.
+     */
+    bskyAppRemoveNuxs(ids: string[]): Promise<void>;
+    setPostInteractionSettings(settings: AppBskyActorDefs.PostInteractionSettingsPref): Promise<void>;
+    setVerificationPrefs(settings: AppBskyActorDefs.VerificationPrefs): Promise<void>;
+    updateLiveEventPreferences(action: {
+        type: 'hideFeed';
+        id: string;
+    } | {
+        type: 'unhideFeed';
+        id: string;
+    } | {
+        type: 'toggleHideAllFeeds';
+    }): Promise<AppBskyActorDefs.Preferences>;
+    /**
+     * This function updates the preferences of a user and allows for a callback function to be executed
+     * before the update.
+     * @param cb - cb is a callback function that takes in a single parameter of type
+     * AppBskyActorDefs.Preferences and returns either a boolean or void. This callback function is used to
+     * update the preferences of the user. The function is called with the current preferences as an
+     * argument and if the callback returns false, the preferences are not updated.
+     */
+    private updatePreferences;
+    private updateHiddenPost;
+    /**
+     * A helper specifically for updating feed preferences
+     */
+    private updateFeedPreferences;
+    private updateSavedFeedsV2Preferences;
+}
+//# sourceMappingURL=agent.d.ts.map