@rebornteam/reborn-api 3.2.1 → 4.5.0

package/docs/AdminPlayerReport.md

@@ -0,0 +1,39 @@
+# AdminPlayerReport
+
+One peer report. May target one or more players.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **number** | Report id | [default to undefined]
+**reporterUuid** | **string** | Reporter\'s UUID | [default to undefined]
+**reporterUsername** | **string** | Reporter\'s username at the time of the report (last-known if changed) | [optional] [default to undefined]
+**reportedTargets** | [**Array<AdminReportTarget>**](AdminReportTarget.md) | All players this report flags. At least one entry. | [default to undefined]
+**category** | **string** | Category | [default to undefined]
+**reason** | **string** | Reason text | [default to undefined]
+**createdAt** | **string** | When created (ISO-8601) | [default to undefined]
+**resolvedAt** | **string** | When resolved by staff. Null = open. | [optional] [default to undefined]
+**resolvedBy** | **string** | Staff member who resolved it | [optional] [default to undefined]
+**resolutionNote** | **string** | Staff\'s resolution note | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminPlayerReport } from '@rebornteam/reborn-api';
+
+const instance: AdminPlayerReport = {
+    id,
+    reporterUuid,
+    reporterUsername,
+    reportedTargets,
+    category,
+    reason,
+    createdAt,
+    resolvedAt,
+    resolvedBy,
+    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/AdminPlayerSession.md

@@ -0,0 +1,31 @@
+# AdminPlayerSession
+
+A single player session — one visit by one player to one game server. Active sessions have null endedAt and durationSeconds; closed sessions have both populated.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **string** | Session id (UUID) | [default to undefined]
+**playerUuid** | **string** | Player Minecraft UUID | [default to undefined]
+**serverSessionId** | **string** | Game server session id this session is associated with. Nullable when the server record has been deleted. | [optional] [default to undefined]
+**startedAt** | **string** | When the player joined (ISO-8601) | [default to undefined]
+**endedAt** | **string** | When the player disconnected (ISO-8601). Null while the session is still active. | [optional] [default to undefined]
+**durationSeconds** | **number** | Closed session duration in seconds (ended_at − started_at). Null while active. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminPlayerSession } from '@rebornteam/reborn-api';
+
+const instance: AdminPlayerSession = {
+    id,
+    playerUuid,
+    serverSessionId,
+    startedAt,
+    endedAt,
+    durationSeconds,
+};
+```
+
+[[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/AdminPlayerSessionStats.md

@@ -0,0 +1,29 @@
+# AdminPlayerSessionStats
+
+Aggregate session statistics for one player. Computed on demand from player_session.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**totalSecondsPlayed** | **number** | Sum of duration_seconds across all closed sessions | [default to undefined]
+**sessionCount** | **number** | Total number of session rows for this player (active + closed) | [default to undefined]
+**distinctDaysActive** | **number** | Distinct calendar days (UTC) on which this player had at least one session | [default to undefined]
+**lastStartedAt** | **string** | Most recent session start time (ISO-8601). Null if the player has never connected. | [optional] [default to undefined]
+**currentlyOnline** | **boolean** | True when the player has at least one currently-active (ended_at IS NULL) session. | [default to undefined]
+
+## Example
+
+```typescript
+import { AdminPlayerSessionStats } from '@rebornteam/reborn-api';
+
+const instance: AdminPlayerSessionStats = {
+    totalSecondsPlayed,
+    sessionCount,
+    distinctDaysActive,
+    lastStartedAt,
+    currentlyOnline,
+};
+```
+
+[[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/AdminPlayerSummary.md

@@ -12,8 +12,7 @@ Name | Type | Description | Notes
 **firstJoin** | **boolean** | Whether this player still has first-join status | [default to undefined]
 **firstLogin** | **string** | Timestamp of first connection (ISO-8601) | [default to undefined]
 **lastUsedAt** | **string** | Timestamp of most recent connection (ISO-8601) | [optional] [default to undefined]
-**punishmentPointsRaw** | **number** | Raw punishment score (sum of weighted punishment values) | [default to undefined]
-**punishmentPointsPercent** | **number** | Punishment score as a percentage. Values above 100 indicate future punishments should be permanent. | [default to undefined]
+**trustFactor** | **number** | Trust factor (0-100, higher = more trusted). Informational only — does NOT auto-escalate punishments. See compute_trust_factor in the database for the formula. | [default to undefined]
 
 ## Example
 
@@ -27,8 +26,7 @@ const instance: AdminPlayerSummary = {
     firstJoin,
     firstLogin,
     lastUsedAt,
-    punishmentPointsRaw,
-    punishmentPointsPercent,
+    trustFactor,
 };
 ```