@rebornteam/reborn-api 2.6.4 → 2.7.0

package/dist/api.d.ts

@@ -2,7 +2,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 2.6.4
+ * The version of the OpenAPI document: 2.7.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -499,6 +499,20 @@ export interface AdminUsernameHistoryEntry {
      */
     'changedAt'?: string;
 }
+export interface ChatMessageDTO {
+    'id': number;
+    'sentAt': string;
+    'sessionId': string;
+    'playerUuid': string;
+    'message': string;
+    'channel': string;
+}
+export interface ChatMessageRequest {
+    'sessionId': string;
+    'playerUuid': string;
+    'message': string;
+    'channel'?: string | null;
+}
 /**
  * Request to create new client credentials
  */
@@ -656,6 +670,27 @@ export interface PunishmentSeveritiesResponseSeverityInfo {
      */
     'durationSeconds'?: number;
 }
+export interface ServerRegisterRequest {
+    'region': string;
+    'gameType': string;
+    'containerId'?: string | null;
+}
+export interface ServerSessionDTO {
+    'id': string;
+    'region': string;
+    'gameType': string;
+    'instanceName': string;
+    'containerId'?: string | null;
+    'startedAt': string;
+    'lastHeartbeat': string;
+    'endedAt'?: string | null;
+    'online': boolean;
+}
+export interface TokenRequest {
+    'grant_type'?: string | null;
+    'client_id'?: string | null;
+    'client_secret'?: string | null;
+}
 /**
  * Request to update client metadata
  */
@@ -1386,140 +1421,280 @@ export declare class AdminPunishmentsApi extends BaseAPI {
     searchTargets(q: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPunishmentSearchResponse, any, {}>>;
 }
 /**
- * ConnectionApi - axios parameter creator
+ * AuthenticationApi - axios parameter creator
  */
-export declare const ConnectionApiAxiosParamCreator: (configuration?: Configuration) => {
+export declare const AuthenticationApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
-     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
-     * @summary Check Connection and Detect VPN/Proxy
-     * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
-     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
-     * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response.
+     * Receives the authorization code from Discord after the user approves the OAuth2 prompt. Exchanges the code for an access token, verifies the user holds an admin guild role, then redirects back to the admin frontend with a signed JWT in the query string (`?token=...`). On failure, redirects with `?error=<reason>` instead.
+     * @summary Discord - OAuth2 callback
+     * @param {string | null} [code] Authorization code provided by Discord on successful approval
+     * @param {string | null} [error] Error code provided by Discord if the user denied access
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getConnectionDetails: (ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    callback: (code?: string | null, error?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+     * @summary Discord - Initiate login
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    initiateLogin: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Exchange service client credentials for a Bearer JWT using the OAuth2 client_credentials grant. Used by game server plugins to authenticate against the API.
+     * @summary Service - Exchange client credentials for token
+     * @param {string | null} [grantType]
+     * @param {string | null} [clientId]
+     * @param {string | null} [clientSecret]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    token: (grantType?: string | null, clientId?: string | null, clientSecret?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
 };
 /**
- * ConnectionApi - functional programming interface
+ * AuthenticationApi - functional programming interface
  */
-export declare const ConnectionApiFp: (configuration?: Configuration) => {
+export declare const AuthenticationApiFp: (configuration?: Configuration) => {
     /**
-     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
-     * @summary Check Connection and Detect VPN/Proxy
-     * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
-     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
-     * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response.
+     * Receives the authorization code from Discord after the user approves the OAuth2 prompt. Exchanges the code for an access token, verifies the user holds an admin guild role, then redirects back to the admin frontend with a signed JWT in the query string (`?token=...`). On failure, redirects with `?error=<reason>` instead.
+     * @summary Discord - OAuth2 callback
+     * @param {string | null} [code] Authorization code provided by Discord on successful approval
+     * @param {string | null} [error] Error code provided by Discord if the user denied access
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ConnectionGetConnectionDetailsResponse>>;
+    callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+     * @summary Discord - Initiate login
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    initiateLogin(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * Exchange service client credentials for a Bearer JWT using the OAuth2 client_credentials grant. Used by game server plugins to authenticate against the API.
+     * @summary Service - Exchange client credentials for token
+     * @param {string | null} [grantType]
+     * @param {string | null} [clientId]
+     * @param {string | null} [clientSecret]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    token(grantType?: string | null, clientId?: string | null, clientSecret?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<object>>;
 };
 /**
- * ConnectionApi - factory interface
+ * AuthenticationApi - factory interface
  */
-export declare const ConnectionApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+export declare const AuthenticationApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
-     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
-     * @summary Check Connection and Detect VPN/Proxy
-     * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
-     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
-     * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response.
+     * Receives the authorization code from Discord after the user approves the OAuth2 prompt. Exchanges the code for an access token, verifies the user holds an admin guild role, then redirects back to the admin frontend with a signed JWT in the query string (`?token=...`). On failure, redirects with `?error=<reason>` instead.
+     * @summary Discord - OAuth2 callback
+     * @param {string | null} [code] Authorization code provided by Discord on successful approval
+     * @param {string | null} [error] Error code provided by Discord if the user denied access
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<ConnectionGetConnectionDetailsResponse>;
+    callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+     * @summary Discord - Initiate login
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    initiateLogin(options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * Exchange service client credentials for a Bearer JWT using the OAuth2 client_credentials grant. Used by game server plugins to authenticate against the API.
+     * @summary Service - Exchange client credentials for token
+     * @param {string | null} [grantType]
+     * @param {string | null} [clientId]
+     * @param {string | null} [clientSecret]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    token(grantType?: string | null, clientId?: string | null, clientSecret?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<object>;
 };
 /**
- * ConnectionApi - object-oriented interface
+ * AuthenticationApi - object-oriented interface
  */
-export declare class ConnectionApi extends BaseAPI {
+export declare class AuthenticationApi extends BaseAPI {
     /**
-     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
-     * @summary Check Connection and Detect VPN/Proxy
-     * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
-     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
-     * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response.
+     * Receives the authorization code from Discord after the user approves the OAuth2 prompt. Exchanges the code for an access token, verifies the user holds an admin guild role, then redirects back to the admin frontend with a signed JWT in the query string (`?token=...`). On failure, redirects with `?error=<reason>` instead.
+     * @summary Discord - OAuth2 callback
+     * @param {string | null} [code] Authorization code provided by Discord on successful approval
+     * @param {string | null} [error] Error code provided by Discord if the user denied access
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ConnectionGetConnectionDetailsResponse, any, {}>>;
+    callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+     * @summary Discord - Initiate login
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    initiateLogin(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     * Exchange service client credentials for a Bearer JWT using the OAuth2 client_credentials grant. Used by game server plugins to authenticate against the API.
+     * @summary Service - Exchange client credentials for token
+     * @param {string | null} [grantType]
+     * @param {string | null} [clientId]
+     * @param {string | null} [clientSecret]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    token(grantType?: string | null, clientId?: string | null, clientSecret?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<object, any, {}>>;
 }
 /**
- * DefaultApi - axios parameter creator
+ * ChatApi - axios parameter creator
  */
-export declare const DefaultApiAxiosParamCreator: (configuration?: Configuration) => {
+export declare const ChatApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
-     *
-     * @param {string | null} [code]
-     * @param {string | null} [error]
+     * Returns up to `limit` chat messages before the given `before` timestamp (keyset pagination). Results are returned in ascending chronological order. Omit `before` to start from the current time. Scroll back through history by passing the `sentAt` of the oldest message received as the next `before` value.
+     * @summary Get chat history
+     * @param {number} limit Maximum number of messages to return (1–100)
+     * @param {string | null} [sessionId] Filter to a specific server session. Omit for global history.
+     * @param {string | null} [before] ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    callback: (code?: string | null, error?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    history: (limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     *
+     * Stores a chat message from a game server and fans it out to all connected WebSocket clients via PostgreSQL LISTEN/NOTIFY. The session must be currently online. Only the player UUID is stored — usernames are resolved on the web UI from the player database cache.
+     * @summary Ingest a chat message
+     * @param {ChatMessageRequest} chatMessageRequest
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    initiateLogin: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    ingest: (chatMessageRequest: ChatMessageRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * ChatApi - functional programming interface
+ */
+export declare const ChatApiFp: (configuration?: Configuration) => {
+    /**
+     * Returns up to `limit` chat messages before the given `before` timestamp (keyset pagination). Results are returned in ascending chronological order. Omit `before` to start from the current time. Scroll back through history by passing the `sentAt` of the oldest message received as the next `before` value.
+     * @summary Get chat history
+     * @param {number} limit Maximum number of messages to return (1–100)
+     * @param {string | null} [sessionId] Filter to a specific server session. Omit for global history.
+     * @param {string | null} [before] ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    history(limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<ChatMessageDTO>>>;
+    /**
+     * Stores a chat message from a game server and fans it out to all connected WebSocket clients via PostgreSQL LISTEN/NOTIFY. The session must be currently online. Only the player UUID is stored — usernames are resolved on the web UI from the player database cache.
+     * @summary Ingest a chat message
+     * @param {ChatMessageRequest} chatMessageRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    ingest(chatMessageRequest: ChatMessageRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ChatMessageDTO>>;
 };
 /**
- * DefaultApi - functional programming interface
+ * ChatApi - factory interface
  */
-export declare const DefaultApiFp: (configuration?: Configuration) => {
+export declare const ChatApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
-     *
-     * @param {string | null} [code]
-     * @param {string | null} [error]
+     * Returns up to `limit` chat messages before the given `before` timestamp (keyset pagination). Results are returned in ascending chronological order. Omit `before` to start from the current time. Scroll back through history by passing the `sentAt` of the oldest message received as the next `before` value.
+     * @summary Get chat history
+     * @param {number} limit Maximum number of messages to return (1–100)
+     * @param {string | null} [sessionId] Filter to a specific server session. Omit for global history.
+     * @param {string | null} [before] ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<object>>;
+    history(limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<ChatMessageDTO>>;
     /**
-     *
+     * Stores a chat message from a game server and fans it out to all connected WebSocket clients via PostgreSQL LISTEN/NOTIFY. The session must be currently online. Only the player UUID is stored — usernames are resolved on the web UI from the player database cache.
+     * @summary Ingest a chat message
+     * @param {ChatMessageRequest} chatMessageRequest
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    initiateLogin(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<object>>;
+    ingest(chatMessageRequest: ChatMessageRequest, options?: RawAxiosRequestConfig): AxiosPromise<ChatMessageDTO>;
 };
 /**
- * DefaultApi - factory interface
+ * ChatApi - object-oriented interface
+ */
+export declare class ChatApi extends BaseAPI {
+    /**
+     * Returns up to `limit` chat messages before the given `before` timestamp (keyset pagination). Results are returned in ascending chronological order. Omit `before` to start from the current time. Scroll back through history by passing the `sentAt` of the oldest message received as the next `before` value.
+     * @summary Get chat history
+     * @param {number} limit Maximum number of messages to return (1–100)
+     * @param {string | null} [sessionId] Filter to a specific server session. Omit for global history.
+     * @param {string | null} [before] ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    history(limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ChatMessageDTO[], any, {}>>;
+    /**
+     * Stores a chat message from a game server and fans it out to all connected WebSocket clients via PostgreSQL LISTEN/NOTIFY. The session must be currently online. Only the player UUID is stored — usernames are resolved on the web UI from the player database cache.
+     * @summary Ingest a chat message
+     * @param {ChatMessageRequest} chatMessageRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    ingest(chatMessageRequest: ChatMessageRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ChatMessageDTO, any, {}>>;
+}
+/**
+ * ConnectionApi - axios parameter creator
  */
-export declare const DefaultApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+export declare const ConnectionApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
-     *
-     * @param {string | null} [code]
-     * @param {string | null} [error]
+     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
+     * @summary Check Connection and Detect VPN/Proxy
+     * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
+     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
+     * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<object>;
+    getConnectionDetails: (ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * ConnectionApi - functional programming interface
+ */
+export declare const ConnectionApiFp: (configuration?: Configuration) => {
     /**
-     *
+     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
+     * @summary Check Connection and Detect VPN/Proxy
+     * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
+     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
+     * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    initiateLogin(options?: RawAxiosRequestConfig): AxiosPromise<object>;
+    getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ConnectionGetConnectionDetailsResponse>>;
 };
 /**
- * DefaultApi - object-oriented interface
+ * ConnectionApi - factory interface
  */
-export declare class DefaultApi extends BaseAPI {
+export declare const ConnectionApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
-     *
-     * @param {string | null} [code]
-     * @param {string | null} [error]
+     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
+     * @summary Check Connection and Detect VPN/Proxy
+     * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
+     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
+     * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<object, any, {}>>;
+    getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<ConnectionGetConnectionDetailsResponse>;
+};
+/**
+ * ConnectionApi - object-oriented interface
+ */
+export declare class ConnectionApi extends BaseAPI {
     /**
-     *
+     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
+     * @summary Check Connection and Detect VPN/Proxy
+     * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
+     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
+     * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    initiateLogin(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<object, any, {}>>;
+    getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ConnectionGetConnectionDetailsResponse, any, {}>>;
 }
 /**
  * PlayerApi - axios parameter creator
@@ -1527,12 +1702,20 @@ export declare class DefaultApi extends BaseAPI {
 export declare const PlayerApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
      * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials.
-     * @summary Get Player Information
+     * @summary Get player information
      * @param {string} uuid The Minecraft player UUID (with or without dashes)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     getPlayer1: (uuid: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log.
+     * @summary Batch resolve UUIDs to usernames
+     * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getUsernames: (uuids: Array<string>, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
 };
 /**
  * PlayerApi - functional programming interface
@@ -1540,12 +1723,20 @@ export declare const PlayerApiAxiosParamCreator: (configuration?: Configuration)
 export declare const PlayerApiFp: (configuration?: Configuration) => {
     /**
      * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials.
-     * @summary Get Player Information
+     * @summary Get player information
      * @param {string} uuid The Minecraft player UUID (with or without dashes)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     getPlayer1(uuid: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PlayerGetPlayerInformation>>;
+    /**
+     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log.
+     * @summary Batch resolve UUIDs to usernames
+     * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getUsernames(uuids: Array<string>, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
 };
 /**
  * PlayerApi - factory interface
@@ -1553,12 +1744,20 @@ export declare const PlayerApiFp: (configuration?: Configuration) => {
 export declare const PlayerApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
      * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials.
-     * @summary Get Player Information
+     * @summary Get player information
      * @param {string} uuid The Minecraft player UUID (with or without dashes)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     getPlayer1(uuid: string, options?: RawAxiosRequestConfig): AxiosPromise<PlayerGetPlayerInformation>;
+    /**
+     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log.
+     * @summary Batch resolve UUIDs to usernames
+     * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getUsernames(uuids: Array<string>, options?: RawAxiosRequestConfig): AxiosPromise<void>;
 };
 /**
  * PlayerApi - object-oriented interface
@@ -1566,12 +1765,20 @@ export declare const PlayerApiFactory: (configuration?: Configuration, basePath?
 export declare class PlayerApi extends BaseAPI {
     /**
      * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials.
-     * @summary Get Player Information
+     * @summary Get player information
      * @param {string} uuid The Minecraft player UUID (with or without dashes)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     getPlayer1(uuid: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PlayerGetPlayerInformation, any, {}>>;
+    /**
+     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log.
+     * @summary Batch resolve UUIDs to usernames
+     * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getUsernames(uuids: Array<string>, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
 }
 /**
  * PunishmentApi - axios parameter creator
@@ -1761,3 +1968,175 @@ export declare class PunishmentApi extends BaseAPI {
      */
     getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<string> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PunishmentGetPunishmentResponse[], any, {}>>;
 }
+/**
+ * ServerSessionsApi - axios parameter creator
+ */
+export declare const ServerSessionsApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server.
+     * @summary Send a heartbeat
+     * @param {string} id Session UUID returned from the registration call
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    heartbeat: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Returns all server sessions — both online and historical — ordered by start time descending. Used by the web UI to populate the session filter dropdown.
+     * @summary List all server sessions
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listAll: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Returns all currently online server sessions, ordered by start time descending.
+     * @summary List online server sessions
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listOnline: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Marks the session as offline with the current timestamp as `endedAt`. Call this from the game server\'s shutdown hook for a clean shutdown signal. Sessions that crash without calling this endpoint will be tombstoned automatically by the 2-minute heartbeat scheduler.
+     * @summary Mark a session offline
+     * @param {string} id Session UUID returned from the registration call
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    markOffline: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Registers a game server instance and returns a session ID used for subsequent heartbeats and chat ingestion. If a `containerId` is provided and an online session already exists for that container (e.g. after a Velocity restart), the existing session is returned unchanged. Otherwise a fresh session is created with an auto-generated instance name.
+     * @summary Register a server session
+     * @param {ServerRegisterRequest} serverRegisterRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    register: (serverRegisterRequest: ServerRegisterRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * ServerSessionsApi - functional programming interface
+ */
+export declare const ServerSessionsApiFp: (configuration?: Configuration) => {
+    /**
+     * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server.
+     * @summary Send a heartbeat
+     * @param {string} id Session UUID returned from the registration call
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    heartbeat(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * Returns all server sessions — both online and historical — ordered by start time descending. Used by the web UI to populate the session filter dropdown.
+     * @summary List all server sessions
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listAll(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<ServerSessionDTO>>>;
+    /**
+     * Returns all currently online server sessions, ordered by start time descending.
+     * @summary List online server sessions
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listOnline(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<ServerSessionDTO>>>;
+    /**
+     * Marks the session as offline with the current timestamp as `endedAt`. Call this from the game server\'s shutdown hook for a clean shutdown signal. Sessions that crash without calling this endpoint will be tombstoned automatically by the 2-minute heartbeat scheduler.
+     * @summary Mark a session offline
+     * @param {string} id Session UUID returned from the registration call
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    markOffline(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * Registers a game server instance and returns a session ID used for subsequent heartbeats and chat ingestion. If a `containerId` is provided and an online session already exists for that container (e.g. after a Velocity restart), the existing session is returned unchanged. Otherwise a fresh session is created with an auto-generated instance name.
+     * @summary Register a server session
+     * @param {ServerRegisterRequest} serverRegisterRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    register(serverRegisterRequest: ServerRegisterRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ServerSessionDTO>>;
+};
+/**
+ * ServerSessionsApi - factory interface
+ */
+export declare const ServerSessionsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server.
+     * @summary Send a heartbeat
+     * @param {string} id Session UUID returned from the registration call
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    heartbeat(id: string, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * Returns all server sessions — both online and historical — ordered by start time descending. Used by the web UI to populate the session filter dropdown.
+     * @summary List all server sessions
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listAll(options?: RawAxiosRequestConfig): AxiosPromise<Array<ServerSessionDTO>>;
+    /**
+     * Returns all currently online server sessions, ordered by start time descending.
+     * @summary List online server sessions
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listOnline(options?: RawAxiosRequestConfig): AxiosPromise<Array<ServerSessionDTO>>;
+    /**
+     * Marks the session as offline with the current timestamp as `endedAt`. Call this from the game server\'s shutdown hook for a clean shutdown signal. Sessions that crash without calling this endpoint will be tombstoned automatically by the 2-minute heartbeat scheduler.
+     * @summary Mark a session offline
+     * @param {string} id Session UUID returned from the registration call
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    markOffline(id: string, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * Registers a game server instance and returns a session ID used for subsequent heartbeats and chat ingestion. If a `containerId` is provided and an online session already exists for that container (e.g. after a Velocity restart), the existing session is returned unchanged. Otherwise a fresh session is created with an auto-generated instance name.
+     * @summary Register a server session
+     * @param {ServerRegisterRequest} serverRegisterRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    register(serverRegisterRequest: ServerRegisterRequest, options?: RawAxiosRequestConfig): AxiosPromise<ServerSessionDTO>;
+};
+/**
+ * ServerSessionsApi - object-oriented interface
+ */
+export declare class ServerSessionsApi extends BaseAPI {
+    /**
+     * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server.
+     * @summary Send a heartbeat
+     * @param {string} id Session UUID returned from the registration call
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    heartbeat(id: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     * Returns all server sessions — both online and historical — ordered by start time descending. Used by the web UI to populate the session filter dropdown.
+     * @summary List all server sessions
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listAll(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ServerSessionDTO[], any, {}>>;
+    /**
+     * Returns all currently online server sessions, ordered by start time descending.
+     * @summary List online server sessions
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listOnline(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ServerSessionDTO[], any, {}>>;
+    /**
+     * Marks the session as offline with the current timestamp as `endedAt`. Call this from the game server\'s shutdown hook for a clean shutdown signal. Sessions that crash without calling this endpoint will be tombstoned automatically by the 2-minute heartbeat scheduler.
+     * @summary Mark a session offline
+     * @param {string} id Session UUID returned from the registration call
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    markOffline(id: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     * Registers a game server instance and returns a session ID used for subsequent heartbeats and chat ingestion. If a `containerId` is provided and an online session already exists for that container (e.g. after a Velocity restart), the existing session is returned unchanged. Otherwise a fresh session is created with an auto-generated instance name.
+     * @summary Register a server session
+     * @param {ServerRegisterRequest} serverRegisterRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    register(serverRegisterRequest: ServerRegisterRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ServerSessionDTO, any, {}>>;
+}