@rebornteam/reborn-api 4.9.0 → 4.9.2

package/base.ts

@@ -4,7 +4,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication 
  *
- * The version of the OpenAPI document: 4.9.0
+ * The version of the OpenAPI document: 4.9.2
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/common.ts

@@ -4,7 +4,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication 
  *
- * The version of the OpenAPI document: 4.9.0
+ * The version of the OpenAPI document: 4.9.2
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/configuration.ts

@@ -3,7 +3,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication 
  *
- * The version of the OpenAPI document: 4.9.0
+ * The version of the OpenAPI document: 4.9.2
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/api.d.ts

@@ -2,7 +2,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 4.9.0
+ * The version of the OpenAPI document: 4.9.2
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -493,6 +493,36 @@ export interface AdminCreatePunishmentDraftRequest {
      */
     'forcePermanent': boolean;
 }
+/**
+ * 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;
@@ -516,6 +546,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;
@@ -2570,6 +2760,31 @@ export declare class AdminConnectionsApi extends BaseAPI {
  * AdminDashboardApi - axios parameter creator
  */
 export declare const AdminDashboardApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * 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) => Promise<RequestArgs>;
+    /**
+     * 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) => Promise<RequestArgs>;
+    /**
+     * 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) => Promise<RequestArgs>;
     /**
      * Returns aggregate counts for clients, connections, and players in the system.
      * @summary Get dashboard statistics
@@ -2577,11 +2792,82 @@ export declare const AdminDashboardApiAxiosParamCreator: (configuration?: Config
      * @throws {RequiredError}
      */
     dashboardStats: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 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) => Promise<RequestArgs>;
+    /**
+     * 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) => Promise<RequestArgs>;
+    /**
+     * 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) => Promise<RequestArgs>;
+    /**
+     * 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) => Promise<RequestArgs>;
+    /**
+     * 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) => Promise<RequestArgs>;
+    /**
+     * 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) => Promise<RequestArgs>;
 };
 /**
  * AdminDashboardApi - functional programming interface
  */
 export declare const AdminDashboardApiFp: (configuration?: Configuration) => {
+    /**
+     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardActivityCell>>>;
+    /**
+     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardCountryCount>>>;
+    /**
+     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardDailySessions>>>;
     /**
      * Returns aggregate counts for clients, connections, and players in the system.
      * @summary Get dashboard statistics
@@ -2589,11 +2875,82 @@ export declare const AdminDashboardApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     dashboardStats(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminGetDashboardStats>>;
+    /**
+     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminDashboardOverview>>;
+    /**
+     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardPunishmentDaily>>>;
+    /**
+     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminDashboardReportSummary>>;
+    /**
+     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardServerRegion>>>;
+    /**
+     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardModeratorActivity>>>;
+    /**
+     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardTrustBucket>>>;
 };
 /**
  * AdminDashboardApi - factory interface
  */
 export declare const AdminDashboardApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * 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>>;
+    /**
+     * 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>>;
+    /**
+     * 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>>;
     /**
      * Returns aggregate counts for clients, connections, and players in the system.
      * @summary Get dashboard statistics
@@ -2601,11 +2958,82 @@ export declare const AdminDashboardApiFactory: (configuration?: Configuration, b
      * @throws {RequiredError}
      */
     dashboardStats(options?: RawAxiosRequestConfig): AxiosPromise<AdminGetDashboardStats>;
+    /**
+     * 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>;
+    /**
+     * 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>>;
+    /**
+     * 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>;
+    /**
+     * 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>>;
+    /**
+     * 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>>;
+    /**
+     * 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>>;
 };
 /**
  * AdminDashboardApi - object-oriented interface
  */
 export declare 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}
+     */
+    activityHeatmap(days?: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminDashboardActivityCell[], any, {}>>;
+    /**
+     * 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): Promise<import("axios").AxiosResponse<AdminDashboardCountryCount[], any, {}>>;
+    /**
+     * 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): Promise<import("axios").AxiosResponse<AdminDashboardDailySessions[], any, {}>>;
     /**
      * Returns aggregate counts for clients, connections, and players in the system.
      * @summary Get dashboard statistics
@@ -2613,6 +3041,52 @@ export declare class AdminDashboardApi extends BaseAPI {
      * @throws {RequiredError}
      */
     dashboardStats(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminGetDashboardStats, any, {}>>;
+    /**
+     * 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): Promise<import("axios").AxiosResponse<AdminDashboardOverview, any, {}>>;
+    /**
+     * 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): Promise<import("axios").AxiosResponse<AdminDashboardPunishmentDaily[], any, {}>>;
+    /**
+     * 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): Promise<import("axios").AxiosResponse<AdminDashboardReportSummary, any, {}>>;
+    /**
+     * 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): Promise<import("axios").AxiosResponse<AdminDashboardServerRegion[], any, {}>>;
+    /**
+     * 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): Promise<import("axios").AxiosResponse<AdminDashboardModeratorActivity[], any, {}>>;
+    /**
+     * 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): Promise<import("axios").AxiosResponse<AdminDashboardTrustBucket[], any, {}>>;
 }
 /**
  * AdminJobsApi - axios parameter creator
@@ -3883,17 +4357,19 @@ export declare const AuthenticationApiAxiosParamCreator: (configuration?: Config
      * @summary Discord - OAuth2 callback
      * @param {string | null} [code] Authorization code provided by Discord on successful approval
      * @param {string | null} [error] Error code provided by Discord if the user denied access
+     * @param {string | null} [state] Opaque value echoed back by Discord — carries the client\&#39;s chosen redirect target
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    callback: (code?: string | null, error?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    callback: (code?: string | null, error?: string | null, state?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+     * Redirects the browser (or native in-app browser session) to Discord\'s OAuth2 authorization page. The optional `redirect` parameter names the final destination the signed JWT should be sent to once auth completes — the web app URL (default) or a native deep-link scheme such as `reborn://auth/callback`. It must be allowlisted (DISCORD_ADMIN_FRONTEND_URL or one of DISCORD_ADMIN_ALLOWED_REDIRECTS); the value is carried through Discord via the OAuth `state` parameter and re-validated on the callback.
      * @summary Discord - Initiate login
+     * @param {string | null} [redirect] Final redirect target for the JWT (web URL or native deep link). Must be allowlisted. Defaults to the web admin frontend.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    initiateLogin: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    initiateLogin: (redirect?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Returns the authenticated user\'s profile from their JWT claims. The session is already validated by the security rule before this endpoint is reached.
      * @summary Get current user profile
@@ -3921,17 +4397,19 @@ export declare const AuthenticationApiFp: (configuration?: Configuration) => {
      * @summary Discord - OAuth2 callback
      * @param {string | null} [code] Authorization code provided by Discord on successful approval
      * @param {string | null} [error] Error code provided by Discord if the user denied access
+     * @param {string | null} [state] Opaque value echoed back by Discord — carries the client\&#39;s chosen redirect target
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    callback(code?: string | null, error?: string | null, state?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
     /**
-     * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+     * Redirects the browser (or native in-app browser session) to Discord\'s OAuth2 authorization page. The optional `redirect` parameter names the final destination the signed JWT should be sent to once auth completes — the web app URL (default) or a native deep-link scheme such as `reborn://auth/callback`. It must be allowlisted (DISCORD_ADMIN_FRONTEND_URL or one of DISCORD_ADMIN_ALLOWED_REDIRECTS); the value is carried through Discord via the OAuth `state` parameter and re-validated on the callback.
      * @summary Discord - Initiate login
+     * @param {string | null} [redirect] Final redirect target for the JWT (web URL or native deep link). Must be allowlisted. Defaults to the web admin frontend.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    initiateLogin(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    initiateLogin(redirect?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
     /**
      * Returns the authenticated user\'s profile from their JWT claims. The session is already validated by the security rule before this endpoint is reached.
      * @summary Get current user profile
@@ -3959,17 +4437,19 @@ export declare const AuthenticationApiFactory: (configuration?: Configuration, b
      * @summary Discord - OAuth2 callback
      * @param {string | null} [code] Authorization code provided by Discord on successful approval
      * @param {string | null} [error] Error code provided by Discord if the user denied access
+     * @param {string | null} [state] Opaque value echoed back by Discord — carries the client\&#39;s chosen redirect target
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    callback(code?: string | null, error?: string | null, state?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<void>;
     /**
-     * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+     * Redirects the browser (or native in-app browser session) to Discord\'s OAuth2 authorization page. The optional `redirect` parameter names the final destination the signed JWT should be sent to once auth completes — the web app URL (default) or a native deep-link scheme such as `reborn://auth/callback`. It must be allowlisted (DISCORD_ADMIN_FRONTEND_URL or one of DISCORD_ADMIN_ALLOWED_REDIRECTS); the value is carried through Discord via the OAuth `state` parameter and re-validated on the callback.
      * @summary Discord - Initiate login
+     * @param {string | null} [redirect] Final redirect target for the JWT (web URL or native deep link). Must be allowlisted. Defaults to the web admin frontend.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    initiateLogin(options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    initiateLogin(redirect?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<void>;
     /**
      * Returns the authenticated user\'s profile from their JWT claims. The session is already validated by the security rule before this endpoint is reached.
      * @summary Get current user profile
@@ -3997,17 +4477,19 @@ export declare class AuthenticationApi extends BaseAPI {
      * @summary Discord - OAuth2 callback
      * @param {string | null} [code] Authorization code provided by Discord on successful approval
      * @param {string | null} [error] Error code provided by Discord if the user denied access
+     * @param {string | null} [state] Opaque value echoed back by Discord — carries the client\&#39;s chosen redirect target
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    callback(code?: string | null, error?: string | null, state?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
     /**
-     * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+     * Redirects the browser (or native in-app browser session) to Discord\'s OAuth2 authorization page. The optional `redirect` parameter names the final destination the signed JWT should be sent to once auth completes — the web app URL (default) or a native deep-link scheme such as `reborn://auth/callback`. It must be allowlisted (DISCORD_ADMIN_FRONTEND_URL or one of DISCORD_ADMIN_ALLOWED_REDIRECTS); the value is carried through Discord via the OAuth `state` parameter and re-validated on the callback.
      * @summary Discord - Initiate login
+     * @param {string | null} [redirect] Final redirect target for the JWT (web URL or native deep link). Must be allowlisted. Defaults to the web admin frontend.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    initiateLogin(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    initiateLogin(redirect?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
     /**
      * Returns the authenticated user\'s profile from their JWT claims. The session is already validated by the security rule before this endpoint is reached.
      * @summary Get current user profile