@rebornteam/reborn-api 4.6.0 → 4.8.0

package/.openapi-generator/FILES

@@ -109,6 +109,7 @@ docs/Region.md
 docs/ReportApi.md
 docs/ReportCategory.md
 docs/SearchKind.md
+docs/ServerHeartbeatRequest.md
 docs/ServerRegisterRequest.md
 docs/ServerSessionDTO.md
 docs/ServerSessionsApi.md

package/README.md

@@ -1,4 +1,4 @@
-## @rebornteam/reborn-api@4.6.0
+## @rebornteam/reborn-api@4.8.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.6.0 --save
+npm install @rebornteam/reborn-api@4.8.0 --save
 ```
 
 _unPublished (not recommended):_
@@ -214,6 +214,7 @@ Class | Method | HTTP request | Description
  - [Region](docs/Region.md)
  - [ReportCategory](docs/ReportCategory.md)
  - [SearchKind](docs/SearchKind.md)
+ - [ServerHeartbeatRequest](docs/ServerHeartbeatRequest.md)
  - [ServerRegisterRequest](docs/ServerRegisterRequest.md)
  - [ServerSessionDTO](docs/ServerSessionDTO.md)
  - [SliceAdminAltAccount](docs/SliceAdminAltAccount.md)

package/api.ts

@@ -4,7 +4,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication 
  *
- * The version of the OpenAPI document: 4.6.0
+ * The version of the OpenAPI document: 4.8.0
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -110,6 +110,10 @@ export interface AdminAltGraphEdge {
      * Number of distinct non-promiscuous connections these two players share. Drives edge thickness.
      */
     'sharedConnectionCount': number;
+    /**
+     * The distinct IP addresses the two players share — the address(es) this edge represents. Same cardinality as sharedConnectionCount.
+     */
+    'sharedIpAddresses': Array<string>;
 }
 /**
  * One player node in an alt-graph traversal.
@@ -775,6 +779,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.
@@ -1821,6 +1829,15 @@ export const SearchKind = {
 export type SearchKind = typeof SearchKind[keyof typeof SearchKind];
 
 
+/**
+ * Optional heartbeat payload carrying the players currently on this server session.
+ */
+export interface ServerHeartbeatRequest {
+    /**
+     * UUIDs of players currently on this server session. Open sessions for this server whose player is absent from this list are auto-closed. Omit to heartbeat without reconciling player sessions.
+     */
+    'activePlayers'?: Array<string> | null;
+}
 export interface ServerRegisterRequest {
     'region': Region;
     'gameType': GameType;
@@ -7761,13 +7778,14 @@ export class ReportApi extends BaseAPI {
 export const ServerSessionsApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server. 
+         * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server.  Optionally include an `activePlayers` list (the UUIDs currently on this server). When present, the API reconciles player sessions for this server: any open session whose player is absent from the list is closed, and linked to the player\'s new session if they transferred to another server. Omit the body for a plain liveness heartbeat. 
          * @summary Send a heartbeat
          * @param {string} id Session UUID returned from the registration call
+         * @param {ServerHeartbeatRequest} [serverHeartbeatRequest] 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        heartbeat: async (id: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        heartbeat: async (id: string, serverHeartbeatRequest?: ServerHeartbeatRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
             // verify required parameter 'id' is not null or undefined
             assertParamExists('heartbeat', 'id', id)
             const localVarPath = `/v1/servers/{id}/heartbeat`
@@ -7787,10 +7805,12 @@ export const ServerSessionsApiAxiosParamCreator = function (configuration?: Conf
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
+            localVarHeaderParameter['Content-Type'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(serverHeartbeatRequest, localVarRequestOptions, configuration)
 
             return {
                 url: toPathString(localVarUrlObj),
@@ -7951,14 +7971,15 @@ export const ServerSessionsApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = ServerSessionsApiAxiosParamCreator(configuration)
     return {
         /**
-         * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server. 
+         * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server.  Optionally include an `activePlayers` list (the UUIDs currently on this server). When present, the API reconciles player sessions for this server: any open session whose player is absent from the list is closed, and linked to the player\'s new session if they transferred to another server. Omit the body for a plain liveness heartbeat. 
          * @summary Send a heartbeat
          * @param {string} id Session UUID returned from the registration call
+         * @param {ServerHeartbeatRequest} [serverHeartbeatRequest] 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async heartbeat(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.heartbeat(id, options);
+        async heartbeat(id: string, serverHeartbeatRequest?: ServerHeartbeatRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.heartbeat(id, serverHeartbeatRequest, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['ServerSessionsApi.heartbeat']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -8023,14 +8044,15 @@ export const ServerSessionsApiFactory = function (configuration?: Configuration,
     const localVarFp = ServerSessionsApiFp(configuration)
     return {
         /**
-         * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server. 
+         * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server.  Optionally include an `activePlayers` list (the UUIDs currently on this server). When present, the API reconciles player sessions for this server: any open session whose player is absent from the list is closed, and linked to the player\'s new session if they transferred to another server. Omit the body for a plain liveness heartbeat. 
          * @summary Send a heartbeat
          * @param {string} id Session UUID returned from the registration call
+         * @param {ServerHeartbeatRequest} [serverHeartbeatRequest] 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        heartbeat(id: string, options?: RawAxiosRequestConfig): AxiosPromise<void> {
-            return localVarFp.heartbeat(id, options).then((request) => request(axios, basePath));
+        heartbeat(id: string, serverHeartbeatRequest?: ServerHeartbeatRequest, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            return localVarFp.heartbeat(id, serverHeartbeatRequest, options).then((request) => request(axios, basePath));
         },
         /**
          * Returns all server sessions — both online and historical — ordered by start time descending. Used by the web UI to populate the session filter dropdown.
@@ -8078,14 +8100,15 @@ export const ServerSessionsApiFactory = function (configuration?: Configuration,
  */
 export class ServerSessionsApi extends BaseAPI {
     /**
-     * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server. 
+     * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server.  Optionally include an `activePlayers` list (the UUIDs currently on this server). When present, the API reconciles player sessions for this server: any open session whose player is absent from the list is closed, and linked to the player\'s new session if they transferred to another server. Omit the body for a plain liveness heartbeat. 
      * @summary Send a heartbeat
      * @param {string} id Session UUID returned from the registration call
+     * @param {ServerHeartbeatRequest} [serverHeartbeatRequest] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public heartbeat(id: string, options?: RawAxiosRequestConfig) {
-        return ServerSessionsApiFp(this.configuration).heartbeat(id, options).then((request) => request(this.axios, this.basePath));
+    public heartbeat(id: string, serverHeartbeatRequest?: ServerHeartbeatRequest, options?: RawAxiosRequestConfig) {
+        return ServerSessionsApiFp(this.configuration).heartbeat(id, serverHeartbeatRequest, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**

package/base.ts

@@ -4,7 +4,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication 
  *
- * The version of the OpenAPI document: 4.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -100,6 +100,10 @@ export interface AdminAltGraphEdge {
      * Number of distinct non-promiscuous connections these two players share. Drives edge thickness.
      */
     'sharedConnectionCount': number;
+    /**
+     * The distinct IP addresses the two players share — the address(es) this edge represents. Same cardinality as sharedConnectionCount.
+     */
+    'sharedIpAddresses': Array<string>;
 }
 /**
  * One player node in an alt-graph traversal.
@@ -755,6 +759,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.
@@ -1737,6 +1745,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;
@@ -4546,13 +4563,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
@@ -4589,13 +4607,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
@@ -4632,13 +4651,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
@@ -4675,13 +4695,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/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.6.0
+ * The version of the OpenAPI document: 4.8.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -5589,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`
@@ -5612,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,
@@ -5754,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);
@@ -5841,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.
@@ -5896,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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -100,6 +100,10 @@ export interface AdminAltGraphEdge {
      * Number of distinct non-promiscuous connections these two players share. Drives edge thickness.
      */
     'sharedConnectionCount': number;
+    /**
+     * The distinct IP addresses the two players share — the address(es) this edge represents. Same cardinality as sharedConnectionCount.
+     */
+    'sharedIpAddresses': Array<string>;
 }
 /**
  * One player node in an alt-graph traversal.
@@ -755,6 +759,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.
@@ -1737,6 +1745,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;
@@ -4546,13 +4563,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
@@ -4589,13 +4607,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
@@ -4632,13 +4651,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
@@ -4675,13 +4695,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.6.0
+ * The version of the OpenAPI document: 4.8.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -5525,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`
@@ -5548,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,
@@ -5689,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);
@@ -5775,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.
@@ -5829,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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0
+ * The version of the OpenAPI document: 4.8.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/docs/AdminAltGraphEdge.md

@@ -9,6 +9,7 @@ Name | Type | Description | Notes
 **fromUuid** | **string** | One endpoint of the edge | [default to undefined]
 **toUuid** | **string** | Other endpoint of the edge. The pair is emitted only once — the SQL ensures fromUuid < toUuid lexicographically. | [default to undefined]
 **sharedConnectionCount** | **number** | Number of distinct non-promiscuous connections these two players share. Drives edge thickness. | [default to undefined]
+**sharedIpAddresses** | **Array<string>** | The distinct IP addresses the two players share — the address(es) this edge represents. Same cardinality as sharedConnectionCount. | [default to undefined]
 
 ## Example
 
@@ -19,6 +20,7 @@ const instance: AdminAltGraphEdge = {
     fromUuid,
     toUuid,
     sharedConnectionCount,
+    sharedIpAddresses,
 };
 ```
 

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/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.6.0
+ * The version of the OpenAPI document: 4.8.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.6.0",
+  "version": "4.8.0",
   "description": "OpenAPI client for @rebornteam/reborn-api",
   "author": "OpenAPI-Generator Contributors",
   "repository": {