@rebornteam/reborn-api 2.9.1 → 3.1.0

package/dist/esm/api.d.ts

@@ -2,7 +2,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 2.9.1
+ * The version of the OpenAPI document: 3.1.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -24,7 +24,7 @@ export interface AdminApplyPunishmentRequest {
     /**
      * Punishment type
      */
-    'type': AdminApplyPunishmentRequestTypeEnum;
+    'type': PunishmentType;
     /**
      * Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical
      */
@@ -46,12 +46,6 @@ export interface AdminApplyPunishmentRequest {
      */
     'notes'?: string | null;
 }
-export declare const AdminApplyPunishmentRequestTypeEnum: {
-    readonly Ban: "BAN";
-    readonly Mute: "MUTE";
-    readonly Warning: "WARNING";
-};
-export type AdminApplyPunishmentRequestTypeEnum = typeof AdminApplyPunishmentRequestTypeEnum[keyof typeof AdminApplyPunishmentRequestTypeEnum];
 /**
  * Batch punishment apply result — one result per target
  */
@@ -76,7 +70,7 @@ export interface AdminApplyPunishmentResult {
     /**
      * Punishment type applied
      */
-    'type'?: string;
+    'type'?: PunishmentType;
     /**
      * Severity level applied
      */
@@ -152,6 +146,23 @@ export interface AdminConnectionBypassResponse {
      */
     'createdAt'?: string;
 }
+/**
+ * Result from a single VPN detection service for a given IP address
+ */
+export interface AdminConnectionCheckResult {
+    /**
+     * Service identifier
+     */
+    'service'?: string;
+    /**
+     * Whether this service flagged the IP as a VPN, proxy, or Tor exit node
+     */
+    'result'?: boolean;
+    /**
+     * When this check was last performed
+     */
+    'checkedAt'?: string;
+}
 /**
  * Request to evaluate the impact of a punishment across one or more targets before applying
  */
@@ -163,7 +174,7 @@ export interface AdminCreatePunishmentDraftRequest {
     /**
      * Punishment type
      */
-    'type': AdminCreatePunishmentDraftRequestTypeEnum;
+    'type': PunishmentType;
     /**
      * Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical
      */
@@ -181,12 +192,6 @@ export interface AdminCreatePunishmentDraftRequest {
      */
     'forcePermanent'?: boolean;
 }
-export declare const AdminCreatePunishmentDraftRequestTypeEnum: {
-    readonly Ban: "BAN";
-    readonly Mute: "MUTE";
-    readonly Warning: "WARNING";
-};
-export type AdminCreatePunishmentDraftRequestTypeEnum = typeof AdminCreatePunishmentDraftRequestTypeEnum[keyof typeof AdminCreatePunishmentDraftRequestTypeEnum];
 export interface AdminDashboardConnectionResponse {
     'id': number;
     'ipAddress': string;
@@ -198,6 +203,10 @@ export interface AdminDashboardConnectionResponse {
     'lastSeen'?: string | null;
     'percentPositive': number;
     'numberOfChecks': number;
+    /**
+     * Results from each VPN detection service for this IP address
+     */
+    'results'?: Array<AdminConnectionCheckResult>;
 }
 export interface AdminGetDashboardStats {
     'totalPlayers': number;
@@ -435,18 +444,18 @@ export interface AdminPunishmentEvaluation {
     /**
      * The effective punishment type that will be applied — may differ from the requested type if escalated to BAN at threshold
      */
-    'effectiveType'?: string;
+    'effectiveType'?: PunishmentType;
 }
 export interface AdminPunishmentListItem {
     'id': number;
     'reason': string;
     'notes'?: string | null;
-    'type': string;
+    'type': PunishmentType;
     'severity': number;
     'createdBy': string;
     'expiresAt'?: string | null;
     'createdAt': string;
-    'targetType': string;
+    'targetType': PunishmentTargetType;
     'targetUuid'?: string | null;
     'targetUsername'?: string | null;
     'targetIp'?: string | null;
@@ -456,9 +465,9 @@ export interface AdminPunishmentListItem {
  */
 export interface AdminPunishmentSearchResponse {
     /**
-     * Search kind — \'player\' for UUID/username searches, \'ip\' for IP address searches
+     * Search kind — PLAYER for UUID/username searches, IP for IP address searches
      */
-    'kind'?: AdminPunishmentSearchResponseKindEnum;
+    'kind'?: SearchKind;
     /**
      * Matching players — only populated when kind=\'player\'
      */
@@ -468,11 +477,6 @@ export interface AdminPunishmentSearchResponse {
      */
     'ipResults'?: Array<AdminIpSearchResult>;
 }
-export declare const AdminPunishmentSearchResponseKindEnum: {
-    readonly Player: "player";
-    readonly Ip: "ip";
-};
-export type AdminPunishmentSearchResponseKindEnum = typeof AdminPunishmentSearchResponseKindEnum[keyof typeof AdminPunishmentSearchResponseKindEnum];
 /**
  * A target for a punishment — either a player UUID or an IP address (mutually exclusive)
  */
@@ -539,31 +543,60 @@ export interface ConnectionGetConnectionDetailsResponse {
      */
     'ipAddress'?: string;
     /**
-     * Approximate geographic location of the IP address, typically in \'City, Country\' format. Returns \'Local, N/A\' for localhost or private IPs.
+     * Approximate geographic location of the IP address. Returns \'Local, N/A\' for localhost or private IPs.
      */
     'approximateLocation'?: string;
     /**
-     * Confidence score representing the percentage of VPN detection services that flagged this IP as suspicious. Range: 0.0 (clean) to 100.0 (definitely VPN/proxy). Values above 50.0 suggest high probability of VPN usage.
+     * Confidence score representing the percentage of VPN detection services that flagged this IP as suspicious. Range: 0.0 (clean) to 100.0 (definitely VPN/proxy).
      */
     'percentPositive'?: number;
     /**
-     * Total number of VPN detection services successfully queried during the last check. Higher numbers indicate more comprehensive analysis.
+     * Total number of VPN detection services successfully queried during the last check.
      */
     'numberOfChecks'?: number;
-    'bypassed'?: boolean;
     /**
-     * Expiration timestamp for the bypass (ISO-8601 format). After this time, normal VPN detection rules will apply again. Null if not bypassed or bypass is permanent.
+     * Indicates if this IP address has been administratively bypassed.
+     */
+    'isBypassed'?: boolean;
+    /**
+     * Expiration timestamp for the bypass (ISO-8601 format). Null if not bypassed or bypass is permanent.
      */
     'bypassedUntil'?: string | null;
     /**
-     * Player information associated with this connection. Only populated when \'associate_uuid\' query parameter is provided. Contains first join status and login history.
+     * Results from each VPN detection service that checked this IP address
+     */
+    'results'?: Array<AdminConnectionCheckResult>;
+    /**
+     * Player information associated with this connection. Only populated when \'associate_uuid\' query parameter is provided.
      */
     'playerInformation'?: PlayerGetPlayerInformation | null;
     /**
      * Combined list of active punishments for both the IP address and player UUID (if provided). Only includes non-expired punishments.
      */
     'punishments'?: Array<PunishmentGetPunishmentResponse>;
+    /**
+     * Join enforcement result. Only populated when \'associate_uuid\' query parameter is provided. Contains the final allow/deny decision and a formatted kick message if denied.
+     */
+    'connectionResult'?: ConnectionResult | null;
+}
+/**
+ * Join enforcement result. Only populated when \'associate_uuid\' query parameter is provided. Contains the final allow/deny decision and a formatted kick message if denied.
+ */
+export interface ConnectionResult {
+    'code': ConnectionResultResultCode;
+    'allowed': boolean;
+    'message'?: string | null;
 }
+export declare const ConnectionResultResultCode: {
+    readonly Allowed: "ALLOWED";
+    readonly AllowedBypass: "ALLOWED_BYPASS";
+    readonly AllowedPlayerBypass: "ALLOWED_PLAYER_BYPASS";
+    readonly Banned: "BANNED";
+    readonly VpnDetected: "VPN_DETECTED";
+    readonly VpnRetry: "VPN_RETRY";
+    readonly VpnTempBanned: "VPN_TEMP_BANNED";
+};
+export type ConnectionResultResultCode = typeof ConnectionResultResultCode[keyof typeof ConnectionResultResultCode];
 /**
  * Request to create a connection bypass
  */
@@ -577,24 +610,30 @@ export interface CreateBypassRequest {
      */
     'expiresAtEpoch': number;
 }
+export declare const GameType: {
+    readonly Rotj: "ROTJ";
+    readonly Legacy: "LEGACY";
+    readonly Classic: "CLASSIC";
+};
+export type GameType = typeof GameType[keyof typeof GameType];
 /**
  * Player information including join history, tracking data, and punishment scoring
  */
 export interface PlayerGetPlayerInformation {
     /**
-     * Timestamp of when the player first connected to the server (ISO-8601 format).
+     * Indicates whether this is the player\'s first time joining the server.
      */
-    'firstLogin'?: string;
+    'firstJoin'?: boolean;
     /**
-     * Indicates whether this is the player\'s first time joining the server. Useful for triggering welcome messages, tutorials, or first-join rewards.
+     * Timestamp of when the player first connected to the server (ISO-8601 format).
      */
-    'firstJoin'?: boolean;
+    'firstLogin'?: string;
     /**
-     * Raw punishment score calculated as: SUM((base_weight × severity/10)) where base_weight is 0.10 for WARNING, 0.30 for MUTE, 0.50 for BAN. Severity ranges 1-10. Used for tracking overall punishment severity.
+     * Raw punishment score calculated as: SUM((base_weight × severity/10)). Used for tracking overall punishment severity.
      */
     'punishmentPointsRaw'?: number;
     /**
-     * Punishment score as a percentage (0-100). When this score is >100% BEFORE applying a new punishment, the new punishment should be made permanent. Check this value BEFORE issuing punishment, not after. Calculated as raw_score × 100.
+     * Punishment score as a percentage (0-100). When >100% before applying a new punishment, the new punishment should be made permanent.
      */
     'punishmentPointsPercent'?: number;
 }
@@ -615,9 +654,9 @@ export interface PunishmentGetPunishmentResponse {
      */
     'notes'?: string | null;
     /**
-     * Type of punishment (BAN, MUTE, WARNING)
+     * Type of punishment
      */
-    'type'?: string;
+    'type'?: PunishmentType;
     /**
      * Severity level (1=Minor, 2=Moderate, 3=Severe, 4=Critical)
      */
@@ -651,7 +690,7 @@ export interface PunishmentSeveritiesResponsePunishmentTypeInfo {
     /**
      * Type of punishment
      */
-    'type'?: string;
+    'type'?: PunishmentType;
     /**
      * List of severity levels with durations
      */
@@ -670,21 +709,46 @@ export interface PunishmentSeveritiesResponseSeverityInfo {
      */
     'durationSeconds'?: number;
 }
+export declare const PunishmentTargetType: {
+    readonly Player: "PLAYER";
+    readonly Connection: "CONNECTION";
+};
+export type PunishmentTargetType = typeof PunishmentTargetType[keyof typeof PunishmentTargetType];
+export declare const PunishmentType: {
+    readonly Ban: "BAN";
+    readonly Mute: "MUTE";
+    readonly Warning: "WARNING";
+};
+export type PunishmentType = typeof PunishmentType[keyof typeof PunishmentType];
 export declare const Rank: {
     readonly Administrator: "ADMINISTRATOR";
     readonly Moderator: "MODERATOR";
     readonly Service: "SERVICE";
 };
 export type Rank = typeof Rank[keyof typeof Rank];
+export declare const Region: {
+    readonly Us: "US";
+    readonly Eu: "EU";
+    readonly Au: "AU";
+};
+export type Region = typeof Region[keyof typeof Region];
+/**
+ * Search kind — PLAYER for UUID/username searches, IP for IP address searches
+ */
+export declare const SearchKind: {
+    readonly Player: "PLAYER";
+    readonly Ip: "IP";
+};
+export type SearchKind = typeof SearchKind[keyof typeof SearchKind];
 export interface ServerRegisterRequest {
-    'region': string;
-    'gameType': string;
+    'region': Region;
+    'gameType': GameType;
     'containerId'?: string | null;
 }
 export interface ServerSessionDTO {
     'id': string;
-    'region': string;
-    'gameType': string;
+    'region': Region;
+    'gameType': GameType;
     'instanceName': string;
     'containerId'?: string | null;
     'startedAt': string;
@@ -1000,6 +1064,15 @@ export declare const AdminConnectionsApiAxiosParamCreator: (configuration?: Conf
      * @throws {RequiredError}
      */
     listConnections: (createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
+     * @summary Refresh a single VPN check
+     * @param {number} connectionId
+     * @param {string} service
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    recheckService: (connectionId: number, service: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
 };
 /**
  * AdminConnectionsApi - functional programming interface
@@ -1039,6 +1112,15 @@ export declare const AdminConnectionsApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     listConnections(createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<AdminDashboardConnectionResponse>>>;
+    /**
+     * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
+     * @summary Refresh a single VPN check
+     * @param {number} connectionId
+     * @param {string} service
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    recheckService(connectionId: number, service: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminConnectionCheckResult>>;
 };
 /**
  * AdminConnectionsApi - factory interface
@@ -1078,6 +1160,15 @@ export declare const AdminConnectionsApiFactory: (configuration?: Configuration,
      * @throws {RequiredError}
      */
     listConnections(createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<AdminDashboardConnectionResponse>>;
+    /**
+     * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
+     * @summary Refresh a single VPN check
+     * @param {number} connectionId
+     * @param {string} service
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    recheckService(connectionId: number, service: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminConnectionCheckResult>;
 };
 /**
  * AdminConnectionsApi - object-oriented interface
@@ -1117,6 +1208,15 @@ export declare class AdminConnectionsApi extends BaseAPI {
      * @throws {RequiredError}
      */
     listConnections(createdAfter?: number | null, createdBefore?: number | null, ipAddress?: string | null, uuid?: string | null, isVpn?: boolean | null, page?: number | null, limit?: number | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminDashboardConnectionResponse[], any, {}>>;
+    /**
+     * Re-runs one named VPN detection service for a specific connection, persists the updated result, and recalculates the connection\'s overall `percentPositive` and `numberOfChecks` from all stored checks. Returns the refreshed check result including its new `checkedAt` timestamp.
+     * @summary Refresh a single VPN check
+     * @param {number} connectionId
+     * @param {string} service
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    recheckService(connectionId: number, service: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminConnectionCheckResult, any, {}>>;
 }
 /**
  * AdminDashboardApi - axios parameter creator
@@ -1263,7 +1363,7 @@ export declare class AdminPlayersApi extends BaseAPI {
  */
 export declare const AdminPunishmentsApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
-     * 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.
+     * 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.
@@ -1271,7 +1371,7 @@ export declare const AdminPunishmentsApiAxiosParamCreator: (configuration?: Conf
      */
     applyPunishment: (adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * 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.
+     * 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.
@@ -1286,15 +1386,15 @@ export declare const AdminPunishmentsApiAxiosParamCreator: (configuration?: Conf
      * @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, WARNING). Repeatable.
+     * @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: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<string> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    getPunishments: (page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * 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.
+     * 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.
@@ -1307,7 +1407,7 @@ export declare const AdminPunishmentsApiAxiosParamCreator: (configuration?: Conf
  */
 export declare const AdminPunishmentsApiFp: (configuration?: Configuration) => {
     /**
-     * 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.
+     * 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.
@@ -1315,7 +1415,7 @@ export declare const AdminPunishmentsApiFp: (configuration?: Configuration) => {
      */
     applyPunishment(adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminApplyPunishmentResponse>>;
     /**
-     * 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.
+     * 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.
@@ -1330,15 +1430,15 @@ export declare const AdminPunishmentsApiFp: (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, WARNING). Repeatable.
+     * @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: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<string> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPagedPunishmentResponse>>;
+    getPunishments(page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPagedPunishmentResponse>>;
     /**
-     * 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.
+     * 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.
@@ -1351,7 +1451,7 @@ export declare const AdminPunishmentsApiFp: (configuration?: Configuration) => {
  */
 export declare const AdminPunishmentsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
-     * 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.
+     * 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.
@@ -1359,7 +1459,7 @@ export declare const AdminPunishmentsApiFactory: (configuration?: Configuration,
      */
     applyPunishment(adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminApplyPunishmentResponse>;
     /**
-     * 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.
+     * 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.
@@ -1374,15 +1474,15 @@ export declare const AdminPunishmentsApiFactory: (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, WARNING). Repeatable.
+     * @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: 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>;
+    getPunishments(page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<AdminPagedPunishmentResponse>;
     /**
-     * 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.
+     * 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.
@@ -1395,7 +1495,7 @@ export declare const AdminPunishmentsApiFactory: (configuration?: Configuration,
  */
 export declare 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.
+     * 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.
@@ -1403,7 +1503,7 @@ export declare class AdminPunishmentsApi extends BaseAPI {
      */
     applyPunishment(adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminApplyPunishmentResponse, any, {}>>;
     /**
-     * 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.
+     * 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.
@@ -1418,15 +1518,15 @@ export declare 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, WARNING). Repeatable.
+     * @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: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<string> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPagedPunishmentResponse, any, {}>>;
+    getPunishments(page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPagedPunishmentResponse, any, {}>>;
     /**
-     * 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.
+     * 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.
@@ -1743,17 +1843,17 @@ export declare class ConnectionApi extends BaseAPI {
  */
 export declare const PlayerApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
-     * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials.
+     * Retrieves player information by Minecraft UUID including first join status and login timestamp.
      * @summary Get player information
-     * @param {string} uuid The Minecraft player UUID (with or without dashes)
+     * @param {string} uuid
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     getPlayer1: (uuid: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log.
+     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record are omitted from the response.
      * @summary Batch resolve UUIDs to usernames
-     * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+     * @param {Array<string>} uuids List of player UUIDs to resolve
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -1764,17 +1864,17 @@ export declare const PlayerApiAxiosParamCreator: (configuration?: Configuration)
  */
 export declare const PlayerApiFp: (configuration?: Configuration) => {
     /**
-     * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials.
+     * Retrieves player information by Minecraft UUID including first join status and login timestamp.
      * @summary Get player information
-     * @param {string} uuid The Minecraft player UUID (with or without dashes)
+     * @param {string} uuid
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     getPlayer1(uuid: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PlayerGetPlayerInformation>>;
     /**
-     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log.
+     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record are omitted from the response.
      * @summary Batch resolve UUIDs to usernames
-     * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+     * @param {Array<string>} uuids List of player UUIDs to resolve
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -1785,17 +1885,17 @@ export declare const PlayerApiFp: (configuration?: Configuration) => {
  */
 export declare const PlayerApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
-     * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials.
+     * Retrieves player information by Minecraft UUID including first join status and login timestamp.
      * @summary Get player information
-     * @param {string} uuid The Minecraft player UUID (with or without dashes)
+     * @param {string} uuid
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     getPlayer1(uuid: string, options?: RawAxiosRequestConfig): AxiosPromise<PlayerGetPlayerInformation>;
     /**
-     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log.
+     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record are omitted from the response.
      * @summary Batch resolve UUIDs to usernames
-     * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+     * @param {Array<string>} uuids List of player UUIDs to resolve
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -1806,17 +1906,17 @@ export declare const PlayerApiFactory: (configuration?: Configuration, basePath?
  */
 export declare class PlayerApi extends BaseAPI {
     /**
-     * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials.
+     * Retrieves player information by Minecraft UUID including first join status and login timestamp.
      * @summary Get player information
-     * @param {string} uuid The Minecraft player UUID (with or without dashes)
+     * @param {string} uuid
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     getPlayer1(uuid: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PlayerGetPlayerInformation, any, {}>>;
     /**
-     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log.
+     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record are omitted from the response.
      * @summary Batch resolve UUIDs to usernames
-     * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+     * @param {Array<string>} uuids List of player UUIDs to resolve
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -1838,12 +1938,12 @@ export declare const PunishmentApiAxiosParamCreator: (configuration?: Configurat
      * @summary Get punishments by player
      * @param {string | null} [uuid] Player UUID
      * @param {string | null} [username] Player username
-     * @param {Array<string> | null} [type] Filter by punishment types
+     * @param {Array<PunishmentType> | null} [type] Filter by punishment types
      * @param {number | null} [since] Filter punishments created after this Unix epoch timestamp (milliseconds)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getPunishments1: (uuid?: string | null, username?: string | null, type?: Array<string> | null, since?: number | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    getPunishments1: (uuid?: string | null, username?: string | null, type?: Array<PunishmentType> | null, since?: number | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Retrieve all active punishments associated with an IP address
      * @summary Get punishments by IP address
@@ -1861,13 +1961,13 @@ export declare const PunishmentApiAxiosParamCreator: (configuration?: Configurat
      * @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<string> | null} [type] Filter by punishment types
+     * @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 {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getRecentPunishments: (limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<string> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    getRecentPunishments: (limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<PunishmentType> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
 };
 /**
  * PunishmentApi - functional programming interface
@@ -1885,12 +1985,12 @@ export declare const PunishmentApiFp: (configuration?: Configuration) => {
      * @summary Get punishments by player
      * @param {string | null} [uuid] Player UUID
      * @param {string | null} [username] Player username
-     * @param {Array<string> | null} [type] Filter by punishment types
+     * @param {Array<PunishmentType> | null} [type] Filter by punishment types
      * @param {number | null} [since] Filter punishments created after this Unix epoch timestamp (milliseconds)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getPunishments1(uuid?: string | null, username?: string | null, type?: Array<string> | null, since?: number | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<PunishmentGetPunishmentResponse>>>;
+    getPunishments1(uuid?: string | null, username?: string | null, type?: Array<PunishmentType> | null, since?: number | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<PunishmentGetPunishmentResponse>>>;
     /**
      * Retrieve all active punishments associated with an IP address
      * @summary Get punishments by IP address
@@ -1908,13 +2008,13 @@ export declare const PunishmentApiFp: (configuration?: Configuration) => {
      * @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<string> | null} [type] Filter by punishment types
+     * @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 {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<string> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<PunishmentGetPunishmentResponse>>>;
+    getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<PunishmentType> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<PunishmentGetPunishmentResponse>>>;
 };
 /**
  * PunishmentApi - factory interface
@@ -1932,12 +2032,12 @@ export declare const PunishmentApiFactory: (configuration?: Configuration, baseP
      * @summary Get punishments by player
      * @param {string | null} [uuid] Player UUID
      * @param {string | null} [username] Player username
-     * @param {Array<string> | null} [type] Filter by punishment types
+     * @param {Array<PunishmentType> | null} [type] Filter by punishment types
      * @param {number | null} [since] Filter punishments created after this Unix epoch timestamp (milliseconds)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getPunishments1(uuid?: string | null, username?: string | null, type?: Array<string> | null, since?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<PunishmentGetPunishmentResponse>>;
+    getPunishments1(uuid?: string | null, username?: string | null, type?: Array<PunishmentType> | null, since?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<PunishmentGetPunishmentResponse>>;
     /**
      * Retrieve all active punishments associated with an IP address
      * @summary Get punishments by IP address
@@ -1955,13 +2055,13 @@ export declare const PunishmentApiFactory: (configuration?: Configuration, baseP
      * @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<string> | null} [type] Filter by punishment types
+     * @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 {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<string> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<PunishmentGetPunishmentResponse>>;
+    getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<PunishmentType> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<PunishmentGetPunishmentResponse>>;
 };
 /**
  * PunishmentApi - object-oriented interface
@@ -1979,12 +2079,12 @@ export declare class PunishmentApi extends BaseAPI {
      * @summary Get punishments by player
      * @param {string | null} [uuid] Player UUID
      * @param {string | null} [username] Player username
-     * @param {Array<string> | null} [type] Filter by punishment types
+     * @param {Array<PunishmentType> | null} [type] Filter by punishment types
      * @param {number | null} [since] Filter punishments created after this Unix epoch timestamp (milliseconds)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getPunishments1(uuid?: string | null, username?: string | null, type?: Array<string> | null, since?: number | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PunishmentGetPunishmentResponse[], any, {}>>;
+    getPunishments1(uuid?: string | null, username?: string | null, type?: Array<PunishmentType> | null, since?: number | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PunishmentGetPunishmentResponse[], any, {}>>;
     /**
      * Retrieve all active punishments associated with an IP address
      * @summary Get punishments by IP address
@@ -2002,13 +2102,13 @@ export declare class PunishmentApi extends BaseAPI {
      * @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<string> | null} [type] Filter by punishment types
+     * @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 {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<string> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PunishmentGetPunishmentResponse[], any, {}>>;
+    getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<PunishmentType> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PunishmentGetPunishmentResponse[], any, {}>>;
 }
 /**
  * ServerSessionsApi - axios parameter creator