@atproto/api 0.20.22 → 0.20.25

package/src/moderation/subjects/profile.ts

@@ -1,26 +0,0 @@
-import { ModerationDecision } from '../decision.js'
-import { Label, ModerationOpts, ModerationSubjectProfile } from '../types.js'
-
-export function decideProfile(
-  subject: ModerationSubjectProfile,
-  opts: ModerationOpts,
-): ModerationDecision {
-  const acc = new ModerationDecision()
-
-  acc.setDid(subject.did)
-  acc.setIsMe(subject.did === opts.userDid)
-  for (const label of filterProfileLabels(subject.labels)) {
-    acc.addLabel('profile', label, opts)
-  }
-
-  return acc
-}
-
-export function filterProfileLabels(labels?: Label[]): Label[] {
-  if (!labels) {
-    return []
-  }
-  return labels.filter((label) =>
-    label.uri.endsWith('/app.bsky.actor.profile/self'),
-  )
-}

package/src/moderation/subjects/status.ts

@@ -1,27 +0,0 @@
-import { ModerationDecision } from '../decision.js'
-import { ModerationOpts, ModerationSubjectProfile } from '../types.js'
-import { decideAccount } from './account.js'
-import { decideProfile } from './profile.js'
-
-export function decideStatus(
-  subject: ModerationSubjectProfile,
-  opts: ModerationOpts,
-): ModerationDecision {
-  const acc = new ModerationDecision()
-
-  acc.setDid(subject.did)
-  acc.setIsMe(subject.did === opts.userDid)
-  if ('status' in subject) {
-    if (subject.status?.labels?.length) {
-      for (const label of subject.status.labels) {
-        acc.addLabel('content', label, opts)
-      }
-    }
-  }
-
-  return ModerationDecision.merge(
-    acc,
-    decideAccount(subject, opts),
-    decideProfile(subject, opts),
-  )
-}

package/src/moderation/subjects/user-list.ts

@@ -1,48 +0,0 @@
-import { AtUri } from '@atproto/syntax'
-import { AppBskyActorDefs } from '../../client/index.js'
-import { ModerationDecision } from '../decision.js'
-import { ModerationOpts, ModerationSubjectUserList } from '../types.js'
-import { decideAccount } from './account.js'
-import { decideProfile } from './profile.js'
-
-export function decideUserList(
-  subject: ModerationSubjectUserList,
-  opts: ModerationOpts,
-): ModerationDecision {
-  const acc = new ModerationDecision()
-
-  const creator =
-    // Note: ListViewBasic should not contain a creator field, but let's support it anyway
-    'creator' in subject && isProfile(subject.creator)
-      ? subject.creator
-      : undefined
-
-  if (creator) {
-    acc.setDid(creator.did)
-    acc.setIsMe(creator.did === opts.userDid)
-    if (subject.labels?.length) {
-      for (const label of subject.labels) {
-        acc.addLabel('content', label, opts)
-      }
-    }
-    return ModerationDecision.merge(
-      acc,
-      decideAccount(creator, opts),
-      decideProfile(creator, opts),
-    )
-  }
-
-  const creatorDid = new AtUri(subject.uri).hostname
-  acc.setDid(creatorDid)
-  acc.setIsMe(creatorDid === opts.userDid)
-  if (subject.labels?.length) {
-    for (const label of subject.labels) {
-      acc.addLabel('content', label, opts)
-    }
-  }
-  return acc
-}
-
-function isProfile(v: any): v is AppBskyActorDefs.ProfileViewBasic {
-  return v && typeof v === 'object' && 'did' in v
-}

package/src/moderation/types.ts

@@ -1,191 +0,0 @@
-import {
-  AppBskyActorDefs,
-  AppBskyFeedDefs,
-  AppBskyGraphDefs,
-  AppBskyNotificationListNotifications,
-  ChatBskyActorDefs,
-  ComAtprotoLabelDefs,
-} from '../client/index.js'
-import { KnownLabelValue } from './const/labels.js'
-import { MuteWordMatch } from './mutewords.js'
-
-// syntax
-// =
-
-export const CUSTOM_LABEL_VALUE_RE = /^[a-z-]+$/
-
-// behaviors
-// =
-
-export interface ModerationBehavior {
-  profileList?: 'blur' | 'alert' | 'inform'
-  profileView?: 'blur' | 'alert' | 'inform'
-  avatar?: 'blur' | 'alert'
-  banner?: 'blur'
-  displayName?: 'blur'
-  contentList?: 'blur' | 'alert' | 'inform'
-  contentView?: 'blur' | 'alert' | 'inform'
-  contentMedia?: 'blur'
-}
-export const BLOCK_BEHAVIOR: ModerationBehavior = {
-  profileList: 'blur',
-  profileView: 'alert',
-  avatar: 'blur',
-  banner: 'blur',
-  contentList: 'blur',
-  contentView: 'blur',
-}
-export const MUTE_BEHAVIOR: ModerationBehavior = {
-  profileList: 'inform',
-  profileView: 'alert',
-  contentList: 'blur',
-  contentView: 'inform',
-}
-export const MUTEWORD_BEHAVIOR: ModerationBehavior = {
-  contentList: 'blur',
-  contentView: 'blur',
-}
-export const HIDE_BEHAVIOR: ModerationBehavior = {
-  contentList: 'blur',
-  contentView: 'blur',
-}
-export const NOOP_BEHAVIOR: ModerationBehavior = {}
-
-// labels
-// =
-
-export type Label = ComAtprotoLabelDefs.Label
-export type LabelTarget = 'account' | 'profile' | 'content'
-export type LabelPreference = 'ignore' | 'warn' | 'hide'
-
-export type LabelValueDefinitionFlag =
-  | 'no-override'
-  | 'adult'
-  | 'unauthed'
-  | 'no-self'
-
-export interface InterpretedLabelValueDefinition
-  extends ComAtprotoLabelDefs.LabelValueDefinition {
-  definedBy?: string | undefined // did of labeler or undefined for global
-  configurable: boolean
-  defaultSetting: LabelPreference // type narrowing
-  flags: LabelValueDefinitionFlag[]
-  behaviors: {
-    account?: ModerationBehavior
-    profile?: ModerationBehavior
-    content?: ModerationBehavior
-  }
-}
-
-export type LabelDefinitionMap = Record<
-  KnownLabelValue,
-  InterpretedLabelValueDefinition
->
-
-// subjects
-// =
-
-export type ModerationSubjectProfile =
-  | AppBskyActorDefs.ProfileViewBasic
-  | AppBskyActorDefs.ProfileView
-  | AppBskyActorDefs.ProfileViewDetailed
-  | ChatBskyActorDefs.ProfileViewBasic
-
-export type ModerationSubjectPost = AppBskyFeedDefs.PostView
-
-export type ModerationSubjectNotification =
-  AppBskyNotificationListNotifications.Notification
-
-export type ModerationSubjectFeedGenerator = AppBskyFeedDefs.GeneratorView
-
-export type ModerationSubjectUserList =
-  | AppBskyGraphDefs.ListViewBasic
-  | AppBskyGraphDefs.ListView
-
-export type ModerationSubject =
-  | ModerationSubjectProfile
-  | ModerationSubjectPost
-  | ModerationSubjectNotification
-  | ModerationSubjectFeedGenerator
-  | ModerationSubjectUserList
-
-// behaviors
-// =
-
-export type ModerationCauseSource =
-  | { type: 'user' }
-  | { type: 'list'; list: AppBskyGraphDefs.ListViewBasic }
-  | { type: 'labeler'; did: string }
-
-export type ModerationCause =
-  | {
-      type: 'blocking'
-      source: ModerationCauseSource
-      priority: 3
-      downgraded?: boolean
-    }
-  | {
-      type: 'blocked-by'
-      source: ModerationCauseSource
-      priority: 4
-      downgraded?: boolean
-    }
-  | {
-      type: 'block-other'
-      source: ModerationCauseSource
-      priority: 4
-      downgraded?: boolean
-    }
-  | {
-      type: 'label'
-      source: ModerationCauseSource
-      label: Label
-      labelDef: InterpretedLabelValueDefinition
-      target: LabelTarget
-      setting: LabelPreference
-      behavior: ModerationBehavior
-      noOverride: boolean
-      priority: 1 | 2 | 5 | 7 | 8
-      downgraded?: boolean
-    }
-  | {
-      type: 'muted'
-      source: ModerationCauseSource
-      priority: 6
-      downgraded?: boolean
-    }
-  | {
-      type: 'mute-word'
-      source: ModerationCauseSource
-      priority: 6
-      downgraded?: boolean
-      matches: MuteWordMatch[]
-    }
-  | {
-      type: 'hidden'
-      source: ModerationCauseSource
-      priority: 6
-      downgraded?: boolean
-    }
-
-export interface ModerationPrefsLabeler {
-  did: string
-  labels: Record<string, LabelPreference>
-}
-
-export interface ModerationPrefs {
-  adultContentEnabled: boolean
-  labels: Record<string, LabelPreference>
-  labelers: ModerationPrefsLabeler[]
-  mutedWords: AppBskyActorDefs.MutedWord[]
-  hiddenPosts: string[]
-}
-
-export interface ModerationOpts {
-  userDid: string | undefined
-  prefs: ModerationPrefs
-  /**
-   * Map of labeler did -> custom definitions
-   */
-  labelDefs?: Record<string, InterpretedLabelValueDefinition[]>
-}

package/src/moderation/ui.ts

@@ -1,21 +0,0 @@
-import { ModerationCause } from './types.js'
-
-export class ModerationUI {
-  noOverride = false
-  filters: ModerationCause[] = []
-  blurs: ModerationCause[] = []
-  alerts: ModerationCause[] = []
-  informs: ModerationCause[] = []
-  get filter(): boolean {
-    return this.filters.length !== 0
-  }
-  get blur(): boolean {
-    return this.blurs.length !== 0
-  }
-  get alert(): boolean {
-    return this.alerts.length !== 0
-  }
-  get inform(): boolean {
-    return this.informs.length !== 0
-  }
-}

package/src/moderation/util.ts

@@ -1,111 +0,0 @@
-import {
-  AppBskyEmbedRecord,
-  AppBskyEmbedRecordWithMedia,
-  AppBskyLabelerDefs,
-  ComAtprotoLabelDefs,
-} from '../client/index.js'
-import { asPredicate } from '../client/util.js'
-import {
-  InterpretedLabelValueDefinition,
-  LabelPreference,
-  LabelValueDefinitionFlag,
-  ModerationBehavior,
-} from './types.js'
-
-export function isQuotedPost(embed: unknown): embed is AppBskyEmbedRecord.View {
-  return Boolean(embed && AppBskyEmbedRecord.isView(embed))
-}
-
-export function isQuotedPostWithMedia(
-  embed: unknown,
-): embed is AppBskyEmbedRecordWithMedia.View {
-  return Boolean(embed && AppBskyEmbedRecordWithMedia.isView(embed))
-}
-
-export function interpretLabelValueDefinition(
-  def: ComAtprotoLabelDefs.LabelValueDefinition,
-  definedBy: string | undefined,
-): InterpretedLabelValueDefinition {
-  const behaviors: {
-    account: ModerationBehavior
-    profile: ModerationBehavior
-    content: ModerationBehavior
-  } = {
-    account: {},
-    profile: {},
-    content: {},
-  }
-  const alertOrInform: 'alert' | 'inform' | undefined =
-    def.severity === 'alert'
-      ? 'alert'
-      : def.severity === 'inform'
-        ? 'inform'
-        : undefined
-  if (def.blurs === 'content') {
-    // target=account, blurs=content
-    behaviors.account.profileList = alertOrInform
-    behaviors.account.profileView = alertOrInform
-    behaviors.account.contentList = 'blur'
-    behaviors.account.contentView = def.adultOnly ? 'blur' : alertOrInform
-    // target=profile, blurs=content
-    behaviors.profile.profileList = alertOrInform
-    behaviors.profile.profileView = alertOrInform
-    // target=content, blurs=content
-    behaviors.content.contentList = 'blur'
-    behaviors.content.contentView = def.adultOnly ? 'blur' : alertOrInform
-  } else if (def.blurs === 'media') {
-    // target=account, blurs=media
-    behaviors.account.profileList = alertOrInform
-    behaviors.account.profileView = alertOrInform
-    behaviors.account.avatar = 'blur'
-    behaviors.account.banner = 'blur'
-    // target=profile, blurs=media
-    behaviors.profile.profileList = alertOrInform
-    behaviors.profile.profileView = alertOrInform
-    behaviors.profile.avatar = 'blur'
-    behaviors.profile.banner = 'blur'
-    // target=content, blurs=media
-    behaviors.content.contentMedia = 'blur'
-  } else if (def.blurs === 'none') {
-    // target=account, blurs=none
-    behaviors.account.profileList = alertOrInform
-    behaviors.account.profileView = alertOrInform
-    behaviors.account.contentList = alertOrInform
-    behaviors.account.contentView = alertOrInform
-    // target=profile, blurs=none
-    behaviors.profile.profileList = alertOrInform
-    behaviors.profile.profileView = alertOrInform
-    // target=content, blurs=none
-    behaviors.content.contentList = alertOrInform
-    behaviors.content.contentView = alertOrInform
-  }
-
-  let defaultSetting: LabelPreference = 'warn'
-  if (def.defaultSetting === 'hide' || def.defaultSetting === 'ignore') {
-    defaultSetting = def.defaultSetting as LabelPreference
-  }
-
-  const flags: LabelValueDefinitionFlag[] = ['no-self']
-  if (def.adultOnly) {
-    flags.push('adult')
-  }
-
-  return {
-    ...def,
-    definedBy,
-    configurable: true,
-    defaultSetting,
-    flags,
-    behaviors,
-  }
-}
-
-export function interpretLabelValueDefinitions(
-  labelerView: AppBskyLabelerDefs.LabelerViewDetailed,
-): InterpretedLabelValueDefinition[] {
-  return (labelerView.policies?.labelValueDefinitions || [])
-    .filter(asPredicate(ComAtprotoLabelDefs.validateLabelValueDefinition))
-    .map((labelValDef) =>
-      interpretLabelValueDefinition(labelValDef, labelerView.creator.did),
-    )
-}

package/src/predicate.ts

@@ -1,52 +0,0 @@
-import { AppBskyActorDefs, AppBskyActorProfile } from './client/index.js'
-import { asPredicate } from './client/util.js'
-
-export const isValidProfile = asPredicate(AppBskyActorProfile.validateRecord)
-export const isValidAdultContentPref = asPredicate(
-  AppBskyActorDefs.validateAdultContentPref,
-)
-export const isValidBskyAppStatePref = asPredicate(
-  AppBskyActorDefs.validateBskyAppStatePref,
-)
-export const isValidContentLabelPref = asPredicate(
-  AppBskyActorDefs.validateContentLabelPref,
-)
-export const isValidFeedViewPref = asPredicate(
-  AppBskyActorDefs.validateFeedViewPref,
-)
-export const isValidHiddenPostsPref = asPredicate(
-  AppBskyActorDefs.validateHiddenPostsPref,
-)
-export const isValidInterestsPref = asPredicate(
-  AppBskyActorDefs.validateInterestsPref,
-)
-export const isValidLabelersPref = asPredicate(
-  AppBskyActorDefs.validateLabelersPref,
-)
-export const isValidMutedWordsPref = asPredicate(
-  AppBskyActorDefs.validateMutedWordsPref,
-)
-export const isValidPersonalDetailsPref = asPredicate(
-  AppBskyActorDefs.validatePersonalDetailsPref,
-)
-export const isValidDeclaredAgePref = asPredicate(
-  AppBskyActorDefs.validateDeclaredAgePref,
-)
-export const isValidPostInteractionSettingsPref = asPredicate(
-  AppBskyActorDefs.validatePostInteractionSettingsPref,
-)
-export const isValidSavedFeedsPref = asPredicate(
-  AppBskyActorDefs.validateSavedFeedsPref,
-)
-export const isValidSavedFeedsPrefV2 = asPredicate(
-  AppBskyActorDefs.validateSavedFeedsPrefV2,
-)
-export const isValidThreadViewPref = asPredicate(
-  AppBskyActorDefs.validateThreadViewPref,
-)
-export const isValidVerificationPrefs = asPredicate(
-  AppBskyActorDefs.validateVerificationPrefs,
-)
-export const isValidLiveEventPreferences = asPredicate(
-  AppBskyActorDefs.validateLiveEventPreferences,
-)

package/src/rich-text/detection.ts

@@ -1,146 +0,0 @@
-import TLDs from 'tlds' with { type: 'json' }
-import { AppBskyRichtextFacet } from '../client/index.js'
-import { UnicodeString } from './unicode.js'
-import {
-  CASHTAG_REGEX,
-  MENTION_REGEX,
-  TAG_REGEX,
-  TRAILING_PUNCTUATION_REGEX,
-  URL_REGEX,
-} from './util.js'
-
-export type Facet = AppBskyRichtextFacet.Main
-
-export function detectFacets(text: UnicodeString): Facet[] | undefined {
-  let match
-  const facets: Facet[] = []
-  {
-    // mentions
-    const re = MENTION_REGEX
-    while ((match = re.exec(text.utf16))) {
-      if (!isValidDomain(match[3]) && !match[3].endsWith('.test')) {
-        continue // probably not a handle
-      }
-
-      const start = text.utf16.indexOf(match[3], match.index) - 1
-      facets.push({
-        $type: 'app.bsky.richtext.facet',
-        index: {
-          byteStart: text.utf16IndexToUtf8Index(start),
-          byteEnd: text.utf16IndexToUtf8Index(start + match[3].length + 1),
-        },
-        features: [
-          {
-            $type: 'app.bsky.richtext.facet#mention',
-            did: match[3], // must be resolved afterwards
-          },
-        ],
-      })
-    }
-  }
-  {
-    // links
-    const re = URL_REGEX
-    while ((match = re.exec(text.utf16))) {
-      let uri = match[2]
-      if (!uri.startsWith('http')) {
-        const domain = match.groups?.domain
-        if (!domain || !isValidDomain(domain)) {
-          continue
-        }
-        uri = `https://${uri}`
-      }
-      const start = text.utf16.indexOf(match[2], match.index)
-      const index = { start, end: start + match[2].length }
-      // strip ending puncuation
-      if (/[.,;:!?]$/.test(uri)) {
-        uri = uri.slice(0, -1)
-        index.end--
-      }
-      if (/[)]$/.test(uri) && !uri.includes('(')) {
-        uri = uri.slice(0, -1)
-        index.end--
-      }
-      facets.push({
-        index: {
-          byteStart: text.utf16IndexToUtf8Index(index.start),
-          byteEnd: text.utf16IndexToUtf8Index(index.end),
-        },
-        features: [
-          {
-            $type: 'app.bsky.richtext.facet#link',
-            uri,
-          },
-        ],
-      })
-    }
-  }
-  {
-    const re = TAG_REGEX
-    while ((match = re.exec(text.utf16))) {
-      const leading = match[1]
-      let tag = match[2]
-
-      if (!tag) continue
-
-      // strip ending punctuation and any spaces
-      tag = tag.trim().replace(TRAILING_PUNCTUATION_REGEX, '')
-
-      if (tag.length === 0 || tag.length > 64) continue
-
-      const index = match.index + leading.length
-
-      facets.push({
-        index: {
-          byteStart: text.utf16IndexToUtf8Index(index),
-          byteEnd: text.utf16IndexToUtf8Index(index + 1 + tag.length),
-        },
-        features: [
-          {
-            $type: 'app.bsky.richtext.facet#tag',
-            tag: tag,
-          },
-        ],
-      })
-    }
-  }
-  {
-    // cashtags
-    const re = CASHTAG_REGEX
-    while ((match = re.exec(text.utf16))) {
-      const leading = match[1]
-      let ticker = match[2]
-
-      if (!ticker) continue
-
-      // Normalize to uppercase
-      ticker = ticker.toUpperCase()
-
-      const index = match.index + leading.length
-
-      facets.push({
-        index: {
-          byteStart: text.utf16IndexToUtf8Index(index),
-          byteEnd: text.utf16IndexToUtf8Index(index + 1 + ticker.length), // +1 for $
-        },
-        features: [
-          {
-            $type: 'app.bsky.richtext.facet#tag',
-            tag: '$' + ticker, // Store with $ prefix
-          },
-        ],
-      })
-    }
-  }
-  return facets.length > 0 ? facets : undefined
-}
-
-function isValidDomain(str: string): boolean {
-  return !!TLDs.find((tld) => {
-    const i = str.lastIndexOf(tld)
-    if (i === -1) {
-      return false
-    }
-    return str.charAt(i - 1) === '.' && i === str.length - tld.length
-  })
-}