modrinth/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 a project's dependencies (v3)
	 *
	 * Returns all projects and versions that are dependencies of this project's versions.
	 *
	 * @param id - Project ID or slug
	 * @returns Promise resolving to dependency data with projects and versions
	 *
	 * @example
	 * ```typescript
	 * const deps = await client.labrinth.projects_v3.getDependencies('sodium')
	 * console.log(deps.projects) // Array of project objects
	 * console.log(deps.versions) // Array of version objects
	 * ```
	 */
	public async getDependencies(id: string): Promise<Labrinth.Projects.v3.ProjectDependencies> {
		return this.client.request<Labrinth.Projects.v3.ProjectDependencies>(
			`/project/${id}/dependencies`,
			{
				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) },
		})
	}

	/**
	 * Search projects (v3)
	 *
	 * @param params - Search parameters
	 * @returns Promise resolving to v3 search results
	 */
	public async search(
		params: Labrinth.Search.SearchParams,
		options?: {
			headers?: Record<string, string>
		},
	): Promise<Labrinth.Search.v3.SearchResults> {
		return this.client.request<Labrinth.Search.v3.SearchResults>(`/search`, {
			api: 'labrinth',
			version: 3,
			method: 'GET',
			headers: options?.headers,
			params: {
				...params,
				facets: params.facets ? JSON.stringify(params.facets) : undefined,
			},
		})
	}

	/**
	 * 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',
		})
	}

	public async createServerProject(
		data: Labrinth.Projects.v3.CreateServerProjectRequest,
	): Promise<Labrinth.Projects.v3.Project> {
		return this.client.request<Labrinth.Projects.v3.Project>(`/project`, {
			api: 'labrinth',
			version: 3,
			method: 'PUT',
			body: data,
		})
	}

	/**
	 * Delete a project
	 *
	 * @param id - Project ID or slug
	 *
	 * @example
	 * ```typescript
	 * await client.labrinth.projects_v3.deleteProject('my-project')
	 * ```
	 */
	public async deleteProject(id: string): Promise<void> {
		return this.client.request(`/project/${id}`, {
			api: 'labrinth',
			version: 3,
			method: 'DELETE',
		})
	}

	/**
	 * Change the icon of a project
	 *
	 * @param id - Project ID or slug
	 * @param file - Image file to upload
	 * @param ext - File extension (e.g., 'png', 'jpeg', 'gif', 'webp')
	 *
	 * @example
	 * ```typescript
	 * await client.labrinth.projects_v3.changeIcon('sodium', imageFile, 'png')
	 * ```
	 */
	public async changeIcon(id: string, file: Blob, ext: string): Promise<void> {
		return this.client.request(`/project/${id}/icon`, {
			api: 'labrinth',
			version: 3,
			method: 'PATCH',
			params: { ext },
			body: file,
		})
	}

	/**
	 * Delete the icon of a project
	 *
	 * @param id - Project ID or slug
	 *
	 * @example
	 * ```typescript
	 * await client.labrinth.projects_v3.deleteIcon('sodium')
	 * ```
	 */
	public async deleteIcon(id: string): Promise<void> {
		return this.client.request(`/project/${id}/icon`, {
			api: 'labrinth',
			version: 3,
			method: 'DELETE',
		})
	}
}