@rebornteam/reborn-api 4.8.0 → 4.9.1

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.8.0
+ * The version of the OpenAPI document: 4.9.1
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -2573,6 +2573,35 @@ export const AdminPlayersApiAxiosParamCreator = function (configuration) {
                 options: localVarRequestOptions,
             };
         }),
+        /**
+         * Submits an async job that recomputes every player\'s trust factor, refreshes the cached player.trust_factor column, and appends today\'s player_trust_factor_history snapshot — the same work the nightly job does, runnable on demand (e.g. to populate the cache immediately after deploy instead of waiting for 03:00 UTC, or after a trust-factor formula change). Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. Idempotent.
+         * @summary Start a trust-factor recompute job
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        trustFactorRecompute: (...args_1) => __awaiter(this, [...args_1], void 0, function* (options = {}) {
+            const localVarPath = `/admin/player/trust-factor-recompute`;
+            // 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 = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
     };
 };
 /**
@@ -2915,6 +2944,21 @@ export const AdminPlayersApiFp = function (configuration) {
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
+        /**
+         * Submits an async job that recomputes every player\'s trust factor, refreshes the cached player.trust_factor column, and appends today\'s player_trust_factor_history snapshot — the same work the nightly job does, runnable on demand (e.g. to populate the cache immediately after deploy instead of waiting for 03:00 UTC, or after a trust-factor formula change). Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. Idempotent.
+         * @summary Start a trust-factor recompute job
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        trustFactorRecompute(options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.trustFactorRecompute(options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.trustFactorRecompute']) === 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);
+            });
+        },
     };
 };
 /**
@@ -3137,6 +3181,15 @@ export const AdminPlayersApiFactory = function (configuration, basePath, axios)
         trustFactorHistory(uuid, days, options) {
             return localVarFp.trustFactorHistory(uuid, days, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Submits an async job that recomputes every player\'s trust factor, refreshes the cached player.trust_factor column, and appends today\'s player_trust_factor_history snapshot — the same work the nightly job does, runnable on demand (e.g. to populate the cache immediately after deploy instead of waiting for 03:00 UTC, or after a trust-factor formula change). Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. Idempotent.
+         * @summary Start a trust-factor recompute job
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        trustFactorRecompute(options) {
+            return localVarFp.trustFactorRecompute(options).then((request) => request(axios, basePath));
+        },
     };
 };
 /**
@@ -3357,6 +3410,15 @@ export class AdminPlayersApi extends BaseAPI {
     trustFactorHistory(uuid, days, options) {
         return AdminPlayersApiFp(this.configuration).trustFactorHistory(uuid, days, options).then((request) => request(this.axios, this.basePath));
     }
+    /**
+     * Submits an async job that recomputes every player\'s trust factor, refreshes the cached player.trust_factor column, and appends today\'s player_trust_factor_history snapshot — the same work the nightly job does, runnable on demand (e.g. to populate the cache immediately after deploy instead of waiting for 03:00 UTC, or after a trust-factor formula change). Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. Idempotent.
+     * @summary Start a trust-factor recompute job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    trustFactorRecompute(options) {
+        return AdminPlayersApiFp(this.configuration).trustFactorRecompute(options).then((request) => request(this.axios, this.basePath));
+    }
 }
 /**
  * AdminPunishmentsApi - axios parameter creator
@@ -4116,10 +4178,11 @@ export const AuthenticationApiAxiosParamCreator = function (configuration) {
          * @summary Discord - OAuth2 callback
          * @param {string | null} [code] Authorization code provided by Discord on successful approval
          * @param {string | null} [error] Error code provided by Discord if the user denied access
+         * @param {string | null} [state] Opaque value echoed back by Discord — carries the client\'s chosen redirect target
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        callback: (code_1, error_1, ...args_1) => __awaiter(this, [code_1, error_1, ...args_1], void 0, function* (code, error, options = {}) {
+        callback: (code_1, error_1, state_1, ...args_1) => __awaiter(this, [code_1, error_1, state_1, ...args_1], void 0, function* (code, error, state, options = {}) {
             const localVarPath = `/auth/discord/callback`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -4139,6 +4202,9 @@ export const AuthenticationApiAxiosParamCreator = function (configuration) {
             if (error !== undefined) {
                 localVarQueryParameter['error'] = error;
             }
+            if (state !== undefined) {
+                localVarQueryParameter['state'] = state;
+            }
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
@@ -4148,12 +4214,13 @@ export const AuthenticationApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+         * Redirects the browser (or native in-app browser session) to Discord\'s OAuth2 authorization page. The optional `redirect` parameter names the final destination the signed JWT should be sent to once auth completes — the web app URL (default) or a native deep-link scheme such as `reborn://auth/callback`. It must be allowlisted (DISCORD_ADMIN_FRONTEND_URL or one of DISCORD_ADMIN_ALLOWED_REDIRECTS); the value is carried through Discord via the OAuth `state` parameter and re-validated on the callback.
          * @summary Discord - Initiate login
+         * @param {string | null} [redirect] Final redirect target for the JWT (web URL or native deep link). Must be allowlisted. Defaults to the web admin frontend.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        initiateLogin: (...args_1) => __awaiter(this, [...args_1], void 0, function* (options = {}) {
+        initiateLogin: (redirect_1, ...args_1) => __awaiter(this, [redirect_1, ...args_1], void 0, function* (redirect, options = {}) {
             const localVarPath = `/auth/discord`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -4167,6 +4234,9 @@ export const AuthenticationApiAxiosParamCreator = function (configuration) {
             // authentication DiscordAuth required
             // http bearer authentication required
             yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (redirect !== undefined) {
+                localVarQueryParameter['redirect'] = redirect;
+            }
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
@@ -4261,28 +4331,30 @@ export const AuthenticationApiFp = function (configuration) {
          * @summary Discord - OAuth2 callback
          * @param {string | null} [code] Authorization code provided by Discord on successful approval
          * @param {string | null} [error] Error code provided by Discord if the user denied access
+         * @param {string | null} [state] Opaque value echoed back by Discord — carries the client\'s chosen redirect target
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        callback(code, error, options) {
+        callback(code, error, state, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.callback(code, error, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.callback(code, error, state, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AuthenticationApi.callback']) === 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);
             });
         },
         /**
-         * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+         * Redirects the browser (or native in-app browser session) to Discord\'s OAuth2 authorization page. The optional `redirect` parameter names the final destination the signed JWT should be sent to once auth completes — the web app URL (default) or a native deep-link scheme such as `reborn://auth/callback`. It must be allowlisted (DISCORD_ADMIN_FRONTEND_URL or one of DISCORD_ADMIN_ALLOWED_REDIRECTS); the value is carried through Discord via the OAuth `state` parameter and re-validated on the callback.
          * @summary Discord - Initiate login
+         * @param {string | null} [redirect] Final redirect target for the JWT (web URL or native deep link). Must be allowlisted. Defaults to the web admin frontend.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        initiateLogin(options) {
+        initiateLogin(redirect, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.initiateLogin(options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.initiateLogin(redirect, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AuthenticationApi.initiateLogin']) === 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);
@@ -4334,20 +4406,22 @@ export const AuthenticationApiFactory = function (configuration, basePath, axios
          * @summary Discord - OAuth2 callback
          * @param {string | null} [code] Authorization code provided by Discord on successful approval
          * @param {string | null} [error] Error code provided by Discord if the user denied access
+         * @param {string | null} [state] Opaque value echoed back by Discord — carries the client\'s chosen redirect target
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        callback(code, error, options) {
-            return localVarFp.callback(code, error, options).then((request) => request(axios, basePath));
+        callback(code, error, state, options) {
+            return localVarFp.callback(code, error, state, options).then((request) => request(axios, basePath));
         },
         /**
-         * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+         * Redirects the browser (or native in-app browser session) to Discord\'s OAuth2 authorization page. The optional `redirect` parameter names the final destination the signed JWT should be sent to once auth completes — the web app URL (default) or a native deep-link scheme such as `reborn://auth/callback`. It must be allowlisted (DISCORD_ADMIN_FRONTEND_URL or one of DISCORD_ADMIN_ALLOWED_REDIRECTS); the value is carried through Discord via the OAuth `state` parameter and re-validated on the callback.
          * @summary Discord - Initiate login
+         * @param {string | null} [redirect] Final redirect target for the JWT (web URL or native deep link). Must be allowlisted. Defaults to the web admin frontend.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        initiateLogin(options) {
-            return localVarFp.initiateLogin(options).then((request) => request(axios, basePath));
+        initiateLogin(redirect, options) {
+            return localVarFp.initiateLogin(redirect, options).then((request) => request(axios, basePath));
         },
         /**
          * Returns the authenticated user\'s profile from their JWT claims. The session is already validated by the security rule before this endpoint is reached.
@@ -4381,20 +4455,22 @@ export class AuthenticationApi extends BaseAPI {
      * @summary Discord - OAuth2 callback
      * @param {string | null} [code] Authorization code provided by Discord on successful approval
      * @param {string | null} [error] Error code provided by Discord if the user denied access
+     * @param {string | null} [state] Opaque value echoed back by Discord — carries the client\'s chosen redirect target
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    callback(code, error, options) {
-        return AuthenticationApiFp(this.configuration).callback(code, error, options).then((request) => request(this.axios, this.basePath));
+    callback(code, error, state, options) {
+        return AuthenticationApiFp(this.configuration).callback(code, error, state, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+     * Redirects the browser (or native in-app browser session) to Discord\'s OAuth2 authorization page. The optional `redirect` parameter names the final destination the signed JWT should be sent to once auth completes — the web app URL (default) or a native deep-link scheme such as `reborn://auth/callback`. It must be allowlisted (DISCORD_ADMIN_FRONTEND_URL or one of DISCORD_ADMIN_ALLOWED_REDIRECTS); the value is carried through Discord via the OAuth `state` parameter and re-validated on the callback.
      * @summary Discord - Initiate login
+     * @param {string | null} [redirect] Final redirect target for the JWT (web URL or native deep link). Must be allowlisted. Defaults to the web admin frontend.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    initiateLogin(options) {
-        return AuthenticationApiFp(this.configuration).initiateLogin(options).then((request) => request(this.axios, this.basePath));
+    initiateLogin(redirect, options) {
+        return AuthenticationApiFp(this.configuration).initiateLogin(redirect, options).then((request) => request(this.axios, this.basePath));
     }
     /**
      * Returns the authenticated user\'s profile from their JWT claims. The session is already validated by the security rule before this endpoint is reached.

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

package/docs/AdminPlayersApi.md

@@ -24,6 +24,7 @@ All URIs are relative to *https://api.smsh.sh*
 |[**setAggressiveModeImmunity**](#setaggressivemodeimmunity) | **PATCH** /admin/player/{uuid}/aggressive-mode-immunity | Toggle aggressive-mode immunity|
 |[**trustFactorBreakdown**](#trustfactorbreakdown) | **GET** /admin/player/{uuid}/trust-factor-breakdown | Trust factor breakdown for a player|
 |[**trustFactorHistory**](#trustfactorhistory) | **GET** /admin/player/{uuid}/trust-factor-history | Trust factor history for a player|
+|[**trustFactorRecompute**](#trustfactorrecompute) | **POST** /admin/player/trust-factor-recompute | Start a trust-factor recompute job|
 
 # **addAltExemption**
 > addAltExemption(adminCreateAltExemptionRequest)
@@ -1144,3 +1145,49 @@ const { status, data } = await apiInstance.trustFactorHistory(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
+# **trustFactorRecompute**
+> AdminAsyncJobStartResponse trustFactorRecompute()
+
+Submits an async job that recomputes every player\'s trust factor, refreshes the cached player.trust_factor column, and appends today\'s player_trust_factor_history snapshot — the same work the nightly job does, runnable on demand (e.g. to populate the cache immediately after deploy instead of waiting for 03:00 UTC, or after a trust-factor formula change). Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. Idempotent.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+const { status, data } = await apiInstance.trustFactorRecompute();
+```
+
+### Parameters
+This endpoint does not have any parameters.
+
+
+### Return type
+
+**AdminAsyncJobStartResponse**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**202** | Job accepted; poll /admin/job/{id} for progress |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+

package/docs/AuthenticationApi.md

@@ -27,10 +27,12 @@ const apiInstance = new AuthenticationApi(configuration);
 
 let code: string; //Authorization code provided by Discord on successful approval (optional) (default to undefined)
 let error: string; //Error code provided by Discord if the user denied access (optional) (default to undefined)
+let state: string; //Opaque value echoed back by Discord — carries the client\'s chosen redirect target (optional) (default to undefined)
 
 const { status, data } = await apiInstance.callback(
     code,
-    error
+    error,
+    state
 );
 ```
 
@@ -40,6 +42,7 @@ const { status, data } = await apiInstance.callback(
 |------------- | ------------- | ------------- | -------------|
 | **code** | [**string**] | Authorization code provided by Discord on successful approval | (optional) defaults to undefined|
 | **error** | [**string**] | Error code provided by Discord if the user denied access | (optional) defaults to undefined|
+| **state** | [**string**] | Opaque value echoed back by Discord — carries the client\'s chosen redirect target | (optional) defaults to undefined|
 
 
 ### Return type
@@ -66,7 +69,7 @@ void (empty response body)
 # **initiateLogin**
 > initiateLogin()
 
-Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+Redirects the browser (or native in-app browser session) to Discord\'s OAuth2 authorization page. The optional `redirect` parameter names the final destination the signed JWT should be sent to once auth completes — the web app URL (default) or a native deep-link scheme such as `reborn://auth/callback`. It must be allowlisted (DISCORD_ADMIN_FRONTEND_URL or one of DISCORD_ADMIN_ALLOWED_REDIRECTS); the value is carried through Discord via the OAuth `state` parameter and re-validated on the callback. 
 
 ### Example
 
@@ -79,11 +82,18 @@ import {
 const configuration = new Configuration();
 const apiInstance = new AuthenticationApi(configuration);
 
-const { status, data } = await apiInstance.initiateLogin();
+let redirect: string; //Final redirect target for the JWT (web URL or native deep link). Must be allowlisted. Defaults to the web admin frontend. (optional) (default to undefined)
+
+const { status, data } = await apiInstance.initiateLogin(
+    redirect
+);
 ```
 
 ### Parameters
-This endpoint does not have any parameters.
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **redirect** | [**string**] | Final redirect target for the JWT (web URL or native deep link). Must be allowlisted. Defaults to the web admin frontend. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -104,6 +114,7 @@ void (empty response body)
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**302** | Redirect to Discord authorization URL |  -  |
+|**400** | The requested `redirect` is not allowlisted |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 

package/index.ts

@@ -4,7 +4,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication 
  *
- * The version of the OpenAPI document: 4.8.0
+ * The version of the OpenAPI document: 4.9.1
  * 
  *
  * 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.8.0",
+  "version": "4.9.1",
   "description": "OpenAPI client for @rebornteam/reborn-api",
   "author": "OpenAPI-Generator Contributors",
   "repository": {