feat: api-client module for tech review

Author: IMB11

packages/api-client/src/modules/index.ts

@@ -8,6 +8,7 @@ import { LabrinthBillingInternalModule } from './labrinth/billing/internal'
 import { LabrinthProjectsV2Module } from './labrinth/projects/v2'
 import { LabrinthProjectsV3Module } from './labrinth/projects/v3'
 import { LabrinthStateModule } from './labrinth/state'
+import { LabrinthTechReviewInternalModule } from './labrinth/tech-review/internal'
 
 type ModuleConstructor = new (client: AbstractModrinthClient) => AbstractModule
 
@@ -29,6 +30,7 @@ export const MODULE_REGISTRY = {
 	labrinth_projects_v2: LabrinthProjectsV2Module,
 	labrinth_projects_v3: LabrinthProjectsV3Module,
 	labrinth_state: LabrinthStateModule,
+	labrinth_tech_review_internal: LabrinthTechReviewInternalModule,
 } as const satisfies Record<string, ModuleConstructor>
 
 export type ModuleID = keyof typeof MODULE_REGISTRY

packages/api-client/src/modules/labrinth/index.ts

@@ -2,3 +2,4 @@ export * from './billing/internal'
 export * from './projects/v2'
 export * from './projects/v3'
 export * from './state'
+export * from './tech-review/internal'

packages/api-client/src/modules/labrinth/tech-review/internal.ts

@@ -0,0 +1,72 @@
+import { AbstractModule } from '../../../core/abstract-module'
+import type { Labrinth } from '../types'
+
+export class LabrinthTechReviewInternalModule extends AbstractModule {
+	public getModuleID(): string {
+		return 'labrinth_tech_review_internal'
+	}
+
+	/**
+	 * Search for projects awaiting technical review.
+	 *
+	 * Returns a list of projects that have been flagged for technical review,
+	 * along with their associated reports, ownership information, and moderation threads.
+	 *
+	 * @param params - Search parameters including pagination, filters, and sorting
+	 * @returns Array of projects with their technical review details
+	 *
+	 * @example
+	 * ```typescript
+	 * const reviews = await client.labrinth.tech_review_internal.searchProjects({
+	 *   limit: 20,
+	 *   page: 0,
+	 *   sort_by: 'CreatedAsc',
+	 *   filter: {
+	 *     project_type: ['mod', 'modpack']
+	 *   }
+	 * })
+	 * ```
+	 */
+	public async searchProjects(
+		params: Labrinth.TechReview.Internal.SearchProjectsRequest,
+	): Promise<Labrinth.TechReview.Internal.ProjectReview[]> {
+		return this.client.request<Labrinth.TechReview.Internal.ProjectReview[]>(
+			'/moderation/tech-review/search',
+			{
+				api: 'labrinth',
+				version: 'internal',
+				method: 'POST',
+				body: params,
+			},
+		)
+	}
+
+	/**
+	 * Update the status of a technical review issue.
+	 *
+	 * Allows moderators to mark an issue as safe (false positive), unsafe (malicious),
+	 * or leave it as pending for further review.
+	 *
+	 * @param issueId - The ID of the issue to update
+	 * @param data - The new status for the issue
+	 * @returns Promise that resolves when the update is complete
+	 *
+	 * @example
+	 * ```typescript
+	 * await client.labrinth.tech_review_internal.updateIssue('issue-123', {
+	 *   status: 'safe'
+	 * })
+	 * ```
+	 */
+	public async updateIssue(
+		issueId: string,
+		data: Labrinth.TechReview.Internal.UpdateIssueRequest,
+	): Promise<void> {
+		return this.client.request<void>(`/moderation/tech-review/issue/${issueId}`, {
+			api: 'labrinth',
+			version: 'internal',
+			method: 'POST',
+			body: data,
+		})
+	}
+}

packages/api-client/src/modules/labrinth/types.ts

@@ -450,4 +450,122 @@ export namespace Labrinth {
 			errors: unknown[]
 		}
 	}
+
+	export namespace TechReview {
+		export namespace Internal {
+			export type SearchProjectsRequest = {
+				limit?: number
+				page?: number
+				filter?: SearchProjectsFilter
+				sort_by?: SearchProjectsSort
+			}
+
+			export type SearchProjectsFilter = {
+				project_type?: string[]
+			}
+
+			export type SearchProjectsSort = 'CreatedAsc' | 'CreatedDesc'
+
+			export type UpdateIssueRequest = {
+				status: DelphiReportIssueStatus
+			}
+
+			export type ProjectReview = {
+				project: Projects.v3.Project
+				project_owner: Ownership
+				thread: DBThread
+				reports: ProjectReport[]
+			}
+
+			export type ProjectReport = {
+				created_at: string
+				flag_reason: FlagReason
+				severity: DelphiSeverity
+				files: FileReview[]
+			}
+
+			export type FileReview = {
+				file_name: string
+				file_size: number
+				issues: FileIssue[]
+			}
+
+			export type FileIssue = {
+				issue_id: string
+				kind: string
+				status: DelphiReportIssueStatus
+				details: FileIssueDetail[]
+			}
+
+			export type FileIssueDetail = {
+				class_name: string
+				decompiled_source: string
+				severity: DelphiSeverity
+			}
+
+			export type Ownership =
+				| {
+						kind: 'user'
+						id: string
+						name: string
+						icon_url?: string
+				  }
+				| {
+						kind: 'organization'
+						id: string
+						name: string
+						icon_url?: string
+				  }
+
+			export type DBThread = {
+				id: string
+				project_id?: string
+				report_id?: string
+				type_: ThreadType
+				messages: DBThreadMessage[]
+				members: string[]
+			}
+
+			export type DBThreadMessage = {
+				id: string
+				thread_id: string
+				author_id?: string
+				body: MessageBody
+				created: string
+				hide_identity: boolean
+			}
+
+			export type MessageBody =
+				| {
+						type: 'text'
+						body: string
+						private?: boolean
+						replying_to?: string
+						associated_images?: string[]
+				  }
+				| {
+						type: 'status_change'
+						new_status: Projects.v2.ProjectStatus
+						old_status: Projects.v2.ProjectStatus
+				  }
+				| {
+						type: 'thread_closure'
+				  }
+				| {
+						type: 'thread_reopen'
+				  }
+				| {
+						type: 'deleted'
+						private?: boolean
+				  }
+
+			export type ThreadType = 'report' | 'project' | 'direct_message'
+
+			export type FlagReason = 'delphi'
+
+			export type DelphiSeverity = 'LOW' | 'MEDIUM' | 'HIGH' | 'SEVERE'
+
+			export type DelphiReportIssueStatus = 'pending' | 'safe' | 'unsafe'
+		}
+	}
 }