pages/packages/api-client/src/modules/labrinth/projects/v3.ts

import { AbstractModule } from '../../../core/abstract-module'
import { ModrinthApiError } from '../../../core/errors'
import type { Labrinth } from '../types'

export class LabrinthProjectsV3Module extends AbstractModule {
	public getModuleID(): string {
		return 'labrinth_projects_v3'
	}

	/**
	 * Get a project by ID or slug (v3)
	 *
	 * @param id - Project ID or slug (e.g., 'sodium' or 'AANobbMI')
	 * @returns Promise resolving to the v3 project data
	 *
	 * @example
	 * ```typescript
	 * const project = await client.labrinth.projects_v3.get('sodium')
	 * console.log(project.project_types) // v3 field
	 * ```
	 */
	public async get(id: string): Promise<Labrinth.Projects.v3.Project> {
		return this.client.request<Labrinth.Projects.v3.Project>(`/project/${id}`, {
			api: 'labrinth',
			version: 3,
			method: 'GET',
		})
	}

	/**
	 * Get multiple projects by IDs (v3)
	 *
	 * @param ids - Array of project IDs or slugs
	 * @returns Promise resolving to array of v3 projects
	 *
	 * @example
	 * ```typescript
	 * const projects = await client.labrinth.projects_v3.getMultiple(['sodium', 'lithium'])
	 * ```
	 */
	public async getMultiple(ids: string[]): Promise<Labrinth.Projects.v3.Project[]> {
		return this.client.request<Labrinth.Projects.v3.Project[]>(`/projects`, {
			api: 'labrinth',
			version: 3,
			method: 'GET',
			params: { ids: JSON.stringify(ids) },
		})
	}

	/**
	 * Edit a project (v3)
	 *
	 * @param id - Project ID or slug
	 * @param data - Project update data (v3 fields)
	 *
	 * @example
	 * ```typescript
	 * await client.labrinth.projects_v3.edit('sodium', {
	 *   environment: 'client_and_server'
	 * })
	 * ```
	 */
	public async edit(id: string, data: Labrinth.Projects.v3.EditProjectRequest): Promise<void> {
		return this.client.request(`/project/${id}`, {
			api: 'labrinth',
			version: 3,
			method: 'PATCH',
			body: data,
		})
	}

	/**
	 * Get the organization that owns a project
	 *
	 * @param id - Project ID or slug
	 * @returns Promise resolving to the organization data, or null if the project is not owned by an organization
	 */
	public async getOrganization(id: string): Promise<Labrinth.Projects.v3.Organization | null> {
		try {
			return await this.client.request<Labrinth.Projects.v3.Organization>(
				`/project/${id}/organization`,
				{ api: 'labrinth', version: 3, method: 'GET' },
			)
		} catch (error) {
			// 404 means the project is not owned by an organization
			if (error instanceof ModrinthApiError && error.statusCode === 404) {
				return null
			}
			throw error
		}
	}

	/**
	 * Get the team members of a project
	 *
	 * @param id - Project ID or slug
	 * @returns Promise resolving to an array of team members
	 */
	public async getMembers(id: string): Promise<Labrinth.Projects.v3.TeamMember[]> {
		return this.client.request<Labrinth.Projects.v3.TeamMember[]>(`/project/${id}/members`, {
			api: 'labrinth',
			version: 3,
			method: 'GET',
		})
	}
}