@atproto/api 0.20.23 → 0.20.26

package/src/moderation/mutewords.ts

@@ -1,170 +0,0 @@
-import { AppBskyActorDefs, AppBskyRichtextFacet } from '../client/index.js'
-
-const REGEX = {
-  LEADING_TRAILING_PUNCTUATION: /(?:^\p{P}+|\p{P}+$)/gu,
-  ESCAPE: /[[\]{}()*+?.\\^$|\s]/g,
-  SEPARATORS: /[/\-–—()[\]_]+/g,
-  WORD_BOUNDARY: /[\s\n\t\r\f\v]+?/g,
-}
-
-/**
- * List of 2-letter lang codes for languages that either don't use spaces, or
- * don't use spaces in a way conducive to word-based filtering.
- *
- * For these, we use a simple `String.includes` to check for a match.
- */
-const LANGUAGE_EXCEPTIONS = [
-  'ja', // Japanese
-  'zh', // Chinese
-  'ko', // Korean
-  'th', // Thai
-  'vi', // Vietnamese
-]
-
-export type MuteWordMatch = {
-  /**
-   * The `AppBskyActorDefs.MutedWord` that matched.
-   */
-  word: AppBskyActorDefs.MutedWord
-  /**
-   * The string that matched the muted word.
-   */
-  predicate: string
-}
-
-export type Params = {
-  mutedWords: AppBskyActorDefs.MutedWord[]
-  text: string
-  facets?: AppBskyRichtextFacet.Main[]
-  outlineTags?: string[]
-  languages?: string[]
-  actor?: AppBskyActorDefs.ProfileView | AppBskyActorDefs.ProfileViewBasic
-}
-
-/**
- * Checks if the given text matches any of the muted words, returning an array
- * of matches. If no matches are found, returns `undefined`.
- */
-export function matchMuteWords({
-  mutedWords,
-  text,
-  facets,
-  outlineTags,
-  languages,
-  actor,
-}: Params): MuteWordMatch[] | undefined {
-  const exception = LANGUAGE_EXCEPTIONS.includes(languages?.[0] || '')
-  const tags = ([] as string[])
-    .concat(outlineTags || [])
-    .concat(
-      (facets || []).flatMap((facet) =>
-        facet.features.filter(AppBskyRichtextFacet.isTag).map((tag) => tag.tag),
-      ),
-    )
-    .map((t) => t.toLowerCase())
-
-  const matches: MuteWordMatch[] = []
-
-  outer: for (const muteWord of mutedWords) {
-    const mutedWord = muteWord.value.toLowerCase()
-    const postText = text.toLowerCase()
-
-    // expired, ignore
-    if (muteWord.expiresAt && muteWord.expiresAt < new Date().toISOString())
-      continue
-
-    if (
-      muteWord.actorTarget === 'exclude-following' &&
-      Boolean(actor?.viewer?.following)
-    )
-      continue
-
-    // `content` applies to tags as well
-    if (tags.includes(mutedWord)) {
-      matches.push({ word: muteWord, predicate: muteWord.value })
-      continue
-    }
-    // rest of the checks are for `content` only
-    if (!muteWord.targets.includes('content')) continue
-    // single character or other exception, has to use includes
-    if ((mutedWord.length === 1 || exception) && postText.includes(mutedWord)) {
-      matches.push({ word: muteWord, predicate: muteWord.value })
-      continue
-    }
-    // too long
-    if (mutedWord.length > postText.length) continue
-    // exact match
-    if (mutedWord === postText) {
-      matches.push({ word: muteWord, predicate: muteWord.value })
-      continue
-    }
-    // any muted phrase with space or punctuation
-    if (/(?:\s|\p{P})+?/u.test(mutedWord) && postText.includes(mutedWord)) {
-      matches.push({ word: muteWord, predicate: muteWord.value })
-      continue
-    }
-
-    // check individual character groups
-    const words = postText.split(REGEX.WORD_BOUNDARY)
-    for (const word of words) {
-      if (word === mutedWord) {
-        matches.push({ word: muteWord, predicate: word })
-        continue outer
-      }
-
-      // compare word without leading/trailing punctuation, but allow internal
-      // punctuation (such as `s@ssy`)
-      const wordTrimmedPunctuation = word.replace(
-        REGEX.LEADING_TRAILING_PUNCTUATION,
-        '',
-      )
-
-      if (mutedWord === wordTrimmedPunctuation) {
-        matches.push({ word: muteWord, predicate: word })
-        continue outer
-      }
-
-      if (mutedWord.length > wordTrimmedPunctuation.length) continue
-
-      if (/\p{P}+/u.test(wordTrimmedPunctuation)) {
-        /**
-         * Exit case for any punctuation within the predicate that we _do_
-         * allow e.g. `and/or` should not match `Andor`.
-         */
-        if (/[/]+/.test(wordTrimmedPunctuation)) {
-          continue outer
-        }
-
-        const spacedWord = wordTrimmedPunctuation.replace(/\p{P}+/gu, ' ')
-        if (spacedWord === mutedWord) {
-          matches.push({ word: muteWord, predicate: word })
-          continue outer
-        }
-
-        const contiguousWord = spacedWord.replace(/\s/gu, '')
-        if (contiguousWord === mutedWord) {
-          matches.push({ word: muteWord, predicate: word })
-          continue outer
-        }
-
-        const wordParts = wordTrimmedPunctuation.split(/\p{P}+/u)
-        for (const wordPart of wordParts) {
-          if (wordPart === mutedWord) {
-            matches.push({ word: muteWord, predicate: word })
-            continue outer
-          }
-        }
-      }
-    }
-  }
-
-  return matches.length ? matches : undefined
-}
-
-/**
- * Checks if the given text matches any of the muted words, returning a boolean
- * if any matches are found.
- */
-export function hasMutedWord(params: Params) {
-  return !!matchMuteWords(params)
-}

package/src/moderation/subjects/account.ts

@@ -1,44 +0,0 @@
-import { ModerationDecision } from '../decision.js'
-import { Label, ModerationOpts, ModerationSubjectProfile } from '../types.js'
-
-export function decideAccount(
-  subject: ModerationSubjectProfile,
-  opts: ModerationOpts,
-): ModerationDecision {
-  const acc = new ModerationDecision()
-
-  acc.setDid(subject.did)
-  acc.setIsMe(subject.did === opts.userDid)
-  if (subject.viewer?.muted) {
-    if (subject.viewer?.mutedByList) {
-      acc.addMutedByList(subject.viewer?.mutedByList)
-    } else {
-      acc.addMuted(subject.viewer?.muted)
-    }
-  }
-  if (subject.viewer?.blocking) {
-    if (subject.viewer?.blockingByList) {
-      acc.addBlockingByList(subject.viewer?.blockingByList)
-    } else {
-      acc.addBlocking(subject.viewer?.blocking)
-    }
-  }
-  acc.addBlockedBy(subject.viewer?.blockedBy)
-
-  for (const label of filterAccountLabels(subject.labels)) {
-    acc.addLabel('account', label, opts)
-  }
-
-  return acc
-}
-
-export function filterAccountLabels(labels?: Label[]): Label[] {
-  if (!labels) {
-    return []
-  }
-  return labels.filter(
-    (label) =>
-      !label.uri.endsWith('/app.bsky.actor.profile/self') ||
-      label.val === '!no-unauthenticated',
-  )
-}

package/src/moderation/subjects/feed-generator.ts

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

package/src/moderation/subjects/notification.ts

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

package/src/moderation/subjects/post.ts

@@ -1,433 +0,0 @@
-import {
-  AppBskyActorDefs,
-  AppBskyEmbedExternal,
-  AppBskyEmbedGallery,
-  AppBskyEmbedImages,
-  AppBskyEmbedRecord,
-  AppBskyEmbedRecordWithMedia,
-  AppBskyFeedPost,
-} from '../../client/index.js'
-import { $Typed } from '../../client/util.js'
-import { ModerationDecision } from '../decision.js'
-import { MuteWordMatch, matchMuteWords } from '../mutewords.js'
-import { ModerationOpts, ModerationSubjectPost } from '../types.js'
-import { decideAccount } from './account.js'
-import { decideProfile } from './profile.js'
-
-export function decidePost(
-  subject: ModerationSubjectPost,
-  opts: ModerationOpts,
-): ModerationDecision {
-  return ModerationDecision.merge(
-    decideSubject(subject, opts),
-    decideEmbed(subject.embed, opts)?.downgrade(),
-    decideAccount(subject.author, opts),
-    decideProfile(subject.author, opts),
-  )
-}
-
-function decideSubject(
-  subject: ModerationSubjectPost,
-  opts: ModerationOpts,
-): ModerationDecision {
-  const acc = new ModerationDecision()
-
-  acc.setDid(subject.author.did)
-  acc.setIsMe(subject.author.did === opts.userDid)
-  if (subject.labels?.length) {
-    for (const label of subject.labels) {
-      acc.addLabel('content', label, opts)
-    }
-  }
-  acc.addHidden(checkHiddenPost(subject, opts.prefs.hiddenPosts))
-  if (!acc.isMe) {
-    acc.addMutedWord(matchAllMuteWords(subject, opts.prefs.mutedWords))
-  }
-
-  return acc
-}
-
-function decideEmbed(
-  embed:
-    | undefined
-    | $Typed<AppBskyEmbedRecord.View>
-    | $Typed<AppBskyEmbedRecordWithMedia.View>
-    | { $type: string },
-  opts: ModerationOpts,
-) {
-  if (embed) {
-    if (
-      (AppBskyEmbedRecord.isView(embed) ||
-        AppBskyEmbedRecordWithMedia.isView(embed)) &&
-      AppBskyEmbedRecord.isViewRecord(embed.record)
-    ) {
-      // quote post
-      return decideQuotedPost(embed.record, opts)
-    } else if (
-      AppBskyEmbedRecordWithMedia.isView(embed) &&
-      AppBskyEmbedRecord.isViewRecord(embed.record.record)
-    ) {
-      // quoted post with media
-      return decideQuotedPost(embed.record.record, opts)
-    } else if (
-      (AppBskyEmbedRecord.isView(embed) ||
-        AppBskyEmbedRecordWithMedia.isView(embed)) &&
-      AppBskyEmbedRecord.isViewBlocked(embed.record)
-    ) {
-      // blocked quote post
-      return decideBlockedQuotedPost(embed.record, opts)
-    } else if (
-      AppBskyEmbedRecordWithMedia.isView(embed) &&
-      AppBskyEmbedRecord.isViewBlocked(embed.record.record)
-    ) {
-      // blocked quoted post with media
-      return decideBlockedQuotedPost(embed.record.record, opts)
-    }
-  }
-
-  return undefined
-}
-
-function decideQuotedPost(
-  subject: AppBskyEmbedRecord.ViewRecord,
-  opts: ModerationOpts,
-) {
-  const acc = new ModerationDecision()
-  acc.setDid(subject.author.did)
-  acc.setIsMe(subject.author.did === opts.userDid)
-  if (subject.labels?.length) {
-    for (const label of subject.labels) {
-      acc.addLabel('content', label, opts)
-    }
-  }
-  return ModerationDecision.merge(
-    acc,
-    decideAccount(subject.author, opts),
-    decideProfile(subject.author, opts),
-  )
-}
-
-function decideBlockedQuotedPost(
-  subject: AppBskyEmbedRecord.ViewBlocked,
-  opts: ModerationOpts,
-) {
-  const acc = new ModerationDecision()
-  acc.setDid(subject.author.did)
-  acc.setIsMe(subject.author.did === opts.userDid)
-  if (subject.author.viewer?.muted) {
-    if (subject.author.viewer?.mutedByList) {
-      acc.addMutedByList(subject.author.viewer?.mutedByList)
-    } else {
-      acc.addMuted(subject.author.viewer?.muted)
-    }
-  }
-  if (subject.author.viewer?.blocking) {
-    if (subject.author.viewer?.blockingByList) {
-      acc.addBlockingByList(subject.author.viewer?.blockingByList)
-    } else {
-      acc.addBlocking(subject.author.viewer?.blocking)
-    }
-  }
-  acc.addBlockedBy(subject.author.viewer?.blockedBy)
-  return acc
-}
-
-function checkHiddenPost(
-  subject: ModerationSubjectPost,
-  hiddenPosts: string[] | undefined,
-) {
-  if (!hiddenPosts?.length) {
-    return false
-  }
-  if (hiddenPosts.includes(subject.uri)) {
-    return true
-  }
-  if (subject.embed) {
-    if (
-      AppBskyEmbedRecord.isView(subject.embed) &&
-      AppBskyEmbedRecord.isViewRecord(subject.embed.record) &&
-      hiddenPosts.includes(subject.embed.record.uri)
-    ) {
-      return true
-    }
-    if (
-      AppBskyEmbedRecordWithMedia.isView(subject.embed) &&
-      AppBskyEmbedRecord.isViewRecord(subject.embed.record.record) &&
-      hiddenPosts.includes(subject.embed.record.record.uri)
-    ) {
-      return true
-    }
-  }
-  return false
-}
-
-function matchAllMuteWords(
-  subject: ModerationSubjectPost,
-  mutedWords: AppBskyActorDefs.MutedWord[] | undefined,
-): MuteWordMatch[] | undefined {
-  if (!mutedWords?.length) {
-    return
-  }
-
-  const postAuthor = subject.author
-
-  if (AppBskyFeedPost.isRecord(subject.record)) {
-    const post = subject.record as AppBskyFeedPost.Record
-
-    const matches = matchMuteWords({
-      mutedWords,
-      text: post.text,
-      facets: post.facets,
-      outlineTags: post.tags,
-      languages: post.langs,
-      actor: postAuthor,
-    })
-    // post text
-    if (matches) {
-      return matches
-    }
-
-    if (post.embed && AppBskyEmbedImages.isMain(post.embed)) {
-      // post images
-      for (const image of post.embed.images) {
-        const matches = matchMuteWords({
-          mutedWords,
-          text: image.alt,
-          languages: post.langs,
-          actor: postAuthor,
-        })
-        if (matches) {
-          return matches
-        }
-      }
-    }
-
-    if (post.embed && AppBskyEmbedGallery.isMain(post.embed)) {
-      // post gallery items
-      for (const item of post.embed.items) {
-        if (AppBskyEmbedGallery.isImage(item)) {
-          const matches = matchMuteWords({
-            mutedWords,
-            text: item.alt,
-            languages: post.langs,
-            actor: postAuthor,
-          })
-          if (matches) {
-            return matches
-          }
-        }
-      }
-    }
-  }
-
-  const { embed } = subject
-  if (embed) {
-    // quote post
-    if (
-      (AppBskyEmbedRecord.isView(embed) ||
-        AppBskyEmbedRecordWithMedia.isView(embed)) &&
-      AppBskyEmbedRecord.isViewRecord(embed.record)
-    ) {
-      if (AppBskyFeedPost.isRecord(embed.record.value)) {
-        const embeddedPost = embed.record.value as AppBskyFeedPost.Record
-        const embedAuthor = embed.record.author
-        const matches = matchMuteWords({
-          mutedWords,
-          text: embeddedPost.text,
-          facets: embeddedPost.facets,
-          outlineTags: embeddedPost.tags,
-          languages: embeddedPost.langs,
-          actor: embedAuthor,
-        })
-
-        // quoted post text
-        if (matches) {
-          return matches
-        }
-
-        // quoted post's images
-        if (AppBskyEmbedImages.isMain(embeddedPost.embed)) {
-          for (const image of embeddedPost.embed.images) {
-            const matches = matchMuteWords({
-              mutedWords,
-              text: image.alt,
-              languages: embeddedPost.langs,
-              actor: embedAuthor,
-            })
-            if (matches) {
-              return matches
-            }
-          }
-        }
-
-        // quoted post's gallery
-        if (AppBskyEmbedGallery.isMain(embeddedPost.embed)) {
-          for (const item of embeddedPost.embed.items) {
-            if (AppBskyEmbedGallery.isImage(item)) {
-              const matches = matchMuteWords({
-                mutedWords,
-                text: item.alt,
-                languages: embeddedPost.langs,
-                actor: embedAuthor,
-              })
-              if (matches) {
-                return matches
-              }
-            }
-          }
-        }
-
-        // quoted post's link card
-        if (AppBskyEmbedExternal.isMain(embeddedPost.embed)) {
-          const { external } = embeddedPost.embed
-          const matches = matchMuteWords({
-            mutedWords,
-            text: external.title + ' ' + external.description,
-            languages: [],
-            actor: embedAuthor,
-          })
-          if (matches) {
-            return matches
-          }
-        }
-
-        if (AppBskyEmbedRecordWithMedia.isMain(embeddedPost.embed)) {
-          // quoted post's link card when it did a quote + media
-          if (AppBskyEmbedExternal.isMain(embeddedPost.embed.media)) {
-            const { external } = embeddedPost.embed.media
-            const matches = matchMuteWords({
-              mutedWords,
-              text: external.title + ' ' + external.description,
-              languages: [],
-              actor: embedAuthor,
-            })
-            if (matches) {
-              return matches
-            }
-          }
-
-          // quoted post's images when it did a quote + media
-          if (AppBskyEmbedImages.isMain(embeddedPost.embed.media)) {
-            for (const image of embeddedPost.embed.media.images) {
-              const matches = matchMuteWords({
-                mutedWords,
-                text: image.alt,
-                languages: AppBskyFeedPost.isRecord(embeddedPost.record)
-                  ? embeddedPost.langs
-                  : [],
-                actor: embedAuthor,
-              })
-              if (matches) {
-                return matches
-              }
-            }
-          }
-
-          // quoted post's gallery when it did a quote + media
-          if (AppBskyEmbedGallery.isMain(embeddedPost.embed.media)) {
-            for (const item of embeddedPost.embed.media.items) {
-              if (AppBskyEmbedGallery.isImage(item)) {
-                const matches = matchMuteWords({
-                  mutedWords,
-                  text: item.alt,
-                  languages: AppBskyFeedPost.isRecord(embeddedPost.record)
-                    ? embeddedPost.langs
-                    : [],
-                  actor: embedAuthor,
-                })
-                if (matches) {
-                  return matches
-                }
-              }
-            }
-          }
-        }
-      }
-    }
-    // link card
-    else if (AppBskyEmbedExternal.isView(embed)) {
-      const { external } = embed
-      const matches = matchMuteWords({
-        mutedWords,
-        text: external.title + ' ' + external.description,
-        languages: [],
-        actor: postAuthor,
-      })
-      if (matches) {
-        return matches
-      }
-    }
-    // quote post with media
-    else if (
-      AppBskyEmbedRecordWithMedia.isView(embed) &&
-      AppBskyEmbedRecord.isViewRecord(embed.record.record)
-    ) {
-      const embedAuthor = embed.record.record.author
-
-      // quoted post text
-      if (AppBskyFeedPost.isRecord(embed.record.record.value)) {
-        const post = embed.record.record.value as AppBskyFeedPost.Record
-        const matches = matchMuteWords({
-          mutedWords,
-          text: post.text,
-          facets: post.facets,
-          outlineTags: post.tags,
-          languages: post.langs,
-          actor: embedAuthor,
-        })
-        if (matches) {
-          return matches
-        }
-      }
-
-      // quoted post images
-      if (AppBskyEmbedImages.isView(embed.media)) {
-        for (const image of embed.media.images) {
-          const matches = matchMuteWords({
-            mutedWords,
-            text: image.alt,
-            languages: AppBskyFeedPost.isRecord(subject.record)
-              ? (subject.record as AppBskyFeedPost.Record).langs
-              : [],
-            actor: embedAuthor,
-          })
-          if (matches) {
-            return matches
-          }
-        }
-      }
-
-      // quoted post gallery
-      if (AppBskyEmbedGallery.isView(embed.media)) {
-        for (const item of embed.media.items) {
-          if (AppBskyEmbedGallery.isViewImage(item)) {
-            const matches = matchMuteWords({
-              mutedWords,
-              text: item.alt,
-              languages: AppBskyFeedPost.isRecord(subject.record)
-                ? (subject.record as AppBskyFeedPost.Record).langs
-                : [],
-              actor: embedAuthor,
-            })
-            if (matches) {
-              return matches
-            }
-          }
-        }
-      }
-
-      if (AppBskyEmbedExternal.isView(embed.media)) {
-        const { external } = embed.media
-        const matches = matchMuteWords({
-          mutedWords,
-          text: external.title + ' ' + external.description,
-          languages: [],
-          actor: embedAuthor,
-        })
-        if (matches) {
-          return matches
-        }
-      }
-    }
-  }
-}