@rebornteam/reborn-api 4.5.0 → 4.6.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

package/README.md

@@ -1,4 +1,4 @@
-## @rebornteam/reborn-api@4.5.0
+## @rebornteam/reborn-api@4.6.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.6.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)

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.6.0
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -1537,6 +1537,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.
  */
@@ -7038,7 +7075,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 +7101,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 +7162,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 +7197,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 +7224,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.

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.6.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.6.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.6.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.6.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -1485,6 +1485,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.
  */
@@ -4189,7 +4226,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 +4247,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 +4268,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 +4289,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

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.6.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.

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.6.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.6.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.6.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.6.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.6.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.6.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.6.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -1485,6 +1485,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.
  */
@@ -4189,7 +4226,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 +4247,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 +4268,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 +4289,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

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.6.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.

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.6.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.6.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.6.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.6.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.6.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/configuration.js

@@ -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.6.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/index.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.6.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/index.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.6.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/index.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.6.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/index.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.6.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/docs/PlayerSessionEndResponse.md

@@ -0,0 +1,35 @@
+# PlayerSessionEndResponse
+
+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.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**playerUuid** | **string** | Player Minecraft UUID, echoed from the request | [default to undefined]
+**serverSessionId** | **string** | Server session id the player was on, echoed from the request | [default to undefined]
+**sessionClosed** | **boolean** | 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). | [default to undefined]
+**sessionId** | **string** | Id of the session that was closed. Null on a no-op. | [optional] [default to undefined]
+**startedAt** | **string** | When the closed session was opened (ISO-8601). Null on a no-op. | [optional] [default to undefined]
+**endedAt** | **string** | When the session was closed (ISO-8601), i.e. now. Null on a no-op. | [optional] [default to undefined]
+**durationSeconds** | **number** | Length of the closed session in seconds (endedAt - startedAt). Null on a no-op. | [optional] [default to undefined]
+**sessionStats** | [**AdminPlayerSessionStats**](AdminPlayerSessionStats.md) | Player\'s aggregate session stats, recomputed after this session was closed (so the just-ended session is included in the totals). | [default to undefined]
+
+## Example
+
+```typescript
+import { PlayerSessionEndResponse } from '@rebornteam/reborn-api';
+
+const instance: PlayerSessionEndResponse = {
+    playerUuid,
+    serverSessionId,
+    sessionClosed,
+    sessionId,
+    startedAt,
+    endedAt,
+    durationSeconds,
+    sessionStats,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/PlayerSessionsApi.md

@@ -8,9 +8,9 @@ All URIs are relative to *https://api.smsh.sh*
 |[**start**](#start) | **POST** /v1/player-session/start | Player join — unified authorization + session-open|
 
 # **end**
-> end(playerSessionEndRequest)
+> PlayerSessionEndResponse end(playerSessionEndRequest)
 
-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.
 
 ### Example
 
@@ -40,7 +40,7 @@ const { status, data } = await apiInstance.end(
 
 ### Return type
 
-void (empty response body)
+**PlayerSessionEndResponse**
 
 ### Authorization
 
@@ -49,13 +49,13 @@ void (empty response body)
 ### HTTP request headers
 
  - **Content-Type**: application/json
- - **Accept**: Not defined
+ - **Accept**: application/json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**204** | Session closed (or no-op if no active session) |  -  |
+|**200** | End handled. Inspect `sessionClosed` to tell whether a session was actually closed. |  -  |
 |**401** | Unauthorized |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)

package/index.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.6.0
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rebornteam/reborn-api",
-  "version": "4.5.0",
+  "version": "4.6.0",
   "description": "OpenAPI client for @rebornteam/reborn-api",
   "author": "OpenAPI-Generator Contributors",
   "repository": {