@rebornteam/reborn-api 4.8.0 → 4.9.1

package/README.md

@@ -1,4 +1,4 @@
-## @rebornteam/reborn-api@4.8.0
+## @rebornteam/reborn-api@4.9.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@4.8.0 --save
+npm install @rebornteam/reborn-api@4.9.1 --save
 ```
 
 _unPublished (not recommended):_
@@ -92,6 +92,7 @@ Class | Method | HTTP request | Description
 *AdminPlayersApi* | [**setAggressiveModeImmunity**](docs/AdminPlayersApi.md#setaggressivemodeimmunity) | **PATCH** /admin/player/{uuid}/aggressive-mode-immunity | Toggle aggressive-mode immunity
 *AdminPlayersApi* | [**trustFactorBreakdown**](docs/AdminPlayersApi.md#trustfactorbreakdown) | **GET** /admin/player/{uuid}/trust-factor-breakdown | Trust factor breakdown for a player
 *AdminPlayersApi* | [**trustFactorHistory**](docs/AdminPlayersApi.md#trustfactorhistory) | **GET** /admin/player/{uuid}/trust-factor-history | Trust factor history for a player
+*AdminPlayersApi* | [**trustFactorRecompute**](docs/AdminPlayersApi.md#trustfactorrecompute) | **POST** /admin/player/trust-factor-recompute | Start a trust-factor recompute job
 *AdminPunishmentsApi* | [**applyPunishment**](docs/AdminPunishmentsApi.md#applypunishment) | **POST** /admin/punishment/apply | Apply punishment
 *AdminPunishmentsApi* | [**createDraft**](docs/AdminPunishmentsApi.md#createdraft) | **POST** /admin/punishment/draft | Evaluate punishment impact
 *AdminPunishmentsApi* | [**editPunishment**](docs/AdminPunishmentsApi.md#editpunishment) | **PATCH** /admin/punishment/{id} | Edit a punishment

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.8.0
+ * The version of the OpenAPI document: 4.9.1
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -4701,6 +4701,40 @@ export const AdminPlayersApiAxiosParamCreator = function (configuration?: Config
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
 
+            return {
+                url: toPathString(localVarUrlObj),
+                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: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            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 = { 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,
@@ -4989,6 +5023,18 @@ export const AdminPlayersApiFp = function(configuration?: Configuration) {
             const localVarOperationServerBasePath = operationServerMap['AdminPlayersApi.trustFactorHistory']?.[localVarOperationServerIndex]?.url;
             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}
+         */
+        async trustFactorRecompute(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAsyncJobStartResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.trustFactorRecompute(options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminPlayersApi.trustFactorRecompute']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
     }
 };
 
@@ -5212,6 +5258,15 @@ export const AdminPlayersApiFactory = function (configuration?: Configuration, b
         trustFactorHistory(uuid: string, days?: number, options?: RawAxiosRequestConfig): AxiosPromise<AdminTrustFactorHistoryEntry> {
             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?: RawAxiosRequestConfig): AxiosPromise<AdminAsyncJobStartResponse> {
+            return localVarFp.trustFactorRecompute(options).then((request) => request(axios, basePath));
+        },
     };
 };
 
@@ -5452,6 +5507,16 @@ export class AdminPlayersApi extends BaseAPI {
     public trustFactorHistory(uuid: string, days?: number, options?: RawAxiosRequestConfig) {
         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}
+     */
+    public trustFactorRecompute(options?: RawAxiosRequestConfig) {
+        return AdminPlayersApiFp(this.configuration).trustFactorRecompute(options).then((request) => request(this.axios, this.basePath));
+    }
 }
 
 
@@ -6262,10 +6327,11 @@ export const AuthenticationApiAxiosParamCreator = function (configuration?: Conf
          * @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\&#39;s chosen redirect target
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        callback: async (code?: string | null, error?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        callback: async (code?: string | null, error?: string | null, state?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
             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);
@@ -6290,6 +6356,10 @@ export const AuthenticationApiAxiosParamCreator = function (configuration?: Conf
                 localVarQueryParameter['error'] = error;
             }
 
+            if (state !== undefined) {
+                localVarQueryParameter['state'] = state;
+            }
+
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
@@ -6301,12 +6371,13 @@ export const AuthenticationApiAxiosParamCreator = function (configuration?: Conf
             };
         },
         /**
-         * 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: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        initiateLogin: async (redirect?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
             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);
@@ -6323,6 +6394,10 @@ export const AuthenticationApiAxiosParamCreator = function (configuration?: Conf
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
+            if (redirect !== undefined) {
+                localVarQueryParameter['redirect'] = redirect;
+            }
+
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
@@ -6433,23 +6508,25 @@ export const AuthenticationApiFp = function(configuration?: 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\&#39;s chosen redirect target
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.callback(code, error, options);
+        async callback(code?: string | null, error?: string | null, state?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.callback(code, error, state, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['AuthenticationApi.callback']?.[localVarOperationServerIndex]?.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}
          */
-        async initiateLogin(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.initiateLogin(options);
+        async initiateLogin(redirect?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.initiateLogin(redirect, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['AuthenticationApi.initiateLogin']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -6495,20 +6572,22 @@ export const AuthenticationApiFactory = function (configuration?: 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\&#39;s chosen redirect target
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<void> {
-            return localVarFp.callback(code, error, options).then((request) => request(axios, basePath));
+        callback(code?: string | null, error?: string | null, state?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            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?: RawAxiosRequestConfig): AxiosPromise<void> {
-            return localVarFp.initiateLogin(options).then((request) => request(axios, basePath));
+        initiateLogin(redirect?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            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.
@@ -6543,21 +6622,23 @@ 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\&#39;s chosen redirect target
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig) {
-        return AuthenticationApiFp(this.configuration).callback(code, error, options).then((request) => request(this.axios, this.basePath));
+    public callback(code?: string | null, error?: string | null, state?: string | null, options?: RawAxiosRequestConfig) {
+        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}
      */
-    public initiateLogin(options?: RawAxiosRequestConfig) {
-        return AuthenticationApiFp(this.configuration).initiateLogin(options).then((request) => request(this.axios, this.basePath));
+    public initiateLogin(redirect?: string | null, options?: RawAxiosRequestConfig) {
+        return AuthenticationApiFp(this.configuration).initiateLogin(redirect, 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.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/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.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/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.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/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.8.0
+ * The version of the OpenAPI document: 4.9.1
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -2944,6 +2944,13 @@ export declare const AdminPlayersApiAxiosParamCreator: (configuration?: Configur
      * @throws {RequiredError}
      */
     trustFactorHistory: (uuid: string, days?: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 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?: RawAxiosRequestConfig) => Promise<RequestArgs>;
 };
 /**
  * AdminPlayersApi - functional programming interface
@@ -3123,6 +3130,13 @@ export declare const AdminPlayersApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     trustFactorHistory(uuid: string, days?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminTrustFactorHistoryEntry>>;
+    /**
+     * 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?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAsyncJobStartResponse>>;
 };
 /**
  * AdminPlayersApi - factory interface
@@ -3302,6 +3316,13 @@ export declare const AdminPlayersApiFactory: (configuration?: Configuration, bas
      * @throws {RequiredError}
      */
     trustFactorHistory(uuid: string, days?: number, options?: RawAxiosRequestConfig): AxiosPromise<AdminTrustFactorHistoryEntry>;
+    /**
+     * 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?: RawAxiosRequestConfig): AxiosPromise<AdminAsyncJobStartResponse>;
 };
 /**
  * AdminPlayersApi - object-oriented interface
@@ -3481,6 +3502,13 @@ export declare class AdminPlayersApi extends BaseAPI {
      * @throws {RequiredError}
      */
     trustFactorHistory(uuid: string, days?: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminTrustFactorHistoryEntry, any, {}>>;
+    /**
+     * 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?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAsyncJobStartResponse, any, {}>>;
 }
 /**
  * AdminPunishmentsApi - axios parameter creator
@@ -3855,17 +3883,19 @@ export declare const AuthenticationApiAxiosParamCreator: (configuration?: Config
      * @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\&#39;s chosen redirect target
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    callback: (code?: string | null, error?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    callback: (code?: string | null, error?: string | null, state?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * 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?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    initiateLogin: (redirect?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Returns the authenticated user\'s profile from their JWT claims. The session is already validated by the security rule before this endpoint is reached.
      * @summary Get current user profile
@@ -3893,17 +3923,19 @@ export declare const AuthenticationApiFp: (configuration?: 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\&#39;s chosen redirect target
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    callback(code?: string | null, error?: string | null, state?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
     /**
-     * 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?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    initiateLogin(redirect?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
     /**
      * Returns the authenticated user\'s profile from their JWT claims. The session is already validated by the security rule before this endpoint is reached.
      * @summary Get current user profile
@@ -3931,17 +3963,19 @@ export declare const AuthenticationApiFactory: (configuration?: Configuration, b
      * @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\&#39;s chosen redirect target
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    callback(code?: string | null, error?: string | null, state?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<void>;
     /**
-     * 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?: RawAxiosRequestConfig): AxiosPromise<void>;
+    initiateLogin(redirect?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<void>;
     /**
      * Returns the authenticated user\'s profile from their JWT claims. The session is already validated by the security rule before this endpoint is reached.
      * @summary Get current user profile
@@ -3969,17 +4003,19 @@ export declare 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\&#39;s chosen redirect target
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    callback(code?: string | null, error?: string | null, state?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
     /**
-     * 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?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    initiateLogin(redirect?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
     /**
      * Returns the authenticated user\'s profile from their JWT claims. The session is already validated by the security rule before this endpoint is reached.
      * @summary Get current user profile