@rebornteam/reborn-api 3.2.1 → 4.5.0

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: 3.2.1
+ * The version of the OpenAPI document: 4.5.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -13,6 +13,119 @@ import type { Configuration } from './configuration';
 import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
 import type { RequestArgs } from './base';
 import { BaseAPI } from './base';
+/**
+ * Another player who has been seen on at least one of this player\'s historical connections — i.e. an alt account candidate.
+ */
+export interface AdminAltAccount {
+    /**
+     * Alt player\'s Minecraft UUID
+     */
+    'uuid': string;
+    /**
+     * Most recently seen username for the alt, null if never recorded
+     */
+    'username'?: string | null;
+    /**
+     * Timestamp of the alt\'s most recent connection (ISO-8601), null if never connected
+     */
+    'lastUsedAt'?: string | null;
+    /**
+     * Number of distinct connections this alt shares with the source player
+     */
+    'sharedConnectionCount': number;
+}
+/**
+ * Per-pair exemption from aggressive-mode alt propagation. When a row exists with (player_id=X, alt_player_id=Y), propagation for X will skip Y as an alt source.
+ */
+export interface AdminAltExemption {
+    /**
+     * Player this exemption applies to
+     */
+    'playerUuid': string;
+    /**
+     * Player to be skipped as an alt source
+     */
+    'altPlayerUuid': string;
+    /**
+     * Most recent username of the exempted alt
+     */
+    'altPlayerUsername'?: string | null;
+    /**
+     * Staff member who created the exemption
+     */
+    'createdBy': string;
+    /**
+     * When the exemption was created (ISO-8601)
+     */
+    'createdAt': string;
+    /**
+     * Optional human-readable reason
+     */
+    'reason'?: string | null;
+}
+/**
+ * Alt-graph rooted at a player, walked out to the requested hop depth.
+ */
+export interface AdminAltGraph {
+    /**
+     * UUID of the focal player. Always appears in nodes at depth=0.
+     */
+    'rootUuid': string;
+    /**
+     * Maximum hop depth walked. Capped server-side at MAX_PROPAGATION_DEPTH.
+     */
+    'depth': number;
+    /**
+     * Every player reachable from the root within {@code depth} hops, including the root at depth=0.
+     */
+    'nodes': Array<AdminAltGraphNode>;
+    /**
+     * Undirected edges between any two players in nodes that share at least one non-promiscuous connection.
+     */
+    'edges': Array<AdminAltGraphEdge>;
+}
+/**
+ * Undirected edge in an alt-graph traversal.
+ */
+export interface AdminAltGraphEdge {
+    /**
+     * One endpoint of the edge
+     */
+    'fromUuid': string;
+    /**
+     * Other endpoint of the edge. The pair is emitted only once — the SQL ensures fromUuid < toUuid lexicographically.
+     */
+    'toUuid': string;
+    /**
+     * Number of distinct non-promiscuous connections these two players share. Drives edge thickness.
+     */
+    'sharedConnectionCount': number;
+}
+/**
+ * One player node in an alt-graph traversal.
+ */
+export interface AdminAltGraphNode {
+    /**
+     * Player Minecraft UUID
+     */
+    'uuid': string;
+    /**
+     * Most recently seen username, null if never resolved
+     */
+    'username'?: string | null;
+    /**
+     * Hop count from the focal player (0 = the focal player herself).
+     */
+    'depth': number;
+    /**
+     * Trust factor (0-100). Drives the node colour in the graph.
+     */
+    'trustFactor': number;
+    /**
+     * Whether this player currently has at least one active (non-revoked, non-expired) player_punishment row. Drives a red outline ring on the node.
+     */
+    'hasActivePunishment': boolean;
+}
 /**
  * Request to apply a punishment to one or more targets
  */
@@ -72,15 +185,15 @@ export interface AdminApplyPunishmentResult {
      */
     'type': PunishmentType;
     /**
-     * Severity level applied
+     * Severity level applied (1-4)
      */
     'severity': number;
     /**
-     * Updated punishment score after applying
+     * Trust factor (0-100) for the targeted player after the punishment landed. Present only when the target is a player; absent for any other target shape.
      */
-    'newScore': number;
+    'newTrustFactor'?: number | null;
     /**
-     * Whether the punishment was made permanent
+     * Whether the punishment was made permanent. Mirrors the request\'s forcePermanent flag — auto-escalation has been removed.
      */
     'isPermanent': boolean;
     /**
@@ -89,21 +202,150 @@ export interface AdminApplyPunishmentResult {
     'expiresAt'?: string | null;
 }
 /**
- * Result of a location backfill run — rechecks every connection_check row missing both city and country, repopulating them from the VPN providers.
+ * One row of admin_job — a long-running admin operation.
+ */
+export interface AdminAsyncJob {
+    /**
+     * Job id
+     */
+    'id': string;
+    /**
+     * Stable identifier of what kind of work this is (e.g. LOCATION_BACKFILL)
+     */
+    'jobType': string;
+    /**
+     * Current lifecycle state.
+     */
+    'status': JobStatus;
+    /**
+     * Number of units processed so far
+     */
+    'progressCurrent': number;
+    /**
+     * Total units, when known up front. Null when total is undetermined.
+     */
+    'progressTotal'?: number | null;
+    /**
+     * Optional human-readable status line (e.g. \"Re-checking IpHub\").
+     */
+    'progressMessage'?: string | null;
+    /**
+     * Error message when status = FAILED. Null otherwise.
+     */
+    'errorMessage'?: string | null;
+    /**
+     * Type-specific JSON result, populated when status = COMPLETED. Schema varies by jobType — consult the docs for each type.
+     */
+    'resultPayload'?: object | null;
+    /**
+     * Admin who submitted the job (Discord username for SSO admins).
+     */
+    'startedBy': string;
+    /**
+     * When the job was submitted (ISO-8601).
+     */
+    'startedAt': string;
+    /**
+     * Timestamp of the most recent progress update. The reaper marks jobs FAILED when this falls behind by 5 min.
+     */
+    'lastProgressAt': string;
+    /**
+     * When the job entered a terminal state. Null while running.
+     */
+    'finishedAt'?: string | null;
+    /**
+     * True if an admin has requested cancellation. The host instance picks this up at its next progress tick.
+     */
+    'cancelRequested': boolean;
+    /**
+     * Identifier of the API instance that is running this job. Other instances can see state and request cancellation but cannot dispose the in-flight Reactor subscription directly.
+     */
+    'hostInstance': string;
+    /**
+     * Pointer to a CSV artifact emitted by this job, when one exists. Present only after the job marks COMPLETED and the artifact has been persisted. Download the CSV bytes via GET /admin/job/{id}/artifact.csv.
+     */
+    'artifact'?: AdminAsyncJobArtifactMeta | null;
+}
+/**
+ * Pointer to a job\'s CSV artifact. Present only when the job emitted one.
+ */
+export interface AdminAsyncJobArtifactMeta {
+    /**
+     * Number of data rows in the artifact (excluding the header).
+     */
+    'rowCount': number;
+    /**
+     * When the artifact was finalized (typically a few seconds after the job marked COMPLETED).
+     */
+    'createdAt': string;
+}
+/**
+ * Acknowledgement returned by endpoints that submit an async job. The id is the polling target — GET /admin/job/{id} for status, DELETE /admin/job/{id} to cancel.
+ */
+export interface AdminAsyncJobStartResponse {
+    /**
+     * Server-assigned job id
+     */
+    'jobId': string;
+}
+/**
+ * Single admin audit-log entry. Captures who did what to which target with an action-specific JSON payload (e.g. before/after for edits, count for bulk ops).
+ */
+export interface AdminAuditLogEntry {
+    /**
+     * Sequential id (ordering matches createdAt)
+     */
+    'id': number;
+    /**
+     * Discord username of the moderator who performed the action
+     */
+    'actorUsername': string;
+    /**
+     * Action verb. Open-vocabulary; current values include APPLY_PUNISHMENT, EDIT_PUNISHMENT, REVOKE_PROPAGATED_LINK, BULK_REVOKE, SET_AGGRESSIVE_MODE_IMMUNITY, ADD_ALT_EXEMPTION, REMOVE_ALT_EXEMPTION.
+     */
+    'action': string;
+    /**
+     * Type of entity acted upon (PLAYER, PUNISHMENT, PLAYER_PUNISHMENT, etc.)
+     */
+    'targetType': string;
+    /**
+     * Identifier of the target (stringified id or UUID, depending on targetType)
+     */
+    'targetId': string;
+    /**
+     * Action-specific JSON payload. Shape depends on the action.
+     */
+    'payload'?: string | null;
+    /**
+     * When the action occurred (ISO-8601)
+     */
+    'createdAt': string;
+}
+/**
+ * Bulk-revoke every active PROPAGATED player_punishment row sourced from a single alt or connection. Used when staff identify a false-positive source (e.g. a shared NAT or legitimate roommate) and want to undo every link it caused.
  */
-export interface AdminBackfillLocationResponse {
+export interface AdminBulkRevokeRequest {
+    /**
+     * Revoke links whose source_player_id matches. Mutually exclusive with sourceConnectionId.
+     */
+    'sourcePlayerId'?: number | null;
     /**
-     * Total checks attempted
+     * Revoke links whose source_connection_id matches. Mutually exclusive with sourcePlayerId.
      */
-    'processed': number;
+    'sourceConnectionId'?: number | null;
     /**
-     * Checks where the provider returned at least a city or country
+     * Optional reason for the audit log
      */
-    'succeeded': number;
+    'reason'?: string | null;
+}
+/**
+ * Result of a bulk-revoke operation
+ */
+export interface AdminBulkRevokeResponse {
     /**
-     * Checks that errored or returned no location data
+     * Number of player_punishment rows soft-deleted by the operation
      */
-    'failed': number;
+    'revoked': number;
 }
 /**
  * Client credential response
@@ -187,6 +429,36 @@ export interface AdminConnectionCheckResult {
      * Country code reported by this service, if available
      */
     'country'?: string | null;
+    /**
+     * Latitude reported by this service, if available
+     */
+    'latitude'?: number | null;
+    /**
+     * Longitude reported by this service, if available
+     */
+    'longitude'?: number | null;
+}
+/**
+ * Add an alt exemption: mark altPlayerUuid as a known-legitimate associate of the path player. Subsequent aggressive-mode propagation skips this pair as an alt source.
+ */
+export interface AdminCreateAltExemptionRequest {
+    /**
+     * UUID of the player to mark as a known-legitimate associate
+     */
+    'altPlayerUuid': string;
+    /**
+     * Optional human-readable reason (e.g. \'roommates, verified via support ticket #1234\')
+     */
+    'reason'?: string | null;
+}
+/**
+ * Create a staff note on a player
+ */
+export interface AdminCreatePlayerNoteRequest {
+    /**
+     * Note body (1–4000 chars)
+     */
+    'body': string;
 }
 /**
  * Request to evaluate the impact of a punishment across one or more targets before applying
@@ -220,7 +492,14 @@ export interface AdminCreatePunishmentDraftRequest {
 export interface AdminDashboardConnectionResponse {
     'id': number;
     'ipAddress': string;
-    'location'?: string | null;
+    /**
+     * City reported by the first VPN provider that returned one for this IP.
+     */
+    'city'?: string | null;
+    /**
+     * Country code (ISO 3166-1 alpha-2 or alpha-3 depending on provider) from the first provider that returned one.
+     */
+    'country'?: string | null;
     'isVpn': boolean;
     'isBypassed': boolean;
     'bypassExpiresAt'?: string | null;
@@ -252,120 +531,188 @@ export interface AdminIpSearchResult {
     'players': Array<AdminPlayerSearchResult>;
 }
 /**
- * Paginated connection list response
+ * Full player detail including punishment history and all known usernames
  */
-export interface AdminPagedConnectionResponse {
+export interface AdminPlayerDetailResponse {
     /**
-     * Connections on the current page
+     * Internal player ID
      */
-    'data': Array<AdminDashboardConnectionResponse>;
+    'id': number;
     /**
-     * Total number of connections matching the filters
+     * Player Minecraft UUID
      */
-    'total': number;
+    'uuid': string;
     /**
-     * Current page (1-indexed)
+     * Most recently seen username
      */
-    'page': number;
+    'username'?: string | null;
     /**
-     * Page size
+     * Whether this player still has first-join status
      */
-    'limit': number;
+    'firstJoin': boolean;
     /**
-     * Total number of pages
+     * Timestamp of first connection (ISO-8601)
      */
-    'totalPages': number;
+    'firstLogin': string;
+    /**
+     * Timestamp of most recent connection (ISO-8601)
+     */
+    'lastUsedAt'?: string | null;
+    /**
+     * Trust factor (0-100, higher = more trusted). Informational only — does NOT auto-escalate punishments. See compute_trust_factor in the database for the formula.
+     */
+    'trustFactor': number;
+    /**
+     * All usernames this player has used, newest first
+     */
+    'usernameHistory': Array<AdminUsernameHistoryEntry>;
+    /**
+     * True when this player is exempt from aggressive-mode propagation. Toggling on also bulk-revokes existing propagated links. Defaults to false.
+     */
+    'aggressiveModeImmunity': boolean;
 }
 /**
- * Paginated player list response
+ * Free-form staff note about a player
  */
-export interface AdminPagedPlayerResponse {
+export interface AdminPlayerNote {
+    /**
+     * Note id
+     */
+    'id': number;
     /**
-     * Players on the current page
+     * Username (Discord username for SSO admins) of the staff member who wrote the note
      */
-    'data': Array<AdminPlayerSummary>;
+    'author': string;
     /**
-     * Total number of players matching the search filter
+     * The note body (1–4000 characters)
      */
-    'total': number;
+    'body': string;
     /**
-     * Current page (1-indexed)
+     * When the note was created (ISO-8601)
      */
-    'page': number;
+    'createdAt': string;
     /**
-     * Page size
+     * When the note was soft-deleted. Null on active notes. Deleted notes are still returned by default; the UI styles them as struck-through.
      */
-    'limit': number;
+    'deletedAt'?: string | null;
     /**
-     * Total number of pages
+     * Staff member who soft-deleted the note. Null on active notes.
      */
-    'totalPages': number;
+    'deletedBy'?: string | null;
 }
 /**
- * Paginated punishment list response
+ * A single player_punishment link with full audit metadata. Used by admin UIs to render the player\'s punishment history with DIRECT vs PROPAGATED badges and per-link revoke controls.
  */
-export interface AdminPagedPunishmentResponse {
+export interface AdminPlayerPunishmentResponse {
     /**
-     * Punishments on the current page
+     * player_punishment row id (the link id, NOT the punishment id)
      */
-    'data': Array<AdminPunishmentListItem>;
+    'id': number;
     /**
-     * Total number of punishments matching the filters
+     * Source punishment id this link points to
      */
-    'total': number;
+    'punishmentId': number;
     /**
-     * Current page (1-indexed)
+     * UUID of the player this link is attached to
      */
-    'page': number;
+    'playerUuid': string;
     /**
-     * Page size
+     * Punishment type
      */
-    'limit': number;
+    'type': PunishmentType;
     /**
-     * Total number of pages
+     * Severity (1-4)
      */
-    'totalPages': number;
+    'severity': number;
+    /**
+     * Reason from the source punishment record
+     */
+    'reason': string;
+    /**
+     * Internal admin notes from the source punishment (may be null)
+     */
+    'notes'?: string | null;
+    /**
+     * Original issuer of the punishment
+     */
+    'createdBy': string;
+    /**
+     * When the source punishment was created (ISO-8601)
+     */
+    'createdAt': string;
+    /**
+     * Source punishment expiration (null = permanent)
+     */
+    'expiresAt'?: string | null;
+    /**
+     * How this link came to exist. DIRECT links are immutable from the link side (remove via the punishment-level delete); PROPAGATED links are revocable individually.
+     */
+    'source': PunishmentSource;
+    /**
+     * Human-readable origin for a PROPAGATED link, e.g. \'Propagated from alt Notch (player_id=42)\' or \'Propagated from connection 1.2.3.4\'. Null for DIRECT links.
+     */
+    'transferNote'?: string | null;
+    /**
+     * player.id that triggered this PROPAGATED link (the alt account). Null for DIRECT links, for PROPAGATED links pre-dating the structured-source migration, and for connection-sourced PROPAGATED links.
+     */
+    'sourcePlayerId'?: number | null;
+    /**
+     * connection.id that triggered this PROPAGATED link (the IP). Null for DIRECT links, for PROPAGATED links pre-dating the structured-source migration, and for player-sourced PROPAGATED links.
+     */
+    'sourceConnectionId'?: number | null;
+    /**
+     * When this link was revoked by a staff member. Null while active.
+     */
+    'revokedAt'?: string | null;
+    /**
+     * Staff member who revoked this link.
+     */
+    'revokedBy'?: string | null;
 }
 /**
- * Full player detail including punishment history and all known usernames
+ * One peer report. May target one or more players.
  */
-export interface AdminPlayerDetailResponse {
+export interface AdminPlayerReport {
     /**
-     * Internal player ID
+     * Report id
      */
     'id': number;
     /**
-     * Player Minecraft UUID
+     * Reporter\'s UUID
      */
-    'uuid': string;
+    'reporterUuid': string;
     /**
-     * Most recently seen username
+     * Reporter\'s username at the time of the report (last-known if changed)
      */
-    'username'?: string | null;
+    'reporterUsername'?: string | null;
     /**
-     * Whether this player still has first-join status
+     * All players this report flags. At least one entry.
      */
-    'firstJoin': boolean;
+    'reportedTargets': Array<AdminReportTarget>;
     /**
-     * Timestamp of first connection (ISO-8601)
+     * Category
      */
-    'firstLogin': string;
+    'category': string;
     /**
-     * Timestamp of most recent connection (ISO-8601)
+     * Reason text
      */
-    'lastUsedAt'?: string | null;
+    'reason': string;
     /**
-     * Raw punishment score
+     * When created (ISO-8601)
      */
-    'punishmentPointsRaw': number;
+    'createdAt': string;
     /**
-     * Punishment score as a percentage
+     * When resolved by staff. Null = open.
      */
-    'punishmentPointsPercent': number;
+    'resolvedAt'?: string | null;
     /**
-     * All usernames this player has used, newest first
+     * Staff member who resolved it
      */
-    'usernameHistory': Array<AdminUsernameHistoryEntry>;
+    'resolvedBy'?: string | null;
+    /**
+     * Staff\'s resolution note
+     */
+    'resolutionNote'?: string | null;
 }
 /**
  * Lightweight player reference used in search results and punishment evaluations
@@ -381,21 +728,75 @@ export interface AdminPlayerSearchResult {
     'username'?: string | null;
 }
 /**
- * Summary of a player record, used in list views
+ * A single player session — one visit by one player to one game server. Active sessions have null endedAt and durationSeconds; closed sessions have both populated.
  */
-export interface AdminPlayerSummary {
+export interface AdminPlayerSession {
     /**
-     * Internal player ID
+     * Session id (UUID)
      */
-    'id': number;
+    'id': string;
     /**
      * Player Minecraft UUID
      */
-    'uuid': string;
+    'playerUuid': string;
     /**
-     * Most recently seen username, null if never recorded
+     * Game server session id this session is associated with. Nullable when the server record has been deleted.
      */
-    'username'?: string | null;
+    'serverSessionId'?: string | null;
+    /**
+     * When the player joined (ISO-8601)
+     */
+    'startedAt': string;
+    /**
+     * When the player disconnected (ISO-8601). Null while the session is still active.
+     */
+    'endedAt'?: string | null;
+    /**
+     * Closed session duration in seconds (ended_at − started_at). Null while active.
+     */
+    'durationSeconds'?: number | null;
+}
+/**
+ * Aggregate session statistics for one player. Computed on demand from player_session.
+ */
+export interface AdminPlayerSessionStats {
+    /**
+     * Sum of duration_seconds across all closed sessions
+     */
+    'totalSecondsPlayed': number;
+    /**
+     * Total number of session rows for this player (active + closed)
+     */
+    'sessionCount': number;
+    /**
+     * Distinct calendar days (UTC) on which this player had at least one session
+     */
+    'distinctDaysActive': number;
+    /**
+     * Most recent session start time (ISO-8601). Null if the player has never connected.
+     */
+    'lastStartedAt'?: string | null;
+    /**
+     * True when the player has at least one currently-active (ended_at IS NULL) session.
+     */
+    'currentlyOnline': boolean;
+}
+/**
+ * Summary of a player record, used in list views
+ */
+export interface AdminPlayerSummary {
+    /**
+     * Internal player ID
+     */
+    'id': number;
+    /**
+     * Player Minecraft UUID
+     */
+    'uuid': string;
+    /**
+     * Most recently seen username, null if never recorded
+     */
+    'username'?: string | null;
     /**
      * Whether this player still has first-join status
      */
@@ -409,13 +810,9 @@ export interface AdminPlayerSummary {
      */
     'lastUsedAt'?: string | null;
     /**
-     * Raw punishment score (sum of weighted punishment values)
-     */
-    'punishmentPointsRaw': number;
-    /**
-     * Punishment score as a percentage. Values above 100 indicate future punishments should be permanent.
+     * Trust factor (0-100, higher = more trusted). Informational only — does NOT auto-escalate punishments. See compute_trust_factor in the database for the formula.
      */
-    'punishmentPointsPercent': number;
+    'trustFactor': number;
 }
 /**
  * Batch punishment draft — one evaluation per target
@@ -439,19 +836,11 @@ export interface AdminPunishmentEvaluation {
      */
     'affectedPlayers': Array<AdminPlayerSearchResult>;
     /**
-     * Current punishment score before applying this punishment (0–100+)
-     */
-    'currentScore': number;
-    /**
-     * Points this punishment would add to the score
-     */
-    'pointsToAdd': number;
-    /**
-     * Projected score after applying this punishment
+     * Trust factor preview for the targeted player. Present only when the target is a player; absent for any other target shape.
      */
-    'newScore': number;
+    'trustFactorImpact'?: AdminTrustFactorImpact | null;
     /**
-     * Whether this punishment would be permanent based on the current score threshold
+     * Whether this punishment will be permanent. Mirrors the request\'s forcePermanent flag — auto-escalation has been removed.
      */
     'willBePermanent': boolean;
     /**
@@ -467,7 +856,7 @@ export interface AdminPunishmentEvaluation {
      */
     'isConnectionTarget': boolean;
     /**
-     * The effective punishment type that will be applied — may differ from the requested type if escalated to BAN at threshold
+     * The punishment type that will be applied. Equal to the requested type — auto-escalation has been removed.
      */
     'effectiveType': PunishmentType;
 }
@@ -515,6 +904,202 @@ export interface AdminPunishmentTarget {
      */
     'ipAddress'?: string | null;
 }
+/**
+ * Active DIRECT participants currently attached to a punishment.
+ */
+export interface AdminPunishmentTargets {
+    /**
+     * UUIDs of players with an active DIRECT player_punishment link to this punishment.
+     */
+    'playerUuids': Array<string>;
+    /**
+     * IPs of connections with a live connection_punishment row for this punishment.
+     */
+    'ipAddresses': Array<string>;
+}
+/**
+ * One reported player attached to a report.
+ */
+export interface AdminReportTarget {
+    /**
+     * Target player\'s UUID
+     */
+    'uuid': string;
+    /**
+     * Target player\'s last-known username
+     */
+    'username'?: string | null;
+}
+/**
+ * Resolve a player report. Sets resolved_at = NOW() and stores the staff note.
+ */
+export interface AdminResolveReportRequest {
+    /**
+     * Free-form resolution note from staff (e.g. \"Watched 10 min footage, no cheating evident.\")
+     */
+    'resolutionNote'?: string | null;
+}
+/**
+ * Set whether a player is exempt from aggressive-mode punishment propagation. Toggling on also revokes all currently-active propagated links for the player.
+ */
+export interface AdminSetAggressiveModeImmunityRequest {
+    /**
+     * True to mark the player immune (no future propagation; existing propagated links bulk-revoked). False to re-enable propagation.
+     */
+    'immune': boolean;
+}
+/**
+ * Detailed breakdown of how a player\'s trust factor was computed. The final score is the same value returned by compute_trust_factor — this DTO carries the subtotals (bonuses, penalties) and the underlying signal counts that drove each subtotal. Powers the \"why is this score 65?\" admin tooltip. Informational only; trust factor does not auto-escalate punishments.
+ */
+export interface AdminTrustFactorBreakdown {
+    /**
+     * Starting score before any signals applied. Constant 75.
+     */
+    'baseTrust': number;
+    /**
+     * Bonus from account age (+1 per 30 days, capped at +15)
+     */
+    'ageBonus': number;
+    /**
+     * Bonus from clean history. +10 if no active punishments; otherwise +1 per 60 days since the most recent one. Capped at +10.
+     */
+    'cleanHistoryBonus': number;
+    /**
+     * Bonus from connection stability. Stair-step on distinct-connection count: ≤1=+5, ≤3=+3, ≤8=+1, else 0.
+     */
+    'stabilityBonus': number;
+    /**
+     * Bonus from admin affirmation. alt-exemptions × 2 + active player-bypass × 4, capped at +10.
+     */
+    'adminAffirmationBonus': number;
+    /**
+     * Penalty from active punishments. Type-weighted, severity-scaled, time-decayed (BAN half-life 730d, MUTE 180d, WARNING 60d). Capped at -40.
+     */
+    'punishmentPenalty': number;
+    /**
+     * Penalty from alts. dirty-alts × 4 + clean-alts × 0.5, after promiscuity/alt caps, excluding alt-exempted players. Capped at -20.
+     */
+    'altPenalty': number;
+    /**
+     * Penalty from VPN exposure. Fraction of the player\'s connections flagged > 50% positive × 15.
+     */
+    'vpnPenalty': number;
+    /**
+     * Penalty from active PROPAGATED punishment links × 3. Capped at -15.
+     */
+    'propagationPenalty': number;
+    /**
+     * Sum of base + bonuses - penalties BEFORE clamping to 0..100. Useful for debugging \"why is my -50 raw sum clamped to 0?\" cases.
+     */
+    'rawSum': number;
+    /**
+     * The clamped final trust factor (0–100). Identical to what compute_trust_factor() returns.
+     */
+    'finalScore': number;
+    /**
+     * Days since the player\'s account was created.
+     */
+    'accountAgeDays': number;
+    /**
+     * Days since the most recent active punishment landed. Null when the player has none — the clean_history bonus is at its cap.
+     */
+    'daysSinceLastPunishment'?: number | null;
+    /**
+     * Distinct connections this player has used. Drives the stability bonus.
+     */
+    'numConnections': number;
+    /**
+     * Alt-exemption rows attributed to this player (admin-asserted legitimate associates).
+     */
+    'numAltExemptions': number;
+    /**
+     * Whether this player currently has an active player_bypass row.
+     */
+    'hasPlayerBypass': boolean;
+    /**
+     * Count of active (non-revoked, non-expired) player_punishment rows on this player. Includes both DIRECT and PROPAGATED.
+     */
+    'numActivePunishments': number;
+    /**
+     * Alts with active punishments (drives the bigger per-alt penalty multiplier).
+     */
+    'numDirtyAlts': number;
+    /**
+     * Alts WITHOUT active punishments (drives the smaller per-alt penalty multiplier).
+     */
+    'numCleanAlts': number;
+    /**
+     * Fraction of this player\'s connections flagged > 50% VPN-positive. Range 0..1.
+     */
+    'vpnConnectionRatio': number;
+    /**
+     * Active PROPAGATED player_punishment links on this player (i.e. aggressive-mode propagation).
+     */
+    'numPropagatedLinks': number;
+}
+/**
+ * One trust factor snapshot for a player on a given day.
+ */
+export interface AdminTrustFactorHistoryEntry {
+    /**
+     * UTC date the snapshot was taken
+     */
+    'snapshotDate': string;
+    /**
+     * Trust factor (0–100, higher = more trusted) on that day
+     */
+    'trustFactor': number;
+}
+/**
+ * Trust factor impact preview for a player-targeted punishment.
+ */
+export interface AdminTrustFactorImpact {
+    /**
+     * Trust factor right now (0-100, higher = more trusted). Computed by compute_trust_factor in the database.
+     */
+    'currentTrustFactor': number;
+    /**
+     * Approximate trust factor AFTER this punishment would land. Approximate because caps in the underlying signals can absorb part of the impact, so the actual post-apply value may be higher than this preview.
+     */
+    'projectedTrustFactor': number;
+}
+/**
+ * Partial update for a punishment. All fields are optional; omitted fields stay untouched.
+ */
+export interface AdminUpdatePunishmentRequest {
+    /**
+     * Replace the visible reason. Min 3, max 500 characters.
+     */
+    'reason'?: string | null;
+    /**
+     * Replace the internal admin notes. Null leaves them untouched; empty string clears them.
+     */
+    'notes'?: string | null;
+    /**
+     * Replace the expiry timestamp (ISO-8601). Send an explicit null in JSON to make permanent — but note: omitting the field leaves expiry untouched. Use \'forcePermanent\' if you want to clear.
+     */
+    'expiresAt'?: string | null;
+    /**
+     * When true, clears expiresAt (makes the punishment permanent). Takes precedence over expiresAt.
+     */
+    'forcePermanent'?: boolean | null;
+    /**
+     * Replace the punishment type (BAN/MUTE/KICK/WARNING). Affects trust factor retroactively.
+     */
+    'type'?: PunishmentType | null;
+    /**
+     * Replace the severity (1–4). Affects trust factor retroactively.
+     */
+    'severity'?: number | null;
+    /**
+     * Targets to ADD. Each entry has either a player UUID or an IP. UUID → new DIRECT player_punishment row. IP → new connection_punishment row.
+     */
+    'addTargets'?: Array<AdminPunishmentTarget> | null;
+    /**
+     * Targets to REMOVE. UUID → soft-revoke the DIRECT player_punishment link. IP → delete the connection_punishment row outright. PROPAGATED links are not affected by this endpoint.
+     */
+    'removeTargets'?: Array<AdminPunishmentTarget> | null;
+}
 /**
  * A single entry in a player\'s username history
  */
@@ -568,9 +1153,18 @@ export interface ConnectionGetConnectionDetailsResponse {
      */
     'ipAddress': string;
     /**
-     * Approximate geographic location of the IP address. Returns \'Local, N/A\' for localhost or private IPs.
+     * City reported by the first VPN provider that returned one for this IP. Null for localhost / private IPs or when no provider returned a city.
+     */
+    'city'?: string | null;
+    /**
+     * Country code reported by the first VPN provider that returned one (ISO 3166-1 alpha-2 or alpha-3 depending on provider).
      */
-    'approximateLocation': string;
+    'country'?: string | null;
+    /**
+     * **DEPRECATED.** Combined city + country string retained for clients pinned to ≤ 3.6.0. Reads as \"City, COUNTRY\" when both are present, the available one when only one is, null when neither is. Use {@link #city} and {@link #country} directly.
+     * @deprecated
+     */
+    'approximateLocation'?: string | null;
     /**
      * Confidence score representing the percentage of VPN detection services that flagged this IP as suspicious. Range: 0.0 (clean) to 100.0 (definitely VPN/proxy).
      */
@@ -605,7 +1199,7 @@ export interface ConnectionGetConnectionDetailsResponse {
     'connectionResult'?: ConnectionResult | null;
 }
 /**
- * Join enforcement result. Only populated when \'associate_uuid\' query parameter is provided. Contains the final allow/deny decision and a formatted kick message if denied.
+ * Final allow/deny verdict plus formatted kick message if denied.
  */
 export interface ConnectionResult {
     'code': ConnectionResultResultCode;
@@ -635,6 +1229,60 @@ export interface CreateBypassRequest {
      */
     'expiresAtEpoch': number;
 }
+/**
+ * Game-server-issued peer report. Sent when a player runs /report in-game. A single report can target multiple players (\"these 3 were griefing together\"); the same reporter resubmitting the EXACT same target set while the prior report is unresolved updates it in place (response\'s deduplicated = true). Any different target set, even an overlapping one, creates a new report.
+ */
+export interface CreateReportRequest {
+    /**
+     * Reporter\'s UUID (the player who ran /report)
+     */
+    'reporterUuid': string;
+    /**
+     * One or more reported player UUIDs. Duplicates within the list are de-duped server-side. The reporter MUST NOT appear in this list.
+     */
+    'reportedUuids': Array<string>;
+    /**
+     * Category of misconduct. Coarse on purpose — staff refine in triage.
+     */
+    'category': ReportCategory;
+    /**
+     * Free-form description from the reporter (1–500 chars)
+     */
+    'reason': string;
+}
+/**
+ * Acknowledgement that a peer report was accepted by the API.
+ */
+export interface CreateReportResponse {
+    /**
+     * Server-assigned report id
+     */
+    'reportId': number;
+    /**
+     * True if an active report from this reporter against this target already existed; the row\'s reason/category were updated in place. False on first report.
+     */
+    'deduplicated': boolean;
+}
+export interface CursoredPageAdminAuditLogEntry {
+    'content': Array<AdminAuditLogEntry>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+    'totalSize': number;
+    'totalPages': number;
+    'cursors': Array<object>;
+}
+export interface CursoredPageable {
+    'orderBy': Array<SortOrder>;
+    'number': number;
+    'size': number;
+    'mode': PageableMode;
+    'sort': Sort;
+    'backward': boolean;
+}
 export declare const GameType: {
     readonly Rotj: "ROTJ";
     readonly Legacy: "LEGACY";
@@ -642,7 +1290,163 @@ export declare const GameType: {
 };
 export type GameType = typeof GameType[keyof typeof GameType];
 /**
- * Player information including join history, tracking data, and punishment scoring
+ * Current lifecycle state.
+ */
+export declare const JobStatus: {
+    readonly Queued: "QUEUED";
+    readonly Running: "RUNNING";
+    readonly Completed: "COMPLETED";
+    readonly Failed: "FAILED";
+    readonly Cancelled: "CANCELLED";
+};
+export type JobStatus = typeof JobStatus[keyof typeof JobStatus];
+export interface PageAdminAltAccount {
+    'content': Array<AdminAltAccount>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+    'totalSize': number;
+    'totalPages': number;
+}
+export interface PageAdminAltExemption {
+    'content': Array<AdminAltExemption>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+    'totalSize': number;
+    'totalPages': number;
+}
+export interface PageAdminAsyncJob {
+    'content': Array<AdminAsyncJob>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+    'totalSize': number;
+    'totalPages': number;
+}
+export interface PageAdminAuditLogEntry {
+    'content': Array<AdminAuditLogEntry>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+    'totalSize': number;
+    'totalPages': number;
+}
+export interface PageAdminDashboardConnectionResponse {
+    'content': Array<AdminDashboardConnectionResponse>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+    'totalSize': number;
+    'totalPages': number;
+}
+export interface PageAdminPlayerNote {
+    'content': Array<AdminPlayerNote>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+    'totalSize': number;
+    'totalPages': number;
+}
+export interface PageAdminPlayerPunishmentResponse {
+    'content': Array<AdminPlayerPunishmentResponse>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+    'totalSize': number;
+    'totalPages': number;
+}
+export interface PageAdminPlayerReport {
+    'content': Array<AdminPlayerReport>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+    'totalSize': number;
+    'totalPages': number;
+}
+export interface PageAdminPlayerSession {
+    'content': Array<AdminPlayerSession>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+    'totalSize': number;
+    'totalPages': number;
+}
+export interface PageAdminPlayerSummary {
+    'content': Array<AdminPlayerSummary>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+    'totalSize': number;
+    'totalPages': number;
+}
+export interface PageAdminPunishmentListItem {
+    'content': Array<AdminPunishmentListItem>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+    'totalSize': number;
+    'totalPages': number;
+}
+export interface PagePunishmentGetPunishmentResponse {
+    'content': Array<PunishmentGetPunishmentResponse>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+    'totalSize': number;
+    'totalPages': number;
+}
+export interface Pageable {
+    'orderBy': Array<SortOrder>;
+    'number': number;
+    'size': number;
+    'mode': PageableMode;
+    'sort': Sort;
+}
+export declare const PageableMode: {
+    readonly CursorNext: "CURSOR_NEXT";
+    readonly CursorPrevious: "CURSOR_PREVIOUS";
+    readonly Offset: "OFFSET";
+};
+export type PageableMode = typeof PageableMode[keyof typeof PageableMode];
+/**
+ * Player information including join history, tracking data, and trust factor
  */
 export interface PlayerGetPlayerInformation {
     /**
@@ -654,73 +1458,182 @@ export interface PlayerGetPlayerInformation {
      */
     'firstLogin': string;
     /**
-     * Raw punishment score calculated as: SUM((base_weight × severity/10)). Used for tracking overall punishment severity.
+     * Trust factor (0-100, higher = more trusted). Composite signal from account age, punishment history, alts, connections, propagation, and admin affirmations. Informational only — does NOT auto-escalate punishments.
+     */
+    'trustFactor': number;
+    /**
+     * **DEPRECATED.** The punishment-score formula was removed in 3.7.0 when trust factor replaced it. This field always serializes as 0.0 and is retained only for clients pinned to ≤ 3.6.0. Use {@link #trustFactor} instead.
+     * @deprecated
      */
     'punishmentPointsRaw': number;
     /**
-     * Punishment score as a percentage (0-100). When >100% before applying a new punishment, the new punishment should be made permanent.
+     * **DEPRECATED.** See {@link #punishmentPointsRaw}. Always 0.0 — use trustFactor.
+     * @deprecated
      */
     'punishmentPointsPercent': number;
 }
 /**
- * Punishment information including reason, type, creator, and expiration
+ * Close the active player session for a (playerUuid, serverSessionId) pair. No-op if no active session is found.
  */
-export interface PunishmentGetPunishmentResponse {
-    /**
-     * Unique identifier for the punishment
-     */
-    'id': number;
-    /**
-     * Reason for the punishment, shown to the punished player
-     */
-    'reason': string;
+export interface PlayerSessionEndRequest {
     /**
-     * Internal administrator notes — not shown to the punished player
+     * Player Minecraft UUID
      */
-    'notes'?: string | null;
+    'playerUuid': string;
     /**
-     * Type of punishment
+     * Server session id the player was on
      */
-    'type': PunishmentType;
+    'serverSessionId': string;
+}
+/**
+ * Unified player-join request. Runs the full authorization check (VPN, bypass, punishments) and conditionally opens a player_session for the allowed players.
+ */
+export interface PlayerSessionStartRequest {
     /**
-     * Severity level (1=Minor, 2=Moderate, 3=Severe, 4=Critical)
+     * Player Minecraft UUID
      */
-    'severity': number;
+    'playerUuid': string;
     /**
-     * Username or identifier of the person who created this punishment
+     * Server session id this player is on (from /v1/servers register)
      */
-    'createdBy': string;
+    'serverSessionId': string;
     /**
-     * Timestamp when the punishment expires (ISO-8601 format). Null for permanent punishments.
+     * IPv4 address the player is connecting from
      */
-    'expiresAt'?: string | null;
+    'ip': string;
     /**
-     * Timestamp when the punishment was created (ISO-8601 format)
+     * When true, bypass any cached VPN-check result and re-run all detection services. Useful when debugging a specific connection. Defaults to false.
      */
-    'createdAt': string;
+    'forceRecheck'?: boolean | null;
 }
 /**
- * Response containing punishment severity durations for each type
+ * Result of POST /v1/player-session/start. Always populated; session fields are null when the player was not allowed in.
  */
-export interface PunishmentSeveritiesResponse {
+export interface PlayerSessionStartResponse {
     /**
-     * List of punishment types with their severity durations
+     * Session row id. Null when the join was not allowed.
      */
-    'punishmentTypes': Array<PunishmentSeveritiesResponsePunishmentTypeInfo>;
-}
-/**
- * Punishment type with severity information
- */
-export interface PunishmentSeveritiesResponsePunishmentTypeInfo {
+    'sessionId'?: string | null;
     /**
-     * Type of punishment
+     * When the session was opened (ISO-8601). For re-attached sessions this is the original start time, not now. Null when the join was not allowed.
      */
-    'type': PunishmentType;
+    'startedAt'?: string | null;
     /**
-     * List of severity levels with durations
+     * Player Minecraft UUID
      */
-    'severities': Array<PunishmentSeveritiesResponseSeverityInfo>;
-}
+    'playerUuid': string;
+    /**
+     * Server session id the join applies to
+     */
+    'serverSessionId': string;
+    /**
+     * Final allow/deny verdict plus formatted kick message if denied.
+     */
+    'connectionResult': ConnectionResult;
+    /**
+     * Player\'s connecting IP, echoed from the request
+     */
+    'ipAddress': string;
+    /**
+     * City reported by the first VPN provider that returned one. Null when no provider has city data (private IPs, localhost, sparse providers).
+     */
+    'city'?: string | null;
+    /**
+     * Country code reported by the first VPN provider that returned one (ISO 3166-1 alpha-2 or alpha-3 depending on provider).
+     */
+    'country'?: string | null;
+    /**
+     * Confidence score (0.0–100.0) representing what fraction of VPN detection services flagged this IP as suspicious.
+     */
+    'percentPositive': number;
+    /**
+     * Total VPN detection services successfully queried on this IP
+     */
+    'numberOfChecks': number;
+    /**
+     * Whether this IP has an active administrative VPN bypass
+     */
+    'isBypassed': boolean;
+    /**
+     * Bypass expiration timestamp; null if not bypassed or bypass is permanent.
+     */
+    'bypassedUntil'?: string | null;
+    /**
+     * Per-provider VPN check results, useful for the admin UI / debugging.
+     */
+    'checkResults'?: Array<AdminConnectionCheckResult>;
+    /**
+     * Player info (first-join flag, first login, punishment score). Null only in edge cases where the player record could not be loaded.
+     */
+    'playerInformation'?: PlayerGetPlayerInformation | null;
+    /**
+     * Active (non-expired, non-revoked) punishments on this player, including any that were just propagated by the join check.
+     */
+    'activePunishments': Array<PunishmentGetPunishmentResponse>;
+    /**
+     * Aggregate session stats. Useful for game-server-side welcome messages (\"Welcome back — you\'ve played 250 hours\") or for the chat plugin to know if the player is a returning user.
+     */
+    'sessionStats': AdminPlayerSessionStats;
+}
+/**
+ * Punishment information including reason, type, creator, and expiration
+ */
+export interface PunishmentGetPunishmentResponse {
+    /**
+     * Unique identifier for the punishment
+     */
+    'id': number;
+    /**
+     * Reason for the punishment, shown to the punished player
+     */
+    'reason': string;
+    /**
+     * Internal administrator notes — not shown to the punished player
+     */
+    'notes'?: string | null;
+    /**
+     * Type of punishment
+     */
+    'type': PunishmentType;
+    /**
+     * Severity level (1=Minor, 2=Moderate, 3=Severe, 4=Critical)
+     */
+    'severity': number;
+    /**
+     * Username or identifier of the person who created this punishment
+     */
+    'createdBy': string;
+    /**
+     * Timestamp when the punishment expires (ISO-8601 format). Null for permanent punishments.
+     */
+    'expiresAt'?: string | null;
+    /**
+     * Timestamp when the punishment was created (ISO-8601 format)
+     */
+    'createdAt': string;
+}
+/**
+ * Response containing punishment severity durations for each type
+ */
+export interface PunishmentSeveritiesResponse {
+    /**
+     * List of punishment types with their severity durations
+     */
+    'punishmentTypes': Array<PunishmentSeveritiesResponsePunishmentTypeInfo>;
+}
+/**
+ * Punishment type with severity information
+ */
+export interface PunishmentSeveritiesResponsePunishmentTypeInfo {
+    /**
+     * Type of punishment
+     */
+    'type': PunishmentType;
+    /**
+     * List of severity levels with durations
+     */
+    'severities': Array<PunishmentSeveritiesResponseSeverityInfo>;
+}
 /**
  * Severity level with duration information
  */
@@ -734,11 +1647,22 @@ export interface PunishmentSeveritiesResponseSeverityInfo {
      */
     'durationSeconds': number;
 }
+/**
+ * How this link came to exist. DIRECT links are immutable from the link side (remove via the punishment-level delete); PROPAGATED links are revocable individually.
+ */
+export declare const PunishmentSource: {
+    readonly Direct: "DIRECT";
+    readonly Propagated: "PROPAGATED";
+};
+export type PunishmentSource = typeof PunishmentSource[keyof typeof PunishmentSource];
 export declare const PunishmentTargetType: {
     readonly Player: "PLAYER";
     readonly Connection: "CONNECTION";
 };
 export type PunishmentTargetType = typeof PunishmentTargetType[keyof typeof PunishmentTargetType];
+/**
+ * Type of punishment
+ */
 export declare const PunishmentType: {
     readonly Ban: "BAN";
     readonly Mute: "MUTE";
@@ -757,6 +1681,17 @@ export declare const Region: {
     readonly Au: "AU";
 };
 export type Region = typeof Region[keyof typeof Region];
+/**
+ * Category of misconduct. Coarse on purpose — staff refine in triage.
+ */
+export declare const ReportCategory: {
+    readonly Cheating: "CHEATING";
+    readonly Harassment: "HARASSMENT";
+    readonly ChatAbuse: "CHAT_ABUSE";
+    readonly Griefing: "GRIEFING";
+    readonly Other: "OTHER";
+};
+export type ReportCategory = typeof ReportCategory[keyof typeof ReportCategory];
 /**
  * Search kind — PLAYER for UUID/username searches, IP for IP address searches
  */
@@ -781,6 +1716,128 @@ export interface ServerSessionDTO {
     'endedAt'?: string | null;
     'online': boolean;
 }
+export interface SliceAdminAltAccount {
+    'content': Array<AdminAltAccount>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+}
+export interface SliceAdminAltExemption {
+    'content': Array<AdminAltExemption>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+}
+export interface SliceAdminAsyncJob {
+    'content': Array<AdminAsyncJob>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+}
+export interface SliceAdminAuditLogEntry {
+    'content': Array<AdminAuditLogEntry>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+}
+export interface SliceAdminDashboardConnectionResponse {
+    'content': Array<AdminDashboardConnectionResponse>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+}
+export interface SliceAdminPlayerNote {
+    'content': Array<AdminPlayerNote>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+}
+export interface SliceAdminPlayerPunishmentResponse {
+    'content': Array<AdminPlayerPunishmentResponse>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+}
+export interface SliceAdminPlayerReport {
+    'content': Array<AdminPlayerReport>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+}
+export interface SliceAdminPlayerSession {
+    'content': Array<AdminPlayerSession>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+}
+export interface SliceAdminPlayerSummary {
+    'content': Array<AdminPlayerSummary>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+}
+export interface SliceAdminPunishmentListItem {
+    'content': Array<AdminPunishmentListItem>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+}
+export interface SlicePunishmentGetPunishmentResponse {
+    'content': Array<PunishmentGetPunishmentResponse>;
+    'pageable': Pageable;
+    'pageNumber': number;
+    'offset': number;
+    'size': number;
+    'empty': boolean;
+    'numberOfElements': number;
+}
+export interface Sort {
+    'orderBy': Array<SortOrder>;
+}
+export interface SortOrder {
+    'ignoreCase': boolean;
+    'direction': SortOrderDirection;
+    'property': string;
+    'ascending': boolean;
+}
+export declare const SortOrderDirection: {
+    readonly Asc: "ASC";
+    readonly Desc: "DESC";
+};
+export type SortOrderDirection = typeof SortOrderDirection[keyof typeof SortOrderDirection];
 export interface TokenRequest {
     'grant_type'?: string | null;
     'client_id'?: string | null;
@@ -807,6 +1864,122 @@ export interface UserProfileResponse {
     'roles': Array<string>;
     'discordRoles': Array<string>;
 }
+/**
+ * AdminAuditLogApi - axios parameter creator
+ */
+export declare const AdminAuditLogApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Paginated audit-log search. All filter parameters are optional; an empty filter set returns the most recent rows across the system. Sorted newest-first.
+     * @summary Search the admin audit log
+     * @param {Pageable} pageable
+     * @param {string | null} [actor] Filter to actions performed by this Discord username (case-sensitive exact match)
+     * @param {string | null} [action] Filter to a specific action verb (e.g. REVOKE_PROPAGATED_LINK, SET_AGGRESSIVE_MODE_IMMUNITY)
+     * @param {string | null} [targetType] Filter to a specific target type (e.g. PLAYER, PUNISHMENT, PLAYER_PUNISHMENT)
+     * @param {string | null} [targetId] Filter to a specific target id (paired with targetType for narrowing)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    search: (pageable: Pageable, actor?: string | null, action?: string | null, targetType?: string | null, targetId?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Cursor-based companion to GET /admin/audit-log. Preferred for the admin UI\'s infinite-scroll view of the audit log because the SQL plan stays flat as the table grows — offset pagination degrades linearly with depth, this does not. Pass the {@code cursor} returned in the previous response to get the next page; omit it for the first page.
+     * @summary Cursor-paginated audit-log search (infinite scroll)
+     * @param {CursoredPageable} pageable
+     * @param {string | null} [actor]
+     * @param {string | null} [action]
+     * @param {string | null} [targetType]
+     * @param {string | null} [targetId]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    searchCursor: (pageable: CursoredPageable, actor?: string | null, action?: string | null, targetType?: string | null, targetId?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * AdminAuditLogApi - functional programming interface
+ */
+export declare const AdminAuditLogApiFp: (configuration?: Configuration) => {
+    /**
+     * Paginated audit-log search. All filter parameters are optional; an empty filter set returns the most recent rows across the system. Sorted newest-first.
+     * @summary Search the admin audit log
+     * @param {Pageable} pageable
+     * @param {string | null} [actor] Filter to actions performed by this Discord username (case-sensitive exact match)
+     * @param {string | null} [action] Filter to a specific action verb (e.g. REVOKE_PROPAGATED_LINK, SET_AGGRESSIVE_MODE_IMMUNITY)
+     * @param {string | null} [targetType] Filter to a specific target type (e.g. PLAYER, PUNISHMENT, PLAYER_PUNISHMENT)
+     * @param {string | null} [targetId] Filter to a specific target id (paired with targetType for narrowing)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    search(pageable: Pageable, actor?: string | null, action?: string | null, targetType?: string | null, targetId?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminAuditLogEntry>>;
+    /**
+     * Cursor-based companion to GET /admin/audit-log. Preferred for the admin UI\'s infinite-scroll view of the audit log because the SQL plan stays flat as the table grows — offset pagination degrades linearly with depth, this does not. Pass the {@code cursor} returned in the previous response to get the next page; omit it for the first page.
+     * @summary Cursor-paginated audit-log search (infinite scroll)
+     * @param {CursoredPageable} pageable
+     * @param {string | null} [actor]
+     * @param {string | null} [action]
+     * @param {string | null} [targetType]
+     * @param {string | null} [targetId]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    searchCursor(pageable: CursoredPageable, actor?: string | null, action?: string | null, targetType?: string | null, targetId?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<CursoredPageAdminAuditLogEntry>>;
+};
+/**
+ * AdminAuditLogApi - factory interface
+ */
+export declare const AdminAuditLogApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Paginated audit-log search. All filter parameters are optional; an empty filter set returns the most recent rows across the system. Sorted newest-first.
+     * @summary Search the admin audit log
+     * @param {Pageable} pageable
+     * @param {string | null} [actor] Filter to actions performed by this Discord username (case-sensitive exact match)
+     * @param {string | null} [action] Filter to a specific action verb (e.g. REVOKE_PROPAGATED_LINK, SET_AGGRESSIVE_MODE_IMMUNITY)
+     * @param {string | null} [targetType] Filter to a specific target type (e.g. PLAYER, PUNISHMENT, PLAYER_PUNISHMENT)
+     * @param {string | null} [targetId] Filter to a specific target id (paired with targetType for narrowing)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    search(pageable: Pageable, actor?: string | null, action?: string | null, targetType?: string | null, targetId?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminAuditLogEntry>;
+    /**
+     * Cursor-based companion to GET /admin/audit-log. Preferred for the admin UI\'s infinite-scroll view of the audit log because the SQL plan stays flat as the table grows — offset pagination degrades linearly with depth, this does not. Pass the {@code cursor} returned in the previous response to get the next page; omit it for the first page.
+     * @summary Cursor-paginated audit-log search (infinite scroll)
+     * @param {CursoredPageable} pageable
+     * @param {string | null} [actor]
+     * @param {string | null} [action]
+     * @param {string | null} [targetType]
+     * @param {string | null} [targetId]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    searchCursor(pageable: CursoredPageable, actor?: string | null, action?: string | null, targetType?: string | null, targetId?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<CursoredPageAdminAuditLogEntry>;
+};
+/**
+ * AdminAuditLogApi - object-oriented interface
+ */
+export declare class AdminAuditLogApi extends BaseAPI {
+    /**
+     * Paginated audit-log search. All filter parameters are optional; an empty filter set returns the most recent rows across the system. Sorted newest-first.
+     * @summary Search the admin audit log
+     * @param {Pageable} pageable
+     * @param {string | null} [actor] Filter to actions performed by this Discord username (case-sensitive exact match)
+     * @param {string | null} [action] Filter to a specific action verb (e.g. REVOKE_PROPAGATED_LINK, SET_AGGRESSIVE_MODE_IMMUNITY)
+     * @param {string | null} [targetType] Filter to a specific target type (e.g. PLAYER, PUNISHMENT, PLAYER_PUNISHMENT)
+     * @param {string | null} [targetId] Filter to a specific target id (paired with targetType for narrowing)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    search(pageable: Pageable, actor?: string | null, action?: string | null, targetType?: string | null, targetId?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PageAdminAuditLogEntry, any, {}>>;
+    /**
+     * Cursor-based companion to GET /admin/audit-log. Preferred for the admin UI\'s infinite-scroll view of the audit log because the SQL plan stays flat as the table grows — offset pagination degrades linearly with depth, this does not. Pass the {@code cursor} returned in the previous response to get the next page; omit it for the first page.
+     * @summary Cursor-paginated audit-log search (infinite scroll)
+     * @param {CursoredPageable} pageable
+     * @param {string | null} [actor]
+     * @param {string | null} [action]
+     * @param {string | null} [targetType]
+     * @param {string | null} [targetId]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    searchCursor(pageable: CursoredPageable, actor?: string | null, action?: string | null, targetType?: string | null, targetId?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<CursoredPageAdminAuditLogEntry, any, {}>>;
+}
 /**
  * AdminClientCredentialsApi - axios parameter creator
  */
@@ -1056,8 +2229,8 @@ export declare class AdminClientCredentialsApi extends BaseAPI {
  */
 export declare const AdminConnectionsApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
-     * Iterates every connection_check row where both city and country are NULL and re-runs that row\'s source VPN service to populate location data. Concurrency is capped to avoid overwhelming external providers. Synchronous — returns once the run completes.
-     * @summary Backfill missing location data
+     * 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}
      */
@@ -1070,32 +2243,49 @@ export declare const AdminConnectionsApiAxiosParamCreator: (configuration?: Conf
      * @throws {RequiredError}
      */
     createBypass: (createBypassRequest: CreateBypassRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 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) => Promise<RequestArgs>;
+    /**
+     * 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) => Promise<RequestArgs>;
     /**
      * 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 {string | null} [ipAddress] Filter by IP address
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {boolean | null} [isVpn] Filter by VPN status
-     * @param {number | null} [page] Page number (1-indexed)
-     * @param {number | null} [limit] Page size
+     * @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: (ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    listAllConnections: (pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * 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 {number | null} [createdAfter] Filter connections after this epoch timestamp in milliseconds
-     * @param {number | null} [createdBefore] Filter connections before this epoch timestamp in milliseconds
-     * @param {string | null} [ipAddress] Filter by IP address
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {boolean | null} [isVpn] Filter by VPN status (true&#x3D;VPN, false&#x3D;not VPN)
-     * @param {number | null} [page] Page number for pagination
-     * @param {number | null} [limit] Maximum number of records to return
+     * @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: (createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    listConnections: (pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * 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
@@ -1111,12 +2301,12 @@ export declare const AdminConnectionsApiAxiosParamCreator: (configuration?: Conf
  */
 export declare const AdminConnectionsApiFp: (configuration?: Configuration) => {
     /**
-     * Iterates every connection_check row where both city and country are NULL and re-runs that row\'s source VPN service to populate location data. Concurrency is capped to avoid overwhelming external providers. Synchronous — returns once the run completes.
-     * @summary Backfill missing location data
+     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminBackfillLocationResponse>>;
+    backfillLocation(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAsyncJobStartResponse>>;
     /**
      * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
      * @summary Create connection bypass
@@ -1125,32 +2315,49 @@ export declare const AdminConnectionsApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     createBypass(createBypassRequest: CreateBypassRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminConnectionBypassResponse>>;
+    /**
+     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminDashboardConnectionResponse>>;
+    /**
+     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminPlayerSummary>>;
     /**
      * 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 {string | null} [ipAddress] Filter by IP address
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {boolean | null} [isVpn] Filter by VPN status
-     * @param {number | null} [page] Page number (1-indexed)
-     * @param {number | null} [limit] Page size
+     * @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(ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPagedConnectionResponse>>;
+    listAllConnections(pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminDashboardConnectionResponse>>;
     /**
      * 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 {number | null} [createdAfter] Filter connections after this epoch timestamp in milliseconds
-     * @param {number | null} [createdBefore] Filter connections before this epoch timestamp in milliseconds
-     * @param {string | null} [ipAddress] Filter by IP address
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {boolean | null} [isVpn] Filter by VPN status (true&#x3D;VPN, false&#x3D;not VPN)
-     * @param {number | null} [page] Page number for pagination
-     * @param {number | null} [limit] Maximum number of records to return
+     * @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(createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardConnectionResponse>>>;
+    listConnections(pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardConnectionResponse>>>;
     /**
      * 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
@@ -1166,12 +2373,12 @@ export declare const AdminConnectionsApiFp: (configuration?: Configuration) => {
  */
 export declare const AdminConnectionsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
-     * Iterates every connection_check row where both city and country are NULL and re-runs that row\'s source VPN service to populate location data. Concurrency is capped to avoid overwhelming external providers. Synchronous — returns once the run completes.
-     * @summary Backfill missing location data
+     * 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<AdminBackfillLocationResponse>;
+    backfillLocation(options?: RawAxiosRequestConfig): AxiosPromise<AdminAsyncJobStartResponse>;
     /**
      * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
      * @summary Create connection bypass
@@ -1180,32 +2387,49 @@ export declare const AdminConnectionsApiFactory: (configuration?: Configuration,
      * @throws {RequiredError}
      */
     createBypass(createBypassRequest: CreateBypassRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminConnectionBypassResponse>;
+    /**
+     * 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>;
+    /**
+     * 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>;
     /**
      * 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 {string | null} [ipAddress] Filter by IP address
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {boolean | null} [isVpn] Filter by VPN status
-     * @param {number | null} [page] Page number (1-indexed)
-     * @param {number | null} [limit] Page size
+     * @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(ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<AdminPagedConnectionResponse>;
+    listAllConnections(pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminDashboardConnectionResponse>;
     /**
      * 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 {number | null} [createdAfter] Filter connections after this epoch timestamp in milliseconds
-     * @param {number | null} [createdBefore] Filter connections before this epoch timestamp in milliseconds
-     * @param {string | null} [ipAddress] Filter by IP address
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {boolean | null} [isVpn] Filter by VPN status (true&#x3D;VPN, false&#x3D;not VPN)
-     * @param {number | null} [page] Page number for pagination
-     * @param {number | null} [limit] Maximum number of records to return
+     * @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(createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardConnectionResponse>>;
+    listConnections(pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardConnectionResponse>>;
     /**
      * 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
@@ -1221,12 +2445,12 @@ export declare const AdminConnectionsApiFactory: (configuration?: Configuration,
  */
 export declare class AdminConnectionsApi extends BaseAPI {
     /**
-     * Iterates every connection_check row where both city and country are NULL and re-runs that row\'s source VPN service to populate location data. Concurrency is capped to avoid overwhelming external providers. Synchronous — returns once the run completes.
-     * @summary Backfill missing location data
+     * 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): Promise<import("axios").AxiosResponse<AdminBackfillLocationResponse, any, {}>>;
+    backfillLocation(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAsyncJobStartResponse, any, {}>>;
     /**
      * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
      * @summary Create connection bypass
@@ -1235,181 +2459,974 @@ export declare class AdminConnectionsApi extends BaseAPI {
      * @throws {RequiredError}
      */
     createBypass(createBypassRequest: CreateBypassRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminConnectionBypassResponse, any, {}>>;
+    /**
+     * 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): Promise<import("axios").AxiosResponse<AdminDashboardConnectionResponse, any, {}>>;
+    /**
+     * 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): Promise<import("axios").AxiosResponse<PageAdminPlayerSummary, any, {}>>;
     /**
      * 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 {string | null} [ipAddress] Filter by IP address
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {boolean | null} [isVpn] Filter by VPN status
-     * @param {number | null} [page] Page number (1-indexed)
-     * @param {number | null} [limit] Page size
+     * @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(ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPagedConnectionResponse, any, {}>>;
+    listAllConnections(pageable: Pageable, createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PageAdminDashboardConnectionResponse, any, {}>>;
     /**
      * 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 {number | null} [createdAfter] Filter connections after this epoch timestamp in milliseconds
-     * @param {number | null} [createdBefore] Filter connections before this epoch timestamp in milliseconds
-     * @param {string | null} [ipAddress] Filter by IP address
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {boolean | null} [isVpn] Filter by VPN status (true&#x3D;VPN, false&#x3D;not VPN)
-     * @param {number | null} [page] Page number for pagination
-     * @param {number | null} [limit] Maximum number of records to return
+     * @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): Promise<import("axios").AxiosResponse<AdminDashboardConnectionResponse[], any, {}>>;
+    /**
+     * 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): Promise<import("axios").AxiosResponse<AdminConnectionCheckResult, any, {}>>;
+}
+/**
+ * AdminDashboardApi - axios parameter creator
+ */
+export declare const AdminDashboardApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * 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) => Promise<RequestArgs>;
+};
+/**
+ * AdminDashboardApi - functional programming interface
+ */
+export declare const AdminDashboardApiFp: (configuration?: Configuration) => {
+    /**
+     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminGetDashboardStats>>;
+};
+/**
+ * AdminDashboardApi - factory interface
+ */
+export declare const AdminDashboardApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * 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>;
+};
+/**
+ * AdminDashboardApi - object-oriented interface
+ */
+export declare 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}
+     */
+    dashboardStats(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminGetDashboardStats, any, {}>>;
+}
+/**
+ * AdminJobsApi - axios parameter creator
+ */
+export declare const AdminJobsApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Flips cancel_requested on the row. The host instance sees this at its next progress tick and bails out, transitioning the row to CANCELLED. Already-terminal jobs (COMPLETED/FAILED/CANCELLED) return 404.
+     * @summary Request cancellation of an async job
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    cancel: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Returns the CSV emitted by the job — typically one row per record the job touched. The first line is a header; subsequent lines are RFC-4180 escaped data rows. 404 when the job has no artifact (either it didn\'t emit one, or it hasn\'t finished yet).
+     * @summary Download a job\'s CSV artifact
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    downloadArtifact: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * The polling target — the admin UI hits this every ~2 s while a job is running to update its progress bar.
+     * @summary Get one async job
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    get: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Paginated, newest first. Filter by status to see only RUNNING jobs (the live queue) or COMPLETED / FAILED / CANCELLED history.
+     * @summary List async jobs
+     * @param {Pageable} pageable
+     * @param {JobStatus | null} [status] Filter by status (omit for all states)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    list: (pageable: Pageable, status?: JobStatus | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * AdminJobsApi - functional programming interface
+ */
+export declare const AdminJobsApiFp: (configuration?: Configuration) => {
+    /**
+     * Flips cancel_requested on the row. The host instance sees this at its next progress tick and bails out, transitioning the row to CANCELLED. Already-terminal jobs (COMPLETED/FAILED/CANCELLED) return 404.
+     * @summary Request cancellation of an async job
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    cancel(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * Returns the CSV emitted by the job — typically one row per record the job touched. The first line is a header; subsequent lines are RFC-4180 escaped data rows. 404 when the job has no artifact (either it didn\'t emit one, or it hasn\'t finished yet).
+     * @summary Download a job\'s CSV artifact
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    downloadArtifact(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<string>>;
+    /**
+     * The polling target — the admin UI hits this every ~2 s while a job is running to update its progress bar.
+     * @summary Get one async job
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    get(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAsyncJob>>;
+    /**
+     * Paginated, newest first. Filter by status to see only RUNNING jobs (the live queue) or COMPLETED / FAILED / CANCELLED history.
+     * @summary List async jobs
+     * @param {Pageable} pageable
+     * @param {JobStatus | null} [status] Filter by status (omit for all states)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    list(pageable: Pageable, status?: JobStatus | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminAsyncJob>>;
+};
+/**
+ * AdminJobsApi - factory interface
+ */
+export declare const AdminJobsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Flips cancel_requested on the row. The host instance sees this at its next progress tick and bails out, transitioning the row to CANCELLED. Already-terminal jobs (COMPLETED/FAILED/CANCELLED) return 404.
+     * @summary Request cancellation of an async job
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    cancel(id: string, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * Returns the CSV emitted by the job — typically one row per record the job touched. The first line is a header; subsequent lines are RFC-4180 escaped data rows. 404 when the job has no artifact (either it didn\'t emit one, or it hasn\'t finished yet).
+     * @summary Download a job\'s CSV artifact
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    downloadArtifact(id: string, options?: RawAxiosRequestConfig): AxiosPromise<string>;
+    /**
+     * The polling target — the admin UI hits this every ~2 s while a job is running to update its progress bar.
+     * @summary Get one async job
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    get(id: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminAsyncJob>;
+    /**
+     * Paginated, newest first. Filter by status to see only RUNNING jobs (the live queue) or COMPLETED / FAILED / CANCELLED history.
+     * @summary List async jobs
+     * @param {Pageable} pageable
+     * @param {JobStatus | null} [status] Filter by status (omit for all states)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    list(pageable: Pageable, status?: JobStatus | null, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminAsyncJob>;
+};
+/**
+ * AdminJobsApi - object-oriented interface
+ */
+export declare class AdminJobsApi extends BaseAPI {
+    /**
+     * Flips cancel_requested on the row. The host instance sees this at its next progress tick and bails out, transitioning the row to CANCELLED. Already-terminal jobs (COMPLETED/FAILED/CANCELLED) return 404.
+     * @summary Request cancellation of an async job
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    cancel(id: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     * Returns the CSV emitted by the job — typically one row per record the job touched. The first line is a header; subsequent lines are RFC-4180 escaped data rows. 404 when the job has no artifact (either it didn\'t emit one, or it hasn\'t finished yet).
+     * @summary Download a job\'s CSV artifact
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    downloadArtifact(id: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<string, any, {}>>;
+    /**
+     * The polling target — the admin UI hits this every ~2 s while a job is running to update its progress bar.
+     * @summary Get one async job
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    get(id: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAsyncJob, any, {}>>;
+    /**
+     * Paginated, newest first. Filter by status to see only RUNNING jobs (the live queue) or COMPLETED / FAILED / CANCELLED history.
+     * @summary List async jobs
+     * @param {Pageable} pageable
+     * @param {JobStatus | null} [status] Filter by status (omit for all states)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    list(pageable: Pageable, status?: JobStatus | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PageAdminAsyncJob, any, {}>>;
+}
+/**
+ * AdminPlayersApi - axios parameter creator
+ */
+export declare const AdminPlayersApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Mark another player as a known-legitimate associate (e.g. roommate). The relationship is stored symmetrically: subsequent aggressive-mode propagation skips this pair as an alt source in either direction. Finer-grained than the per-player aggressive_mode_immunity flag.
+     * @summary Add an alt exemption
+     * @param {string} uuid Player Minecraft UUID
+     * @param {AdminCreateAltExemptionRequest} adminCreateAltExemptionRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    addAltExemption: (uuid: string, adminCreateAltExemptionRequest: AdminCreateAltExemptionRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Submits an async job that walks every player row whose username is NULL and calls the Mojang profile API to resolve it. The job upserts both the player.username column and a player_username_history row. Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. The final Admin_BackfillUsernamesResponse (processed/succeeded/failed counts) lands in the job\'s result_payload on COMPLETED. Mojang rate-limits at ~1 req/sec; a backfill of many rows can run for a while — cancel is honoured between rows.
+     * @summary Start a username backfill job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    backfillUsernames: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Soft-revokes every currently active PROPAGATED player_punishment row whose source matches the supplied id. Exactly one of sourcePlayerId / sourceConnectionId must be set. Useful when staff identify a single source as a false positive (e.g. shared NAT, legitimate roommate) and want to undo every link it caused in one operation.
+     * @summary Bulk-revoke PROPAGATED links by source
+     * @param {AdminBulkRevokeRequest} adminBulkRevokeRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    bulkRevokePropagated: (adminBulkRevokeRequest: AdminBulkRevokeRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Appends a free-form note (1–4000 chars). Notes are not editable — to revise, post a new one and soft-delete the old.
+     * @summary Create a staff note on a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {AdminCreatePlayerNoteRequest} adminCreatePlayerNoteRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createPlayerNote: (uuid: string, adminCreatePlayerNoteRequest: AdminCreatePlayerNoteRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Marks the note as deleted but keeps the row for audit. Idempotent — 404 if already deleted or unknown id.
+     * @summary Soft-delete a staff note
+     * @param {string} uuid Player Minecraft UUID (routing only)
+     * @param {number} noteId Note id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    deletePlayerNote: (uuid: string, noteId: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Returns the connection-shared player graph reachable from this player within {depth} hops. Mirrors the propagation walk used by ALT_PROPAGATION_SWEEP — promiscuous (likely shared-NAT) connections are pruned, alt-exemption rows cut the graph at exempted players. Depth is clamped server-side at 5. Used by the admin Graph tab to render an interactive explorer.
+     * @summary Alt-graph traversal rooted at a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {number} [depth] Hop depth to walk. 1&#x3D;direct alts only; 5&#x3D;full sticky-trap radius. Default 2.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getAltGraph: (uuid: string, depth?: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Returns full detail for a single player including all known usernames and punishment scoring.
+     * @summary Get player detail
+     * @param {string} uuid Player Minecraft UUID
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPlayer: (uuid: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Other players who have been seen on at least one of this player\'s historical connections. Sorted by shared-connection count desc, then last seen desc.
+     * @summary List a player\'s alt accounts
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPlayerAlts: (uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Paginated list of every connection this player has used (latest first). Same shape as the dashboard connection list, suitable for an infinite-scroll panel inside the player detail modal.
+     * @summary List a player\'s connection history
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPlayerConnections: (uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Paginated list of every player_punishment row for this player — DIRECT and PROPAGATED, active and revoked. Includes the transfer_note explaining why each propagated link was inserted and the revocation audit trail. The admin UI uses this to render a punishment-history section inside the player detail modal.
+     * @summary List a player\'s full punishment history
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPlayerPunishments: (uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Single-row summary: total seconds played, session count, distinct days active, most recent session start, and whether the player is currently online. Computed on demand from player_session. Feeds the trust factor system.
+     * @summary Get a player\'s aggregate session stats
+     * @param {string} uuid Player Minecraft UUID
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getSessionStats: (uuid: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Paginated list of the player\'s known-legitimate-associate exemptions. The list reflects rows where this player is the source side (player_id = this); since exemptions are stored symmetrically the reciprocal rows exist too.
+     * @summary List a player\'s alt exemptions
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listAltExemptions: (uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Paginated, newest first. Soft-deleted notes are included; the UI styles them as struck-through.
+     * @summary List staff notes on a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listPlayerNotes: (uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Returns up to 500 players ordered by most recently seen. Optionally filter by UUID or username substring.
+     * @summary List players
+     * @param {Pageable} pageable
+     * @param {string | null} [search] Optional search string matched against UUID or username (case-insensitive substring)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listPlayers: (pageable: Pageable, search?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Paginated history of player_session rows (active + closed), newest first. Each row records one visit by this player to one game server. Used by the admin player detail view and as the underlying data for the session-stats aggregate.
+     * @summary List a player\'s session history
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listSessions: (uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Delete the symmetric exemption pair between two players. Both directions are removed.
+     * @summary Remove an alt exemption
+     * @param {string} uuid Player Minecraft UUID
+     * @param {string} altPlayerUuid UUID of the alt to remove from exemption
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    removeAltExemption: (uuid: string, altPlayerUuid: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Soft-deletes a single player_punishment row that was inserted by aggressive-mode propagation. The source punishment record is untouched — only the link between this player and that punishment is removed from enforcement. Rejected with 404 if the row is DIRECT (the original punishment record) or already revoked.
+     * @summary Revoke a propagated punishment link
+     * @param {string} uuid Player Minecraft UUID (for routing/audit context; the link id is the source of truth)
+     * @param {number} playerPunishmentId player_punishment row id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    revokePropagatedLink: (uuid: string, playerPunishmentId: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Sets whether a player is exempt from aggressive-mode propagation. Flipping the flag ON also bulk-revokes every currently active PROPAGATED link for the player in the same transaction, so the player\'s enforcement state immediately reflects the cleared status. Flipping back to OFF re-enables propagation but does NOT un-revoke previously-revoked links.
+     * @summary Toggle aggressive-mode immunity
+     * @param {string} uuid Player Minecraft UUID
+     * @param {AdminSetAggressiveModeImmunityRequest} adminSetAggressiveModeImmunityRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    setAggressiveModeImmunity: (uuid: string, adminSetAggressiveModeImmunityRequest: AdminSetAggressiveModeImmunityRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Returns every subtotal (bonuses / penalties) and the underlying signal counts that fed compute_trust_factor for this player. The {@code finalScore} matches what GET /admin/player/{uuid} returns; this endpoint adds the per-component detail. Used by the admin UI \"why is this score what it is?\" tooltip. Informational only — trust factor never auto-escalates punishments.
+     * @summary Trust factor breakdown for a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    trustFactorBreakdown: (uuid: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Returns one snapshot per day (oldest first) over the requested window. Useful for trend visualization. The daily snapshot job runs at 03:00 UTC; days with no row indicate the snapshot job didn\'t run that day (e.g., outage).
+     * @summary Trust factor history for a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {number} [days] Window in days (default 30, max 365)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    trustFactorHistory: (uuid: string, days?: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * AdminPlayersApi - functional programming interface
+ */
+export declare const AdminPlayersApiFp: (configuration?: Configuration) => {
+    /**
+     * Mark another player as a known-legitimate associate (e.g. roommate). The relationship is stored symmetrically: subsequent aggressive-mode propagation skips this pair as an alt source in either direction. Finer-grained than the per-player aggressive_mode_immunity flag.
+     * @summary Add an alt exemption
+     * @param {string} uuid Player Minecraft UUID
+     * @param {AdminCreateAltExemptionRequest} adminCreateAltExemptionRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    addAltExemption(uuid: string, adminCreateAltExemptionRequest: AdminCreateAltExemptionRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * Submits an async job that walks every player row whose username is NULL and calls the Mojang profile API to resolve it. The job upserts both the player.username column and a player_username_history row. Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. The final Admin_BackfillUsernamesResponse (processed/succeeded/failed counts) lands in the job\'s result_payload on COMPLETED. Mojang rate-limits at ~1 req/sec; a backfill of many rows can run for a while — cancel is honoured between rows.
+     * @summary Start a username backfill job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    backfillUsernames(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAsyncJobStartResponse>>;
+    /**
+     * Soft-revokes every currently active PROPAGATED player_punishment row whose source matches the supplied id. Exactly one of sourcePlayerId / sourceConnectionId must be set. Useful when staff identify a single source as a false positive (e.g. shared NAT, legitimate roommate) and want to undo every link it caused in one operation.
+     * @summary Bulk-revoke PROPAGATED links by source
+     * @param {AdminBulkRevokeRequest} adminBulkRevokeRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    bulkRevokePropagated(adminBulkRevokeRequest: AdminBulkRevokeRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminBulkRevokeResponse>>;
+    /**
+     * Appends a free-form note (1–4000 chars). Notes are not editable — to revise, post a new one and soft-delete the old.
+     * @summary Create a staff note on a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {AdminCreatePlayerNoteRequest} adminCreatePlayerNoteRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createPlayerNote(uuid: string, adminCreatePlayerNoteRequest: AdminCreatePlayerNoteRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPlayerNote>>;
+    /**
+     * Marks the note as deleted but keeps the row for audit. Idempotent — 404 if already deleted or unknown id.
+     * @summary Soft-delete a staff note
+     * @param {string} uuid Player Minecraft UUID (routing only)
+     * @param {number} noteId Note id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    deletePlayerNote(uuid: string, noteId: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * Returns the connection-shared player graph reachable from this player within {depth} hops. Mirrors the propagation walk used by ALT_PROPAGATION_SWEEP — promiscuous (likely shared-NAT) connections are pruned, alt-exemption rows cut the graph at exempted players. Depth is clamped server-side at 5. Used by the admin Graph tab to render an interactive explorer.
+     * @summary Alt-graph traversal rooted at a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {number} [depth] Hop depth to walk. 1&#x3D;direct alts only; 5&#x3D;full sticky-trap radius. Default 2.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getAltGraph(uuid: string, depth?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAltGraph>>;
+    /**
+     * Returns full detail for a single player including all known usernames and punishment scoring.
+     * @summary Get player detail
+     * @param {string} uuid Player Minecraft UUID
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPlayer(uuid: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPlayerDetailResponse>>;
+    /**
+     * Other players who have been seen on at least one of this player\'s historical connections. Sorted by shared-connection count desc, then last seen desc.
+     * @summary List a player\'s alt accounts
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPlayerAlts(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminAltAccount>>;
+    /**
+     * Paginated list of every connection this player has used (latest first). Same shape as the dashboard connection list, suitable for an infinite-scroll panel inside the player detail modal.
+     * @summary List a player\'s connection history
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPlayerConnections(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminDashboardConnectionResponse>>;
+    /**
+     * Paginated list of every player_punishment row for this player — DIRECT and PROPAGATED, active and revoked. Includes the transfer_note explaining why each propagated link was inserted and the revocation audit trail. The admin UI uses this to render a punishment-history section inside the player detail modal.
+     * @summary List a player\'s full punishment history
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPlayerPunishments(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminPlayerPunishmentResponse>>;
+    /**
+     * Single-row summary: total seconds played, session count, distinct days active, most recent session start, and whether the player is currently online. Computed on demand from player_session. Feeds the trust factor system.
+     * @summary Get a player\'s aggregate session stats
+     * @param {string} uuid Player Minecraft UUID
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getSessionStats(uuid: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPlayerSessionStats>>;
+    /**
+     * Paginated list of the player\'s known-legitimate-associate exemptions. The list reflects rows where this player is the source side (player_id = this); since exemptions are stored symmetrically the reciprocal rows exist too.
+     * @summary List a player\'s alt exemptions
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listAltExemptions(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminAltExemption>>;
+    /**
+     * Paginated, newest first. Soft-deleted notes are included; the UI styles them as struck-through.
+     * @summary List staff notes on a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listPlayerNotes(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminPlayerNote>>;
+    /**
+     * Returns up to 500 players ordered by most recently seen. Optionally filter by UUID or username substring.
+     * @summary List players
+     * @param {Pageable} pageable
+     * @param {string | null} [search] Optional search string matched against UUID or username (case-insensitive substring)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listPlayers(pageable: Pageable, search?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminPlayerSummary>>;
+    /**
+     * Paginated history of player_session rows (active + closed), newest first. Each row records one visit by this player to one game server. Used by the admin player detail view and as the underlying data for the session-stats aggregate.
+     * @summary List a player\'s session history
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listSessions(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminPlayerSession>>;
+    /**
+     * Delete the symmetric exemption pair between two players. Both directions are removed.
+     * @summary Remove an alt exemption
+     * @param {string} uuid Player Minecraft UUID
+     * @param {string} altPlayerUuid UUID of the alt to remove from exemption
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    removeAltExemption(uuid: string, altPlayerUuid: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * Soft-deletes a single player_punishment row that was inserted by aggressive-mode propagation. The source punishment record is untouched — only the link between this player and that punishment is removed from enforcement. Rejected with 404 if the row is DIRECT (the original punishment record) or already revoked.
+     * @summary Revoke a propagated punishment link
+     * @param {string} uuid Player Minecraft UUID (for routing/audit context; the link id is the source of truth)
+     * @param {number} playerPunishmentId player_punishment row id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    revokePropagatedLink(uuid: string, playerPunishmentId: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * Sets whether a player is exempt from aggressive-mode propagation. Flipping the flag ON also bulk-revokes every currently active PROPAGATED link for the player in the same transaction, so the player\'s enforcement state immediately reflects the cleared status. Flipping back to OFF re-enables propagation but does NOT un-revoke previously-revoked links.
+     * @summary Toggle aggressive-mode immunity
+     * @param {string} uuid Player Minecraft UUID
+     * @param {AdminSetAggressiveModeImmunityRequest} adminSetAggressiveModeImmunityRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    setAggressiveModeImmunity(uuid: string, adminSetAggressiveModeImmunityRequest: AdminSetAggressiveModeImmunityRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPlayerDetailResponse>>;
+    /**
+     * Returns every subtotal (bonuses / penalties) and the underlying signal counts that fed compute_trust_factor for this player. The {@code finalScore} matches what GET /admin/player/{uuid} returns; this endpoint adds the per-component detail. Used by the admin UI \"why is this score what it is?\" tooltip. Informational only — trust factor never auto-escalates punishments.
+     * @summary Trust factor breakdown for a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    trustFactorBreakdown(uuid: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminTrustFactorBreakdown>>;
+    /**
+     * Returns one snapshot per day (oldest first) over the requested window. Useful for trend visualization. The daily snapshot job runs at 03:00 UTC; days with no row indicate the snapshot job didn\'t run that day (e.g., outage).
+     * @summary Trust factor history for a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {number} [days] Window in days (default 30, max 365)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    trustFactorHistory(uuid: string, days?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminTrustFactorHistoryEntry>>;
+};
+/**
+ * AdminPlayersApi - factory interface
+ */
+export declare const AdminPlayersApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Mark another player as a known-legitimate associate (e.g. roommate). The relationship is stored symmetrically: subsequent aggressive-mode propagation skips this pair as an alt source in either direction. Finer-grained than the per-player aggressive_mode_immunity flag.
+     * @summary Add an alt exemption
+     * @param {string} uuid Player Minecraft UUID
+     * @param {AdminCreateAltExemptionRequest} adminCreateAltExemptionRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    addAltExemption(uuid: string, adminCreateAltExemptionRequest: AdminCreateAltExemptionRequest, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * Submits an async job that walks every player row whose username is NULL and calls the Mojang profile API to resolve it. The job upserts both the player.username column and a player_username_history row. Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. The final Admin_BackfillUsernamesResponse (processed/succeeded/failed counts) lands in the job\'s result_payload on COMPLETED. Mojang rate-limits at ~1 req/sec; a backfill of many rows can run for a while — cancel is honoured between rows.
+     * @summary Start a username backfill job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    backfillUsernames(options?: RawAxiosRequestConfig): AxiosPromise<AdminAsyncJobStartResponse>;
+    /**
+     * Soft-revokes every currently active PROPAGATED player_punishment row whose source matches the supplied id. Exactly one of sourcePlayerId / sourceConnectionId must be set. Useful when staff identify a single source as a false positive (e.g. shared NAT, legitimate roommate) and want to undo every link it caused in one operation.
+     * @summary Bulk-revoke PROPAGATED links by source
+     * @param {AdminBulkRevokeRequest} adminBulkRevokeRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    bulkRevokePropagated(adminBulkRevokeRequest: AdminBulkRevokeRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminBulkRevokeResponse>;
+    /**
+     * Appends a free-form note (1–4000 chars). Notes are not editable — to revise, post a new one and soft-delete the old.
+     * @summary Create a staff note on a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {AdminCreatePlayerNoteRequest} adminCreatePlayerNoteRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createPlayerNote(uuid: string, adminCreatePlayerNoteRequest: AdminCreatePlayerNoteRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminPlayerNote>;
+    /**
+     * Marks the note as deleted but keeps the row for audit. Idempotent — 404 if already deleted or unknown id.
+     * @summary Soft-delete a staff note
+     * @param {string} uuid Player Minecraft UUID (routing only)
+     * @param {number} noteId Note id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    deletePlayerNote(uuid: string, noteId: number, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * Returns the connection-shared player graph reachable from this player within {depth} hops. Mirrors the propagation walk used by ALT_PROPAGATION_SWEEP — promiscuous (likely shared-NAT) connections are pruned, alt-exemption rows cut the graph at exempted players. Depth is clamped server-side at 5. Used by the admin Graph tab to render an interactive explorer.
+     * @summary Alt-graph traversal rooted at a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {number} [depth] Hop depth to walk. 1&#x3D;direct alts only; 5&#x3D;full sticky-trap radius. Default 2.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getAltGraph(uuid: string, depth?: number, options?: RawAxiosRequestConfig): AxiosPromise<AdminAltGraph>;
+    /**
+     * Returns full detail for a single player including all known usernames and punishment scoring.
+     * @summary Get player detail
+     * @param {string} uuid Player Minecraft UUID
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPlayer(uuid: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminPlayerDetailResponse>;
+    /**
+     * Other players who have been seen on at least one of this player\'s historical connections. Sorted by shared-connection count desc, then last seen desc.
+     * @summary List a player\'s alt accounts
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPlayerAlts(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminAltAccount>;
+    /**
+     * Paginated list of every connection this player has used (latest first). Same shape as the dashboard connection list, suitable for an infinite-scroll panel inside the player detail modal.
+     * @summary List a player\'s connection history
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPlayerConnections(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminDashboardConnectionResponse>;
+    /**
+     * Paginated list of every player_punishment row for this player — DIRECT and PROPAGATED, active and revoked. Includes the transfer_note explaining why each propagated link was inserted and the revocation audit trail. The admin UI uses this to render a punishment-history section inside the player detail modal.
+     * @summary List a player\'s full punishment history
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPlayerPunishments(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminPlayerPunishmentResponse>;
+    /**
+     * Single-row summary: total seconds played, session count, distinct days active, most recent session start, and whether the player is currently online. Computed on demand from player_session. Feeds the trust factor system.
+     * @summary Get a player\'s aggregate session stats
+     * @param {string} uuid Player Minecraft UUID
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getSessionStats(uuid: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminPlayerSessionStats>;
+    /**
+     * Paginated list of the player\'s known-legitimate-associate exemptions. The list reflects rows where this player is the source side (player_id = this); since exemptions are stored symmetrically the reciprocal rows exist too.
+     * @summary List a player\'s alt exemptions
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listAltExemptions(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminAltExemption>;
+    /**
+     * Paginated, newest first. Soft-deleted notes are included; the UI styles them as struck-through.
+     * @summary List staff notes on a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listPlayerNotes(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminPlayerNote>;
+    /**
+     * Returns up to 500 players ordered by most recently seen. Optionally filter by UUID or username substring.
+     * @summary List players
+     * @param {Pageable} pageable
+     * @param {string | null} [search] Optional search string matched against UUID or username (case-insensitive substring)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listPlayers(pageable: Pageable, search?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminPlayerSummary>;
+    /**
+     * Paginated history of player_session rows (active + closed), newest first. Each row records one visit by this player to one game server. Used by the admin player detail view and as the underlying data for the session-stats aggregate.
+     * @summary List a player\'s session history
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listSessions(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminPlayerSession>;
+    /**
+     * Delete the symmetric exemption pair between two players. Both directions are removed.
+     * @summary Remove an alt exemption
+     * @param {string} uuid Player Minecraft UUID
+     * @param {string} altPlayerUuid UUID of the alt to remove from exemption
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    removeAltExemption(uuid: string, altPlayerUuid: string, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * Soft-deletes a single player_punishment row that was inserted by aggressive-mode propagation. The source punishment record is untouched — only the link between this player and that punishment is removed from enforcement. Rejected with 404 if the row is DIRECT (the original punishment record) or already revoked.
+     * @summary Revoke a propagated punishment link
+     * @param {string} uuid Player Minecraft UUID (for routing/audit context; the link id is the source of truth)
+     * @param {number} playerPunishmentId player_punishment row id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    revokePropagatedLink(uuid: string, playerPunishmentId: number, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * Sets whether a player is exempt from aggressive-mode propagation. Flipping the flag ON also bulk-revokes every currently active PROPAGATED link for the player in the same transaction, so the player\'s enforcement state immediately reflects the cleared status. Flipping back to OFF re-enables propagation but does NOT un-revoke previously-revoked links.
+     * @summary Toggle aggressive-mode immunity
+     * @param {string} uuid Player Minecraft UUID
+     * @param {AdminSetAggressiveModeImmunityRequest} adminSetAggressiveModeImmunityRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    setAggressiveModeImmunity(uuid: string, adminSetAggressiveModeImmunityRequest: AdminSetAggressiveModeImmunityRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminPlayerDetailResponse>;
+    /**
+     * Returns every subtotal (bonuses / penalties) and the underlying signal counts that fed compute_trust_factor for this player. The {@code finalScore} matches what GET /admin/player/{uuid} returns; this endpoint adds the per-component detail. Used by the admin UI \"why is this score what it is?\" tooltip. Informational only — trust factor never auto-escalates punishments.
+     * @summary Trust factor breakdown for a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    trustFactorBreakdown(uuid: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminTrustFactorBreakdown>;
+    /**
+     * Returns one snapshot per day (oldest first) over the requested window. Useful for trend visualization. The daily snapshot job runs at 03:00 UTC; days with no row indicate the snapshot job didn\'t run that day (e.g., outage).
+     * @summary Trust factor history for a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {number} [days] Window in days (default 30, max 365)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    trustFactorHistory(uuid: string, days?: number, options?: RawAxiosRequestConfig): AxiosPromise<AdminTrustFactorHistoryEntry>;
+};
+/**
+ * AdminPlayersApi - object-oriented interface
+ */
+export declare class AdminPlayersApi extends BaseAPI {
+    /**
+     * Mark another player as a known-legitimate associate (e.g. roommate). The relationship is stored symmetrically: subsequent aggressive-mode propagation skips this pair as an alt source in either direction. Finer-grained than the per-player aggressive_mode_immunity flag.
+     * @summary Add an alt exemption
+     * @param {string} uuid Player Minecraft UUID
+     * @param {AdminCreateAltExemptionRequest} adminCreateAltExemptionRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    addAltExemption(uuid: string, adminCreateAltExemptionRequest: AdminCreateAltExemptionRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     * Submits an async job that walks every player row whose username is NULL and calls the Mojang profile API to resolve it. The job upserts both the player.username column and a player_username_history row. Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. The final Admin_BackfillUsernamesResponse (processed/succeeded/failed counts) lands in the job\'s result_payload on COMPLETED. Mojang rate-limits at ~1 req/sec; a backfill of many rows can run for a while — cancel is honoured between rows.
+     * @summary Start a username backfill job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    backfillUsernames(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAsyncJobStartResponse, any, {}>>;
+    /**
+     * Soft-revokes every currently active PROPAGATED player_punishment row whose source matches the supplied id. Exactly one of sourcePlayerId / sourceConnectionId must be set. Useful when staff identify a single source as a false positive (e.g. shared NAT, legitimate roommate) and want to undo every link it caused in one operation.
+     * @summary Bulk-revoke PROPAGATED links by source
+     * @param {AdminBulkRevokeRequest} adminBulkRevokeRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    bulkRevokePropagated(adminBulkRevokeRequest: AdminBulkRevokeRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminBulkRevokeResponse, any, {}>>;
+    /**
+     * Appends a free-form note (1–4000 chars). Notes are not editable — to revise, post a new one and soft-delete the old.
+     * @summary Create a staff note on a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {AdminCreatePlayerNoteRequest} adminCreatePlayerNoteRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createPlayerNote(uuid: string, adminCreatePlayerNoteRequest: AdminCreatePlayerNoteRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPlayerNote, any, {}>>;
+    /**
+     * Marks the note as deleted but keeps the row for audit. Idempotent — 404 if already deleted or unknown id.
+     * @summary Soft-delete a staff note
+     * @param {string} uuid Player Minecraft UUID (routing only)
+     * @param {number} noteId Note id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    deletePlayerNote(uuid: string, noteId: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     * Returns the connection-shared player graph reachable from this player within {depth} hops. Mirrors the propagation walk used by ALT_PROPAGATION_SWEEP — promiscuous (likely shared-NAT) connections are pruned, alt-exemption rows cut the graph at exempted players. Depth is clamped server-side at 5. Used by the admin Graph tab to render an interactive explorer.
+     * @summary Alt-graph traversal rooted at a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {number} [depth] Hop depth to walk. 1&#x3D;direct alts only; 5&#x3D;full sticky-trap radius. Default 2.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getAltGraph(uuid: string, depth?: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAltGraph, any, {}>>;
+    /**
+     * Returns full detail for a single player including all known usernames and punishment scoring.
+     * @summary Get player detail
+     * @param {string} uuid Player Minecraft UUID
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    listConnections(createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminDashboardConnectionResponse[], any, {}>>;
+    getPlayer(uuid: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPlayerDetailResponse, any, {}>>;
     /**
-     * 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
+     * Other players who have been seen on at least one of this player\'s historical connections. Sorted by shared-connection count desc, then last seen desc.
+     * @summary List a player\'s alt accounts
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    recheckService(connectionId: number, service: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminConnectionCheckResult, any, {}>>;
-}
-/**
- * AdminDashboardApi - axios parameter creator
- */
-export declare const AdminDashboardApiAxiosParamCreator: (configuration?: Configuration) => {
+    getPlayerAlts(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PageAdminAltAccount, any, {}>>;
     /**
-     * Returns aggregate counts for clients, connections, and players in the system.
-     * @summary Get dashboard statistics
+     * Paginated list of every connection this player has used (latest first). Same shape as the dashboard connection list, suitable for an infinite-scroll panel inside the player detail modal.
+     * @summary List a player\'s connection history
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    dashboardStats: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
-};
-/**
- * AdminDashboardApi - functional programming interface
- */
-export declare const AdminDashboardApiFp: (configuration?: Configuration) => {
+    getPlayerConnections(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PageAdminDashboardConnectionResponse, any, {}>>;
     /**
-     * Returns aggregate counts for clients, connections, and players in the system.
-     * @summary Get dashboard statistics
+     * Paginated list of every player_punishment row for this player — DIRECT and PROPAGATED, active and revoked. Includes the transfer_note explaining why each propagated link was inserted and the revocation audit trail. The admin UI uses this to render a punishment-history section inside the player detail modal.
+     * @summary List a player\'s full punishment history
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    dashboardStats(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminGetDashboardStats>>;
-};
-/**
- * AdminDashboardApi - factory interface
- */
-export declare const AdminDashboardApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    getPlayerPunishments(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PageAdminPlayerPunishmentResponse, any, {}>>;
     /**
-     * Returns aggregate counts for clients, connections, and players in the system.
-     * @summary Get dashboard statistics
+     * Single-row summary: total seconds played, session count, distinct days active, most recent session start, and whether the player is currently online. Computed on demand from player_session. Feeds the trust factor system.
+     * @summary Get a player\'s aggregate session stats
+     * @param {string} uuid Player Minecraft UUID
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    dashboardStats(options?: RawAxiosRequestConfig): AxiosPromise<AdminGetDashboardStats>;
-};
-/**
- * AdminDashboardApi - object-oriented interface
- */
-export declare class AdminDashboardApi extends BaseAPI {
+    getSessionStats(uuid: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPlayerSessionStats, any, {}>>;
     /**
-     * Returns aggregate counts for clients, connections, and players in the system.
-     * @summary Get dashboard statistics
+     * Paginated list of the player\'s known-legitimate-associate exemptions. The list reflects rows where this player is the source side (player_id = this); since exemptions are stored symmetrically the reciprocal rows exist too.
+     * @summary List a player\'s alt exemptions
+     * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    dashboardStats(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminGetDashboardStats, any, {}>>;
-}
-/**
- * AdminPlayersApi - axios parameter creator
- */
-export declare const AdminPlayersApiAxiosParamCreator: (configuration?: Configuration) => {
+    listAltExemptions(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PageAdminAltExemption, any, {}>>;
     /**
-     * Returns full detail for a single player including all known usernames and punishment scoring.
-     * @summary Get player detail
+     * Paginated, newest first. Soft-deleted notes are included; the UI styles them as struck-through.
+     * @summary List staff notes on a player
      * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getPlayer: (uuid: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    listPlayerNotes(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PageAdminPlayerNote, any, {}>>;
     /**
      * Returns up to 500 players ordered by most recently seen. Optionally filter by UUID or username substring.
      * @summary List players
-     * @param {number} page Page number (1-indexed)
-     * @param {number} limit Page size
+     * @param {Pageable} pageable
      * @param {string | null} [search] Optional search string matched against UUID or username (case-insensitive substring)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    listPlayers: (page: number, limit: number, search?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
-};
-/**
- * AdminPlayersApi - functional programming interface
- */
-export declare const AdminPlayersApiFp: (configuration?: Configuration) => {
+    listPlayers(pageable: Pageable, search?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PageAdminPlayerSummary, any, {}>>;
     /**
-     * Returns full detail for a single player including all known usernames and punishment scoring.
-     * @summary Get player detail
+     * Paginated history of player_session rows (active + closed), newest first. Each row records one visit by this player to one game server. Used by the admin player detail view and as the underlying data for the session-stats aggregate.
+     * @summary List a player\'s session history
      * @param {string} uuid Player Minecraft UUID
+     * @param {Pageable} pageable
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getPlayer(uuid: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPlayerDetailResponse>>;
+    listSessions(uuid: string, pageable: Pageable, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PageAdminPlayerSession, any, {}>>;
     /**
-     * Returns up to 500 players ordered by most recently seen. Optionally filter by UUID or username substring.
-     * @summary List players
-     * @param {number} page Page number (1-indexed)
-     * @param {number} limit Page size
-     * @param {string | null} [search] Optional search string matched against UUID or username (case-insensitive substring)
+     * Delete the symmetric exemption pair between two players. Both directions are removed.
+     * @summary Remove an alt exemption
+     * @param {string} uuid Player Minecraft UUID
+     * @param {string} altPlayerUuid UUID of the alt to remove from exemption
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    listPlayers(page: number, limit: number, search?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPagedPlayerResponse>>;
-};
-/**
- * AdminPlayersApi - factory interface
- */
-export declare const AdminPlayersApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    removeAltExemption(uuid: string, altPlayerUuid: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
     /**
-     * Returns full detail for a single player including all known usernames and punishment scoring.
-     * @summary Get player detail
-     * @param {string} uuid Player Minecraft UUID
+     * Soft-deletes a single player_punishment row that was inserted by aggressive-mode propagation. The source punishment record is untouched — only the link between this player and that punishment is removed from enforcement. Rejected with 404 if the row is DIRECT (the original punishment record) or already revoked.
+     * @summary Revoke a propagated punishment link
+     * @param {string} uuid Player Minecraft UUID (for routing/audit context; the link id is the source of truth)
+     * @param {number} playerPunishmentId player_punishment row id
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getPlayer(uuid: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminPlayerDetailResponse>;
+    revokePropagatedLink(uuid: string, playerPunishmentId: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
     /**
-     * Returns up to 500 players ordered by most recently seen. Optionally filter by UUID or username substring.
-     * @summary List players
-     * @param {number} page Page number (1-indexed)
-     * @param {number} limit Page size
-     * @param {string | null} [search] Optional search string matched against UUID or username (case-insensitive substring)
+     * Sets whether a player is exempt from aggressive-mode propagation. Flipping the flag ON also bulk-revokes every currently active PROPAGATED link for the player in the same transaction, so the player\'s enforcement state immediately reflects the cleared status. Flipping back to OFF re-enables propagation but does NOT un-revoke previously-revoked links.
+     * @summary Toggle aggressive-mode immunity
+     * @param {string} uuid Player Minecraft UUID
+     * @param {AdminSetAggressiveModeImmunityRequest} adminSetAggressiveModeImmunityRequest
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    listPlayers(page: number, limit: number, search?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<AdminPagedPlayerResponse>;
-};
-/**
- * AdminPlayersApi - object-oriented interface
- */
-export declare class AdminPlayersApi extends BaseAPI {
+    setAggressiveModeImmunity(uuid: string, adminSetAggressiveModeImmunityRequest: AdminSetAggressiveModeImmunityRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPlayerDetailResponse, any, {}>>;
     /**
-     * Returns full detail for a single player including all known usernames and punishment scoring.
-     * @summary Get player detail
+     * Returns every subtotal (bonuses / penalties) and the underlying signal counts that fed compute_trust_factor for this player. The {@code finalScore} matches what GET /admin/player/{uuid} returns; this endpoint adds the per-component detail. Used by the admin UI \"why is this score what it is?\" tooltip. Informational only — trust factor never auto-escalates punishments.
+     * @summary Trust factor breakdown for a player
      * @param {string} uuid Player Minecraft UUID
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getPlayer(uuid: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPlayerDetailResponse, any, {}>>;
+    trustFactorBreakdown(uuid: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminTrustFactorBreakdown, any, {}>>;
     /**
-     * Returns up to 500 players ordered by most recently seen. Optionally filter by UUID or username substring.
-     * @summary List players
-     * @param {number} page Page number (1-indexed)
-     * @param {number} limit Page size
-     * @param {string | null} [search] Optional search string matched against UUID or username (case-insensitive substring)
+     * Returns one snapshot per day (oldest first) over the requested window. Useful for trend visualization. The daily snapshot job runs at 03:00 UTC; days with no row indicate the snapshot job didn\'t run that day (e.g., outage).
+     * @summary Trust factor history for a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {number} [days] Window in days (default 30, max 365)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    listPlayers(page: number, limit: number, search?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPagedPlayerResponse, any, {}>>;
+    trustFactorHistory(uuid: string, days?: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminTrustFactorHistoryEntry, any, {}>>;
 }
 /**
  * AdminPunishmentsApi - axios parameter creator
@@ -1431,21 +3448,44 @@ export declare const AdminPunishmentsApiAxiosParamCreator: (configuration?: Conf
      * @throws {RequiredError}
      */
     createDraft: (adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Partial update of a punishment record. Reason / notes / expiresAt are mutable; severity is intentionally immutable to keep the punishment score deterministic. To make a punishment permanent, set forcePermanent=true. The endpoint returns 404 if the id doesn\'t exist, 200 with the updated entity otherwise. Every edit is recorded in admin_audit_log with the before/after payload.
+     * @summary Edit a punishment
+     * @param {number} id Punishment id
+     * @param {AdminUpdatePunishmentRequest} adminUpdatePunishmentRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    editPunishment: (id: number, adminUpdatePunishmentRequest: AdminUpdatePunishmentRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Returns the active DIRECT player_punishment UUIDs and the live connection_punishment IPs for a punishment. Used by the admin edit dialog to render the editable participant list. PROPAGATED links are excluded — they\'re an enforcement detail, not part of \'who the admin attached to this punishment\'.
+     * @summary List a punishment\'s current participants
+     * @param {number} id Punishment id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPunishmentTargets: (id: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
      * @summary List punishments
-     * @param {number} page Page number (1-indexed)
-     * @param {number} limit Page size
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {string | null} [username] Filter by player username (case-insensitive substring match)
-     * @param {string | null} [ipAddress] Filter by IP address
-     * @param {Array<PunishmentType> | null} [type] Filter by punishment type. Repeatable.
-     * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (ms)
-     * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (ms)
+     * @param {Pageable} pageable
+     * @param {string | null} [uuid]
+     * @param {string | null} [username]
+     * @param {string | null} [ipAddress]
+     * @param {Array<PunishmentType> | null} [type]
+     * @param {number | null} [issuedAfter]
+     * @param {number | null} [issuedBefore]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getPunishments: (page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    getPunishments: (pageable: Pageable, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Submits an async job that walks every player and re-runs the aggressive-mode propagation logic (tier-1 own-IP plus tier-2 alt-driven). Useful after toggling aggressive-mode on, or after a propagation-rule change, to backfill PROPAGATED player_punishment rows that would otherwise only appear on each player\'s next login. Idempotent — ON CONFLICT DO NOTHING. Returns immediately with a job id; poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel.
+     * @summary Start an alt-propagation sweep job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    propagationSweep: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Search for players by UUID or username, or look up all players associated with an IP address.
      * @summary Search punishment targets
@@ -1475,21 +3515,44 @@ export declare const AdminPunishmentsApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     createDraft(adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPunishmentDraftResponse>>;
+    /**
+     * Partial update of a punishment record. Reason / notes / expiresAt are mutable; severity is intentionally immutable to keep the punishment score deterministic. To make a punishment permanent, set forcePermanent=true. The endpoint returns 404 if the id doesn\'t exist, 200 with the updated entity otherwise. Every edit is recorded in admin_audit_log with the before/after payload.
+     * @summary Edit a punishment
+     * @param {number} id Punishment id
+     * @param {AdminUpdatePunishmentRequest} adminUpdatePunishmentRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    editPunishment(id: number, adminUpdatePunishmentRequest: AdminUpdatePunishmentRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * Returns the active DIRECT player_punishment UUIDs and the live connection_punishment IPs for a punishment. Used by the admin edit dialog to render the editable participant list. PROPAGATED links are excluded — they\'re an enforcement detail, not part of \'who the admin attached to this punishment\'.
+     * @summary List a punishment\'s current participants
+     * @param {number} id Punishment id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPunishmentTargets(id: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPunishmentTargets>>;
     /**
      * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
      * @summary List punishments
-     * @param {number} page Page number (1-indexed)
-     * @param {number} limit Page size
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {string | null} [username] Filter by player username (case-insensitive substring match)
-     * @param {string | null} [ipAddress] Filter by IP address
-     * @param {Array<PunishmentType> | null} [type] Filter by punishment type. Repeatable.
-     * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (ms)
-     * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (ms)
+     * @param {Pageable} pageable
+     * @param {string | null} [uuid]
+     * @param {string | null} [username]
+     * @param {string | null} [ipAddress]
+     * @param {Array<PunishmentType> | null} [type]
+     * @param {number | null} [issuedAfter]
+     * @param {number | null} [issuedBefore]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPunishments(pageable: Pageable, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminPunishmentListItem>>;
+    /**
+     * Submits an async job that walks every player and re-runs the aggressive-mode propagation logic (tier-1 own-IP plus tier-2 alt-driven). Useful after toggling aggressive-mode on, or after a propagation-rule change, to backfill PROPAGATED player_punishment rows that would otherwise only appear on each player\'s next login. Idempotent — ON CONFLICT DO NOTHING. Returns immediately with a job id; poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel.
+     * @summary Start an alt-propagation sweep job
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getPunishments(page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPagedPunishmentResponse>>;
+    propagationSweep(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAsyncJobStartResponse>>;
     /**
      * Search for players by UUID or username, or look up all players associated with an IP address.
      * @summary Search punishment targets
@@ -1519,21 +3582,44 @@ export declare const AdminPunishmentsApiFactory: (configuration?: Configuration,
      * @throws {RequiredError}
      */
     createDraft(adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminPunishmentDraftResponse>;
+    /**
+     * Partial update of a punishment record. Reason / notes / expiresAt are mutable; severity is intentionally immutable to keep the punishment score deterministic. To make a punishment permanent, set forcePermanent=true. The endpoint returns 404 if the id doesn\'t exist, 200 with the updated entity otherwise. Every edit is recorded in admin_audit_log with the before/after payload.
+     * @summary Edit a punishment
+     * @param {number} id Punishment id
+     * @param {AdminUpdatePunishmentRequest} adminUpdatePunishmentRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    editPunishment(id: number, adminUpdatePunishmentRequest: AdminUpdatePunishmentRequest, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * Returns the active DIRECT player_punishment UUIDs and the live connection_punishment IPs for a punishment. Used by the admin edit dialog to render the editable participant list. PROPAGATED links are excluded — they\'re an enforcement detail, not part of \'who the admin attached to this punishment\'.
+     * @summary List a punishment\'s current participants
+     * @param {number} id Punishment id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPunishmentTargets(id: number, options?: RawAxiosRequestConfig): AxiosPromise<AdminPunishmentTargets>;
     /**
      * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
      * @summary List punishments
-     * @param {number} page Page number (1-indexed)
-     * @param {number} limit Page size
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {string | null} [username] Filter by player username (case-insensitive substring match)
-     * @param {string | null} [ipAddress] Filter by IP address
-     * @param {Array<PunishmentType> | null} [type] Filter by punishment type. Repeatable.
-     * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (ms)
-     * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (ms)
+     * @param {Pageable} pageable
+     * @param {string | null} [uuid]
+     * @param {string | null} [username]
+     * @param {string | null} [ipAddress]
+     * @param {Array<PunishmentType> | null} [type]
+     * @param {number | null} [issuedAfter]
+     * @param {number | null} [issuedBefore]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getPunishments(page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<AdminPagedPunishmentResponse>;
+    getPunishments(pageable: Pageable, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminPunishmentListItem>;
+    /**
+     * Submits an async job that walks every player and re-runs the aggressive-mode propagation logic (tier-1 own-IP plus tier-2 alt-driven). Useful after toggling aggressive-mode on, or after a propagation-rule change, to backfill PROPAGATED player_punishment rows that would otherwise only appear on each player\'s next login. Idempotent — ON CONFLICT DO NOTHING. Returns immediately with a job id; poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel.
+     * @summary Start an alt-propagation sweep job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    propagationSweep(options?: RawAxiosRequestConfig): AxiosPromise<AdminAsyncJobStartResponse>;
     /**
      * Search for players by UUID or username, or look up all players associated with an IP address.
      * @summary Search punishment targets
@@ -1563,21 +3649,44 @@ export declare class AdminPunishmentsApi extends BaseAPI {
      * @throws {RequiredError}
      */
     createDraft(adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPunishmentDraftResponse, any, {}>>;
+    /**
+     * Partial update of a punishment record. Reason / notes / expiresAt are mutable; severity is intentionally immutable to keep the punishment score deterministic. To make a punishment permanent, set forcePermanent=true. The endpoint returns 404 if the id doesn\'t exist, 200 with the updated entity otherwise. Every edit is recorded in admin_audit_log with the before/after payload.
+     * @summary Edit a punishment
+     * @param {number} id Punishment id
+     * @param {AdminUpdatePunishmentRequest} adminUpdatePunishmentRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    editPunishment(id: number, adminUpdatePunishmentRequest: AdminUpdatePunishmentRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     * Returns the active DIRECT player_punishment UUIDs and the live connection_punishment IPs for a punishment. Used by the admin edit dialog to render the editable participant list. PROPAGATED links are excluded — they\'re an enforcement detail, not part of \'who the admin attached to this punishment\'.
+     * @summary List a punishment\'s current participants
+     * @param {number} id Punishment id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPunishmentTargets(id: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPunishmentTargets, any, {}>>;
     /**
      * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
      * @summary List punishments
-     * @param {number} page Page number (1-indexed)
-     * @param {number} limit Page size
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {string | null} [username] Filter by player username (case-insensitive substring match)
-     * @param {string | null} [ipAddress] Filter by IP address
-     * @param {Array<PunishmentType> | null} [type] Filter by punishment type. Repeatable.
-     * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (ms)
-     * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (ms)
+     * @param {Pageable} pageable
+     * @param {string | null} [uuid]
+     * @param {string | null} [username]
+     * @param {string | null} [ipAddress]
+     * @param {Array<PunishmentType> | null} [type]
+     * @param {number | null} [issuedAfter]
+     * @param {number | null} [issuedBefore]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPunishments(pageable: Pageable, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PageAdminPunishmentListItem, any, {}>>;
+    /**
+     * Submits an async job that walks every player and re-runs the aggressive-mode propagation logic (tier-1 own-IP plus tier-2 alt-driven). Useful after toggling aggressive-mode on, or after a propagation-rule change, to backfill PROPAGATED player_punishment rows that would otherwise only appear on each player\'s next login. Idempotent — ON CONFLICT DO NOTHING. Returns immediately with a job id; poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel.
+     * @summary Start an alt-propagation sweep job
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getPunishments(page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPagedPunishmentResponse, any, {}>>;
+    propagationSweep(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAsyncJobStartResponse, any, {}>>;
     /**
      * Search for players by UUID or username, or look up all players associated with an IP address.
      * @summary Search punishment targets
@@ -1587,6 +3696,102 @@ export declare class AdminPunishmentsApi extends BaseAPI {
      */
     searchTargets(q: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPunishmentSearchResponse, any, {}>>;
 }
+/**
+ * AdminReportsApi - axios parameter creator
+ */
+export declare const AdminReportsApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Paginated, newest first. Use openOnly=true to see the triage queue; reportedUuid filters to one player.
+     * @summary List reports
+     * @param {Pageable} pageable
+     * @param {string | null} [reportedUuid] Filter to reports targeting this player UUID
+     * @param {boolean} [openOnly]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    list1: (pageable: Pageable, reportedUuid?: string | null, openOnly?: boolean, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Marks the report resolved with the staff member\'s note. 404 if already resolved or unknown id.
+     * @summary Resolve a report
+     * @param {number} id Report id
+     * @param {AdminResolveReportRequest} adminResolveReportRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    resolve: (id: number, adminResolveReportRequest: AdminResolveReportRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * AdminReportsApi - functional programming interface
+ */
+export declare const AdminReportsApiFp: (configuration?: Configuration) => {
+    /**
+     * Paginated, newest first. Use openOnly=true to see the triage queue; reportedUuid filters to one player.
+     * @summary List reports
+     * @param {Pageable} pageable
+     * @param {string | null} [reportedUuid] Filter to reports targeting this player UUID
+     * @param {boolean} [openOnly]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    list1(pageable: Pageable, reportedUuid?: string | null, openOnly?: boolean, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminPlayerReport>>;
+    /**
+     * Marks the report resolved with the staff member\'s note. 404 if already resolved or unknown id.
+     * @summary Resolve a report
+     * @param {number} id Report id
+     * @param {AdminResolveReportRequest} adminResolveReportRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    resolve(id: number, adminResolveReportRequest: AdminResolveReportRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+};
+/**
+ * AdminReportsApi - factory interface
+ */
+export declare const AdminReportsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Paginated, newest first. Use openOnly=true to see the triage queue; reportedUuid filters to one player.
+     * @summary List reports
+     * @param {Pageable} pageable
+     * @param {string | null} [reportedUuid] Filter to reports targeting this player UUID
+     * @param {boolean} [openOnly]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    list1(pageable: Pageable, reportedUuid?: string | null, openOnly?: boolean, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminPlayerReport>;
+    /**
+     * Marks the report resolved with the staff member\'s note. 404 if already resolved or unknown id.
+     * @summary Resolve a report
+     * @param {number} id Report id
+     * @param {AdminResolveReportRequest} adminResolveReportRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    resolve(id: number, adminResolveReportRequest: AdminResolveReportRequest, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+};
+/**
+ * AdminReportsApi - object-oriented interface
+ */
+export declare class AdminReportsApi extends BaseAPI {
+    /**
+     * Paginated, newest first. Use openOnly=true to see the triage queue; reportedUuid filters to one player.
+     * @summary List reports
+     * @param {Pageable} pageable
+     * @param {string | null} [reportedUuid] Filter to reports targeting this player UUID
+     * @param {boolean} [openOnly]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    list1(pageable: Pageable, reportedUuid?: string | null, openOnly?: boolean, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PageAdminPlayerReport, any, {}>>;
+    /**
+     * Marks the report resolved with the staff member\'s note. 404 if already resolved or unknown id.
+     * @summary Resolve a report
+     * @param {number} id Report id
+     * @param {AdminResolveReportRequest} adminResolveReportRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    resolve(id: number, adminResolveReportRequest: AdminResolveReportRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+}
 /**
  * AuthenticationApi - axios parameter creator
  */
@@ -1746,13 +3951,13 @@ export declare const ChatApiAxiosParamCreator: (configuration?: Configuration) =
     /**
      * Returns up to `limit` chat messages before the given `before` timestamp (keyset pagination). Results are returned in ascending chronological order. Omit `before` to start from the current time. Scroll back through history by passing the `sentAt` of the oldest message received as the next `before` value.
      * @summary Get chat history
-     * @param {number} limit Maximum number of messages to return (1–100)
      * @param {string | null} [sessionId] Filter to a specific server session. Omit for global history.
      * @param {string | null} [before] ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now.
+     * @param {number} [limit] Maximum number of messages to return (1–100)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    history: (limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    history: (sessionId?: string | null, before?: string | null, limit?: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Stores a chat message from a game server and fans it out to all connected WebSocket clients via PostgreSQL LISTEN/NOTIFY. The session must be currently online. Only the player UUID is stored — usernames are resolved on the web UI from the player database cache.
      * @summary Ingest a chat message
@@ -1769,13 +3974,13 @@ export declare const ChatApiFp: (configuration?: Configuration) => {
     /**
      * Returns up to `limit` chat messages before the given `before` timestamp (keyset pagination). Results are returned in ascending chronological order. Omit `before` to start from the current time. Scroll back through history by passing the `sentAt` of the oldest message received as the next `before` value.
      * @summary Get chat history
-     * @param {number} limit Maximum number of messages to return (1–100)
      * @param {string | null} [sessionId] Filter to a specific server session. Omit for global history.
      * @param {string | null} [before] ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now.
+     * @param {number} [limit] Maximum number of messages to return (1–100)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    history(limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<ChatMessageDTO>>>;
+    history(sessionId?: string | null, before?: string | null, limit?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<ChatMessageDTO>>>;
     /**
      * Stores a chat message from a game server and fans it out to all connected WebSocket clients via PostgreSQL LISTEN/NOTIFY. The session must be currently online. Only the player UUID is stored — usernames are resolved on the web UI from the player database cache.
      * @summary Ingest a chat message
@@ -1792,13 +3997,13 @@ export declare const ChatApiFactory: (configuration?: Configuration, basePath?:
     /**
      * Returns up to `limit` chat messages before the given `before` timestamp (keyset pagination). Results are returned in ascending chronological order. Omit `before` to start from the current time. Scroll back through history by passing the `sentAt` of the oldest message received as the next `before` value.
      * @summary Get chat history
-     * @param {number} limit Maximum number of messages to return (1–100)
      * @param {string | null} [sessionId] Filter to a specific server session. Omit for global history.
      * @param {string | null} [before] ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now.
+     * @param {number} [limit] Maximum number of messages to return (1–100)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    history(limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<ChatMessageDTO>>;
+    history(sessionId?: string | null, before?: string | null, limit?: number, options?: RawAxiosRequestConfig): AxiosPromise<Array<ChatMessageDTO>>;
     /**
      * Stores a chat message from a game server and fans it out to all connected WebSocket clients via PostgreSQL LISTEN/NOTIFY. The session must be currently online. Only the player UUID is stored — usernames are resolved on the web UI from the player database cache.
      * @summary Ingest a chat message
@@ -1815,13 +4020,13 @@ export declare class ChatApi extends BaseAPI {
     /**
      * Returns up to `limit` chat messages before the given `before` timestamp (keyset pagination). Results are returned in ascending chronological order. Omit `before` to start from the current time. Scroll back through history by passing the `sentAt` of the oldest message received as the next `before` value.
      * @summary Get chat history
-     * @param {number} limit Maximum number of messages to return (1–100)
      * @param {string | null} [sessionId] Filter to a specific server session. Omit for global history.
      * @param {string | null} [before] ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now.
+     * @param {number} [limit] Maximum number of messages to return (1–100)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    history(limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ChatMessageDTO[], any, {}>>;
+    history(sessionId?: string | null, before?: string | null, limit?: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ChatMessageDTO[], any, {}>>;
     /**
      * Stores a chat message from a game server and fans it out to all connected WebSocket clients via PostgreSQL LISTEN/NOTIFY. The session must be currently online. Only the player UUID is stored — usernames are resolved on the web UI from the player database cache.
      * @summary Ingest a chat message
@@ -1836,60 +4041,64 @@ export declare class ChatApi extends BaseAPI {
  */
 export declare const ConnectionApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
-     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
-     * @summary Check Connection and Detect VPN/Proxy
+     * **DEPRECATED for game-server player-join flows.** Use `POST /v1/player-session/start` instead — it runs the same authorization check AND opens the player_session row in a single round-trip, returning the same connection / player / punishment context plus aggregate session stats.  This endpoint remains available for admin and debugging scenarios where you want to inspect a connection\'s state without opening a session (e.g. one-off lookups, batch sweeps, support troubleshooting).  Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
+     * @summary Check Connection and Detect VPN/Proxy (DEPRECATED for player-join use)
      * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
-     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
+     * @param {boolean} [forceRecheck] When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
      * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response.
      * @param {*} [options] Override http request option.
+     * @deprecated
      * @throws {RequiredError}
      */
-    getConnectionDetails: (ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    getConnectionDetails: (ip: string, forceRecheck?: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
 };
 /**
  * ConnectionApi - functional programming interface
  */
 export declare const ConnectionApiFp: (configuration?: Configuration) => {
     /**
-     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
-     * @summary Check Connection and Detect VPN/Proxy
+     * **DEPRECATED for game-server player-join flows.** Use `POST /v1/player-session/start` instead — it runs the same authorization check AND opens the player_session row in a single round-trip, returning the same connection / player / punishment context plus aggregate session stats.  This endpoint remains available for admin and debugging scenarios where you want to inspect a connection\'s state without opening a session (e.g. one-off lookups, batch sweeps, support troubleshooting).  Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
+     * @summary Check Connection and Detect VPN/Proxy (DEPRECATED for player-join use)
      * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
-     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
+     * @param {boolean} [forceRecheck] When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
      * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response.
      * @param {*} [options] Override http request option.
+     * @deprecated
      * @throws {RequiredError}
      */
-    getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ConnectionGetConnectionDetailsResponse>>;
+    getConnectionDetails(ip: string, forceRecheck?: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ConnectionGetConnectionDetailsResponse>>;
 };
 /**
  * ConnectionApi - factory interface
  */
 export declare const ConnectionApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
-     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
-     * @summary Check Connection and Detect VPN/Proxy
+     * **DEPRECATED for game-server player-join flows.** Use `POST /v1/player-session/start` instead — it runs the same authorization check AND opens the player_session row in a single round-trip, returning the same connection / player / punishment context plus aggregate session stats.  This endpoint remains available for admin and debugging scenarios where you want to inspect a connection\'s state without opening a session (e.g. one-off lookups, batch sweeps, support troubleshooting).  Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
+     * @summary Check Connection and Detect VPN/Proxy (DEPRECATED for player-join use)
      * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
-     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
+     * @param {boolean} [forceRecheck] When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
      * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response.
      * @param {*} [options] Override http request option.
+     * @deprecated
      * @throws {RequiredError}
      */
-    getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<ConnectionGetConnectionDetailsResponse>;
+    getConnectionDetails(ip: string, forceRecheck?: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<ConnectionGetConnectionDetailsResponse>;
 };
 /**
  * ConnectionApi - object-oriented interface
  */
 export declare class ConnectionApi extends BaseAPI {
     /**
-     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
-     * @summary Check Connection and Detect VPN/Proxy
+     * **DEPRECATED for game-server player-join flows.** Use `POST /v1/player-session/start` instead — it runs the same authorization check AND opens the player_session row in a single round-trip, returning the same connection / player / punishment context plus aggregate session stats.  This endpoint remains available for admin and debugging scenarios where you want to inspect a connection\'s state without opening a session (e.g. one-off lookups, batch sweeps, support troubleshooting).  Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times.
+     * @summary Check Connection and Detect VPN/Proxy (DEPRECATED for player-join use)
      * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
-     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
+     * @param {boolean} [forceRecheck] When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false
      * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response.
      * @param {*} [options] Override http request option.
+     * @deprecated
      * @throws {RequiredError}
      */
-    getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ConnectionGetConnectionDetailsResponse, any, {}>>;
+    getConnectionDetails(ip: string, forceRecheck?: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ConnectionGetConnectionDetailsResponse, any, {}>>;
 }
 /**
  * PlayerApi - axios parameter creator
@@ -1975,6 +4184,90 @@ export declare class PlayerApi extends BaseAPI {
      */
     getUsernames(uuids: Array<string>, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
 }
+/**
+ * PlayerSessionsApi - axios parameter creator
+ */
+export declare const PlayerSessionsApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+     * @summary Close the active player session
+     * @param {PlayerSessionEndRequest} playerSessionEndRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    end: (playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Single round-trip the game server / proxy makes when a player joins. Runs the full authorization check (VPN detection, bypass tiers, punishment propagation, active-ban evaluation) and — only if allowed — opens (or re-attaches to) a player_session row.  Replaces the older two-call flow (`GET /v1/connection/details` followed by a session-open POST). `/v1/connection/details` remains available for admin / debugging use but is deprecated for player-join purposes.  Idempotent at the session-open step: a duplicate join request returns the existing active session\'s id instead of creating a duplicate row.  Response shape: - `connectionResult` — always populated; carries ALLOWED / BANNED / VPN_DETECTED etc.   plus a formatted kick message when denied. - `sessionId` / `startedAt` — populated only when the join was allowed. - Connection context (IP, location, VPN%, bypass) for display + logging. - `playerInformation`, `activePunishments` — full player history at join time. - `sessionStats` — total seconds played / days active / currently-online, useful   for game-server-side welcome messages.
+     * @summary Player join — unified authorization + session-open
+     * @param {PlayerSessionStartRequest} playerSessionStartRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    start: (playerSessionStartRequest: PlayerSessionStartRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * PlayerSessionsApi - functional programming interface
+ */
+export declare const PlayerSessionsApiFp: (configuration?: Configuration) => {
+    /**
+     * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+     * @summary Close the active player session
+     * @param {PlayerSessionEndRequest} playerSessionEndRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * Single round-trip the game server / proxy makes when a player joins. Runs the full authorization check (VPN detection, bypass tiers, punishment propagation, active-ban evaluation) and — only if allowed — opens (or re-attaches to) a player_session row.  Replaces the older two-call flow (`GET /v1/connection/details` followed by a session-open POST). `/v1/connection/details` remains available for admin / debugging use but is deprecated for player-join purposes.  Idempotent at the session-open step: a duplicate join request returns the existing active session\'s id instead of creating a duplicate row.  Response shape: - `connectionResult` — always populated; carries ALLOWED / BANNED / VPN_DETECTED etc.   plus a formatted kick message when denied. - `sessionId` / `startedAt` — populated only when the join was allowed. - Connection context (IP, location, VPN%, bypass) for display + logging. - `playerInformation`, `activePunishments` — full player history at join time. - `sessionStats` — total seconds played / days active / currently-online, useful   for game-server-side welcome messages.
+     * @summary Player join — unified authorization + session-open
+     * @param {PlayerSessionStartRequest} playerSessionStartRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    start(playerSessionStartRequest: PlayerSessionStartRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PlayerSessionStartResponse>>;
+};
+/**
+ * PlayerSessionsApi - factory interface
+ */
+export declare const PlayerSessionsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+     * @summary Close the active player session
+     * @param {PlayerSessionEndRequest} playerSessionEndRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * Single round-trip the game server / proxy makes when a player joins. Runs the full authorization check (VPN detection, bypass tiers, punishment propagation, active-ban evaluation) and — only if allowed — opens (or re-attaches to) a player_session row.  Replaces the older two-call flow (`GET /v1/connection/details` followed by a session-open POST). `/v1/connection/details` remains available for admin / debugging use but is deprecated for player-join purposes.  Idempotent at the session-open step: a duplicate join request returns the existing active session\'s id instead of creating a duplicate row.  Response shape: - `connectionResult` — always populated; carries ALLOWED / BANNED / VPN_DETECTED etc.   plus a formatted kick message when denied. - `sessionId` / `startedAt` — populated only when the join was allowed. - Connection context (IP, location, VPN%, bypass) for display + logging. - `playerInformation`, `activePunishments` — full player history at join time. - `sessionStats` — total seconds played / days active / currently-online, useful   for game-server-side welcome messages.
+     * @summary Player join — unified authorization + session-open
+     * @param {PlayerSessionStartRequest} playerSessionStartRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    start(playerSessionStartRequest: PlayerSessionStartRequest, options?: RawAxiosRequestConfig): AxiosPromise<PlayerSessionStartResponse>;
+};
+/**
+ * PlayerSessionsApi - object-oriented interface
+ */
+export declare class PlayerSessionsApi extends BaseAPI {
+    /**
+     * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+     * @summary Close the active player session
+     * @param {PlayerSessionEndRequest} playerSessionEndRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     * Single round-trip the game server / proxy makes when a player joins. Runs the full authorization check (VPN detection, bypass tiers, punishment propagation, active-ban evaluation) and — only if allowed — opens (or re-attaches to) a player_session row.  Replaces the older two-call flow (`GET /v1/connection/details` followed by a session-open POST). `/v1/connection/details` remains available for admin / debugging use but is deprecated for player-join purposes.  Idempotent at the session-open step: a duplicate join request returns the existing active session\'s id instead of creating a duplicate row.  Response shape: - `connectionResult` — always populated; carries ALLOWED / BANNED / VPN_DETECTED etc.   plus a formatted kick message when denied. - `sessionId` / `startedAt` — populated only when the join was allowed. - Connection context (IP, location, VPN%, bypass) for display + logging. - `playerInformation`, `activePunishments` — full player history at join time. - `sessionStats` — total seconds played / days active / currently-online, useful   for game-server-side welcome messages.
+     * @summary Player join — unified authorization + session-open
+     * @param {PlayerSessionStartRequest} playerSessionStartRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    start(playerSessionStartRequest: PlayerSessionStartRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PlayerSessionStartResponse, any, {}>>;
+}
 /**
  * PunishmentApi - axios parameter creator
  */
@@ -2008,19 +4301,18 @@ export declare const PunishmentApiAxiosParamCreator: (configuration?: Configurat
     /**
      * Returns a paginated list of recent punishments with optional filtering by issue date, expiration date, and type
      * @summary List recent punishments
-     * @param {number} limit Maximum number of records to return
-     * @param {number} page Page number for pagination
-     * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (milliseconds)
-     * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (milliseconds)
-     * @param {number | null} [expiresAfter] Filter punishments expiring after this epoch timestamp (milliseconds)
-     * @param {number | null} [expiresBefore] Filter punishments expiring before this epoch timestamp (milliseconds)
-     * @param {Array<PunishmentType> | null} [type] Filter by punishment types
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {string | null} [ipAddress] Filter by IP address
+     * @param {Pageable} pageable
+     * @param {number | null} [issuedAfter]
+     * @param {number | null} [issuedBefore]
+     * @param {number | null} [expiresAfter]
+     * @param {number | null} [expiresBefore]
+     * @param {Array<PunishmentType> | null} [type]
+     * @param {string | null} [uuid]
+     * @param {string | null} [ipAddress]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getRecentPunishments: (limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<PunishmentType> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    getRecentPunishments: (pageable: Pageable, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<PunishmentType> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
 };
 /**
  * PunishmentApi - functional programming interface
@@ -2055,19 +4347,18 @@ export declare const PunishmentApiFp: (configuration?: Configuration) => {
     /**
      * Returns a paginated list of recent punishments with optional filtering by issue date, expiration date, and type
      * @summary List recent punishments
-     * @param {number} limit Maximum number of records to return
-     * @param {number} page Page number for pagination
-     * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (milliseconds)
-     * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (milliseconds)
-     * @param {number | null} [expiresAfter] Filter punishments expiring after this epoch timestamp (milliseconds)
-     * @param {number | null} [expiresBefore] Filter punishments expiring before this epoch timestamp (milliseconds)
-     * @param {Array<PunishmentType> | null} [type] Filter by punishment types
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {string | null} [ipAddress] Filter by IP address
+     * @param {Pageable} pageable
+     * @param {number | null} [issuedAfter]
+     * @param {number | null} [issuedBefore]
+     * @param {number | null} [expiresAfter]
+     * @param {number | null} [expiresBefore]
+     * @param {Array<PunishmentType> | null} [type]
+     * @param {string | null} [uuid]
+     * @param {string | null} [ipAddress]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<PunishmentType> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<PunishmentGetPunishmentResponse>>>;
+    getRecentPunishments(pageable: Pageable, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<PunishmentType> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PagePunishmentGetPunishmentResponse>>;
 };
 /**
  * PunishmentApi - factory interface
@@ -2102,19 +4393,18 @@ export declare const PunishmentApiFactory: (configuration?: Configuration, baseP
     /**
      * Returns a paginated list of recent punishments with optional filtering by issue date, expiration date, and type
      * @summary List recent punishments
-     * @param {number} limit Maximum number of records to return
-     * @param {number} page Page number for pagination
-     * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (milliseconds)
-     * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (milliseconds)
-     * @param {number | null} [expiresAfter] Filter punishments expiring after this epoch timestamp (milliseconds)
-     * @param {number | null} [expiresBefore] Filter punishments expiring before this epoch timestamp (milliseconds)
-     * @param {Array<PunishmentType> | null} [type] Filter by punishment types
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {string | null} [ipAddress] Filter by IP address
+     * @param {Pageable} pageable
+     * @param {number | null} [issuedAfter]
+     * @param {number | null} [issuedBefore]
+     * @param {number | null} [expiresAfter]
+     * @param {number | null} [expiresBefore]
+     * @param {Array<PunishmentType> | null} [type]
+     * @param {string | null} [uuid]
+     * @param {string | null} [ipAddress]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<PunishmentType> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<PunishmentGetPunishmentResponse>>;
+    getRecentPunishments(pageable: Pageable, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<PunishmentType> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<PagePunishmentGetPunishmentResponse>;
 };
 /**
  * PunishmentApi - object-oriented interface
@@ -2149,19 +4439,70 @@ export declare class PunishmentApi extends BaseAPI {
     /**
      * Returns a paginated list of recent punishments with optional filtering by issue date, expiration date, and type
      * @summary List recent punishments
-     * @param {number} limit Maximum number of records to return
-     * @param {number} page Page number for pagination
-     * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (milliseconds)
-     * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (milliseconds)
-     * @param {number | null} [expiresAfter] Filter punishments expiring after this epoch timestamp (milliseconds)
-     * @param {number | null} [expiresBefore] Filter punishments expiring before this epoch timestamp (milliseconds)
-     * @param {Array<PunishmentType> | null} [type] Filter by punishment types
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {string | null} [ipAddress] Filter by IP address
+     * @param {Pageable} pageable
+     * @param {number | null} [issuedAfter]
+     * @param {number | null} [issuedBefore]
+     * @param {number | null} [expiresAfter]
+     * @param {number | null} [expiresBefore]
+     * @param {Array<PunishmentType> | null} [type]
+     * @param {string | null} [uuid]
+     * @param {string | null} [ipAddress]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getRecentPunishments(pageable: Pageable, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<PunishmentType> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PagePunishmentGetPunishmentResponse, any, {}>>;
+}
+/**
+ * ReportApi - axios parameter creator
+ */
+export declare const ReportApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Records that {reporterUuid} flagged one OR MORE players for misconduct in a single incident. Idempotent per (reporter, exact target set) while the prior report is unresolved — repeat submissions with the same target set overwrite reason / category in place and the response\'s {@code deduplicated} flag is true. A different target set (even overlapping) creates a new report. Resolved reports do not block fresh submissions. **Active-report cap**: each reporter may hold at most 3 unresolved reports at a time. A 4th submission with a NEW target set returns 429 until staff resolve one of the existing reports. Dedupe updates (same target set) never count against the cap.
+     * @summary Submit a peer report
+     * @param {CreateReportRequest} createReportRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submit: (createReportRequest: CreateReportRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * ReportApi - functional programming interface
+ */
+export declare const ReportApiFp: (configuration?: Configuration) => {
+    /**
+     * Records that {reporterUuid} flagged one OR MORE players for misconduct in a single incident. Idempotent per (reporter, exact target set) while the prior report is unresolved — repeat submissions with the same target set overwrite reason / category in place and the response\'s {@code deduplicated} flag is true. A different target set (even overlapping) creates a new report. Resolved reports do not block fresh submissions. **Active-report cap**: each reporter may hold at most 3 unresolved reports at a time. A 4th submission with a NEW target set returns 429 until staff resolve one of the existing reports. Dedupe updates (same target set) never count against the cap.
+     * @summary Submit a peer report
+     * @param {CreateReportRequest} createReportRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submit(createReportRequest: CreateReportRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<CreateReportResponse>>;
+};
+/**
+ * ReportApi - factory interface
+ */
+export declare const ReportApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Records that {reporterUuid} flagged one OR MORE players for misconduct in a single incident. Idempotent per (reporter, exact target set) while the prior report is unresolved — repeat submissions with the same target set overwrite reason / category in place and the response\'s {@code deduplicated} flag is true. A different target set (even overlapping) creates a new report. Resolved reports do not block fresh submissions. **Active-report cap**: each reporter may hold at most 3 unresolved reports at a time. A 4th submission with a NEW target set returns 429 until staff resolve one of the existing reports. Dedupe updates (same target set) never count against the cap.
+     * @summary Submit a peer report
+     * @param {CreateReportRequest} createReportRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submit(createReportRequest: CreateReportRequest, options?: RawAxiosRequestConfig): AxiosPromise<CreateReportResponse>;
+};
+/**
+ * ReportApi - object-oriented interface
+ */
+export declare class ReportApi extends BaseAPI {
+    /**
+     * Records that {reporterUuid} flagged one OR MORE players for misconduct in a single incident. Idempotent per (reporter, exact target set) while the prior report is unresolved — repeat submissions with the same target set overwrite reason / category in place and the response\'s {@code deduplicated} flag is true. A different target set (even overlapping) creates a new report. Resolved reports do not block fresh submissions. **Active-report cap**: each reporter may hold at most 3 unresolved reports at a time. A 4th submission with a NEW target set returns 429 until staff resolve one of the existing reports. Dedupe updates (same target set) never count against the cap.
+     * @summary Submit a peer report
+     * @param {CreateReportRequest} createReportRequest
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<PunishmentType> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PunishmentGetPunishmentResponse[], any, {}>>;
+    submit(createReportRequest: CreateReportRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<CreateReportResponse, any, {}>>;
 }
 /**
  * ServerSessionsApi - axios parameter creator