@rebornteam/reborn-api 2.6.4 → 2.8.0

package/api.ts

@@ -4,7 +4,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.8.0
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -518,6 +518,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
  */
@@ -675,6 +689,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
  */
@@ -2241,26 +2276,20 @@ export class AdminPunishmentsApi extends BaseAPI {
 
 
 /**
- * ConnectionApi - axios parameter creator
+ * AuthenticationApi - axios parameter creator
  */
-export const ConnectionApiAxiosParamCreator = function (configuration?: Configuration) {
+export const AuthenticationApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * 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\'s history - Update the player\'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\'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: async (ip: string, forceRecheck: boolean, associateUuid?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'ip' is not null or undefined
-            assertParamExists('getConnectionDetails', 'ip', ip)
-            // verify required parameter 'forceRecheck' is not null or undefined
-            assertParamExists('getConnectionDetails', 'forceRecheck', forceRecheck)
-            const localVarPath = `/v1/connection/get-connection-details/{ip}`
-                .replace(`{${"ip"}}`, encodeURIComponent(String(ip)));
+        callback: async (code?: string | null, error?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/auth/discord/callback`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -2276,19 +2305,103 @@ export const ConnectionApiAxiosParamCreator = function (configuration?: Configur
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
-            if (forceRecheck !== undefined) {
-                localVarQueryParameter['force_recheck'] = forceRecheck;
+            if (code !== undefined) {
+                localVarQueryParameter['code'] = code;
             }
 
-            if (associateUuid !== undefined) {
-                localVarQueryParameter['associate_uuid'] = associateUuid;
+            if (error !== undefined) {
+                localVarQueryParameter['error'] = error;
+            }
+
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 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: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/auth/discord`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 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: async (grantType?: string | null, clientId?: string | null, clientSecret?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/oauth/token`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+            const localVarFormParams = new URLSearchParams();
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+
+            if (grantType !== undefined) { 
+                localVarFormParams.set('grant_type', grantType as any);
+            }
+
+            if (clientId !== undefined) { 
+                localVarFormParams.set('client_id', clientId as any);
             }
 
+            if (clientSecret !== undefined) { 
+                localVarFormParams.set('client_secret', clientSecret as any);
+            }
+            localVarHeaderParameter['Content-Type'] = 'application/x-www-form-urlencoded';
             localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = localVarFormParams.toString();
 
             return {
                 url: toPathString(localVarUrlObj),
@@ -2299,84 +2412,156 @@ export const ConnectionApiAxiosParamCreator = function (configuration?: Configur
 };
 
 /**
- * ConnectionApi - functional programming interface
+ * AuthenticationApi - functional programming interface
  */
-export const ConnectionApiFp = function(configuration?: Configuration) {
-    const localVarAxiosParamCreator = ConnectionApiAxiosParamCreator(configuration)
+export const AuthenticationApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = AuthenticationApiAxiosParamCreator(configuration)
     return {
         /**
-         * 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}
          */
-        async getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ConnectionGetConnectionDetailsResponse>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.getConnectionDetails(ip, forceRecheck, associateUuid, options);
+        async callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.callback(code, error, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['ConnectionApi.getConnectionDetails']?.[localVarOperationServerIndex]?.url;
+            const localVarOperationServerBasePath = operationServerMap['AuthenticationApi.callback']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * 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}
+         */
+        async initiateLogin(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.initiateLogin(options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AuthenticationApi.initiateLogin']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * 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}
+         */
+        async token(grantType?: string | null, clientId?: string | null, clientSecret?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<object>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.token(grantType, clientId, clientSecret, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AuthenticationApi.token']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
     }
 };
 
 /**
- * ConnectionApi - factory interface
+ * AuthenticationApi - factory interface
  */
-export const ConnectionApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
-    const localVarFp = ConnectionApiFp(configuration)
+export const AuthenticationApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = AuthenticationApiFp(configuration)
     return {
         /**
-         * 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> {
-            return localVarFp.getConnectionDetails(ip, forceRecheck, associateUuid, options).then((request) => request(axios, basePath));
+        callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            return localVarFp.callback(code, error, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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> {
+            return localVarFp.initiateLogin(options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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> {
+            return localVarFp.token(grantType, clientId, clientSecret, options).then((request) => request(axios, basePath));
         },
     };
 };
 
 /**
- * ConnectionApi - object-oriented interface
+ * AuthenticationApi - object-oriented interface
  */
-export class ConnectionApi extends BaseAPI {
+export 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}
      */
-    public getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig) {
-        return ConnectionApiFp(this.configuration).getConnectionDetails(ip, forceRecheck, associateUuid, options).then((request) => request(this.axios, this.basePath));
+    public callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig) {
+        return AuthenticationApiFp(this.configuration).callback(code, error, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * 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}
+     */
+    public initiateLogin(options?: RawAxiosRequestConfig) {
+        return AuthenticationApiFp(this.configuration).initiateLogin(options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * 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}
+     */
+    public token(grantType?: string | null, clientId?: string | null, clientSecret?: string | null, options?: RawAxiosRequestConfig) {
+        return AuthenticationApiFp(this.configuration).token(grantType, clientId, clientSecret, options).then((request) => request(this.axios, this.basePath));
     }
 }
 
 
 
 /**
- * DefaultApi - axios parameter creator
+ * ChatApi - axios parameter creator
  */
-export const DefaultApiAxiosParamCreator = function (configuration?: Configuration) {
+export const ChatApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * 
-         * @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: async (code?: string | null, error?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            const localVarPath = `/auth/discord/callback`;
+        history: async (limit: number, sessionId?: string | null, before?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'limit' is not null or undefined
+            assertParamExists('history', 'limit', limit)
+            const localVarPath = `/v1/chat`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -2392,12 +2577,16 @@ export const DefaultApiAxiosParamCreator = function (configuration?: Configurati
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
-            if (code !== undefined) {
-                localVarQueryParameter['code'] = code;
+            if (sessionId !== undefined) {
+                localVarQueryParameter['sessionId'] = sessionId;
             }
 
-            if (error !== undefined) {
-                localVarQueryParameter['error'] = error;
+            if (before !== undefined) {
+                localVarQueryParameter['before'] = before;
+            }
+
+            if (limit !== undefined) {
+                localVarQueryParameter['limit'] = limit;
             }
 
             localVarHeaderParameter['Accept'] = 'application/json';
@@ -2412,12 +2601,16 @@ export const DefaultApiAxiosParamCreator = function (configuration?: Configurati
             };
         },
         /**
-         * 
+         * 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: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            const localVarPath = `/auth/discord`;
+        ingest: async (chatMessageRequest: ChatMessageRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'chatMessageRequest' is not null or undefined
+            assertParamExists('ingest', 'chatMessageRequest', chatMessageRequest)
+            const localVarPath = `/v1/chat`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -2425,7 +2618,7 @@ export const DefaultApiAxiosParamCreator = function (configuration?: Configurati
                 baseOptions = configuration.baseOptions;
             }
 
-            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
             const localVarHeaderParameter = {} as any;
             const localVarQueryParameter = {} as any;
 
@@ -2433,11 +2626,13 @@ export const DefaultApiAxiosParamCreator = function (configuration?: Configurati
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
+            localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(chatMessageRequest, localVarRequestOptions, configuration)
 
             return {
                 url: toPathString(localVarUrlObj),
@@ -2448,109 +2643,125 @@ export const DefaultApiAxiosParamCreator = function (configuration?: Configurati
 };
 
 /**
- * DefaultApi - functional programming interface
+ * ChatApi - functional programming interface
  */
-export const DefaultApiFp = function(configuration?: Configuration) {
-    const localVarAxiosParamCreator = DefaultApiAxiosParamCreator(configuration)
+export const ChatApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = ChatApiAxiosParamCreator(configuration)
     return {
         /**
-         * 
-         * @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}
          */
-        async callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<object>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.callback(code, error, options);
+        async history(limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<ChatMessageDTO>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.history(limit, sessionId, before, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['DefaultApi.callback']?.[localVarOperationServerIndex]?.url;
+            const localVarOperationServerBasePath = operationServerMap['ChatApi.history']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * 
+         * 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}
          */
-        async initiateLogin(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<object>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.initiateLogin(options);
+        async ingest(chatMessageRequest: ChatMessageRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ChatMessageDTO>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.ingest(chatMessageRequest, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['DefaultApi.initiateLogin']?.[localVarOperationServerIndex]?.url;
+            const localVarOperationServerBasePath = operationServerMap['ChatApi.ingest']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
     }
 };
 
 /**
- * DefaultApi - factory interface
+ * ChatApi - factory interface
  */
-export const DefaultApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
-    const localVarFp = DefaultApiFp(configuration)
+export const ChatApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = ChatApiFp(configuration)
     return {
         /**
-         * 
-         * @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): AxiosPromise<object> {
-            return localVarFp.callback(code, error, options).then((request) => request(axios, basePath));
+        history(limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<ChatMessageDTO>> {
+            return localVarFp.history(limit, sessionId, before, options).then((request) => request(axios, basePath));
         },
         /**
-         * 
+         * 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): AxiosPromise<object> {
-            return localVarFp.initiateLogin(options).then((request) => request(axios, basePath));
+        ingest(chatMessageRequest: ChatMessageRequest, options?: RawAxiosRequestConfig): AxiosPromise<ChatMessageDTO> {
+            return localVarFp.ingest(chatMessageRequest, options).then((request) => request(axios, basePath));
         },
     };
 };
 
 /**
- * DefaultApi - object-oriented interface
+ * ChatApi - object-oriented interface
  */
-export class DefaultApi extends BaseAPI {
+export class ChatApi extends BaseAPI {
     /**
-     * 
-     * @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}
      */
-    public callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig) {
-        return DefaultApiFp(this.configuration).callback(code, error, options).then((request) => request(this.axios, this.basePath));
+    public history(limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig) {
+        return ChatApiFp(this.configuration).history(limit, sessionId, before, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * 
+     * 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}
      */
-    public initiateLogin(options?: RawAxiosRequestConfig) {
-        return DefaultApiFp(this.configuration).initiateLogin(options).then((request) => request(this.axios, this.basePath));
+    public ingest(chatMessageRequest: ChatMessageRequest, options?: RawAxiosRequestConfig) {
+        return ChatApiFp(this.configuration).ingest(chatMessageRequest, options).then((request) => request(this.axios, this.basePath));
     }
 }
 
 
 
 /**
- * PlayerApi - axios parameter creator
+ * ConnectionApi - axios parameter creator
  */
-export const PlayerApiAxiosParamCreator = function (configuration?: Configuration) {
+export const ConnectionApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * 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
-         * @param {string} uuid The Minecraft player UUID (with or without dashes)
+         * 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}
          */
-        getPlayer1: async (uuid: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'uuid' is not null or undefined
-            assertParamExists('getPlayer1', 'uuid', uuid)
-            const localVarPath = `/v1/player/{uuid}`
-                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+        getConnectionDetails: async (ip: string, forceRecheck: boolean, associateUuid?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'ip' is not null or undefined
+            assertParamExists('getConnectionDetails', 'ip', ip)
+            // verify required parameter 'forceRecheck' is not null or undefined
+            assertParamExists('getConnectionDetails', 'forceRecheck', forceRecheck)
+            const localVarPath = `/v1/connection/get-connection-details/{ip}`
+                .replace(`{${"ip"}}`, encodeURIComponent(String(ip)));
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -2566,6 +2777,14 @@ export const PlayerApiAxiosParamCreator = function (configuration?: Configuratio
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
+            if (forceRecheck !== undefined) {
+                localVarQueryParameter['force_recheck'] = forceRecheck;
+            }
+
+            if (associateUuid !== undefined) {
+                localVarQueryParameter['associate_uuid'] = associateUuid;
+            }
+
             localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -2581,43 +2800,218 @@ export const PlayerApiAxiosParamCreator = function (configuration?: Configuratio
 };
 
 /**
- * PlayerApi - functional programming interface
+ * ConnectionApi - functional programming interface
  */
-export const PlayerApiFp = function(configuration?: Configuration) {
-    const localVarAxiosParamCreator = PlayerApiAxiosParamCreator(configuration)
+export const ConnectionApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = ConnectionApiAxiosParamCreator(configuration)
     return {
         /**
-         * 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
-         * @param {string} uuid The Minecraft player UUID (with or without dashes)
+         * 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}
          */
-        async getPlayer1(uuid: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PlayerGetPlayerInformation>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.getPlayer1(uuid, options);
+        async getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ConnectionGetConnectionDetailsResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getConnectionDetails(ip, forceRecheck, associateUuid, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['PlayerApi.getPlayer1']?.[localVarOperationServerIndex]?.url;
+            const localVarOperationServerBasePath = operationServerMap['ConnectionApi.getConnectionDetails']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
     }
 };
 
 /**
- * PlayerApi - factory interface
+ * ConnectionApi - factory interface
  */
-export const PlayerApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
-    const localVarFp = PlayerApiFp(configuration)
+export const ConnectionApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = ConnectionApiFp(configuration)
     return {
         /**
-         * 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
-         * @param {string} uuid The Minecraft player UUID (with or without dashes)
+         * 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}
          */
-        getPlayer1(uuid: string, options?: RawAxiosRequestConfig): AxiosPromise<PlayerGetPlayerInformation> {
-            return localVarFp.getPlayer1(uuid, options).then((request) => request(axios, basePath));
-        },
+        getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<ConnectionGetConnectionDetailsResponse> {
+            return localVarFp.getConnectionDetails(ip, forceRecheck, associateUuid, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+
+/**
+ * ConnectionApi - object-oriented interface
+ */
+export 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}
+     */
+    public getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig) {
+        return ConnectionApiFp(this.configuration).getConnectionDetails(ip, forceRecheck, associateUuid, options).then((request) => request(this.axios, this.basePath));
+    }
+}
+
+
+
+/**
+ * PlayerApi - axios parameter creator
+ */
+export const PlayerApiAxiosParamCreator = function (configuration?: Configuration) {
+    return {
+        /**
+         * 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
+         * @param {string} uuid The Minecraft player UUID (with or without dashes)
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getPlayer1: async (uuid: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('getPlayer1', 'uuid', uuid)
+            const localVarPath = `/v1/player/{uuid}`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 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: async (uuids: Array<string>, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'uuids' is not null or undefined
+            assertParamExists('getUsernames', 'uuids', uuids)
+            const localVarPath = `/v1/player/usernames`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            if (uuids) {
+                localVarQueryParameter['uuids'] = uuids.join(COLLECTION_FORMATS.csv);
+            }
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+    }
+};
+
+/**
+ * PlayerApi - functional programming interface
+ */
+export const PlayerApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = PlayerApiAxiosParamCreator(configuration)
+    return {
+        /**
+         * 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
+         * @param {string} uuid The Minecraft player UUID (with or without dashes)
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getPlayer1(uuid: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PlayerGetPlayerInformation>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getPlayer1(uuid, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['PlayerApi.getPlayer1']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * 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}
+         */
+        async getUsernames(uuids: Array<string>, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getUsernames(uuids, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['PlayerApi.getUsernames']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+    }
+};
+
+/**
+ * PlayerApi - factory interface
+ */
+export const PlayerApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = PlayerApiFp(configuration)
+    return {
+        /**
+         * 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
+         * @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> {
+            return localVarFp.getPlayer1(uuid, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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> {
+            return localVarFp.getUsernames(uuids, options).then((request) => request(axios, basePath));
+        },
     };
 };
 
@@ -2627,7 +3021,7 @@ export const PlayerApiFactory = function (configuration?: Configuration, basePat
 export 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}
@@ -2635,6 +3029,17 @@ export class PlayerApi extends BaseAPI {
     public getPlayer1(uuid: string, options?: RawAxiosRequestConfig) {
         return PlayerApiFp(this.configuration).getPlayer1(uuid, options).then((request) => request(this.axios, this.basePath));
     }
+
+    /**
+     * 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}
+     */
+    public getUsernames(uuids: Array<string>, options?: RawAxiosRequestConfig) {
+        return PlayerApiFp(this.configuration).getUsernames(uuids, options).then((request) => request(this.axios, this.basePath));
+    }
 }
 
 
@@ -3050,3 +3455,381 @@ export class PunishmentApi extends BaseAPI {
 
 
 
+/**
+ * ServerSessionsApi - axios parameter creator
+ */
+export const ServerSessionsApiAxiosParamCreator = function (configuration?: Configuration) {
+    return {
+        /**
+         * 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: async (id: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'id' is not null or undefined
+            assertParamExists('heartbeat', 'id', id)
+            const localVarPath = `/v1/servers/{id}/heartbeat`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'PUT', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 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: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/v1/servers/history`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 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: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/v1/servers`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 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: async (id: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'id' is not null or undefined
+            assertParamExists('markOffline', 'id', id)
+            const localVarPath = `/v1/servers/{id}/offline`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'PUT', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 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: async (serverRegisterRequest: ServerRegisterRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'serverRegisterRequest' is not null or undefined
+            assertParamExists('register', 'serverRegisterRequest', serverRegisterRequest)
+            const localVarPath = `/v1/servers`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(serverRegisterRequest, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+    }
+};
+
+/**
+ * ServerSessionsApi - functional programming interface
+ */
+export const ServerSessionsApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = ServerSessionsApiAxiosParamCreator(configuration)
+    return {
+        /**
+         * 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}
+         */
+        async heartbeat(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.heartbeat(id, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['ServerSessionsApi.heartbeat']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * 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}
+         */
+        async listAll(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<ServerSessionDTO>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.listAll(options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['ServerSessionsApi.listAll']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Returns all currently online server sessions, ordered by start time descending.
+         * @summary List online server sessions
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async listOnline(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<ServerSessionDTO>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.listOnline(options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['ServerSessionsApi.listOnline']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * 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}
+         */
+        async markOffline(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.markOffline(id, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['ServerSessionsApi.markOffline']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * 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}
+         */
+        async register(serverRegisterRequest: ServerRegisterRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ServerSessionDTO>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.register(serverRegisterRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['ServerSessionsApi.register']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+    }
+};
+
+/**
+ * ServerSessionsApi - factory interface
+ */
+export const ServerSessionsApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = ServerSessionsApiFp(configuration)
+    return {
+        /**
+         * 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> {
+            return localVarFp.heartbeat(id, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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>> {
+            return localVarFp.listAll(options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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>> {
+            return localVarFp.listOnline(options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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> {
+            return localVarFp.markOffline(id, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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> {
+            return localVarFp.register(serverRegisterRequest, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+
+/**
+ * ServerSessionsApi - object-oriented interface
+ */
+export 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}
+     */
+    public heartbeat(id: string, options?: RawAxiosRequestConfig) {
+        return ServerSessionsApiFp(this.configuration).heartbeat(id, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * 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}
+     */
+    public listAll(options?: RawAxiosRequestConfig) {
+        return ServerSessionsApiFp(this.configuration).listAll(options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Returns all currently online server sessions, ordered by start time descending.
+     * @summary List online server sessions
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public listOnline(options?: RawAxiosRequestConfig) {
+        return ServerSessionsApiFp(this.configuration).listOnline(options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * 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}
+     */
+    public markOffline(id: string, options?: RawAxiosRequestConfig) {
+        return ServerSessionsApiFp(this.configuration).markOffline(id, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * 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}
+     */
+    public register(serverRegisterRequest: ServerRegisterRequest, options?: RawAxiosRequestConfig) {
+        return ServerSessionsApiFp(this.configuration).register(serverRegisterRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+}
+
+
+