@rebornteam/reborn-api 4.0.0 → 4.5.0

package/docs/AdminAltGraphNode.md

@@ -0,0 +1,29 @@
+# AdminAltGraphNode
+
+One player node in an alt-graph traversal.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**uuid** | **string** | Player Minecraft UUID | [default to undefined]
+**username** | **string** | Most recently seen username, null if never resolved | [optional] [default to undefined]
+**depth** | **number** | Hop count from the focal player (0 = the focal player herself). | [default to undefined]
+**trustFactor** | **number** | Trust factor (0-100). Drives the node colour in the graph. | [default to undefined]
+**hasActivePunishment** | **boolean** | Whether this player currently has at least one active (non-revoked, non-expired) player_punishment row. Drives a red outline ring on the node. | [default to undefined]
+
+## Example
+
+```typescript
+import { AdminAltGraphNode } from '@rebornteam/reborn-api';
+
+const instance: AdminAltGraphNode = {
+    uuid,
+    username,
+    depth,
+    trustFactor,
+    hasActivePunishment,
+};
+```
+
+[[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/AdminAsyncJob.md

@@ -20,6 +20,7 @@ Name | Type | Description | Notes
 **finishedAt** | **string** | When the job entered a terminal state. Null while running. | [optional] [default to undefined]
 **cancelRequested** | **boolean** | True if an admin has requested cancellation. The host instance picks this up at its next progress tick. | [default to undefined]
 **hostInstance** | **string** | Identifier of the API instance that is running this job. Other instances can see state and request cancellation but cannot dispose the in-flight Reactor subscription directly. | [default to undefined]
+**artifact** | [**AdminAsyncJobArtifactMeta**](AdminAsyncJobArtifactMeta.md) | Pointer to a CSV artifact emitted by this job, when one exists. Present only after the job marks COMPLETED and the artifact has been persisted. Download the CSV bytes via GET /admin/job/{id}/artifact.csv. | [optional] [default to undefined]
 
 ## Example
 
@@ -41,6 +42,7 @@ const instance: AdminAsyncJob = {
     finishedAt,
     cancelRequested,
     hostInstance,
+    artifact,
 };
 ```
 

package/docs/AdminAsyncJobArtifactMeta.md

@@ -0,0 +1,23 @@
+# AdminAsyncJobArtifactMeta
+
+Pointer to a job\'s CSV artifact. Present only when the job emitted one.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**rowCount** | **number** | Number of data rows in the artifact (excluding the header). | [default to undefined]
+**createdAt** | **string** | When the artifact was finalized (typically a few seconds after the job marked COMPLETED). | [default to undefined]
+
+## Example
+
+```typescript
+import { AdminAsyncJobArtifactMeta } from '@rebornteam/reborn-api';
+
+const instance: AdminAsyncJobArtifactMeta = {
+    rowCount,
+    createdAt,
+};
+```
+
+[[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/AdminJobsApi.md

@@ -5,6 +5,7 @@ All URIs are relative to *https://api.smsh.sh*
 |Method | HTTP request | Description|
 |------------- | ------------- | -------------|
 |[**cancel**](#cancel) | **DELETE** /admin/job/{id} | Request cancellation of an async job|
+|[**downloadArtifact**](#downloadartifact) | **GET** /admin/job/{id}/artifact.csv | Download a job\'s CSV artifact|
 |[**get**](#get) | **GET** /admin/job/{id} | Get one async job|
 |[**list**](#list) | **GET** /admin/job | List async jobs|
 
@@ -62,6 +63,60 @@ void (empty response body)
 
 [[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)
 
+# **downloadArtifact**
+> string downloadArtifact()
+
+Returns the CSV emitted by the job — typically one row per record the job touched. The first line is a header; subsequent lines are RFC-4180 escaped data rows. 404 when the job has no artifact (either it didn\'t emit one, or it hasn\'t finished yet).
+
+### Example
+
+```typescript
+import {
+    AdminJobsApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminJobsApi(configuration);
+
+let id: string; //Job id (default to undefined)
+
+const { status, data } = await apiInstance.downloadArtifact(
+    id
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **id** | [**string**] | Job id | defaults to undefined|
+
+
+### Return type
+
+**string**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: text/csv
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | CSV streamed |  -  |
+|**404** | No artifact for this job |  -  |
+|**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)
+
 # **get**
 > AdminAsyncJob get()
 

package/docs/AdminPlayersApi.md

@@ -5,9 +5,11 @@ All URIs are relative to *https://api.smsh.sh*
 |Method | HTTP request | Description|
 |------------- | ------------- | -------------|
 |[**addAltExemption**](#addaltexemption) | **POST** /admin/player/{uuid}/alt-exemption | Add an alt exemption|
+|[**backfillUsernames**](#backfillusernames) | **POST** /admin/player/backfill-usernames | Start a username backfill job|
 |[**bulkRevokePropagated**](#bulkrevokepropagated) | **POST** /admin/player/player-punishment/bulk-revoke | Bulk-revoke PROPAGATED links by source|
 |[**createPlayerNote**](#createplayernote) | **POST** /admin/player/{uuid}/note | Create a staff note on a player|
 |[**deletePlayerNote**](#deleteplayernote) | **DELETE** /admin/player/{uuid}/note/{noteId} | Soft-delete a staff note|
+|[**getAltGraph**](#getaltgraph) | **GET** /admin/player/{uuid}/alt-graph | Alt-graph traversal rooted at a player|
 |[**getPlayer**](#getplayer) | **GET** /admin/player/{uuid} | Get player detail|
 |[**getPlayerAlts**](#getplayeralts) | **GET** /admin/player/{uuid}/alts | List a player\'s alt accounts|
 |[**getPlayerConnections**](#getplayerconnections) | **GET** /admin/player/{uuid}/connections | List a player\'s connection history|
@@ -82,6 +84,52 @@ void (empty response body)
 
 [[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)
 
+# **backfillUsernames**
+> AdminAsyncJobStartResponse backfillUsernames()
+
+Submits an async job that walks every player row whose username is NULL and calls the Mojang profile API to resolve it. The job upserts both the player.username column and a player_username_history row. Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. The final Admin_BackfillUsernamesResponse (processed/succeeded/failed counts) lands in the job\'s result_payload on COMPLETED. Mojang rate-limits at ~1 req/sec; a backfill of many rows can run for a while — cancel is honoured between rows.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+const { status, data } = await apiInstance.backfillUsernames();
+```
+
+### 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)
+
 # **bulkRevokePropagated**
 > AdminBulkRevokeResponse bulkRevokePropagated(adminBulkRevokeRequest)
 
@@ -252,6 +300,62 @@ void (empty response body)
 
 [[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)
 
+# **getAltGraph**
+> AdminAltGraph getAltGraph()
+
+Returns the connection-shared player graph reachable from this player within {depth} hops. Mirrors the propagation walk used by ALT_PROPAGATION_SWEEP — promiscuous (likely shared-NAT) connections are pruned, alt-exemption rows cut the graph at exempted players. Depth is clamped server-side at 5. Used by the admin Graph tab to render an interactive explorer.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+let depth: number; //Hop depth to walk. 1=direct alts only; 5=full sticky-trap radius. Default 2. (optional) (default to 2)
+
+const { status, data } = await apiInstance.getAltGraph(
+    uuid,
+    depth
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+| **depth** | [**number**] | Hop depth to walk. 1=direct alts only; 5=full sticky-trap radius. Default 2. | (optional) defaults to 2|
+
+
+### Return type
+
+**AdminAltGraph**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Graph traversal complete |  -  |
+|**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)
+
 # **getPlayer**
 > AdminPlayerDetailResponse getPlayer()
 

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

@@ -7,7 +7,9 @@ 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**
@@ -178,6 +180,59 @@ void (empty response body)
 
 [[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**
 > PageAdminPunishmentListItem getPunishments()
 
@@ -250,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/AdminUpdatePunishmentRequest.md

@@ -1,6 +1,6 @@
 # AdminUpdatePunishmentRequest
 
-Partial update for a punishment. Only reason / notes / expiresAt may be edited — severity is intentionally immutable to keep the punishment score deterministic.
+Partial update for a punishment. All fields are optional; omitted fields stay untouched.
 
 ## Properties
 
@@ -10,6 +10,10 @@ Name | Type | Description | Notes
 **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
 
@@ -21,6 +25,10 @@ const instance: AdminUpdatePunishmentRequest = {
     notes,
     expiresAt,
     forcePermanent,
+    type,
+    severity,
+    addTargets,
+    removeTargets,
 };
 ```
 

package/index.ts

@@ -4,7 +4,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication 
  *
- * The version of the OpenAPI document: 4.0.0
+ * The version of the OpenAPI document: 4.5.0
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rebornteam/reborn-api",
-  "version": "4.0.0",
+  "version": "4.5.0",
   "description": "OpenAPI client for @rebornteam/reborn-api",
   "author": "OpenAPI-Generator Contributors",
   "repository": {