@rebornteam/reborn-api 4.5.0 → 4.7.0

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

package/docs/AdminPlayerSession.md

@@ -12,6 +12,7 @@ Name | Type | Description | Notes
 **startedAt** | **string** | When the player joined (ISO-8601) | [default to undefined]
 **endedAt** | **string** | When the player disconnected (ISO-8601). Null while the session is still active. | [optional] [default to undefined]
 **durationSeconds** | **number** | Closed session duration in seconds (ended_at − started_at). Null while active. | [optional] [default to undefined]
+**transferredTo** | **string** | When the player transferred to another server, the id of the session they moved to. Null for a normal disconnect or an active session. | [optional] [default to undefined]
 
 ## Example
 
@@ -25,6 +26,7 @@ const instance: AdminPlayerSession = {
     startedAt,
     endedAt,
     durationSeconds,
+    transferredTo,
 };
 ```
 

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/docs/ServerHeartbeatRequest.md

@@ -0,0 +1,21 @@
+# ServerHeartbeatRequest
+
+Optional heartbeat payload carrying the players currently on this server session.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**activePlayers** | **Array<string>** | 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. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { ServerHeartbeatRequest } from '@rebornteam/reborn-api';
+
+const instance: ServerHeartbeatRequest = {
+    activePlayers,
+};
+```
+
+[[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/ServerSessionsApi.md

@@ -13,23 +13,26 @@ All URIs are relative to *https://api.smsh.sh*
 # **heartbeat**
 > heartbeat()
 
-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. 
 
 ### Example
 
 ```typescript
 import {
     ServerSessionsApi,
-    Configuration
+    Configuration,
+    ServerHeartbeatRequest
 } from '@rebornteam/reborn-api';
 
 const configuration = new Configuration();
 const apiInstance = new ServerSessionsApi(configuration);
 
 let id: string; //Session UUID returned from the registration call (default to undefined)
+let serverHeartbeatRequest: ServerHeartbeatRequest; // (optional)
 
 const { status, data } = await apiInstance.heartbeat(
-    id
+    id,
+    serverHeartbeatRequest
 );
 ```
 
@@ -37,6 +40,7 @@ const { status, data } = await apiInstance.heartbeat(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
+| **serverHeartbeatRequest** | **ServerHeartbeatRequest**|  | |
 | **id** | [**string**] | Session UUID returned from the registration call | defaults to undefined|
 
 
@@ -50,7 +54,7 @@ void (empty response body)
 
 ### HTTP request headers
 
- - **Content-Type**: Not defined
+ - **Content-Type**: application/json
  - **Accept**: Not defined
 
 

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.7.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.7.0",
   "description": "OpenAPI client for @rebornteam/reborn-api",
   "author": "OpenAPI-Generator Contributors",
   "repository": {