@rebornteam/reborn-api 4.5.0 → 4.7.0

package/.openapi-generator/FILES

@@ -92,6 +92,7 @@ docs/PageableMode.md
 docs/PlayerApi.md
 docs/PlayerGetPlayerInformation.md
 docs/PlayerSessionEndRequest.md
+docs/PlayerSessionEndResponse.md
 docs/PlayerSessionStartRequest.md
 docs/PlayerSessionStartResponse.md
 docs/PlayerSessionsApi.md
@@ -108,6 +109,7 @@ docs/Region.md
 docs/ReportApi.md
 docs/ReportCategory.md
 docs/SearchKind.md
+docs/ServerHeartbeatRequest.md
 docs/ServerRegisterRequest.md
 docs/ServerSessionDTO.md
 docs/ServerSessionsApi.md

package/README.md

@@ -1,4 +1,4 @@
-## @rebornteam/reborn-api@4.5.0
+## @rebornteam/reborn-api@4.7.0
 
 This generator creates TypeScript/JavaScript client that utilizes [axios](https://github.com/axios/axios). The generated Node module can be used in the following environments:
 
@@ -36,7 +36,7 @@ navigate to the folder of your consuming project and run one of the following co
 _published:_
 
 ```
-npm install @rebornteam/reborn-api@4.5.0 --save
+npm install @rebornteam/reborn-api@4.7.0 --save
 ```
 
 _unPublished (not recommended):_
@@ -200,6 +200,7 @@ Class | Method | HTTP request | Description
  - [PageableMode](docs/PageableMode.md)
  - [PlayerGetPlayerInformation](docs/PlayerGetPlayerInformation.md)
  - [PlayerSessionEndRequest](docs/PlayerSessionEndRequest.md)
+ - [PlayerSessionEndResponse](docs/PlayerSessionEndResponse.md)
  - [PlayerSessionStartRequest](docs/PlayerSessionStartRequest.md)
  - [PlayerSessionStartResponse](docs/PlayerSessionStartResponse.md)
  - [PunishmentGetPunishmentResponse](docs/PunishmentGetPunishmentResponse.md)
@@ -213,6 +214,7 @@ Class | Method | HTTP request | Description
  - [Region](docs/Region.md)
  - [ReportCategory](docs/ReportCategory.md)
  - [SearchKind](docs/SearchKind.md)
+ - [ServerHeartbeatRequest](docs/ServerHeartbeatRequest.md)
  - [ServerRegisterRequest](docs/ServerRegisterRequest.md)
  - [ServerSessionDTO](docs/ServerSessionDTO.md)
  - [SliceAdminAltAccount](docs/SliceAdminAltAccount.md)

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: 4.5.0
+ * The version of the OpenAPI document: 4.7.0
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -775,6 +775,10 @@ export interface AdminPlayerSession {
      * Closed session duration in seconds (ended_at − started_at). Null while active.
      */
     'durationSeconds'?: number | null;
+    /**
+     * When the player transferred to another server, the id of the session they moved to. Null for a normal disconnect or an active session.
+     */
+    'transferredTo'?: string | null;
 }
 /**
  * Aggregate session statistics for one player. Computed on demand from player_session.
@@ -1537,6 +1541,43 @@ export interface PlayerSessionEndRequest {
      */
     'serverSessionId': string;
 }
+/**
+ * Result of POST /v1/player-session/end. Confirms whether a session was closed and returns that session\'s lifetime plus the player\'s refreshed aggregate stats.
+ */
+export interface PlayerSessionEndResponse {
+    /**
+     * Player Minecraft UUID, echoed from the request
+     */
+    'playerUuid': string;
+    /**
+     * Server session id the player was on, echoed from the request
+     */
+    'serverSessionId': string;
+    /**
+     * True when an active session was found and closed by this call; false on a no-op (no active session existed, e.g. a duplicate/retried end event).
+     */
+    'sessionClosed': boolean;
+    /**
+     * Id of the session that was closed. Null on a no-op.
+     */
+    'sessionId'?: string | null;
+    /**
+     * When the closed session was opened (ISO-8601). Null on a no-op.
+     */
+    'startedAt'?: string | null;
+    /**
+     * When the session was closed (ISO-8601), i.e. now. Null on a no-op.
+     */
+    'endedAt'?: string | null;
+    /**
+     * Length of the closed session in seconds (endedAt - startedAt). Null on a no-op.
+     */
+    'durationSeconds'?: number | null;
+    /**
+     * Player\'s aggregate session stats, recomputed after this session was closed (so the just-ended session is included in the totals).
+     */
+    'sessionStats': AdminPlayerSessionStats;
+}
 /**
  * Unified player-join request. Runs the full authorization check (VPN, bypass, punishments) and conditionally opens a player_session for the allowed players.
  */
@@ -1784,6 +1825,15 @@ export const SearchKind = {
 export type SearchKind = typeof SearchKind[keyof typeof SearchKind];
 
 
+/**
+ * Optional heartbeat payload carrying the players currently on this server session.
+ */
+export interface ServerHeartbeatRequest {
+    /**
+     * UUIDs of players currently on this server session. Open sessions for this server whose player is absent from this list are auto-closed. Omit to heartbeat without reconciling player sessions.
+     */
+    'activePlayers'?: Array<string> | null;
+}
 export interface ServerRegisterRequest {
     'region': Region;
     'gameType': GameType;
@@ -7038,7 +7088,7 @@ export class PlayerApi extends BaseAPI {
 export const PlayerSessionsApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+         * Closes the active session for a (playerUuid, serverSessionId) pair and returns an acknowledgment: whether a session was actually closed, that session\'s start / end / duration, and the player\'s aggregate session stats recomputed after the close. No-op if no active session is found — `sessionClosed` is false and the per-session fields are null (stats are still returned) — so duplicate end events from a retry don\'t error.
          * @summary Close the active player session
          * @param {PlayerSessionEndRequest} playerSessionEndRequest 
          * @param {*} [options] Override http request option.
@@ -7064,6 +7114,7 @@ export const PlayerSessionsApiAxiosParamCreator = function (configuration?: Conf
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
@@ -7124,13 +7175,13 @@ export const PlayerSessionsApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = PlayerSessionsApiAxiosParamCreator(configuration)
     return {
         /**
-         * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+         * Closes the active session for a (playerUuid, serverSessionId) pair and returns an acknowledgment: whether a session was actually closed, that session\'s start / end / duration, and the player\'s aggregate session stats recomputed after the close. No-op if no active session is found — `sessionClosed` is false and the per-session fields are null (stats are still returned) — so duplicate end events from a retry don\'t error.
          * @summary Close the active player session
          * @param {PlayerSessionEndRequest} playerSessionEndRequest 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+        async end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PlayerSessionEndResponse>> {
             const localVarAxiosArgs = await localVarAxiosParamCreator.end(playerSessionEndRequest, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['PlayerSessionsApi.end']?.[localVarOperationServerIndex]?.url;
@@ -7159,13 +7210,13 @@ export const PlayerSessionsApiFactory = function (configuration?: Configuration,
     const localVarFp = PlayerSessionsApiFp(configuration)
     return {
         /**
-         * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+         * Closes the active session for a (playerUuid, serverSessionId) pair and returns an acknowledgment: whether a session was actually closed, that session\'s start / end / duration, and the player\'s aggregate session stats recomputed after the close. No-op if no active session is found — `sessionClosed` is false and the per-session fields are null (stats are still returned) — so duplicate end events from a retry don\'t error.
          * @summary Close the active player session
          * @param {PlayerSessionEndRequest} playerSessionEndRequest 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+        end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): AxiosPromise<PlayerSessionEndResponse> {
             return localVarFp.end(playerSessionEndRequest, options).then((request) => request(axios, basePath));
         },
         /**
@@ -7186,7 +7237,7 @@ export const PlayerSessionsApiFactory = function (configuration?: Configuration,
  */
 export class PlayerSessionsApi extends BaseAPI {
     /**
-     * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+     * Closes the active session for a (playerUuid, serverSessionId) pair and returns an acknowledgment: whether a session was actually closed, that session\'s start / end / duration, and the player\'s aggregate session stats recomputed after the close. No-op if no active session is found — `sessionClosed` is false and the per-session fields are null (stats are still returned) — so duplicate end events from a retry don\'t error.
      * @summary Close the active player session
      * @param {PlayerSessionEndRequest} playerSessionEndRequest 
      * @param {*} [options] Override http request option.
@@ -7723,13 +7774,14 @@ export class ReportApi extends BaseAPI {
 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. 
+         * 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.  Optionally include an `activePlayers` list (the UUIDs currently on this server). When present, the API reconciles player sessions for this server: any open session whose player is absent from the list is closed, and linked to the player\'s new session if they transferred to another server. Omit the body for a plain liveness heartbeat. 
          * @summary Send a heartbeat
          * @param {string} id Session UUID returned from the registration call
+         * @param {ServerHeartbeatRequest} [serverHeartbeatRequest] 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        heartbeat: async (id: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        heartbeat: async (id: string, serverHeartbeatRequest?: ServerHeartbeatRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
             // verify required parameter 'id' is not null or undefined
             assertParamExists('heartbeat', 'id', id)
             const localVarPath = `/v1/servers/{id}/heartbeat`
@@ -7749,10 +7801,12 @@ export const ServerSessionsApiAxiosParamCreator = function (configuration?: Conf
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
+            localVarHeaderParameter['Content-Type'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(serverHeartbeatRequest, localVarRequestOptions, configuration)
 
             return {
                 url: toPathString(localVarUrlObj),
@@ -7913,14 +7967,15 @@ 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. 
+         * 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.  Optionally include an `activePlayers` list (the UUIDs currently on this server). When present, the API reconciles player sessions for this server: any open session whose player is absent from the list is closed, and linked to the player\'s new session if they transferred to another server. Omit the body for a plain liveness heartbeat. 
          * @summary Send a heartbeat
          * @param {string} id Session UUID returned from the registration call
+         * @param {ServerHeartbeatRequest} [serverHeartbeatRequest] 
          * @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);
+        async heartbeat(id: string, serverHeartbeatRequest?: ServerHeartbeatRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.heartbeat(id, serverHeartbeatRequest, 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);
@@ -7985,14 +8040,15 @@ export const ServerSessionsApiFactory = function (configuration?: Configuration,
     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. 
+         * 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.  Optionally include an `activePlayers` list (the UUIDs currently on this server). When present, the API reconciles player sessions for this server: any open session whose player is absent from the list is closed, and linked to the player\'s new session if they transferred to another server. Omit the body for a plain liveness heartbeat. 
          * @summary Send a heartbeat
          * @param {string} id Session UUID returned from the registration call
+         * @param {ServerHeartbeatRequest} [serverHeartbeatRequest] 
          * @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));
+        heartbeat(id: string, serverHeartbeatRequest?: ServerHeartbeatRequest, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            return localVarFp.heartbeat(id, serverHeartbeatRequest, 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.
@@ -8040,14 +8096,15 @@ export const ServerSessionsApiFactory = function (configuration?: Configuration,
  */
 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. 
+     * 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.  Optionally include an `activePlayers` list (the UUIDs currently on this server). When present, the API reconciles player sessions for this server: any open session whose player is absent from the list is closed, and linked to the player\'s new session if they transferred to another server. Omit the body for a plain liveness heartbeat. 
      * @summary Send a heartbeat
      * @param {string} id Session UUID returned from the registration call
+     * @param {ServerHeartbeatRequest} [serverHeartbeatRequest] 
      * @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));
+    public heartbeat(id: string, serverHeartbeatRequest?: ServerHeartbeatRequest, options?: RawAxiosRequestConfig) {
+        return ServerSessionsApiFp(this.configuration).heartbeat(id, serverHeartbeatRequest, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**

package/base.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: 4.5.0
+ * The version of the OpenAPI document: 4.7.0
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/common.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: 4.5.0
+ * The version of the OpenAPI document: 4.7.0
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/configuration.ts

@@ -3,7 +3,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: 4.5.0
+ * The version of the OpenAPI document: 4.7.0
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

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: 4.5.0
+ * The version of the OpenAPI document: 4.7.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -755,6 +755,10 @@ export interface AdminPlayerSession {
      * Closed session duration in seconds (ended_at − started_at). Null while active.
      */
     'durationSeconds'?: number | null;
+    /**
+     * When the player transferred to another server, the id of the session they moved to. Null for a normal disconnect or an active session.
+     */
+    'transferredTo'?: string | null;
 }
 /**
  * Aggregate session statistics for one player. Computed on demand from player_session.
@@ -1485,6 +1489,43 @@ export interface PlayerSessionEndRequest {
      */
     'serverSessionId': string;
 }
+/**
+ * Result of POST /v1/player-session/end. Confirms whether a session was closed and returns that session\'s lifetime plus the player\'s refreshed aggregate stats.
+ */
+export interface PlayerSessionEndResponse {
+    /**
+     * Player Minecraft UUID, echoed from the request
+     */
+    'playerUuid': string;
+    /**
+     * Server session id the player was on, echoed from the request
+     */
+    'serverSessionId': string;
+    /**
+     * True when an active session was found and closed by this call; false on a no-op (no active session existed, e.g. a duplicate/retried end event).
+     */
+    'sessionClosed': boolean;
+    /**
+     * Id of the session that was closed. Null on a no-op.
+     */
+    'sessionId'?: string | null;
+    /**
+     * When the closed session was opened (ISO-8601). Null on a no-op.
+     */
+    'startedAt'?: string | null;
+    /**
+     * When the session was closed (ISO-8601), i.e. now. Null on a no-op.
+     */
+    'endedAt'?: string | null;
+    /**
+     * Length of the closed session in seconds (endedAt - startedAt). Null on a no-op.
+     */
+    'durationSeconds'?: number | null;
+    /**
+     * Player\'s aggregate session stats, recomputed after this session was closed (so the just-ended session is included in the totals).
+     */
+    'sessionStats': AdminPlayerSessionStats;
+}
 /**
  * Unified player-join request. Runs the full authorization check (VPN, bypass, punishments) and conditionally opens a player_session for the allowed players.
  */
@@ -1700,6 +1741,15 @@ export declare const SearchKind: {
     readonly Ip: "IP";
 };
 export type SearchKind = typeof SearchKind[keyof typeof SearchKind];
+/**
+ * Optional heartbeat payload carrying the players currently on this server session.
+ */
+export interface ServerHeartbeatRequest {
+    /**
+     * UUIDs of players currently on this server session. Open sessions for this server whose player is absent from this list are auto-closed. Omit to heartbeat without reconciling player sessions.
+     */
+    'activePlayers'?: Array<string> | null;
+}
 export interface ServerRegisterRequest {
     'region': Region;
     'gameType': GameType;
@@ -4189,7 +4239,7 @@ export declare class PlayerApi extends BaseAPI {
  */
 export declare const PlayerSessionsApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
-     * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+     * Closes the active session for a (playerUuid, serverSessionId) pair and returns an acknowledgment: whether a session was actually closed, that session\'s start / end / duration, and the player\'s aggregate session stats recomputed after the close. No-op if no active session is found — `sessionClosed` is false and the per-session fields are null (stats are still returned) — so duplicate end events from a retry don\'t error.
      * @summary Close the active player session
      * @param {PlayerSessionEndRequest} playerSessionEndRequest
      * @param {*} [options] Override http request option.
@@ -4210,13 +4260,13 @@ export declare const PlayerSessionsApiAxiosParamCreator: (configuration?: Config
  */
 export declare const PlayerSessionsApiFp: (configuration?: Configuration) => {
     /**
-     * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+     * Closes the active session for a (playerUuid, serverSessionId) pair and returns an acknowledgment: whether a session was actually closed, that session\'s start / end / duration, and the player\'s aggregate session stats recomputed after the close. No-op if no active session is found — `sessionClosed` is false and the per-session fields are null (stats are still returned) — so duplicate end events from a retry don\'t error.
      * @summary Close the active player session
      * @param {PlayerSessionEndRequest} playerSessionEndRequest
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PlayerSessionEndResponse>>;
     /**
      * Single round-trip the game server / proxy makes when a player joins. Runs the full authorization check (VPN detection, bypass tiers, punishment propagation, active-ban evaluation) and — only if allowed — opens (or re-attaches to) a player_session row.  Replaces the older two-call flow (`GET /v1/connection/details` followed by a session-open POST). `/v1/connection/details` remains available for admin / debugging use but is deprecated for player-join purposes.  Idempotent at the session-open step: a duplicate join request returns the existing active session\'s id instead of creating a duplicate row.  Response shape: - `connectionResult` — always populated; carries ALLOWED / BANNED / VPN_DETECTED etc.   plus a formatted kick message when denied. - `sessionId` / `startedAt` — populated only when the join was allowed. - Connection context (IP, location, VPN%, bypass) for display + logging. - `playerInformation`, `activePunishments` — full player history at join time. - `sessionStats` — total seconds played / days active / currently-online, useful   for game-server-side welcome messages.
      * @summary Player join — unified authorization + session-open
@@ -4231,13 +4281,13 @@ export declare const PlayerSessionsApiFp: (configuration?: Configuration) => {
  */
 export declare const PlayerSessionsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
-     * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+     * Closes the active session for a (playerUuid, serverSessionId) pair and returns an acknowledgment: whether a session was actually closed, that session\'s start / end / duration, and the player\'s aggregate session stats recomputed after the close. No-op if no active session is found — `sessionClosed` is false and the per-session fields are null (stats are still returned) — so duplicate end events from a retry don\'t error.
      * @summary Close the active player session
      * @param {PlayerSessionEndRequest} playerSessionEndRequest
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): AxiosPromise<PlayerSessionEndResponse>;
     /**
      * Single round-trip the game server / proxy makes when a player joins. Runs the full authorization check (VPN detection, bypass tiers, punishment propagation, active-ban evaluation) and — only if allowed — opens (or re-attaches to) a player_session row.  Replaces the older two-call flow (`GET /v1/connection/details` followed by a session-open POST). `/v1/connection/details` remains available for admin / debugging use but is deprecated for player-join purposes.  Idempotent at the session-open step: a duplicate join request returns the existing active session\'s id instead of creating a duplicate row.  Response shape: - `connectionResult` — always populated; carries ALLOWED / BANNED / VPN_DETECTED etc.   plus a formatted kick message when denied. - `sessionId` / `startedAt` — populated only when the join was allowed. - Connection context (IP, location, VPN%, bypass) for display + logging. - `playerInformation`, `activePunishments` — full player history at join time. - `sessionStats` — total seconds played / days active / currently-online, useful   for game-server-side welcome messages.
      * @summary Player join — unified authorization + session-open
@@ -4252,13 +4302,13 @@ export declare const PlayerSessionsApiFactory: (configuration?: Configuration, b
  */
 export declare class PlayerSessionsApi extends BaseAPI {
     /**
-     * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+     * Closes the active session for a (playerUuid, serverSessionId) pair and returns an acknowledgment: whether a session was actually closed, that session\'s start / end / duration, and the player\'s aggregate session stats recomputed after the close. No-op if no active session is found — `sessionClosed` is false and the per-session fields are null (stats are still returned) — so duplicate end events from a retry don\'t error.
      * @summary Close the active player session
      * @param {PlayerSessionEndRequest} playerSessionEndRequest
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PlayerSessionEndResponse, any, {}>>;
     /**
      * Single round-trip the game server / proxy makes when a player joins. Runs the full authorization check (VPN detection, bypass tiers, punishment propagation, active-ban evaluation) and — only if allowed — opens (or re-attaches to) a player_session row.  Replaces the older two-call flow (`GET /v1/connection/details` followed by a session-open POST). `/v1/connection/details` remains available for admin / debugging use but is deprecated for player-join purposes.  Idempotent at the session-open step: a duplicate join request returns the existing active session\'s id instead of creating a duplicate row.  Response shape: - `connectionResult` — always populated; carries ALLOWED / BANNED / VPN_DETECTED etc.   plus a formatted kick message when denied. - `sessionId` / `startedAt` — populated only when the join was allowed. - Connection context (IP, location, VPN%, bypass) for display + logging. - `playerInformation`, `activePunishments` — full player history at join time. - `sessionStats` — total seconds played / days active / currently-online, useful   for game-server-side welcome messages.
      * @summary Player join — unified authorization + session-open
@@ -4509,13 +4559,14 @@ export declare class ReportApi extends BaseAPI {
  */
 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.
+     * 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.  Optionally include an `activePlayers` list (the UUIDs currently on this server). When present, the API reconciles player sessions for this server: any open session whose player is absent from the list is closed, and linked to the player\'s new session if they transferred to another server. Omit the body for a plain liveness heartbeat.
      * @summary Send a heartbeat
      * @param {string} id Session UUID returned from the registration call
+     * @param {ServerHeartbeatRequest} [serverHeartbeatRequest]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    heartbeat: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    heartbeat: (id: string, serverHeartbeatRequest?: ServerHeartbeatRequest, 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
@@ -4552,13 +4603,14 @@ export declare const ServerSessionsApiAxiosParamCreator: (configuration?: Config
  */
 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.
+     * 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.  Optionally include an `activePlayers` list (the UUIDs currently on this server). When present, the API reconciles player sessions for this server: any open session whose player is absent from the list is closed, and linked to the player\'s new session if they transferred to another server. Omit the body for a plain liveness heartbeat.
      * @summary Send a heartbeat
      * @param {string} id Session UUID returned from the registration call
+     * @param {ServerHeartbeatRequest} [serverHeartbeatRequest]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    heartbeat(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    heartbeat(id: string, serverHeartbeatRequest?: ServerHeartbeatRequest, 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
@@ -4595,13 +4647,14 @@ export declare const ServerSessionsApiFp: (configuration?: Configuration) => {
  */
 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.
+     * 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.  Optionally include an `activePlayers` list (the UUIDs currently on this server). When present, the API reconciles player sessions for this server: any open session whose player is absent from the list is closed, and linked to the player\'s new session if they transferred to another server. Omit the body for a plain liveness heartbeat.
      * @summary Send a heartbeat
      * @param {string} id Session UUID returned from the registration call
+     * @param {ServerHeartbeatRequest} [serverHeartbeatRequest]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    heartbeat(id: string, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    heartbeat(id: string, serverHeartbeatRequest?: ServerHeartbeatRequest, 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
@@ -4638,13 +4691,14 @@ export declare const ServerSessionsApiFactory: (configuration?: Configuration, b
  */
 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.
+     * 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.  Optionally include an `activePlayers` list (the UUIDs currently on this server). When present, the API reconciles player sessions for this server: any open session whose player is absent from the list is closed, and linked to the player\'s new session if they transferred to another server. Omit the body for a plain liveness heartbeat.
      * @summary Send a heartbeat
      * @param {string} id Session UUID returned from the registration call
+     * @param {ServerHeartbeatRequest} [serverHeartbeatRequest]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    heartbeat(id: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    heartbeat(id: string, serverHeartbeatRequest?: ServerHeartbeatRequest, 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