@rebornteam/reborn-api 3.2.1 → 4.5.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/AdminPunishmentTargets.md

@@ -0,0 +1,23 @@
+# AdminPunishmentTargets
+
+Active DIRECT participants currently attached to a punishment.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**playerUuids** | **Array<string>** | UUIDs of players with an active DIRECT player_punishment link to this punishment. | [default to undefined]
+**ipAddresses** | **Array<string>** | IPs of connections with a live connection_punishment row for this punishment. | [default to undefined]
+
+## Example
+
+```typescript
+import { AdminPunishmentTargets } from '@rebornteam/reborn-api';
+
+const instance: AdminPunishmentTargets = {
+    playerUuids,
+    ipAddresses,
+};
+```
+
+[[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/AdminPunishmentsApi.md

@@ -6,7 +6,10 @@ 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|
+|[**getPunishmentTargets**](#getpunishmenttargets) | **GET** /admin/punishment/{id}/targets | List a punishment\'s current participants|
 |[**getPunishments**](#getpunishments) | **GET** /admin/punishment | List punishments|
+|[**propagationSweep**](#propagationsweep) | **POST** /admin/punishment/propagation-sweep | Start an alt-propagation sweep job|
 |[**searchTargets**](#searchtargets) | **GET** /admin/punishment/search | Search punishment targets|
 
 # **applyPunishment**
@@ -119,8 +122,119 @@ 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)
+
+# **getPunishmentTargets**
+> AdminPunishmentTargets getPunishmentTargets()
+
+Returns the active DIRECT player_punishment UUIDs and the live connection_punishment IPs for a punishment. Used by the admin edit dialog to render the editable participant list. PROPAGATED links are excluded — they\'re an enforcement detail, not part of \'who the admin attached to this punishment\'.
+
+### Example
+
+```typescript
+import {
+    AdminPunishmentsApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPunishmentsApi(configuration);
+
+let id: number; //Punishment id (default to undefined)
+
+const { status, data } = await apiInstance.getPunishmentTargets(
+    id
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **id** | [**number**] | Punishment id | defaults to undefined|
+
+
+### Return type
+
+**AdminPunishmentTargets**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Participants retrieved |  -  |
+|**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 +243,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 +273,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
 
@@ -193,6 +305,52 @@ const { status, data } = await apiInstance.getPunishments(
 
 [[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)
 
+# **propagationSweep**
+> AdminAsyncJobStartResponse propagationSweep()
+
+Submits an async job that walks every player and re-runs the aggressive-mode propagation logic (tier-1 own-IP plus tier-2 alt-driven). Useful after toggling aggressive-mode on, or after a propagation-rule change, to backfill PROPAGATED player_punishment rows that would otherwise only appear on each player\'s next login. Idempotent — ON CONFLICT DO NOTHING. Returns immediately with a job id; poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel.
+
+### Example
+
+```typescript
+import {
+    AdminPunishmentsApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPunishmentsApi(configuration);
+
+const { status, data } = await apiInstance.propagationSweep();
+```
+
+### Parameters
+This endpoint does not have any parameters.
+
+
+### Return type
+
+**AdminAsyncJobStartResponse**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**202** | Job accepted; poll /admin/job/{id} for progress |  -  |
+|**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)
+
 # **searchTargets**
 > AdminPunishmentSearchResponse searchTargets()
 

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,35 @@
+# AdminUpdatePunishmentRequest
+
+Partial update for a punishment. All fields are optional; omitted fields stay untouched.
+
+## 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]
+**type** | [**PunishmentType**](PunishmentType.md) | Replace the punishment type (BAN/MUTE/KICK/WARNING). Affects trust factor retroactively. | [optional] [default to undefined]
+**severity** | **number** | Replace the severity (1–4). Affects trust factor retroactively. | [optional] [default to undefined]
+**addTargets** | [**Array<AdminPunishmentTarget>**](AdminPunishmentTarget.md) | Targets to ADD. Each entry has either a player UUID or an IP. UUID → new DIRECT player_punishment row. IP → new connection_punishment row. | [optional] [default to undefined]
+**removeTargets** | [**Array<AdminPunishmentTarget>**](AdminPunishmentTarget.md) | Targets to REMOVE. UUID → soft-revoke the DIRECT player_punishment link. IP → delete the connection_punishment row outright. PROPAGATED links are not affected by this endpoint. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminUpdatePunishmentRequest } from '@rebornteam/reborn-api';
+
+const instance: AdminUpdatePunishmentRequest = {
+    reason,
+    notes,
+    expiresAt,
+    forcePermanent,
+    type,
+    severity,
+    addTargets,
+    removeTargets,
+};
+```
+
+[[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