@wumx-labs/noxaeapi-sdk 0.3.5 → 0.4.0

package/dist/index.d.cts

@@ -268,6 +268,41 @@ interface NetworkHealthResponse {
 }
 /** Per-server "success" | "error" result, keyed by network server ID. */
 type NetworkBroadcastResponse = Record<string, "success" | "error">;
+/** Last-known state of one backend node, as tracked by the network hub. */
+interface NetworkHubNode {
+    id: string;
+    label: string;
+    online: boolean;
+    tps: string;
+    onlinePlayers: number;
+    maxPlayers: number;
+    /** Opaque payload the backend reported in its last heartbeat. Shape isn't fixed by the hub. */
+    health: unknown;
+    /** Unix epoch ms of the last heartbeat received, or 0 if never. */
+    lastHeartbeatAt: number;
+}
+interface NetworkHubStatusResponse {
+    network: NetworkHubNode[];
+}
+/** A player as seen directly by the proxy (not reported by a backend). */
+interface NetworkHubPlayer {
+    uuid: string;
+    name: string;
+    /** Backend server ID the player is currently connected to, if known. */
+    server?: string;
+}
+interface NetworkHubPlayersResponse {
+    total: number;
+    players: NetworkHubPlayer[];
+}
+interface NetworkHubFindPlayerResponse {
+    found: boolean;
+    player?: NetworkHubPlayer;
+}
+/** Result of a proxy-wide broadcast: how many connected players received the message. */
+interface NetworkHubBroadcastResponse {
+    delivered: number;
+}
 
 declare class PlayersModule {
     private readonly http;
@@ -670,6 +705,69 @@ declare class NetworkModule {
     }): Promise<T>;
 }
 
+/**
+ * Wraps the `/v1/network/*` routes exposed by the **NoxAeApi-Velocity**
+ * network hub — a separate plugin/process from NoxAeApi-main, run on the
+ * Velocity proxy and listening on its own port (`NetworkHubConfig`'s
+ * `api-port`, distinct from any individual backend's own REST port).
+ *
+ * Point a `NoxAeApiNetworkHubClient` (not the regular `NoxAeApiClient`) at
+ * that port to use this module. Backend Paper/Bukkit servers connect out
+ * to the hub over WebSocket (`/network/register`) and push register /
+ * heartbeat / player-join / player-quit events; the hub answers every
+ * method below from its own in-memory registry, so calls here are cheap
+ * and don't block on a live round trip to each backend the way the older
+ * `NetworkModule` (NoxAeApi-main's built-in aggregator) does.
+ *
+ * Response shapes differ from `NetworkModule` even where the route names
+ * match — e.g. `players()` returns one flat proxy-wide player list here,
+ * not a per-server breakdown — so the two modules' types aren't
+ * interchangeable. There's also no hub equivalent of `/v1/network/health`;
+ * each node's last-reported health is embedded in `status*()`'s
+ * `NetworkHubNode.health` field instead.
+ */
+declare class NetworkHubModule {
+    private readonly http;
+    constructor(http: HttpEngine);
+    /** Get last-known status (from the registry) for every backend node that has ever registered. */
+    statusAll(): Promise<NetworkHubStatusResponse>;
+    /** Get last-known status for a single node by its configured ID. */
+    statusById(id: string): Promise<NetworkHubNode>;
+    /**
+     * List every player currently connected to the proxy, read straight from
+     * Velocity's own player registry (not reported by backends), along with
+     * which backend server each is on.
+     */
+    players(): Promise<NetworkHubPlayersResponse>;
+    /** Find which backend server a player is currently on by UUID (proxy-authoritative). */
+    findPlayer(uuid: string): Promise<NetworkHubFindPlayerResponse>;
+    /**
+     * Broadcast a message directly to every player connected to the proxy.
+     * Unlike `NetworkModule.broadcast`, this doesn't forward to each
+     * backend's `/v1/chat/broadcast` — the proxy already has every player
+     * in hand — so it still delivers even to servers with no REST API of
+     * their own reachable from the hub.
+     */
+    broadcast(message: string): Promise<NetworkHubBroadcastResponse>;
+    /**
+     * Forward an arbitrary request to a specific backend node's own REST
+     * API, e.g. `hub.forward("survival", "POST", "server/exec", { body:
+     * { command: "say hi" }, form: true })` reaches that backend's
+     * `POST /v1/server/exec` directly. Useful for endpoints the hub doesn't
+     * have a dedicated method for (economy, worlds, etc) without
+     * instantiating a second client pointed at that backend directly.
+     *
+     * The target backend 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 {
@@ -733,7 +831,17 @@ declare class NoxAeApiClient {
     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. */
+    /**
+     * Only works if `network.enabled: true` is set in the server config.
+     *
+     * This is NoxAeApi-main's built-in polling aggregator — it lives on the
+     * *same* backend server you're already connected to and fans requests
+     * out to the other backends listed in that server's own config. If the
+     * network is running NoxAeApi-Velocity instead, use
+     * `NoxAeApiNetworkHubClient` (pointed at the proxy's hub port) rather
+     * than this module — the hub replaces this aggregator with a push model
+     * and its response shapes differ.
+     */
     readonly network: NetworkModule;
     private readonly http;
     private readonly baseUrl;
@@ -752,6 +860,33 @@ declare class NoxAeApiClient {
     /** Open a WebSocket connection to the server (console tail or event stream). */
     connect(options?: Partial<NoxAeApiWsOptions>): NoxAeApiSocket;
 }
+/**
+ * Client for the **NoxAeApi-Velocity** network hub — a separate plugin
+ * that runs on the Velocity proxy, not on any individual backend server.
+ * Point `baseUrl` at the hub's own REST port (`NetworkHubConfig`'s
+ * `api-port`), not a backend's port, and use `NOXAEAPI_HUB_*` env vars
+ * (via `fromEnv`) if you keep that separate from a regular backend's
+ * `NOXAEAPI_*` vars.
+ *
+ * Only exposes `.network` — the hub doesn't run any of the other REST
+ * modules (players, economy, worlds, ...) that a backend `NoxAeApiClient`
+ * does. To reach a specific backend's own routes through the hub, use
+ * `hub.network.forward(id, ...)`.
+ */
+declare class NoxAeApiNetworkHubClient {
+    /** The network hub's aggregated view of every registered backend node. */
+    readonly network: NetworkHubModule;
+    constructor(options: NoxAeApiClientOptions);
+    /**
+     * Build a hub client from environment variables:
+     * `NOXAEAPI_HUB_BASE_URL` and `NOXAEAPI_HUB_KEY`.
+     *
+     * Same convenience as `NoxAeApiClient.fromEnv()`, under separate env var
+     * names so a process can hold both a backend client and a hub client at
+     * once without the two colliding.
+     */
+    static fromEnv(overrides?: Partial<NoxAeApiClientOptions>): NoxAeApiNetworkHubClient;
+}
 
 interface NoxAeApiErrorInfo {
     status: number;
@@ -805,4 +940,4 @@ declare class NoxAeApiNetworkError extends Error {
     constructor(message: string, method: string, path: string, cause?: unknown);
 }
 
-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 };
+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 NetworkHubBroadcastResponse, type NetworkHubFindPlayerResponse, type NetworkHubNode, type NetworkHubPlayer, type NetworkHubPlayersResponse, type NetworkHubStatusResponse, type NetworkPlayersResponse, type NetworkPlayersServerEntry, type NetworkServerStatus, NoxAeApiClient, type NoxAeApiClientOptions, NoxAeApiError, NoxAeApiForbiddenError, NoxAeApiNetworkError, NoxAeApiNetworkHubClient, 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

@@ -268,6 +268,41 @@ interface NetworkHealthResponse {
 }
 /** Per-server "success" | "error" result, keyed by network server ID. */
 type NetworkBroadcastResponse = Record<string, "success" | "error">;
+/** Last-known state of one backend node, as tracked by the network hub. */
+interface NetworkHubNode {
+    id: string;
+    label: string;
+    online: boolean;
+    tps: string;
+    onlinePlayers: number;
+    maxPlayers: number;
+    /** Opaque payload the backend reported in its last heartbeat. Shape isn't fixed by the hub. */
+    health: unknown;
+    /** Unix epoch ms of the last heartbeat received, or 0 if never. */
+    lastHeartbeatAt: number;
+}
+interface NetworkHubStatusResponse {
+    network: NetworkHubNode[];
+}
+/** A player as seen directly by the proxy (not reported by a backend). */
+interface NetworkHubPlayer {
+    uuid: string;
+    name: string;
+    /** Backend server ID the player is currently connected to, if known. */
+    server?: string;
+}
+interface NetworkHubPlayersResponse {
+    total: number;
+    players: NetworkHubPlayer[];
+}
+interface NetworkHubFindPlayerResponse {
+    found: boolean;
+    player?: NetworkHubPlayer;
+}
+/** Result of a proxy-wide broadcast: how many connected players received the message. */
+interface NetworkHubBroadcastResponse {
+    delivered: number;
+}
 
 declare class PlayersModule {
     private readonly http;
@@ -670,6 +705,69 @@ declare class NetworkModule {
     }): Promise<T>;
 }
 
+/**
+ * Wraps the `/v1/network/*` routes exposed by the **NoxAeApi-Velocity**
+ * network hub — a separate plugin/process from NoxAeApi-main, run on the
+ * Velocity proxy and listening on its own port (`NetworkHubConfig`'s
+ * `api-port`, distinct from any individual backend's own REST port).
+ *
+ * Point a `NoxAeApiNetworkHubClient` (not the regular `NoxAeApiClient`) at
+ * that port to use this module. Backend Paper/Bukkit servers connect out
+ * to the hub over WebSocket (`/network/register`) and push register /
+ * heartbeat / player-join / player-quit events; the hub answers every
+ * method below from its own in-memory registry, so calls here are cheap
+ * and don't block on a live round trip to each backend the way the older
+ * `NetworkModule` (NoxAeApi-main's built-in aggregator) does.
+ *
+ * Response shapes differ from `NetworkModule` even where the route names
+ * match — e.g. `players()` returns one flat proxy-wide player list here,
+ * not a per-server breakdown — so the two modules' types aren't
+ * interchangeable. There's also no hub equivalent of `/v1/network/health`;
+ * each node's last-reported health is embedded in `status*()`'s
+ * `NetworkHubNode.health` field instead.
+ */
+declare class NetworkHubModule {
+    private readonly http;
+    constructor(http: HttpEngine);
+    /** Get last-known status (from the registry) for every backend node that has ever registered. */
+    statusAll(): Promise<NetworkHubStatusResponse>;
+    /** Get last-known status for a single node by its configured ID. */
+    statusById(id: string): Promise<NetworkHubNode>;
+    /**
+     * List every player currently connected to the proxy, read straight from
+     * Velocity's own player registry (not reported by backends), along with
+     * which backend server each is on.
+     */
+    players(): Promise<NetworkHubPlayersResponse>;
+    /** Find which backend server a player is currently on by UUID (proxy-authoritative). */
+    findPlayer(uuid: string): Promise<NetworkHubFindPlayerResponse>;
+    /**
+     * Broadcast a message directly to every player connected to the proxy.
+     * Unlike `NetworkModule.broadcast`, this doesn't forward to each
+     * backend's `/v1/chat/broadcast` — the proxy already has every player
+     * in hand — so it still delivers even to servers with no REST API of
+     * their own reachable from the hub.
+     */
+    broadcast(message: string): Promise<NetworkHubBroadcastResponse>;
+    /**
+     * Forward an arbitrary request to a specific backend node's own REST
+     * API, e.g. `hub.forward("survival", "POST", "server/exec", { body:
+     * { command: "say hi" }, form: true })` reaches that backend's
+     * `POST /v1/server/exec` directly. Useful for endpoints the hub doesn't
+     * have a dedicated method for (economy, worlds, etc) without
+     * instantiating a second client pointed at that backend directly.
+     *
+     * The target backend 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 {
@@ -733,7 +831,17 @@ declare class NoxAeApiClient {
     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. */
+    /**
+     * Only works if `network.enabled: true` is set in the server config.
+     *
+     * This is NoxAeApi-main's built-in polling aggregator — it lives on the
+     * *same* backend server you're already connected to and fans requests
+     * out to the other backends listed in that server's own config. If the
+     * network is running NoxAeApi-Velocity instead, use
+     * `NoxAeApiNetworkHubClient` (pointed at the proxy's hub port) rather
+     * than this module — the hub replaces this aggregator with a push model
+     * and its response shapes differ.
+     */
     readonly network: NetworkModule;
     private readonly http;
     private readonly baseUrl;
@@ -752,6 +860,33 @@ declare class NoxAeApiClient {
     /** Open a WebSocket connection to the server (console tail or event stream). */
     connect(options?: Partial<NoxAeApiWsOptions>): NoxAeApiSocket;
 }
+/**
+ * Client for the **NoxAeApi-Velocity** network hub — a separate plugin
+ * that runs on the Velocity proxy, not on any individual backend server.
+ * Point `baseUrl` at the hub's own REST port (`NetworkHubConfig`'s
+ * `api-port`), not a backend's port, and use `NOXAEAPI_HUB_*` env vars
+ * (via `fromEnv`) if you keep that separate from a regular backend's
+ * `NOXAEAPI_*` vars.
+ *
+ * Only exposes `.network` — the hub doesn't run any of the other REST
+ * modules (players, economy, worlds, ...) that a backend `NoxAeApiClient`
+ * does. To reach a specific backend's own routes through the hub, use
+ * `hub.network.forward(id, ...)`.
+ */
+declare class NoxAeApiNetworkHubClient {
+    /** The network hub's aggregated view of every registered backend node. */
+    readonly network: NetworkHubModule;
+    constructor(options: NoxAeApiClientOptions);
+    /**
+     * Build a hub client from environment variables:
+     * `NOXAEAPI_HUB_BASE_URL` and `NOXAEAPI_HUB_KEY`.
+     *
+     * Same convenience as `NoxAeApiClient.fromEnv()`, under separate env var
+     * names so a process can hold both a backend client and a hub client at
+     * once without the two colliding.
+     */
+    static fromEnv(overrides?: Partial<NoxAeApiClientOptions>): NoxAeApiNetworkHubClient;
+}
 
 interface NoxAeApiErrorInfo {
     status: number;
@@ -805,4 +940,4 @@ declare class NoxAeApiNetworkError extends Error {
     constructor(message: string, method: string, path: string, cause?: unknown);
 }
 
-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 };
+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 NetworkHubBroadcastResponse, type NetworkHubFindPlayerResponse, type NetworkHubNode, type NetworkHubPlayer, type NetworkHubPlayersResponse, type NetworkHubStatusResponse, type NetworkPlayersResponse, type NetworkPlayersServerEntry, type NetworkServerStatus, NoxAeApiClient, type NoxAeApiClientOptions, NoxAeApiError, NoxAeApiForbiddenError, NoxAeApiNetworkError, NoxAeApiNetworkHubClient, 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

@@ -828,6 +828,59 @@ var NetworkModule = class {
   }
 };
 
+// src/modules/network-hub.ts
+var NetworkHubModule = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Get last-known status (from the registry) for every backend node that has ever registered. */
+  statusAll() {
+    return this.http.request("GET", "network/status");
+  }
+  /** Get last-known status for a single node by its configured ID. */
+  statusById(id) {
+    return this.http.request("GET", `network/status/${encodeURIComponent(id)}`);
+  }
+  /**
+   * List every player currently connected to the proxy, read straight from
+   * Velocity's own player registry (not reported by backends), along with
+   * which backend server each is on.
+   */
+  players() {
+    return this.http.request("GET", "network/players");
+  }
+  /** Find which backend server a player is currently on by UUID (proxy-authoritative). */
+  findPlayer(uuid) {
+    return this.http.request("GET", `network/players/${encodeURIComponent(uuid)}`);
+  }
+  /**
+   * Broadcast a message directly to every player connected to the proxy.
+   * Unlike `NetworkModule.broadcast`, this doesn't forward to each
+   * backend's `/v1/chat/broadcast` — the proxy already has every player
+   * in hand — so it still delivers even to servers with no REST API of
+   * their own reachable from the hub.
+   */
+  broadcast(message) {
+    return this.http.request("POST", "network/broadcast", { body: { message }, form: true });
+  }
+  /**
+   * Forward an arbitrary request to a specific backend node's own REST
+   * API, e.g. `hub.forward("survival", "POST", "server/exec", { body:
+   * { command: "say hi" }, form: true })` reaches that backend's
+   * `POST /v1/server/exec` directly. Useful for endpoints the hub doesn't
+   * have a dedicated method for (economy, worlds, etc) without
+   * instantiating a second client pointed at that backend directly.
+   *
+   * The target backend 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(/^\/+/, "")}`);
@@ -937,7 +990,17 @@ var NoxAeApiClient = class _NoxAeApiClient {
   skills;
   /** Generic ranked leaderboards (economy currencies, mcMMO, AuraSkills, ...). */
   leaderboards;
-  /** Only works if `network.enabled: true` is set in the server config. */
+  /**
+   * Only works if `network.enabled: true` is set in the server config.
+   *
+   * This is NoxAeApi-main's built-in polling aggregator — it lives on the
+   * *same* backend server you're already connected to and fans requests
+   * out to the other backends listed in that server's own config. If the
+   * network is running NoxAeApi-Velocity instead, use
+   * `NoxAeApiNetworkHubClient` (pointed at the proxy's hub port) rather
+   * than this module — the hub replaces this aggregator with a push model
+   * and its response shapes differ.
+   */
   network;
   http;
   baseUrl;
@@ -988,7 +1051,34 @@ var NoxAeApiClient = class _NoxAeApiClient {
     });
   }
 };
+var NoxAeApiNetworkHubClient = class _NoxAeApiNetworkHubClient {
+  /** The network hub's aggregated view of every registered backend node. */
+  network;
+  constructor(options) {
+    const http = new HttpEngine(options);
+    this.network = new NetworkHubModule(http);
+  }
+  /**
+   * Build a hub client from environment variables:
+   * `NOXAEAPI_HUB_BASE_URL` and `NOXAEAPI_HUB_KEY`.
+   *
+   * Same convenience as `NoxAeApiClient.fromEnv()`, under separate env var
+   * names so a process can hold both a backend client and a hub client at
+   * once without the two colliding.
+   */
+  static fromEnv(overrides = {}) {
+    const env = globalThis.process?.env;
+    const baseUrl = overrides.baseUrl ?? env?.NOXAEAPI_HUB_BASE_URL;
+    const apiKey = overrides.apiKey ?? env?.NOXAEAPI_HUB_KEY;
+    if (!baseUrl) {
+      throw new Error(
+        "NoxAeApiNetworkHubClient.fromEnv(): NOXAEAPI_HUB_BASE_URL is not set and no baseUrl override was given."
+      );
+    }
+    return new _NoxAeApiNetworkHubClient({ ...overrides, baseUrl, apiKey });
+  }
+};
 
-export { NoxAeApiClient, NoxAeApiError, NoxAeApiForbiddenError, NoxAeApiNetworkError, NoxAeApiNotFoundError, NoxAeApiRateLimitError, NoxAeApiServerError, NoxAeApiSocket, NoxAeApiUnauthorizedError };
+export { NoxAeApiClient, NoxAeApiError, NoxAeApiForbiddenError, NoxAeApiNetworkError, NoxAeApiNetworkHubClient, NoxAeApiNotFoundError, NoxAeApiRateLimitError, NoxAeApiServerError, NoxAeApiSocket, NoxAeApiUnauthorizedError };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map