@rebornteam/reborn-api 4.9.1 → 4.9.3

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.1
+ * The version of the OpenAPI document: 4.9.3
  * 
  *
  * 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;
@@ -1329,6 +1519,15 @@ export interface CursoredPageable {
 }
 
 
+/**
+ * The Discord OAuth2 authorize URL, returned as JSON so a native client can open it directly (system browser → Discord-app universal-link hand-off) rather than following the backend\'s 302. Keeps client_id/scope server-side.
+ */
+export interface DiscordAuthUrlResponse {
+    /**
+     * Discord OAuth2 authorize URL to open on the client.
+     */
+    'authorizeUrl': string;
+}
 
 export const GameType = {
     Rotj: 'ROTJ',
@@ -3254,277 +3453,926 @@ export const AdminConnectionsApiFactory = function (configuration?: Configuratio
     const localVarFp = AdminConnectionsApiFp(configuration)
     return {
         /**
-         * Submits an async job that iterates every connection_check row missing both city and country and re-runs its source VPN service to populate location data. Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. The final {@code Admin_BackfillLocationResponse} (processed/succeeded/failed counts) lands in the job\'s {@code result_payload} on COMPLETED.
-         * @summary Start a location backfill job
+         * Submits an async job that iterates every connection_check row missing both city and country and re-runs its source VPN service to populate location data. Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. The final {@code Admin_BackfillLocationResponse} (processed/succeeded/failed counts) lands in the job\'s {@code result_payload} on COMPLETED.
+         * @summary Start a location backfill job
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        backfillLocation(options?: RawAxiosRequestConfig): AxiosPromise<AdminAsyncJobStartResponse> {
+            return localVarFp.backfillLocation(options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
+         * @summary Create connection bypass
+         * @param {CreateBypassRequest} createBypassRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        createBypass(createBypassRequest: CreateBypassRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminConnectionBypassResponse> {
+            return localVarFp.createBypass(createBypassRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Single connection by id, enriched with VPN check results and bypass status — same shape as the dashboard list row.
+         * @summary Get connection detail
+         * @param {number} id 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getConnection(id: number, options?: RawAxiosRequestConfig): AxiosPromise<AdminDashboardConnectionResponse> {
+            return localVarFp.getConnection(id, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Paginated list of every player ever seen on this connection, with punishment scoring inline. Suitable for an infinite-scroll panel inside the connection detail modal.
+         * @summary List players who have used this connection
+         * @param {number} id 
+         * @param {Pageable} pageable 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getConnectionPlayers(id: number, pageable: Pageable, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminPlayerSummary> {
+            return localVarFp.getConnectionPlayers(id, pageable, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Returns a paginated list of all connections with a total count. Supports filtering by IP address, UUID, and VPN status.
+         * @summary List all connections (paginated)
+         * @param {Pageable} pageable 
+         * @param {number | null} [createdAfter] 
+         * @param {number | null} [createdBefore] 
+         * @param {string | null} [ipAddress] 
+         * @param {string | null} [uuid] 
+         * @param {boolean | null} [isVpn] 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        listAllConnections(pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminDashboardConnectionResponse> {
+            return localVarFp.listAllConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Returns a list of recent connections with VPN detection status, bypass information, and associated player data. Optionally filter by epoch timestamp (seconds since Unix epoch).
+         * @summary List recent connections
+         * @param {Pageable} pageable 
+         * @param {number | null} [createdAfter] 
+         * @param {number | null} [createdBefore] 
+         * @param {string | null} [ipAddress] 
+         * @param {string | null} [uuid] 
+         * @param {boolean | null} [isVpn] 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        listConnections(pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardConnectionResponse>> {
+            return localVarFp.listConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
+         * @summary Refresh a single VPN check
+         * @param {number} connectionId 
+         * @param {string} service 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        recheckService(connectionId: number, service: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminConnectionCheckResult> {
+            return localVarFp.recheckService(connectionId, service, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+
+/**
+ * AdminConnectionsApi - object-oriented interface
+ */
+export class AdminConnectionsApi extends BaseAPI {
+    /**
+     * Submits an async job that iterates every connection_check row missing both city and country and re-runs its source VPN service to populate location data. Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. The final {@code Admin_BackfillLocationResponse} (processed/succeeded/failed counts) lands in the job\'s {@code result_payload} on COMPLETED.
+     * @summary Start a location backfill job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public backfillLocation(options?: RawAxiosRequestConfig) {
+        return AdminConnectionsApiFp(this.configuration).backfillLocation(options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
+     * @summary Create connection bypass
+     * @param {CreateBypassRequest} createBypassRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public createBypass(createBypassRequest: CreateBypassRequest, options?: RawAxiosRequestConfig) {
+        return AdminConnectionsApiFp(this.configuration).createBypass(createBypassRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Single connection by id, enriched with VPN check results and bypass status — same shape as the dashboard list row.
+     * @summary Get connection detail
+     * @param {number} id 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public getConnection(id: number, options?: RawAxiosRequestConfig) {
+        return AdminConnectionsApiFp(this.configuration).getConnection(id, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Paginated list of every player ever seen on this connection, with punishment scoring inline. Suitable for an infinite-scroll panel inside the connection detail modal.
+     * @summary List players who have used this connection
+     * @param {number} id 
+     * @param {Pageable} pageable 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public getConnectionPlayers(id: number, pageable: Pageable, options?: RawAxiosRequestConfig) {
+        return AdminConnectionsApiFp(this.configuration).getConnectionPlayers(id, pageable, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Returns a paginated list of all connections with a total count. Supports filtering by IP address, UUID, and VPN status.
+     * @summary List all connections (paginated)
+     * @param {Pageable} pageable 
+     * @param {number | null} [createdAfter] 
+     * @param {number | null} [createdBefore] 
+     * @param {string | null} [ipAddress] 
+     * @param {string | null} [uuid] 
+     * @param {boolean | null} [isVpn] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public listAllConnections(pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig) {
+        return AdminConnectionsApiFp(this.configuration).listAllConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Returns a list of recent connections with VPN detection status, bypass information, and associated player data. Optionally filter by epoch timestamp (seconds since Unix epoch).
+     * @summary List recent connections
+     * @param {Pageable} pageable 
+     * @param {number | null} [createdAfter] 
+     * @param {number | null} [createdBefore] 
+     * @param {string | null} [ipAddress] 
+     * @param {string | null} [uuid] 
+     * @param {boolean | null} [isVpn] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public listConnections(pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig) {
+        return AdminConnectionsApiFp(this.configuration).listConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
+     * @summary Refresh a single VPN check
+     * @param {number} connectionId 
+     * @param {string} service 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public recheckService(connectionId: number, service: string, options?: RawAxiosRequestConfig) {
+        return AdminConnectionsApiFp(this.configuration).recheckService(connectionId, service, options).then((request) => request(this.axios, this.basePath));
+    }
+}
+
+
+
+/**
+ * AdminDashboardApi - axios parameter creator
+ */
+export const AdminDashboardApiAxiosParamCreator = function (configuration?: 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: 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;
+            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,
+            };
+        },
+        /**
+         * 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: 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;
+            }
+
+            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,
+            };
+        },
+        /**
+         * 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: 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;
+            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,
+            };
+        },
+        /**
+         * Returns aggregate counts for clients, connections, and players in the system.
+         * @summary Get dashboard statistics
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        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;
+            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,
+            };
+        },
+        /**
+         * 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: 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;
+            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,
+            };
+        },
+        /**
+         * 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: 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;
+            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,
+            };
+        },
+        /**
+         * 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}
          */
-        backfillLocation(options?: RawAxiosRequestConfig): AxiosPromise<AdminAsyncJobStartResponse> {
-            return localVarFp.backfillLocation(options).then((request) => request(axios, basePath));
+        dashboardStats(options?: RawAxiosRequestConfig): AxiosPromise<AdminGetDashboardStats> {
+            return localVarFp.dashboardStats(options).then((request) => request(axios, basePath));
         },
         /**
-         * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
-         * @summary Create connection bypass
-         * @param {CreateBypassRequest} createBypassRequest 
+         * 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}
          */
-        createBypass(createBypassRequest: CreateBypassRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminConnectionBypassResponse> {
-            return localVarFp.createBypass(createBypassRequest, options).then((request) => request(axios, basePath));
+        overview(options?: RawAxiosRequestConfig): AxiosPromise<AdminDashboardOverview> {
+            return localVarFp.overview(options).then((request) => request(axios, basePath));
         },
         /**
-         * Single connection by id, enriched with VPN check results and bypass status — same shape as the dashboard list row.
-         * @summary Get connection detail
-         * @param {number} id 
+         * 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}
          */
-        getConnection(id: number, options?: RawAxiosRequestConfig): AxiosPromise<AdminDashboardConnectionResponse> {
-            return localVarFp.getConnection(id, options).then((request) => request(axios, basePath));
+        punishmentsByType(days?: number, options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardPunishmentDaily>> {
+            return localVarFp.punishmentsByType(days, options).then((request) => request(axios, basePath));
         },
         /**
-         * Paginated list of every player ever seen on this connection, with punishment scoring inline. Suitable for an infinite-scroll panel inside the connection detail modal.
-         * @summary List players who have used this connection
-         * @param {number} id 
-         * @param {Pageable} pageable 
+         * 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}
          */
-        getConnectionPlayers(id: number, pageable: Pageable, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminPlayerSummary> {
-            return localVarFp.getConnectionPlayers(id, pageable, options).then((request) => request(axios, basePath));
+        reportSummary(days?: number, options?: RawAxiosRequestConfig): AxiosPromise<AdminDashboardReportSummary> {
+            return localVarFp.reportSummary(days, options).then((request) => request(axios, basePath));
         },
         /**
-         * Returns a paginated list of all connections with a total count. Supports filtering by IP address, UUID, and VPN status.
-         * @summary List all connections (paginated)
-         * @param {Pageable} pageable 
-         * @param {number | null} [createdAfter] 
-         * @param {number | null} [createdBefore] 
-         * @param {string | null} [ipAddress] 
-         * @param {string | null} [uuid] 
-         * @param {boolean | null} [isVpn] 
+         * Online server count and current player load per region/game-type.
+         * @summary Servers & players by region
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        listAllConnections(pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminDashboardConnectionResponse> {
-            return localVarFp.listAllConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options).then((request) => request(axios, basePath));
+        serverRegions(options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardServerRegion>> {
+            return localVarFp.serverRegions(options).then((request) => request(axios, basePath));
         },
         /**
-         * Returns a list of recent connections with VPN detection status, bypass information, and associated player data. Optionally filter by epoch timestamp (seconds since Unix epoch).
-         * @summary List recent connections
-         * @param {Pageable} pageable 
-         * @param {number | null} [createdAfter] 
-         * @param {number | null} [createdBefore] 
-         * @param {string | null} [ipAddress] 
-         * @param {string | null} [uuid] 
-         * @param {boolean | null} [isVpn] 
+         * 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}
          */
-        listConnections(pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardConnectionResponse>> {
-            return localVarFp.listConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options).then((request) => request(axios, basePath));
+        topModerators(days?: number, limit?: number, options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardModeratorActivity>> {
+            return localVarFp.topModerators(days, limit, options).then((request) => request(axios, basePath));
         },
         /**
-         * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
-         * @summary Refresh a single VPN check
-         * @param {number} connectionId 
-         * @param {string} service 
+         * 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}
          */
-        recheckService(connectionId: number, service: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminConnectionCheckResult> {
-            return localVarFp.recheckService(connectionId, service, options).then((request) => request(axios, basePath));
+        trustDistribution(options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardTrustBucket>> {
+            return localVarFp.trustDistribution(options).then((request) => request(axios, basePath));
         },
     };
 };
 
 /**
- * AdminConnectionsApi - object-oriented interface
+ * AdminDashboardApi - object-oriented interface
  */
-export class AdminConnectionsApi extends BaseAPI {
+export class AdminDashboardApi extends BaseAPI {
     /**
-     * Submits an async job that iterates every connection_check row missing both city and country and re-runs its source VPN service to populate location data. Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. The final {@code Admin_BackfillLocationResponse} (processed/succeeded/failed counts) lands in the job\'s {@code result_payload} on COMPLETED.
-     * @summary Start a location backfill job
+     * 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 backfillLocation(options?: RawAxiosRequestConfig) {
-        return AdminConnectionsApiFp(this.configuration).backfillLocation(options).then((request) => request(this.axios, this.basePath));
+    public activityHeatmap(days?: number, options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).activityHeatmap(days, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
-     * @summary Create connection bypass
-     * @param {CreateBypassRequest} createBypassRequest 
+     * 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 createBypass(createBypassRequest: CreateBypassRequest, options?: RawAxiosRequestConfig) {
-        return AdminConnectionsApiFp(this.configuration).createBypass(createBypassRequest, options).then((request) => request(this.axios, this.basePath));
+    public connectionsByCountry(days?: number, limit?: number, options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).connectionsByCountry(days, limit, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * Single connection by id, enriched with VPN check results and bypass status — same shape as the dashboard list row.
-     * @summary Get connection detail
-     * @param {number} 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}
      */
-    public getConnection(id: number, options?: RawAxiosRequestConfig) {
-        return AdminConnectionsApiFp(this.configuration).getConnection(id, options).then((request) => request(this.axios, this.basePath));
+    public dailySessions(days?: number, options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).dailySessions(days, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * Paginated list of every player ever seen on this connection, with punishment scoring inline. Suitable for an infinite-scroll panel inside the connection detail modal.
-     * @summary List players who have used this connection
-     * @param {number} id 
-     * @param {Pageable} pageable 
+     * Returns aggregate counts for clients, connections, and players in the system.
+     * @summary Get dashboard statistics
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public getConnectionPlayers(id: number, pageable: Pageable, options?: RawAxiosRequestConfig) {
-        return AdminConnectionsApiFp(this.configuration).getConnectionPlayers(id, pageable, options).then((request) => request(this.axios, this.basePath));
+    public dashboardStats(options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).dashboardStats(options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * Returns a paginated list of all connections with a total count. Supports filtering by IP address, UUID, and VPN status.
-     * @summary List all connections (paginated)
-     * @param {Pageable} pageable 
-     * @param {number | null} [createdAfter] 
-     * @param {number | null} [createdBefore] 
-     * @param {string | null} [ipAddress] 
-     * @param {string | null} [uuid] 
-     * @param {boolean | null} [isVpn] 
+     * 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 listAllConnections(pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig) {
-        return AdminConnectionsApiFp(this.configuration).listAllConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options).then((request) => request(this.axios, this.basePath));
+    public overview(options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).overview(options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * Returns a list of recent connections with VPN detection status, bypass information, and associated player data. Optionally filter by epoch timestamp (seconds since Unix epoch).
-     * @summary List recent connections
-     * @param {Pageable} pageable 
-     * @param {number | null} [createdAfter] 
-     * @param {number | null} [createdBefore] 
-     * @param {string | null} [ipAddress] 
-     * @param {string | null} [uuid] 
-     * @param {boolean | null} [isVpn] 
+     * 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 listConnections(pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig) {
-        return AdminConnectionsApiFp(this.configuration).listConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options).then((request) => request(this.axios, this.basePath));
+    public punishmentsByType(days?: number, options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).punishmentsByType(days, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
-     * @summary Refresh a single VPN check
-     * @param {number} connectionId 
-     * @param {string} service 
+     * 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 recheckService(connectionId: number, service: string, options?: RawAxiosRequestConfig) {
-        return AdminConnectionsApiFp(this.configuration).recheckService(connectionId, service, options).then((request) => request(this.axios, this.basePath));
+    public reportSummary(days?: number, options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).reportSummary(days, options).then((request) => request(this.axios, this.basePath));
     }
-}
-
-
-
-/**
- * AdminDashboardApi - axios parameter creator
- */
-export const AdminDashboardApiAxiosParamCreator = function (configuration?: 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: 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;
-            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,
-            };
-        },
+    /**
+     * 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));
     }
-};
 
-/**
- * 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
-         * @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);
-        },
+    /**
+     * 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));
     }
-};
-
-/**
- * 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));
-        },
-    };
-};
 
-/**
- * AdminDashboardApi - object-oriented interface
- */
-export class AdminDashboardApi extends BaseAPI {
     /**
-     * Returns aggregate counts for clients, connections, and players in the system.
-     * @summary Get dashboard statistics
+     * 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 dashboardStats(options?: RawAxiosRequestConfig) {
-        return AdminDashboardApiFp(this.configuration).dashboardStats(options).then((request) => request(this.axios, this.basePath));
+    public trustDistribution(options?: RawAxiosRequestConfig) {
+        return AdminDashboardApiFp(this.configuration).trustDistribution(options).then((request) => request(this.axios, this.basePath));
     }
 }
 
@@ -6322,6 +7170,45 @@ export class AdminReportsApi extends BaseAPI {
  */
 export const AuthenticationApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
+        /**
+         * Returns the Discord OAuth2 authorize URL as JSON so a native app can open it directly (system browser → Discord-app universal-link hand-off) instead of following the 302. The `redirect` is validated against the allowlist and carried through Discord via `state`, exactly like the browser flow; the callback still bounces the JWT to that target. 
+         * @summary Discord - Authorize URL (native clients)
+         * @param {string | null} [redirect] Final redirect target for the JWT (native deep link). Must be allowlisted.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        authorizeUrl: async (redirect?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/auth/discord/url`;
+            // 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 (redirect !== undefined) {
+                localVarQueryParameter['redirect'] = redirect;
+            }
+
+            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,
+            };
+        },
         /**
          * Receives the authorization code from Discord after the user approves the OAuth2 prompt. Exchanges the code for an access token, verifies the user holds an admin guild role, then redirects back to the admin frontend with a signed JWT in the query string (`?token=...`). On failure, redirects with `?error=<reason>` instead. 
          * @summary Discord - OAuth2 callback
@@ -6503,6 +7390,19 @@ export const AuthenticationApiAxiosParamCreator = function (configuration?: Conf
 export const AuthenticationApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = AuthenticationApiAxiosParamCreator(configuration)
     return {
+        /**
+         * Returns the Discord OAuth2 authorize URL as JSON so a native app can open it directly (system browser → Discord-app universal-link hand-off) instead of following the 302. The `redirect` is validated against the allowlist and carried through Discord via `state`, exactly like the browser flow; the callback still bounces the JWT to that target. 
+         * @summary Discord - Authorize URL (native clients)
+         * @param {string | null} [redirect] Final redirect target for the JWT (native deep link). Must be allowlisted.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async authorizeUrl(redirect?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<DiscordAuthUrlResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.authorizeUrl(redirect, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AuthenticationApi.authorizeUrl']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
         /**
          * Receives the authorization code from Discord after the user approves the OAuth2 prompt. Exchanges the code for an access token, verifies the user holds an admin guild role, then redirects back to the admin frontend with a signed JWT in the query string (`?token=...`). On failure, redirects with `?error=<reason>` instead. 
          * @summary Discord - OAuth2 callback
@@ -6567,6 +7467,16 @@ export const AuthenticationApiFp = function(configuration?: Configuration) {
 export const AuthenticationApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
     const localVarFp = AuthenticationApiFp(configuration)
     return {
+        /**
+         * Returns the Discord OAuth2 authorize URL as JSON so a native app can open it directly (system browser → Discord-app universal-link hand-off) instead of following the 302. The `redirect` is validated against the allowlist and carried through Discord via `state`, exactly like the browser flow; the callback still bounces the JWT to that target. 
+         * @summary Discord - Authorize URL (native clients)
+         * @param {string | null} [redirect] Final redirect target for the JWT (native deep link). Must be allowlisted.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        authorizeUrl(redirect?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<DiscordAuthUrlResponse> {
+            return localVarFp.authorizeUrl(redirect, options).then((request) => request(axios, basePath));
+        },
         /**
          * Receives the authorization code from Discord after the user approves the OAuth2 prompt. Exchanges the code for an access token, verifies the user holds an admin guild role, then redirects back to the admin frontend with a signed JWT in the query string (`?token=...`). On failure, redirects with `?error=<reason>` instead. 
          * @summary Discord - OAuth2 callback
@@ -6617,6 +7527,17 @@ export const AuthenticationApiFactory = function (configuration?: Configuration,
  * AuthenticationApi - object-oriented interface
  */
 export class AuthenticationApi extends BaseAPI {
+    /**
+     * Returns the Discord OAuth2 authorize URL as JSON so a native app can open it directly (system browser → Discord-app universal-link hand-off) instead of following the 302. The `redirect` is validated against the allowlist and carried through Discord via `state`, exactly like the browser flow; the callback still bounces the JWT to that target. 
+     * @summary Discord - Authorize URL (native clients)
+     * @param {string | null} [redirect] Final redirect target for the JWT (native deep link). Must be allowlisted.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public authorizeUrl(redirect?: string | null, options?: RawAxiosRequestConfig) {
+        return AuthenticationApiFp(this.configuration).authorizeUrl(redirect, options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * Receives the authorization code from Discord after the user approves the OAuth2 prompt. Exchanges the code for an access token, verifies the user holds an admin guild role, then redirects back to the admin frontend with a signed JWT in the query string (`?token=...`). On failure, redirects with `?error=<reason>` instead. 
      * @summary Discord - OAuth2 callback