@rebornteam/reborn-api 4.9.0 → 4.9.2

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.9.0
+ * The version of the OpenAPI document: 4.9.2
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -511,6 +511,36 @@ export interface AdminCreatePunishmentDraftRequest {
 }
 
 
+/**
+ * One cell of the activity heatmap: connection volume bucketed by UTC day-of-week (0 = Sunday) and hour-of-day (0--23).
+ */
+export interface AdminDashboardActivityCell {
+    /**
+     * UTC day of week, 0 = Sunday … 6 = Saturday
+     */
+    'dayOfWeek': number;
+    /**
+     * UTC hour of day, 0–23
+     */
+    'hourOfDay': number;
+    /**
+     * Connections in this bucket
+     */
+    'count': number;
+}
+/**
+ * Report count for one category over the window.
+ */
+export interface AdminDashboardCategoryCount {
+    /**
+     * Report category
+     */
+    'category': string;
+    /**
+     * Reports filed in this category
+     */
+    'count': number;
+}
 export interface AdminDashboardConnectionResponse {
     'id': number;
     'ipAddress': string;
@@ -534,6 +564,166 @@ export interface AdminDashboardConnectionResponse {
      */
     'results': Array<AdminConnectionCheckResult>;
 }
+/**
+ * Connection volume for one country over the requested window.
+ */
+export interface AdminDashboardCountryCount {
+    /**
+     * ISO country code
+     */
+    'country': string;
+    /**
+     * Distinct connections geolocated to this country
+     */
+    'connections': number;
+    /**
+     * Of those, how many were flagged VPN/proxy
+     */
+    'vpnConnections': number;
+}
+/**
+ * One day of the session-activity timeseries (UTC day).
+ */
+export interface AdminDashboardDailySessions {
+    /**
+     * UTC day, YYYY-MM-DD
+     */
+    'day': string;
+    /**
+     * Sessions started this day
+     */
+    'sessionCount': number;
+    /**
+     * Distinct players active this day
+     */
+    'activePlayers': number;
+    /**
+     * Mean completed-session length this day, seconds
+     */
+    'avgDurationSeconds': number;
+}
+/**
+ * A moderator and their audit-log action count over the window.
+ */
+export interface AdminDashboardModeratorActivity {
+    /**
+     * Moderator username
+     */
+    'actor': string;
+    /**
+     * Audit-log actions performed
+     */
+    'actionCount': number;
+}
+/**
+ * \"At a glance\" dashboard tiles --- current pulse of the network plus rolling 7-day session averages. Session durations are in seconds.
+ */
+export interface AdminDashboardOverview {
+    /**
+     * Players with an open session right now
+     */
+    'onlinePlayers': number;
+    /**
+     * Players whose first join was today (UTC)
+     */
+    'newPlayersToday': number;
+    /**
+     * Distinct players seen today (UTC)
+     */
+    'dauToday': number;
+    /**
+     * Mean completed-session length over the last 7 days, seconds
+     */
+    'avgSessionSeconds': number;
+    /**
+     * Median completed-session length over the last 7 days, seconds
+     */
+    'medianSessionSeconds': number;
+    /**
+     * Unexpired BAN punishments
+     */
+    'activeBans': number;
+    /**
+     * Unexpired MUTE punishments
+     */
+    'activeMutes': number;
+    /**
+     * Reports awaiting resolution
+     */
+    'openReports': number;
+}
+/**
+ * Punishments issued on one UTC day for a single type (BAN/MUTE/KICK/WARNING).
+ */
+export interface AdminDashboardPunishmentDaily {
+    /**
+     * UTC day, YYYY-MM-DD
+     */
+    'day': string;
+    /**
+     * Punishment type
+     */
+    'type': string;
+    /**
+     * Issued this day of this type
+     */
+    'count': number;
+}
+/**
+ * Report backlog, resolution speed, and category breakdown over the window.
+ */
+export interface AdminDashboardReportSummary {
+    /**
+     * Reports awaiting resolution (all time)
+     */
+    'openReports': number;
+    /**
+     * Reports resolved within the window
+     */
+    'resolvedReports': number;
+    /**
+     * Mean time-to-resolution within the window, seconds
+     */
+    'avgResolutionSeconds': number;
+    /**
+     * Reports filed within the window, grouped by category
+     */
+    'byCategory': Array<AdminDashboardCategoryCount>;
+}
+/**
+ * Online server count and current player load for a region/game-type pair.
+ */
+export interface AdminDashboardServerRegion {
+    /**
+     * Server region
+     */
+    'region': string;
+    /**
+     * Game type
+     */
+    'gameType': string;
+    /**
+     * Online server instances
+     */
+    'onlineServers': number;
+    /**
+     * Players currently in open sessions on those servers
+     */
+    'players': number;
+}
+/**
+ * One bar of the trust-factor distribution histogram. Bucket 0 = scores 0--9, bucket 9 = scores 90--100; count is players whose latest snapshot falls in it.
+ */
+export interface AdminDashboardTrustBucket {
+    /**
+     * Histogram bucket index, 0–9 (each spans 10 trust points)
+     */
+    'bucket': number;
+    /**
+     * Players in this bucket
+     */
+    'count': number;
+}
 export interface AdminGetDashboardStats {
     'totalPlayers': number;
     'totalConnections': number;
@@ -3438,13 +3628,14 @@ export class AdminConnectionsApi extends BaseAPI {
 export const AdminDashboardApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Returns aggregate counts for clients, connections, and players in the system.
-         * @summary Get dashboard statistics
+         * Connection volume bucketed by UTC day-of-week (0=Sunday) and hour-of-day (0–23) over the window.
+         * @summary Connection activity heatmap
+         * @param {number} [days] Trailing window in days
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        dashboardStats: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            const localVarPath = `/admin/dashboard`;
+        activityHeatmap: async (days?: number, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/admin/dashboard/connections/activity`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -3460,6 +3651,10 @@ export const AdminDashboardApiAxiosParamCreator = function (configuration?: Conf
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
+            if (days !== undefined) {
+                localVarQueryParameter['days'] = days;
+            }
+
             localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -3471,82 +3666,59 @@ export const AdminDashboardApiAxiosParamCreator = function (configuration?: Conf
                 options: localVarRequestOptions,
             };
         },
-    }
-};
-
-/**
- * AdminDashboardApi - functional programming interface
- */
-export const AdminDashboardApiFp = function(configuration?: Configuration) {
-    const localVarAxiosParamCreator = AdminDashboardApiAxiosParamCreator(configuration)
-    return {
         /**
-         * Returns aggregate counts for clients, connections, and players in the system.
-         * @summary Get dashboard statistics
+         * Top countries by distinct connection volume over the window, with the VPN/proxy-flagged subset.
+         * @summary Connections by country
+         * @param {number} [days] Trailing window in days
+         * @param {number} [limit] Max countries to return
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async dashboardStats(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminGetDashboardStats>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.dashboardStats(options);
-            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['AdminDashboardApi.dashboardStats']?.[localVarOperationServerIndex]?.url;
-            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
-        },
-    }
-};
+        connectionsByCountry: async (days?: number, limit?: number, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/admin/dashboard/connections/countries`;
+            // 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;
+            }
 
-/**
- * AdminDashboardApi - factory interface
- */
-export const AdminDashboardApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
-    const localVarFp = AdminDashboardApiFp(configuration)
-    return {
-        /**
-         * Returns aggregate counts for clients, connections, and players in the system.
-         * @summary Get dashboard statistics
-         * @param {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        dashboardStats(options?: RawAxiosRequestConfig): AxiosPromise<AdminGetDashboardStats> {
-            return localVarFp.dashboardStats(options).then((request) => request(axios, basePath));
-        },
-    };
-};
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
 
-/**
- * AdminDashboardApi - object-oriented interface
- */
-export class AdminDashboardApi extends BaseAPI {
-    /**
-     * Returns aggregate counts for clients, connections, and players in the system.
-     * @summary Get dashboard statistics
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    public dashboardStats(options?: RawAxiosRequestConfig) {
-        return AdminDashboardApiFp(this.configuration).dashboardStats(options).then((request) => request(this.axios, this.basePath));
-    }
-}
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            if (days !== undefined) {
+                localVarQueryParameter['days'] = days;
+            }
 
+            if (limit !== undefined) {
+                localVarQueryParameter['limit'] = limit;
+            }
 
+            localVarHeaderParameter['Accept'] = 'application/json';
 
-/**
- * AdminJobsApi - axios parameter creator
- */
-export const AdminJobsApiAxiosParamCreator = function (configuration?: Configuration) {
-    return {
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
         /**
-         * Flips cancel_requested on the row. The host instance sees this at its next progress tick and bails out, transitioning the row to CANCELLED. Already-terminal jobs (COMPLETED/FAILED/CANCELLED) return 404.
-         * @summary Request cancellation of an async job
-         * @param {string} id Job id
+         * Per-day session count, distinct active players, and mean completed-session length over the requested window.
+         * @summary Daily session activity
+         * @param {number} [days] Trailing window in days
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        cancel: async (id: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'id' is not null or undefined
-            assertParamExists('cancel', 'id', id)
-            const localVarPath = `/admin/job/{id}`
-                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+        dailySessions: async (days?: number, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/admin/dashboard/sessions/daily`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -3554,7 +3726,7 @@ export const AdminJobsApiAxiosParamCreator = function (configuration?: Configura
                 baseOptions = configuration.baseOptions;
             }
 
-            const localVarRequestOptions = { method: 'DELETE', ...baseOptions, ...options};
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
             const localVarHeaderParameter = {} as any;
             const localVarQueryParameter = {} as any;
 
@@ -3562,6 +3734,11 @@ export const AdminJobsApiAxiosParamCreator = function (configuration?: Configura
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
+            if (days !== undefined) {
+                localVarQueryParameter['days'] = days;
+            }
+
+            localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
@@ -3573,17 +3750,13 @@ export const AdminJobsApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * Returns the CSV emitted by the job — typically one row per record the job touched. The first line is a header; subsequent lines are RFC-4180 escaped data rows. 404 when the job has no artifact (either it didn\'t emit one, or it hasn\'t finished yet).
-         * @summary Download a job\'s CSV artifact
-         * @param {string} id Job id
+         * Returns aggregate counts for clients, connections, and players in the system.
+         * @summary Get dashboard statistics
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        downloadArtifact: async (id: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'id' is not null or undefined
-            assertParamExists('downloadArtifact', 'id', id)
-            const localVarPath = `/admin/job/{id}/artifact.csv`
-                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+        dashboardStats: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/admin/dashboard`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -3599,7 +3772,7 @@ export const AdminJobsApiAxiosParamCreator = function (configuration?: Configura
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
-            localVarHeaderParameter['Accept'] = 'text/csv';
+            localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
@@ -3611,17 +3784,13 @@ export const AdminJobsApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * The polling target — the admin UI hits this every ~2 s while a job is running to update its progress bar.
-         * @summary Get one async job
-         * @param {string} id Job id
+         * At-a-glance counts: players online now, new players today, DAU, 7-day mean/median session length, active bans/mutes, and open reports.
+         * @summary Dashboard overview tiles
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        get: async (id: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'id' is not null or undefined
-            assertParamExists('get', 'id', id)
-            const localVarPath = `/admin/job/{id}`
-                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+        overview: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/admin/dashboard/overview`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -3649,17 +3818,14 @@ export const AdminJobsApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * Paginated, newest first. Filter by status to see only RUNNING jobs (the live queue) or COMPLETED / FAILED / CANCELLED history.
-         * @summary List async jobs
-         * @param {Pageable} pageable 
-         * @param {JobStatus | null} [status] Filter by status (omit for all states)
+         * Daily punishment issuance over the window, split by type (BAN/MUTE/KICK/WARNING) — feeds the stacked chart.
+         * @summary Punishments by type over time
+         * @param {number} [days] Trailing window in days
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        list: async (pageable: Pageable, status?: JobStatus | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'pageable' is not null or undefined
-            assertParamExists('list', 'pageable', pageable)
-            const localVarPath = `/admin/job`;
+        punishmentsByType: async (days?: number, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/admin/dashboard/punishments/daily`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -3675,12 +3841,8 @@ export const AdminJobsApiAxiosParamCreator = function (configuration?: Configura
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
-            if (status !== undefined) {
-                localVarQueryParameter['status'] = status;
-            }
-
-            if (pageable !== undefined) {
-                localVarQueryParameter['pageable'] = pageable;
+            if (days !== undefined) {
+                localVarQueryParameter['days'] = days;
             }
 
             localVarHeaderParameter['Accept'] = 'application/json';
@@ -3694,14 +3856,691 @@ export const AdminJobsApiAxiosParamCreator = function (configuration?: Configura
                 options: localVarRequestOptions,
             };
         },
-    }
-};
-
-/**
- * AdminJobsApi - functional programming interface
- */
-export const AdminJobsApiFp = function(configuration?: Configuration) {
-    const localVarAxiosParamCreator = AdminJobsApiAxiosParamCreator(configuration)
+        /**
+         * Open backlog, reports resolved in the window, mean resolution time, and a category breakdown.
+         * @summary Report backlog & resolution speed
+         * @param {number} [days] Trailing window in days
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        reportSummary: async (days?: number, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/admin/dashboard/reports/summary`;
+            // 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: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            if (days !== undefined) {
+                localVarQueryParameter['days'] = days;
+            }
+
+            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,
+            };
+        },
+        /**
+         * Online server count and current player load per region/game-type.
+         * @summary Servers & players by region
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        serverRegions: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/admin/dashboard/servers/summary`;
+            // 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: 'GET', ...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,
+            };
+        },
+        /**
+         * Moderators ranked by audit-log action count over the window.
+         * @summary Top moderators by activity
+         * @param {number} [days] Trailing window in days
+         * @param {number} [limit] Max moderators to return
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        topModerators: async (days?: number, limit?: number, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/admin/dashboard/moderators/top`;
+            // 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: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            if (days !== undefined) {
+                localVarQueryParameter['days'] = days;
+            }
+
+            if (limit !== undefined) {
+                localVarQueryParameter['limit'] = limit;
+            }
+
+            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,
+            };
+        },
+        /**
+         * Histogram of every player\'s latest trust factor, bucketed into ten 10-point bins.
+         * @summary Trust-factor distribution
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        trustDistribution: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/admin/dashboard/trust/distribution`;
+            // 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: 'GET', ...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,
+            };
+        },
+    }
+};
+
+/**
+ * AdminDashboardApi - functional programming interface
+ */
+export const AdminDashboardApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = AdminDashboardApiAxiosParamCreator(configuration)
+    return {
+        /**
+         * Connection volume bucketed by UTC day-of-week (0=Sunday) and hour-of-day (0–23) over the window.
+         * @summary Connection activity heatmap
+         * @param {number} [days] Trailing window in days
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async activityHeatmap(days?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardActivityCell>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.activityHeatmap(days, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminDashboardApi.activityHeatmap']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Top countries by distinct connection volume over the window, with the VPN/proxy-flagged subset.
+         * @summary Connections by country
+         * @param {number} [days] Trailing window in days
+         * @param {number} [limit] Max countries to return
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async connectionsByCountry(days?: number, limit?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardCountryCount>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.connectionsByCountry(days, limit, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminDashboardApi.connectionsByCountry']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Per-day session count, distinct active players, and mean completed-session length over the requested window.
+         * @summary Daily session activity
+         * @param {number} [days] Trailing window in days
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async dailySessions(days?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardDailySessions>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.dailySessions(days, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminDashboardApi.dailySessions']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Returns aggregate counts for clients, connections, and players in the system.
+         * @summary Get dashboard statistics
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async dashboardStats(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminGetDashboardStats>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.dashboardStats(options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminDashboardApi.dashboardStats']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * At-a-glance counts: players online now, new players today, DAU, 7-day mean/median session length, active bans/mutes, and open reports.
+         * @summary Dashboard overview tiles
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async overview(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminDashboardOverview>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.overview(options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminDashboardApi.overview']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Daily punishment issuance over the window, split by type (BAN/MUTE/KICK/WARNING) — feeds the stacked chart.
+         * @summary Punishments by type over time
+         * @param {number} [days] Trailing window in days
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async punishmentsByType(days?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardPunishmentDaily>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.punishmentsByType(days, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminDashboardApi.punishmentsByType']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Open backlog, reports resolved in the window, mean resolution time, and a category breakdown.
+         * @summary Report backlog & resolution speed
+         * @param {number} [days] Trailing window in days
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async reportSummary(days?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminDashboardReportSummary>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.reportSummary(days, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminDashboardApi.reportSummary']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Online server count and current player load per region/game-type.
+         * @summary Servers & players by region
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async serverRegions(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardServerRegion>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.serverRegions(options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminDashboardApi.serverRegions']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Moderators ranked by audit-log action count over the window.
+         * @summary Top moderators by activity
+         * @param {number} [days] Trailing window in days
+         * @param {number} [limit] Max moderators to return
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async topModerators(days?: number, limit?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardModeratorActivity>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.topModerators(days, limit, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminDashboardApi.topModerators']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Histogram of every player\'s latest trust factor, bucketed into ten 10-point bins.
+         * @summary Trust-factor distribution
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async trustDistribution(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardTrustBucket>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.trustDistribution(options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminDashboardApi.trustDistribution']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+    }
+};
+
+/**
+ * AdminDashboardApi - factory interface
+ */
+export const AdminDashboardApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = AdminDashboardApiFp(configuration)
+    return {
+        /**
+         * Connection volume bucketed by UTC day-of-week (0=Sunday) and hour-of-day (0–23) over the window.
+         * @summary Connection activity heatmap
+         * @param {number} [days] Trailing window in days
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        activityHeatmap(days?: number, options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardActivityCell>> {
+            return localVarFp.activityHeatmap(days, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Top countries by distinct connection volume over the window, with the VPN/proxy-flagged subset.
+         * @summary Connections by country
+         * @param {number} [days] Trailing window in days
+         * @param {number} [limit] Max countries to return
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        connectionsByCountry(days?: number, limit?: number, options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardCountryCount>> {
+            return localVarFp.connectionsByCountry(days, limit, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Per-day session count, distinct active players, and mean completed-session length over the requested window.
+         * @summary Daily session activity
+         * @param {number} [days] Trailing window in days
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        dailySessions(days?: number, options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardDailySessions>> {
+            return localVarFp.dailySessions(days, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Returns aggregate counts for clients, connections, and players in the system.
+         * @summary Get dashboard statistics
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        dashboardStats(options?: RawAxiosRequestConfig): AxiosPromise<AdminGetDashboardStats> {
+            return localVarFp.dashboardStats(options).then((request) => request(axios, basePath));
+        },
+        /**
+         * At-a-glance counts: players online now, new players today, DAU, 7-day mean/median session length, active bans/mutes, and open reports.
+         * @summary Dashboard overview tiles
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        overview(options?: RawAxiosRequestConfig): AxiosPromise<AdminDashboardOverview> {
+            return localVarFp.overview(options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Daily punishment issuance over the window, split by type (BAN/MUTE/KICK/WARNING) — feeds the stacked chart.
+         * @summary Punishments by type over time
+         * @param {number} [days] Trailing window in days
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        punishmentsByType(days?: number, options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardPunishmentDaily>> {
+            return localVarFp.punishmentsByType(days, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Open backlog, reports resolved in the window, mean resolution time, and a category breakdown.
+         * @summary Report backlog & resolution speed
+         * @param {number} [days] Trailing window in days
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        reportSummary(days?: number, options?: RawAxiosRequestConfig): AxiosPromise<AdminDashboardReportSummary> {
+            return localVarFp.reportSummary(days, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Online server count and current player load per region/game-type.
+         * @summary Servers & players by region
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        serverRegions(options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardServerRegion>> {
+            return localVarFp.serverRegions(options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Moderators ranked by audit-log action count over the window.
+         * @summary Top moderators by activity
+         * @param {number} [days] Trailing window in days
+         * @param {number} [limit] Max moderators to return
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        topModerators(days?: number, limit?: number, options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardModeratorActivity>> {
+            return localVarFp.topModerators(days, limit, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Histogram of every player\'s latest trust factor, bucketed into ten 10-point bins.
+         * @summary Trust-factor distribution
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        trustDistribution(options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardTrustBucket>> {
+            return localVarFp.trustDistribution(options).then((request) => request(axios, basePath));
+        },
+    };
+};
+
+/**
+ * AdminDashboardApi - object-oriented interface
+ */
+export class AdminDashboardApi extends BaseAPI {
+    /**
+     * Connection volume bucketed by UTC day-of-week (0=Sunday) and hour-of-day (0–23) over the window.
+     * @summary Connection activity heatmap
+     * @param {number} [days] Trailing window in days
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public activityHeatmap(days?: number, options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).activityHeatmap(days, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Top countries by distinct connection volume over the window, with the VPN/proxy-flagged subset.
+     * @summary Connections by country
+     * @param {number} [days] Trailing window in days
+     * @param {number} [limit] Max countries to return
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public connectionsByCountry(days?: number, limit?: number, options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).connectionsByCountry(days, limit, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Per-day session count, distinct active players, and mean completed-session length over the requested window.
+     * @summary Daily session activity
+     * @param {number} [days] Trailing window in days
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public dailySessions(days?: number, options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).dailySessions(days, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Returns aggregate counts for clients, connections, and players in the system.
+     * @summary Get dashboard statistics
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public dashboardStats(options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).dashboardStats(options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * At-a-glance counts: players online now, new players today, DAU, 7-day mean/median session length, active bans/mutes, and open reports.
+     * @summary Dashboard overview tiles
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public overview(options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).overview(options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Daily punishment issuance over the window, split by type (BAN/MUTE/KICK/WARNING) — feeds the stacked chart.
+     * @summary Punishments by type over time
+     * @param {number} [days] Trailing window in days
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public punishmentsByType(days?: number, options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).punishmentsByType(days, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Open backlog, reports resolved in the window, mean resolution time, and a category breakdown.
+     * @summary Report backlog & resolution speed
+     * @param {number} [days] Trailing window in days
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public reportSummary(days?: number, options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).reportSummary(days, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Online server count and current player load per region/game-type.
+     * @summary Servers & players by region
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public serverRegions(options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).serverRegions(options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Moderators ranked by audit-log action count over the window.
+     * @summary Top moderators by activity
+     * @param {number} [days] Trailing window in days
+     * @param {number} [limit] Max moderators to return
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public topModerators(days?: number, limit?: number, options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).topModerators(days, limit, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Histogram of every player\'s latest trust factor, bucketed into ten 10-point bins.
+     * @summary Trust-factor distribution
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public trustDistribution(options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).trustDistribution(options).then((request) => request(this.axios, this.basePath));
+    }
+}
+
+
+
+/**
+ * AdminJobsApi - axios parameter creator
+ */
+export const AdminJobsApiAxiosParamCreator = function (configuration?: Configuration) {
+    return {
+        /**
+         * Flips cancel_requested on the row. The host instance sees this at its next progress tick and bails out, transitioning the row to CANCELLED. Already-terminal jobs (COMPLETED/FAILED/CANCELLED) return 404.
+         * @summary Request cancellation of an async job
+         * @param {string} id Job id
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        cancel: async (id: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'id' is not null or undefined
+            assertParamExists('cancel', 'id', id)
+            const localVarPath = `/admin/job/{id}`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // 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: 'DELETE', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Returns the CSV emitted by the job — typically one row per record the job touched. The first line is a header; subsequent lines are RFC-4180 escaped data rows. 404 when the job has no artifact (either it didn\'t emit one, or it hasn\'t finished yet).
+         * @summary Download a job\'s CSV artifact
+         * @param {string} id Job id
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        downloadArtifact: async (id: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'id' is not null or undefined
+            assertParamExists('downloadArtifact', 'id', id)
+            const localVarPath = `/admin/job/{id}/artifact.csv`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // 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: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Accept'] = 'text/csv';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * The polling target — the admin UI hits this every ~2 s while a job is running to update its progress bar.
+         * @summary Get one async job
+         * @param {string} id Job id
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        get: async (id: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'id' is not null or undefined
+            assertParamExists('get', 'id', id)
+            const localVarPath = `/admin/job/{id}`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // 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: 'GET', ...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,
+            };
+        },
+        /**
+         * Paginated, newest first. Filter by status to see only RUNNING jobs (the live queue) or COMPLETED / FAILED / CANCELLED history.
+         * @summary List async jobs
+         * @param {Pageable} pageable 
+         * @param {JobStatus | null} [status] Filter by status (omit for all states)
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        list: async (pageable: Pageable, status?: JobStatus | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('list', 'pageable', pageable)
+            const localVarPath = `/admin/job`;
+            // 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: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            if (status !== undefined) {
+                localVarQueryParameter['status'] = status;
+            }
+
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
+            }
+
+            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,
+            };
+        },
+    }
+};
+
+/**
+ * AdminJobsApi - functional programming interface
+ */
+export const AdminJobsApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = AdminJobsApiAxiosParamCreator(configuration)
     return {
         /**
          * Flips cancel_requested on the row. The host instance sees this at its next progress tick and bails out, transitioning the row to CANCELLED. Already-terminal jobs (COMPLETED/FAILED/CANCELLED) return 404.
@@ -6327,10 +7166,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);
@@ -6355,6 +7195,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 : {};
@@ -6366,12 +7210,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);
@@ -6388,6 +7233,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 : {};
@@ -6498,23 +7347,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);
@@ -6560,20 +7411,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.
@@ -6608,21 +7461,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));
     }
 
     /**