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

import type { AbstractModrinthClient } from '../core/abstract-client'
import type { AbstractModule } from '../core/abstract-module'
import { ArchonActionsV1Module } from './archon/actions/v1'
import { ArchonBackupsV1Module } from './archon/backups/v1'
import { ArchonBackupsQueueV1Module } from './archon/backups-queue/v1'
import { ArchonContentV1Module } from './archon/content/v1'
import { ArchonNodesInternalModule } from './archon/nodes/internal'
import { ArchonNoticesV0Module } from './archon/notices/v0'
import { ArchonOptionsV1Module } from './archon/options/v1'
import { ArchonPropertiesV1Module } from './archon/properties/v1'
import { ArchonServerUsersV1Module } from './archon/server-users/v1'
import { ArchonServersV0Module } from './archon/servers/v0'
import { ArchonServersV1Module } from './archon/servers/v1'
import { ArchonTransfersInternalModule } from './archon/transfers/internal'
import { ISO3166Module } from './iso3166'
import { KyrosContentV1Module } from './kyros/content/v1'
import { KyrosFilesV0Module } from './kyros/files/v0'
import { KyrosLogsV1Module } from './kyros/logs/v1'
import { KyrosUploadSessionsV1Module } from './kyros/upload-sessions/v1'
import { LabrinthVersionsV2Module, LabrinthVersionsV3Module } from './labrinth'
import { LabrinthAffiliateInternalModule } from './labrinth/affiliate/internal'
import { LabrinthAnalyticsV3Module } from './labrinth/analytics/v3'
import { LabrinthAttributionInternalModule } from './labrinth/attribution/internal'
import { LabrinthAuthInternalModule } from './labrinth/auth/internal'
import { LabrinthAuthV2Module } from './labrinth/auth/v2'
import { LabrinthBillingInternalModule } from './labrinth/billing/internal'
import { LabrinthCampaignInternalModule } from './labrinth/campaign/internal'
import { LabrinthCollectionsModule } from './labrinth/collections'
import { LabrinthContentV3Module } from './labrinth/content/v3'
import { LabrinthExternalProjectsInternalModule } from './labrinth/external-projects/internal'
import { LabrinthFriendsV3Module } from './labrinth/friends/v3'
import { LabrinthGlobalsInternalModule } from './labrinth/globals/internal'
import { LabrinthImagesV3Module } from './labrinth/images/v3'
import { LabrinthLimitsV3Module } from './labrinth/limits/v3'
import { LabrinthModerationInternalModule } from './labrinth/moderation/internal'
import { LabrinthNotificationsV2Module } from './labrinth/notifications/v2'
import { LabrinthOAuthInternalModule } from './labrinth/oauth/internal'
import { LabrinthOrganizationsV3Module } from './labrinth/organizations/v3'
import { LabrinthPatsV2Module } from './labrinth/pats/v2'
import { LabrinthPayoutV3Module } from './labrinth/payout/v3'
import { LabrinthPayoutsV3Module } from './labrinth/payouts/v3'
import { LabrinthProjectsV2Module } from './labrinth/projects/v2'
import { LabrinthProjectsV3Module } from './labrinth/projects/v3'
import { LabrinthReportsV3Module } from './labrinth/reports/v3'
import { LabrinthServerPingInternalModule } from './labrinth/server-ping/internal'
import { LabrinthSessionsV2Module } from './labrinth/sessions/v2'
import { LabrinthStateModule } from './labrinth/state'
import { LabrinthTagsV2Module } from './labrinth/tags/v2'
import { LabrinthTeamsV2Module } from './labrinth/teams/v2'
import { LabrinthTeamsV3Module } from './labrinth/teams/v3'
import { LabrinthTechReviewInternalModule } from './labrinth/tech-review/internal'
import { LabrinthThreadsV3Module } from './labrinth/threads/v3'
import { LabrinthUsersV2Module } from './labrinth/users/v2'
import { LabrinthUsersV3Module } from './labrinth/users/v3'
import { LauncherMetaManifestV0Module } from './launcher-meta/v0'
import { MclogsInsightsV1Module } from './mclogs/insights/v1'
import { MclogsLogsV1Module } from './mclogs/logs/v1'
import { PaperVersionsV3Module } from './paper/v3'
import { PurpurVersionsV2Module } from './purpur/v2'

type ModuleConstructor = new (client: AbstractModrinthClient) => AbstractModule

/**
 * To add a new module:
 * 1. Create your module class extending AbstractModule
 * 2. Add one line here: `<api>_<module>: YourModuleClass`
 *
 * TypeScript will automatically infer the client's field structure from this registry.
 *
 * TODO: Better way? Probably not
 */
export const MODULE_REGISTRY = {
	archon_actions_v1: ArchonActionsV1Module,
	archon_backups_queue_v1: ArchonBackupsQueueV1Module,
	archon_backups_v1: ArchonBackupsV1Module,
	archon_content_v1: ArchonContentV1Module,
	archon_nodes_internal: ArchonNodesInternalModule,
	archon_notices_v0: ArchonNoticesV0Module,
	archon_options_v1: ArchonOptionsV1Module,
	archon_properties_v1: ArchonPropertiesV1Module,
	archon_server_users_v1: ArchonServerUsersV1Module,
	archon_servers_v0: ArchonServersV0Module,
	archon_servers_v1: ArchonServersV1Module,
	archon_transfers_internal: ArchonTransfersInternalModule,
	iso3166_data: ISO3166Module,
	mclogs_insights_v1: MclogsInsightsV1Module,
	mclogs_logs_v1: MclogsLogsV1Module,
	launchermeta_manifest_v0: LauncherMetaManifestV0Module,
	kyros_content_v1: KyrosContentV1Module,
	kyros_files_v0: KyrosFilesV0Module,
	kyros_logs_v1: KyrosLogsV1Module,
	kyros_upload_sessions_v1: KyrosUploadSessionsV1Module,
	labrinth_affiliate_internal: LabrinthAffiliateInternalModule,
	labrinth_analytics_v3: LabrinthAnalyticsV3Module,
	labrinth_auth_internal: LabrinthAuthInternalModule,
	labrinth_auth_v2: LabrinthAuthV2Module,
	labrinth_attribution_internal: LabrinthAttributionInternalModule,
	labrinth_billing_internal: LabrinthBillingInternalModule,
	labrinth_campaign_internal: LabrinthCampaignInternalModule,
	labrinth_collections: LabrinthCollectionsModule,
	labrinth_content_v3: LabrinthContentV3Module,
	labrinth_external_projects_internal: LabrinthExternalProjectsInternalModule,
	labrinth_friends_v3: LabrinthFriendsV3Module,
	labrinth_globals_internal: LabrinthGlobalsInternalModule,
	labrinth_images_v3: LabrinthImagesV3Module,
	labrinth_moderation_internal: LabrinthModerationInternalModule,
	labrinth_notifications_v2: LabrinthNotificationsV2Module,
	labrinth_oauth_internal: LabrinthOAuthInternalModule,
	labrinth_organizations_v3: LabrinthOrganizationsV3Module,
	labrinth_pats_v2: LabrinthPatsV2Module,
	labrinth_limits_v3: LabrinthLimitsV3Module,
	labrinth_payout_v3: LabrinthPayoutV3Module,
	labrinth_payouts_v3: LabrinthPayoutsV3Module,
	labrinth_projects_v2: LabrinthProjectsV2Module,
	labrinth_projects_v3: LabrinthProjectsV3Module,
	labrinth_reports_v3: LabrinthReportsV3Module,
	labrinth_server_ping_internal: LabrinthServerPingInternalModule,
	labrinth_sessions_v2: LabrinthSessionsV2Module,
	labrinth_state: LabrinthStateModule,
	labrinth_tags_v2: LabrinthTagsV2Module,
	labrinth_teams_v2: LabrinthTeamsV2Module,
	labrinth_teams_v3: LabrinthTeamsV3Module,
	labrinth_tech_review_internal: LabrinthTechReviewInternalModule,
	labrinth_threads_v3: LabrinthThreadsV3Module,
	labrinth_users_v2: LabrinthUsersV2Module,
	labrinth_users_v3: LabrinthUsersV3Module,
	labrinth_versions_v2: LabrinthVersionsV2Module,
	labrinth_versions_v3: LabrinthVersionsV3Module,
	paper_versions_v3: PaperVersionsV3Module,
	purpur_versions_v2: PurpurVersionsV2Module,
} as const satisfies Record<string, ModuleConstructor>

export type ModuleID = keyof typeof MODULE_REGISTRY

/**
 * Parse a module ID into [api, moduleName] tuple
 *
 * @param id - Module ID in format `<api>_<module>` (e.g., 'labrinth_projects_v2')
 * @returns Tuple of [api, moduleName] (e.g., ['labrinth', 'projects_v2'])
 * @throws Error if module ID doesn't match expected format
 */
export function parseModuleID(id: string): [string, string] {
	const parts = id.split('_')
	if (parts.length < 2) {
		throw new Error(
			`Invalid module ID "${id}". Expected format: <api>_<module> (e.g., "labrinth_projects_v2")`,
		)
	}
	const api = parts[0]
	const moduleName = parts.slice(1).join('_')
	return [api, moduleName]
}

/**
 * Build nested module structure from flat registry
 *
 * Transforms:
 * ```
 * { labrinth_projects_v2: Constructor, labrinth_users_v2: Constructor }
 * ```
 * Into:
 * ```
 * { labrinth: { projects_v2: Constructor, users_v2: Constructor } }
 * ```
 *
 * @returns Nested structure organized by API namespace
 */
export function buildModuleStructure(): Record<string, Record<string, ModuleConstructor>> {
	const structure: Record<string, Record<string, ModuleConstructor>> = {}

	for (const [id, constructor] of Object.entries(MODULE_REGISTRY)) {
		const [api, moduleName] = parseModuleID(id)

		if (!structure[api]) {
			structure[api] = {}
		}

		structure[api][moduleName] = constructor
	}

	return structure
}

/**
 * Extract API name from module ID
 * @example ParseAPI<'labrinth_projects_v2'> = 'labrinth'
 */
type ParseAPI<T extends string> = T extends `${infer API}_${string}` ? API : never

/**
 * Extract module name for a given API
 * @example ParseModule<'labrinth_projects_v2', 'labrinth'> = 'projects_v2'
 */
type ParseModule<T extends string, API extends string> = T extends `${API}_${infer Module}`
	? Module
	: never

/**
 * Group registry modules by API namespace
 *
 * Transforms flat registry into nested structure at the type level:
 * ```
 * { labrinth_projects_v2: ModuleClass } → { labrinth: { projects_v2: ModuleInstance } }
 * ```
 */
type GroupByAPI<Registry extends Record<string, ModuleConstructor>> = {
	[API in ParseAPI<keyof Registry & string>]: {
		[Module in ParseModule<keyof Registry & string, API>]: InstanceType<
			Registry[`${API}_${Module}`]
		>
	}
}

/**
 * Inferred client module structure
 **/
export type InferredClientModules = GroupByAPI<typeof MODULE_REGISTRY>