@atproto/ozone 0.1.68 → 0.1.70

package/src/db/migrations/20241220T144630860Z-stats-materialized-views.ts

@@ -0,0 +1,218 @@
+import { Kysely, sql } from 'kysely'
+
+import { REASONAPPEAL } from '../../lexicon/types/com/atproto/moderation/defs'
+import { DatabaseSchemaType } from '../schema'
+
+import {
+  REVIEWESCALATED,
+  REVIEWOPEN,
+} from '../../lexicon/types/tools/ozone/moderation/defs'
+import * as modEvent from '../schema/moderation_event'
+import * as modStatus from '../schema/moderation_subject_status'
+import * as recordEventsStats from '../schema/record_events_stats'
+
+export async function up(db: Kysely<any>): Promise<void> {
+  // Used by "tools.ozone.moderation.queryStatuses". Reduces query cost by two
+  // order of magnitudes when sorting using "reportedRecordsCount" or
+  // "takendownRecordsCount" and filtering by "reviewState".
+  await db.schema
+    .createIndex('moderation_subject_status_did_id_review_state_idx')
+    .on('moderation_subject_status')
+    .column('did')
+    .expression(sql`"id" ASC NULLS FIRST`)
+    .column('reviewState')
+    .execute()
+
+  // ~6sec for 16M events
+  await db.schema
+    .createView('account_events_stats')
+    .materialized()
+    .ifNotExists()
+    .as(
+      (db as Kysely<modEvent.PartialDB>)
+        .selectFrom('moderation_event')
+        .where('subjectType', '=', 'com.atproto.admin.defs#repoRef')
+        .where('subjectUri', 'is', null)
+        .select('subjectDid')
+        .select([
+          (eb) =>
+            sql<number>`COUNT(*) FILTER(
+              WHERE ${eb.ref('action')} = 'tools.ozone.moderation.defs#modEventTakedown'
+              AND ${eb.ref('durationInHours')} IS NULL
+            )`.as('takedownCount'),
+          (eb) =>
+            sql<number>`COUNT(*) FILTER(
+              WHERE ${eb.ref('action')} = 'tools.ozone.moderation.defs#modEventTakedown'
+              AND ${eb.ref('durationInHours')} IS NOT NULL
+            )`.as('suspendCount'),
+          (eb) =>
+            sql<number>`COUNT(*) FILTER(
+              WHERE ${eb.ref('action')} = 'tools.ozone.moderation.defs#modEventEscalate'
+            )`.as('escalateCount'),
+          (eb) =>
+            sql<number>`COUNT(*) FILTER(
+              WHERE ${eb.ref('action')} = 'tools.ozone.moderation.defs#modEventReport'
+              AND ${eb.ref('meta')} ->> 'reportType' != ${REASONAPPEAL}
+            )`.as('reportCount'),
+          (eb) =>
+            sql<number>`COUNT(*) FILTER(
+              WHERE ${eb.ref('action')} = 'tools.ozone.moderation.defs#modEventReport'
+              AND ${eb.ref('meta')} ->> 'reportType' = ${REASONAPPEAL}
+            )`.as('appealCount'),
+        ])
+        .groupBy('subjectDid'),
+    )
+    .execute()
+
+  await db.schema
+    .createIndex('account_events_stats_did_idx')
+    .unique()
+    .on('account_events_stats')
+    .column('subjectDid')
+    .execute()
+
+  await db.schema
+    .createIndex('account_events_stats_suspend_count_idx')
+    .on('account_events_stats')
+    .expression(sql`"suspendCount" ASC NULLS FIRST`)
+    .column('subjectDid')
+    .execute()
+
+  // ~50sec for 16M events
+  await db.schema
+    .createView('record_events_stats')
+    .materialized()
+    .ifNotExists()
+    .as(
+      (db as Kysely<modEvent.PartialDB>)
+        .selectFrom('moderation_event')
+        .select([
+          'subjectDid',
+          'subjectUri',
+          (eb) =>
+            sql<number>`COUNT(*) FILTER (WHERE ${eb.ref('action')} = 'tools.ozone.moderation.defs#modEventEscalate')`.as(
+              'escalateCount',
+            ),
+          (eb) =>
+            sql<number>`COUNT(*) FILTER (WHERE ${eb.ref('action')} = 'tools.ozone.moderation.defs#modEventReport' AND ${eb.ref('meta')} ->> 'reportType' != 'com.atproto.moderation.defs#reasonAppeal')`.as(
+              'reportCount',
+            ),
+          (eb) =>
+            sql<number>`COUNT(*) FILTER (WHERE ${eb.ref('action')} = 'tools.ozone.moderation.defs#modEventReport' AND ${eb.ref('meta')} ->> 'reportType' = 'com.atproto.moderation.defs#reasonAppeal')`.as(
+              'appealCount',
+            ),
+        ])
+        .where('subjectType', '=', 'com.atproto.repo.strongRef')
+        .where('subjectUri', 'is not', null)
+        .groupBy(['subjectDid', 'subjectUri']),
+    )
+    .execute()
+
+  await db.schema
+    .createIndex('record_events_stats_uri_idx')
+    .unique()
+    .on('record_events_stats')
+    .column('subjectUri')
+    .execute()
+
+  await db.schema
+    .createIndex('record_events_stats_did_idx')
+    .on('record_events_stats')
+    .column('subjectDid')
+    .execute()
+
+  await db.schema
+    .createView('account_record_events_stats')
+    .materialized()
+    .ifNotExists()
+    .as(
+      (db as Kysely<recordEventsStats.PartialDB>)
+        .selectFrom('record_events_stats')
+        .select([
+          'subjectDid',
+          (eb) =>
+            // Casting to "bigint" because "numeric" gets casted to a string
+            // by default by postgres-node.
+            sql<number>`SUM(${eb.ref('reportCount')})::bigint`.as(
+              'totalReports',
+            ),
+          (eb) =>
+            sql<number>`COUNT(*) FILTER (WHERE ${eb.ref('reportCount')} > 0)`.as(
+              'reportedCount',
+            ),
+          (eb) =>
+            sql<number>`COUNT(*) FILTER (WHERE ${eb.ref('escalateCount')} > 0)`.as(
+              'escalatedCount',
+            ),
+          (eb) =>
+            sql<number>`COUNT(*) FILTER (WHERE ${eb.ref('appealCount')} > 0)`.as(
+              'appealedCount',
+            ),
+        ])
+        .groupBy('subjectDid'),
+    )
+    .execute()
+
+  await db.schema
+    .createIndex('account_record_events_stats_did_idx')
+    .unique()
+    .on('account_record_events_stats')
+    .column('subjectDid')
+    .execute()
+
+  await db.schema
+    .createIndex('account_record_events_stats_reported_count_idx')
+    .on('account_record_events_stats')
+    .expression(sql`"reportedCount" ASC NULLS FIRST`)
+    .column('subjectDid')
+    .execute()
+
+  await db.schema
+    .createView('account_record_status_stats')
+    .materialized()
+    .ifNotExists()
+    .as(
+      (db as Kysely<modStatus.PartialDB>)
+        .selectFrom('moderation_subject_status')
+        .select('did')
+        .select([
+          sql<number>`COUNT(*)`.as('subjectCount'),
+          (eb) =>
+            sql<number>`COUNT(*) FILTER (WHERE ${eb.ref('reviewState')} IN (${REVIEWOPEN}, ${REVIEWESCALATED}))`.as(
+              'pendingCount',
+            ),
+          (eb) =>
+            sql<number>`COUNT(*) FILTER (WHERE ${eb.ref('reviewState')} NOT IN (${REVIEWOPEN}, ${REVIEWESCALATED}))`.as(
+              'processedCount',
+            ),
+          (eb) =>
+            sql<number>`COUNT(*) FILTER (WHERE ${eb.ref('takendown')})`.as(
+              'takendownCount',
+            ),
+        ])
+        .where('recordPath', '!=', '')
+        .groupBy('did'),
+    )
+    .execute()
+
+  await db.schema
+    .createIndex('account_record_status_stats_did_idx')
+    .unique()
+    .on('account_record_status_stats')
+    .column('did')
+    .execute()
+
+  await db.schema
+    .createIndex('account_record_status_stats_takendown_count_idx')
+    .on('account_record_status_stats')
+    .expression(sql`"takendownCount" ASC NULLS FIRST`)
+    .column('did')
+    .execute()
+}
+
+export async function down(db: Kysely<DatabaseSchemaType>): Promise<void> {
+  db.schema.dropView('account_record_status_stats').materialized().execute()
+  db.schema.dropView('account_record_events_stats').materialized().execute()
+  db.schema.dropView('record_events_stats').materialized().execute()
+  db.schema.dropView('account_events_stats').materialized().execute()
+}

package/src/db/migrations/index.ts

@@ -17,3 +17,4 @@ export * as _20241001T205730722Z from './20241001T205730722Z-subject-status-revi
 export * as _20241008T205730722Z from './20241008T205730722Z-sets'
 export * as _20241018T205730722Z from './20241018T205730722Z-setting'
 export * as _20241026T205730722Z from './20241026T205730722Z-add-hosting-status-to-subject-status'
+export * as _20241220T144630860Z from './20241220T144630860Z-stats-materialized-views'

package/src/db/schema/account_events_stats.ts

@@ -0,0 +1,16 @@
+import { GeneratedAlways, Selectable } from 'kysely'
+
+export const tableName = 'account_events_stats'
+
+export type AccountEventsStats = {
+  subjectDid: GeneratedAlways<string>
+  takedownCount: GeneratedAlways<number>
+  suspendCount: GeneratedAlways<number>
+  escalateCount: GeneratedAlways<number>
+  reportCount: GeneratedAlways<number>
+  appealCount: GeneratedAlways<number>
+}
+
+export type AccountEventsStatsRow = Selectable<AccountEventsStats>
+
+export type PartialDB = { [tableName]: AccountEventsStats }

package/src/db/schema/account_record_events_stats.ts

@@ -0,0 +1,15 @@
+import { GeneratedAlways, Selectable } from 'kysely'
+
+export const tableName = 'account_record_events_stats'
+
+type AccountRecordEventsStats = {
+  subjectDid: GeneratedAlways<string>
+  totalReports: GeneratedAlways<number>
+  reportedCount: GeneratedAlways<number>
+  escalatedCount: GeneratedAlways<number>
+  appealedCount: GeneratedAlways<number>
+}
+
+export type AccountRecordEventsStatsRow = Selectable<AccountRecordEventsStats>
+
+export type PartialDB = { [tableName]: AccountRecordEventsStats }

package/src/db/schema/account_record_status_stats.ts

@@ -0,0 +1,15 @@
+import { GeneratedAlways, Selectable } from 'kysely'
+
+export const tableName = 'account_record_status_stats'
+
+type AccountRecordStatusStats = {
+  did: GeneratedAlways<string>
+  subjectCount: GeneratedAlways<number>
+  pendingCount: GeneratedAlways<number>
+  processedCount: GeneratedAlways<number>
+  takendownCount: GeneratedAlways<number>
+}
+
+export type AccountRecordStatusStatsRow = Selectable<AccountRecordStatusStats>
+
+export type PartialDB = { [tableName]: AccountRecordStatusStats }

package/src/db/schema/index.ts

@@ -11,6 +11,11 @@ import * as set from './ozone_set'
 import * as member from './member'
 import * as setting from './setting'
 
+import * as recordEventsStats from './record_events_stats'
+import * as accountEventsStats from './account_events_stats'
+import * as accountRecordEventsStats from './account_record_events_stats'
+import * as accountRecordStatusStats from './account_record_status_stats'
+
 export type DatabaseSchemaType = modEvent.PartialDB &
   modSubjectStatus.PartialDB &
   label.PartialDB &
@@ -21,7 +26,11 @@ export type DatabaseSchemaType = modEvent.PartialDB &
   communicationTemplate.PartialDB &
   set.PartialDB &
   member.PartialDB &
-  setting.PartialDB
+  setting.PartialDB &
+  accountEventsStats.PartialDB &
+  recordEventsStats.PartialDB &
+  accountRecordEventsStats.PartialDB &
+  accountRecordStatusStats.PartialDB
 
 export type DatabaseSchema = Kysely<DatabaseSchemaType>
 

package/src/db/schema/record_events_stats.ts

@@ -0,0 +1,15 @@
+import { GeneratedAlways, Selectable } from 'kysely'
+
+export const tableName = 'record_events_stats'
+
+export type RecordEventsStats = {
+  subjectDid: GeneratedAlways<string>
+  subjectUri: GeneratedAlways<string>
+  escalateCount: GeneratedAlways<number>
+  reportCount: GeneratedAlways<number>
+  appealCount: GeneratedAlways<number>
+}
+
+export type RecordEventsStatsRow = Selectable<RecordEventsStats>
+
+export type PartialDB = { [tableName]: RecordEventsStats }

package/src/index.ts

@@ -114,13 +114,7 @@ export class OzoneService {
         },
         'db pool stats',
       )
-      dbLogger.info(
-        {
-          runningCount: backgroundQueue.queue.pending,
-          waitingCount: backgroundQueue.queue.size,
-        },
-        'background queue stats',
-      )
+      dbLogger.info(backgroundQueue.getStats(), 'background queue stats')
     }, 10000)
     await this.ctx.sequencer.start()
     const server = this.app.listen(this.ctx.cfg.service.port)

package/src/lexicon/index.ts

@@ -211,6 +211,8 @@ export const APP_BSKY_FEED = {
   DefsClickthroughAuthor: 'app.bsky.feed.defs#clickthroughAuthor',
   DefsClickthroughReposter: 'app.bsky.feed.defs#clickthroughReposter',
   DefsClickthroughEmbed: 'app.bsky.feed.defs#clickthroughEmbed',
+  DefsContentModeUnspecified: 'app.bsky.feed.defs#contentModeUnspecified',
+  DefsContentModeVideo: 'app.bsky.feed.defs#contentModeVideo',
   DefsInteractionSeen: 'app.bsky.feed.defs#interactionSeen',
   DefsInteractionLike: 'app.bsky.feed.defs#interactionLike',
   DefsInteractionRepost: 'app.bsky.feed.defs#interactionRepost',

package/src/lexicon/lexicons.ts

@@ -4851,6 +4851,11 @@ export const schemaDict = {
                   ref: 'lex:app.bsky.actor.defs#profileView',
                 },
               },
+              recId: {
+                type: 'integer',
+                description:
+                  'Snowflake for this recommendation, use when submitting recommendation events.',
+              },
             },
           },
         },
@@ -5773,6 +5778,13 @@ export const schemaDict = {
             type: 'ref',
             ref: 'lex:app.bsky.feed.defs#generatorViewerState',
           },
+          contentMode: {
+            type: 'string',
+            knownValues: [
+              'app.bsky.feed.defs#contentModeUnspecified',
+              'app.bsky.feed.defs#contentModeVideo',
+            ],
+          },
           indexedAt: {
             type: 'string',
             format: 'datetime',
@@ -5907,6 +5919,15 @@ export const schemaDict = {
         description:
           'User clicked through to the embedded content of the feed item',
       },
+      contentModeUnspecified: {
+        type: 'token',
+        description: 'Declares the feed generator returns any types of posts.',
+      },
+      contentModeVideo: {
+        type: 'token',
+        description:
+          'Declares the feed generator returns posts containing app.bsky.embed.video embeds.',
+      },
       interactionSeen: {
         type: 'token',
         description: 'Feed item was seen by user',
@@ -6038,6 +6059,13 @@ export const schemaDict = {
               description: 'Self-label values',
               refs: ['lex:com.atproto.label.defs#selfLabels'],
             },
+            contentMode: {
+              type: 'string',
+              knownValues: [
+                'app.bsky.feed.defs#contentModeUnspecified',
+                'app.bsky.feed.defs#contentModeVideo',
+              ],
+            },
             createdAt: {
               type: 'string',
               format: 'datetime',
@@ -8358,6 +8386,11 @@ export const schemaDict = {
                   'If true, response has fallen-back to generic results, and is not scoped using relativeToDid',
                 default: false,
               },
+              recId: {
+                type: 'integer',
+                description:
+                  'Snowflake for this recommendation, use when submitting recommendation events.',
+              },
             },
           },
         },
@@ -9429,6 +9462,11 @@ export const schemaDict = {
                 description:
                   'DID of the account these suggestions are relative to. If this is returned undefined, suggestions are based on the viewer.',
               },
+              recId: {
+                type: 'integer',
+                description:
+                  'Snowflake for this recommendation, use when submitting recommendation events.',
+              },
             },
           },
         },
@@ -11284,6 +11322,85 @@ export const schemaDict = {
               type: 'string',
             },
           },
+          accountStats: {
+            description: 'Statistics related to the account subject',
+            type: 'ref',
+            ref: 'lex:tools.ozone.moderation.defs#accountStats',
+          },
+          recordsStats: {
+            description:
+              "Statistics related to the record subjects authored by the subject's account",
+            type: 'ref',
+            ref: 'lex:tools.ozone.moderation.defs#recordsStats',
+          },
+        },
+      },
+      accountStats: {
+        description: 'Statistics about a particular account subject',
+        type: 'object',
+        properties: {
+          reportCount: {
+            description: 'Total number of reports on the account',
+            type: 'integer',
+          },
+          appealCount: {
+            description:
+              'Total number of appeals against a moderation action on the account',
+            type: 'integer',
+          },
+          suspendCount: {
+            description: 'Number of times the account was suspended',
+            type: 'integer',
+          },
+          escalateCount: {
+            description: 'Number of times the account was escalated',
+            type: 'integer',
+          },
+          takedownCount: {
+            description: 'Number of times the account was taken down',
+            type: 'integer',
+          },
+        },
+      },
+      recordsStats: {
+        description: 'Statistics about a set of record subject items',
+        type: 'object',
+        properties: {
+          totalReports: {
+            description:
+              'Cumulative sum of the number of reports on the items in the set',
+            type: 'integer',
+          },
+          reportedCount: {
+            description: 'Number of items that were reported at least once',
+            type: 'integer',
+          },
+          escalatedCount: {
+            description: 'Number of items that were escalated at least once',
+            type: 'integer',
+          },
+          appealedCount: {
+            description: 'Number of items that were appealed at least once',
+            type: 'integer',
+          },
+          subjectCount: {
+            description: 'Total number of item in the set',
+            type: 'integer',
+          },
+          pendingCount: {
+            description:
+              'Number of item currently in "reviewOpen" or "reviewEscalated" state',
+            type: 'integer',
+          },
+          processedCount: {
+            description:
+              'Number of item currently in "reviewNone" or "reviewClosed" state',
+            type: 'integer',
+          },
+          takendownCount: {
+            description: 'Number of item currently taken down',
+            type: 'integer',
+          },
         },
       },
       subjectReviewState: {
@@ -12532,7 +12649,12 @@ export const schemaDict = {
             sortField: {
               type: 'string',
               default: 'lastReportedAt',
-              enum: ['lastReviewedAt', 'lastReportedAt'],
+              enum: [
+                'lastReviewedAt',
+                'lastReportedAt',
+                'reportedRecordsCount',
+                'takendownRecordsCount',
+              ],
             },
             sortDirection: {
               type: 'string',
@@ -12587,6 +12709,21 @@ export const schemaDict = {
                 "If specified, subjects of the given type (account or record) will be returned. When this is set to 'account' the 'collections' parameter will be ignored. When includeAllUserRecords or subject is set, this will be ignored.",
               knownValues: ['account', 'record'],
             },
+            minAccountSuspendCount: {
+              type: 'integer',
+              description:
+                'If specified, only subjects that belong to an account that has at least this many suspensions will be returned.',
+            },
+            minReportedRecordsCount: {
+              type: 'integer',
+              description:
+                'If specified, only subjects that belong to an account that has at least this many reported records will be returned.',
+            },
+            minTakendownRecordsCount: {
+              type: 'integer',
+              description:
+                'If specified, only subjects that belong to an account that has at least this many taken down records will be returned.',
+            },
           },
         },
         output: {

package/src/lexicon/types/app/bsky/feed/defs.ts

@@ -247,6 +247,10 @@ export interface GeneratorView {
   acceptsInteractions?: boolean
   labels?: ComAtprotoLabelDefs.Label[]
   viewer?: GeneratorViewerState
+  contentMode?:
+    | 'app.bsky.feed.defs#contentModeUnspecified'
+    | 'app.bsky.feed.defs#contentModeVideo'
+    | (string & {})
   indexedAt: string
   [k: string]: unknown
 }
@@ -401,6 +405,11 @@ export const CLICKTHROUGHAUTHOR = 'app.bsky.feed.defs#clickthroughAuthor'
 export const CLICKTHROUGHREPOSTER = 'app.bsky.feed.defs#clickthroughReposter'
 /** User clicked through to the embedded content of the feed item */
 export const CLICKTHROUGHEMBED = 'app.bsky.feed.defs#clickthroughEmbed'
+/** Declares the feed generator returns any types of posts. */
+export const CONTENTMODEUNSPECIFIED =
+  'app.bsky.feed.defs#contentModeUnspecified'
+/** Declares the feed generator returns posts containing app.bsky.embed.video embeds. */
+export const CONTENTMODEVIDEO = 'app.bsky.feed.defs#contentModeVideo'
 /** Feed item was seen by user */
 export const INTERACTIONSEEN = 'app.bsky.feed.defs#interactionSeen'
 /** User liked the feed item */

package/src/lexicon/types/app/bsky/feed/generator.ts

@@ -19,6 +19,10 @@ export interface Record {
   labels?:
     | ComAtprotoLabelDefs.SelfLabels
     | { $type: string; [k: string]: unknown }
+  contentMode?:
+    | 'app.bsky.feed.defs#contentModeUnspecified'
+    | 'app.bsky.feed.defs#contentModeVideo'
+    | (string & {})
   createdAt: string
   [k: string]: unknown
 }

package/src/lexicon/types/tools/ozone/moderation/defs.ts

@@ -136,6 +136,8 @@ export interface SubjectStatusView {
   appealed?: boolean
   suspendUntil?: string
   tags?: string[]
+  accountStats?: AccountStats
+  recordsStats?: RecordsStats
   [k: string]: unknown
 }
 
@@ -151,6 +153,66 @@ export function validateSubjectStatusView(v: unknown): ValidationResult {
   return lexicons.validate('tools.ozone.moderation.defs#subjectStatusView', v)
 }
 
+/** Statistics about a particular account subject */
+export interface AccountStats {
+  /** Total number of reports on the account */
+  reportCount?: number
+  /** Total number of appeals against a moderation action on the account */
+  appealCount?: number
+  /** Number of times the account was suspended */
+  suspendCount?: number
+  /** Number of times the account was escalated */
+  escalateCount?: number
+  /** Number of times the account was taken down */
+  takedownCount?: number
+  [k: string]: unknown
+}
+
+export function isAccountStats(v: unknown): v is AccountStats {
+  return (
+    isObj(v) &&
+    hasProp(v, '$type') &&
+    v.$type === 'tools.ozone.moderation.defs#accountStats'
+  )
+}
+
+export function validateAccountStats(v: unknown): ValidationResult {
+  return lexicons.validate('tools.ozone.moderation.defs#accountStats', v)
+}
+
+/** Statistics about a set of record subject items */
+export interface RecordsStats {
+  /** Cumulative sum of the number of reports on the items in the set */
+  totalReports?: number
+  /** Number of items that were reported at least once */
+  reportedCount?: number
+  /** Number of items that were escalated at least once */
+  escalatedCount?: number
+  /** Number of items that were appealed at least once */
+  appealedCount?: number
+  /** Total number of item in the set */
+  subjectCount?: number
+  /** Number of item currently in "reviewOpen" or "reviewEscalated" state */
+  pendingCount?: number
+  /** Number of item currently in "reviewNone" or "reviewClosed" state */
+  processedCount?: number
+  /** Number of item currently taken down */
+  takendownCount?: number
+  [k: string]: unknown
+}
+
+export function isRecordsStats(v: unknown): v is RecordsStats {
+  return (
+    isObj(v) &&
+    hasProp(v, '$type') &&
+    v.$type === 'tools.ozone.moderation.defs#recordsStats'
+  )
+}
+
+export function validateRecordsStats(v: unknown): ValidationResult {
+  return lexicons.validate('tools.ozone.moderation.defs#recordsStats', v)
+}
+
 export type SubjectReviewState =
   | 'lex:tools.ozone.moderation.defs#reviewOpen'
   | 'lex:tools.ozone.moderation.defs#reviewEscalated'

package/src/lexicon/types/tools/ozone/moderation/queryStatuses.ts

@@ -49,7 +49,11 @@ export interface QueryParams {
   ignoreSubjects?: string[]
   /** Get all subject statuses that were reviewed by a specific moderator */
   lastReviewedBy?: string
-  sortField: 'lastReviewedAt' | 'lastReportedAt'
+  sortField:
+    | 'lastReviewedAt'
+    | 'lastReportedAt'
+    | 'reportedRecordsCount'
+    | 'takendownRecordsCount'
   sortDirection: 'asc' | 'desc'
   /** Get subjects that were taken down */
   takendown?: boolean
@@ -63,6 +67,12 @@ export interface QueryParams {
   collections?: string[]
   /** If specified, subjects of the given type (account or record) will be returned. When this is set to 'account' the 'collections' parameter will be ignored. When includeAllUserRecords or subject is set, this will be ignored. */
   subjectType?: 'account' | 'record' | (string & {})
+  /** If specified, only subjects that belong to an account that has at least this many suspensions will be returned. */
+  minAccountSuspendCount?: number
+  /** If specified, only subjects that belong to an account that has at least this many reported records will be returned. */
+  minReportedRecordsCount?: number
+  /** If specified, only subjects that belong to an account that has at least this many taken down records will be returned. */
+  minTakendownRecordsCount?: number
 }
 
 export type InputSchema = undefined