@atproto/ozone 0.1.173 → 0.1.174

package/src/lexicon/types/app/bsky/embed/external.ts

@@ -36,6 +36,8 @@ export interface External {
   title: string
   description: string
   thumb?: BlobRef
+  /** The URI of the Atmosphere record representing this external content, if it exists. Example: a site.standard.document record. */
+  associatedRecord?: string
 }
 
 const hashExternal = 'external'

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

@@ -56,6 +56,7 @@ export interface InputSchema {
   modTool?: ToolsOzoneModerationDefs.ModTool
   /** An optional external ID for the event, used to deduplicate events from external systems. Fails when an event of same type with the same external ID exists for the same subject. */
   externalId?: string
+  reportAction?: ReportAction
 }
 
 export type OutputSchema = ToolsOzoneModerationDefs.ModEventView
@@ -78,3 +79,26 @@ export interface HandlerError {
 }
 
 export type HandlerOutput = HandlerError | HandlerSuccess
+
+/** Target specific reports when emitting a moderation event */
+export interface ReportAction {
+  $type?: 'tools.ozone.moderation.emitEvent#reportAction'
+  /** Target specific report IDs */
+  ids?: number[]
+  /** Target reports matching these report types on the subject (fully qualified NSIDs) */
+  types?: string[]
+  /** Target ALL reports on the subject */
+  all?: boolean
+  /** Note to send to reporter(s) when actioning their report */
+  note?: string
+}
+
+const hashReportAction = 'reportAction'
+
+export function isReportAction<V>(v: V) {
+  return is$typed(v, id, hashReportAction)
+}
+
+export function validateReportAction<V>(v: V) {
+  return validate<ReportAction & V>(v, id, hashReportAction)
+}

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

@@ -0,0 +1,46 @@
+/**
+ * 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.assignModerator'
+
+export type QueryParams = {}
+
+export interface InputSchema {
+  /** The ID of the queue to assign the user to. */
+  queueId: number
+  /** DID to be assigned. */
+  did: string
+}
+
+export type OutputSchema = ToolsOzoneQueueDefs.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?: 'InvalidAssignment'
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/tools/ozone/queue/createQueue.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 ToolsOzoneQueueDefs from './defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.queue.createQueue'
+
+export type QueryParams = {}
+
+export interface InputSchema {
+  /** Display name for the queue (must be unique) */
+  name: string
+  /** Subject types this queue accepts */
+  subjectTypes: ('account' | 'record' | 'message' | (string & {}))[]
+  /** Collection name for record subjects. Required if subjectTypes includes 'record'. */
+  collection?: string
+  /** Report reason types (fully qualified NSIDs) */
+  reportTypes: string[]
+  /** 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
+  error?: 'ConflictingQueue'
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess

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

@@ -0,0 +1,99 @@
+/**
+ * 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 ToolsOzoneTeamDefs from '../team/defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.queue.defs'
+
+export interface QueueView {
+  $type?: 'tools.ozone.queue.defs#queueView'
+  /** Queue ID */
+  id: number
+  /** Display name of the queue */
+  name: string
+  /** Subject types this queue accepts. */
+  subjectTypes: ('account' | 'record' | 'message' | (string & {}))[]
+  /** Collection name for record subjects (e.g., 'app.bsky.feed.post') */
+  collection?: string
+  /** Report reason types this queue accepts (fully qualified NSIDs) */
+  reportTypes: string[]
+  /** Optional description of the queue */
+  description?: string
+  /** DID of moderator who created this queue */
+  createdBy: string
+  createdAt: string
+  updatedAt: string
+  /** Whether this queue is currently active */
+  enabled: boolean
+  /** When the queue was deleted, if applicable */
+  deletedAt?: string
+  stats: QueueStats
+}
+
+const hashQueueView = 'queueView'
+
+export function isQueueView<V>(v: V) {
+  return is$typed(v, id, hashQueueView)
+}
+
+export function validateQueueView<V>(v: V) {
+  return validate<QueueView & V>(v, id, hashQueueView)
+}
+
+export interface QueueStats {
+  $type?: 'tools.ozone.queue.defs#queueStats'
+  /** Number of reports in 'open' status */
+  pendingCount?: number
+  /** Number of reports in 'closed' status */
+  actionedCount?: number
+  /** Number of reports in 'escalated' status */
+  escalatedCount?: number
+  /** Reports received in this queue in the last 24 hours. */
+  inboundCount?: number
+  /** Percentage of reports actioned (actionedCount / inboundCount * 100), rounded to nearest integer. Absent when inboundCount is 0. */
+  actionRate?: number
+  /** Average time in seconds from report creation to close, for reports closed in this period. */
+  avgHandlingTimeSec?: number
+  /** When these statistics were last computed */
+  lastUpdated?: string
+}
+
+const hashQueueStats = 'queueStats'
+
+export function isQueueStats<V>(v: V) {
+  return is$typed(v, id, hashQueueStats)
+}
+
+export function validateQueueStats<V>(v: V) {
+  return validate<QueueStats & V>(v, id, hashQueueStats)
+}
+
+export interface AssignmentView {
+  $type?: 'tools.ozone.queue.defs#assignmentView'
+  id: number
+  did: string
+  moderator?: ToolsOzoneTeamDefs.Member
+  queue: QueueView
+  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/queue/deleteQueue.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'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.queue.deleteQueue'
+
+export type QueryParams = {}
+
+export interface InputSchema {
+  /** ID of the queue to delete */
+  queueId: number
+  /** Optional: migrate all reports to this queue. If not specified, reports will be set to unassigned (-1). */
+  migrateToQueueId?: number
+}
+
+export interface OutputSchema {
+  deleted: boolean
+  /** Number of reports that were migrated (if migration occurred) */
+  reportsMigrated?: 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
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess

package/src/lexicon/types/tools/ozone/queue/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 ToolsOzoneQueueDefs from './defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.queue.getAssignments'
+
+export type QueryParams = {
+  /** When true, only returns active assignments. */
+  onlyActive: boolean
+  /** If specified, returns assignments for these queues only. */
+  queueIds?: 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: ToolsOzoneQueueDefs.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/queue/listQueues.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 ToolsOzoneQueueDefs from './defs.js'
+
+const is$typed = _is$typed,
+  validate = _validate
+const id = 'tools.ozone.queue.listQueues'
+
+export type QueryParams = {
+  /** Filter by enabled status. If not specified, returns all queues. */
+  enabled?: boolean
+  /** Filter queues that handle this subject type ('account' or 'record'). */
+  subjectType?: string
+  /** Filter queues by collection name (e.g. 'app.bsky.feed.post'). */
+  collection?: string
+  /** Filter queues that handle any of these report reason types. */
+  reportTypes?: string[]
+  limit: number
+  cursor?: string
+}
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  cursor?: string
+  queues: ToolsOzoneQueueDefs.QueueView[]
+}
+
+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/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