@rebornteam/reborn-api 3.2.0 → 4.0.0

package/docs/AdminPunishmentEvaluation.md

@@ -8,14 +8,12 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **target** | [**AdminPunishmentTarget**](AdminPunishmentTarget.md) | The target this evaluation applies to | [default to undefined]
 **affectedPlayers** | [**Array<AdminPlayerSearchResult>**](AdminPlayerSearchResult.md) | Players affected — one player for UUID targets, all players on the IP for connection targets | [default to undefined]
-**currentScore** | **number** | Current punishment score before applying this punishment (0–100+) | [default to undefined]
-**pointsToAdd** | **number** | Points this punishment would add to the score | [default to undefined]
-**newScore** | **number** | Projected score after applying this punishment | [default to undefined]
-**willBePermanent** | **boolean** | Whether this punishment would be permanent based on the current score threshold | [default to undefined]
+**trustFactorImpact** | [**AdminTrustFactorImpact**](AdminTrustFactorImpact.md) | Trust factor preview for the targeted player. Present only when the target is a player; absent for any other target shape. | [optional] [default to undefined]
+**willBePermanent** | **boolean** | Whether this punishment will be permanent. Mirrors the request\'s forcePermanent flag — auto-escalation has been removed. | [default to undefined]
 **durationSeconds** | **number** | Resolved duration in seconds — null if permanent or a WARNING | [optional] [default to undefined]
 **previousPunishmentCount** | **number** | Number of existing punishments on this target | [default to undefined]
 **isConnectionTarget** | **boolean** | True when the target is an IP address (connection punishment) rather than a player UUID | [default to undefined]
-**effectiveType** | [**PunishmentType**](PunishmentType.md) | The effective punishment type that will be applied — may differ from the requested type if escalated to BAN at threshold | [default to undefined]
+**effectiveType** | [**PunishmentType**](PunishmentType.md) | The punishment type that will be applied. Equal to the requested type — auto-escalation has been removed. | [default to undefined]
 
 ## Example
 
@@ -25,9 +23,7 @@ import { AdminPunishmentEvaluation } from '@rebornteam/reborn-api';
 const instance: AdminPunishmentEvaluation = {
     target,
     affectedPlayers,
-    currentScore,
-    pointsToAdd,
-    newScore,
+    trustFactorImpact,
     willBePermanent,
     durationSeconds,
     previousPunishmentCount,

package/docs/AdminPunishmentsApi.md

@@ -6,6 +6,7 @@ All URIs are relative to *https://api.smsh.sh*
 |------------- | ------------- | -------------|
 |[**applyPunishment**](#applypunishment) | **POST** /admin/punishment/apply | Apply punishment|
 |[**createDraft**](#createdraft) | **POST** /admin/punishment/draft | Evaluate punishment impact|
+|[**editPunishment**](#editpunishment) | **PATCH** /admin/punishment/{id} | Edit a punishment|
 |[**getPunishments**](#getpunishments) | **GET** /admin/punishment | List punishments|
 |[**searchTargets**](#searchtargets) | **GET** /admin/punishment/search | Search punishment targets|
 
@@ -119,8 +120,66 @@ const { status, data } = await apiInstance.createDraft(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
+# **editPunishment**
+> editPunishment(adminUpdatePunishmentRequest)
+
+Partial update of a punishment record. Reason / notes / expiresAt are mutable; severity is intentionally immutable to keep the punishment score deterministic. To make a punishment permanent, set forcePermanent=true. The endpoint returns 404 if the id doesn\'t exist, 200 with the updated entity otherwise. Every edit is recorded in admin_audit_log with the before/after payload.
+
+### Example
+
+```typescript
+import {
+    AdminPunishmentsApi,
+    Configuration,
+    AdminUpdatePunishmentRequest
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPunishmentsApi(configuration);
+
+let id: number; //Punishment id (default to undefined)
+let adminUpdatePunishmentRequest: AdminUpdatePunishmentRequest; //
+
+const { status, data } = await apiInstance.editPunishment(
+    id,
+    adminUpdatePunishmentRequest
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **adminUpdatePunishmentRequest** | **AdminUpdatePunishmentRequest**|  | |
+| **id** | [**number**] | Punishment id | defaults to undefined|
+
+
+### Return type
+
+void (empty response body)
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: Not defined
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**204** | Punishment updated |  -  |
+|**404** | Punishment not found |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
 # **getPunishments**
-> AdminPagedPunishmentResponse getPunishments()
+> PageAdminPunishmentListItem getPunishments()
 
 Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
 
@@ -129,24 +188,23 @@ Returns a paginated list of punishments with optional filtering by player UUID,
 ```typescript
 import {
     AdminPunishmentsApi,
-    Configuration
+    Configuration,
+    Pageable
 } from '@rebornteam/reborn-api';
 
 const configuration = new Configuration();
 const apiInstance = new AdminPunishmentsApi(configuration);
 
-let page: number; //Page number (1-indexed) (default to 1)
-let limit: number; //Page size (default to 50)
-let uuid: string; //Filter by player UUID (optional) (default to undefined)
-let username: string; //Filter by player username (case-insensitive substring match) (optional) (default to undefined)
-let ipAddress: string; //Filter by IP address (optional) (default to undefined)
-let type: Array<PunishmentType>; //Filter by punishment type. Repeatable. (optional) (default to undefined)
-let issuedAfter: number; //Filter punishments issued after this epoch timestamp (ms) (optional) (default to undefined)
-let issuedBefore: number; //Filter punishments issued before this epoch timestamp (ms) (optional) (default to undefined)
+let pageable: Pageable; // (default to undefined)
+let uuid: string; // (optional) (default to undefined)
+let username: string; // (optional) (default to undefined)
+let ipAddress: string; // (optional) (default to undefined)
+let type: Array<PunishmentType>; // (optional) (default to undefined)
+let issuedAfter: number; // (optional) (default to undefined)
+let issuedBefore: number; // (optional) (default to undefined)
 
 const { status, data } = await apiInstance.getPunishments(
-    page,
-    limit,
+    pageable,
     uuid,
     username,
     ipAddress,
@@ -160,19 +218,18 @@ const { status, data } = await apiInstance.getPunishments(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **page** | [**number**] | Page number (1-indexed) | defaults to 1|
-| **limit** | [**number**] | Page size | defaults to 50|
-| **uuid** | [**string**] | Filter by player UUID | (optional) defaults to undefined|
-| **username** | [**string**] | Filter by player username (case-insensitive substring match) | (optional) defaults to undefined|
-| **ipAddress** | [**string**] | Filter by IP address | (optional) defaults to undefined|
-| **type** | **Array&lt;PunishmentType&gt;** | Filter by punishment type. Repeatable. | (optional) defaults to undefined|
-| **issuedAfter** | [**number**] | Filter punishments issued after this epoch timestamp (ms) | (optional) defaults to undefined|
-| **issuedBefore** | [**number**] | Filter punishments issued before this epoch timestamp (ms) | (optional) defaults to undefined|
+| **pageable** | **Pageable** |  | defaults to undefined|
+| **uuid** | [**string**] |  | (optional) defaults to undefined|
+| **username** | [**string**] |  | (optional) defaults to undefined|
+| **ipAddress** | [**string**] |  | (optional) defaults to undefined|
+| **type** | **Array&lt;PunishmentType&gt;** |  | (optional) defaults to undefined|
+| **issuedAfter** | [**number**] |  | (optional) defaults to undefined|
+| **issuedBefore** | [**number**] |  | (optional) defaults to undefined|
 
 
 ### Return type
 
-**AdminPagedPunishmentResponse**
+**PageAdminPunishmentListItem**
 
 ### Authorization
 

package/docs/AdminReportTarget.md

@@ -0,0 +1,23 @@
+# AdminReportTarget
+
+One reported player attached to a report.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**uuid** | **string** | Target player\'s UUID | [default to undefined]
+**username** | **string** | Target player\'s last-known username | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminReportTarget } from '@rebornteam/reborn-api';
+
+const instance: AdminReportTarget = {
+    uuid,
+    username,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminReportsApi.md

@@ -0,0 +1,123 @@
+# AdminReportsApi
+
+All URIs are relative to *https://api.smsh.sh*
+
+|Method | HTTP request | Description|
+|------------- | ------------- | -------------|
+|[**list1**](#list1) | **GET** /admin/report | List reports|
+|[**resolve**](#resolve) | **POST** /admin/report/{id}/resolve | Resolve a report|
+
+# **list1**
+> PageAdminPlayerReport list1()
+
+Paginated, newest first. Use openOnly=true to see the triage queue; reportedUuid filters to one player.
+
+### Example
+
+```typescript
+import {
+    AdminReportsApi,
+    Configuration,
+    Pageable
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminReportsApi(configuration);
+
+let pageable: Pageable; // (default to undefined)
+let reportedUuid: string; //Filter to reports targeting this player UUID (optional) (default to undefined)
+let openOnly: boolean; // (optional) (default to true)
+
+const { status, data } = await apiInstance.list1(
+    pageable,
+    reportedUuid,
+    openOnly
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **pageable** | **Pageable** |  | defaults to undefined|
+| **reportedUuid** | [**string**] | Filter to reports targeting this player UUID | (optional) defaults to undefined|
+| **openOnly** | [**boolean**] |  | (optional) defaults to true|
+
+
+### Return type
+
+**PageAdminPlayerReport**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Reports retrieved |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **resolve**
+> resolve(adminResolveReportRequest)
+
+Marks the report resolved with the staff member\'s note. 404 if already resolved or unknown id.
+
+### Example
+
+```typescript
+import {
+    AdminReportsApi,
+    Configuration,
+    AdminResolveReportRequest
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminReportsApi(configuration);
+
+let id: number; //Report id (default to undefined)
+let adminResolveReportRequest: AdminResolveReportRequest; //
+
+const { status, data } = await apiInstance.resolve(
+    id,
+    adminResolveReportRequest
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **adminResolveReportRequest** | **AdminResolveReportRequest**|  | |
+| **id** | [**number**] | Report id | defaults to undefined|
+
+
+### Return type
+
+void (empty response body)
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: Not defined
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**204** | Report resolved |  -  |
+|**404** | Report not found or already resolved |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+

package/docs/AdminResolveReportRequest.md

@@ -0,0 +1,21 @@
+# AdminResolveReportRequest
+
+Resolve a player report. Sets resolved_at = NOW() and stores the staff note.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**resolutionNote** | **string** | Free-form resolution note from staff (e.g. \"Watched 10 min footage, no cheating evident.\") | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminResolveReportRequest } from '@rebornteam/reborn-api';
+
+const instance: AdminResolveReportRequest = {
+    resolutionNote,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminSetAggressiveModeImmunityRequest.md

@@ -0,0 +1,21 @@
+# AdminSetAggressiveModeImmunityRequest
+
+Set whether a player is exempt from aggressive-mode punishment propagation. Toggling on also revokes all currently-active propagated links for the player.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**immune** | **boolean** | True to mark the player immune (no future propagation; existing propagated links bulk-revoked). False to re-enable propagation. | [default to undefined]
+
+## Example
+
+```typescript
+import { AdminSetAggressiveModeImmunityRequest } from '@rebornteam/reborn-api';
+
+const instance: AdminSetAggressiveModeImmunityRequest = {
+    immune,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminTrustFactorBreakdown.md

@@ -0,0 +1,61 @@
+# AdminTrustFactorBreakdown
+
+Detailed breakdown of how a player\'s trust factor was computed. The final score is the same value returned by compute_trust_factor — this DTO carries the subtotals (bonuses, penalties) and the underlying signal counts that drove each subtotal. Powers the \"why is this score 65?\" admin tooltip. Informational only; trust factor does not auto-escalate punishments.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**baseTrust** | **number** | Starting score before any signals applied. Constant 75. | [default to undefined]
+**ageBonus** | **number** | Bonus from account age (+1 per 30 days, capped at +15) | [default to undefined]
+**cleanHistoryBonus** | **number** | Bonus from clean history. +10 if no active punishments; otherwise +1 per 60 days since the most recent one. Capped at +10. | [default to undefined]
+**stabilityBonus** | **number** | Bonus from connection stability. Stair-step on distinct-connection count: ≤1=+5, ≤3=+3, ≤8=+1, else 0. | [default to undefined]
+**adminAffirmationBonus** | **number** | Bonus from admin affirmation. alt-exemptions × 2 + active player-bypass × 4, capped at +10. | [default to undefined]
+**punishmentPenalty** | **number** | Penalty from active punishments. Type-weighted, severity-scaled, time-decayed (BAN half-life 730d, MUTE 180d, WARNING 60d). Capped at -40. | [default to undefined]
+**altPenalty** | **number** | Penalty from alts. dirty-alts × 4 + clean-alts × 0.5, after promiscuity/alt caps, excluding alt-exempted players. Capped at -20. | [default to undefined]
+**vpnPenalty** | **number** | Penalty from VPN exposure. Fraction of the player\'s connections flagged > 50% positive × 15. | [default to undefined]
+**propagationPenalty** | **number** | Penalty from active PROPAGATED punishment links × 3. Capped at -15. | [default to undefined]
+**rawSum** | **number** | Sum of base + bonuses - penalties BEFORE clamping to 0..100. Useful for debugging \"why is my -50 raw sum clamped to 0?\" cases. | [default to undefined]
+**finalScore** | **number** | The clamped final trust factor (0–100). Identical to what compute_trust_factor() returns. | [default to undefined]
+**accountAgeDays** | **number** | Days since the player\'s account was created. | [default to undefined]
+**daysSinceLastPunishment** | **number** | Days since the most recent active punishment landed. Null when the player has none — the clean_history bonus is at its cap. | [optional] [default to undefined]
+**numConnections** | **number** | Distinct connections this player has used. Drives the stability bonus. | [default to undefined]
+**numAltExemptions** | **number** | Alt-exemption rows attributed to this player (admin-asserted legitimate associates). | [default to undefined]
+**hasPlayerBypass** | **boolean** | Whether this player currently has an active player_bypass row. | [default to undefined]
+**numActivePunishments** | **number** | Count of active (non-revoked, non-expired) player_punishment rows on this player. Includes both DIRECT and PROPAGATED. | [default to undefined]
+**numDirtyAlts** | **number** | Alts with active punishments (drives the bigger per-alt penalty multiplier). | [default to undefined]
+**numCleanAlts** | **number** | Alts WITHOUT active punishments (drives the smaller per-alt penalty multiplier). | [default to undefined]
+**vpnConnectionRatio** | **number** | Fraction of this player\'s connections flagged > 50% VPN-positive. Range 0..1. | [default to undefined]
+**numPropagatedLinks** | **number** | Active PROPAGATED player_punishment links on this player (i.e. aggressive-mode propagation). | [default to undefined]
+
+## Example
+
+```typescript
+import { AdminTrustFactorBreakdown } from '@rebornteam/reborn-api';
+
+const instance: AdminTrustFactorBreakdown = {
+    baseTrust,
+    ageBonus,
+    cleanHistoryBonus,
+    stabilityBonus,
+    adminAffirmationBonus,
+    punishmentPenalty,
+    altPenalty,
+    vpnPenalty,
+    propagationPenalty,
+    rawSum,
+    finalScore,
+    accountAgeDays,
+    daysSinceLastPunishment,
+    numConnections,
+    numAltExemptions,
+    hasPlayerBypass,
+    numActivePunishments,
+    numDirtyAlts,
+    numCleanAlts,
+    vpnConnectionRatio,
+    numPropagatedLinks,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminTrustFactorHistoryEntry.md

@@ -0,0 +1,23 @@
+# AdminTrustFactorHistoryEntry
+
+One trust factor snapshot for a player on a given day.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**snapshotDate** | **string** | UTC date the snapshot was taken | [default to undefined]
+**trustFactor** | **number** | Trust factor (0–100, higher = more trusted) on that day | [default to undefined]
+
+## Example
+
+```typescript
+import { AdminTrustFactorHistoryEntry } from '@rebornteam/reborn-api';
+
+const instance: AdminTrustFactorHistoryEntry = {
+    snapshotDate,
+    trustFactor,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminTrustFactorImpact.md

@@ -0,0 +1,23 @@
+# AdminTrustFactorImpact
+
+Trust factor impact preview for a player-targeted punishment.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**currentTrustFactor** | **number** | Trust factor right now (0-100, higher = more trusted). Computed by compute_trust_factor in the database. | [default to undefined]
+**projectedTrustFactor** | **number** | Approximate trust factor AFTER this punishment would land. Approximate because caps in the underlying signals can absorb part of the impact, so the actual post-apply value may be higher than this preview. | [default to undefined]
+
+## Example
+
+```typescript
+import { AdminTrustFactorImpact } from '@rebornteam/reborn-api';
+
+const instance: AdminTrustFactorImpact = {
+    currentTrustFactor,
+    projectedTrustFactor,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminUpdatePunishmentRequest.md

@@ -0,0 +1,27 @@
+# AdminUpdatePunishmentRequest
+
+Partial update for a punishment. Only reason / notes / expiresAt may be edited — severity is intentionally immutable to keep the punishment score deterministic.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**reason** | **string** | Replace the visible reason. Min 3, max 500 characters. | [optional] [default to undefined]
+**notes** | **string** | Replace the internal admin notes. Null leaves them untouched; empty string clears them. | [optional] [default to undefined]
+**expiresAt** | **string** | Replace the expiry timestamp (ISO-8601). Send an explicit null in JSON to make permanent — but note: omitting the field leaves expiry untouched. Use \'forcePermanent\' if you want to clear. | [optional] [default to undefined]
+**forcePermanent** | **boolean** | When true, clears expiresAt (makes the punishment permanent). Takes precedence over expiresAt. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminUpdatePunishmentRequest } from '@rebornteam/reborn-api';
+
+const instance: AdminUpdatePunishmentRequest = {
+    reason,
+    notes,
+    expiresAt,
+    forcePermanent,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/ChatApi.md

@@ -23,14 +23,14 @@ import {
 const configuration = new Configuration();
 const apiInstance = new ChatApi(configuration);
 
-let limit: number; //Maximum number of messages to return (1–100) (default to 50)
 let sessionId: string; //Filter to a specific server session. Omit for global history. (optional) (default to undefined)
 let before: string; //ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now. (optional) (default to undefined)
+let limit: number; //Maximum number of messages to return (1–100) (optional) (default to 50)
 
 const { status, data } = await apiInstance.history(
-    limit,
     sessionId,
-    before
+    before,
+    limit
 );
 ```
 
@@ -38,9 +38,9 @@ const { status, data } = await apiInstance.history(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **limit** | [**number**] | Maximum number of messages to return (1–100) | defaults to 50|
 | **sessionId** | [**string**] | Filter to a specific server session. Omit for global history. | (optional) defaults to undefined|
 | **before** | [**string**] | ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now. | (optional) defaults to undefined|
+| **limit** | [**number**] | Maximum number of messages to return (1–100) | (optional) defaults to 50|
 
 
 ### Return type

package/docs/ConnectionApi.md

@@ -4,12 +4,12 @@ All URIs are relative to *https://api.smsh.sh*
 
 |Method | HTTP request | Description|
 |------------- | ------------- | -------------|
-|[**getConnectionDetails**](#getconnectiondetails) | **GET** /v1/connection/get-connection-details/{ip} | Check Connection and Detect VPN/Proxy|
+|[**getConnectionDetails**](#getconnectiondetails) | **GET** /v1/connection/get-connection-details/{ip} | Check Connection and Detect VPN/Proxy (DEPRECATED for player-join use)|
 
 # **getConnectionDetails**
 > ConnectionGetConnectionDetailsResponse getConnectionDetails()
 
-Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times. 
+**DEPRECATED for game-server player-join flows.** Use `POST /v1/player-session/start` instead — it runs the same authorization check AND opens the player_session row in a single round-trip, returning the same connection / player / punishment context plus aggregate session stats.  This endpoint remains available for admin and debugging scenarios where you want to inspect a connection\'s state without opening a session (e.g. one-off lookups, batch sweeps, support troubleshooting).  Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times. 
 
 ### Example
 
@@ -23,7 +23,7 @@ const configuration = new Configuration();
 const apiInstance = new ConnectionApi(configuration);
 
 let ip: string; //IPv4 address to analyze for VPN/proxy detection and geolocation (default to undefined)
-let forceRecheck: boolean; //When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false  (default to false)
+let forceRecheck: boolean; //When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false  (optional) (default to false)
 let associateUuid: string; //Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\'s history - Update the player\'s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\'t block the response.  (optional) (default to undefined)
 
 const { status, data } = await apiInstance.getConnectionDetails(
@@ -38,7 +38,7 @@ const { status, data } = await apiInstance.getConnectionDetails(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **ip** | [**string**] | IPv4 address to analyze for VPN/proxy detection and geolocation | defaults to undefined|
-| **forceRecheck** | [**boolean**] | When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false  | defaults to false|
+| **forceRecheck** | [**boolean**] | When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false  | (optional) defaults to false|
 | **associateUuid** | [**string**] | Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\'s history - Update the player\'s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\'t block the response.  | (optional) defaults to undefined|
 
 

package/docs/ConnectionGetConnectionDetailsResponse.md

@@ -7,7 +7,9 @@ Comprehensive connection analysis response including VPN detection, geolocation,
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **ipAddress** | **string** | The analyzed IPv4 address | [default to undefined]
-**approximateLocation** | **string** | Approximate geographic location of the IP address. Returns \'Local, N/A\' for localhost or private IPs. | [default to undefined]
+**city** | **string** | City reported by the first VPN provider that returned one for this IP. Null for localhost / private IPs or when no provider returned a city. | [optional] [default to undefined]
+**country** | **string** | Country code reported by the first VPN provider that returned one (ISO 3166-1 alpha-2 or alpha-3 depending on provider). | [optional] [default to undefined]
+**approximateLocation** | **string** | **DEPRECATED.** Combined city + country string retained for clients pinned to ≤ 3.6.0. Reads as \"City, COUNTRY\" when both are present, the available one when only one is, null when neither is. Use {@link #city} and {@link #country} directly. | [optional] [default to undefined]
 **percentPositive** | **number** | 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). | [default to undefined]
 **numberOfChecks** | **number** | Total number of VPN detection services successfully queried during the last check. | [default to undefined]
 **isBypassed** | **boolean** | Indicates if this IP address has been administratively bypassed. | [default to undefined]
@@ -24,6 +26,8 @@ import { ConnectionGetConnectionDetailsResponse } from '@rebornteam/reborn-api';
 
 const instance: ConnectionGetConnectionDetailsResponse = {
     ipAddress,
+    city,
+    country,
     approximateLocation,
     percentPositive,
     numberOfChecks,

package/docs/ConnectionResult.md

@@ -1,6 +1,6 @@
 # ConnectionResult
 
-Join enforcement result. Only populated when \'associate_uuid\' query parameter is provided. Contains the final allow/deny decision and a formatted kick message if denied.
+Final allow/deny verdict plus formatted kick message if denied.
 
 ## Properties
 

package/docs/CreateReportRequest.md

@@ -0,0 +1,27 @@
+# CreateReportRequest
+
+Game-server-issued peer report. Sent when a player runs /report in-game. A single report can target multiple players (\"these 3 were griefing together\"); the same reporter resubmitting the EXACT same target set while the prior report is unresolved updates it in place (response\'s deduplicated = true). Any different target set, even an overlapping one, creates a new report.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**reporterUuid** | **string** | Reporter\'s UUID (the player who ran /report) | [default to undefined]
+**reportedUuids** | **Array<string>** | One or more reported player UUIDs. Duplicates within the list are de-duped server-side. The reporter MUST NOT appear in this list. | [default to undefined]
+**category** | [**ReportCategory**](ReportCategory.md) | Category of misconduct. Coarse on purpose — staff refine in triage. | [default to undefined]
+**reason** | **string** | Free-form description from the reporter (1–500 chars) | [default to undefined]
+
+## Example
+
+```typescript
+import { CreateReportRequest } from '@rebornteam/reborn-api';
+
+const instance: CreateReportRequest = {
+    reporterUuid,
+    reportedUuids,
+    category,
+    reason,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/CreateReportResponse.md

@@ -0,0 +1,23 @@
+# CreateReportResponse
+
+Acknowledgement that a peer report was accepted by the API.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**reportId** | **number** | Server-assigned report id | [default to undefined]
+**deduplicated** | **boolean** | True if an active report from this reporter against this target already existed; the row\'s reason/category were updated in place. False on first report. | [default to undefined]
+
+## Example
+
+```typescript
+import { CreateReportResponse } from '@rebornteam/reborn-api';
+
+const instance: CreateReportResponse = {
+    reportId,
+    deduplicated,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)