@wumx-labs/noxaeapi-sdk 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -207,6 +207,67 @@ interface SkillInfo {
     skills: Record<string, number>;
     powerLevel: number;
 }
+/** A single currency configured on ExcellentEconomy (multi-currency, non-Vault). */
+interface CurrencyBalance {
+    uuid: string;
+    name: string | null;
+    currency: string;
+    balance: number;
+}
+interface CurrencyTopEntry {
+    uuid: string;
+    name: string;
+    balance: number;
+}
+/** Entry returned by `GET /v1/leaderboards` describing one registered leaderboard source. */
+interface LeaderboardSourceInfo {
+    id: string;
+    displayName: string;
+    available: boolean;
+    /** True if this source can only rank currently-online players (e.g. mcMMO). */
+    onlineOnly: boolean;
+}
+/** A single ranked entry from `GET /v1/leaderboards/{id}/top`. Shape can vary slightly by source. */
+interface LeaderboardEntry {
+    uuid: string;
+    name: string;
+    value: number;
+    [key: string]: unknown;
+}
+interface NetworkServerStatus {
+    id: string;
+    label: string;
+    online: boolean;
+    server: ServerInfo | null;
+    players: OnlinePlayer[];
+}
+interface NetworkPlayersServerEntry {
+    id: string;
+    label: string;
+    online: boolean;
+    players: OnlinePlayer[];
+}
+interface NetworkPlayersResponse {
+    total: number;
+    servers: NetworkPlayersServerEntry[];
+}
+interface NetworkFindPlayerResponse {
+    found: boolean;
+    server?: string;
+    player?: OnlinePlayer;
+}
+interface NetworkHealthServerEntry {
+    id: string;
+    label: string;
+    online: boolean;
+    tps?: unknown;
+    health?: unknown;
+}
+interface NetworkHealthResponse {
+    servers: NetworkHealthServerEntry[];
+}
+/** Per-server "success" | "error" result, keyed by network server ID. */
+type NetworkBroadcastResponse = Record<string, "success" | "error">;
 
 declare class PlayersModule {
     private readonly http;
@@ -254,6 +315,27 @@ declare class EconomyModule {
     pay(uuid: string, amount: number): Promise<void>;
     /** Debit an amount from a player (subtracts from their balance). */
     debit(uuid: string, amount: number): Promise<void>;
+    /** List all currency IDs configured on ExcellentEconomy. */
+    listCurrencies(): Promise<string[]>;
+    /** Get a player's balance for a specific ExcellentEconomy currency. */
+    getCurrencyBalance(currency: string, uuid: string): Promise<CurrencyBalance>;
+    /**
+     * Pay a player in a specific currency (adds `amount` to their balance).
+     * `amount` must be greater than zero.
+     */
+    payCurrency(currency: string, uuid: string, amount: number): Promise<"success" | "failure">;
+    /**
+     * Debit a player in a specific currency (subtracts `amount` from their
+     * balance). `amount` must be greater than zero.
+     */
+    debitCurrency(currency: string, uuid: string, amount: number): Promise<"success" | "failure">;
+    /**
+     * Set a player's balance for a specific currency to an exact amount
+     * (`amount` must be >= 0), rather than adding/subtracting.
+     */
+    setCurrencyBalance(currency: string, uuid: string, amount: number): Promise<"success" | "failure">;
+    /** Get the top balances leaderboard for a specific currency. */
+    getCurrencyTop(currency: string, limit?: number): Promise<CurrencyTopEntry[]>;
 }
 
 declare class ServerModule {
@@ -458,6 +540,20 @@ declare class LuckPermsModule {
     removePlayerGroup(uuid: string, groupName: string): Promise<void>;
     /** List all known groups. */
     getGroups(): Promise<string[]>;
+    /**
+     * Create a new LuckPerms group. The name is lowercased server-side.
+     * Throws `NoxAeApiError` with a 409 status if the group already exists.
+     */
+    createGroup(name: string): Promise<{
+        name: string;
+        status: string;
+    }>;
+    /**
+     * Delete a LuckPerms group by name.
+     * The `default` group can't be deleted (400 — every user without an
+     * explicit group inherits from it) and a 404 is thrown if it doesn't exist.
+     */
+    deleteGroup(name: string): Promise<void>;
     /** Get the permissions attached to a specific group. */
     getGroupPermissions(name: string): Promise<GroupInfo>;
 }
@@ -502,6 +598,78 @@ declare class SkillsModule {
     getAuraSkills(uuid: string): Promise<SkillInfo>;
 }
 
+/**
+ * Wraps the generic, pluggable `/v1/leaderboards/*` routes. This is a
+ * unified view over every ranking source registered on the server —
+ * economy currencies, mcMMO power level, AuraSkills power level, etc —
+ * so you don't need to know ahead of time which plugins are installed.
+ *
+ * Use `list()` to discover available source IDs, then pass one to
+ * `getTop(id)`. Sources that are registered but currently unavailable
+ * (e.g. the backing plugin isn't loaded) throw `NoxAeApiError` with the
+ * source's own unavailable status (424 for economy currencies, 503 for
+ * mcMMO/AuraSkills) when you call `getTop`.
+ */
+declare class LeaderboardModule {
+    private readonly http;
+    constructor(http: HttpEngine);
+    /** List every registered leaderboard source and its availability. */
+    list(): Promise<LeaderboardSourceInfo[]>;
+    /** Get ranked entries for one leaderboard source (see `list()` for valid IDs). */
+    getTop(id: string, limit?: number): Promise<LeaderboardEntry[]>;
+}
+
+/**
+ * Wraps the `/v1/network/*` routes. These only exist when `network.enabled:
+ * true` is set in the server's config with at least one backend server
+ * configured — calling any method here against a server without the
+ * network aggregator enabled will 404.
+ *
+ * The aggregator fans requests out to every configured backend server
+ * (each with its own base URL + key) and merges the results, so a single
+ * call here can reflect the state of an entire network rather than just
+ * the server you connected to.
+ */
+declare class NetworkModule {
+    private readonly http;
+    constructor(http: HttpEngine);
+    /** Get status (server info + online players) for every configured network server. */
+    statusAll(): Promise<{
+        network: NetworkServerStatus[];
+    }>;
+    /** Get status for a single network server by its configured ID. */
+    statusById(id: string): Promise<NetworkServerStatus>;
+    /** Aggregate online players across every network server. */
+    players(): Promise<NetworkPlayersResponse>;
+    /** Find which network server a player is currently on by UUID. */
+    findPlayer(uuid: string): Promise<NetworkFindPlayerResponse>;
+    /** Get aggregate health (TPS/memory) from every network server. */
+    health(): Promise<NetworkHealthResponse>;
+    /**
+     * Broadcast a message to every server on the network.
+     * Returns a map of server ID -> "success" | "error" (per-server delivery
+     * result; a network-wide failure is only thrown for a malformed request).
+     */
+    broadcast(message: string): Promise<Record<string, "success" | "error">>;
+    /**
+     * Forward an arbitrary request to a specific network server's own REST
+     * API, e.g. `network.forward("survival", "POST", "server/exec", { body:
+     * { command: "say hi" }, form: true })` reaches that server's
+     * `POST /v1/server/exec` directly. Useful for endpoints the aggregator
+     * doesn't have a dedicated method for (economy, worlds, etc) on a
+     * specific server without instantiating a second client pointed at it.
+     *
+     * Note the target server responds according to its own route's expected
+     * encoding (form vs JSON) — pass `form: true` the same way you would for
+     * a direct call to that endpoint.
+     */
+    forward<T = unknown>(id: string, method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH", path: string, opts?: {
+        body?: unknown;
+        query?: Record<string, QueryValue>;
+        form?: boolean;
+    }): Promise<T>;
+}
+
 type NoxAeApiWsEvent = "open" | "close" | "error" | "console" | "event" | "message";
 type Listener = (payload: unknown) => void;
 interface NoxAeApiWsOptions {
@@ -563,6 +731,10 @@ declare class NoxAeApiClient {
     readonly noxauth: NoxAuthModule;
     /** Requires mcMMO and/or AuraSkills to be loaded on the target server. */
     readonly skills: SkillsModule;
+    /** Generic ranked leaderboards (economy currencies, mcMMO, AuraSkills, ...). */
+    readonly leaderboards: LeaderboardModule;
+    /** Only works if `network.enabled: true` is set in the server config. */
+    readonly network: NetworkModule;
     private readonly http;
     private readonly baseUrl;
     private readonly apiKey?;
@@ -633,4 +805,4 @@ declare class NoxAeApiNetworkError extends Error {
     constructor(message: string, method: string, path: string, cause?: unknown);
 }
 
-export { type Advancement, type EconomyInfo, type GroupInfo, type InventoryItem, NoxAeApiClient, type NoxAeApiClientOptions, NoxAeApiError, NoxAeApiForbiddenError, NoxAeApiNetworkError, NoxAeApiNotFoundError, NoxAeApiRateLimitError, NoxAeApiServerError, NoxAeApiSocket, NoxAeApiUnauthorizedError, type NoxAeApiWsEvent, type NoxAeApiWsOptions, type NoxAuthPlayerInfo, type Objective, type OfflinePlayer, type OnlinePlayer, type PasswordCheckResult, type PermissionNode, type PlayerBalance, type PlayerStats, type Plugin, type RetryOptions, type Score, type Scoreboard, type ServerBan, type ServerHealth, type ServerInfo, type SkillInfo, type TopBalanceEntry, type WhitelistEntry, type World };
+export { type Advancement, type CurrencyBalance, type CurrencyTopEntry, type EconomyInfo, type GroupInfo, type InventoryItem, type LeaderboardEntry, type LeaderboardSourceInfo, type NetworkBroadcastResponse, type NetworkFindPlayerResponse, type NetworkHealthResponse, type NetworkHealthServerEntry, type NetworkPlayersResponse, type NetworkPlayersServerEntry, type NetworkServerStatus, NoxAeApiClient, type NoxAeApiClientOptions, NoxAeApiError, NoxAeApiForbiddenError, NoxAeApiNetworkError, NoxAeApiNotFoundError, NoxAeApiRateLimitError, NoxAeApiServerError, NoxAeApiSocket, NoxAeApiUnauthorizedError, type NoxAeApiWsEvent, type NoxAeApiWsOptions, type NoxAuthPlayerInfo, type Objective, type OfflinePlayer, type OnlinePlayer, type PasswordCheckResult, type PermissionNode, type PlayerBalance, type PlayerStats, type Plugin, type RetryOptions, type Score, type Scoreboard, type ServerBan, type ServerHealth, type ServerInfo, type SkillInfo, type TopBalanceEntry, type WhitelistEntry, type World };

package/dist/index.d.ts

@@ -207,6 +207,67 @@ interface SkillInfo {
     skills: Record<string, number>;
     powerLevel: number;
 }
+/** A single currency configured on ExcellentEconomy (multi-currency, non-Vault). */
+interface CurrencyBalance {
+    uuid: string;
+    name: string | null;
+    currency: string;
+    balance: number;
+}
+interface CurrencyTopEntry {
+    uuid: string;
+    name: string;
+    balance: number;
+}
+/** Entry returned by `GET /v1/leaderboards` describing one registered leaderboard source. */
+interface LeaderboardSourceInfo {
+    id: string;
+    displayName: string;
+    available: boolean;
+    /** True if this source can only rank currently-online players (e.g. mcMMO). */
+    onlineOnly: boolean;
+}
+/** A single ranked entry from `GET /v1/leaderboards/{id}/top`. Shape can vary slightly by source. */
+interface LeaderboardEntry {
+    uuid: string;
+    name: string;
+    value: number;
+    [key: string]: unknown;
+}
+interface NetworkServerStatus {
+    id: string;
+    label: string;
+    online: boolean;
+    server: ServerInfo | null;
+    players: OnlinePlayer[];
+}
+interface NetworkPlayersServerEntry {
+    id: string;
+    label: string;
+    online: boolean;
+    players: OnlinePlayer[];
+}
+interface NetworkPlayersResponse {
+    total: number;
+    servers: NetworkPlayersServerEntry[];
+}
+interface NetworkFindPlayerResponse {
+    found: boolean;
+    server?: string;
+    player?: OnlinePlayer;
+}
+interface NetworkHealthServerEntry {
+    id: string;
+    label: string;
+    online: boolean;
+    tps?: unknown;
+    health?: unknown;
+}
+interface NetworkHealthResponse {
+    servers: NetworkHealthServerEntry[];
+}
+/** Per-server "success" | "error" result, keyed by network server ID. */
+type NetworkBroadcastResponse = Record<string, "success" | "error">;
 
 declare class PlayersModule {
     private readonly http;
@@ -254,6 +315,27 @@ declare class EconomyModule {
     pay(uuid: string, amount: number): Promise<void>;
     /** Debit an amount from a player (subtracts from their balance). */
     debit(uuid: string, amount: number): Promise<void>;
+    /** List all currency IDs configured on ExcellentEconomy. */
+    listCurrencies(): Promise<string[]>;
+    /** Get a player's balance for a specific ExcellentEconomy currency. */
+    getCurrencyBalance(currency: string, uuid: string): Promise<CurrencyBalance>;
+    /**
+     * Pay a player in a specific currency (adds `amount` to their balance).
+     * `amount` must be greater than zero.
+     */
+    payCurrency(currency: string, uuid: string, amount: number): Promise<"success" | "failure">;
+    /**
+     * Debit a player in a specific currency (subtracts `amount` from their
+     * balance). `amount` must be greater than zero.
+     */
+    debitCurrency(currency: string, uuid: string, amount: number): Promise<"success" | "failure">;
+    /**
+     * Set a player's balance for a specific currency to an exact amount
+     * (`amount` must be >= 0), rather than adding/subtracting.
+     */
+    setCurrencyBalance(currency: string, uuid: string, amount: number): Promise<"success" | "failure">;
+    /** Get the top balances leaderboard for a specific currency. */
+    getCurrencyTop(currency: string, limit?: number): Promise<CurrencyTopEntry[]>;
 }
 
 declare class ServerModule {
@@ -458,6 +540,20 @@ declare class LuckPermsModule {
     removePlayerGroup(uuid: string, groupName: string): Promise<void>;
     /** List all known groups. */
     getGroups(): Promise<string[]>;
+    /**
+     * Create a new LuckPerms group. The name is lowercased server-side.
+     * Throws `NoxAeApiError` with a 409 status if the group already exists.
+     */
+    createGroup(name: string): Promise<{
+        name: string;
+        status: string;
+    }>;
+    /**
+     * Delete a LuckPerms group by name.
+     * The `default` group can't be deleted (400 — every user without an
+     * explicit group inherits from it) and a 404 is thrown if it doesn't exist.
+     */
+    deleteGroup(name: string): Promise<void>;
     /** Get the permissions attached to a specific group. */
     getGroupPermissions(name: string): Promise<GroupInfo>;
 }
@@ -502,6 +598,78 @@ declare class SkillsModule {
     getAuraSkills(uuid: string): Promise<SkillInfo>;
 }
 
+/**
+ * Wraps the generic, pluggable `/v1/leaderboards/*` routes. This is a
+ * unified view over every ranking source registered on the server —
+ * economy currencies, mcMMO power level, AuraSkills power level, etc —
+ * so you don't need to know ahead of time which plugins are installed.
+ *
+ * Use `list()` to discover available source IDs, then pass one to
+ * `getTop(id)`. Sources that are registered but currently unavailable
+ * (e.g. the backing plugin isn't loaded) throw `NoxAeApiError` with the
+ * source's own unavailable status (424 for economy currencies, 503 for
+ * mcMMO/AuraSkills) when you call `getTop`.
+ */
+declare class LeaderboardModule {
+    private readonly http;
+    constructor(http: HttpEngine);
+    /** List every registered leaderboard source and its availability. */
+    list(): Promise<LeaderboardSourceInfo[]>;
+    /** Get ranked entries for one leaderboard source (see `list()` for valid IDs). */
+    getTop(id: string, limit?: number): Promise<LeaderboardEntry[]>;
+}
+
+/**
+ * Wraps the `/v1/network/*` routes. These only exist when `network.enabled:
+ * true` is set in the server's config with at least one backend server
+ * configured — calling any method here against a server without the
+ * network aggregator enabled will 404.
+ *
+ * The aggregator fans requests out to every configured backend server
+ * (each with its own base URL + key) and merges the results, so a single
+ * call here can reflect the state of an entire network rather than just
+ * the server you connected to.
+ */
+declare class NetworkModule {
+    private readonly http;
+    constructor(http: HttpEngine);
+    /** Get status (server info + online players) for every configured network server. */
+    statusAll(): Promise<{
+        network: NetworkServerStatus[];
+    }>;
+    /** Get status for a single network server by its configured ID. */
+    statusById(id: string): Promise<NetworkServerStatus>;
+    /** Aggregate online players across every network server. */
+    players(): Promise<NetworkPlayersResponse>;
+    /** Find which network server a player is currently on by UUID. */
+    findPlayer(uuid: string): Promise<NetworkFindPlayerResponse>;
+    /** Get aggregate health (TPS/memory) from every network server. */
+    health(): Promise<NetworkHealthResponse>;
+    /**
+     * Broadcast a message to every server on the network.
+     * Returns a map of server ID -> "success" | "error" (per-server delivery
+     * result; a network-wide failure is only thrown for a malformed request).
+     */
+    broadcast(message: string): Promise<Record<string, "success" | "error">>;
+    /**
+     * Forward an arbitrary request to a specific network server's own REST
+     * API, e.g. `network.forward("survival", "POST", "server/exec", { body:
+     * { command: "say hi" }, form: true })` reaches that server's
+     * `POST /v1/server/exec` directly. Useful for endpoints the aggregator
+     * doesn't have a dedicated method for (economy, worlds, etc) on a
+     * specific server without instantiating a second client pointed at it.
+     *
+     * Note the target server responds according to its own route's expected
+     * encoding (form vs JSON) — pass `form: true` the same way you would for
+     * a direct call to that endpoint.
+     */
+    forward<T = unknown>(id: string, method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH", path: string, opts?: {
+        body?: unknown;
+        query?: Record<string, QueryValue>;
+        form?: boolean;
+    }): Promise<T>;
+}
+
 type NoxAeApiWsEvent = "open" | "close" | "error" | "console" | "event" | "message";
 type Listener = (payload: unknown) => void;
 interface NoxAeApiWsOptions {
@@ -563,6 +731,10 @@ declare class NoxAeApiClient {
     readonly noxauth: NoxAuthModule;
     /** Requires mcMMO and/or AuraSkills to be loaded on the target server. */
     readonly skills: SkillsModule;
+    /** Generic ranked leaderboards (economy currencies, mcMMO, AuraSkills, ...). */
+    readonly leaderboards: LeaderboardModule;
+    /** Only works if `network.enabled: true` is set in the server config. */
+    readonly network: NetworkModule;
     private readonly http;
     private readonly baseUrl;
     private readonly apiKey?;
@@ -633,4 +805,4 @@ declare class NoxAeApiNetworkError extends Error {
     constructor(message: string, method: string, path: string, cause?: unknown);
 }
 
-export { type Advancement, type EconomyInfo, type GroupInfo, type InventoryItem, NoxAeApiClient, type NoxAeApiClientOptions, NoxAeApiError, NoxAeApiForbiddenError, NoxAeApiNetworkError, NoxAeApiNotFoundError, NoxAeApiRateLimitError, NoxAeApiServerError, NoxAeApiSocket, NoxAeApiUnauthorizedError, type NoxAeApiWsEvent, type NoxAeApiWsOptions, type NoxAuthPlayerInfo, type Objective, type OfflinePlayer, type OnlinePlayer, type PasswordCheckResult, type PermissionNode, type PlayerBalance, type PlayerStats, type Plugin, type RetryOptions, type Score, type Scoreboard, type ServerBan, type ServerHealth, type ServerInfo, type SkillInfo, type TopBalanceEntry, type WhitelistEntry, type World };
+export { type Advancement, type CurrencyBalance, type CurrencyTopEntry, type EconomyInfo, type GroupInfo, type InventoryItem, type LeaderboardEntry, type LeaderboardSourceInfo, type NetworkBroadcastResponse, type NetworkFindPlayerResponse, type NetworkHealthResponse, type NetworkHealthServerEntry, type NetworkPlayersResponse, type NetworkPlayersServerEntry, type NetworkServerStatus, NoxAeApiClient, type NoxAeApiClientOptions, NoxAeApiError, NoxAeApiForbiddenError, NoxAeApiNetworkError, NoxAeApiNotFoundError, NoxAeApiRateLimitError, NoxAeApiServerError, NoxAeApiSocket, NoxAeApiUnauthorizedError, type NoxAeApiWsEvent, type NoxAeApiWsOptions, type NoxAuthPlayerInfo, type Objective, type OfflinePlayer, type OnlinePlayer, type PasswordCheckResult, type PermissionNode, type PlayerBalance, type PlayerStats, type Plugin, type RetryOptions, type Score, type Scoreboard, type ServerBan, type ServerHealth, type ServerInfo, type SkillInfo, type TopBalanceEntry, type WhitelistEntry, type World };

package/dist/index.js

@@ -324,6 +324,61 @@ var EconomyModule = class {
   debit(uuid, amount) {
     return this.http.request("POST", "economy/debit", { body: { uuid, amount }, form: true });
   }
+  // ─── ExcellentEconomy multi-currency (native API, not Vault) ────────────
+  //
+  // These endpoints talk directly to ExcellentEconomy's Developer API rather
+  // than Vault, so they work with any currency configured on the server
+  // (coins, gems, tokens, ...) instead of only the single Vault-linked
+  // "primary" currency exposed above. They throw `NoxAeApiError` with a 424
+  // status if ExcellentEconomy isn't installed on the target server, and a
+  // 404 if the given currency ID doesn't exist.
+  /** List all currency IDs configured on ExcellentEconomy. */
+  listCurrencies() {
+    return this.http.request("GET", "economy/currencies");
+  }
+  /** Get a player's balance for a specific ExcellentEconomy currency. */
+  getCurrencyBalance(currency, uuid) {
+    return this.http.request(
+      "GET",
+      `economy/currency/${encodeURIComponent(currency)}/balance/${encodeURIComponent(uuid)}`
+    );
+  }
+  /**
+   * Pay a player in a specific currency (adds `amount` to their balance).
+   * `amount` must be greater than zero.
+   */
+  payCurrency(currency, uuid, amount) {
+    return this.http.request("POST", `economy/currency/${encodeURIComponent(currency)}/pay`, {
+      body: { uuid, amount },
+      form: true
+    });
+  }
+  /**
+   * Debit a player in a specific currency (subtracts `amount` from their
+   * balance). `amount` must be greater than zero.
+   */
+  debitCurrency(currency, uuid, amount) {
+    return this.http.request("POST", `economy/currency/${encodeURIComponent(currency)}/debit`, {
+      body: { uuid, amount },
+      form: true
+    });
+  }
+  /**
+   * Set a player's balance for a specific currency to an exact amount
+   * (`amount` must be >= 0), rather than adding/subtracting.
+   */
+  setCurrencyBalance(currency, uuid, amount) {
+    return this.http.request("POST", `economy/currency/${encodeURIComponent(currency)}/set`, {
+      body: { uuid, amount },
+      form: true
+    });
+  }
+  /** Get the top balances leaderboard for a specific currency. */
+  getCurrencyTop(currency, limit) {
+    return this.http.request("GET", `economy/currency/${encodeURIComponent(currency)}/top`, {
+      query: { limit }
+    });
+  }
 };
 
 // src/modules/server.ts
@@ -637,6 +692,21 @@ var LuckPermsModule = class {
   getGroups() {
     return this.http.request("GET", "luckperms/groups");
   }
+  /**
+   * Create a new LuckPerms group. The name is lowercased server-side.
+   * Throws `NoxAeApiError` with a 409 status if the group already exists.
+   */
+  createGroup(name) {
+    return this.http.request("POST", "luckperms/groups", { body: { name } });
+  }
+  /**
+   * Delete a LuckPerms group by name.
+   * The `default` group can't be deleted (400 — every user without an
+   * explicit group inherits from it) and a 404 is thrown if it doesn't exist.
+   */
+  deleteGroup(name) {
+    return this.http.request("DELETE", `luckperms/group/${encodeURIComponent(name)}`);
+  }
   /** Get the permissions attached to a specific group. */
   getGroupPermissions(name) {
     return this.http.request("GET", `luckperms/group/${encodeURIComponent(name)}/permissions`);
@@ -689,6 +759,75 @@ var SkillsModule = class {
   }
 };
 
+// src/modules/leaderboard.ts
+var LeaderboardModule = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** List every registered leaderboard source and its availability. */
+  list() {
+    return this.http.request("GET", "leaderboards");
+  }
+  /** Get ranked entries for one leaderboard source (see `list()` for valid IDs). */
+  getTop(id, limit) {
+    return this.http.request("GET", `leaderboards/${encodeURIComponent(id)}/top`, {
+      query: { limit }
+    });
+  }
+};
+
+// src/modules/network.ts
+var NetworkModule = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Get status (server info + online players) for every configured network server. */
+  statusAll() {
+    return this.http.request("GET", "network/status");
+  }
+  /** Get status for a single network server by its configured ID. */
+  statusById(id) {
+    return this.http.request("GET", `network/status/${encodeURIComponent(id)}`);
+  }
+  /** Aggregate online players across every network server. */
+  players() {
+    return this.http.request("GET", "network/players");
+  }
+  /** Find which network server a player is currently on by UUID. */
+  findPlayer(uuid) {
+    return this.http.request("GET", `network/players/${encodeURIComponent(uuid)}`);
+  }
+  /** Get aggregate health (TPS/memory) from every network server. */
+  health() {
+    return this.http.request("GET", "network/health");
+  }
+  /**
+   * Broadcast a message to every server on the network.
+   * Returns a map of server ID -> "success" | "error" (per-server delivery
+   * result; a network-wide failure is only thrown for a malformed request).
+   */
+  broadcast(message) {
+    return this.http.request("POST", "network/broadcast", { body: { message }, form: true });
+  }
+  /**
+   * Forward an arbitrary request to a specific network server's own REST
+   * API, e.g. `network.forward("survival", "POST", "server/exec", { body:
+   * { command: "say hi" }, form: true })` reaches that server's
+   * `POST /v1/server/exec` directly. Useful for endpoints the aggregator
+   * doesn't have a dedicated method for (economy, worlds, etc) on a
+   * specific server without instantiating a second client pointed at it.
+   *
+   * Note the target server responds according to its own route's expected
+   * encoding (form vs JSON) — pass `form: true` the same way you would for
+   * a direct call to that endpoint.
+   */
+  forward(id, method, path, opts = {}) {
+    return this.http.request(method, `network/${encodeURIComponent(id)}/${path.replace(/^\/+/, "")}`, opts);
+  }
+};
+
 // src/socket.ts
 function toWsUrl(baseUrl, route, apiKey) {
   const url = new URL(`${baseUrl.replace(/\/+$/, "")}/v1/ws/${route.replace(/^\/+/, "")}`);
@@ -796,6 +935,10 @@ var NoxAeApiClient = class _NoxAeApiClient {
   noxauth;
   /** Requires mcMMO and/or AuraSkills to be loaded on the target server. */
   skills;
+  /** Generic ranked leaderboards (economy currencies, mcMMO, AuraSkills, ...). */
+  leaderboards;
+  /** Only works if `network.enabled: true` is set in the server config. */
+  network;
   http;
   baseUrl;
   apiKey;
@@ -813,6 +956,8 @@ var NoxAeApiClient = class _NoxAeApiClient {
     this.luckperms = new LuckPermsModule(this.http);
     this.noxauth = new NoxAuthModule(this.http);
     this.skills = new SkillsModule(this.http);
+    this.leaderboards = new LeaderboardModule(this.http);
+    this.network = new NetworkModule(this.http);
   }
   /**
    * Build a client from environment variables: