@modrinth/api-client 0.94.0 → 0.95.0

package/dist/index.d.ts

@@ -861,15 +861,6 @@ export declare namespace Archon {
                 limit?: number;
                 offset?: number;
             };
-            export type StockRequest = {
-                cpu?: number;
-                memory_mb?: number;
-                swap_mb?: number;
-                storage_mb?: number;
-            };
-            export type StockResponse = {
-                available: number;
-            };
             export type JWTAuth = {
                 url: string;
                 token: string;
@@ -973,6 +964,25 @@ export declare namespace Archon {
                 lon: number;
                 zone: string;
             };
+            export type MemorySizeStock = {
+                /** Number of servers of this memory size that fit in the region */
+                available: number;
+                /** Hostnames of the nodes which fit at least one server of this memory size */
+                hostnames: string[];
+            };
+            export type RegionStock = {
+                /** Shortcode of the region */
+                region: string;
+                /** Stock of each requested memory size, keyed by memory size in MB */
+                stock: Record<number, MemorySizeStock>;
+                /** WebSocket URLs of random nodes in the region, to measure the latency to it */
+                ping_urls: string[];
+            };
+            export type StockResponse = {
+                regions: RegionStock[];
+                /** Number of servers that fit across all regions, keyed by memory size in MB */
+                total: Record<number, number>;
+            };
         }
     }
     export namespace Backups {
@@ -1640,16 +1650,6 @@ declare class ArchonServersV0Module extends AbstractModule {
      * GET /modrinth/v0/servers
      */
     list(options?: Archon.Servers.v0.GetServersOptions): Promise<Archon.Servers.v0.ServerGetResponse>;
-    /**
-     * Check stock availability for a region
-     * POST /modrinth/v0/stock?region=:region
-     */
-    checkStock(region: string, request: Archon.Servers.v0.StockRequest): Promise<Archon.Servers.v0.StockResponse>;
-    /**
-     * Check stock availability (without region filter)
-     * POST /modrinth/v0/stock
-     */
-    checkStockGlobal(request: Archon.Servers.v0.StockRequest): Promise<Archon.Servers.v0.StockResponse>;
     /**
      * Get filesystem authentication credentials for a server
      * Returns URL and JWT token for accessing the server's filesystem via Kyros
@@ -1770,6 +1770,16 @@ declare class ArchonServersV1Module extends AbstractModule {
      * GET /v1/regions
      */
     getRegions(): Promise<Archon.Servers.v1.Region[]>;
+    /**
+     * Get how many servers of each memory size fit in every public region
+     * GET /v1/stock
+     */
+    getStock(memoryMb: number[]): Promise<Archon.Servers.v1.StockResponse>;
+    /**
+     * Get how many servers of each memory size fit in every public region when upgrading a server
+     * GET /v1/servers/:server_id/upgrade-stock
+     */
+    getUpgradeStock(serverId: string, memoryMb: number[]): Promise<Archon.Servers.v1.StockResponse>;
     /**
      * End the intro flow for a server
      * DELETE /v1/servers/:id/flows/intro
@@ -7661,8 +7671,6 @@ declare type ParseModule<T extends string, API extends string> = T extends `${AP
 
 export declare function parseSyncEventData(data: string): Archon.Sync.v1.SyncEvent | null;
 
-export declare function pingWebSocketUrl(url: string, options?: WebSocketPingOptions): Promise<number>;
-
 export declare namespace Purpur {
     export namespace Versions {
         export namespace v2 {
@@ -8213,11 +8221,30 @@ export declare interface WebSocketConnection {
 
 export declare type WebSocketEventHandler<E extends Archon.Websocket.v0.WSEvent = Archon.Websocket.v0.WSEvent> = (event: E) => void;
 
+/**
+ * Measures the latency to a ping test WebSocket, which echoes back every message. The connection stays open between
+ * measurements until {@link WebSocketPinger.close} is called.
+ */
+export declare class WebSocketPinger {
+    /** Resolves to whether the connection opened within the connect timeout. */
+    readonly connected: Promise<boolean>;
+    private readonly socket;
+    private sampleListener;
+    private closed;
+    constructor(url: string, connectTimeoutMs: number);
+    get isOpen(): boolean;
+    /**
+     * Sends `count` pings over the connection and resolves to the latency in ms of every ping that came back, once
+     * all of them came back or `settleDelayMs` after the last one was sent.
+     */
+    measure(options?: WebSocketPingOptions): Promise<number[]>;
+    close(): void;
+}
+
 export declare interface WebSocketPingOptions {
     count?: number;
     intervalMs?: number;
     settleDelayMs?: number;
-    timeoutMs?: number;
     signal?: AbortSignal;
 }