@rebornteam/reborn-api 4.5.0 → 4.7.0

package/dist/api.js

@@ -5,7 +5,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).
@@ -4940,7 +4940,7 @@ exports.PlayerApi = PlayerApi;
 const PlayerSessionsApiAxiosParamCreator = function (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.
@@ -4963,6 +4963,7 @@ const PlayerSessionsApiAxiosParamCreator = function (configuration) {
             // http bearer authentication required
             yield (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
             localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
             (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
@@ -5016,7 +5017,7 @@ const PlayerSessionsApiFp = function (configuration) {
     const localVarAxiosParamCreator = (0, exports.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.
@@ -5057,7 +5058,7 @@ const PlayerSessionsApiFactory = function (configuration, basePath, axios) {
     const localVarFp = (0, exports.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.
@@ -5084,7 +5085,7 @@ exports.PlayerSessionsApiFactory = PlayerSessionsApiFactory;
  */
 class PlayerSessionsApi extends base_1.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.
@@ -5588,13 +5589,14 @@ exports.ReportApi = ReportApi;
 const ServerSessionsApiAxiosParamCreator = function (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_1, ...args_1) => __awaiter(this, [id_1, ...args_1], void 0, function* (id, options = {}) {
+        heartbeat: (id_1, serverHeartbeatRequest_1, ...args_1) => __awaiter(this, [id_1, serverHeartbeatRequest_1, ...args_1], void 0, function* (id, serverHeartbeatRequest, options = {}) {
             // verify required parameter 'id' is not null or undefined
             (0, common_1.assertParamExists)('heartbeat', 'id', id);
             const localVarPath = `/v1/servers/{id}/heartbeat`
@@ -5611,9 +5613,11 @@ const ServerSessionsApiAxiosParamCreator = function (configuration) {
             // authentication DiscordAuth required
             // http bearer authentication required
             yield (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
             (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = (0, common_1.serializeDataIfNeeded)(serverHeartbeatRequest, localVarRequestOptions, configuration);
             return {
                 url: (0, common_1.toPathString)(localVarUrlObj),
                 options: localVarRequestOptions,
@@ -5753,16 +5757,17 @@ const ServerSessionsApiFp = function (configuration) {
     const localVarAxiosParamCreator = (0, exports.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}
          */
-        heartbeat(id, options) {
+        heartbeat(id, serverHeartbeatRequest, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.heartbeat(id, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.heartbeat(id, serverHeartbeatRequest, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['ServerSessionsApi.heartbeat']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -5840,14 +5845,15 @@ const ServerSessionsApiFactory = function (configuration, basePath, axios) {
     const localVarFp = (0, exports.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, options) {
-            return localVarFp.heartbeat(id, options).then((request) => request(axios, basePath));
+        heartbeat(id, serverHeartbeatRequest, options) {
+            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.
@@ -5895,14 +5901,15 @@ exports.ServerSessionsApiFactory = ServerSessionsApiFactory;
  */
 class ServerSessionsApi extends base_1.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, options) {
-        return (0, exports.ServerSessionsApiFp)(this.configuration).heartbeat(id, options).then((request) => request(this.axios, this.basePath));
+    heartbeat(id, serverHeartbeatRequest, options) {
+        return (0, exports.ServerSessionsApiFp)(this.configuration).heartbeat(id, serverHeartbeatRequest, options).then((request) => request(this.axios, this.basePath));
     }
     /**
      * Returns all server sessions — both online and historical — ordered by start time descending. Used by the web UI to populate the session filter dropdown.

package/dist/base.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).

package/dist/base.js

@@ -5,7 +5,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/common.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).

package/dist/common.js

@@ -5,7 +5,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/configuration.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).

package/dist/configuration.js

@@ -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/dist/esm/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

package/dist/esm/api.js

@@ -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).
@@ -4888,7 +4888,7 @@ export class PlayerApi extends BaseAPI {
 export const PlayerSessionsApiAxiosParamCreator = function (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.
@@ -4911,6 +4911,7 @@ export const PlayerSessionsApiAxiosParamCreator = function (configuration) {
             // http bearer authentication required
             yield setBearerAuthToObject(localVarHeaderParameter, configuration);
             localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
@@ -4963,7 +4964,7 @@ export const PlayerSessionsApiFp = function (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.
@@ -5003,7 +5004,7 @@ export const PlayerSessionsApiFactory = function (configuration, basePath, axios
     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.
@@ -5029,7 +5030,7 @@ export const PlayerSessionsApiFactory = function (configuration, basePath, axios
  */
 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.
@@ -5524,13 +5525,14 @@ export class ReportApi extends BaseAPI {
 export const ServerSessionsApiAxiosParamCreator = function (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_1, ...args_1) => __awaiter(this, [id_1, ...args_1], void 0, function* (id, options = {}) {
+        heartbeat: (id_1, serverHeartbeatRequest_1, ...args_1) => __awaiter(this, [id_1, serverHeartbeatRequest_1, ...args_1], void 0, function* (id, serverHeartbeatRequest, options = {}) {
             // verify required parameter 'id' is not null or undefined
             assertParamExists('heartbeat', 'id', id);
             const localVarPath = `/v1/servers/{id}/heartbeat`
@@ -5547,9 +5549,11 @@ export const ServerSessionsApiAxiosParamCreator = function (configuration) {
             // authentication DiscordAuth required
             // http bearer authentication required
             yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(serverHeartbeatRequest, localVarRequestOptions, configuration);
             return {
                 url: toPathString(localVarUrlObj),
                 options: localVarRequestOptions,
@@ -5688,16 +5692,17 @@ export const ServerSessionsApiFp = function (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}
          */
-        heartbeat(id, options) {
+        heartbeat(id, serverHeartbeatRequest, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.heartbeat(id, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.heartbeat(id, serverHeartbeatRequest, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = operationServerMap['ServerSessionsApi.heartbeat']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -5774,14 +5779,15 @@ export const ServerSessionsApiFactory = function (configuration, basePath, axios
     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, options) {
-            return localVarFp.heartbeat(id, options).then((request) => request(axios, basePath));
+        heartbeat(id, serverHeartbeatRequest, options) {
+            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.
@@ -5828,14 +5834,15 @@ export const ServerSessionsApiFactory = function (configuration, basePath, axios
  */
 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}
      */
-    heartbeat(id, options) {
-        return ServerSessionsApiFp(this.configuration).heartbeat(id, options).then((request) => request(this.axios, this.basePath));
+    heartbeat(id, serverHeartbeatRequest, options) {
+        return ServerSessionsApiFp(this.configuration).heartbeat(id, serverHeartbeatRequest, options).then((request) => request(this.axios, this.basePath));
     }
     /**
      * Returns all server sessions — both online and historical — ordered by start time descending. Used by the web UI to populate the session filter dropdown.

package/dist/esm/base.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).

package/dist/esm/base.js

@@ -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/dist/esm/common.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).

package/dist/esm/common.js

@@ -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/dist/esm/configuration.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).