@thomasfarineau/anvil 0.0.2 → 0.0.4

package/src/client/config.schema.json

@@ -4,13 +4,13 @@
   "title": "Anvil Launcher Config",
   "description": "Configuration file for an Anvil Minecraft launcher (config.json)",
   "type": "object",
-  "required": ["instances"],
+  "anyOf": [{ "required": ["instances"] }, { "required": ["anvil-server"] }],
   "additionalProperties": false,
   "properties": {
     "$schema": {
       "type": "string",
       "description": "JSON schema URL for validation",
-      "default": "./node_modules/anvil/src/client/config.schema.json"
+      "default": "./node_modules/@thomasfarineau/anvil/src/client/config.schema.json"
     },
     "identifier": {
       "type": "string",
@@ -48,10 +48,20 @@
     },
     "session": {
       "type": "string",
-      "enum": ["none", "mojang", "custom"],
-      "description": "Authentication mode. 'none': offline. 'custom': client calls MC.setSession() before launch.",
+      "enum": ["none", "mojang", "custom", "anvil-session"],
+      "description": "Authentication mode. 'none': offline. 'custom': client calls MC.setSession() before launch. 'anvil-session': login (username/password/2FA) handled by the anvil-server declared in 'anvil-server'.",
       "default": "none"
     },
+    "anvil-server": {
+      "type": "string",
+      "description": "Base URL of an anvil-server instance (e.g. https://mods.example.com). When set, the launcher fetches the list of enabled instances from this server at startup (the 'instances' field becomes unnecessary), and 'anvil-session' authentication is validated against it.",
+      "default": ""
+    },
+    "anvil-key": {
+      "type": "string",
+      "description": "API key generated in the anvil-server web UI (Clés API). Required to query the server: instance list, sessions and file downloads are refused without a valid key.",
+      "default": ""
+    },
     "window_decorations": {
       "type": "boolean",
       "description": "Show native window title bar and borders",
@@ -64,11 +74,11 @@
     },
     "instances": {
       "type": "array",
-      "description": "List of Minecraft instances available in the launcher",
+      "description": "List of Minecraft instances available in the launcher. Ignored (replaced) when 'anvil-server' is set: the server's enabled instances are used instead.",
       "minItems": 1,
       "items": {
         "type": "object",
-        "required": ["id", "name", "mc_version"],
+        "required": ["id"],
         "additionalProperties": false,
         "properties": {
           "id": {
@@ -105,6 +115,48 @@
             "maximum": 65535,
             "description": "Server port",
             "default": 25565
+          },
+          "mods": {
+            "type": "array",
+            "description": "Mods downloaded into this instance's mods/ folder during setup",
+            "items": {
+              "type": "object",
+              "required": ["url"],
+              "additionalProperties": false,
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "description": "Display name of the mod"
+                },
+                "url": {
+                  "type": "string",
+                  "description": "Direct download URL of the mod .jar"
+                },
+                "file_name": {
+                  "type": "string",
+                  "description": "Target file name in mods/ (defaults to the URL basename)"
+                }
+              }
+            }
+          },
+          "files": {
+            "type": "array",
+            "description": "Extra files (mod configs, options.txt…) downloaded into the instance folder during setup. Always overwritten: the source (usually an anvil-server) is authoritative.",
+            "items": {
+              "type": "object",
+              "required": ["path", "url"],
+              "additionalProperties": false,
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "description": "Relative target path inside the instance folder (e.g. \"config/mymod.toml\")"
+                },
+                "url": {
+                  "type": "string",
+                  "description": "Direct download URL of the file"
+                }
+              }
+            }
           }
         }
       }

package/src/client/index.d.ts

@@ -1,3 +1,14 @@
+export interface ModConfig {
+  url: string;
+  name?: string;
+  file_name?: string;
+}
+
+export interface FileConfig {
+  path: string;
+  url: string;
+}
+
 export interface InstanceConfig {
   id: string;
   name: string;
@@ -6,6 +17,8 @@ export interface InstanceConfig {
   loader_version: string;
   server_ip: string;
   server_port: number;
+  mods: ModConfig[];
+  files: FileConfig[];
 }
 
 export interface LauncherConfig {
@@ -16,9 +29,11 @@ export interface LauncherConfig {
   java_version: number;
   update_url: string;
   logo: string;
-  session: 'none' | 'mojang' | 'custom';
+  session: 'none' | 'mojang' | 'custom' | 'anvil-session';
   window_decorations: boolean;
   window_resizable: boolean;
+  'anvil-server': string;
+  'anvil-key': string;
   instances: InstanceConfig[];
 }
 
@@ -38,6 +53,7 @@ export interface InstanceStatus {
   id: string;
   name: string;
   installed: boolean;
+  running: boolean;
 }
 
 export interface InitStatus {
@@ -46,6 +62,14 @@ export interface InitStatus {
   instances: InstanceStatus[];
 }
 
+export interface ModInfo {
+  file_name: string;
+  name: string;
+  enabled: boolean;
+  size: number;
+  managed: boolean;
+}
+
 export interface SetupProgress {
   step: string;
   current: number;
@@ -71,20 +95,55 @@ export interface UpdateInfo {
   notes: string;
 }
 
+export interface AnvilLoginResult {
+  status: 'ok' | 'totp_required';
+  username: string;
+  uuid: string;
+}
+
 export declare const MC: {
   getConfig(): Promise<LauncherConfig>;
   getSettings(): Promise<Settings>;
   saveSettings(s: Settings): Promise<void>;
   getDefaultDir(): Promise<string>;
+  getVersion(): Promise<string>;
   getInitStatus(): Promise<InitStatus>;
   runSetup(): Promise<void>;
   verify(instanceId: string): Promise<void>;
   play(instanceId: string): Promise<void>;
+  stop(instanceId: string): Promise<void>;
+  getRunning(): Promise<string[]>;
+  isRunning(instanceId: string): Promise<boolean>;
+  mods: {
+    list(instanceId: string): Promise<ModInfo[]>;
+    add(
+      instanceId: string,
+      url: string,
+      fileName?: string | null,
+    ): Promise<ModInfo>;
+    remove(instanceId: string, fileName: string): Promise<void>;
+    enable(instanceId: string, fileName: string): Promise<void>;
+    disable(instanceId: string, fileName: string): Promise<void>;
+    openFolder(instanceId: string): Promise<void>;
+  };
+  openInstanceFolder(instanceId: string): Promise<void>;
   checkUpdate(): Promise<UpdateInfo | null>;
   doUpdate(url: string): Promise<void>;
   setSession(session: CustomSession): Promise<void>;
   clearSession(): Promise<void>;
+  anvilSession: {
+    login(
+      username: string,
+      password: string,
+      code?: string | null,
+    ): Promise<AnvilLoginResult>;
+    restore(): Promise<AnvilLoginResult | null>;
+    logout(): Promise<void>;
+  };
   close(): Promise<void>;
+  minimize(): Promise<void>;
+  toggleMaximize(): Promise<void>;
+  startDrag(): Promise<void>;
   on: {
     setupProgress(cb: (p: SetupProgress) => void): Promise<() => void>;
     setupDone(cb: () => void): Promise<() => void>;