@rebornteam/reborn-api 4.0.0 → 4.6.0

package/base.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.6.0
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/common.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.6.0
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/configuration.ts

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

package/dist/api.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: 4.0.0
+ * The version of the OpenAPI document: 4.6.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -63,6 +63,69 @@ export interface AdminAltExemption {
      */
     'reason'?: string | null;
 }
+/**
+ * Alt-graph rooted at a player, walked out to the requested hop depth.
+ */
+export interface AdminAltGraph {
+    /**
+     * UUID of the focal player. Always appears in nodes at depth=0.
+     */
+    'rootUuid': string;
+    /**
+     * Maximum hop depth walked. Capped server-side at MAX_PROPAGATION_DEPTH.
+     */
+    'depth': number;
+    /**
+     * Every player reachable from the root within {@code depth} hops, including the root at depth=0.
+     */
+    'nodes': Array<AdminAltGraphNode>;
+    /**
+     * Undirected edges between any two players in nodes that share at least one non-promiscuous connection.
+     */
+    'edges': Array<AdminAltGraphEdge>;
+}
+/**
+ * Undirected edge in an alt-graph traversal.
+ */
+export interface AdminAltGraphEdge {
+    /**
+     * One endpoint of the edge
+     */
+    'fromUuid': string;
+    /**
+     * Other endpoint of the edge. The pair is emitted only once — the SQL ensures fromUuid < toUuid lexicographically.
+     */
+    'toUuid': string;
+    /**
+     * Number of distinct non-promiscuous connections these two players share. Drives edge thickness.
+     */
+    'sharedConnectionCount': number;
+}
+/**
+ * One player node in an alt-graph traversal.
+ */
+export interface AdminAltGraphNode {
+    /**
+     * Player Minecraft UUID
+     */
+    'uuid': string;
+    /**
+     * Most recently seen username, null if never resolved
+     */
+    'username'?: string | null;
+    /**
+     * Hop count from the focal player (0 = the focal player herself).
+     */
+    'depth': number;
+    /**
+     * Trust factor (0-100). Drives the node colour in the graph.
+     */
+    'trustFactor': number;
+    /**
+     * Whether this player currently has at least one active (non-revoked, non-expired) player_punishment row. Drives a red outline ring on the node.
+     */
+    'hasActivePunishment': boolean;
+}
 /**
  * Request to apply a punishment to one or more targets
  */
@@ -198,6 +261,23 @@ export interface AdminAsyncJob {
      * 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.
      */
     'hostInstance': string;
+    /**
+     * 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.
+     */
+    'artifact'?: AdminAsyncJobArtifactMeta | null;
+}
+/**
+ * Pointer to a job\'s CSV artifact. Present only when the job emitted one.
+ */
+export interface AdminAsyncJobArtifactMeta {
+    /**
+     * Number of data rows in the artifact (excluding the header).
+     */
+    'rowCount': number;
+    /**
+     * When the artifact was finalized (typically a few seconds after the job marked COMPLETED).
+     */
+    'createdAt': string;
 }
 /**
  * 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.
@@ -824,6 +904,19 @@ export interface AdminPunishmentTarget {
      */
     'ipAddress'?: string | null;
 }
+/**
+ * Active DIRECT participants currently attached to a punishment.
+ */
+export interface AdminPunishmentTargets {
+    /**
+     * UUIDs of players with an active DIRECT player_punishment link to this punishment.
+     */
+    'playerUuids': Array<string>;
+    /**
+     * IPs of connections with a live connection_punishment row for this punishment.
+     */
+    'ipAddresses': Array<string>;
+}
 /**
  * One reported player attached to a report.
  */
@@ -971,7 +1064,7 @@ export interface AdminTrustFactorImpact {
     'projectedTrustFactor': number;
 }
 /**
- * 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.
  */
 export interface AdminUpdatePunishmentRequest {
     /**
@@ -990,6 +1083,22 @@ export interface AdminUpdatePunishmentRequest {
      * When true, clears expiresAt (makes the punishment permanent). Takes precedence over expiresAt.
      */
     'forcePermanent'?: boolean | null;
+    /**
+     * Replace the punishment type (BAN/MUTE/KICK/WARNING). Affects trust factor retroactively.
+     */
+    'type'?: PunishmentType | null;
+    /**
+     * Replace the severity (1–4). Affects trust factor retroactively.
+     */
+    'severity'?: number | null;
+    /**
+     * Targets to ADD. Each entry has either a player UUID or an IP. UUID → new DIRECT player_punishment row. IP → new connection_punishment row.
+     */
+    'addTargets'?: Array<AdminPunishmentTarget> | null;
+    /**
+     * 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.
+     */
+    'removeTargets'?: Array<AdminPunishmentTarget> | null;
 }
 /**
  * A single entry in a player\'s username history
@@ -1376,6 +1485,43 @@ export interface PlayerSessionEndRequest {
      */
     'serverSessionId': string;
 }
+/**
+ * Result of POST /v1/player-session/end. Confirms whether a session was closed and returns that session\'s lifetime plus the player\'s refreshed aggregate stats.
+ */
+export interface PlayerSessionEndResponse {
+    /**
+     * Player Minecraft UUID, echoed from the request
+     */
+    'playerUuid': string;
+    /**
+     * Server session id the player was on, echoed from the request
+     */
+    'serverSessionId': string;
+    /**
+     * True when an active session was found and closed by this call; false on a no-op (no active session existed, e.g. a duplicate/retried end event).
+     */
+    'sessionClosed': boolean;
+    /**
+     * Id of the session that was closed. Null on a no-op.
+     */
+    'sessionId'?: string | null;
+    /**
+     * When the closed session was opened (ISO-8601). Null on a no-op.
+     */
+    'startedAt'?: string | null;
+    /**
+     * When the session was closed (ISO-8601), i.e. now. Null on a no-op.
+     */
+    'endedAt'?: string | null;
+    /**
+     * Length of the closed session in seconds (endedAt - startedAt). Null on a no-op.
+     */
+    'durationSeconds'?: number | null;
+    /**
+     * Player\'s aggregate session stats, recomputed after this session was closed (so the just-ended session is included in the totals).
+     */
+    'sessionStats': AdminPlayerSessionStats;
+}
 /**
  * Unified player-join request. Runs the full authorization check (VPN, bypass, punishments) and conditionally opens a player_session for the allowed players.
  */
@@ -2463,6 +2609,14 @@ export declare const AdminJobsApiAxiosParamCreator: (configuration?: Configurati
      * @throws {RequiredError}
      */
     cancel: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 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).
+     * @summary Download a job\'s CSV artifact
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    downloadArtifact: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * The polling target — the admin UI hits this every ~2 s while a job is running to update its progress bar.
      * @summary Get one async job
@@ -2493,6 +2647,14 @@ export declare const AdminJobsApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     cancel(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * 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).
+     * @summary Download a job\'s CSV artifact
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    downloadArtifact(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<string>>;
     /**
      * The polling target — the admin UI hits this every ~2 s while a job is running to update its progress bar.
      * @summary Get one async job
@@ -2523,6 +2685,14 @@ export declare const AdminJobsApiFactory: (configuration?: Configuration, basePa
      * @throws {RequiredError}
      */
     cancel(id: string, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * 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).
+     * @summary Download a job\'s CSV artifact
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    downloadArtifact(id: string, options?: RawAxiosRequestConfig): AxiosPromise<string>;
     /**
      * The polling target — the admin UI hits this every ~2 s while a job is running to update its progress bar.
      * @summary Get one async job
@@ -2553,6 +2723,14 @@ export declare class AdminJobsApi extends BaseAPI {
      * @throws {RequiredError}
      */
     cancel(id: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     * 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).
+     * @summary Download a job\'s CSV artifact
+     * @param {string} id Job id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    downloadArtifact(id: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<string, any, {}>>;
     /**
      * The polling target — the admin UI hits this every ~2 s while a job is running to update its progress bar.
      * @summary Get one async job
@@ -2584,6 +2762,13 @@ export declare const AdminPlayersApiAxiosParamCreator: (configuration?: Configur
      * @throws {RequiredError}
      */
     addAltExemption: (uuid: string, adminCreateAltExemptionRequest: AdminCreateAltExemptionRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 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.
+     * @summary Start a username backfill job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    backfillUsernames: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Soft-revokes every currently active PROPAGATED player_punishment row whose source matches the supplied id. Exactly one of sourcePlayerId / sourceConnectionId must be set. Useful when staff identify a single source as a false positive (e.g. shared NAT, legitimate roommate) and want to undo every link it caused in one operation.
      * @summary Bulk-revoke PROPAGATED links by source
@@ -2610,6 +2795,15 @@ export declare const AdminPlayersApiAxiosParamCreator: (configuration?: Configur
      * @throws {RequiredError}
      */
     deletePlayerNote: (uuid: string, noteId: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 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.
+     * @summary Alt-graph traversal rooted at a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {number} [depth] Hop depth to walk. 1&#x3D;direct alts only; 5&#x3D;full sticky-trap radius. Default 2.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getAltGraph: (uuid: string, depth?: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Returns full detail for a single player including all known usernames and punishment scoring.
      * @summary Get player detail
@@ -2747,6 +2941,13 @@ export declare const AdminPlayersApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     addAltExemption(uuid: string, adminCreateAltExemptionRequest: AdminCreateAltExemptionRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * 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.
+     * @summary Start a username backfill job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    backfillUsernames(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAsyncJobStartResponse>>;
     /**
      * Soft-revokes every currently active PROPAGATED player_punishment row whose source matches the supplied id. Exactly one of sourcePlayerId / sourceConnectionId must be set. Useful when staff identify a single source as a false positive (e.g. shared NAT, legitimate roommate) and want to undo every link it caused in one operation.
      * @summary Bulk-revoke PROPAGATED links by source
@@ -2773,6 +2974,15 @@ export declare const AdminPlayersApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     deletePlayerNote(uuid: string, noteId: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * 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.
+     * @summary Alt-graph traversal rooted at a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {number} [depth] Hop depth to walk. 1&#x3D;direct alts only; 5&#x3D;full sticky-trap radius. Default 2.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getAltGraph(uuid: string, depth?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAltGraph>>;
     /**
      * Returns full detail for a single player including all known usernames and punishment scoring.
      * @summary Get player detail
@@ -2910,6 +3120,13 @@ export declare const AdminPlayersApiFactory: (configuration?: Configuration, bas
      * @throws {RequiredError}
      */
     addAltExemption(uuid: string, adminCreateAltExemptionRequest: AdminCreateAltExemptionRequest, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * 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.
+     * @summary Start a username backfill job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    backfillUsernames(options?: RawAxiosRequestConfig): AxiosPromise<AdminAsyncJobStartResponse>;
     /**
      * Soft-revokes every currently active PROPAGATED player_punishment row whose source matches the supplied id. Exactly one of sourcePlayerId / sourceConnectionId must be set. Useful when staff identify a single source as a false positive (e.g. shared NAT, legitimate roommate) and want to undo every link it caused in one operation.
      * @summary Bulk-revoke PROPAGATED links by source
@@ -2936,6 +3153,15 @@ export declare const AdminPlayersApiFactory: (configuration?: Configuration, bas
      * @throws {RequiredError}
      */
     deletePlayerNote(uuid: string, noteId: number, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * 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.
+     * @summary Alt-graph traversal rooted at a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {number} [depth] Hop depth to walk. 1&#x3D;direct alts only; 5&#x3D;full sticky-trap radius. Default 2.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getAltGraph(uuid: string, depth?: number, options?: RawAxiosRequestConfig): AxiosPromise<AdminAltGraph>;
     /**
      * Returns full detail for a single player including all known usernames and punishment scoring.
      * @summary Get player detail
@@ -3073,6 +3299,13 @@ export declare class AdminPlayersApi extends BaseAPI {
      * @throws {RequiredError}
      */
     addAltExemption(uuid: string, adminCreateAltExemptionRequest: AdminCreateAltExemptionRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     * 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.
+     * @summary Start a username backfill job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    backfillUsernames(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAsyncJobStartResponse, any, {}>>;
     /**
      * Soft-revokes every currently active PROPAGATED player_punishment row whose source matches the supplied id. Exactly one of sourcePlayerId / sourceConnectionId must be set. Useful when staff identify a single source as a false positive (e.g. shared NAT, legitimate roommate) and want to undo every link it caused in one operation.
      * @summary Bulk-revoke PROPAGATED links by source
@@ -3099,6 +3332,15 @@ export declare class AdminPlayersApi extends BaseAPI {
      * @throws {RequiredError}
      */
     deletePlayerNote(uuid: string, noteId: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     * 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.
+     * @summary Alt-graph traversal rooted at a player
+     * @param {string} uuid Player Minecraft UUID
+     * @param {number} [depth] Hop depth to walk. 1&#x3D;direct alts only; 5&#x3D;full sticky-trap radius. Default 2.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getAltGraph(uuid: string, depth?: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAltGraph, any, {}>>;
     /**
      * Returns full detail for a single player including all known usernames and punishment scoring.
      * @summary Get player detail
@@ -3252,6 +3494,14 @@ export declare const AdminPunishmentsApiAxiosParamCreator: (configuration?: Conf
      * @throws {RequiredError}
      */
     editPunishment: (id: number, adminUpdatePunishmentRequest: AdminUpdatePunishmentRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 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\'.
+     * @summary List a punishment\'s current participants
+     * @param {number} id Punishment id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPunishmentTargets: (id: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
      * @summary List punishments
@@ -3266,6 +3516,13 @@ export declare const AdminPunishmentsApiAxiosParamCreator: (configuration?: Conf
      * @throws {RequiredError}
      */
     getPunishments: (pageable: Pageable, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 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.
+     * @summary Start an alt-propagation sweep job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    propagationSweep: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Search for players by UUID or username, or look up all players associated with an IP address.
      * @summary Search punishment targets
@@ -3304,6 +3561,14 @@ export declare const AdminPunishmentsApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     editPunishment(id: number, adminUpdatePunishmentRequest: AdminUpdatePunishmentRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * 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\'.
+     * @summary List a punishment\'s current participants
+     * @param {number} id Punishment id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPunishmentTargets(id: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPunishmentTargets>>;
     /**
      * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
      * @summary List punishments
@@ -3318,6 +3583,13 @@ export declare const AdminPunishmentsApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     getPunishments(pageable: Pageable, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PageAdminPunishmentListItem>>;
+    /**
+     * 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.
+     * @summary Start an alt-propagation sweep job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    propagationSweep(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminAsyncJobStartResponse>>;
     /**
      * Search for players by UUID or username, or look up all players associated with an IP address.
      * @summary Search punishment targets
@@ -3356,6 +3628,14 @@ export declare const AdminPunishmentsApiFactory: (configuration?: Configuration,
      * @throws {RequiredError}
      */
     editPunishment(id: number, adminUpdatePunishmentRequest: AdminUpdatePunishmentRequest, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * 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\'.
+     * @summary List a punishment\'s current participants
+     * @param {number} id Punishment id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPunishmentTargets(id: number, options?: RawAxiosRequestConfig): AxiosPromise<AdminPunishmentTargets>;
     /**
      * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
      * @summary List punishments
@@ -3370,6 +3650,13 @@ export declare const AdminPunishmentsApiFactory: (configuration?: Configuration,
      * @throws {RequiredError}
      */
     getPunishments(pageable: Pageable, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<PageAdminPunishmentListItem>;
+    /**
+     * 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.
+     * @summary Start an alt-propagation sweep job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    propagationSweep(options?: RawAxiosRequestConfig): AxiosPromise<AdminAsyncJobStartResponse>;
     /**
      * Search for players by UUID or username, or look up all players associated with an IP address.
      * @summary Search punishment targets
@@ -3408,6 +3695,14 @@ export declare class AdminPunishmentsApi extends BaseAPI {
      * @throws {RequiredError}
      */
     editPunishment(id: number, adminUpdatePunishmentRequest: AdminUpdatePunishmentRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     * 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\'.
+     * @summary List a punishment\'s current participants
+     * @param {number} id Punishment id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPunishmentTargets(id: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminPunishmentTargets, any, {}>>;
     /**
      * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
      * @summary List punishments
@@ -3422,6 +3717,13 @@ export declare class AdminPunishmentsApi extends BaseAPI {
      * @throws {RequiredError}
      */
     getPunishments(pageable: Pageable, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<PunishmentType> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PageAdminPunishmentListItem, any, {}>>;
+    /**
+     * 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.
+     * @summary Start an alt-propagation sweep job
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    propagationSweep(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AdminAsyncJobStartResponse, any, {}>>;
     /**
      * Search for players by UUID or username, or look up all players associated with an IP address.
      * @summary Search punishment targets
@@ -3924,7 +4226,7 @@ export declare class PlayerApi extends BaseAPI {
  */
 export declare const PlayerSessionsApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
-     * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+     * Closes the active session for a (playerUuid, serverSessionId) pair and returns an acknowledgment: whether a session was actually closed, that session\'s start / end / duration, and the player\'s aggregate session stats recomputed after the close. No-op if no active session is found — `sessionClosed` is false and the per-session fields are null (stats are still returned) — so duplicate end events from a retry don\'t error.
      * @summary Close the active player session
      * @param {PlayerSessionEndRequest} playerSessionEndRequest
      * @param {*} [options] Override http request option.
@@ -3945,13 +4247,13 @@ export declare const PlayerSessionsApiAxiosParamCreator: (configuration?: Config
  */
 export declare const PlayerSessionsApiFp: (configuration?: Configuration) => {
     /**
-     * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+     * Closes the active session for a (playerUuid, serverSessionId) pair and returns an acknowledgment: whether a session was actually closed, that session\'s start / end / duration, and the player\'s aggregate session stats recomputed after the close. No-op if no active session is found — `sessionClosed` is false and the per-session fields are null (stats are still returned) — so duplicate end events from a retry don\'t error.
      * @summary Close the active player session
      * @param {PlayerSessionEndRequest} playerSessionEndRequest
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PlayerSessionEndResponse>>;
     /**
      * Single round-trip the game server / proxy makes when a player joins. Runs the full authorization check (VPN detection, bypass tiers, punishment propagation, active-ban evaluation) and — only if allowed — opens (or re-attaches to) a player_session row.  Replaces the older two-call flow (`GET /v1/connection/details` followed by a session-open POST). `/v1/connection/details` remains available for admin / debugging use but is deprecated for player-join purposes.  Idempotent at the session-open step: a duplicate join request returns the existing active session\'s id instead of creating a duplicate row.  Response shape: - `connectionResult` — always populated; carries ALLOWED / BANNED / VPN_DETECTED etc.   plus a formatted kick message when denied. - `sessionId` / `startedAt` — populated only when the join was allowed. - Connection context (IP, location, VPN%, bypass) for display + logging. - `playerInformation`, `activePunishments` — full player history at join time. - `sessionStats` — total seconds played / days active / currently-online, useful   for game-server-side welcome messages.
      * @summary Player join — unified authorization + session-open
@@ -3966,13 +4268,13 @@ export declare const PlayerSessionsApiFp: (configuration?: Configuration) => {
  */
 export declare const PlayerSessionsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
-     * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+     * Closes the active session for a (playerUuid, serverSessionId) pair and returns an acknowledgment: whether a session was actually closed, that session\'s start / end / duration, and the player\'s aggregate session stats recomputed after the close. No-op if no active session is found — `sessionClosed` is false and the per-session fields are null (stats are still returned) — so duplicate end events from a retry don\'t error.
      * @summary Close the active player session
      * @param {PlayerSessionEndRequest} playerSessionEndRequest
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): AxiosPromise<PlayerSessionEndResponse>;
     /**
      * Single round-trip the game server / proxy makes when a player joins. Runs the full authorization check (VPN detection, bypass tiers, punishment propagation, active-ban evaluation) and — only if allowed — opens (or re-attaches to) a player_session row.  Replaces the older two-call flow (`GET /v1/connection/details` followed by a session-open POST). `/v1/connection/details` remains available for admin / debugging use but is deprecated for player-join purposes.  Idempotent at the session-open step: a duplicate join request returns the existing active session\'s id instead of creating a duplicate row.  Response shape: - `connectionResult` — always populated; carries ALLOWED / BANNED / VPN_DETECTED etc.   plus a formatted kick message when denied. - `sessionId` / `startedAt` — populated only when the join was allowed. - Connection context (IP, location, VPN%, bypass) for display + logging. - `playerInformation`, `activePunishments` — full player history at join time. - `sessionStats` — total seconds played / days active / currently-online, useful   for game-server-side welcome messages.
      * @summary Player join — unified authorization + session-open
@@ -3987,13 +4289,13 @@ export declare const PlayerSessionsApiFactory: (configuration?: Configuration, b
  */
 export declare class PlayerSessionsApi extends BaseAPI {
     /**
-     * Closes the active session for a (playerUuid, serverSessionId) pair. No-op if no active session is found, so duplicate end events from a retry don\'t error.
+     * Closes the active session for a (playerUuid, serverSessionId) pair and returns an acknowledgment: whether a session was actually closed, that session\'s start / end / duration, and the player\'s aggregate session stats recomputed after the close. No-op if no active session is found — `sessionClosed` is false and the per-session fields are null (stats are still returned) — so duplicate end events from a retry don\'t error.
      * @summary Close the active player session
      * @param {PlayerSessionEndRequest} playerSessionEndRequest
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    end(playerSessionEndRequest: PlayerSessionEndRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PlayerSessionEndResponse, any, {}>>;
     /**
      * Single round-trip the game server / proxy makes when a player joins. Runs the full authorization check (VPN detection, bypass tiers, punishment propagation, active-ban evaluation) and — only if allowed — opens (or re-attaches to) a player_session row.  Replaces the older two-call flow (`GET /v1/connection/details` followed by a session-open POST). `/v1/connection/details` remains available for admin / debugging use but is deprecated for player-join purposes.  Idempotent at the session-open step: a duplicate join request returns the existing active session\'s id instead of creating a duplicate row.  Response shape: - `connectionResult` — always populated; carries ALLOWED / BANNED / VPN_DETECTED etc.   plus a formatted kick message when denied. - `sessionId` / `startedAt` — populated only when the join was allowed. - Connection context (IP, location, VPN%, bypass) for display + logging. - `playerInformation`, `activePunishments` — full player history at join time. - `sessionStats` — total seconds played / days active / currently-online, useful   for game-server-side welcome messages.
      * @summary Player join — unified authorization + session-open