@atproto/ozone 0.1.172 → 0.1.174

package/src/lexicon/types/tools/ozone/queue/routeReports.ts

@@ -0,0 +1,50 @@
+/**
+ * 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'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.queue.routeReports'
+
+export type QueryParams = {}
+
+export interface InputSchema {
+  /** Start of report ID range (inclusive). */
+  startReportId: number
+  /** End of report ID range (inclusive). Difference between start and end must be less than 5,000. */
+  endReportId: number
+}
+
+export interface OutputSchema {
+  /** The number of reports assigned to a queue. */
+  assigned: number
+  /** The number of reports with no matching queue. */
+  unmatched: number
+}
+
+export interface HandlerInput {
+  encoding: 'application/json'
+  body: InputSchema
+}
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+  error?: 'OutOfRange'
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/tools/ozone/queue/unassignModerator.ts

@@ -0,0 +1,37 @@
+/**
+ * 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'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.queue.unassignModerator'
+
+export type QueryParams = {}
+
+export interface InputSchema {
+  /** The ID of the queue to unassign the user from. */
+  queueId: number
+  /** DID to be unassigned. */
+  did: string
+}
+
+export interface HandlerInput {
+  encoding: 'application/json'
+  body: InputSchema
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+  error?: 'InvalidAssignment'
+}
+
+export type HandlerOutput = HandlerError | void

package/src/lexicon/types/tools/ozone/queue/updateQueue.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 ToolsOzoneQueueDefs from './defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.queue.updateQueue'
+
+export type QueryParams = {}
+
+export interface InputSchema {
+  /** ID of the queue to update */
+  queueId: number
+  /** New display name for the queue */
+  name?: string
+  /** Enable or disable the queue */
+  enabled?: boolean
+  /** Optional description of the queue */
+  description?: string
+}
+
+export interface OutputSchema {
+  queue: ToolsOzoneQueueDefs.QueueView
+}
+
+export interface HandlerInput {
+  encoding: 'application/json'
+  body: InputSchema
+}
+
+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/assignModerator.ts

@@ -0,0 +1,50 @@
+/**
+ * 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.assignModerator'
+
+export type QueryParams = {}
+
+export interface InputSchema {
+  /** The ID of the report to assign. */
+  reportId: number
+  /** Optional queue ID to associate the assignment with. If not provided and the report has been assigned on a queue before, it will stay on that queue. */
+  queueId?: number
+  /** DID to be assigned. Defaults to the caller's DID. Admins may assign to any moderator. */
+  did?: string
+  /** When true, the assignment has no expiry (endAt is null). Throws AlreadyAssigned if another user already has a permanent assignment on this report. */
+  isPermanent?: boolean
+}
+
+export type OutputSchema = ToolsOzoneReportDefs.AssignmentView
+
+export interface HandlerInput {
+  encoding: 'application/json'
+  body: InputSchema
+}
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+  error?: 'AlreadyAssigned' | 'InvalidAssignment'
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess

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

@@ -0,0 +1,60 @@
+/**
+ * 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.createActivity'
+
+export type QueryParams = {}
+
+export interface InputSchema {
+  /** ID of the report to record activity on */
+  reportId: number
+  activity:
+    | $Typed<ToolsOzoneReportDefs.QueueActivity>
+    | $Typed<ToolsOzoneReportDefs.AssignmentActivity>
+    | $Typed<ToolsOzoneReportDefs.EscalationActivity>
+    | $Typed<ToolsOzoneReportDefs.CloseActivity>
+    | $Typed<ToolsOzoneReportDefs.ReopenActivity>
+    | $Typed<ToolsOzoneReportDefs.NoteActivity>
+    | { $type: string }
+  /** Optional moderator-only note. Not visible to reporters. */
+  internalNote?: string
+  /** Optional public-facing note, potentially visible to the reporter. */
+  publicNote?: string
+  /** Set true when this activity is triggered by an automated process. Defaults to false. */
+  isAutomated: boolean
+}
+
+export interface OutputSchema {
+  activity: ToolsOzoneReportDefs.ReportActivityView
+}
+
+export interface HandlerInput {
+  encoding: 'application/json'
+  body: InputSchema
+}
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+  error?: 'ReportNotFound' | 'InvalidStateTransition' | 'AlreadyInTargetState'
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess

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