@rebornteam/reborn-api 2.6.0 → 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.0
+ * The version of the OpenAPI document: 2.7.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -13,6 +13,87 @@ import type { Configuration } from './configuration';
 import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
 import type { RequestArgs } from './base';
 import { BaseAPI } from './base';
+/**
+ * Request to apply a punishment to one or more targets
+ */
+export interface AdminApplyPunishmentRequest {
+    /**
+     * List of targets to punish — each must have either a uuid or ipAddress
+     */
+    'targets': Array<AdminPunishmentTarget>;
+    /**
+     * Punishment type
+     */
+    'type': AdminApplyPunishmentRequestTypeEnum;
+    /**
+     * Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical
+     */
+    'severity'?: number;
+    /**
+     * Reason for the punishment
+     */
+    'reason': string;
+    /**
+     * Custom duration in seconds — if omitted the suggested duration for the type and severity is used
+     */
+    'durationSeconds'?: number | null;
+    /**
+     * Force the punishment to be permanent regardless of the target\'s current score
+     */
+    'forcePermanent'?: boolean;
+    /**
+     * Internal notes visible only to administrators — not shown to the punished player
+     */
+    'notes'?: string | null;
+}
+export declare const AdminApplyPunishmentRequestTypeEnum: {
+    readonly Ban: "BAN";
+    readonly Mute: "MUTE";
+    readonly Warning: "WARNING";
+};
+export type AdminApplyPunishmentRequestTypeEnum = typeof AdminApplyPunishmentRequestTypeEnum[keyof typeof AdminApplyPunishmentRequestTypeEnum];
+/**
+ * Batch punishment apply result — one result per target
+ */
+export interface AdminApplyPunishmentResponse {
+    /**
+     * Ordered list of results, one per target in the request
+     */
+    'results'?: Array<AdminApplyPunishmentResult>;
+}
+/**
+ * Result of applying a punishment to a single target
+ */
+export interface AdminApplyPunishmentResult {
+    /**
+     * The target this result applies to
+     */
+    'target'?: AdminPunishmentTarget;
+    /**
+     * ID of the created punishment record
+     */
+    'punishmentId'?: number;
+    /**
+     * Punishment type applied
+     */
+    'type'?: string;
+    /**
+     * Severity level applied
+     */
+    'severity'?: number;
+    /**
+     * Updated punishment score after applying
+     */
+    'newScore'?: number;
+    /**
+     * Whether the punishment was made permanent
+     */
+    'isPermanent'?: boolean;
+    /**
+     * When the punishment expires — null if permanent or a WARNING
+     */
+    'expiresAt'?: string | null;
+}
 /**
  * Client credential response
  */
@@ -71,6 +152,41 @@ export interface AdminConnectionBypassResponse {
      */
     'createdAt'?: string;
 }
+/**
+ * Request to evaluate the impact of a punishment across one or more targets before applying
+ */
+export interface AdminCreatePunishmentDraftRequest {
+    /**
+     * List of targets to evaluate — each must have either a uuid or ipAddress
+     */
+    'targets': Array<AdminPunishmentTarget>;
+    /**
+     * Punishment type
+     */
+    'type': AdminCreatePunishmentDraftRequestTypeEnum;
+    /**
+     * Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical
+     */
+    'severity'?: number;
+    /**
+     * Reason for the punishment (not used in evaluation, required for apply)
+     */
+    'reason': string;
+    /**
+     * Custom duration in seconds — if omitted the suggested duration for the type and severity is used
+     */
+    'durationSeconds'?: number | null;
+    /**
+     * Force the punishment to be permanent regardless of the target\'s current score
+     */
+    'forcePermanent'?: boolean;
+}
+export declare const AdminCreatePunishmentDraftRequestTypeEnum: {
+    readonly Ban: "BAN";
+    readonly Mute: "MUTE";
+    readonly Warning: "WARNING";
+};
+export type AdminCreatePunishmentDraftRequestTypeEnum = typeof AdminCreatePunishmentDraftRequestTypeEnum[keyof typeof AdminCreatePunishmentDraftRequestTypeEnum];
 export interface AdminDashboardConnectionResponse {
     'id': number;
     'ipAddress': string;
@@ -88,6 +204,19 @@ export interface AdminGetDashboardStats {
     'totalConnections': number;
     'totalClients': number;
 }
+/**
+ * A single IP address match in a punishment search, with all players ever seen on that IP
+ */
+export interface AdminIpSearchResult {
+    /**
+     * IP address
+     */
+    'ipAddress'?: string;
+    /**
+     * Players ever seen on this IP
+     */
+    'players'?: Array<AdminPlayerSearchResult>;
+}
 /**
  * Paginated connection list response
  */
@@ -145,7 +274,7 @@ export interface AdminPagedPunishmentResponse {
     /**
      * Punishments on the current page
      */
-    'data'?: Array<PunishmentGetPunishmentResponse>;
+    'data'?: Array<AdminPunishmentListItem>;
     /**
      * Total number of punishments matching the filters
      */
@@ -204,6 +333,19 @@ export interface AdminPlayerDetailResponse {
      */
     'usernameHistory'?: Array<AdminUsernameHistoryEntry>;
 }
+/**
+ * Lightweight player reference used in search results and punishment evaluations
+ */
+export interface AdminPlayerSearchResult {
+    /**
+     * Player Minecraft UUID
+     */
+    'uuid'?: string;
+    /**
+     * Most recently seen username, null if never recorded
+     */
+    'username'?: string | null;
+}
 /**
  * Summary of a player record, used in list views
  */
@@ -242,79 +384,134 @@ export interface AdminPlayerSummary {
     'punishmentPointsPercent'?: number;
 }
 /**
- * A single entry in a player\'s username history
+ * Batch punishment draft — one evaluation per target
  */
-export interface AdminUsernameHistoryEntry {
-    /**
-     * The username at this point in time
-     */
-    'username'?: string;
+export interface AdminPunishmentDraftResponse {
     /**
-     * When this username was first observed (ISO-8601)
+     * Ordered list of evaluations, one per target in the request
      */
-    'changedAt'?: string;
+    'evaluations'?: Array<AdminPunishmentEvaluation>;
 }
 /**
- * Request to apply a punishment to a player
+ * Evaluation of a punishment\'s impact on a single target
  */
-export interface ApplyPunishmentRequest {
+export interface AdminPunishmentEvaluation {
     /**
-     * Player UUID to punish
+     * The target this evaluation applies to
      */
-    'playerUuid': string;
+    'target'?: AdminPunishmentTarget;
     /**
-     * Reason for the punishment
+     * Players affected — one player for UUID targets, all players on the IP for connection targets
      */
-    'reason': string;
+    'affectedPlayers'?: Array<AdminPlayerSearchResult>;
     /**
-     * Type of punishment
+     * Current punishment score before applying this punishment (0–100+)
      */
-    'type': string;
+    'currentScore'?: number;
     /**
-     * Severity level of the punishment (1-10)
+     * Points this punishment would add to the score
      */
-    'severity': number;
+    'pointsToAdd'?: number;
     /**
-     * Staff member applying the punishment
+     * Projected score after applying this punishment
      */
-    'createdBy': string;
+    'newScore'?: number;
+    /**
+     * Whether this punishment would be permanent based on the current score threshold
+     */
+    'willBePermanent'?: boolean;
     /**
-     * Duration of the punishment in seconds. Null means permanent.
+     * Resolved duration in seconds — null if permanent or a WARNING
      */
     'durationSeconds'?: number | null;
+    /**
+     * Number of existing punishments on this target
+     */
+    'previousPunishmentCount'?: number;
+    /**
+     * True when the target is an IP address (connection punishment) rather than a player UUID
+     */
+    'isConnectionTarget'?: boolean;
+    /**
+     * The effective punishment type that will be applied — may differ from the requested type if escalated to BAN at threshold
+     */
+    'effectiveType'?: string;
+}
+export interface AdminPunishmentListItem {
+    'id': number;
+    'reason': string;
+    'notes'?: string | null;
+    'type': string;
+    'severity': number;
+    'createdBy': string;
+    'expiresAt'?: string | null;
+    'createdAt': string;
+    'targetType': string;
+    'targetUuid'?: string | null;
+    'targetUsername'?: string | null;
+    'targetIp'?: string | null;
 }
 /**
- * Response after applying a punishment
+ * Result of a punishment target search — either a list of matching players or a list of matching IP addresses
  */
-export interface ApplyPunishmentResponse {
+export interface AdminPunishmentSearchResponse {
     /**
-     * ID of the created punishment
+     * Search kind — \'player\' for UUID/username searches, \'ip\' for IP address searches
      */
-    'punishmentId'?: number;
+    'kind'?: AdminPunishmentSearchResponseKindEnum;
     /**
-     * Player UUID punished
+     * Matching players — only populated when kind=\'player\'
      */
-    'playerUuid'?: string;
+    'players'?: Array<AdminPlayerSearchResult>;
     /**
-     * Type of punishment applied
+     * Matching IP addresses with their associated players — only populated when kind=\'ip\'
      */
-    'type'?: string;
+    'ipResults'?: Array<AdminIpSearchResult>;
+}
+export declare const AdminPunishmentSearchResponseKindEnum: {
+    readonly Player: "player";
+    readonly Ip: "ip";
+};
+export type AdminPunishmentSearchResponseKindEnum = typeof AdminPunishmentSearchResponseKindEnum[keyof typeof AdminPunishmentSearchResponseKindEnum];
+/**
+ * A target for a punishment — either a player UUID or an IP address (mutually exclusive)
+ */
+export interface AdminPunishmentTarget {
     /**
-     * Severity level (1-10)
+     * Player Minecraft UUID
      */
-    'severity'?: number;
+    'uuid'?: string | null;
     /**
-     * New total punishment score after applying
+     * IP address — when specified, the punishment is linked to the connection record and all players on that IP are shown as affected
      */
-    'newScore'?: number;
+    'ipAddress'?: string | null;
+}
+/**
+ * A single entry in a player\'s username history
+ */
+export interface AdminUsernameHistoryEntry {
     /**
-     * Whether this punishment is permanent
+     * The username at this point in time
      */
-    'isPermanent'?: boolean;
+    'username'?: string;
     /**
-     * Timestamp when punishment expires (ISO-8601 format, null if permanent)
+     * When this username was first observed (ISO-8601)
      */
-    'expiresAt'?: string;
+    '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
@@ -380,31 +577,6 @@ export interface CreateBypassRequest {
      */
     'expiresAtEpoch': number;
 }
-/**
- * Request to create a punishment draft for preview before applying
- */
-export interface CreatePunishmentDraftRequest {
-    /**
-     * Player UUID to punish
-     */
-    'playerUuid': string;
-    /**
-     * Reason for the punishment
-     */
-    'reason': string;
-    /**
-     * Type of punishment
-     */
-    'type': string;
-    /**
-     * Severity level of the punishment (1-10)
-     */
-    'severity': number;
-    /**
-     * Duration of the punishment in seconds. Null means permanent.
-     */
-    'durationSeconds'?: number | null;
-}
 /**
  * Player information including join history, tracking data, and punishment scoring
  */
@@ -426,51 +598,6 @@ export interface PlayerGetPlayerInformation {
      */
     'punishmentPointsPercent'?: number;
 }
-/**
- * Response containing punishment draft preview with calculated points and thresholds
- */
-export interface PunishmentDraftResponse {
-    /**
-     * Player UUID this punishment would apply to
-     */
-    'playerUuid'?: string;
-    /**
-     * Reason for the punishment
-     */
-    'reason'?: string;
-    /**
-     * Type of punishment
-     */
-    'type'?: string;
-    /**
-     * Severity level (1-10)
-     */
-    'severity'?: number;
-    /**
-     * Current total punishment score before applying this punishment
-     */
-    'currentScore'?: number;
-    /**
-     * Points this punishment would add
-     */
-    'pointsToAdd'?: number;
-    /**
-     * New total score after applying this punishment
-     */
-    'newScore'?: number;
-    /**
-     * Whether this punishment will be permanent
-     */
-    'willBePermanent'?: boolean;
-    /**
-     * Duration in seconds (null if permanent)
-     */
-    'durationSeconds'?: number;
-    /**
-     * Number of previous punishments for this player
-     */
-    'previousPunishmentCount'?: number;
-}
 /**
  * Punishment information including reason, type, creator, and expiration
  */
@@ -480,15 +607,19 @@ export interface PunishmentGetPunishmentResponse {
      */
     'id'?: number;
     /**
-     * Reason for the punishment
+     * Reason for the punishment, shown to the punished player
      */
     'reason'?: string;
     /**
-     * Type of punishment (e.g., BAN, MUTE, KICK, WARNING)
+     * Internal administrator notes — not shown to the punished player
+     */
+    'notes'?: string | null;
+    /**
+     * Type of punishment (BAN, MUTE, WARNING)
      */
     'type'?: string;
     /**
-     * Severity level of the punishment (1-10, where 10 is most severe)
+     * Severity level (1=Minor, 2=Moderate, 3=Severe, 4=Critical)
      */
     'severity'?: number;
     /**
@@ -539,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
  */
@@ -1096,6 +1248,22 @@ export declare class AdminPlayersApi extends BaseAPI {
  * AdminPunishmentsApi - axios parameter creator
  */
 export declare const AdminPunishmentsApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+     * @summary Apply punishment
+     * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    applyPunishment: (adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+     * @summary Evaluate punishment impact
+     * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createDraft: (adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
      * @summary List punishments
@@ -1104,18 +1272,42 @@ export declare const AdminPunishmentsApiAxiosParamCreator: (configuration?: Conf
      * @param {string | null} [uuid] Filter by player UUID
      * @param {string | null} [username] Filter by player username (case-insensitive substring match)
      * @param {string | null} [ipAddress] Filter by IP address
-     * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, KICK, WARNING). Repeatable.
+     * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, WARNING). Repeatable.
      * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (ms)
      * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (ms)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     getPunishments: (page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<string> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Search for players by UUID or username, or look up all players associated with an IP address. Used to populate the target table before issuing a punishment.
+     * @summary Search punishment targets
+     * @param {string} q UUID, username, or partial/full IP address to search for
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    searchTargets: (q: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
 };
 /**
  * AdminPunishmentsApi - functional programming interface
  */
 export declare const AdminPunishmentsApiFp: (configuration?: Configuration) => {
+    /**
+     * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+     * @summary Apply punishment
+     * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    applyPunishment(adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminApplyPunishmentResponse>>;
+    /**
+     * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+     * @summary Evaluate punishment impact
+     * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createDraft(adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPunishmentDraftResponse>>;
     /**
      * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
      * @summary List punishments
@@ -1124,18 +1316,42 @@ export declare const AdminPunishmentsApiFp: (configuration?: Configuration) => {
      * @param {string | null} [uuid] Filter by player UUID
      * @param {string | null} [username] Filter by player username (case-insensitive substring match)
      * @param {string | null} [ipAddress] Filter by IP address
-     * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, KICK, WARNING). Repeatable.
+     * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, WARNING). Repeatable.
      * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (ms)
      * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (ms)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     getPunishments(page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<string> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPagedPunishmentResponse>>;
+    /**
+     * Search for players by UUID or username, or look up all players associated with an IP address. Used to populate the target table before issuing a punishment.
+     * @summary Search punishment targets
+     * @param {string} q UUID, username, or partial/full IP address to search for
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    searchTargets(q: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPunishmentSearchResponse>>;
 };
 /**
  * AdminPunishmentsApi - factory interface
  */
 export declare const AdminPunishmentsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+     * @summary Apply punishment
+     * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    applyPunishment(adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminApplyPunishmentResponse>;
+    /**
+     * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+     * @summary Evaluate punishment impact
+     * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createDraft(adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminPunishmentDraftResponse>;
     /**
      * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
      * @summary List punishments
@@ -1144,18 +1360,42 @@ export declare const AdminPunishmentsApiFactory: (configuration?: Configuration,
      * @param {string | null} [uuid] Filter by player UUID
      * @param {string | null} [username] Filter by player username (case-insensitive substring match)
      * @param {string | null} [ipAddress] Filter by IP address
-     * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, KICK, WARNING). Repeatable.
+     * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, WARNING). Repeatable.
      * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (ms)
      * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (ms)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     getPunishments(page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<string> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<AdminPagedPunishmentResponse>;
+    /**
+     * Search for players by UUID or username, or look up all players associated with an IP address. Used to populate the target table before issuing a punishment.
+     * @summary Search punishment targets
+     * @param {string} q UUID, username, or partial/full IP address to search for
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    searchTargets(q: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminPunishmentSearchResponse>;
 };
 /**
  * AdminPunishmentsApi - object-oriented interface
  */
 export declare class AdminPunishmentsApi extends BaseAPI {
+    /**
+     * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+     * @summary Apply punishment
+     * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    applyPunishment(adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminApplyPunishmentResponse, any, {}>>;
+    /**
+     * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+     * @summary Evaluate punishment impact
+     * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createDraft(adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPunishmentDraftResponse, any, {}>>;
     /**
      * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
      * @summary List punishments
@@ -1164,149 +1404,297 @@ export declare class AdminPunishmentsApi extends BaseAPI {
      * @param {string | null} [uuid] Filter by player UUID
      * @param {string | null} [username] Filter by player username (case-insensitive substring match)
      * @param {string | null} [ipAddress] Filter by IP address
-     * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, KICK, WARNING). Repeatable.
+     * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, WARNING). Repeatable.
      * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (ms)
      * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (ms)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     getPunishments(page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<string> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPagedPunishmentResponse, any, {}>>;
+    /**
+     * Search for players by UUID or username, or look up all players associated with an IP address. Used to populate the target table before issuing a punishment.
+     * @summary Search punishment targets
+     * @param {string} q UUID, username, or partial/full IP address to search for
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    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>;
 };
 /**
- * DefaultApi - functional programming interface
+ * ChatApi - functional programming interface
  */
-export declare const DefaultApiFp: (configuration?: Configuration) => {
+export declare const ChatApiFp: (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<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<object>>;
+    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}
      */
-    initiateLogin(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<object>>;
+    ingest(chatMessageRequest: ChatMessageRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ChatMessageDTO>>;
 };
 /**
- * DefaultApi - factory interface
+ * ChatApi - factory interface
  */
-export declare const DefaultApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+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): 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): AxiosPromise<object>;
+    ingest(chatMessageRequest: ChatMessageRequest, options?: RawAxiosRequestConfig): AxiosPromise<ChatMessageDTO>;
 };
 /**
- * DefaultApi - object-oriented interface
+ * ChatApi - object-oriented interface
  */
-export declare class DefaultApi extends BaseAPI {
+export declare 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}
      */
-    callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<object, any, {}>>;
+    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}
      */
-    initiateLogin(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<object, any, {}>>;
+    ingest(chatMessageRequest: ChatMessageRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ChatMessageDTO, any, {}>>;
+}
+/**
+ * ConnectionApi - axios parameter creator
+ */
+export declare const ConnectionApiAxiosParamCreator: (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}
+     */
+    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}
+     */
+    getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ConnectionGetConnectionDetailsResponse>>;
+};
+/**
+ * ConnectionApi - factory interface
+ */
+export declare const ConnectionApiFactory: (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.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    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}
+     */
+    getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ConnectionGetConnectionDetailsResponse, any, {}>>;
 }
 /**
  * PlayerApi - axios parameter creator
@@ -1314,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
@@ -1327,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
@@ -1340,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
@@ -1353,33 +1765,25 @@ 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
  */
 export declare const PunishmentApiAxiosParamCreator: (configuration?: Configuration) => {
-    /**
-     * Create and apply a punishment to a player. Automatically determines if permanent based on current score threshold (≥100%).
-     * @summary Apply a punishment
-     * @param {ApplyPunishmentRequest} applyPunishmentRequest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    applyPunishment: (applyPunishmentRequest: ApplyPunishmentRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
-    /**
-     * Preview punishment impact before applying. Returns calculated points, current/new thresholds, and whether it will be permanent.
-     * @summary Create a punishment draft
-     * @param {CreatePunishmentDraftRequest} createPunishmentDraftRequest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    createPunishmentDraft: (createPunishmentDraftRequest: CreatePunishmentDraftRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Retrieve duration information for each punishment type and severity level (1-10)
      * @summary Get punishment severities
@@ -1427,22 +1831,6 @@ export declare const PunishmentApiAxiosParamCreator: (configuration?: Configurat
  * PunishmentApi - functional programming interface
  */
 export declare const PunishmentApiFp: (configuration?: Configuration) => {
-    /**
-     * Create and apply a punishment to a player. Automatically determines if permanent based on current score threshold (≥100%).
-     * @summary Apply a punishment
-     * @param {ApplyPunishmentRequest} applyPunishmentRequest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    applyPunishment(applyPunishmentRequest: ApplyPunishmentRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ApplyPunishmentResponse>>;
-    /**
-     * Preview punishment impact before applying. Returns calculated points, current/new thresholds, and whether it will be permanent.
-     * @summary Create a punishment draft
-     * @param {CreatePunishmentDraftRequest} createPunishmentDraftRequest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    createPunishmentDraft(createPunishmentDraftRequest: CreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PunishmentDraftResponse>>;
     /**
      * Retrieve duration information for each punishment type and severity level (1-10)
      * @summary Get punishment severities
@@ -1490,22 +1878,6 @@ export declare const PunishmentApiFp: (configuration?: Configuration) => {
  * PunishmentApi - factory interface
  */
 export declare const PunishmentApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
-    /**
-     * Create and apply a punishment to a player. Automatically determines if permanent based on current score threshold (≥100%).
-     * @summary Apply a punishment
-     * @param {ApplyPunishmentRequest} applyPunishmentRequest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    applyPunishment(applyPunishmentRequest: ApplyPunishmentRequest, options?: RawAxiosRequestConfig): AxiosPromise<ApplyPunishmentResponse>;
-    /**
-     * Preview punishment impact before applying. Returns calculated points, current/new thresholds, and whether it will be permanent.
-     * @summary Create a punishment draft
-     * @param {CreatePunishmentDraftRequest} createPunishmentDraftRequest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    createPunishmentDraft(createPunishmentDraftRequest: CreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): AxiosPromise<PunishmentDraftResponse>;
     /**
      * Retrieve duration information for each punishment type and severity level (1-10)
      * @summary Get punishment severities
@@ -1553,22 +1925,6 @@ export declare const PunishmentApiFactory: (configuration?: Configuration, baseP
  * PunishmentApi - object-oriented interface
  */
 export declare class PunishmentApi extends BaseAPI {
-    /**
-     * Create and apply a punishment to a player. Automatically determines if permanent based on current score threshold (≥100%).
-     * @summary Apply a punishment
-     * @param {ApplyPunishmentRequest} applyPunishmentRequest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    applyPunishment(applyPunishmentRequest: ApplyPunishmentRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ApplyPunishmentResponse, any, {}>>;
-    /**
-     * Preview punishment impact before applying. Returns calculated points, current/new thresholds, and whether it will be permanent.
-     * @summary Create a punishment draft
-     * @param {CreatePunishmentDraftRequest} createPunishmentDraftRequest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    createPunishmentDraft(createPunishmentDraftRequest: CreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PunishmentDraftResponse, any, {}>>;
     /**
      * Retrieve duration information for each punishment type and severity level (1-10)
      * @summary Get punishment severities
@@ -1612,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, {}>>;
+}