@rebornteam/reborn-api 4.9.1 → 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.1
+ * 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,60 +3666,704 @@ 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;
+            }
+
+            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;
+            }
 
-/**
- * AdminDashboardApi - factory interface
- */
-export const AdminDashboardApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
-    const localVarFp = AdminDashboardApiFp(configuration)
-    return {
+            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(options?: RawAxiosRequestConfig): AxiosPromise<AdminGetDashboardStats> {
-            return localVarFp.dashboardStats(options).then((request) => request(axios, basePath));
+        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;
+            }
 
-/**
- * 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));
+            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}
+         */
+        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));
     }
 }