@atproto/api 0.20.22 → 0.20.25

package/jest.setup.ts

@@ -1,97 +0,0 @@
-import { ModerationUI } from './src/index.js'
-import { ModerationTestSuiteResultFlag } from './tests/util/moderation-behavior.js'
-
-expect.extend({
-  toBeModerationResult(
-    actual: ModerationUI,
-    expected: ModerationTestSuiteResultFlag[] | undefined,
-    context = '',
-    stringifiedResult: string | undefined = undefined,
-    _ignoreCause = false,
-  ) {
-    const fail = (msg: string) => ({
-      pass: false,
-      message: () =>
-        `${msg}.${
-          stringifiedResult ? ` Full result: ${stringifiedResult}` : ''
-        }`,
-    })
-    // let cause = actual.causes?.type as string
-    // if (actual.cause?.type === 'label') {
-    //   cause = `label:${actual.cause.labelDef.id}`
-    // } else if (actual.cause?.type === 'muted') {
-    //   if (actual.cause.source.type === 'list') {
-    //     cause = 'muted-by-list'
-    //   }
-    // } else if (actual.cause?.type === 'blocking') {
-    //   if (actual.cause.source.type === 'list') {
-    //     cause = 'blocking-by-list'
-    //   }
-    // }
-    if (!expected) {
-      // if (!ignoreCause && actual.cause) {
-      //   return fail(`${context} expected to be a no-op, got ${cause}`)
-      // }
-      if (actual.inform) {
-        return fail(`${context} expected to be a no-op, got inform=true`)
-      }
-      if (actual.alert) {
-        return fail(`${context} expected to be a no-op, got alert=true`)
-      }
-      if (actual.blur) {
-        return fail(`${context} expected to be a no-op, got blur=true`)
-      }
-      if (actual.filter) {
-        return fail(`${context} expected to be a no-op, got filter=true`)
-      }
-      if (actual.noOverride) {
-        return fail(`${context} expected to be a no-op, got noOverride=true`)
-      }
-    } else {
-      // if (!ignoreCause && cause !== expected.cause) {
-      //   return fail(`${context} expected to be ${expected.cause}, got ${cause}`)
-      // }
-      const expectedInform = expected.includes('inform')
-      if (!!actual.inform !== expectedInform) {
-        return fail(
-          `${context} expected to be inform=${expectedInform}, got ${
-            actual.inform || false
-          }`,
-        )
-      }
-      const expectedAlert = expected.includes('alert')
-      if (!!actual.alert !== expectedAlert) {
-        return fail(
-          `${context} expected to be alert=${expectedAlert}, got ${
-            actual.alert || false
-          }`,
-        )
-      }
-      const expectedBlur = expected.includes('blur')
-      if (!!actual.blur !== expectedBlur) {
-        return fail(
-          `${context} expected to be blur=${expectedBlur}, got ${
-            actual.blur || false
-          }`,
-        )
-      }
-      const expectedFilter = expected.includes('filter')
-      if (!!actual.filter !== expectedFilter) {
-        return fail(
-          `${context} expected to be filter=${expectedFilter}, got ${
-            actual.filter || false
-          }`,
-        )
-      }
-      const expectedNoOverride = expected.includes('noOverride')
-      if (!!actual.noOverride !== expectedNoOverride) {
-        return fail(
-          `${context} expected to be noOverride=${expectedNoOverride}, got ${
-            actual.noOverride || false
-          }`,
-        )
-      }
-    }
-    return { pass: true, message: () => '' }
-  },
-})

package/scripts/code/labels.mjs

@@ -1,77 +0,0 @@
-import { mkdir, writeFile } from 'node:fs/promises'
-import { dirname, join } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import * as prettier from 'prettier'
-import labelsDef from '../../definitions/labels.json' with { type: 'json' }
-
-const __dirname = dirname(fileURLToPath(import.meta.url))
-
-export async function labels() {
-  const content = await gen()
-
-  const path = join(
-    __dirname,
-    '..',
-    '..',
-    'src',
-    'moderation',
-    'const',
-    'labels.ts',
-  )
-
-  await mkdir(dirname(path), { recursive: true })
-  await writeFile(path, content, 'utf8')
-}
-
-async function gen() {
-  const knownValues = new Set()
-  const flattenedLabelDefs = []
-
-  for (const { alias: aliases, ...label } of labelsDef) {
-    knownValues.add(label.identifier)
-    flattenedLabelDefs.push([label.identifier, { ...label, locales: [] }])
-
-    if (aliases) {
-      for (const alias of aliases) {
-        knownValues.add(alias)
-        flattenedLabelDefs.push([
-          alias,
-          {
-            ...label,
-            identifier: alias,
-            locales: [],
-            comment: `@deprecated alias for \`${label.identifier}\``,
-          },
-        ])
-      }
-    }
-  }
-
-  let labelDefsStr = `{`
-  for (const [key, { comment, ...value }] of flattenedLabelDefs) {
-    const commentStr = comment ? `\n/** ${comment} */\n` : ''
-    labelDefsStr += `${commentStr}'${key}': ${JSON.stringify(value, null, 2)},`
-  }
-  labelDefsStr += `}`
-
-  return prettier.format(
-    `/** this doc is generated by ./scripts/code/labels.mjs **/
-  import {InterpretedLabelValueDefinition, LabelPreference} from '../types.js'
-
-  export type KnownLabelValue = ${Array.from(knownValues)
-    .map((value) => `"${value}"`)
-    .join(' | ')}
-
-  export const DEFAULT_LABEL_SETTINGS: Record<string, LabelPreference> = ${JSON.stringify(
-    Object.fromEntries(
-      labelsDef
-        .filter((label) => label.configurable)
-        .map((label) => [label.identifier, label.defaultSetting]),
-    ),
-  )}
-
-  export const LABELS: Record<KnownLabelValue, InterpretedLabelValueDefinition> = ${labelDefsStr}
-  `,
-    { semi: false, parser: 'typescript', singleQuote: true },
-  )
-}

package/scripts/generate-code.mjs

@@ -1,4 +0,0 @@
-import { labels } from './code/labels.mjs'
-export { labels }
-
-labels()

package/src/age-assurance.test.ts

@@ -1,218 +0,0 @@
-import { describe, expect, it } from '@jest/globals'
-import {
-  ageAssuranceRuleIDs,
-  computeAgeAssuranceRegionAccess,
-  getAgeAssuranceRegionConfig,
-} from './age-assurance.js'
-import { AppBskyAgeassuranceDefs } from './client/index.js'
-
-describe('age-assurance', () => {
-  describe('getAgeAssuranceRegionConfig', () => {
-    const config: AppBskyAgeassuranceDefs.Config = {
-      regions: [
-        {
-          countryCode: 'US',
-          regionCode: 'CA',
-          minAccessAge: 13,
-          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()
-    })
-  })
-
-  describe('computeAgeAssuranceRegionAccess', () => {
-    const region: AppBskyAgeassuranceDefs.ConfigRegion = {
-      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,
-        })
-      })
-    })
-  })
-})

package/src/age-assurance.ts

@@ -1,137 +0,0 @@
-import { AppBskyAgeassuranceDefs } from './client/index.js'
-import { ids } from './client/lexicons.js'
-
-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,
-      }
-    }
-  }
-}