@rebornteam/reborn-api 3.1.0 → 3.2.1

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: 3.1.0
+ * The version of the OpenAPI document: 3.2.1
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -28,7 +28,7 @@ export interface AdminApplyPunishmentRequest {
     /**
      * Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical
      */
-    'severity'?: number;
+    'severity': number;
     /**
      * Reason for the punishment
      */
@@ -40,7 +40,7 @@ export interface AdminApplyPunishmentRequest {
     /**
      * Force the punishment to be permanent regardless of the target\'s current score
      */
-    'forcePermanent'?: boolean;
+    'forcePermanent': boolean;
     /**
      * Internal notes visible only to administrators — not shown to the punished player
      */
@@ -53,7 +53,7 @@ export interface AdminApplyPunishmentResponse {
     /**
      * Ordered list of results, one per target in the request
      */
-    'results'?: Array<AdminApplyPunishmentResult>;
+    'results': Array<AdminApplyPunishmentResult>;
 }
 /**
  * Result of applying a punishment to a single target
@@ -62,32 +62,49 @@ export interface AdminApplyPunishmentResult {
     /**
      * The target this result applies to
      */
-    'target'?: AdminPunishmentTarget;
+    'target': AdminPunishmentTarget;
     /**
      * ID of the created punishment record
      */
-    'punishmentId'?: number;
+    'punishmentId': number;
     /**
      * Punishment type applied
      */
-    'type'?: PunishmentType;
+    'type': PunishmentType;
     /**
      * Severity level applied
      */
-    'severity'?: number;
+    'severity': number;
     /**
      * Updated punishment score after applying
      */
-    'newScore'?: number;
+    'newScore': number;
     /**
      * Whether the punishment was made permanent
      */
-    'isPermanent'?: boolean;
+    'isPermanent': boolean;
     /**
      * When the punishment expires — null if permanent or a WARNING
      */
     'expiresAt'?: string | null;
 }
+/**
+ * Result of a location backfill run — rechecks every connection_check row missing both city and country, repopulating them from the VPN providers.
+ */
+export interface AdminBackfillLocationResponse {
+    /**
+     * Total checks attempted
+     */
+    'processed': number;
+    /**
+     * Checks where the provider returned at least a city or country
+     */
+    'succeeded': number;
+    /**
+     * Checks that errored or returned no location data
+     */
+    'failed': number;
+}
 /**
  * Client credential response
  */
@@ -95,11 +112,11 @@ export interface AdminClientCredentialResponse {
     /**
      * Unique identifier for the client credential
      */
-    'id'?: number;
+    'id': number;
     /**
      * Client ID used for authentication
      */
-    'clientId'?: string;
+    'clientId': string;
     /**
      * Client secret (only returned on generation/rotation, null otherwise)
      */
@@ -107,19 +124,19 @@ export interface AdminClientCredentialResponse {
     /**
      * Human-readable name for the client
      */
-    'name'?: string;
+    'name': string;
     /**
      * Optional description of the client\'s purpose
      */
-    'description'?: string;
+    'description': string;
     /**
      * Whether the client credential is currently enabled
      */
-    'enabled'?: boolean;
+    'enabled': boolean;
     /**
      * Timestamp when the credential was created (ISO-8601 format)
      */
-    'createdAt'?: string;
+    'createdAt': string;
     /**
      * Timestamp when the credential expires (ISO-8601 format). Null means the credential never expires.
      */
@@ -132,19 +149,19 @@ export interface AdminConnectionBypassResponse {
     /**
      * Unique identifier for the bypass
      */
-    'id'?: number;
+    'id': number;
     /**
      * IP address that is bypassed
      */
-    'ipAddress'?: string;
+    'ipAddress': string;
     /**
      * Timestamp when the bypass expires (ISO-8601 format)
      */
-    'expiresAt'?: string;
+    'expiresAt': string;
     /**
      * Timestamp when the bypass was created (ISO-8601 format)
      */
-    'createdAt'?: string;
+    'createdAt': string;
 }
 /**
  * Result from a single VPN detection service for a given IP address
@@ -153,15 +170,23 @@ export interface AdminConnectionCheckResult {
     /**
      * Service identifier
      */
-    'service'?: string;
+    'service': string;
     /**
      * Whether this service flagged the IP as a VPN, proxy, or Tor exit node
      */
-    'result'?: boolean;
+    'result': boolean;
     /**
      * When this check was last performed
      */
-    'checkedAt'?: string;
+    'checkedAt': string;
+    /**
+     * City reported by this service, if available
+     */
+    'city'?: string | null;
+    /**
+     * Country code reported by this service, if available
+     */
+    'country'?: string | null;
 }
 /**
  * Request to evaluate the impact of a punishment across one or more targets before applying
@@ -178,7 +203,7 @@ export interface AdminCreatePunishmentDraftRequest {
     /**
      * Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical
      */
-    'severity'?: number;
+    'severity': number;
     /**
      * Reason for the punishment (not used in evaluation, required for apply)
      */
@@ -190,12 +215,12 @@ export interface AdminCreatePunishmentDraftRequest {
     /**
      * Force the punishment to be permanent regardless of the target\'s current score
      */
-    'forcePermanent'?: boolean;
+    'forcePermanent': boolean;
 }
 export interface AdminDashboardConnectionResponse {
     'id': number;
     'ipAddress': string;
-    'location': string;
+    'location'?: string | null;
     'isVpn': boolean;
     'isBypassed': boolean;
     'bypassExpiresAt'?: string | null;
@@ -206,7 +231,7 @@ export interface AdminDashboardConnectionResponse {
     /**
      * Results from each VPN detection service for this IP address
      */
-    'results'?: Array<AdminConnectionCheckResult>;
+    'results': Array<AdminConnectionCheckResult>;
 }
 export interface AdminGetDashboardStats {
     'totalPlayers': number;
@@ -220,11 +245,11 @@ export interface AdminIpSearchResult {
     /**
      * IP address
      */
-    'ipAddress'?: string;
+    'ipAddress': string;
     /**
      * Players ever seen on this IP
      */
-    'players'?: Array<AdminPlayerSearchResult>;
+    'players': Array<AdminPlayerSearchResult>;
 }
 /**
  * Paginated connection list response
@@ -233,23 +258,23 @@ export interface AdminPagedConnectionResponse {
     /**
      * Connections on the current page
      */
-    'data'?: Array<AdminDashboardConnectionResponse>;
+    'data': Array<AdminDashboardConnectionResponse>;
     /**
      * Total number of connections matching the filters
      */
-    'total'?: number;
+    'total': number;
     /**
      * Current page (1-indexed)
      */
-    'page'?: number;
+    'page': number;
     /**
      * Page size
      */
-    'limit'?: number;
+    'limit': number;
     /**
      * Total number of pages
      */
-    'totalPages'?: number;
+    'totalPages': number;
 }
 /**
  * Paginated player list response
@@ -258,23 +283,23 @@ export interface AdminPagedPlayerResponse {
     /**
      * Players on the current page
      */
-    'data'?: Array<AdminPlayerSummary>;
+    'data': Array<AdminPlayerSummary>;
     /**
      * Total number of players matching the search filter
      */
-    'total'?: number;
+    'total': number;
     /**
      * Current page (1-indexed)
      */
-    'page'?: number;
+    'page': number;
     /**
      * Page size
      */
-    'limit'?: number;
+    'limit': number;
     /**
      * Total number of pages
      */
-    'totalPages'?: number;
+    'totalPages': number;
 }
 /**
  * Paginated punishment list response
@@ -283,23 +308,23 @@ export interface AdminPagedPunishmentResponse {
     /**
      * Punishments on the current page
      */
-    'data'?: Array<AdminPunishmentListItem>;
+    'data': Array<AdminPunishmentListItem>;
     /**
      * Total number of punishments matching the filters
      */
-    'total'?: number;
+    'total': number;
     /**
      * Current page (1-indexed)
      */
-    'page'?: number;
+    'page': number;
     /**
      * Page size
      */
-    'limit'?: number;
+    'limit': number;
     /**
      * Total number of pages
      */
-    'totalPages'?: number;
+    'totalPages': number;
 }
 /**
  * Full player detail including punishment history and all known usernames
@@ -308,11 +333,11 @@ export interface AdminPlayerDetailResponse {
     /**
      * Internal player ID
      */
-    'id'?: number;
+    'id': number;
     /**
      * Player Minecraft UUID
      */
-    'uuid'?: string;
+    'uuid': string;
     /**
      * Most recently seen username
      */
@@ -320,11 +345,11 @@ export interface AdminPlayerDetailResponse {
     /**
      * Whether this player still has first-join status
      */
-    'firstJoin'?: boolean;
+    'firstJoin': boolean;
     /**
      * Timestamp of first connection (ISO-8601)
      */
-    'firstLogin'?: string;
+    'firstLogin': string;
     /**
      * Timestamp of most recent connection (ISO-8601)
      */
@@ -332,15 +357,15 @@ export interface AdminPlayerDetailResponse {
     /**
      * Raw punishment score
      */
-    'punishmentPointsRaw'?: number;
+    'punishmentPointsRaw': number;
     /**
      * Punishment score as a percentage
      */
-    'punishmentPointsPercent'?: number;
+    'punishmentPointsPercent': number;
     /**
      * All usernames this player has used, newest first
      */
-    'usernameHistory'?: Array<AdminUsernameHistoryEntry>;
+    'usernameHistory': Array<AdminUsernameHistoryEntry>;
 }
 /**
  * Lightweight player reference used in search results and punishment evaluations
@@ -349,7 +374,7 @@ export interface AdminPlayerSearchResult {
     /**
      * Player Minecraft UUID
      */
-    'uuid'?: string;
+    'uuid': string;
     /**
      * Most recently seen username, null if never recorded
      */
@@ -362,11 +387,11 @@ export interface AdminPlayerSummary {
     /**
      * Internal player ID
      */
-    'id'?: number;
+    'id': number;
     /**
      * Player Minecraft UUID
      */
-    'uuid'?: string;
+    'uuid': string;
     /**
      * Most recently seen username, null if never recorded
      */
@@ -374,11 +399,11 @@ export interface AdminPlayerSummary {
     /**
      * Whether this player still has first-join status
      */
-    'firstJoin'?: boolean;
+    'firstJoin': boolean;
     /**
      * Timestamp of first connection (ISO-8601)
      */
-    'firstLogin'?: string;
+    'firstLogin': string;
     /**
      * Timestamp of most recent connection (ISO-8601)
      */
@@ -386,11 +411,11 @@ export interface AdminPlayerSummary {
     /**
      * Raw punishment score (sum of weighted punishment values)
      */
-    'punishmentPointsRaw'?: number;
+    'punishmentPointsRaw': number;
     /**
      * Punishment score as a percentage. Values above 100 indicate future punishments should be permanent.
      */
-    'punishmentPointsPercent'?: number;
+    'punishmentPointsPercent': number;
 }
 /**
  * Batch punishment draft — one evaluation per target
@@ -399,7 +424,7 @@ export interface AdminPunishmentDraftResponse {
     /**
      * Ordered list of evaluations, one per target in the request
      */
-    'evaluations'?: Array<AdminPunishmentEvaluation>;
+    'evaluations': Array<AdminPunishmentEvaluation>;
 }
 /**
  * Evaluation of a punishment\'s impact on a single target
@@ -408,27 +433,27 @@ export interface AdminPunishmentEvaluation {
     /**
      * The target this evaluation applies to
      */
-    'target'?: AdminPunishmentTarget;
+    'target': AdminPunishmentTarget;
     /**
      * Players affected — one player for UUID targets, all players on the IP for connection targets
      */
-    'affectedPlayers'?: Array<AdminPlayerSearchResult>;
+    'affectedPlayers': Array<AdminPlayerSearchResult>;
     /**
      * Current punishment score before applying this punishment (0–100+)
      */
-    'currentScore'?: number;
+    'currentScore': number;
     /**
      * Points this punishment would add to the score
      */
-    'pointsToAdd'?: number;
+    'pointsToAdd': number;
     /**
      * Projected score after applying this punishment
      */
-    'newScore'?: number;
+    'newScore': number;
     /**
      * Whether this punishment would be permanent based on the current score threshold
      */
-    'willBePermanent'?: boolean;
+    'willBePermanent': boolean;
     /**
      * Resolved duration in seconds — null if permanent or a WARNING
      */
@@ -436,15 +461,15 @@ export interface AdminPunishmentEvaluation {
     /**
      * Number of existing punishments on this target
      */
-    'previousPunishmentCount'?: number;
+    'previousPunishmentCount': number;
     /**
      * True when the target is an IP address (connection punishment) rather than a player UUID
      */
-    'isConnectionTarget'?: boolean;
+    'isConnectionTarget': boolean;
     /**
      * The effective punishment type that will be applied — may differ from the requested type if escalated to BAN at threshold
      */
-    'effectiveType'?: PunishmentType;
+    'effectiveType': PunishmentType;
 }
 export interface AdminPunishmentListItem {
     'id': number;
@@ -467,15 +492,15 @@ export interface AdminPunishmentSearchResponse {
     /**
      * Search kind — PLAYER for UUID/username searches, IP for IP address searches
      */
-    'kind'?: SearchKind;
+    'kind': SearchKind;
     /**
      * Matching players — only populated when kind=\'player\'
      */
-    'players'?: Array<AdminPlayerSearchResult>;
+    'players': Array<AdminPlayerSearchResult>;
     /**
      * Matching IP addresses with their associated players — only populated when kind=\'ip\'
      */
-    'ipResults'?: Array<AdminIpSearchResult>;
+    'ipResults': Array<AdminIpSearchResult>;
 }
 /**
  * A target for a punishment — either a player UUID or an IP address (mutually exclusive)
@@ -497,11 +522,11 @@ export interface AdminUsernameHistoryEntry {
     /**
      * The username at this point in time
      */
-    'username'?: string;
+    'username': string;
     /**
      * When this username was first observed (ISO-8601)
      */
-    'changedAt'?: string;
+    'changedAt': string;
 }
 export interface ChatMessageDTO {
     'id': number;
@@ -541,23 +566,23 @@ export interface ConnectionGetConnectionDetailsResponse {
     /**
      * The analyzed IPv4 address
      */
-    'ipAddress'?: string;
+    'ipAddress': string;
     /**
      * Approximate geographic location of the IP address. Returns \'Local, N/A\' for localhost or private IPs.
      */
-    'approximateLocation'?: string;
+    '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).
      */
-    'percentPositive'?: number;
+    'percentPositive': number;
     /**
      * Total number of VPN detection services successfully queried during the last check.
      */
-    'numberOfChecks'?: number;
+    'numberOfChecks': number;
     /**
      * Indicates if this IP address has been administratively bypassed.
      */
-    'isBypassed'?: boolean;
+    'isBypassed': boolean;
     /**
      * Expiration timestamp for the bypass (ISO-8601 format). Null if not bypassed or bypass is permanent.
      */
@@ -565,7 +590,7 @@ export interface ConnectionGetConnectionDetailsResponse {
     /**
      * Results from each VPN detection service that checked this IP address
      */
-    'results'?: Array<AdminConnectionCheckResult>;
+    'results': Array<AdminConnectionCheckResult>;
     /**
      * Player information associated with this connection. Only populated when \'associate_uuid\' query parameter is provided.
      */
@@ -573,7 +598,7 @@ export interface ConnectionGetConnectionDetailsResponse {
     /**
      * Combined list of active punishments for both the IP address and player UUID (if provided). Only includes non-expired punishments.
      */
-    'punishments'?: Array<PunishmentGetPunishmentResponse>;
+    '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.
      */
@@ -623,19 +648,19 @@ export interface PlayerGetPlayerInformation {
     /**
      * Indicates whether this is the player\'s first time joining the server.
      */
-    'firstJoin'?: boolean;
+    'firstJoin': boolean;
     /**
      * Timestamp of when the player first connected to the server (ISO-8601 format).
      */
-    'firstLogin'?: string;
+    'firstLogin': string;
     /**
      * Raw punishment score calculated as: SUM((base_weight × severity/10)). Used for tracking overall punishment severity.
      */
-    'punishmentPointsRaw'?: number;
+    'punishmentPointsRaw': number;
     /**
      * Punishment score as a percentage (0-100). When >100% before applying a new punishment, the new punishment should be made permanent.
      */
-    'punishmentPointsPercent'?: number;
+    'punishmentPointsPercent': number;
 }
 /**
  * Punishment information including reason, type, creator, and expiration
@@ -644,11 +669,11 @@ export interface PunishmentGetPunishmentResponse {
     /**
      * Unique identifier for the punishment
      */
-    'id'?: number;
+    'id': number;
     /**
      * Reason for the punishment, shown to the punished player
      */
-    'reason'?: string;
+    'reason': string;
     /**
      * Internal administrator notes — not shown to the punished player
      */
@@ -656,15 +681,15 @@ export interface PunishmentGetPunishmentResponse {
     /**
      * Type of punishment
      */
-    'type'?: PunishmentType;
+    'type': PunishmentType;
     /**
      * Severity level (1=Minor, 2=Moderate, 3=Severe, 4=Critical)
      */
-    'severity'?: number;
+    'severity': number;
     /**
      * Username or identifier of the person who created this punishment
      */
-    'createdBy'?: string;
+    'createdBy': string;
     /**
      * Timestamp when the punishment expires (ISO-8601 format). Null for permanent punishments.
      */
@@ -672,7 +697,7 @@ export interface PunishmentGetPunishmentResponse {
     /**
      * Timestamp when the punishment was created (ISO-8601 format)
      */
-    'createdAt'?: string;
+    'createdAt': string;
 }
 /**
  * Response containing punishment severity durations for each type
@@ -681,7 +706,7 @@ export interface PunishmentSeveritiesResponse {
     /**
      * List of punishment types with their severity durations
      */
-    'punishmentTypes'?: Array<PunishmentSeveritiesResponsePunishmentTypeInfo>;
+    'punishmentTypes': Array<PunishmentSeveritiesResponsePunishmentTypeInfo>;
 }
 /**
  * Punishment type with severity information
@@ -690,11 +715,11 @@ export interface PunishmentSeveritiesResponsePunishmentTypeInfo {
     /**
      * Type of punishment
      */
-    'type'?: PunishmentType;
+    'type': PunishmentType;
     /**
      * List of severity levels with durations
      */
-    'severities'?: Array<PunishmentSeveritiesResponseSeverityInfo>;
+    'severities': Array<PunishmentSeveritiesResponseSeverityInfo>;
 }
 /**
  * Severity level with duration information
@@ -703,11 +728,11 @@ export interface PunishmentSeveritiesResponseSeverityInfo {
     /**
      * Severity level
      */
-    'severity'?: number;
+    'severity': number;
     /**
      * Duration in seconds (0 means no duration)
      */
-    'durationSeconds'?: number;
+    'durationSeconds': number;
 }
 export declare const PunishmentTargetType: {
     readonly Player: "PLAYER";
@@ -1030,6 +1055,13 @@ export declare class AdminClientCredentialsApi extends BaseAPI {
  * AdminConnectionsApi - axios parameter creator
  */
 export declare const AdminConnectionsApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Iterates every connection_check row where both city and country are NULL and re-runs that row\'s source VPN service to populate location data. Concurrency is capped to avoid overwhelming external providers. Synchronous — returns once the run completes.
+     * @summary Backfill missing location data
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    backfillLocation: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
      * @summary Create connection bypass
@@ -1078,6 +1110,13 @@ export declare const AdminConnectionsApiAxiosParamCreator: (configuration?: Conf
  * AdminConnectionsApi - functional programming interface
  */
 export declare const AdminConnectionsApiFp: (configuration?: Configuration) => {
+    /**
+     * Iterates every connection_check row where both city and country are NULL and re-runs that row\'s source VPN service to populate location data. Concurrency is capped to avoid overwhelming external providers. Synchronous — returns once the run completes.
+     * @summary Backfill missing location data
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    backfillLocation(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminBackfillLocationResponse>>;
     /**
      * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
      * @summary Create connection bypass
@@ -1126,6 +1165,13 @@ export declare const AdminConnectionsApiFp: (configuration?: Configuration) => {
  * AdminConnectionsApi - factory interface
  */
 export declare const AdminConnectionsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Iterates every connection_check row where both city and country are NULL and re-runs that row\'s source VPN service to populate location data. Concurrency is capped to avoid overwhelming external providers. Synchronous — returns once the run completes.
+     * @summary Backfill missing location data
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    backfillLocation(options?: RawAxiosRequestConfig): AxiosPromise<AdminBackfillLocationResponse>;
     /**
      * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
      * @summary Create connection bypass
@@ -1174,6 +1220,13 @@ export declare const AdminConnectionsApiFactory: (configuration?: Configuration,
  * AdminConnectionsApi - object-oriented interface
  */
 export declare class AdminConnectionsApi extends BaseAPI {
+    /**
+     * Iterates every connection_check row where both city and country are NULL and re-runs that row\'s source VPN service to populate location data. Concurrency is capped to avoid overwhelming external providers. Synchronous — returns once the run completes.
+     * @summary Backfill missing location data
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    backfillLocation(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminBackfillLocationResponse, any, {}>>;
     /**
      * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
      * @summary Create connection bypass