@atproto/ozone 0.1.173 → 0.1.174

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

@@ -9,6 +9,10 @@ import {
   is$typed as _is$typed,
   type OmitKey,
 } from '../../../../util'
+import type * as ToolsOzoneTeamDefs from '../team/defs.js'
+import type * as ToolsOzoneModerationDefs from '../moderation/defs.js'
+import type * as ComAtprotoModerationDefs from '../../../com/atproto/moderation/defs.js'
+import type * as ToolsOzoneQueueDefs from '../queue/defs.js'
 
 const is$typed = _is$typed,
   validate = _validate
@@ -137,3 +141,326 @@ export const REASONSELFHARMSTUNTS = `${id}#reasonSelfHarmStunts`
 export const REASONSELFHARMSUBSTANCES = `${id}#reasonSelfHarmSubstances`
 /** Other dangerous content */
 export const REASONSELFHARMOTHER = `${id}#reasonSelfHarmOther`
+
+/** Information about the moderator currently assigned to a report. */
+export interface ReportAssignment {
+  $type?: 'tools.ozone.report.defs#reportAssignment'
+  /** DID of the assigned moderator */
+  did: string
+  moderator?: ToolsOzoneTeamDefs.Member
+  /** When the report was assigned */
+  assignedAt: string
+}
+
+const hashReportAssignment = 'reportAssignment'
+
+export function isReportAssignment<V>(v: V) {
+  return is$typed(v, id, hashReportAssignment)
+}
+
+export function validateReportAssignment<V>(v: V) {
+  return validate<ReportAssignment & V>(v, id, hashReportAssignment)
+}
+
+export interface ReportView {
+  $type?: 'tools.ozone.report.defs#reportView'
+  /** Report ID */
+  id: number
+  /** ID of the moderation event that created this report */
+  eventId: number
+  /** Current status of the report */
+  status:
+    | 'open'
+    | 'closed'
+    | 'escalated'
+    | 'queued'
+    | 'assigned'
+    | (string & {})
+  subject: ToolsOzoneModerationDefs.SubjectView
+  reportType: ComAtprotoModerationDefs.ReasonType
+  /** DID of the user who made the report */
+  reportedBy: string
+  reporter: ToolsOzoneModerationDefs.SubjectView
+  /** Comment provided by the reporter */
+  comment?: string
+  /** When the report was created */
+  createdAt: string
+  /** When the report was last updated */
+  updatedAt?: string
+  /** When the report was assigned to its current queue */
+  queuedAt?: string
+  /** Array of moderation event IDs representing actions taken on this report (sorted DESC, most recent first) */
+  actionEventIds?: number[]
+  /** Optional: expanded action events */
+  actions?: ToolsOzoneModerationDefs.ModEventView[]
+  /** Note sent to reporter when report was actioned */
+  actionNote?: string
+  subjectStatus?: ToolsOzoneModerationDefs.SubjectStatusView
+  /** Number of other pending reports on the same subject */
+  relatedReportCount?: number
+  assignment?: ReportAssignment
+  queue?: ToolsOzoneQueueDefs.QueueView
+  /** Whether this report is muted. A report is muted if the reporter was muted or the subject was muted at the time the report was created. */
+  isMuted?: boolean
+}
+
+const hashReportView = 'reportView'
+
+export function isReportView<V>(v: V) {
+  return is$typed(v, id, hashReportView)
+}
+
+export function validateReportView<V>(v: V) {
+  return validate<ReportView & V>(v, id, hashReportView)
+}
+
+/** Activity recording a report being routed to a queue. */
+export interface QueueActivity {
+  $type?: 'tools.ozone.report.defs#queueActivity'
+  /** The report's status before this activity. Populated automatically from the report row; not required in input. */
+  previousStatus?:
+    | 'open'
+    | 'closed'
+    | 'escalated'
+    | 'queued'
+    | 'assigned'
+    | (string & {})
+}
+
+const hashQueueActivity = 'queueActivity'
+
+export function isQueueActivity<V>(v: V) {
+  return is$typed(v, id, hashQueueActivity)
+}
+
+export function validateQueueActivity<V>(v: V) {
+  return validate<QueueActivity & V>(v, id, hashQueueActivity)
+}
+
+/** Activity recording a moderator being assigned to a report. */
+export interface AssignmentActivity {
+  $type?: 'tools.ozone.report.defs#assignmentActivity'
+  /** The report's status before this activity. Populated automatically from the report row; not required in input. */
+  previousStatus?:
+    | 'open'
+    | 'closed'
+    | 'escalated'
+    | 'queued'
+    | 'assigned'
+    | (string & {})
+}
+
+const hashAssignmentActivity = 'assignmentActivity'
+
+export function isAssignmentActivity<V>(v: V) {
+  return is$typed(v, id, hashAssignmentActivity)
+}
+
+export function validateAssignmentActivity<V>(v: V) {
+  return validate<AssignmentActivity & V>(v, id, hashAssignmentActivity)
+}
+
+/** Activity recording a report being escalated. */
+export interface EscalationActivity {
+  $type?: 'tools.ozone.report.defs#escalationActivity'
+  /** The report's status before this activity. Populated automatically from the report row; not required in input. */
+  previousStatus?:
+    | 'open'
+    | 'closed'
+    | 'escalated'
+    | 'queued'
+    | 'assigned'
+    | (string & {})
+}
+
+const hashEscalationActivity = 'escalationActivity'
+
+export function isEscalationActivity<V>(v: V) {
+  return is$typed(v, id, hashEscalationActivity)
+}
+
+export function validateEscalationActivity<V>(v: V) {
+  return validate<EscalationActivity & V>(v, id, hashEscalationActivity)
+}
+
+/** Activity recording a report being closed. */
+export interface CloseActivity {
+  $type?: 'tools.ozone.report.defs#closeActivity'
+  /** The report's status before this activity. Populated automatically from the report row; not required in input. */
+  previousStatus?:
+    | 'open'
+    | 'closed'
+    | 'escalated'
+    | 'queued'
+    | 'assigned'
+    | (string & {})
+}
+
+const hashCloseActivity = 'closeActivity'
+
+export function isCloseActivity<V>(v: V) {
+  return is$typed(v, id, hashCloseActivity)
+}
+
+export function validateCloseActivity<V>(v: V) {
+  return validate<CloseActivity & V>(v, id, hashCloseActivity)
+}
+
+/** Activity recording a closed report being reopened. Only valid when the report is in 'closed' status. */
+export interface ReopenActivity {
+  $type?: 'tools.ozone.report.defs#reopenActivity'
+  /** The report's status before this activity. Populated automatically from the report row; not required in input. */
+  previousStatus?:
+    | 'open'
+    | 'closed'
+    | 'escalated'
+    | 'queued'
+    | 'assigned'
+    | (string & {})
+}
+
+const hashReopenActivity = 'reopenActivity'
+
+export function isReopenActivity<V>(v: V) {
+  return is$typed(v, id, hashReopenActivity)
+}
+
+export function validateReopenActivity<V>(v: V) {
+  return validate<ReopenActivity & V>(v, id, hashReopenActivity)
+}
+
+/** Activity recording a note on a report. Use internalNote for moderator-only notes or publicNote for reporter-visible notes (or both). */
+export interface NoteActivity {
+  $type?: 'tools.ozone.report.defs#noteActivity'
+}
+
+const hashNoteActivity = 'noteActivity'
+
+export function isNoteActivity<V>(v: V) {
+  return is$typed(v, id, hashNoteActivity)
+}
+
+export function validateNoteActivity<V>(v: V) {
+  return validate<NoteActivity & V>(v, id, hashNoteActivity)
+}
+
+/** A single activity entry on a report. */
+export interface ReportActivityView {
+  $type?: 'tools.ozone.report.defs#reportActivityView'
+  /** Activity ID */
+  id: number
+  /** ID of the report this activity belongs to */
+  reportId: number
+  activity:
+    | $Typed<QueueActivity>
+    | $Typed<AssignmentActivity>
+    | $Typed<EscalationActivity>
+    | $Typed<CloseActivity>
+    | $Typed<ReopenActivity>
+    | $Typed<NoteActivity>
+    | { $type: string }
+  /** Optional moderator-only note. Not visible to reporters. */
+  internalNote?: string
+  /** Optional public note, potentially visible to the reporter. */
+  publicNote?: string
+  /** Extensible JSON payload for loose activity-specific metadata (e.g. assignmentId). */
+  meta?: { [_ in string]: unknown }
+  /** True if this activity was created by an automated process (e.g. queue router) rather than a direct human action. */
+  isAutomated: boolean
+  /** DID of the actor who created this activity, or the service DID for automated activities. */
+  createdBy: string
+  moderator?: ToolsOzoneTeamDefs.Member
+  /** When this activity was created */
+  createdAt: string
+}
+
+const hashReportActivityView = 'reportActivityView'
+
+export function isReportActivityView<V>(v: V) {
+  return is$typed(v, id, hashReportActivityView)
+}
+
+export function validateReportActivityView<V>(v: V) {
+  return validate<ReportActivityView & V>(v, id, hashReportActivityView)
+}
+
+/** Live statistics for reports for the current calendar day, filterable by queue, moderator, or report type. */
+export interface LiveStats {
+  $type?: 'tools.ozone.report.defs#liveStats'
+  /** Number of reports currently not closed. */
+  pendingCount?: number
+  /** Number of reports closed today. */
+  actionedCount?: number
+  /** Number of reports escalated today. */
+  escalatedCount?: number
+  /** Reports received today. */
+  inboundCount?: number
+  /** Percentage of reports actioned (actionedCount / inboundCount * 100), rounded to nearest integer. */
+  actionRate?: number
+  /** Average time in seconds from report creation (or moderator assignment) to close. */
+  avgHandlingTimeSec?: number
+  /** When these statistics were last computed. */
+  lastUpdated?: string
+}
+
+const hashLiveStats = 'liveStats'
+
+export function isLiveStats<V>(v: V) {
+  return is$typed(v, id, hashLiveStats)
+}
+
+export function validateLiveStats<V>(v: V) {
+  return validate<LiveStats & V>(v, id, hashLiveStats)
+}
+
+/** A single daily snapshot of report statistics for a calendar date. */
+export interface HistoricalStats {
+  $type?: 'tools.ozone.report.defs#historicalStats'
+  /** The calendar date this snapshot covers (YYYY-MM-DD). */
+  date: string
+  /** When this snapshot was last computed. */
+  computedAt?: string
+  /** Number of reports not closed at time of computation. */
+  pendingCount?: number
+  /** Number of reports closed during this day. */
+  actionedCount?: number
+  /** Number of reports escalated during this day. */
+  escalatedCount?: number
+  /** Reports received during this day. */
+  inboundCount?: number
+  /** Percentage of reports actioned (actionedCount / inboundCount * 100), rounded to nearest integer. */
+  actionRate?: number
+  /** Average time in seconds from report creation (or moderator assignment) to close. */
+  avgHandlingTimeSec?: number
+}
+
+const hashHistoricalStats = 'historicalStats'
+
+export function isHistoricalStats<V>(v: V) {
+  return is$typed(v, id, hashHistoricalStats)
+}
+
+export function validateHistoricalStats<V>(v: V) {
+  return validate<HistoricalStats & V>(v, id, hashHistoricalStats)
+}
+
+export interface AssignmentView {
+  $type?: 'tools.ozone.report.defs#assignmentView'
+  id: number
+  did: string
+  moderator?: ToolsOzoneTeamDefs.Member
+  queue?: ToolsOzoneQueueDefs.QueueView
+  reportId: number
+  startAt: string
+  endAt?: string
+}
+
+const hashAssignmentView = 'assignmentView'
+
+export function isAssignmentView<V>(v: V) {
+  return is$typed(v, id, hashAssignmentView)
+}
+
+export function validateAssignmentView<V>(v: V) {
+  return validate<AssignmentView & V>(v, id, hashAssignmentView)
+}

package/src/lexicon/types/tools/ozone/report/getAssignments.ts

@@ -0,0 +1,48 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import { type ValidationResult, BlobRef } from '@atproto/lexicon'
+import { CID } from 'multiformats/cid'
+import { validate as _validate } from '../../../../lexicons'
+import {
+  type $Typed,
+  is$typed as _is$typed,
+  type OmitKey,
+} from '../../../../util'
+import type * as ToolsOzoneReportDefs from './defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.report.getAssignments'
+
+export type QueryParams = {
+  /** When true, only returns active assignments. */
+  onlyActive: boolean
+  /** If specified, returns assignments for these reports only. */
+  reportIds?: number[]
+  /** If specified, returns assignments for these moderators only. */
+  dids?: string[]
+  limit: number
+  cursor?: string
+}
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  cursor?: string
+  assignments: ToolsOzoneReportDefs.AssignmentView[]
+}
+
+export type HandlerInput = void
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/tools/ozone/report/getHistoricalStats.ts

@@ -0,0 +1,54 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import { type ValidationResult, BlobRef } from '@atproto/lexicon'
+import { CID } from 'multiformats/cid'
+import { validate as _validate } from '../../../../lexicons'
+import {
+  type $Typed,
+  is$typed as _is$typed,
+  type OmitKey,
+} from '../../../../util'
+import type * as ToolsOzoneReportDefs from './defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.report.getHistoricalStats'
+
+export type QueryParams = {
+  /** Filter stats by queue. Use -1 for unqueued reports. */
+  queueId?: number
+  /** Filter stats by moderator DID. */
+  moderatorDid?: string
+  /** Filter stats by report types. */
+  reportTypes?: string[]
+  /** Earliest date to include (inclusive). */
+  startDate?: string
+  /** Latest date to include (inclusive). */
+  endDate?: string
+  /** Maximum number of entries to return. */
+  limit: number
+  /** Pagination cursor. */
+  cursor?: string
+}
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  stats: ToolsOzoneReportDefs.HistoricalStats[]
+  cursor?: string
+}
+
+export type HandlerInput = void
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/tools/ozone/report/getLatestReport.ts

@@ -0,0 +1,39 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import { type ValidationResult, BlobRef } from '@atproto/lexicon'
+import { CID } from 'multiformats/cid'
+import { validate as _validate } from '../../../../lexicons'
+import {
+  type $Typed,
+  is$typed as _is$typed,
+  type OmitKey,
+} from '../../../../util'
+import type * as ToolsOzoneReportDefs from './defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.report.getLatestReport'
+
+export type QueryParams = {}
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  report: ToolsOzoneReportDefs.ReportView
+}
+
+export type HandlerInput = void
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+  error?: 'NotFound'
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/tools/ozone/report/getLiveStats.ts

@@ -0,0 +1,45 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import { type ValidationResult, BlobRef } from '@atproto/lexicon'
+import { CID } from 'multiformats/cid'
+import { validate as _validate } from '../../../../lexicons'
+import {
+  type $Typed,
+  is$typed as _is$typed,
+  type OmitKey,
+} from '../../../../util'
+import type * as ToolsOzoneReportDefs from './defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.report.getLiveStats'
+
+export type QueryParams = {
+  /** Filter stats by queue. Use -1 for unqueued reports. */
+  queueId?: number
+  /** Filter stats by moderator DID. */
+  moderatorDid?: string
+  /** Filter stats by report types. */
+  reportTypes?: string[]
+}
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  stats: ToolsOzoneReportDefs.LiveStats
+}
+
+export type HandlerInput = void
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/tools/ozone/report/getReport.ts

@@ -0,0 +1,38 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import { type ValidationResult, BlobRef } from '@atproto/lexicon'
+import { CID } from 'multiformats/cid'
+import { validate as _validate } from '../../../../lexicons'
+import {
+  type $Typed,
+  is$typed as _is$typed,
+  type OmitKey,
+} from '../../../../util'
+import type * as ToolsOzoneReportDefs from './defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.report.getReport'
+
+export type QueryParams = {
+  /** The ID of the report to retrieve. */
+  id: number
+}
+export type InputSchema = undefined
+export type OutputSchema = ToolsOzoneReportDefs.ReportView
+export type HandlerInput = void
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+  error?: 'NotFound'
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/tools/ozone/report/listActivities.ts

@@ -0,0 +1,44 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import { type ValidationResult, BlobRef } from '@atproto/lexicon'
+import { CID } from 'multiformats/cid'
+import { validate as _validate } from '../../../../lexicons'
+import {
+  type $Typed,
+  is$typed as _is$typed,
+  type OmitKey,
+} from '../../../../util'
+import type * as ToolsOzoneReportDefs from './defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.report.listActivities'
+
+export type QueryParams = {
+  /** ID of the report whose activities to list */
+  reportId: number
+  limit: number
+  cursor?: string
+}
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  activities: ToolsOzoneReportDefs.ReportActivityView[]
+  cursor?: string
+}
+
+export type HandlerInput = void
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/tools/ozone/report/queryReports.ts

@@ -0,0 +1,72 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import { type ValidationResult, BlobRef } from '@atproto/lexicon'
+import { CID } from 'multiformats/cid'
+import { validate as _validate } from '../../../../lexicons'
+import {
+  type $Typed,
+  is$typed as _is$typed,
+  type OmitKey,
+} from '../../../../util'
+import type * as ToolsOzoneReportDefs from './defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.report.queryReports'
+
+export type QueryParams = {
+  /** Filter by queue ID. Use -1 for unassigned reports. */
+  queueId?: number
+  /** Filter by report types (fully qualified string in the format of com.atproto.moderation.defs#reason<name>). */
+  reportTypes?: string[]
+  /** Filter by report status. */
+  status:
+    | 'open'
+    | 'closed'
+    | 'escalated'
+    | 'queued'
+    | 'assigned'
+    | (string & {})
+  /** Filter by subject DID or AT-URI. */
+  subject?: string
+  /** Filter to reports where the subject is this DID or any record owned by this DID. Unlike `subject` (which scopes to a specific account or record), this returns all reports tied to the DID across both account-level and record-level subjects. */
+  did?: string
+  /** If specified, reports of the given type (account or record) will be returned. */
+  subjectType?: 'account' | 'record' | (string & {})
+  /** If specified, reports where the subject belongs to the given collections will be returned. When subjectType is set to 'account', this will be ignored. */
+  collections?: string[]
+  /** Retrieve reports created after a given timestamp */
+  reportedAfter?: string
+  /** Retrieve reports created before a given timestamp */
+  reportedBefore?: string
+  /** Filter by muted status. true returns only muted reports, false returns only unmuted reports. Defaults to false. */
+  isMuted: boolean
+  /** Filter by the DID of the moderator permanently assigned to the report. */
+  assignedTo?: string
+  sortField: 'createdAt' | 'updatedAt'
+  sortDirection: 'asc' | 'desc'
+  limit: number
+  cursor?: string
+}
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  cursor?: string
+  reports: ToolsOzoneReportDefs.ReportView[]
+}
+
+export type HandlerInput = void
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess