@rebornteam/reborn-api 2.6.0 → 2.6.4

package/api.ts

@@ -4,7 +4,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication 
  *
- * The version of the OpenAPI document: 2.6.0
+ * The version of the OpenAPI document: 2.6.4
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -23,6 +23,90 @@ import type { RequestArgs } from './base';
 // @ts-ignore
 import { BASE_PATH, COLLECTION_FORMATS, BaseAPI, RequiredError, operationServerMap } from './base';
 
+/**
+ * Request to apply a punishment to one or more targets
+ */
+export interface AdminApplyPunishmentRequest {
+    /**
+     * List of targets to punish — each must have either a uuid or ipAddress
+     */
+    'targets': Array<AdminPunishmentTarget>;
+    /**
+     * Punishment type
+     */
+    'type': AdminApplyPunishmentRequestTypeEnum;
+    /**
+     * Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical
+     */
+    'severity'?: number;
+    /**
+     * Reason for the punishment
+     */
+    'reason': string;
+    /**
+     * Custom duration in seconds — if omitted the suggested duration for the type and severity is used
+     */
+    'durationSeconds'?: number | null;
+    /**
+     * Force the punishment to be permanent regardless of the target\'s current score
+     */
+    'forcePermanent'?: boolean;
+    /**
+     * Internal notes visible only to administrators — not shown to the punished player
+     */
+    'notes'?: string | null;
+}
+
+export const AdminApplyPunishmentRequestTypeEnum = {
+    Ban: 'BAN',
+    Mute: 'MUTE',
+    Warning: 'WARNING'
+} as const;
+
+export type AdminApplyPunishmentRequestTypeEnum = typeof AdminApplyPunishmentRequestTypeEnum[keyof typeof AdminApplyPunishmentRequestTypeEnum];
+
+/**
+ * Batch punishment apply result — one result per target
+ */
+export interface AdminApplyPunishmentResponse {
+    /**
+     * Ordered list of results, one per target in the request
+     */
+    'results'?: Array<AdminApplyPunishmentResult>;
+}
+/**
+ * Result of applying a punishment to a single target
+ */
+export interface AdminApplyPunishmentResult {
+    /**
+     * The target this result applies to
+     */
+    'target'?: AdminPunishmentTarget;
+    /**
+     * ID of the created punishment record
+     */
+    'punishmentId'?: number;
+    /**
+     * Punishment type applied
+     */
+    'type'?: string;
+    /**
+     * Severity level applied
+     */
+    'severity'?: number;
+    /**
+     * Updated punishment score after applying
+     */
+    'newScore'?: number;
+    /**
+     * Whether the punishment was made permanent
+     */
+    'isPermanent'?: boolean;
+    /**
+     * When the punishment expires — null if permanent or a WARNING
+     */
+    'expiresAt'?: string | null;
+}
 /**
  * Client credential response
  */
@@ -81,6 +165,44 @@ export interface AdminConnectionBypassResponse {
      */
     'createdAt'?: string;
 }
+/**
+ * Request to evaluate the impact of a punishment across one or more targets before applying
+ */
+export interface AdminCreatePunishmentDraftRequest {
+    /**
+     * List of targets to evaluate — each must have either a uuid or ipAddress
+     */
+    'targets': Array<AdminPunishmentTarget>;
+    /**
+     * Punishment type
+     */
+    'type': AdminCreatePunishmentDraftRequestTypeEnum;
+    /**
+     * Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical
+     */
+    'severity'?: number;
+    /**
+     * Reason for the punishment (not used in evaluation, required for apply)
+     */
+    'reason': string;
+    /**
+     * Custom duration in seconds — if omitted the suggested duration for the type and severity is used
+     */
+    'durationSeconds'?: number | null;
+    /**
+     * Force the punishment to be permanent regardless of the target\'s current score
+     */
+    'forcePermanent'?: boolean;
+}
+
+export const AdminCreatePunishmentDraftRequestTypeEnum = {
+    Ban: 'BAN',
+    Mute: 'MUTE',
+    Warning: 'WARNING'
+} as const;
+
+export type AdminCreatePunishmentDraftRequestTypeEnum = typeof AdminCreatePunishmentDraftRequestTypeEnum[keyof typeof AdminCreatePunishmentDraftRequestTypeEnum];
+
 export interface AdminDashboardConnectionResponse {
     'id': number;
     'ipAddress': string;
@@ -98,6 +220,19 @@ export interface AdminGetDashboardStats {
     'totalConnections': number;
     'totalClients': number;
 }
+/**
+ * A single IP address match in a punishment search, with all players ever seen on that IP
+ */
+export interface AdminIpSearchResult {
+    /**
+     * IP address
+     */
+    'ipAddress'?: string;
+    /**
+     * Players ever seen on this IP
+     */
+    'players'?: Array<AdminPlayerSearchResult>;
+}
 /**
  * Paginated connection list response
  */
@@ -155,7 +290,7 @@ export interface AdminPagedPunishmentResponse {
     /**
      * Punishments on the current page
      */
-    'data'?: Array<PunishmentGetPunishmentResponse>;
+    'data'?: Array<AdminPunishmentListItem>;
     /**
      * Total number of punishments matching the filters
      */
@@ -214,6 +349,19 @@ export interface AdminPlayerDetailResponse {
      */
     'usernameHistory'?: Array<AdminUsernameHistoryEntry>;
 }
+/**
+ * Lightweight player reference used in search results and punishment evaluations
+ */
+export interface AdminPlayerSearchResult {
+    /**
+     * Player Minecraft UUID
+     */
+    'uuid'?: string;
+    /**
+     * Most recently seen username, null if never recorded
+     */
+    'username'?: string | null;
+}
 /**
  * Summary of a player record, used in list views
  */
@@ -252,79 +400,123 @@ export interface AdminPlayerSummary {
     'punishmentPointsPercent'?: number;
 }
 /**
- * A single entry in a player\'s username history
+ * Batch punishment draft — one evaluation per target
  */
-export interface AdminUsernameHistoryEntry {
+export interface AdminPunishmentDraftResponse {
     /**
-     * The username at this point in time
-     */
-    'username'?: string;
-    /**
-     * When this username was first observed (ISO-8601)
+     * Ordered list of evaluations, one per target in the request
      */
-    'changedAt'?: string;
+    'evaluations'?: Array<AdminPunishmentEvaluation>;
 }
 /**
- * Request to apply a punishment to a player
+ * Evaluation of a punishment\'s impact on a single target
  */
-export interface ApplyPunishmentRequest {
+export interface AdminPunishmentEvaluation {
     /**
-     * Player UUID to punish
+     * The target this evaluation applies to
      */
-    'playerUuid': string;
+    'target'?: AdminPunishmentTarget;
     /**
-     * Reason for the punishment
+     * Players affected — one player for UUID targets, all players on the IP for connection targets
      */
-    'reason': string;
+    'affectedPlayers'?: Array<AdminPlayerSearchResult>;
     /**
-     * Type of punishment
+     * Current punishment score before applying this punishment (0–100+)
      */
-    'type': string;
+    'currentScore'?: number;
     /**
-     * Severity level of the punishment (1-10)
+     * Points this punishment would add to the score
      */
-    'severity': number;
+    'pointsToAdd'?: number;
     /**
-     * Staff member applying the punishment
+     * Projected score after applying this punishment
      */
-    'createdBy': string;
+    'newScore'?: number;
     /**
-     * Duration of the punishment in seconds. Null means permanent.
+     * Whether this punishment would be permanent based on the current score threshold
+     */
+    'willBePermanent'?: boolean;
+    /**
+     * Resolved duration in seconds — null if permanent or a WARNING
      */
     'durationSeconds'?: number | null;
+    /**
+     * Number of existing punishments on this target
+     */
+    'previousPunishmentCount'?: number;
+    /**
+     * True when the target is an IP address (connection punishment) rather than a player UUID
+     */
+    'isConnectionTarget'?: boolean;
+    /**
+     * The effective punishment type that will be applied — may differ from the requested type if escalated to BAN at threshold
+     */
+    'effectiveType'?: string;
+}
+export interface AdminPunishmentListItem {
+    'id': number;
+    'reason': string;
+    'notes'?: string | null;
+    'type': string;
+    'severity': number;
+    'createdBy': string;
+    'expiresAt'?: string | null;
+    'createdAt': string;
+    'targetType': string;
+    'targetUuid'?: string | null;
+    'targetUsername'?: string | null;
+    'targetIp'?: string | null;
 }
 /**
- * Response after applying a punishment
+ * Result of a punishment target search — either a list of matching players or a list of matching IP addresses
  */
-export interface ApplyPunishmentResponse {
+export interface AdminPunishmentSearchResponse {
     /**
-     * ID of the created punishment
+     * Search kind — \'player\' for UUID/username searches, \'ip\' for IP address searches
      */
-    'punishmentId'?: number;
+    'kind'?: AdminPunishmentSearchResponseKindEnum;
     /**
-     * Player UUID punished
+     * Matching players — only populated when kind=\'player\'
      */
-    'playerUuid'?: string;
+    'players'?: Array<AdminPlayerSearchResult>;
     /**
-     * Type of punishment applied
+     * Matching IP addresses with their associated players — only populated when kind=\'ip\'
      */
-    'type'?: string;
+    'ipResults'?: Array<AdminIpSearchResult>;
+}
+
+export const AdminPunishmentSearchResponseKindEnum = {
+    Player: 'player',
+    Ip: 'ip'
+} as const;
+
+export type AdminPunishmentSearchResponseKindEnum = typeof AdminPunishmentSearchResponseKindEnum[keyof typeof AdminPunishmentSearchResponseKindEnum];
+
+/**
+ * A target for a punishment — either a player UUID or an IP address (mutually exclusive)
+ */
+export interface AdminPunishmentTarget {
     /**
-     * Severity level (1-10)
+     * Player Minecraft UUID
      */
-    'severity'?: number;
+    'uuid'?: string | null;
     /**
-     * New total punishment score after applying
+     * IP address — when specified, the punishment is linked to the connection record and all players on that IP are shown as affected
      */
-    'newScore'?: number;
+    'ipAddress'?: string | null;
+}
+/**
+ * A single entry in a player\'s username history
+ */
+export interface AdminUsernameHistoryEntry {
     /**
-     * Whether this punishment is permanent
+     * The username at this point in time
      */
-    'isPermanent'?: boolean;
+    'username'?: string;
     /**
-     * Timestamp when punishment expires (ISO-8601 format, null if permanent)
+     * When this username was first observed (ISO-8601)
      */
-    'expiresAt'?: string;
+    'changedAt'?: string;
 }
 /**
  * Request to create new client credentials
@@ -390,31 +582,6 @@ export interface CreateBypassRequest {
      */
     'expiresAtEpoch': number;
 }
-/**
- * Request to create a punishment draft for preview before applying
- */
-export interface CreatePunishmentDraftRequest {
-    /**
-     * Player UUID to punish
-     */
-    'playerUuid': string;
-    /**
-     * Reason for the punishment
-     */
-    'reason': string;
-    /**
-     * Type of punishment
-     */
-    'type': string;
-    /**
-     * Severity level of the punishment (1-10)
-     */
-    'severity': number;
-    /**
-     * Duration of the punishment in seconds. Null means permanent.
-     */
-    'durationSeconds'?: number | null;
-}
 /**
  * Player information including join history, tracking data, and punishment scoring
  */
@@ -436,51 +603,6 @@ export interface PlayerGetPlayerInformation {
      */
     'punishmentPointsPercent'?: number;
 }
-/**
- * Response containing punishment draft preview with calculated points and thresholds
- */
-export interface PunishmentDraftResponse {
-    /**
-     * Player UUID this punishment would apply to
-     */
-    'playerUuid'?: string;
-    /**
-     * Reason for the punishment
-     */
-    'reason'?: string;
-    /**
-     * Type of punishment
-     */
-    'type'?: string;
-    /**
-     * Severity level (1-10)
-     */
-    'severity'?: number;
-    /**
-     * Current total punishment score before applying this punishment
-     */
-    'currentScore'?: number;
-    /**
-     * Points this punishment would add
-     */
-    'pointsToAdd'?: number;
-    /**
-     * New total score after applying this punishment
-     */
-    'newScore'?: number;
-    /**
-     * Whether this punishment will be permanent
-     */
-    'willBePermanent'?: boolean;
-    /**
-     * Duration in seconds (null if permanent)
-     */
-    'durationSeconds'?: number;
-    /**
-     * Number of previous punishments for this player
-     */
-    'previousPunishmentCount'?: number;
-}
 /**
  * Punishment information including reason, type, creator, and expiration
  */
@@ -490,15 +612,19 @@ export interface PunishmentGetPunishmentResponse {
      */
     'id'?: number;
     /**
-     * Reason for the punishment
+     * Reason for the punishment, shown to the punished player
      */
     'reason'?: string;
     /**
-     * Type of punishment (e.g., BAN, MUTE, KICK, WARNING)
+     * Internal administrator notes — not shown to the punished player
+     */
+    'notes'?: string | null;
+    /**
+     * Type of punishment (BAN, MUTE, WARNING)
      */
     'type'?: string;
     /**
-     * Severity level of the punishment (1-10, where 10 is most severe)
+     * Severity level (1=Minor, 2=Moderate, 3=Severe, 4=Critical)
      */
     'severity'?: number;
     /**
@@ -1732,6 +1858,84 @@ export class AdminPlayersApi extends BaseAPI {
  */
 export const AdminPunishmentsApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
+        /**
+         * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+         * @summary Apply punishment
+         * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        applyPunishment: async (adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // 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 = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...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. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+         * @summary Evaluate punishment impact
+         * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        createDraft: async (adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // 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 = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(adminCreatePunishmentDraftRequest, 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
@@ -1740,7 +1944,7 @@ export const AdminPunishmentsApiAxiosParamCreator = function (configuration?: Co
          * @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<string> | null} [type] Filter by punishment type (BAN, MUTE, KICK, WARNING). Repeatable.
+         * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, WARNING). 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.
@@ -1805,6 +2009,47 @@ export const AdminPunishmentsApiAxiosParamCreator = function (configuration?: Co
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...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. Used to populate the target table before issuing a punishment.
+         * @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: async (q: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // 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 = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await 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 = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
             return {
                 url: toPathString(localVarUrlObj),
                 options: localVarRequestOptions,
@@ -1819,6 +2064,32 @@ export const AdminPunishmentsApiAxiosParamCreator = function (configuration?: Co
 export const AdminPunishmentsApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = AdminPunishmentsApiAxiosParamCreator(configuration)
     return {
+        /**
+         * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+         * @summary Apply punishment
+         * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async applyPunishment(adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminApplyPunishmentResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.applyPunishment(adminApplyPunishmentRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminPunishmentsApi.applyPunishment']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+         * @summary Evaluate punishment impact
+         * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async createDraft(adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPunishmentDraftResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.createDraft(adminCreatePunishmentDraftRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminPunishmentsApi.createDraft']?.[localVarOperationServerIndex]?.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
@@ -1827,7 +2098,7 @@ export const AdminPunishmentsApiFp = function(configuration?: Configuration) {
          * @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<string> | null} [type] Filter by punishment type (BAN, MUTE, KICK, WARNING). Repeatable.
+         * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, WARNING). 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.
@@ -1839,6 +2110,19 @@ export const AdminPunishmentsApiFp = function(configuration?: Configuration) {
             const localVarOperationServerBasePath = operationServerMap['AdminPunishmentsApi.getPunishments']?.[localVarOperationServerIndex]?.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. Used to populate the target table before issuing a punishment.
+         * @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}
+         */
+        async searchTargets(q: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPunishmentSearchResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.searchTargets(q, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminPunishmentsApi.searchTargets']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
     }
 };
 
@@ -1848,6 +2132,26 @@ export const AdminPunishmentsApiFp = function(configuration?: Configuration) {
 export const AdminPunishmentsApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
     const localVarFp = AdminPunishmentsApiFp(configuration)
     return {
+        /**
+         * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+         * @summary Apply punishment
+         * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        applyPunishment(adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminApplyPunishmentResponse> {
+            return localVarFp.applyPunishment(adminApplyPunishmentRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+         * @summary Evaluate punishment impact
+         * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        createDraft(adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminPunishmentDraftResponse> {
+            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
@@ -1856,7 +2160,7 @@ export const AdminPunishmentsApiFactory = function (configuration?: Configuratio
          * @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<string> | null} [type] Filter by punishment type (BAN, MUTE, KICK, WARNING). Repeatable.
+         * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, WARNING). 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.
@@ -1865,6 +2169,16 @@ export const AdminPunishmentsApiFactory = function (configuration?: Configuratio
         getPunishments(page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<string> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<AdminPagedPunishmentResponse> {
             return localVarFp.getPunishments(page, limit, 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. Used to populate the target table before issuing a punishment.
+         * @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: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminPunishmentSearchResponse> {
+            return localVarFp.searchTargets(q, options).then((request) => request(axios, basePath));
+        },
     };
 };
 
@@ -1872,6 +2186,28 @@ export const AdminPunishmentsApiFactory = function (configuration?: Configuratio
  * AdminPunishmentsApi - object-oriented interface
  */
 export class AdminPunishmentsApi extends BaseAPI {
+    /**
+     * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+     * @summary Apply punishment
+     * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public applyPunishment(adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig) {
+        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. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+     * @summary Evaluate punishment impact
+     * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public createDraft(adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig) {
+        return AdminPunishmentsApiFp(this.configuration).createDraft(adminCreatePunishmentDraftRequest, 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
@@ -1880,7 +2216,7 @@ export class AdminPunishmentsApi extends BaseAPI {
      * @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<string> | null} [type] Filter by punishment type (BAN, MUTE, KICK, WARNING). Repeatable.
+     * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, WARNING). 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.
@@ -1889,6 +2225,17 @@ export class AdminPunishmentsApi extends BaseAPI {
     public getPunishments(page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<string> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig) {
         return AdminPunishmentsApiFp(this.configuration).getPunishments(page, limit, 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. Used to populate the target table before issuing a punishment.
+     * @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}
+     */
+    public searchTargets(q: string, options?: RawAxiosRequestConfig) {
+        return AdminPunishmentsApiFp(this.configuration).searchTargets(q, options).then((request) => request(this.axios, this.basePath));
+    }
 }
 
 
@@ -2297,84 +2644,6 @@ export class PlayerApi extends BaseAPI {
  */
 export const PunishmentApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
-        /**
-         * Create and apply a punishment to a player. Automatically determines if permanent based on current score threshold (≥100%).
-         * @summary Apply a punishment
-         * @param {ApplyPunishmentRequest} applyPunishmentRequest 
-         * @param {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        applyPunishment: async (applyPunishmentRequest: ApplyPunishmentRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'applyPunishmentRequest' is not null or undefined
-            assertParamExists('applyPunishment', 'applyPunishmentRequest', applyPunishmentRequest)
-            const localVarPath = `/v1/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 = { method: 'POST', ...baseOptions, ...options};
-            const localVarHeaderParameter = {} as any;
-            const localVarQueryParameter = {} as any;
-
-            // authentication DiscordAuth required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
-
-            localVarHeaderParameter['Content-Type'] = 'application/json';
-            localVarHeaderParameter['Accept'] = 'application/json';
-
-            setSearchParams(localVarUrlObj, localVarQueryParameter);
-            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
-            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
-            localVarRequestOptions.data = serializeDataIfNeeded(applyPunishmentRequest, localVarRequestOptions, configuration)
-
-            return {
-                url: toPathString(localVarUrlObj),
-                options: localVarRequestOptions,
-            };
-        },
-        /**
-         * Preview punishment impact before applying. Returns calculated points, current/new thresholds, and whether it will be permanent.
-         * @summary Create a punishment draft
-         * @param {CreatePunishmentDraftRequest} createPunishmentDraftRequest 
-         * @param {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        createPunishmentDraft: async (createPunishmentDraftRequest: CreatePunishmentDraftRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'createPunishmentDraftRequest' is not null or undefined
-            assertParamExists('createPunishmentDraft', 'createPunishmentDraftRequest', createPunishmentDraftRequest)
-            const localVarPath = `/v1/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 = { method: 'POST', ...baseOptions, ...options};
-            const localVarHeaderParameter = {} as any;
-            const localVarQueryParameter = {} as any;
-
-            // authentication DiscordAuth required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
-
-            localVarHeaderParameter['Content-Type'] = 'application/json';
-            localVarHeaderParameter['Accept'] = 'application/json';
-
-            setSearchParams(localVarUrlObj, localVarQueryParameter);
-            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
-            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
-            localVarRequestOptions.data = serializeDataIfNeeded(createPunishmentDraftRequest, localVarRequestOptions, configuration)
-
-            return {
-                url: toPathString(localVarUrlObj),
-                options: localVarRequestOptions,
-            };
-        },
         /**
          * Retrieve duration information for each punishment type and severity level (1-10)
          * @summary Get punishment severities
@@ -2596,32 +2865,6 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
 export const PunishmentApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = PunishmentApiAxiosParamCreator(configuration)
     return {
-        /**
-         * Create and apply a punishment to a player. Automatically determines if permanent based on current score threshold (≥100%).
-         * @summary Apply a punishment
-         * @param {ApplyPunishmentRequest} applyPunishmentRequest 
-         * @param {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        async applyPunishment(applyPunishmentRequest: ApplyPunishmentRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ApplyPunishmentResponse>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.applyPunishment(applyPunishmentRequest, options);
-            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['PunishmentApi.applyPunishment']?.[localVarOperationServerIndex]?.url;
-            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
-        },
-        /**
-         * Preview punishment impact before applying. Returns calculated points, current/new thresholds, and whether it will be permanent.
-         * @summary Create a punishment draft
-         * @param {CreatePunishmentDraftRequest} createPunishmentDraftRequest 
-         * @param {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        async createPunishmentDraft(createPunishmentDraftRequest: CreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PunishmentDraftResponse>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.createPunishmentDraft(createPunishmentDraftRequest, options);
-            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['PunishmentApi.createPunishmentDraft']?.[localVarOperationServerIndex]?.url;
-            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
-        },
         /**
          * Retrieve duration information for each punishment type and severity level (1-10)
          * @summary Get punishment severities
@@ -2693,26 +2936,6 @@ export const PunishmentApiFp = function(configuration?: Configuration) {
 export const PunishmentApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
     const localVarFp = PunishmentApiFp(configuration)
     return {
-        /**
-         * Create and apply a punishment to a player. Automatically determines if permanent based on current score threshold (≥100%).
-         * @summary Apply a punishment
-         * @param {ApplyPunishmentRequest} applyPunishmentRequest 
-         * @param {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        applyPunishment(applyPunishmentRequest: ApplyPunishmentRequest, options?: RawAxiosRequestConfig): AxiosPromise<ApplyPunishmentResponse> {
-            return localVarFp.applyPunishment(applyPunishmentRequest, options).then((request) => request(axios, basePath));
-        },
-        /**
-         * Preview punishment impact before applying. Returns calculated points, current/new thresholds, and whether it will be permanent.
-         * @summary Create a punishment draft
-         * @param {CreatePunishmentDraftRequest} createPunishmentDraftRequest 
-         * @param {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        createPunishmentDraft(createPunishmentDraftRequest: CreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): AxiosPromise<PunishmentDraftResponse> {
-            return localVarFp.createPunishmentDraft(createPunishmentDraftRequest, options).then((request) => request(axios, basePath));
-        },
         /**
          * Retrieve duration information for each punishment type and severity level (1-10)
          * @summary Get punishment severities
@@ -2770,28 +2993,6 @@ export const PunishmentApiFactory = function (configuration?: Configuration, bas
  * PunishmentApi - object-oriented interface
  */
 export class PunishmentApi extends BaseAPI {
-    /**
-     * Create and apply a punishment to a player. Automatically determines if permanent based on current score threshold (≥100%).
-     * @summary Apply a punishment
-     * @param {ApplyPunishmentRequest} applyPunishmentRequest 
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    public applyPunishment(applyPunishmentRequest: ApplyPunishmentRequest, options?: RawAxiosRequestConfig) {
-        return PunishmentApiFp(this.configuration).applyPunishment(applyPunishmentRequest, options).then((request) => request(this.axios, this.basePath));
-    }
-
-    /**
-     * Preview punishment impact before applying. Returns calculated points, current/new thresholds, and whether it will be permanent.
-     * @summary Create a punishment draft
-     * @param {CreatePunishmentDraftRequest} createPunishmentDraftRequest 
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    public createPunishmentDraft(createPunishmentDraftRequest: CreatePunishmentDraftRequest, options?: RawAxiosRequestConfig) {
-        return PunishmentApiFp(this.configuration).createPunishmentDraft(createPunishmentDraftRequest, options).then((request) => request(this.axios, this.basePath));
-    }
-
     /**
      * Retrieve duration information for each punishment type and severity level (1-10)
      * @summary Get punishment severities