@rebornteam/reborn-api 3.2.0 → 4.0.0

package/dist/esm/api.js

@@ -4,7 +4,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 3.2.0
+ * The version of the OpenAPI document: 4.0.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -40,10 +40,35 @@ export const GameType = {
     Legacy: 'LEGACY',
     Classic: 'CLASSIC'
 };
+/**
+ * Current lifecycle state.
+ */
+export const JobStatus = {
+    Queued: 'QUEUED',
+    Running: 'RUNNING',
+    Completed: 'COMPLETED',
+    Failed: 'FAILED',
+    Cancelled: 'CANCELLED'
+};
+export const PageableMode = {
+    CursorNext: 'CURSOR_NEXT',
+    CursorPrevious: 'CURSOR_PREVIOUS',
+    Offset: 'OFFSET'
+};
+/**
+ * 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 const PunishmentSource = {
+    Direct: 'DIRECT',
+    Propagated: 'PROPAGATED'
+};
 export const PunishmentTargetType = {
     Player: 'PLAYER',
     Connection: 'CONNECTION'
 };
+/**
+ * Type of punishment
+ */
 export const PunishmentType = {
     Ban: 'BAN',
     Mute: 'MUTE',
@@ -59,6 +84,16 @@ export const Region = {
     Eu: 'EU',
     Au: 'AU'
 };
+/**
+ * Category of misconduct. Coarse on purpose — staff refine in triage.
+ */
+export const ReportCategory = {
+    Cheating: 'CHEATING',
+    Harassment: 'HARASSMENT',
+    ChatAbuse: 'CHAT_ABUSE',
+    Griefing: 'GRIEFING',
+    Other: 'OTHER'
+};
 /**
  * Search kind — PLAYER for UUID/username searches, IP for IP address searches
  */
@@ -66,6 +101,236 @@ export const SearchKind = {
     Player: 'PLAYER',
     Ip: 'IP'
 };
+export const SortOrderDirection = {
+    Asc: 'ASC',
+    Desc: 'DESC'
+};
+/**
+ * AdminAuditLogApi - axios parameter creator
+ */
+export const AdminAuditLogApiAxiosParamCreator = function (configuration) {
+    return {
+        /**
+         * 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_1, actor_1, action_1, targetType_1, targetId_1, ...args_1) => __awaiter(this, [pageable_1, actor_1, action_1, targetType_1, targetId_1, ...args_1], void 0, function* (pageable, actor, action, targetType, targetId, options = {}) {
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('search', 'pageable', pageable);
+            const localVarPath = `/admin/audit-log`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (actor !== undefined) {
+                localVarQueryParameter['actor'] = actor;
+            }
+            if (action !== undefined) {
+                localVarQueryParameter['action'] = action;
+            }
+            if (targetType !== undefined) {
+                localVarQueryParameter['targetType'] = targetType;
+            }
+            if (targetId !== undefined) {
+                localVarQueryParameter['targetId'] = targetId;
+            }
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, actor_1, action_1, targetType_1, targetId_1, ...args_1) => __awaiter(this, [pageable_1, actor_1, action_1, targetType_1, targetId_1, ...args_1], void 0, function* (pageable, actor, action, targetType, targetId, options = {}) {
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('searchCursor', 'pageable', pageable);
+            const localVarPath = `/admin/audit-log/cursor`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (actor !== undefined) {
+                localVarQueryParameter['actor'] = actor;
+            }
+            if (action !== undefined) {
+                localVarQueryParameter['action'] = action;
+            }
+            if (targetType !== undefined) {
+                localVarQueryParameter['targetType'] = targetType;
+            }
+            if (targetId !== undefined) {
+                localVarQueryParameter['targetId'] = targetId;
+            }
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+    };
+};
+/**
+ * AdminAuditLogApi - functional programming interface
+ */
+export const AdminAuditLogApiFp = function (configuration) {
+    const localVarAxiosParamCreator = AdminAuditLogApiAxiosParamCreator(configuration);
+    return {
+        /**
+         * 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, actor, action, targetType, targetId, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.search(pageable, actor, action, targetType, targetId, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminAuditLogApi.search']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, actor, action, targetType, targetId, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.searchCursor(pageable, actor, action, targetType, targetId, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminAuditLogApi.searchCursor']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+    };
+};
+/**
+ * AdminAuditLogApi - factory interface
+ */
+export const AdminAuditLogApiFactory = function (configuration, basePath, axios) {
+    const localVarFp = AdminAuditLogApiFp(configuration);
+    return {
+        /**
+         * 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, actor, action, targetType, targetId, options) {
+            return localVarFp.search(pageable, actor, action, targetType, targetId, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, actor, action, targetType, targetId, options) {
+            return localVarFp.searchCursor(pageable, actor, action, targetType, targetId, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+/**
+ * AdminAuditLogApi - object-oriented interface
+ */
+export 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, actor, action, targetType, targetId, options) {
+        return AdminAuditLogApiFp(this.configuration).search(pageable, actor, action, targetType, targetId, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, actor, action, targetType, targetId, options) {
+        return AdminAuditLogApiFp(this.configuration).searchCursor(pageable, actor, action, targetType, targetId, options).then((request) => request(this.axios, this.basePath));
+    }
+}
 /**
  * AdminClientCredentialsApi - axios parameter creator
  */
@@ -581,6 +846,35 @@ export class AdminClientCredentialsApi extends BaseAPI {
  */
 export const AdminConnectionsApiAxiosParamCreator = function (configuration) {
     return {
+        /**
+         * Submits an async job that iterates every connection_check row missing both city and country and re-runs its source VPN service to populate location data. Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. The final {@code Admin_BackfillLocationResponse} (processed/succeeded/failed counts) lands in the job\'s {@code result_payload} on COMPLETED.
+         * @summary Start a location backfill job
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        backfillLocation: (...args_1) => __awaiter(this, [...args_1], void 0, function* (options = {}) {
+            const localVarPath = `/admin/connection/backfill-location`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
         /**
          * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
          * @summary Create connection bypass
@@ -615,18 +909,93 @@ export const AdminConnectionsApiAxiosParamCreator = function (configuration) {
                 options: localVarRequestOptions,
             };
         }),
+        /**
+         * 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_1, ...args_1) => __awaiter(this, [id_1, ...args_1], void 0, function* (id, options = {}) {
+            // verify required parameter 'id' is not null or undefined
+            assertParamExists('getConnection', 'id', id);
+            const localVarPath = `/admin/connection/{id}`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, pageable_1, ...args_1) => __awaiter(this, [id_1, pageable_1, ...args_1], void 0, function* (id, pageable, options = {}) {
+            // verify required parameter 'id' is not null or undefined
+            assertParamExists('getConnectionPlayers', 'id', id);
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('getConnectionPlayers', 'pageable', pageable);
+            const localVarPath = `/admin/connection/{id}/players`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
         /**
          * 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_1, uuid_1, isVpn_1, page_1, limit_1, ...args_1) => __awaiter(this, [ipAddress_1, uuid_1, isVpn_1, page_1, limit_1, ...args_1], void 0, function* (ipAddress, uuid, isVpn, page, limit, options = {}) {
+        listAllConnections: (pageable_1, createdAfter_1, createdBefore_1, ipAddress_1, uuid_1, isVpn_1, ...args_1) => __awaiter(this, [pageable_1, createdAfter_1, createdBefore_1, ipAddress_1, uuid_1, isVpn_1, ...args_1], void 0, function* (pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options = {}) {
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('listAllConnections', 'pageable', pageable);
             const localVarPath = `/admin/connection`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -640,6 +1009,12 @@ export const AdminConnectionsApiAxiosParamCreator = function (configuration) {
             // authentication DiscordAuth required
             // http bearer authentication required
             yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (createdAfter !== undefined) {
+                localVarQueryParameter['createdAfter'] = createdAfter;
+            }
+            if (createdBefore !== undefined) {
+                localVarQueryParameter['createdBefore'] = createdBefore;
+            }
             if (ipAddress !== undefined) {
                 localVarQueryParameter['ipAddress'] = ipAddress;
             }
@@ -649,11 +1024,8 @@ export const AdminConnectionsApiAxiosParamCreator = function (configuration) {
             if (isVpn !== undefined) {
                 localVarQueryParameter['isVpn'] = isVpn;
             }
-            if (page !== undefined) {
-                localVarQueryParameter['page'] = page;
-            }
-            if (limit !== undefined) {
-                localVarQueryParameter['limit'] = limit;
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
             }
             localVarHeaderParameter['Accept'] = 'application/json';
             setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -667,17 +1039,18 @@ export const AdminConnectionsApiAxiosParamCreator = function (configuration) {
         /**
          * 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=VPN, false=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_1, createdBefore_1, ipAddress_1, uuid_1, isVpn_1, page_1, limit_1, ...args_1) => __awaiter(this, [createdAfter_1, createdBefore_1, ipAddress_1, uuid_1, isVpn_1, page_1, limit_1, ...args_1], void 0, function* (createdAfter, createdBefore, ipAddress, uuid, isVpn, page, limit, options = {}) {
+        listConnections: (pageable_1, createdAfter_1, createdBefore_1, ipAddress_1, uuid_1, isVpn_1, ...args_1) => __awaiter(this, [pageable_1, createdAfter_1, createdBefore_1, ipAddress_1, uuid_1, isVpn_1, ...args_1], void 0, function* (pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options = {}) {
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('listConnections', 'pageable', pageable);
             const localVarPath = `/admin/connection/recent`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -706,11 +1079,8 @@ export const AdminConnectionsApiAxiosParamCreator = function (configuration) {
             if (isVpn !== undefined) {
                 localVarQueryParameter['isVpn'] = isVpn;
             }
-            if (page !== undefined) {
-                localVarQueryParameter['page'] = page;
-            }
-            if (limit !== undefined) {
-                localVarQueryParameter['limit'] = limit;
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
             }
             localVarHeaderParameter['Accept'] = 'application/json';
             setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -766,6 +1136,21 @@ export const AdminConnectionsApiAxiosParamCreator = function (configuration) {
 export const AdminConnectionsApiFp = function (configuration) {
     const localVarAxiosParamCreator = AdminConnectionsApiAxiosParamCreator(configuration);
     return {
+        /**
+         * Submits an async job that iterates every connection_check row missing both city and country and re-runs its source VPN service to populate location data. Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. The final {@code Admin_BackfillLocationResponse} (processed/succeeded/failed counts) lands in the job\'s {@code result_payload} on COMPLETED.
+         * @summary Start a location backfill job
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        backfillLocation(options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.backfillLocation(options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminConnectionsApi.backfillLocation']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
         /**
          * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
          * @summary Create connection bypass
@@ -782,21 +1167,55 @@ export const AdminConnectionsApiFp = function (configuration) {
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
+        /**
+         * Single connection by id, enriched with VPN check results and bypass status — same shape as the dashboard list row.
+         * @summary Get connection detail
+         * @param {number} id
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getConnection(id, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.getConnection(id, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminConnectionsApi.getConnection']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * Paginated list of every player ever seen on this connection, with punishment scoring inline. Suitable for an infinite-scroll panel inside the connection detail modal.
+         * @summary List players who have used this connection
+         * @param {number} id
+         * @param {Pageable} pageable
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getConnectionPlayers(id, pageable, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.getConnectionPlayers(id, pageable, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminConnectionsApi.getConnectionPlayers']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
         /**
          * Returns a paginated list of all connections with a total count. Supports filtering by IP address, UUID, and VPN status.
          * @summary List all connections (paginated)
-         * @param {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, uuid, isVpn, page, limit, options) {
+        listAllConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.listAllConnections(ipAddress, uuid, isVpn, page, limit, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.listAllConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminConnectionsApi.listAllConnections']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -805,20 +1224,19 @@ export const AdminConnectionsApiFp = function (configuration) {
         /**
          * 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=VPN, false=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, createdBefore, ipAddress, uuid, isVpn, page, limit, options) {
+        listConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.listConnections(createdAfter, createdBefore, ipAddress, uuid, isVpn, page, limit, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.listConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminConnectionsApi.listConnections']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -850,44 +1268,74 @@ export const AdminConnectionsApiFactory = function (configuration, basePath, axi
     const localVarFp = AdminConnectionsApiFp(configuration);
     return {
         /**
-         * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
-         * @summary Create connection bypass
-         * @param {CreateBypassRequest} createBypassRequest
+         * 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) {
+            return localVarFp.backfillLocation(options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
+         * @summary Create connection bypass
+         * @param {CreateBypassRequest} createBypassRequest
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
         createBypass(createBypassRequest, options) {
             return localVarFp.createBypass(createBypassRequest, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Single connection by id, enriched with VPN check results and bypass status — same shape as the dashboard list row.
+         * @summary Get connection detail
+         * @param {number} id
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getConnection(id, options) {
+            return localVarFp.getConnection(id, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Paginated list of every player ever seen on this connection, with punishment scoring inline. Suitable for an infinite-scroll panel inside the connection detail modal.
+         * @summary List players who have used this connection
+         * @param {number} id
+         * @param {Pageable} pageable
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getConnectionPlayers(id, pageable, options) {
+            return localVarFp.getConnectionPlayers(id, pageable, options).then((request) => request(axios, basePath));
+        },
         /**
          * Returns a paginated list of all connections with a total count. Supports filtering by IP address, UUID, and VPN status.
          * @summary List all connections (paginated)
-         * @param {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, uuid, isVpn, page, limit, options) {
-            return localVarFp.listAllConnections(ipAddress, uuid, isVpn, page, limit, options).then((request) => request(axios, basePath));
+        listAllConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options) {
+            return localVarFp.listAllConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options).then((request) => request(axios, basePath));
         },
         /**
          * Returns a list of recent connections with VPN detection status, bypass information, and associated player data. Optionally filter by epoch timestamp (seconds since Unix epoch).
          * @summary List recent connections
-         * @param {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=VPN, false=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, createdBefore, ipAddress, uuid, isVpn, page, limit, options) {
-            return localVarFp.listConnections(createdAfter, createdBefore, ipAddress, uuid, isVpn, page, limit, options).then((request) => request(axios, basePath));
+        listConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options) {
+            return localVarFp.listConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options).then((request) => request(axios, basePath));
         },
         /**
          * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
@@ -906,6 +1354,15 @@ export const AdminConnectionsApiFactory = function (configuration, basePath, axi
  * AdminConnectionsApi - object-oriented interface
  */
 export class AdminConnectionsApi extends BaseAPI {
+    /**
+     * Submits an async job that iterates every connection_check row missing both city and country and re-runs its source VPN service to populate location data. Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. The final {@code Admin_BackfillLocationResponse} (processed/succeeded/failed counts) lands in the job\'s {@code result_payload} on COMPLETED.
+     * @summary Start a location backfill job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    backfillLocation(options) {
+        return AdminConnectionsApiFp(this.configuration).backfillLocation(options).then((request) => request(this.axios, this.basePath));
+    }
     /**
      * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
      * @summary Create connection bypass
@@ -916,35 +1373,56 @@ export class AdminConnectionsApi extends BaseAPI {
     createBypass(createBypassRequest, options) {
         return AdminConnectionsApiFp(this.configuration).createBypass(createBypassRequest, options).then((request) => request(this.axios, this.basePath));
     }
+    /**
+     * Single connection by id, enriched with VPN check results and bypass status — same shape as the dashboard list row.
+     * @summary Get connection detail
+     * @param {number} id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getConnection(id, options) {
+        return AdminConnectionsApiFp(this.configuration).getConnection(id, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * Paginated list of every player ever seen on this connection, with punishment scoring inline. Suitable for an infinite-scroll panel inside the connection detail modal.
+     * @summary List players who have used this connection
+     * @param {number} id
+     * @param {Pageable} pageable
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getConnectionPlayers(id, pageable, options) {
+        return AdminConnectionsApiFp(this.configuration).getConnectionPlayers(id, pageable, options).then((request) => request(this.axios, this.basePath));
+    }
     /**
      * Returns a paginated list of all connections with a total count. Supports filtering by IP address, UUID, and VPN status.
      * @summary List all connections (paginated)
-     * @param {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, uuid, isVpn, page, limit, options) {
-        return AdminConnectionsApiFp(this.configuration).listAllConnections(ipAddress, uuid, isVpn, page, limit, options).then((request) => request(this.axios, this.basePath));
+    listAllConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options) {
+        return AdminConnectionsApiFp(this.configuration).listAllConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options).then((request) => request(this.axios, this.basePath));
     }
     /**
      * Returns a list of recent connections with VPN detection status, bypass information, and associated player data. Optionally filter by epoch timestamp (seconds since Unix epoch).
      * @summary List recent connections
-     * @param {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=VPN, false=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, createdBefore, ipAddress, uuid, isVpn, page, limit, options) {
-        return AdminConnectionsApiFp(this.configuration).listConnections(createdAfter, createdBefore, ipAddress, uuid, isVpn, page, limit, options).then((request) => request(this.axios, this.basePath));
+    listConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options) {
+        return AdminConnectionsApiFp(this.configuration).listConnections(pageable, createdAfter, createdBefore, ipAddress, uuid, isVpn, options).then((request) => request(this.axios, this.basePath));
     }
     /**
      * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
@@ -1049,22 +1527,54 @@ export class AdminDashboardApi extends BaseAPI {
     }
 }
 /**
- * AdminPlayersApi - axios parameter creator
+ * AdminJobsApi - axios parameter creator
  */
-export const AdminPlayersApiAxiosParamCreator = function (configuration) {
+export const AdminJobsApiAxiosParamCreator = function (configuration) {
     return {
         /**
-         * Returns full detail for a single player including all known usernames and punishment scoring.
-         * @summary Get player detail
-         * @param {string} uuid Player Minecraft UUID
+         * 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}
          */
-        getPlayer: (uuid_1, ...args_1) => __awaiter(this, [uuid_1, ...args_1], void 0, function* (uuid, options = {}) {
-            // verify required parameter 'uuid' is not null or undefined
-            assertParamExists('getPlayer', 'uuid', uuid);
-            const localVarPath = `/admin/player/{uuid}`
-                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+        cancel: (id_1, ...args_1) => __awaiter(this, [id_1, ...args_1], void 0, function* (id, options = {}) {
+            // verify required parameter 'id' is not null or undefined
+            assertParamExists('cancel', 'id', id);
+            const localVarPath = `/admin/job/{id}`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'DELETE' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * The polling target — the admin UI hits this every ~2 s while a job is running to update its progress bar.
+         * @summary Get one async job
+         * @param {string} id Job id
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        get: (id_1, ...args_1) => __awaiter(this, [id_1, ...args_1], void 0, function* (id, options = {}) {
+            // verify required parameter 'id' is not null or undefined
+            assertParamExists('get', 'id', id);
+            const localVarPath = `/admin/job/{id}`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -1087,20 +1597,17 @@ export const AdminPlayersApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * 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)
+         * 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}
          */
-        listPlayers: (page_1, limit_1, search_1, ...args_1) => __awaiter(this, [page_1, limit_1, search_1, ...args_1], void 0, function* (page, limit, search, options = {}) {
-            // verify required parameter 'page' is not null or undefined
-            assertParamExists('listPlayers', 'page', page);
-            // verify required parameter 'limit' is not null or undefined
-            assertParamExists('listPlayers', 'limit', limit);
-            const localVarPath = `/admin/player`;
+        list: (pageable_1, status_1, ...args_1) => __awaiter(this, [pageable_1, status_1, ...args_1], void 0, function* (pageable, status, options = {}) {
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('list', 'pageable', pageable);
+            const localVarPath = `/admin/job`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -1113,14 +1620,11 @@ export const AdminPlayersApiAxiosParamCreator = function (configuration) {
             // authentication DiscordAuth required
             // http bearer authentication required
             yield setBearerAuthToObject(localVarHeaderParameter, configuration);
-            if (search !== undefined) {
-                localVarQueryParameter['search'] = search;
-            }
-            if (page !== undefined) {
-                localVarQueryParameter['page'] = page;
+            if (status !== undefined) {
+                localVarQueryParameter['status'] = status;
             }
-            if (limit !== undefined) {
-                localVarQueryParameter['limit'] = limit;
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
             }
             localVarHeaderParameter['Accept'] = 'application/json';
             setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -1134,120 +1638,157 @@ export const AdminPlayersApiAxiosParamCreator = function (configuration) {
     };
 };
 /**
- * AdminPlayersApi - functional programming interface
+ * AdminJobsApi - functional programming interface
  */
-export const AdminPlayersApiFp = function (configuration) {
-    const localVarAxiosParamCreator = AdminPlayersApiAxiosParamCreator(configuration);
+export const AdminJobsApiFp = function (configuration) {
+    const localVarAxiosParamCreator = AdminJobsApiAxiosParamCreator(configuration);
     return {
         /**
-         * Returns full detail for a single player including all known usernames and punishment scoring.
-         * @summary Get player detail
-         * @param {string} uuid Player Minecraft UUID
+         * 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}
          */
-        getPlayer(uuid, options) {
+        cancel(id, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.getPlayer(uuid, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.cancel(id, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
-                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.getPlayer']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminJobsApi.cancel']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
         /**
-         * 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)
+         * 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}
          */
-        listPlayers(page, limit, search, options) {
+        get(id, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.listPlayers(page, limit, search, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.get(id, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
-                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.listPlayers']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminJobsApi.get']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, status, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.list(pageable, status, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminJobsApi.list']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
     };
 };
 /**
- * AdminPlayersApi - factory interface
+ * AdminJobsApi - factory interface
  */
-export const AdminPlayersApiFactory = function (configuration, basePath, axios) {
-    const localVarFp = AdminPlayersApiFp(configuration);
+export const AdminJobsApiFactory = function (configuration, basePath, axios) {
+    const localVarFp = AdminJobsApiFp(configuration);
     return {
         /**
-         * Returns full detail for a single player including all known usernames and punishment scoring.
-         * @summary Get player detail
-         * @param {string} uuid Player Minecraft UUID
+         * 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}
          */
-        getPlayer(uuid, options) {
-            return localVarFp.getPlayer(uuid, options).then((request) => request(axios, basePath));
+        cancel(id, options) {
+            return localVarFp.cancel(id, options).then((request) => request(axios, basePath));
         },
         /**
-         * 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)
+         * 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, options) {
+            return localVarFp.get(id, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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}
          */
-        listPlayers(page, limit, search, options) {
-            return localVarFp.listPlayers(page, limit, search, options).then((request) => request(axios, basePath));
+        list(pageable, status, options) {
+            return localVarFp.list(pageable, status, options).then((request) => request(axios, basePath));
         },
     };
 };
 /**
- * AdminPlayersApi - object-oriented interface
+ * AdminJobsApi - object-oriented interface
  */
-export class AdminPlayersApi extends BaseAPI {
+export class AdminJobsApi extends BaseAPI {
     /**
-     * Returns full detail for a single player including all known usernames and punishment scoring.
-     * @summary Get player detail
-     * @param {string} uuid Player Minecraft UUID
+     * 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}
      */
-    getPlayer(uuid, options) {
-        return AdminPlayersApiFp(this.configuration).getPlayer(uuid, options).then((request) => request(this.axios, this.basePath));
+    cancel(id, options) {
+        return AdminJobsApiFp(this.configuration).cancel(id, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * 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)
+     * 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, options) {
+        return AdminJobsApiFp(this.configuration).get(id, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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}
      */
-    listPlayers(page, limit, search, options) {
-        return AdminPlayersApiFp(this.configuration).listPlayers(page, limit, search, options).then((request) => request(this.axios, this.basePath));
+    list(pageable, status, options) {
+        return AdminJobsApiFp(this.configuration).list(pageable, status, options).then((request) => request(this.axios, this.basePath));
     }
 }
 /**
- * AdminPunishmentsApi - axios parameter creator
+ * AdminPlayersApi - axios parameter creator
  */
-export const AdminPunishmentsApiAxiosParamCreator = function (configuration) {
+export const AdminPlayersApiAxiosParamCreator = function (configuration) {
     return {
         /**
-         * Apply a punishment to one or more targets. The authenticated user is recorded as the issuer.
-         * @summary Apply punishment
-         * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest
+         * 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}
          */
-        applyPunishment: (adminApplyPunishmentRequest_1, ...args_1) => __awaiter(this, [adminApplyPunishmentRequest_1, ...args_1], void 0, function* (adminApplyPunishmentRequest, options = {}) {
-            // verify required parameter 'adminApplyPunishmentRequest' is not null or undefined
-            assertParamExists('applyPunishment', 'adminApplyPunishmentRequest', adminApplyPunishmentRequest);
-            const localVarPath = `/admin/punishment/apply`;
+        addAltExemption: (uuid_1, adminCreateAltExemptionRequest_1, ...args_1) => __awaiter(this, [uuid_1, adminCreateAltExemptionRequest_1, ...args_1], void 0, function* (uuid, adminCreateAltExemptionRequest, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('addAltExemption', 'uuid', uuid);
+            // verify required parameter 'adminCreateAltExemptionRequest' is not null or undefined
+            assertParamExists('addAltExemption', 'adminCreateAltExemptionRequest', adminCreateAltExemptionRequest);
+            const localVarPath = `/admin/player/{uuid}/alt-exemption`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -1261,27 +1802,26 @@ export const AdminPunishmentsApiAxiosParamCreator = function (configuration) {
             // http bearer authentication required
             yield setBearerAuthToObject(localVarHeaderParameter, configuration);
             localVarHeaderParameter['Content-Type'] = 'application/json';
-            localVarHeaderParameter['Accept'] = 'application/json';
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
-            localVarRequestOptions.data = serializeDataIfNeeded(adminApplyPunishmentRequest, localVarRequestOptions, configuration);
+            localVarRequestOptions.data = serializeDataIfNeeded(adminCreateAltExemptionRequest, localVarRequestOptions, configuration);
             return {
                 url: toPathString(localVarUrlObj),
                 options: localVarRequestOptions,
             };
         }),
         /**
-         * Preview the impact of a punishment across one or more targets. No changes are made.
-         * @summary Evaluate punishment impact
-         * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest
+         * 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}
          */
-        createDraft: (adminCreatePunishmentDraftRequest_1, ...args_1) => __awaiter(this, [adminCreatePunishmentDraftRequest_1, ...args_1], void 0, function* (adminCreatePunishmentDraftRequest, options = {}) {
-            // verify required parameter 'adminCreatePunishmentDraftRequest' is not null or undefined
-            assertParamExists('createDraft', 'adminCreatePunishmentDraftRequest', adminCreatePunishmentDraftRequest);
-            const localVarPath = `/admin/punishment/draft`;
+        bulkRevokePropagated: (adminBulkRevokeRequest_1, ...args_1) => __awaiter(this, [adminBulkRevokeRequest_1, ...args_1], void 0, function* (adminBulkRevokeRequest, options = {}) {
+            // verify required parameter 'adminBulkRevokeRequest' is not null or undefined
+            assertParamExists('bulkRevokePropagated', 'adminBulkRevokeRequest', adminBulkRevokeRequest);
+            const localVarPath = `/admin/player/player-punishment/bulk-revoke`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -1299,103 +1839,110 @@ export const AdminPunishmentsApiAxiosParamCreator = function (configuration) {
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
-            localVarRequestOptions.data = serializeDataIfNeeded(adminCreatePunishmentDraftRequest, localVarRequestOptions, configuration);
+            localVarRequestOptions.data = serializeDataIfNeeded(adminBulkRevokeRequest, localVarRequestOptions, configuration);
             return {
                 url: toPathString(localVarUrlObj),
                 options: localVarRequestOptions,
             };
         }),
         /**
-         * 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 {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        getPunishments: (page_1, limit_1, uuid_1, username_1, ipAddress_1, type_1, issuedAfter_1, issuedBefore_1, ...args_1) => __awaiter(this, [page_1, limit_1, uuid_1, username_1, ipAddress_1, type_1, issuedAfter_1, issuedBefore_1, ...args_1], void 0, function* (page, limit, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options = {}) {
-            // verify required parameter 'page' is not null or undefined
-            assertParamExists('getPunishments', 'page', page);
-            // verify required parameter 'limit' is not null or undefined
-            assertParamExists('getPunishments', 'limit', limit);
-            const localVarPath = `/admin/punishment`;
+         * 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_1, adminCreatePlayerNoteRequest_1, ...args_1) => __awaiter(this, [uuid_1, adminCreatePlayerNoteRequest_1, ...args_1], void 0, function* (uuid, adminCreatePlayerNoteRequest, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('createPlayerNote', 'uuid', uuid);
+            // verify required parameter 'adminCreatePlayerNoteRequest' is not null or undefined
+            assertParamExists('createPlayerNote', 'adminCreatePlayerNoteRequest', adminCreatePlayerNoteRequest);
+            const localVarPath = `/admin/player/{uuid}/note`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
             if (configuration) {
                 baseOptions = configuration.baseOptions;
             }
-            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
             const localVarHeaderParameter = {};
             const localVarQueryParameter = {};
             // authentication DiscordAuth required
             // http bearer authentication required
             yield setBearerAuthToObject(localVarHeaderParameter, configuration);
-            if (uuid !== undefined) {
-                localVarQueryParameter['uuid'] = uuid;
-            }
-            if (username !== undefined) {
-                localVarQueryParameter['username'] = username;
-            }
-            if (ipAddress !== undefined) {
-                localVarQueryParameter['ipAddress'] = ipAddress;
-            }
-            if (type) {
-                localVarQueryParameter['type'] = type.join(COLLECTION_FORMATS.csv);
-            }
-            if (issuedAfter !== undefined) {
-                localVarQueryParameter['issuedAfter'] = issuedAfter;
-            }
-            if (issuedBefore !== undefined) {
-                localVarQueryParameter['issuedBefore'] = issuedBefore;
-            }
-            if (page !== undefined) {
-                localVarQueryParameter['page'] = page;
-            }
-            if (limit !== undefined) {
-                localVarQueryParameter['limit'] = limit;
-            }
+            localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(adminCreatePlayerNoteRequest, localVarRequestOptions, configuration);
             return {
                 url: toPathString(localVarUrlObj),
                 options: localVarRequestOptions,
             };
         }),
         /**
-         * Search for players by UUID or username, or look up all players associated with an IP address.
-         * @summary Search punishment targets
-         * @param {string} q UUID, username, or partial/full IP address to search for
+         * 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}
          */
-        searchTargets: (q_1, ...args_1) => __awaiter(this, [q_1, ...args_1], void 0, function* (q, options = {}) {
-            // verify required parameter 'q' is not null or undefined
-            assertParamExists('searchTargets', 'q', q);
-            const localVarPath = `/admin/punishment/search`;
+        deletePlayerNote: (uuid_1, noteId_1, ...args_1) => __awaiter(this, [uuid_1, noteId_1, ...args_1], void 0, function* (uuid, noteId, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('deletePlayerNote', 'uuid', uuid);
+            // verify required parameter 'noteId' is not null or undefined
+            assertParamExists('deletePlayerNote', 'noteId', noteId);
+            const localVarPath = `/admin/player/{uuid}/note/{noteId}`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)))
+                .replace(`{${"noteId"}}`, encodeURIComponent(String(noteId)));
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
             if (configuration) {
                 baseOptions = configuration.baseOptions;
             }
-            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'DELETE' }, baseOptions), options);
             const localVarHeaderParameter = {};
             const localVarQueryParameter = {};
             // authentication DiscordAuth required
             // http bearer authentication required
             yield setBearerAuthToObject(localVarHeaderParameter, configuration);
-            if (q !== undefined) {
-                localVarQueryParameter['q'] = q;
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, ...args_1) => __awaiter(this, [uuid_1, ...args_1], void 0, function* (uuid, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('getPlayer', 'uuid', uuid);
+            const localVarPath = `/admin/player/{uuid}`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
             }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
             localVarHeaderParameter['Accept'] = 'application/json';
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
@@ -1405,30 +1952,1433 @@ export const AdminPunishmentsApiAxiosParamCreator = function (configuration) {
                 options: localVarRequestOptions,
             };
         }),
-    };
-};
-/**
- * AdminPunishmentsApi - functional programming interface
- */
-export const AdminPunishmentsApiFp = function (configuration) {
-    const localVarAxiosParamCreator = AdminPunishmentsApiAxiosParamCreator(configuration);
-    return {
         /**
-         * Apply a punishment to one or more targets. The authenticated user is recorded as the issuer.
-         * @summary Apply punishment
-         * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest
+         * 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}
          */
-        applyPunishment(adminApplyPunishmentRequest, options) {
-            return __awaiter(this, void 0, void 0, function* () {
-                var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.applyPunishment(adminApplyPunishmentRequest, options);
-                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
-                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPunishmentsApi.applyPunishment']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
-                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
-            });
-        },
+        getPlayerAlts: (uuid_1, pageable_1, ...args_1) => __awaiter(this, [uuid_1, pageable_1, ...args_1], void 0, function* (uuid, pageable, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('getPlayerAlts', 'uuid', uuid);
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('getPlayerAlts', 'pageable', pageable);
+            const localVarPath = `/admin/player/{uuid}/alts`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, pageable_1, ...args_1) => __awaiter(this, [uuid_1, pageable_1, ...args_1], void 0, function* (uuid, pageable, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('getPlayerConnections', 'uuid', uuid);
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('getPlayerConnections', 'pageable', pageable);
+            const localVarPath = `/admin/player/{uuid}/connections`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, pageable_1, ...args_1) => __awaiter(this, [uuid_1, pageable_1, ...args_1], void 0, function* (uuid, pageable, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('getPlayerPunishments', 'uuid', uuid);
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('getPlayerPunishments', 'pageable', pageable);
+            const localVarPath = `/admin/player/{uuid}/player-punishments`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, ...args_1) => __awaiter(this, [uuid_1, ...args_1], void 0, function* (uuid, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('getSessionStats', 'uuid', uuid);
+            const localVarPath = `/admin/player/{uuid}/session-stats`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, pageable_1, ...args_1) => __awaiter(this, [uuid_1, pageable_1, ...args_1], void 0, function* (uuid, pageable, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('listAltExemptions', 'uuid', uuid);
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('listAltExemptions', 'pageable', pageable);
+            const localVarPath = `/admin/player/{uuid}/alt-exemption`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, pageable_1, ...args_1) => __awaiter(this, [uuid_1, pageable_1, ...args_1], void 0, function* (uuid, pageable, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('listPlayerNotes', 'uuid', uuid);
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('listPlayerNotes', 'pageable', pageable);
+            const localVarPath = `/admin/player/{uuid}/notes`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, search_1, ...args_1) => __awaiter(this, [pageable_1, search_1, ...args_1], void 0, function* (pageable, search, options = {}) {
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('listPlayers', 'pageable', pageable);
+            const localVarPath = `/admin/player`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (search !== undefined) {
+                localVarQueryParameter['search'] = search;
+            }
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, pageable_1, ...args_1) => __awaiter(this, [uuid_1, pageable_1, ...args_1], void 0, function* (uuid, pageable, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('listSessions', 'uuid', uuid);
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('listSessions', 'pageable', pageable);
+            const localVarPath = `/admin/player/{uuid}/sessions`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, altPlayerUuid_1, ...args_1) => __awaiter(this, [uuid_1, altPlayerUuid_1, ...args_1], void 0, function* (uuid, altPlayerUuid, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('removeAltExemption', 'uuid', uuid);
+            // verify required parameter 'altPlayerUuid' is not null or undefined
+            assertParamExists('removeAltExemption', 'altPlayerUuid', altPlayerUuid);
+            const localVarPath = `/admin/player/{uuid}/alt-exemption/{altPlayerUuid}`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)))
+                .replace(`{${"altPlayerUuid"}}`, encodeURIComponent(String(altPlayerUuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'DELETE' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, playerPunishmentId_1, ...args_1) => __awaiter(this, [uuid_1, playerPunishmentId_1, ...args_1], void 0, function* (uuid, playerPunishmentId, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('revokePropagatedLink', 'uuid', uuid);
+            // verify required parameter 'playerPunishmentId' is not null or undefined
+            assertParamExists('revokePropagatedLink', 'playerPunishmentId', playerPunishmentId);
+            const localVarPath = `/admin/player/{uuid}/player-punishment/{playerPunishmentId}`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)))
+                .replace(`{${"playerPunishmentId"}}`, encodeURIComponent(String(playerPunishmentId)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'DELETE' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, adminSetAggressiveModeImmunityRequest_1, ...args_1) => __awaiter(this, [uuid_1, adminSetAggressiveModeImmunityRequest_1, ...args_1], void 0, function* (uuid, adminSetAggressiveModeImmunityRequest, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('setAggressiveModeImmunity', 'uuid', uuid);
+            // verify required parameter 'adminSetAggressiveModeImmunityRequest' is not null or undefined
+            assertParamExists('setAggressiveModeImmunity', 'adminSetAggressiveModeImmunityRequest', adminSetAggressiveModeImmunityRequest);
+            const localVarPath = `/admin/player/{uuid}/aggressive-mode-immunity`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'PATCH' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(adminSetAggressiveModeImmunityRequest, localVarRequestOptions, configuration);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, ...args_1) => __awaiter(this, [uuid_1, ...args_1], void 0, function* (uuid, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('trustFactorBreakdown', 'uuid', uuid);
+            const localVarPath = `/admin/player/{uuid}/trust-factor-breakdown`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, days_1, ...args_1) => __awaiter(this, [uuid_1, days_1, ...args_1], void 0, function* (uuid, days, options = {}) {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('trustFactorHistory', 'uuid', uuid);
+            const localVarPath = `/admin/player/{uuid}/trust-factor-history`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (days !== undefined) {
+                localVarQueryParameter['days'] = days;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+    };
+};
+/**
+ * AdminPlayersApi - functional programming interface
+ */
+export const AdminPlayersApiFp = function (configuration) {
+    const localVarAxiosParamCreator = AdminPlayersApiAxiosParamCreator(configuration);
+    return {
+        /**
+         * 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, adminCreateAltExemptionRequest, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.addAltExemption(uuid, adminCreateAltExemptionRequest, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.addAltExemption']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.bulkRevokePropagated(adminBulkRevokeRequest, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.bulkRevokePropagated']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, adminCreatePlayerNoteRequest, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.createPlayerNote(uuid, adminCreatePlayerNoteRequest, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.createPlayerNote']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, noteId, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.deletePlayerNote(uuid, noteId, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.deletePlayerNote']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.getPlayer(uuid, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.getPlayer']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, pageable, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.getPlayerAlts(uuid, pageable, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.getPlayerAlts']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, pageable, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.getPlayerConnections(uuid, pageable, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.getPlayerConnections']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, pageable, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.getPlayerPunishments(uuid, pageable, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.getPlayerPunishments']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.getSessionStats(uuid, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.getSessionStats']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, pageable, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.listAltExemptions(uuid, pageable, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.listAltExemptions']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, pageable, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.listPlayerNotes(uuid, pageable, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.listPlayerNotes']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, search, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.listPlayers(pageable, search, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.listPlayers']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, pageable, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.listSessions(uuid, pageable, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.listSessions']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, altPlayerUuid, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.removeAltExemption(uuid, altPlayerUuid, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.removeAltExemption']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, playerPunishmentId, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.revokePropagatedLink(uuid, playerPunishmentId, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.revokePropagatedLink']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, adminSetAggressiveModeImmunityRequest, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.setAggressiveModeImmunity(uuid, adminSetAggressiveModeImmunityRequest, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.setAggressiveModeImmunity']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.trustFactorBreakdown(uuid, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.trustFactorBreakdown']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, days, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.trustFactorHistory(uuid, days, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPlayersApi.trustFactorHistory']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+    };
+};
+/**
+ * AdminPlayersApi - factory interface
+ */
+export const AdminPlayersApiFactory = function (configuration, basePath, axios) {
+    const localVarFp = AdminPlayersApiFp(configuration);
+    return {
+        /**
+         * 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, adminCreateAltExemptionRequest, options) {
+            return localVarFp.addAltExemption(uuid, adminCreateAltExemptionRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, options) {
+            return localVarFp.bulkRevokePropagated(adminBulkRevokeRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, adminCreatePlayerNoteRequest, options) {
+            return localVarFp.createPlayerNote(uuid, adminCreatePlayerNoteRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, noteId, options) {
+            return localVarFp.deletePlayerNote(uuid, noteId, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, options) {
+            return localVarFp.getPlayer(uuid, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, pageable, options) {
+            return localVarFp.getPlayerAlts(uuid, pageable, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, pageable, options) {
+            return localVarFp.getPlayerConnections(uuid, pageable, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, pageable, options) {
+            return localVarFp.getPlayerPunishments(uuid, pageable, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, options) {
+            return localVarFp.getSessionStats(uuid, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, pageable, options) {
+            return localVarFp.listAltExemptions(uuid, pageable, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, pageable, options) {
+            return localVarFp.listPlayerNotes(uuid, pageable, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, search, options) {
+            return localVarFp.listPlayers(pageable, search, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, pageable, options) {
+            return localVarFp.listSessions(uuid, pageable, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, altPlayerUuid, options) {
+            return localVarFp.removeAltExemption(uuid, altPlayerUuid, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, playerPunishmentId, options) {
+            return localVarFp.revokePropagatedLink(uuid, playerPunishmentId, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, adminSetAggressiveModeImmunityRequest, options) {
+            return localVarFp.setAggressiveModeImmunity(uuid, adminSetAggressiveModeImmunityRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, options) {
+            return localVarFp.trustFactorBreakdown(uuid, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, days, options) {
+            return localVarFp.trustFactorHistory(uuid, days, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+/**
+ * AdminPlayersApi - object-oriented interface
+ */
+export 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, adminCreateAltExemptionRequest, options) {
+        return AdminPlayersApiFp(this.configuration).addAltExemption(uuid, adminCreateAltExemptionRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, options) {
+        return AdminPlayersApiFp(this.configuration).bulkRevokePropagated(adminBulkRevokeRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, adminCreatePlayerNoteRequest, options) {
+        return AdminPlayersApiFp(this.configuration).createPlayerNote(uuid, adminCreatePlayerNoteRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, noteId, options) {
+        return AdminPlayersApiFp(this.configuration).deletePlayerNote(uuid, noteId, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, options) {
+        return AdminPlayersApiFp(this.configuration).getPlayer(uuid, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, pageable, options) {
+        return AdminPlayersApiFp(this.configuration).getPlayerAlts(uuid, pageable, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, pageable, options) {
+        return AdminPlayersApiFp(this.configuration).getPlayerConnections(uuid, pageable, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, pageable, options) {
+        return AdminPlayersApiFp(this.configuration).getPlayerPunishments(uuid, pageable, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, options) {
+        return AdminPlayersApiFp(this.configuration).getSessionStats(uuid, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, pageable, options) {
+        return AdminPlayersApiFp(this.configuration).listAltExemptions(uuid, pageable, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, pageable, options) {
+        return AdminPlayersApiFp(this.configuration).listPlayerNotes(uuid, pageable, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, search, options) {
+        return AdminPlayersApiFp(this.configuration).listPlayers(pageable, search, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, pageable, options) {
+        return AdminPlayersApiFp(this.configuration).listSessions(uuid, pageable, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, altPlayerUuid, options) {
+        return AdminPlayersApiFp(this.configuration).removeAltExemption(uuid, altPlayerUuid, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, playerPunishmentId, options) {
+        return AdminPlayersApiFp(this.configuration).revokePropagatedLink(uuid, playerPunishmentId, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, adminSetAggressiveModeImmunityRequest, options) {
+        return AdminPlayersApiFp(this.configuration).setAggressiveModeImmunity(uuid, adminSetAggressiveModeImmunityRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, options) {
+        return AdminPlayersApiFp(this.configuration).trustFactorBreakdown(uuid, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, days, options) {
+        return AdminPlayersApiFp(this.configuration).trustFactorHistory(uuid, days, options).then((request) => request(this.axios, this.basePath));
+    }
+}
+/**
+ * AdminPunishmentsApi - axios parameter creator
+ */
+export const AdminPunishmentsApiAxiosParamCreator = function (configuration) {
+    return {
+        /**
+         * Apply a punishment to one or more targets. The authenticated user is recorded as the issuer.
+         * @summary Apply punishment
+         * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        applyPunishment: (adminApplyPunishmentRequest_1, ...args_1) => __awaiter(this, [adminApplyPunishmentRequest_1, ...args_1], void 0, function* (adminApplyPunishmentRequest, options = {}) {
+            // verify required parameter 'adminApplyPunishmentRequest' is not null or undefined
+            assertParamExists('applyPunishment', 'adminApplyPunishmentRequest', adminApplyPunishmentRequest);
+            const localVarPath = `/admin/punishment/apply`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(adminApplyPunishmentRequest, localVarRequestOptions, configuration);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * Preview the impact of a punishment across one or more targets. No changes are made.
+         * @summary Evaluate punishment impact
+         * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        createDraft: (adminCreatePunishmentDraftRequest_1, ...args_1) => __awaiter(this, [adminCreatePunishmentDraftRequest_1, ...args_1], void 0, function* (adminCreatePunishmentDraftRequest, options = {}) {
+            // verify required parameter 'adminCreatePunishmentDraftRequest' is not null or undefined
+            assertParamExists('createDraft', 'adminCreatePunishmentDraftRequest', adminCreatePunishmentDraftRequest);
+            const localVarPath = `/admin/punishment/draft`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(adminCreatePunishmentDraftRequest, localVarRequestOptions, configuration);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, adminUpdatePunishmentRequest_1, ...args_1) => __awaiter(this, [id_1, adminUpdatePunishmentRequest_1, ...args_1], void 0, function* (id, adminUpdatePunishmentRequest, options = {}) {
+            // verify required parameter 'id' is not null or undefined
+            assertParamExists('editPunishment', 'id', id);
+            // verify required parameter 'adminUpdatePunishmentRequest' is not null or undefined
+            assertParamExists('editPunishment', 'adminUpdatePunishmentRequest', adminUpdatePunishmentRequest);
+            const localVarPath = `/admin/punishment/{id}`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'PATCH' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(adminUpdatePunishmentRequest, localVarRequestOptions, configuration);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
+         * @summary List punishments
+         * @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_1, uuid_1, username_1, ipAddress_1, type_1, issuedAfter_1, issuedBefore_1, ...args_1) => __awaiter(this, [pageable_1, uuid_1, username_1, ipAddress_1, type_1, issuedAfter_1, issuedBefore_1, ...args_1], void 0, function* (pageable, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options = {}) {
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('getPunishments', 'pageable', pageable);
+            const localVarPath = `/admin/punishment`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (uuid !== undefined) {
+                localVarQueryParameter['uuid'] = uuid;
+            }
+            if (username !== undefined) {
+                localVarQueryParameter['username'] = username;
+            }
+            if (ipAddress !== undefined) {
+                localVarQueryParameter['ipAddress'] = ipAddress;
+            }
+            if (type) {
+                localVarQueryParameter['type'] = type.join(COLLECTION_FORMATS.csv);
+            }
+            if (issuedAfter !== undefined) {
+                localVarQueryParameter['issuedAfter'] = issuedAfter;
+            }
+            if (issuedBefore !== undefined) {
+                localVarQueryParameter['issuedBefore'] = issuedBefore;
+            }
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * Search for players by UUID or username, or look up all players associated with an IP address.
+         * @summary Search punishment targets
+         * @param {string} q UUID, username, or partial/full IP address to search for
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        searchTargets: (q_1, ...args_1) => __awaiter(this, [q_1, ...args_1], void 0, function* (q, options = {}) {
+            // verify required parameter 'q' is not null or undefined
+            assertParamExists('searchTargets', 'q', q);
+            const localVarPath = `/admin/punishment/search`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (q !== undefined) {
+                localVarQueryParameter['q'] = q;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+    };
+};
+/**
+ * AdminPunishmentsApi - functional programming interface
+ */
+export const AdminPunishmentsApiFp = function (configuration) {
+    const localVarAxiosParamCreator = AdminPunishmentsApiAxiosParamCreator(configuration);
+    return {
+        /**
+         * Apply a punishment to one or more targets. The authenticated user is recorded as the issuer.
+         * @summary Apply punishment
+         * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        applyPunishment(adminApplyPunishmentRequest, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.applyPunishment(adminApplyPunishmentRequest, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPunishmentsApi.applyPunishment']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
         /**
          * Preview the impact of a punishment across one or more targets. No changes are made.
          * @summary Evaluate punishment impact
@@ -1446,151 +3396,376 @@ export const AdminPunishmentsApiFp = function (configuration) {
             });
         },
         /**
-         * 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)
+         * 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, adminUpdatePunishmentRequest, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.editPunishment(id, adminUpdatePunishmentRequest, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPunishmentsApi.editPunishment']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
+         * @summary List punishments
+         * @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, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.getPunishments(pageable, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPunishmentsApi.getPunishments']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * Search for players by UUID or username, or look up all players associated with an IP address.
+         * @summary Search punishment targets
+         * @param {string} q UUID, username, or partial/full IP address to search for
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        searchTargets(q, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.searchTargets(q, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPunishmentsApi.searchTargets']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+    };
+};
+/**
+ * AdminPunishmentsApi - factory interface
+ */
+export const AdminPunishmentsApiFactory = function (configuration, basePath, axios) {
+    const localVarFp = AdminPunishmentsApiFp(configuration);
+    return {
+        /**
+         * Apply a punishment to one or more targets. The authenticated user is recorded as the issuer.
+         * @summary Apply punishment
+         * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        applyPunishment(adminApplyPunishmentRequest, options) {
+            return localVarFp.applyPunishment(adminApplyPunishmentRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Preview the impact of a punishment across one or more targets. No changes are made.
+         * @summary Evaluate punishment impact
+         * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        createDraft(adminCreatePunishmentDraftRequest, options) {
+            return localVarFp.createDraft(adminCreatePunishmentDraftRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, adminUpdatePunishmentRequest, options) {
+            return localVarFp.editPunishment(id, adminUpdatePunishmentRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
+         * @summary List punishments
+         * @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, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options) {
+            return localVarFp.getPunishments(pageable, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Search for players by UUID or username, or look up all players associated with an IP address.
+         * @summary Search punishment targets
+         * @param {string} q UUID, username, or partial/full IP address to search for
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        searchTargets(q, options) {
+            return localVarFp.searchTargets(q, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+/**
+ * AdminPunishmentsApi - object-oriented interface
+ */
+export class AdminPunishmentsApi extends BaseAPI {
+    /**
+     * Apply a punishment to one or more targets. The authenticated user is recorded as the issuer.
+     * @summary Apply punishment
+     * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    applyPunishment(adminApplyPunishmentRequest, options) {
+        return AdminPunishmentsApiFp(this.configuration).applyPunishment(adminApplyPunishmentRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * Preview the impact of a punishment across one or more targets. No changes are made.
+     * @summary Evaluate punishment impact
+     * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createDraft(adminCreatePunishmentDraftRequest, options) {
+        return AdminPunishmentsApiFp(this.configuration).createDraft(adminCreatePunishmentDraftRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, adminUpdatePunishmentRequest, options) {
+        return AdminPunishmentsApiFp(this.configuration).editPunishment(id, adminUpdatePunishmentRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
+     * @summary List punishments
+     * @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, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options) {
+        return AdminPunishmentsApiFp(this.configuration).getPunishments(pageable, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * Search for players by UUID or username, or look up all players associated with an IP address.
+     * @summary Search punishment targets
+     * @param {string} q UUID, username, or partial/full IP address to search for
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    searchTargets(q, options) {
+        return AdminPunishmentsApiFp(this.configuration).searchTargets(q, options).then((request) => request(this.axios, this.basePath));
+    }
+}
+/**
+ * AdminReportsApi - axios parameter creator
+ */
+export const AdminReportsApiAxiosParamCreator = function (configuration) {
+    return {
+        /**
+         * 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_1, reportedUuid_1, openOnly_1, ...args_1) => __awaiter(this, [pageable_1, reportedUuid_1, openOnly_1, ...args_1], void 0, function* (pageable, reportedUuid, openOnly, options = {}) {
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('list1', 'pageable', pageable);
+            const localVarPath = `/admin/report`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            if (reportedUuid !== undefined) {
+                localVarQueryParameter['reportedUuid'] = reportedUuid;
+            }
+            if (openOnly !== undefined) {
+                localVarQueryParameter['openOnly'] = openOnly;
+            }
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, adminResolveReportRequest_1, ...args_1) => __awaiter(this, [id_1, adminResolveReportRequest_1, ...args_1], void 0, function* (id, adminResolveReportRequest, options = {}) {
+            // verify required parameter 'id' is not null or undefined
+            assertParamExists('resolve', 'id', id);
+            // verify required parameter 'adminResolveReportRequest' is not null or undefined
+            assertParamExists('resolve', 'adminResolveReportRequest', adminResolveReportRequest);
+            const localVarPath = `/admin/report/{id}/resolve`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(adminResolveReportRequest, localVarRequestOptions, configuration);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+    };
+};
+/**
+ * AdminReportsApi - functional programming interface
+ */
+export const AdminReportsApiFp = function (configuration) {
+    const localVarAxiosParamCreator = AdminReportsApiAxiosParamCreator(configuration);
+    return {
+        /**
+         * 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}
          */
-        getPunishments(page, limit, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options) {
+        list1(pageable, reportedUuid, openOnly, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.getPunishments(page, limit, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.list1(pageable, reportedUuid, openOnly, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
-                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPunishmentsApi.getPunishments']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminReportsApi.list1']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
         /**
-         * Search for players by UUID or username, or look up all players associated with an IP address.
-         * @summary Search punishment targets
-         * @param {string} q UUID, username, or partial/full IP address to search for
+         * 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}
          */
-        searchTargets(q, options) {
+        resolve(id, adminResolveReportRequest, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.searchTargets(q, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.resolve(id, adminResolveReportRequest, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
-                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminPunishmentsApi.searchTargets']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['AdminReportsApi.resolve']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
     };
 };
 /**
- * AdminPunishmentsApi - factory interface
+ * AdminReportsApi - factory interface
  */
-export const AdminPunishmentsApiFactory = function (configuration, basePath, axios) {
-    const localVarFp = AdminPunishmentsApiFp(configuration);
+export const AdminReportsApiFactory = function (configuration, basePath, axios) {
+    const localVarFp = AdminReportsApiFp(configuration);
     return {
         /**
-         * Apply a punishment to one or more targets. The authenticated user is recorded as the issuer.
-         * @summary Apply punishment
-         * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest
-         * @param {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        applyPunishment(adminApplyPunishmentRequest, options) {
-            return localVarFp.applyPunishment(adminApplyPunishmentRequest, options).then((request) => request(axios, basePath));
-        },
-        /**
-         * Preview the impact of a punishment across one or more targets. No changes are made.
-         * @summary Evaluate punishment impact
-         * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest
-         * @param {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        createDraft(adminCreatePunishmentDraftRequest, options) {
-            return localVarFp.createDraft(adminCreatePunishmentDraftRequest, options).then((request) => request(axios, basePath));
-        },
-        /**
-         * 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)
+         * 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}
          */
-        getPunishments(page, limit, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options) {
-            return localVarFp.getPunishments(page, limit, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options).then((request) => request(axios, basePath));
+        list1(pageable, reportedUuid, openOnly, options) {
+            return localVarFp.list1(pageable, reportedUuid, openOnly, options).then((request) => request(axios, basePath));
         },
         /**
-         * Search for players by UUID or username, or look up all players associated with an IP address.
-         * @summary Search punishment targets
-         * @param {string} q UUID, username, or partial/full IP address to search for
+         * 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}
          */
-        searchTargets(q, options) {
-            return localVarFp.searchTargets(q, options).then((request) => request(axios, basePath));
+        resolve(id, adminResolveReportRequest, options) {
+            return localVarFp.resolve(id, adminResolveReportRequest, options).then((request) => request(axios, basePath));
         },
     };
 };
 /**
- * AdminPunishmentsApi - object-oriented interface
+ * AdminReportsApi - object-oriented interface
  */
-export class AdminPunishmentsApi extends BaseAPI {
-    /**
-     * Apply a punishment to one or more targets. The authenticated user is recorded as the issuer.
-     * @summary Apply punishment
-     * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    applyPunishment(adminApplyPunishmentRequest, options) {
-        return AdminPunishmentsApiFp(this.configuration).applyPunishment(adminApplyPunishmentRequest, options).then((request) => request(this.axios, this.basePath));
-    }
-    /**
-     * Preview the impact of a punishment across one or more targets. No changes are made.
-     * @summary Evaluate punishment impact
-     * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    createDraft(adminCreatePunishmentDraftRequest, options) {
-        return AdminPunishmentsApiFp(this.configuration).createDraft(adminCreatePunishmentDraftRequest, options).then((request) => request(this.axios, this.basePath));
-    }
+export class AdminReportsApi extends BaseAPI {
     /**
-     * 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)
+     * 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}
      */
-    getPunishments(page, limit, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options) {
-        return AdminPunishmentsApiFp(this.configuration).getPunishments(page, limit, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options).then((request) => request(this.axios, this.basePath));
+    list1(pageable, reportedUuid, openOnly, options) {
+        return AdminReportsApiFp(this.configuration).list1(pageable, reportedUuid, openOnly, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Search for players by UUID or username, or look up all players associated with an IP address.
-     * @summary Search punishment targets
-     * @param {string} q UUID, username, or partial/full IP address to search for
+     * 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}
      */
-    searchTargets(q, options) {
-        return AdminPunishmentsApiFp(this.configuration).searchTargets(q, options).then((request) => request(this.axios, this.basePath));
+    resolve(id, adminResolveReportRequest, options) {
+        return AdminReportsApiFp(this.configuration).resolve(id, adminResolveReportRequest, options).then((request) => request(this.axios, this.basePath));
     }
 }
 /**
@@ -1913,15 +4088,13 @@ export const ChatApiAxiosParamCreator = function (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_1, sessionId_1, before_1, ...args_1) => __awaiter(this, [limit_1, sessionId_1, before_1, ...args_1], void 0, function* (limit, sessionId, before, options = {}) {
-            // verify required parameter 'limit' is not null or undefined
-            assertParamExists('history', 'limit', limit);
+        history: (sessionId_1, before_1, limit_1, ...args_1) => __awaiter(this, [sessionId_1, before_1, limit_1, ...args_1], void 0, function* (sessionId, before, limit, options = {}) {
             const localVarPath = `/v1/chat`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -1998,16 +4171,16 @@ export const ChatApiFp = function (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, sessionId, before, options) {
+        history(sessionId, before, limit, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.history(limit, sessionId, before, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.history(sessionId, before, limit, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = operationServerMap['ChatApi.history']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -2040,14 +4213,14 @@ export const ChatApiFactory = function (configuration, basePath, axios) {
         /**
          * 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, sessionId, before, options) {
-            return localVarFp.history(limit, sessionId, before, options).then((request) => request(axios, basePath));
+        history(sessionId, before, limit, options) {
+            return localVarFp.history(sessionId, before, limit, options).then((request) => request(axios, basePath));
         },
         /**
          * 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.
@@ -2068,14 +4241,14 @@ export 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, sessionId, before, options) {
-        return ChatApiFp(this.configuration).history(limit, sessionId, before, options).then((request) => request(this.axios, this.basePath));
+    history(sessionId, before, limit, options) {
+        return ChatApiFp(this.configuration).history(sessionId, before, limit, options).then((request) => request(this.axios, this.basePath));
     }
     /**
      * 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.
@@ -2094,19 +4267,18 @@ export class ChatApi extends BaseAPI {
 export const ConnectionApiAxiosParamCreator = function (configuration) {
     return {
         /**
-         * 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_1, forceRecheck_1, associateUuid_1, ...args_1) => __awaiter(this, [ip_1, forceRecheck_1, associateUuid_1, ...args_1], void 0, function* (ip, forceRecheck, associateUuid, options = {}) {
             // verify required parameter 'ip' is not null or undefined
             assertParamExists('getConnectionDetails', 'ip', ip);
-            // verify required parameter 'forceRecheck' is not null or undefined
-            assertParamExists('getConnectionDetails', 'forceRecheck', forceRecheck);
             const localVarPath = `/v1/connection/get-connection-details/{ip}`
                 .replace(`{${"ip"}}`, encodeURIComponent(String(ip)));
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
@@ -2145,12 +4317,13 @@ export const ConnectionApiFp = function (configuration) {
     const localVarAxiosParamCreator = ConnectionApiAxiosParamCreator(configuration);
     return {
         /**
-         * 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, forceRecheck, associateUuid, options) {
@@ -2171,12 +4344,13 @@ export const ConnectionApiFactory = function (configuration, basePath, axios) {
     const localVarFp = ConnectionApiFp(configuration);
     return {
         /**
-         * 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, forceRecheck, associateUuid, options) {
@@ -2189,12 +4363,13 @@ export const ConnectionApiFactory = function (configuration, basePath, axios) {
  */
 export 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, forceRecheck, associateUuid, options) {
@@ -2369,6 +4544,173 @@ export class PlayerApi extends BaseAPI {
         return PlayerApiFp(this.configuration).getUsernames(uuids, options).then((request) => request(this.axios, this.basePath));
     }
 }
+/**
+ * PlayerSessionsApi - axios parameter creator
+ */
+export const PlayerSessionsApiAxiosParamCreator = function (configuration) {
+    return {
+        /**
+         * 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_1, ...args_1) => __awaiter(this, [playerSessionEndRequest_1, ...args_1], void 0, function* (playerSessionEndRequest, options = {}) {
+            // verify required parameter 'playerSessionEndRequest' is not null or undefined
+            assertParamExists('end', 'playerSessionEndRequest', playerSessionEndRequest);
+            const localVarPath = `/v1/player-session/end`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(playerSessionEndRequest, localVarRequestOptions, configuration);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * 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_1, ...args_1) => __awaiter(this, [playerSessionStartRequest_1, ...args_1], void 0, function* (playerSessionStartRequest, options = {}) {
+            // verify required parameter 'playerSessionStartRequest' is not null or undefined
+            assertParamExists('start', 'playerSessionStartRequest', playerSessionStartRequest);
+            const localVarPath = `/v1/player-session/start`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(playerSessionStartRequest, localVarRequestOptions, configuration);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+    };
+};
+/**
+ * PlayerSessionsApi - functional programming interface
+ */
+export const PlayerSessionsApiFp = function (configuration) {
+    const localVarAxiosParamCreator = PlayerSessionsApiAxiosParamCreator(configuration);
+    return {
+        /**
+         * 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, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.end(playerSessionEndRequest, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PlayerSessionsApi.end']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * 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, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.start(playerSessionStartRequest, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PlayerSessionsApi.start']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+    };
+};
+/**
+ * PlayerSessionsApi - factory interface
+ */
+export const PlayerSessionsApiFactory = function (configuration, basePath, axios) {
+    const localVarFp = PlayerSessionsApiFp(configuration);
+    return {
+        /**
+         * 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, options) {
+            return localVarFp.end(playerSessionEndRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 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, options) {
+            return localVarFp.start(playerSessionStartRequest, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+/**
+ * PlayerSessionsApi - object-oriented interface
+ */
+export 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, options) {
+        return PlayerSessionsApiFp(this.configuration).end(playerSessionEndRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * 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, options) {
+        return PlayerSessionsApiFp(this.configuration).start(playerSessionStartRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+}
 /**
  * PunishmentApi - axios parameter creator
  */
@@ -2486,23 +4828,20 @@ export const PunishmentApiAxiosParamCreator = function (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_1, page_1, issuedAfter_1, issuedBefore_1, expiresAfter_1, expiresBefore_1, type_1, uuid_1, ipAddress_1, ...args_1) => __awaiter(this, [limit_1, page_1, issuedAfter_1, issuedBefore_1, expiresAfter_1, expiresBefore_1, type_1, uuid_1, ipAddress_1, ...args_1], void 0, function* (limit, page, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options = {}) {
-            // verify required parameter 'limit' is not null or undefined
-            assertParamExists('getRecentPunishments', 'limit', limit);
-            // verify required parameter 'page' is not null or undefined
-            assertParamExists('getRecentPunishments', 'page', page);
+        getRecentPunishments: (pageable_1, issuedAfter_1, issuedBefore_1, expiresAfter_1, expiresBefore_1, type_1, uuid_1, ipAddress_1, ...args_1) => __awaiter(this, [pageable_1, issuedAfter_1, issuedBefore_1, expiresAfter_1, expiresBefore_1, type_1, uuid_1, ipAddress_1, ...args_1], void 0, function* (pageable, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options = {}) {
+            // verify required parameter 'pageable' is not null or undefined
+            assertParamExists('getRecentPunishments', 'pageable', pageable);
             const localVarPath = `/v1/punishment/recent`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -2537,11 +4876,8 @@ export const PunishmentApiAxiosParamCreator = function (configuration) {
             if (ipAddress !== undefined) {
                 localVarQueryParameter['ipAddress'] = ipAddress;
             }
-            if (limit !== undefined) {
-                localVarQueryParameter['limit'] = limit;
-            }
-            if (page !== undefined) {
-                localVarQueryParameter['page'] = page;
+            if (pageable !== undefined) {
+                localVarQueryParameter['pageable'] = pageable;
             }
             localVarHeaderParameter['Accept'] = 'application/json';
             setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -2613,22 +4949,21 @@ export const PunishmentApiFp = function (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, page, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options) {
+        getRecentPunishments(pageable, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.getRecentPunishments(limit, page, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.getRecentPunishments(pageable, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PunishmentApi.getRecentPunishments']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -2677,20 +5012,19 @@ export const PunishmentApiFactory = function (configuration, basePath, axios) {
         /**
          * 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, page, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options) {
-            return localVarFp.getRecentPunishments(limit, page, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options).then((request) => request(axios, basePath));
+        getRecentPunishments(pageable, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options) {
+            return localVarFp.getRecentPunishments(pageable, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options).then((request) => request(axios, basePath));
         },
     };
 };
@@ -2733,20 +5067,117 @@ export 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, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options) {
+        return PunishmentApiFp(this.configuration).getRecentPunishments(pageable, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options).then((request) => request(this.axios, this.basePath));
+    }
+}
+/**
+ * ReportApi - axios parameter creator
+ */
+export const ReportApiAxiosParamCreator = function (configuration) {
+    return {
+        /**
+         * 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_1, ...args_1) => __awaiter(this, [createReportRequest_1, ...args_1], void 0, function* (createReportRequest, options = {}) {
+            // verify required parameter 'createReportRequest' is not null or undefined
+            assertParamExists('submit', 'createReportRequest', createReportRequest);
+            const localVarPath = `/v1/report`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(createReportRequest, localVarRequestOptions, configuration);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+    };
+};
+/**
+ * ReportApi - functional programming interface
+ */
+export const ReportApiFp = function (configuration) {
+    const localVarAxiosParamCreator = ReportApiAxiosParamCreator(configuration);
+    return {
+        /**
+         * 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, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.submit(createReportRequest, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['ReportApi.submit']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+    };
+};
+/**
+ * ReportApi - factory interface
+ */
+export const ReportApiFactory = function (configuration, basePath, axios) {
+    const localVarFp = ReportApiFp(configuration);
+    return {
+        /**
+         * 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, options) {
+            return localVarFp.submit(createReportRequest, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+/**
+ * ReportApi - object-oriented interface
+ */
+export 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, page, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options) {
-        return PunishmentApiFp(this.configuration).getRecentPunishments(limit, page, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options).then((request) => request(this.axios, this.basePath));
+    submit(createReportRequest, options) {
+        return ReportApiFp(this.configuration).submit(createReportRequest, options).then((request) => request(this.axios, this.basePath));
     }
 }
 /**