@rebornteam/reborn-api 3.2.1 → 4.0.0

package/dist/esm/base.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.2.1
+ * The version of the OpenAPI document: 4.0.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/base.js

@@ -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: 3.2.1
+ * The version of the OpenAPI document: 4.0.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/common.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.2.1
+ * The version of the OpenAPI document: 4.0.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/common.js

@@ -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: 3.2.1
+ * The version of the OpenAPI document: 4.0.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/configuration.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.2.1
+ * The version of the OpenAPI document: 4.0.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/configuration.js

@@ -3,7 +3,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.2.1
+ * The version of the OpenAPI document: 4.0.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/index.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.2.1
+ * The version of the OpenAPI document: 4.0.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/index.js

@@ -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: 3.2.1
+ * The version of the OpenAPI document: 4.0.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/index.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.2.1
+ * The version of the OpenAPI document: 4.0.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/index.js

@@ -5,7 +5,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.2.1
+ * The version of the OpenAPI document: 4.0.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/docs/AdminAltAccount.md

@@ -0,0 +1,27 @@
+# AdminAltAccount
+
+Another player who has been seen on at least one of this player\'s historical connections — i.e. an alt account candidate.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**uuid** | **string** | Alt player\'s Minecraft UUID | [default to undefined]
+**username** | **string** | Most recently seen username for the alt, null if never recorded | [optional] [default to undefined]
+**lastUsedAt** | **string** | Timestamp of the alt\'s most recent connection (ISO-8601), null if never connected | [optional] [default to undefined]
+**sharedConnectionCount** | **number** | Number of distinct connections this alt shares with the source player | [default to undefined]
+
+## Example
+
+```typescript
+import { AdminAltAccount } from '@rebornteam/reborn-api';
+
+const instance: AdminAltAccount = {
+    uuid,
+    username,
+    lastUsedAt,
+    sharedConnectionCount,
+};
+```
+
+[[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/AdminAltExemption.md

@@ -0,0 +1,31 @@
+# AdminAltExemption
+
+Per-pair exemption from aggressive-mode alt propagation. When a row exists with (player_id=X, alt_player_id=Y), propagation for X will skip Y as an alt source.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**playerUuid** | **string** | Player this exemption applies to | [default to undefined]
+**altPlayerUuid** | **string** | Player to be skipped as an alt source | [default to undefined]
+**altPlayerUsername** | **string** | Most recent username of the exempted alt | [optional] [default to undefined]
+**createdBy** | **string** | Staff member who created the exemption | [default to undefined]
+**createdAt** | **string** | When the exemption was created (ISO-8601) | [default to undefined]
+**reason** | **string** | Optional human-readable reason | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminAltExemption } from '@rebornteam/reborn-api';
+
+const instance: AdminAltExemption = {
+    playerUuid,
+    altPlayerUuid,
+    altPlayerUsername,
+    createdBy,
+    createdAt,
+    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/AdminApplyPunishmentResult.md

@@ -9,9 +9,9 @@ Name | Type | Description | Notes
 **target** | [**AdminPunishmentTarget**](AdminPunishmentTarget.md) | The target this result applies to | [default to undefined]
 **punishmentId** | **number** | ID of the created punishment record | [default to undefined]
 **type** | [**PunishmentType**](PunishmentType.md) | Punishment type applied | [default to undefined]
-**severity** | **number** | Severity level applied | [default to undefined]
-**newScore** | **number** | Updated punishment score after applying | [default to undefined]
-**isPermanent** | **boolean** | Whether the punishment was made permanent | [default to undefined]
+**severity** | **number** | Severity level applied (1-4) | [default to undefined]
+**newTrustFactor** | **number** | Trust factor (0-100) for the targeted player after the punishment landed. Present only when the target is a player; absent for any other target shape. | [optional] [default to undefined]
+**isPermanent** | **boolean** | Whether the punishment was made permanent. Mirrors the request\'s forcePermanent flag — auto-escalation has been removed. | [default to undefined]
 **expiresAt** | **string** | When the punishment expires — null if permanent or a WARNING | [optional] [default to undefined]
 
 ## Example
@@ -24,7 +24,7 @@ const instance: AdminApplyPunishmentResult = {
     punishmentId,
     type,
     severity,
-    newScore,
+    newTrustFactor,
     isPermanent,
     expiresAt,
 };

package/docs/AdminAsyncJob.md

@@ -0,0 +1,47 @@
+# AdminAsyncJob
+
+One row of admin_job — a long-running admin operation.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **string** | Job id | [default to undefined]
+**jobType** | **string** | Stable identifier of what kind of work this is (e.g. LOCATION_BACKFILL) | [default to undefined]
+**status** | [**JobStatus**](JobStatus.md) | Current lifecycle state. | [default to undefined]
+**progressCurrent** | **number** | Number of units processed so far | [default to undefined]
+**progressTotal** | **number** | Total units, when known up front. Null when total is undetermined. | [optional] [default to undefined]
+**progressMessage** | **string** | Optional human-readable status line (e.g. \"Re-checking IpHub\"). | [optional] [default to undefined]
+**errorMessage** | **string** | Error message when status = FAILED. Null otherwise. | [optional] [default to undefined]
+**resultPayload** | **object** | Type-specific JSON result, populated when status = COMPLETED. Schema varies by jobType — consult the docs for each type. | [optional] [default to undefined]
+**startedBy** | **string** | Admin who submitted the job (Discord username for SSO admins). | [default to undefined]
+**startedAt** | **string** | When the job was submitted (ISO-8601). | [default to undefined]
+**lastProgressAt** | **string** | Timestamp of the most recent progress update. The reaper marks jobs FAILED when this falls behind by 5 min. | [default to undefined]
+**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]
+
+## Example
+
+```typescript
+import { AdminAsyncJob } from '@rebornteam/reborn-api';
+
+const instance: AdminAsyncJob = {
+    id,
+    jobType,
+    status,
+    progressCurrent,
+    progressTotal,
+    progressMessage,
+    errorMessage,
+    resultPayload,
+    startedBy,
+    startedAt,
+    lastProgressAt,
+    finishedAt,
+    cancelRequested,
+    hostInstance,
+};
+```
+
+[[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/AdminAsyncJobStartResponse.md

@@ -0,0 +1,21 @@
+# AdminAsyncJobStartResponse
+
+Acknowledgement returned by endpoints that submit an async job. The id is the polling target — GET /admin/job/{id} for status, DELETE /admin/job/{id} to cancel.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**jobId** | **string** | Server-assigned job id | [default to undefined]
+
+## Example
+
+```typescript
+import { AdminAsyncJobStartResponse } from '@rebornteam/reborn-api';
+
+const instance: AdminAsyncJobStartResponse = {
+    jobId,
+};
+```
+
+[[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/AdminAuditLogApi.md

@@ -0,0 +1,141 @@
+# AdminAuditLogApi
+
+All URIs are relative to *https://api.smsh.sh*
+
+|Method | HTTP request | Description|
+|------------- | ------------- | -------------|
+|[**search**](#search) | **GET** /admin/audit-log | Search the admin audit log|
+|[**searchCursor**](#searchcursor) | **GET** /admin/audit-log/cursor | Cursor-paginated audit-log search (infinite scroll)|
+
+# **search**
+> PageAdminAuditLogEntry search()
+
+Paginated audit-log search. All filter parameters are optional; an empty filter set returns the most recent rows across the system. Sorted newest-first.
+
+### Example
+
+```typescript
+import {
+    AdminAuditLogApi,
+    Configuration,
+    Pageable
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminAuditLogApi(configuration);
+
+let pageable: Pageable; // (default to undefined)
+let actor: string; //Filter to actions performed by this Discord username (case-sensitive exact match) (optional) (default to undefined)
+let action: string; //Filter to a specific action verb (e.g. REVOKE_PROPAGATED_LINK, SET_AGGRESSIVE_MODE_IMMUNITY) (optional) (default to undefined)
+let targetType: string; //Filter to a specific target type (e.g. PLAYER, PUNISHMENT, PLAYER_PUNISHMENT) (optional) (default to undefined)
+let targetId: string; //Filter to a specific target id (paired with targetType for narrowing) (optional) (default to undefined)
+
+const { status, data } = await apiInstance.search(
+    pageable,
+    actor,
+    action,
+    targetType,
+    targetId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **pageable** | **Pageable** |  | defaults to undefined|
+| **actor** | [**string**] | Filter to actions performed by this Discord username (case-sensitive exact match) | (optional) defaults to undefined|
+| **action** | [**string**] | Filter to a specific action verb (e.g. REVOKE_PROPAGATED_LINK, SET_AGGRESSIVE_MODE_IMMUNITY) | (optional) defaults to undefined|
+| **targetType** | [**string**] | Filter to a specific target type (e.g. PLAYER, PUNISHMENT, PLAYER_PUNISHMENT) | (optional) defaults to undefined|
+| **targetId** | [**string**] | Filter to a specific target id (paired with targetType for narrowing) | (optional) defaults to undefined|
+
+
+### Return type
+
+**PageAdminAuditLogEntry**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Audit-log page 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)
+
+# **searchCursor**
+> CursoredPageAdminAuditLogEntry searchCursor()
+
+Cursor-based companion to GET /admin/audit-log. Preferred for the admin UI\'s infinite-scroll view of the audit log because the SQL plan stays flat as the table grows — offset pagination degrades linearly with depth, this does not. Pass the {@code cursor} returned in the previous response to get the next page; omit it for the first page.
+
+### Example
+
+```typescript
+import {
+    AdminAuditLogApi,
+    Configuration,
+    CursoredPageable
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminAuditLogApi(configuration);
+
+let pageable: CursoredPageable; // (default to undefined)
+let actor: string; // (optional) (default to undefined)
+let action: string; // (optional) (default to undefined)
+let targetType: string; // (optional) (default to undefined)
+let targetId: string; // (optional) (default to undefined)
+
+const { status, data } = await apiInstance.searchCursor(
+    pageable,
+    actor,
+    action,
+    targetType,
+    targetId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **pageable** | **CursoredPageable** |  | defaults to undefined|
+| **actor** | [**string**] |  | (optional) defaults to undefined|
+| **action** | [**string**] |  | (optional) defaults to undefined|
+| **targetType** | [**string**] |  | (optional) defaults to undefined|
+| **targetId** | [**string**] |  | (optional) defaults to undefined|
+
+
+### Return type
+
+**CursoredPageAdminAuditLogEntry**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Cursor page 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)
+

package/docs/AdminAuditLogEntry.md

@@ -0,0 +1,33 @@
+# AdminAuditLogEntry
+
+Single admin audit-log entry. Captures who did what to which target with an action-specific JSON payload (e.g. before/after for edits, count for bulk ops).
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **number** | Sequential id (ordering matches createdAt) | [default to undefined]
+**actorUsername** | **string** | Discord username of the moderator who performed the action | [default to undefined]
+**action** | **string** | Action verb. Open-vocabulary; current values include APPLY_PUNISHMENT, EDIT_PUNISHMENT, REVOKE_PROPAGATED_LINK, BULK_REVOKE, SET_AGGRESSIVE_MODE_IMMUNITY, ADD_ALT_EXEMPTION, REMOVE_ALT_EXEMPTION. | [default to undefined]
+**targetType** | **string** | Type of entity acted upon (PLAYER, PUNISHMENT, PLAYER_PUNISHMENT, etc.) | [default to undefined]
+**targetId** | **string** | Identifier of the target (stringified id or UUID, depending on targetType) | [default to undefined]
+**payload** | **string** | Action-specific JSON payload. Shape depends on the action. | [optional] [default to undefined]
+**createdAt** | **string** | When the action occurred (ISO-8601) | [default to undefined]
+
+## Example
+
+```typescript
+import { AdminAuditLogEntry } from '@rebornteam/reborn-api';
+
+const instance: AdminAuditLogEntry = {
+    id,
+    actorUsername,
+    action,
+    targetType,
+    targetId,
+    payload,
+    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/AdminBulkRevokeRequest.md

@@ -0,0 +1,25 @@
+# AdminBulkRevokeRequest
+
+Bulk-revoke every active PROPAGATED player_punishment row sourced from a single alt or connection. Used when staff identify a false-positive source (e.g. a shared NAT or legitimate roommate) and want to undo every link it caused.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**sourcePlayerId** | **number** | Revoke links whose source_player_id matches. Mutually exclusive with sourceConnectionId. | [optional] [default to undefined]
+**sourceConnectionId** | **number** | Revoke links whose source_connection_id matches. Mutually exclusive with sourcePlayerId. | [optional] [default to undefined]
+**reason** | **string** | Optional reason for the audit log | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminBulkRevokeRequest } from '@rebornteam/reborn-api';
+
+const instance: AdminBulkRevokeRequest = {
+    sourcePlayerId,
+    sourceConnectionId,
+    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/AdminBulkRevokeResponse.md

@@ -0,0 +1,21 @@
+# AdminBulkRevokeResponse
+
+Result of a bulk-revoke operation
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**revoked** | **number** | Number of player_punishment rows soft-deleted by the operation | [default to undefined]
+
+## Example
+
+```typescript
+import { AdminBulkRevokeResponse } from '@rebornteam/reborn-api';
+
+const instance: AdminBulkRevokeResponse = {
+    revoked,
+};
+```
+
+[[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/AdminConnectionCheckResult.md

@@ -11,6 +11,8 @@ Name | Type | Description | Notes
 **checkedAt** | **string** | When this check was last performed | [default to undefined]
 **city** | **string** | City reported by this service, if available | [optional] [default to undefined]
 **country** | **string** | Country code reported by this service, if available | [optional] [default to undefined]
+**latitude** | **number** | Latitude reported by this service, if available | [optional] [default to undefined]
+**longitude** | **number** | Longitude reported by this service, if available | [optional] [default to undefined]
 
 ## Example
 
@@ -23,6 +25,8 @@ const instance: AdminConnectionCheckResult = {
     checkedAt,
     city,
     country,
+    latitude,
+    longitude,
 };
 ```