import { invoke } from "@tauri-apps/api/core"; export const REMOTE_CLIENT_ID = "@remote-client"; export interface RemoteConnection { host: string; client_path: string | null } export type Classification = "healthy" | "partial" | "unknown-custom" | "incompatible"; export type ItemStatus = "found" | "missing" | "attention"; export interface ScanItem { key: string; label: string; status: ItemStatus; detail: string | null; } export interface ExeInfo { size: number; sha256: string; matches_release: boolean | null; } export interface ScanReport { path: string; classification: Classification; items: ScanItem[]; worldserver: ExeInfo | null; authserver: ExeInfo | null; banner_revision: string | null; bot_config_keys: number; client: { path: string; executable: string } | null; notes: string[]; /** the repack's main folder when the chosen folder is part of it */ suggested_path?: string | null; hint?: "not-repack" | null; modifies_files: boolean; } export type ServiceState = "stopped" | "starting" | "running" | "stopping" | "crashed" | "updating" | "unknown"; export interface ServiceStatus { name: string; state: ServiceState; pid: number | null; port: number; port_ready: boolean; conflict: { port: number; pid: number; exe: string | null } | null; uptime_secs: number | null; } export interface StatusView { observed: { mysql: ServiceStatus; auth: ServiceStatus; world: ServiceStatus; secondary_world?: ServiceStatus | null }; busy: boolean; path_exists: boolean; } export type RealmMode = "coa" | "wildcard" | "reborn"; export interface RealmProfiles { active: RealmMode; wildcard_created: boolean; reborn_created: boolean; reborn_supported: boolean; supported: boolean; recovery_pending: boolean; simultaneous: boolean; secondary_world_port: number | null; secondary_running: boolean } export interface DatabaseCheck { realm: RealmMode; migrations: { id: string; db: string; status: "applied" | "pending" | "failed"; error: string | null }[]; problems: { database: string; table: string; column: string; detail: string }[]; full_schema: boolean; } export interface RepairReport { restored: string[]; applied: string[]; backup: string; database: DatabaseCheck[]; error: string | null } export interface Human { code: string; title: string; message: string; actions: string[]; } export interface DriverOutcome { ok: boolean; exit_code: number | null; code: string | null; human: Human | null; output: string; } export interface DashboardStatus { installed: boolean; tag: string | null; squid_tag: string | null; matches: boolean; running: boolean; port: number; url: string; } export interface BackupLocation { path: string; default_path: string; is_default: boolean; } export interface ServerSummary { id: string; name: string; path: string; } export interface FieldError { key: string; message: string; } export interface UiError { human: Human; technical: string; fields?: FieldError[]; } export type Scope = "bots" | "server"; export type Restart = "runtime" | "world" | "full"; export type JsonValue = string | number | boolean; export interface Setting { key: string; type: "bool" | "int" | "float" | "string" | "enum"; category: string; title: string; description: string; default: JsonValue; min?: number; max?: number; options: { value: JsonValue; label: string }[]; unit?: string | null; advanced: boolean; restartRequired: Restart; dangerous: boolean; } export interface SettingView extends Setting { value: JsonValue; is_default: boolean; present: boolean; problem: string | null; drift: boolean; } export interface SettingsView { scope: Scope; categories: { id: string; title: string }[]; settings: SettingView[]; unknown_keys: number; drift_keys: string[]; files: string[]; } export interface PresetInfo { id: string; title: string; description: string; } export interface PresetChange { key: string; title: string; from: JsonValue; to: JsonValue; dangerous: boolean; } export interface PresetPreview { id: string; title: string; description: string; changes: PresetChange[]; } export interface SaveReport { changed: { key: string; title: string; restart: Restart; dangerous: boolean }[]; restart: Restart | null; snapshot: string | null; } export type BackupKind = "quick" | "full" | "config" | "database"; export interface RecoveryPoint { realm?: RealmMode; schema: number; id: string; kind: BackupKind; trigger: string; label: string | null; created_at: string; components: { name: string; path: string; bytes: number; tables: number | null; files: string[] | null }[]; mysql_snapshot?: { bytes: number } | null; } export interface DbRestore { previous_schema: string; safety_backup: string; tables_restored: number; } export interface Preflight { ok: boolean; problems: { code: string; message: string }[]; free_bytes: number; } export interface RealmProfile { id: string; name: string; data: string; } export interface ModuleView { id: string; name: string; version?: string | null; description: Record; repo: string; /** the module is part of this server build (its configuration exists) */ installed: boolean; has_settings: boolean; enabled: boolean; /** can be turned on and off (a part the game client needs is only configured) */ switchable: boolean; /** soon (planned, not available yet), early (experimental), beta (still being tested) or release (stable) */ status: "soon" | "early" | "beta" | "release"; icon: string; /** a page of the Manager that is hidden while the module is off */ page: string | null; /** not shown on the Modules page */ hidden: boolean; compatibility?: "compatible" | "experimental" | "unsupported"; } export interface ModuleSetting { key: string; value: string; default: string | null; doc: string; field?: { key: string; type: string; title: string; description: string; group: string; group_title?: string | null; min?: number | null; max?: number | null; choices?: { value: string | number | boolean; label: string }[] | null } | null; } export interface AllSetting { key: string; value: string; default: string; doc: string; /** the configuration sets it to something other than the documented default */ changed: boolean; } export interface ReportContext { manager_version: string; windows: string; install_kind: "new" | "imported"; server_version: string | null; /** where the form starts: the bot system that is switched on, else the Manager */ suggested_target: ReportTargetId; /** the release of the bot system that is on */ bots_version: string | null; } export type ReportTargetId = "manager" | "companions" | "squid"; /** A place a problem report can go: its GitHub repository as `owner/name`. */ export interface ReportTarget { id: ReportTargetId; repo: string; ours: boolean; } /** The kind of server this computer installs: a repack (Windows) or Docker containers (Linux). */ export type Flavor = "repack" | "docker"; export interface InstallEnvironment { flavor: Flavor; default_dir: string; /** Why Docker cannot be used, in its own words; null when it works. */ docker_problem: string | null; } export interface InstallRequirements { download_bytes: number; unpacked_bytes: number; version: string; } export interface AccountInfo { id: number; name: string; /** 0 player, 1 moderator, 2 game master, 3 administrator */ access: number; online: boolean; last_login: string | null; characters: number; } export interface InstallStep { step: string; percent: number; detail: string | null; } export interface UpdatePlanItem { path: string; action: "create" | "replace" | "merge-config" | "skip" | "conflict"; reason: string | null; } export interface UpdatePreview { from_version: string | null; to_version: string; latest_version?: string; items: UpdatePlanItem[]; conflicts: string[]; migrations: number; pending_migrations?: number; download_bytes: number; /** False when pending database changes were not counted (stopped server during a background check, or an error). */ database_checked?: boolean; /** Set when the database could not be inspected; the file comparison is still valid. */ database_check_error?: string; } export interface UpdateTxn { id: string; state: "prepared" | "applying" | "applied" | "needs-decision" | "committed" | "rolled-back" | "failed"; from_version: string | null; to_version: string; recovery_point: string | null; databases_started: boolean; message: string | null; } export interface Population { online_total: number; bots_online: number; players_online: number; bots_total: number; } export interface Performance { mean_ms: number; median_ms: number; p95_ms: number; p99_ms: number; max_ms: number; ticks_per_sec: number; } export interface CompanionSizes { hardware: { cores: number; ram_gb: number; free_ram_gb: number }; sizes: { id: string; title: string; bots: number; warning: string | null }[]; } export interface ClientInfo { path: string; executable: string; realmlists: { path: string; host: string | null }[]; addon: { installed: boolean; version: string | null; up_to_date: boolean | null }; other_addons: number; } export interface ClientStatus { linked: boolean; managed: boolean; installed_version: string | null; latest_version: string | null; latest_bytes: number | null; update_available: boolean; } export interface ClientPlan { version: string; items: { path: string; size: number; kind: "missing" | "changed" | "modified" }[]; download_bytes: number; total_files: number; up_to_date_files: number; kept_files: number; } export interface ClientStep { phase: "scan" | "download" | "finish"; done: number; total: number; bytes_per_sec: number; file: string | null; } export interface ClientDownloadCheck { needed_bytes: number; free_bytes: number; version: string; dest: string; } export type ClientPatchState = "not-installed" | "enabled" | "disabled" | "partially-installed"; export interface CustomRacesClientStatus { version: string | null; state: ClientPatchState; installedMpqs: number; totalMpqs: number; hasRootFiles: boolean; clientPath: string | null; } export interface CustomRacesProgress { id: string; step: string; percent: number; } export type FriendsMode = "local" | "lan" | "direct" | "private"; export interface LanAddress { interface: string; address: string; is_default: boolean; } export interface FriendsStatus { settings: { mode: FriendsMode; host: string | null; lan_address_override: string | null }; lan_ip: string | null; lan_addresses: LanAddress[]; exposure: { port: number; what: string; reachable_from_network: boolean; listening: boolean }[]; servers_open: boolean; /** null where there is no Windows firewall to ask about (Linux). */ firewall: { auth: boolean; world: boolean } | null; tailscale: { installed: boolean; ip: string | null; connected: boolean }; server_running: boolean; auth_port: number; world_port: number; secondary_world_port?: number | null; } export interface InternetCheck { public_ip: string | null; router_ip: string | null; reachability: "direct_possible" | "cgnat" | "unknown"; router_found: boolean; } export interface DiagCheck { id: string; title: string; level: "ok" | "warn" | "fail"; detail: string; } export type ConsoleSource = "world" | "auth" | "database" | "manager"; export interface ConsoleLine { text: string; level: "info" | "warn" | "error"; } export interface CrashItem { id: string; timestamp_ms: number; date_str: string; title: string; explanation: string; category: "assertion" | "access_violation" | "stack_overflow" | "out_of_memory" | "database" | "network" | "exception" | "generic"; exception_code?: string | null; location?: string | null; function?: string | null; condition?: string | null; preview: string; full_log: string; } export const api = { remoteConnection: () => invoke("remote_connection"), remoteConnect: (host: string) => invoke("remote_connect", { host }), realmProfiles: (id: string) => invoke("realm_profiles", { id }), realmSelect: (id: string, mode: RealmMode, restart: boolean) => invoke("realm_select", { id, mode, restart }), realmSimultaneous: (id: string, enabled: boolean) => invoke("realm_simultaneous", { id, enabled }), checkDatabase: (id: string) => invoke("check_database", { id }), repairServer: (id: string) => invoke("repair_server", { id }), defaultInstallDir: () => invoke("default_install_dir"), scan: (path: string) => invoke("scan_server", { path }), add: (path: string) => invoke("add_server", { path }), list: () => invoke("list_servers"), forget: (id: string) => invoke("forget_server", { id }), status: (id: string) => invoke("server_status", { id }), start: (id: string) => invoke("start_server", { id }), stop: (id: string) => invoke("stop_server", { id }), settings: (id: string, scope: Scope) => invoke("get_settings", { id, scope }), save: (id: string, scope: Scope, changes: Record) => invoke("save_settings", { id, scope, changes }), presets: (scope: Scope) => invoke("list_presets", { scope }), backups: (id: string) => invoke("list_backups", { id }), dashboardStatus: (id: string) => invoke("dashboard_status", { id }), dashboardInstall: (id: string) => invoke("dashboard_install", { id }), dashboardOpen: (id: string) => invoke("dashboard_open", { id }), dashboardStart: (id: string) => invoke("dashboard_start", { id }), dashboardStop: (id: string) => invoke("dashboard_stop", { id }), backupLocation: (id: string) => invoke("backup_location", { id }), /** `null` goes back to the default folder next to the server. */ setBackupLocation: (id: string, path: string | null) => invoke("set_backup_location", { id, path }), createBackup: (id: string, kind: BackupKind, label?: string) => invoke("create_backup", { id, kind, label: label ?? null }), verifyBackup: (id: string, backupId: string) => invoke<{ ok: boolean; problems: string[] }>("verify_backup", { id, backupId }), deleteBackup: (id: string, backupId: string) => invoke("delete_backup", { id, backupId }), restoreConfigs: (id: string, backupId: string) => invoke("restore_backup_configs", { id, backupId }), restoreDatabase: (id: string, backupId: string, database: string) => invoke("restore_backup_database", { id, backupId, database }), installEnvironment: () => invoke("install_environment"), /** The game data folder of a Docker server; null for a repack. */ gameDataFolder: (id: string) => invoke("game_data_folder", { id }), setGameDataFolder: (id: string, path: string) => invoke("set_game_data_folder", { id, path }), installPreflight: (dest: string, needed?: number, gameData?: string) => invoke("install_preflight", { dest, needed: needed ?? null, gameData: gameData ?? null }), installRequirements: (pkg?: string) => invoke("install_requirements", { package: pkg ?? null }), realmlistProfiles: (id: string) => invoke<{ profiles: RealmProfile[]; active: string | null }>("realmlist_profiles", { id }), realmlistSave: (id: string, profileId: string | null, name: string, data: string) => invoke("realmlist_save", { id, profileId, name, data }), realmlistDelete: (id: string, profileId: string) => invoke("realmlist_delete", { id, profileId }), realmlistActivate: (id: string, profileId: string) => invoke("realmlist_activate", { id, profileId }), modulesList: (id: string) => invoke("modules_list", { id }), moduleSetEnabled: (id: string, module: string, enabled: boolean) => invoke("module_set_enabled", { id, module, enabled }), moduleSettings: (id: string, module: string) => invoke("module_settings", { id, module }), moduleSaveSettings: (id: string, module: string, changes: Record) => invoke("module_save_settings", { id, module, changes }), allSettings: (id: string) => invoke("all_settings", { id }), allSettingsSave: (id: string, changes: Record) => invoke("all_settings_save", { id, changes }), reportContext: (id: string) => invoke("report_context", { id }), reportTargets: () => invoke("report_targets"), listAccounts: (id: string) => invoke("list_accounts", { id }), accountSetPassword: (id: string, name: string, password: string) => invoke("account_set_password", { id, name, password }), accountSetAccess: (id: string, name: string, level: number) => invoke("account_set_access", { id, name, level }), accountRename: (id: string, name: string, newName: string, password: string) => invoke("account_rename", { id, name, newName, password }), accountDelete: (id: string, name: string) => invoke("account_delete", { id, name }), installNew: (dest: string, pkg?: string, gameData?: string) => invoke("install_new", { dest, package: pkg ?? null, gameData: gameData ?? null }), cancelInstall: () => invoke("cancel_install"), createAccount: (id: string, username: string, password: string, administrator: boolean) => invoke("create_account", { id, username, password, administrator }), /** `background`: the repeating check, which must not start the database of a stopped server. */ checkUpdate: (id: string, source?: string, background?: boolean) => invoke("check_update", { id, source: source ?? null, background: background ?? false }), pendingUpdate: (id: string) => invoke("pending_update", { id }), applyUpdate: (id: string, resolutions: Record, source?: string) => invoke<{ txn: UpdateTxn }>("apply_update", { id, source: source ?? null, resolutions }), rollbackUpdate: (id: string, txn: string) => invoke("rollback_update", { id, txn }), retryUpdateValidation: (id: string, txn: string) => invoke("retry_update_validation", { id, txn }), population: (id: string) => invoke("get_population", { id }), stopSpawning: (id: string) => invoke<{ count: number }>("companions_stop_spawning", { id }), takeOffline: (id: string) => invoke<{ count: number }>("companions_take_offline", { id }), despawnSome: (id: string, count: number) => invoke<{ count: number }>("companions_despawn_some", { id, count }), deleteAllCompanions: (id: string) => invoke<{ count: number }>("companions_delete_all", { id }), openLink: (url: string) => invoke("open_link", { url }), performance: (id: string) => invoke("get_performance", { id }), companionSizes: () => invoke("companion_sizes"), addCompanions: (id: string, count: number) => invoke<{ spawned: string | null; created: number | null; baseline: number | null }>("add_companions", { id, count }), clientInfo: (id: string) => invoke("client_info", { id }), setClient: (id: string, path: string) => invoke("set_client", { id, path }), setRealmlist: (id: string, host: string) => invoke("client_realmlist", { id, host }), installAddon: (id: string) => invoke("client_install_addon", { id }), clientStatus: (id: string) => invoke("client_status", { id }), clientDownloadCheck: (parent: string) => invoke("client_download_check", { parent }), clientPlan: (id: string) => invoke("client_plan", { id }), clientSync: (id: string, keepModified: boolean) => invoke("client_sync", { id, keepModified }), clientDownload: (id: string, parent: string) => invoke("client_download", { id, parent }), clientCancel: () => invoke("client_cancel"), customRacesStatus: (id: string) => invoke("custom_races_status", { id }), customRacesUninstall: (id: string) => invoke("custom_races_uninstall", { id }), customRacesInstall: (id: string) => invoke("custom_races_install", { id }), customRacesToggleClient: (id: string, enabled: boolean) => invoke("custom_races_toggle_client", { id, enabled }), play: (id: string) => invoke("play", { id }), friendsStatus: (id: string) => invoke("friends_status", { id }), friendsCheckInternet: () => invoke("friends_check_internet"), friendsEnable: (id: string, mode: FriendsMode, host?: string, useUpnp = false, lanAddressOverride: string | null = null) => invoke<{ host: string; restart_required: boolean; note: string | null }>("friends_enable", { id, mode, host: host ?? null, useUpnp, lanAddressOverride }), friendsPackage: (id: string) => invoke("friends_package", { id }), runDiagnostics: (id: string) => invoke<{ checks: DiagCheck[]; problems: number }>("run_diagnostics", { id }), verifyFiles: (id: string) => invoke<{ path: string; kind: "missing" | "changed" }[]>("verify_files", { id }), exportDiagnostics: (id: string) => invoke("export_diagnostics", { id }), listCrashes: (id: string, limit?: number) => invoke("list_crashes", { id, limit: limit ?? null }), consoleTail: (id: string, source: ConsoleSource, filter?: string, lines = 300) => invoke("console_tail", { id, source, filter: filter ?? null, lines }), consoleRisk: (command: string) => invoke<"normal" | "dangerous">("console_risk", { command }), consoleCommand: (id: string, command: string, confirmed: boolean) => invoke("console_command", { id, command, confirmed }), previewPreset: (id: string, scope: Scope, preset: string) => invoke("preview_preset", { id, scope, preset }), }; export function asUiError(e: unknown): UiError { if (e && typeof e === "object" && "human" in e) return e as UiError; return { human: { code: "unknown", title: "Something went wrong", message: "See the technical details.", actions: ["show_details"] }, technical: String(e), }; }