@rebornteam/reborn-api 2.9.1 → 3.0.1

package/.openapi-generator/FILES

@@ -12,6 +12,7 @@ docs/AdminApplyPunishmentResult.md
 docs/AdminClientCredentialResponse.md
 docs/AdminClientCredentialsApi.md
 docs/AdminConnectionBypassResponse.md
+docs/AdminConnectionCheckResult.md
 docs/AdminConnectionsApi.md
 docs/AdminCreatePunishmentDraftRequest.md
 docs/AdminDashboardApi.md

package/README.md

@@ -1,4 +1,4 @@
-## @rebornteam/reborn-api@2.9.1
+## @rebornteam/reborn-api@3.0.1
 
 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@2.9.1 --save
+npm install @rebornteam/reborn-api@3.0.1 --save
 ```
 
 _unPublished (not recommended):_
@@ -61,6 +61,7 @@ Class | Method | HTTP request | Description
 *AdminConnectionsApi* | [**createBypass**](docs/AdminConnectionsApi.md#createbypass) | **POST** /admin/connection/bypass | Create connection bypass
 *AdminConnectionsApi* | [**listAllConnections**](docs/AdminConnectionsApi.md#listallconnections) | **GET** /admin/connection | List all connections (paginated)
 *AdminConnectionsApi* | [**listConnections**](docs/AdminConnectionsApi.md#listconnections) | **GET** /admin/connection/recent | List recent connections
+*AdminConnectionsApi* | [**recheckService**](docs/AdminConnectionsApi.md#recheckservice) | **POST** /admin/connection/{connectionId}/recheck/{service} | Refresh a single VPN check
 *AdminDashboardApi* | [**dashboardStats**](docs/AdminDashboardApi.md#dashboardstats) | **GET** /admin/dashboard | Get dashboard statistics
 *AdminPlayersApi* | [**getPlayer**](docs/AdminPlayersApi.md#getplayer) | **GET** /admin/player/{uuid} | Get player detail
 *AdminPlayersApi* | [**listPlayers**](docs/AdminPlayersApi.md#listplayers) | **GET** /admin/player | List players
@@ -95,6 +96,7 @@ Class | Method | HTTP request | Description
  - [AdminApplyPunishmentResult](docs/AdminApplyPunishmentResult.md)
  - [AdminClientCredentialResponse](docs/AdminClientCredentialResponse.md)
  - [AdminConnectionBypassResponse](docs/AdminConnectionBypassResponse.md)
+ - [AdminConnectionCheckResult](docs/AdminConnectionCheckResult.md)
  - [AdminCreatePunishmentDraftRequest](docs/AdminCreatePunishmentDraftRequest.md)
  - [AdminDashboardConnectionResponse](docs/AdminDashboardConnectionResponse.md)
  - [AdminGetDashboardStats](docs/AdminGetDashboardStats.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: 2.9.1
+ * The version of the OpenAPI document: 3.0.1
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -165,6 +165,23 @@ export interface AdminConnectionBypassResponse {
      */
     'createdAt'?: string;
 }
+/**
+ * Result from a single VPN detection service for a given IP address
+ */
+export interface AdminConnectionCheckResult {
+    /**
+     * Service identifier
+     */
+    'service'?: string;
+    /**
+     * Whether this service flagged the IP as a VPN, proxy, or Tor exit node
+     */
+    'result'?: boolean;
+    /**
+     * When this check was last performed
+     */
+    'checkedAt'?: string;
+}
 /**
  * Request to evaluate the impact of a punishment across one or more targets before applying
  */
@@ -214,6 +231,10 @@ export interface AdminDashboardConnectionResponse {
     'lastSeen'?: string | null;
     'percentPositive': number;
     'numberOfChecks': number;
+    /**
+     * Results from each VPN detection service for this IP address
+     */
+    'results'?: Array<AdminConnectionCheckResult>;
 }
 export interface AdminGetDashboardStats {
     'totalPlayers': number;
@@ -558,24 +579,31 @@ export interface ConnectionGetConnectionDetailsResponse {
      */
     'ipAddress'?: string;
     /**
-     * Approximate geographic location of the IP address, typically in \'City, Country\' format. Returns \'Local, N/A\' for localhost or private IPs.
+     * Approximate geographic location of the IP address. Returns \'Local, N/A\' for localhost or private IPs.
      */
     'approximateLocation'?: string;
     /**
-     * Confidence score representing the percentage of VPN detection services that flagged this IP as suspicious. Range: 0.0 (clean) to 100.0 (definitely VPN/proxy). Values above 50.0 suggest high probability of VPN usage.
+     * Confidence score representing the percentage of VPN detection services that flagged this IP as suspicious. Range: 0.0 (clean) to 100.0 (definitely VPN/proxy).
      */
     'percentPositive'?: number;
     /**
-     * Total number of VPN detection services successfully queried during the last check. Higher numbers indicate more comprehensive analysis.
+     * Total number of VPN detection services successfully queried during the last check.
      */
     'numberOfChecks'?: number;
-    'bypassed'?: boolean;
     /**
-     * Expiration timestamp for the bypass (ISO-8601 format). After this time, normal VPN detection rules will apply again. Null if not bypassed or bypass is permanent.
+     * Indicates if this IP address has been administratively bypassed.
+     */
+    'isBypassed'?: boolean;
+    /**
+     * Expiration timestamp for the bypass (ISO-8601 format). Null if not bypassed or bypass is permanent.
      */
     'bypassedUntil'?: string | null;
     /**
-     * Player information associated with this connection. Only populated when \'associate_uuid\' query parameter is provided. Contains first join status and login history.
+     * Results from each VPN detection service that checked this IP address
+     */
+    'results'?: Array<AdminConnectionCheckResult>;
+    /**
+     * Player information associated with this connection. Only populated when \'associate_uuid\' query parameter is provided.
      */
     'playerInformation'?: PlayerGetPlayerInformation | null;
     /**
@@ -601,19 +629,19 @@ export interface CreateBypassRequest {
  */
 export interface PlayerGetPlayerInformation {
     /**
-     * Timestamp of when the player first connected to the server (ISO-8601 format).
+     * Indicates whether this is the player\'s first time joining the server.
      */
-    'firstLogin'?: string;
+    'firstJoin'?: boolean;
     /**
-     * Indicates whether this is the player\'s first time joining the server. Useful for triggering welcome messages, tutorials, or first-join rewards.
+     * Timestamp of when the player first connected to the server (ISO-8601 format).
      */
-    'firstJoin'?: boolean;
+    'firstLogin'?: string;
     /**
-     * Raw punishment score calculated as: SUM((base_weight × severity/10)) where base_weight is 0.10 for WARNING, 0.30 for MUTE, 0.50 for BAN. Severity ranges 1-10. Used for tracking overall punishment severity.
+     * Raw punishment score calculated as: SUM((base_weight × severity/10)). Used for tracking overall punishment severity.
      */
     'punishmentPointsRaw'?: number;
     /**
-     * Punishment score as a percentage (0-100). When this score is >100% BEFORE applying a new punishment, the new punishment should be made permanent. Check this value BEFORE issuing punishment, not after. Calculated as raw_score × 100.
+     * Punishment score as a percentage (0-100). When >100% before applying a new punishment, the new punishment should be made permanent.
      */
     'punishmentPointsPercent'?: number;
 }
@@ -1447,6 +1475,48 @@ export const AdminConnectionsApiAxiosParamCreator = function (configuration?: Co
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
 
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
+         * @summary Refresh a single VPN check
+         * @param {number} connectionId 
+         * @param {string} service 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        recheckService: async (connectionId: number, service: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'connectionId' is not null or undefined
+            assertParamExists('recheckService', 'connectionId', connectionId)
+            // verify required parameter 'service' is not null or undefined
+            assertParamExists('recheckService', 'service', service)
+            const localVarPath = `/admin/connection/{connectionId}/recheck/{service}`
+                .replace(`{${"connectionId"}}`, encodeURIComponent(String(connectionId)))
+                .replace(`{${"service"}}`, encodeURIComponent(String(service)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
             return {
                 url: toPathString(localVarUrlObj),
                 options: localVarRequestOptions,
@@ -1510,6 +1580,20 @@ export const AdminConnectionsApiFp = function(configuration?: Configuration) {
             const localVarOperationServerBasePath = operationServerMap['AdminConnectionsApi.listConnections']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
+        /**
+         * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
+         * @summary Refresh a single VPN check
+         * @param {number} connectionId 
+         * @param {string} service 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async recheckService(connectionId: number, service: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminConnectionCheckResult>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.recheckService(connectionId, service, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminConnectionsApi.recheckService']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
     }
 };
 
@@ -1559,6 +1643,17 @@ export const AdminConnectionsApiFactory = function (configuration?: Configuratio
         listConnections(createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardConnectionResponse>> {
             return localVarFp.listConnections(createdAfter, createdBefore, ipAddress, uuid, isVpn, page, limit, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
+         * @summary Refresh a single VPN check
+         * @param {number} connectionId 
+         * @param {string} service 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        recheckService(connectionId: number, service: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminConnectionCheckResult> {
+            return localVarFp.recheckService(connectionId, service, options).then((request) => request(axios, basePath));
+        },
     };
 };
 
@@ -1608,6 +1703,18 @@ export class AdminConnectionsApi extends BaseAPI {
     public listConnections(createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig) {
         return AdminConnectionsApiFp(this.configuration).listConnections(createdAfter, createdBefore, ipAddress, uuid, isVpn, page, limit, options).then((request) => request(this.axios, this.basePath));
     }
+
+    /**
+     * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
+     * @summary Refresh a single VPN check
+     * @param {number} connectionId 
+     * @param {string} service 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public recheckService(connectionId: number, service: string, options?: RawAxiosRequestConfig) {
+        return AdminConnectionsApiFp(this.configuration).recheckService(connectionId, service, options).then((request) => request(this.axios, this.basePath));
+    }
 }
 
 
@@ -1914,7 +2021,7 @@ export class AdminPlayersApi extends BaseAPI {
 export const AdminPunishmentsApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+         * Apply a punishment to one or more targets. The authenticated user is recorded as the issuer.
          * @summary Apply punishment
          * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest 
          * @param {*} [options] Override http request option.
@@ -1953,7 +2060,7 @@ export const AdminPunishmentsApiAxiosParamCreator = function (configuration?: Co
             };
         },
         /**
-         * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+         * Preview the impact of a punishment across one or more targets. No changes are made.
          * @summary Evaluate punishment impact
          * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest 
          * @param {*} [options] Override http request option.
@@ -2070,7 +2177,7 @@ export const AdminPunishmentsApiAxiosParamCreator = function (configuration?: Co
             };
         },
         /**
-         * Search for players by UUID or username, or look up all players associated with an IP address. Used to populate the target table before issuing a punishment.
+         * Search for players by UUID or username, or look up all players associated with an IP address.
          * @summary Search punishment targets
          * @param {string} q UUID, username, or partial/full IP address to search for
          * @param {*} [options] Override http request option.
@@ -2120,7 +2227,7 @@ export const AdminPunishmentsApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = AdminPunishmentsApiAxiosParamCreator(configuration)
     return {
         /**
-         * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+         * Apply a punishment to one or more targets. The authenticated user is recorded as the issuer.
          * @summary Apply punishment
          * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest 
          * @param {*} [options] Override http request option.
@@ -2133,7 +2240,7 @@ export const AdminPunishmentsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+         * Preview the impact of a punishment across one or more targets. No changes are made.
          * @summary Evaluate punishment impact
          * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest 
          * @param {*} [options] Override http request option.
@@ -2166,7 +2273,7 @@ export const AdminPunishmentsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Search for players by UUID or username, or look up all players associated with an IP address. Used to populate the target table before issuing a punishment.
+         * Search for players by UUID or username, or look up all players associated with an IP address.
          * @summary Search punishment targets
          * @param {string} q UUID, username, or partial/full IP address to search for
          * @param {*} [options] Override http request option.
@@ -2188,7 +2295,7 @@ export const AdminPunishmentsApiFactory = function (configuration?: Configuratio
     const localVarFp = AdminPunishmentsApiFp(configuration)
     return {
         /**
-         * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+         * Apply a punishment to one or more targets. The authenticated user is recorded as the issuer.
          * @summary Apply punishment
          * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest 
          * @param {*} [options] Override http request option.
@@ -2198,7 +2305,7 @@ export const AdminPunishmentsApiFactory = function (configuration?: Configuratio
             return localVarFp.applyPunishment(adminApplyPunishmentRequest, options).then((request) => request(axios, basePath));
         },
         /**
-         * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+         * Preview the impact of a punishment across one or more targets. No changes are made.
          * @summary Evaluate punishment impact
          * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest 
          * @param {*} [options] Override http request option.
@@ -2225,7 +2332,7 @@ export const AdminPunishmentsApiFactory = function (configuration?: Configuratio
             return localVarFp.getPunishments(page, limit, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options).then((request) => request(axios, basePath));
         },
         /**
-         * Search for players by UUID or username, or look up all players associated with an IP address. Used to populate the target table before issuing a punishment.
+         * Search for players by UUID or username, or look up all players associated with an IP address.
          * @summary Search punishment targets
          * @param {string} q UUID, username, or partial/full IP address to search for
          * @param {*} [options] Override http request option.
@@ -2242,7 +2349,7 @@ export const AdminPunishmentsApiFactory = function (configuration?: Configuratio
  */
 export class AdminPunishmentsApi extends BaseAPI {
     /**
-     * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+     * Apply a punishment to one or more targets. The authenticated user is recorded as the issuer.
      * @summary Apply punishment
      * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest 
      * @param {*} [options] Override http request option.
@@ -2253,7 +2360,7 @@ export class AdminPunishmentsApi extends BaseAPI {
     }
 
     /**
-     * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+     * Preview the impact of a punishment across one or more targets. No changes are made.
      * @summary Evaluate punishment impact
      * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest 
      * @param {*} [options] Override http request option.
@@ -2282,7 +2389,7 @@ export class AdminPunishmentsApi extends BaseAPI {
     }
 
     /**
-     * Search for players by UUID or username, or look up all players associated with an IP address. Used to populate the target table before issuing a punishment.
+     * Search for players by UUID or username, or look up all players associated with an IP address.
      * @summary Search punishment targets
      * @param {string} q UUID, username, or partial/full IP address to search for
      * @param {*} [options] Override http request option.
@@ -2955,9 +3062,9 @@ export class ConnectionApi extends BaseAPI {
 export const PlayerApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials. 
+         * Retrieves player information by Minecraft UUID including first join status and login timestamp.
          * @summary Get player information
-         * @param {string} uuid The Minecraft player UUID (with or without dashes)
+         * @param {string} uuid 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -2993,9 +3100,9 @@ export const PlayerApiAxiosParamCreator = function (configuration?: Configuratio
             };
         },
         /**
-         * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log. 
+         * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record are omitted from the response. 
          * @summary Batch resolve UUIDs to usernames
-         * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+         * @param {Array<string>} uuids List of player UUIDs to resolve
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -3043,9 +3150,9 @@ export const PlayerApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = PlayerApiAxiosParamCreator(configuration)
     return {
         /**
-         * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials. 
+         * Retrieves player information by Minecraft UUID including first join status and login timestamp.
          * @summary Get player information
-         * @param {string} uuid The Minecraft player UUID (with or without dashes)
+         * @param {string} uuid 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -3056,9 +3163,9 @@ export const PlayerApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log. 
+         * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record are omitted from the response. 
          * @summary Batch resolve UUIDs to usernames
-         * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+         * @param {Array<string>} uuids List of player UUIDs to resolve
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -3078,9 +3185,9 @@ export const PlayerApiFactory = function (configuration?: Configuration, basePat
     const localVarFp = PlayerApiFp(configuration)
     return {
         /**
-         * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials. 
+         * Retrieves player information by Minecraft UUID including first join status and login timestamp.
          * @summary Get player information
-         * @param {string} uuid The Minecraft player UUID (with or without dashes)
+         * @param {string} uuid 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -3088,9 +3195,9 @@ export const PlayerApiFactory = function (configuration?: Configuration, basePat
             return localVarFp.getPlayer1(uuid, options).then((request) => request(axios, basePath));
         },
         /**
-         * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log. 
+         * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record are omitted from the response. 
          * @summary Batch resolve UUIDs to usernames
-         * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+         * @param {Array<string>} uuids List of player UUIDs to resolve
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -3105,9 +3212,9 @@ export const PlayerApiFactory = function (configuration?: Configuration, basePat
  */
 export class PlayerApi extends BaseAPI {
     /**
-     * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials. 
+     * Retrieves player information by Minecraft UUID including first join status and login timestamp.
      * @summary Get player information
-     * @param {string} uuid The Minecraft player UUID (with or without dashes)
+     * @param {string} uuid 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -3116,9 +3223,9 @@ export class PlayerApi extends BaseAPI {
     }
 
     /**
-     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log. 
+     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record are omitted from the response. 
      * @summary Batch resolve UUIDs to usernames
-     * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+     * @param {Array<string>} uuids List of player UUIDs to resolve
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */

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