AstralRinth/packages/api-client/src/modules/kyros/files/v0.ts

import { AbstractModule } from '../../../core/abstract-module'
import type { UploadHandle, UploadProgress } from '../../../types/upload'
import type { Archon } from '../../archon/types'
import type { Kyros } from '../types'

type NodeFsAuth = Pick<Archon.Servers.v0.JWTAuth, 'url' | 'token'>

export class KyrosFilesV0Module extends AbstractModule {
	public getModuleID(): string {
		return 'kyros_files_v0'
	}

	private getNodeBaseUrl(auth: NodeFsAuth): string {
		return `https://${auth.url.replace(/\/modrinth\/v\d+\/fs\/?$/, '')}`
	}

	/**
	 * List directory contents with pagination
	 *
	 * @param path - Directory path (e.g., "/")
	 * @param page - Page number (1-indexed)
	 * @param pageSize - Items per page
	 * @returns Directory listing with items and pagination info
	 */
	public async listDirectory(
		path: string,
		page: number = 1,
		pageSize: number = 100,
	): Promise<Kyros.Files.v0.DirectoryResponse> {
		return this.client.request<Kyros.Files.v0.DirectoryResponse>('/fs/list', {
			api: '',
			version: 'modrinth/v0',
			method: 'GET',
			params: { path, page, page_size: pageSize },
			useNodeAuth: true,
		})
	}

	/**
	 * Create a file or directory
	 *
	 * @param path - Path for new item (e.g., "/new-folder")
	 * @param type - Type of item to create
	 */
	public async createFileOrFolder(path: string, type: 'file' | 'directory'): Promise<void> {
		return this.client.request<void>('/fs/create', {
			api: '',
			version: 'modrinth/v0',
			method: 'POST',
			params: { path, type },
			headers: { 'Content-Type': 'application/octet-stream' },
			useNodeAuth: true,
		})
	}

	/**
	 * Download a file from a server's filesystem
	 *
	 * @param path - File path (e.g., "/server-icon-original.png")
	 * @returns Promise resolving to file Blob
	 */
	public async downloadFile(path: string): Promise<Blob> {
		return this.client.request<Blob>('/fs/download', {
			api: '',
			version: 'modrinth/v0',
			method: 'GET',
			params: { path },
			useNodeAuth: true,
		})
	}

	/**
	 * Download a file using explicit filesystem auth credentials.
	 *
	 * @param auth - Filesystem auth (url + token) from Archon
	 * @param path - File path (e.g., "/server-icon.png")
	 * @returns Promise resolving to file Blob
	 */
	public async downloadFileWithAuth(auth: NodeFsAuth, path: string): Promise<Blob> {
		return this.client.request<Blob>('/fs/download', {
			api: this.getNodeBaseUrl(auth),
			version: 'modrinth/v0',
			method: 'GET',
			params: { path },
			headers: { Authorization: `Bearer ${auth.token}` },
			skipAuth: true,
		})
	}

	/**
	 * Upload a file to a server's filesystem with progress tracking
	 *
	 * @param path - Destination path (e.g., "/server-icon.png")
	 * @param file - File to upload
	 * @param options - Optional progress callback and feature overrides
	 * @returns UploadHandle with promise, onProgress, and cancel
	 * @deprecated Use `kyros.upload_sessions_v1` for bulk uploads so cancellation can remove staged files before finalize.
	 */
	public uploadFile(
		path: string,
		file: File | Blob,
		options?: {
			onProgress?: (progress: UploadProgress) => void
			retry?: boolean | number
		},
	): UploadHandle<void> {
		return this.client.upload<void>('/fs/create', {
			api: '',
			version: 'modrinth/v0',
			file,
			params: { path, type: 'file' },
			onProgress: options?.onProgress,
			retry: options?.retry,
			useNodeAuth: true,
		})
	}

	/**
	 * Upload a file using explicit filesystem auth credentials.
	 *
	 * @param auth - Filesystem auth (url + token) from Archon
	 * @param path - Destination path (e.g., "/server-icon.png")
	 * @param file - File to upload
	 * @param options - Optional progress callback and feature overrides
	 * @returns UploadHandle with promise, onProgress, and cancel
	 */
	public uploadFileWithAuth(
		auth: NodeFsAuth,
		path: string,
		file: File | Blob,
		options?: {
			onProgress?: (progress: UploadProgress) => void
			retry?: boolean | number
		},
	): UploadHandle<void> {
		return this.client.upload<void>('/fs/create', {
			api: this.getNodeBaseUrl(auth),
			version: 'modrinth/v0',
			file,
			params: { path, type: 'file' },
			headers: { Authorization: `Bearer ${auth.token}` },
			onProgress: options?.onProgress,
			retry: options?.retry,
			skipAuth: true,
		})
	}

	/**
	 * Update file contents
	 *
	 * @param path - File path to update
	 * @param content - New file content (string or Blob)
	 */
	public async updateFile(path: string, content: string | Blob): Promise<void> {
		const blob = typeof content === 'string' ? new Blob([content]) : content

		return this.client.request<void>('/fs/update', {
			api: '',
			version: 'modrinth/v0',
			method: 'PUT',
			params: { path },
			body: blob,
			headers: { 'Content-Type': 'application/octet-stream' },
			useNodeAuth: true,
		})
	}

	/**
	 * Move a file or folder to a new location
	 *
	 * @param sourcePath - Current path
	 * @param destPath - New path
	 */
	public async moveFileOrFolder(sourcePath: string, destPath: string): Promise<void> {
		return this.client.request<void>('/fs/move', {
			api: '',
			version: 'modrinth/v0',
			method: 'POST',
			body: { source: sourcePath, destination: destPath },
			useNodeAuth: true,
		})
	}

	/**
	 * Rename a file or folder (convenience wrapper around move)
	 *
	 * @param path - Current file/folder path
	 * @param newName - New name (not full path)
	 */
	public async renameFileOrFolder(path: string, newName: string): Promise<void> {
		const newPath = path.split('/').slice(0, -1).join('/') + '/' + newName
		return this.moveFileOrFolder(path, newPath)
	}

	/**
	 * Delete a file or folder
	 *
	 * @param path - Path to delete
	 * @param recursive - If true, delete directory contents recursively
	 */
	public async deleteFileOrFolder(path: string, recursive: boolean): Promise<void> {
		return this.client.request<void>('/fs/delete', {
			api: '',
			version: 'modrinth/v0',
			method: 'DELETE',
			params: { path, recursive },
			useNodeAuth: true,
		})
	}

	/**
	 * Delete a file or folder using explicit filesystem auth credentials.
	 *
	 * @param auth - Filesystem auth (url + token) from Archon
	 * @param path - Path to delete
	 * @param recursive - If true, delete directory contents recursively
	 */
	public async deleteFileOrFolderWithAuth(
		auth: NodeFsAuth,
		path: string,
		recursive: boolean,
	): Promise<void> {
		return this.client.request<void>('/fs/delete', {
			api: this.getNodeBaseUrl(auth),
			version: 'modrinth/v0',
			method: 'DELETE',
			params: { path, recursive },
			headers: { Authorization: `Bearer ${auth.token}` },
			skipAuth: true,
		})
	}

	/**
	 * Extract an archive file (zip, tar, etc.)
	 *
	 * Uses v1 API endpoint.
	 *
	 * @param path - Path to archive file
	 * @param override - If true, overwrite existing files
	 * @param dry - If true, perform dry run (returns conflicts without extracting)
	 * @returns Extract result with modpack name and conflicting files
	 */
	public async extractFile(
		path: string,
		override: boolean = true,
		dry: boolean = false,
	): Promise<Kyros.Files.v0.ExtractResult> {
		return this.client.request<Kyros.Files.v0.ExtractResult>('/fs/unarchive', {
			api: '',
			version: 'v1',
			method: 'POST',
			params: { src: path, trg: '/', override, dry },
			useNodeAuth: true,
		})
	}

	/**
	 * Modify a filesystem operation (dismiss or cancel)
	 *
	 * Uses v1 API endpoint.
	 *
	 * @param opId - Operation ID (UUID)
	 * @param action - Action to perform
	 */
	public async modifyOperation(opId: string, action: 'dismiss' | 'cancel'): Promise<void> {
		return this.client.request<void>(`/fs/ops/${action}`, {
			api: '',
			version: 'v1',
			method: 'POST',
			params: { id: opId },
			useNodeAuth: true,
		})
	}
}