@rebornteam/reborn-api 3.1.0 → 3.2.1

package/api.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: 3.1.0
+ * The version of the OpenAPI document: 3.2.1
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -38,7 +38,7 @@ export interface AdminApplyPunishmentRequest {
     /**
      * Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical
      */
-    'severity'?: number;
+    'severity': number;
     /**
      * Reason for the punishment
      */
@@ -50,7 +50,7 @@ export interface AdminApplyPunishmentRequest {
     /**
      * Force the punishment to be permanent regardless of the target\'s current score
      */
-    'forcePermanent'?: boolean;
+    'forcePermanent': boolean;
     /**
      * Internal notes visible only to administrators — not shown to the punished player
      */
@@ -65,7 +65,7 @@ export interface AdminApplyPunishmentResponse {
     /**
      * Ordered list of results, one per target in the request
      */
-    'results'?: Array<AdminApplyPunishmentResult>;
+    'results': Array<AdminApplyPunishmentResult>;
 }
 /**
  * Result of applying a punishment to a single target
@@ -74,27 +74,27 @@ export interface AdminApplyPunishmentResult {
     /**
      * The target this result applies to
      */
-    'target'?: AdminPunishmentTarget;
+    'target': AdminPunishmentTarget;
     /**
      * ID of the created punishment record
      */
-    'punishmentId'?: number;
+    'punishmentId': number;
     /**
      * Punishment type applied
      */
-    'type'?: PunishmentType;
+    'type': PunishmentType;
     /**
      * Severity level applied
      */
-    'severity'?: number;
+    'severity': number;
     /**
      * Updated punishment score after applying
      */
-    'newScore'?: number;
+    'newScore': number;
     /**
      * Whether the punishment was made permanent
      */
-    'isPermanent'?: boolean;
+    'isPermanent': boolean;
     /**
      * When the punishment expires — null if permanent or a WARNING
      */
@@ -102,6 +102,23 @@ export interface AdminApplyPunishmentResult {
 }
 
 
+/**
+ * Result of a location backfill run — rechecks every connection_check row missing both city and country, repopulating them from the VPN providers.
+ */
+export interface AdminBackfillLocationResponse {
+    /**
+     * Total checks attempted
+     */
+    'processed': number;
+    /**
+     * Checks where the provider returned at least a city or country
+     */
+    'succeeded': number;
+    /**
+     * Checks that errored or returned no location data
+     */
+    'failed': number;
+}
 /**
  * Client credential response
  */
@@ -109,11 +126,11 @@ export interface AdminClientCredentialResponse {
     /**
      * Unique identifier for the client credential
      */
-    'id'?: number;
+    'id': number;
     /**
      * Client ID used for authentication
      */
-    'clientId'?: string;
+    'clientId': string;
     /**
      * Client secret (only returned on generation/rotation, null otherwise)
      */
@@ -121,19 +138,19 @@ export interface AdminClientCredentialResponse {
     /**
      * Human-readable name for the client
      */
-    'name'?: string;
+    'name': string;
     /**
      * Optional description of the client\'s purpose
      */
-    'description'?: string;
+    'description': string;
     /**
      * Whether the client credential is currently enabled
      */
-    'enabled'?: boolean;
+    'enabled': boolean;
     /**
      * Timestamp when the credential was created (ISO-8601 format)
      */
-    'createdAt'?: string;
+    'createdAt': string;
     /**
      * Timestamp when the credential expires (ISO-8601 format). Null means the credential never expires.
      */
@@ -146,19 +163,19 @@ export interface AdminConnectionBypassResponse {
     /**
      * Unique identifier for the bypass
      */
-    'id'?: number;
+    'id': number;
     /**
      * IP address that is bypassed
      */
-    'ipAddress'?: string;
+    'ipAddress': string;
     /**
      * Timestamp when the bypass expires (ISO-8601 format)
      */
-    'expiresAt'?: string;
+    'expiresAt': string;
     /**
      * Timestamp when the bypass was created (ISO-8601 format)
      */
-    'createdAt'?: string;
+    'createdAt': string;
 }
 /**
  * Result from a single VPN detection service for a given IP address
@@ -167,15 +184,23 @@ export interface AdminConnectionCheckResult {
     /**
      * Service identifier
      */
-    'service'?: string;
+    'service': string;
     /**
      * Whether this service flagged the IP as a VPN, proxy, or Tor exit node
      */
-    'result'?: boolean;
+    'result': boolean;
     /**
      * When this check was last performed
      */
-    'checkedAt'?: string;
+    'checkedAt': string;
+    /**
+     * City reported by this service, if available
+     */
+    'city'?: string | null;
+    /**
+     * Country code reported by this service, if available
+     */
+    'country'?: string | null;
 }
 /**
  * Request to evaluate the impact of a punishment across one or more targets before applying
@@ -192,7 +217,7 @@ export interface AdminCreatePunishmentDraftRequest {
     /**
      * Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical
      */
-    'severity'?: number;
+    'severity': number;
     /**
      * Reason for the punishment (not used in evaluation, required for apply)
      */
@@ -204,14 +229,14 @@ export interface AdminCreatePunishmentDraftRequest {
     /**
      * Force the punishment to be permanent regardless of the target\'s current score
      */
-    'forcePermanent'?: boolean;
+    'forcePermanent': boolean;
 }
 
 
 export interface AdminDashboardConnectionResponse {
     'id': number;
     'ipAddress': string;
-    'location': string;
+    'location'?: string | null;
     'isVpn': boolean;
     'isBypassed': boolean;
     'bypassExpiresAt'?: string | null;
@@ -222,7 +247,7 @@ export interface AdminDashboardConnectionResponse {
     /**
      * Results from each VPN detection service for this IP address
      */
-    'results'?: Array<AdminConnectionCheckResult>;
+    'results': Array<AdminConnectionCheckResult>;
 }
 export interface AdminGetDashboardStats {
     'totalPlayers': number;
@@ -236,11 +261,11 @@ export interface AdminIpSearchResult {
     /**
      * IP address
      */
-    'ipAddress'?: string;
+    'ipAddress': string;
     /**
      * Players ever seen on this IP
      */
-    'players'?: Array<AdminPlayerSearchResult>;
+    'players': Array<AdminPlayerSearchResult>;
 }
 /**
  * Paginated connection list response
@@ -249,23 +274,23 @@ export interface AdminPagedConnectionResponse {
     /**
      * Connections on the current page
      */
-    'data'?: Array<AdminDashboardConnectionResponse>;
+    'data': Array<AdminDashboardConnectionResponse>;
     /**
      * Total number of connections matching the filters
      */
-    'total'?: number;
+    'total': number;
     /**
      * Current page (1-indexed)
      */
-    'page'?: number;
+    'page': number;
     /**
      * Page size
      */
-    'limit'?: number;
+    'limit': number;
     /**
      * Total number of pages
      */
-    'totalPages'?: number;
+    'totalPages': number;
 }
 /**
  * Paginated player list response
@@ -274,23 +299,23 @@ export interface AdminPagedPlayerResponse {
     /**
      * Players on the current page
      */
-    'data'?: Array<AdminPlayerSummary>;
+    'data': Array<AdminPlayerSummary>;
     /**
      * Total number of players matching the search filter
      */
-    'total'?: number;
+    'total': number;
     /**
      * Current page (1-indexed)
      */
-    'page'?: number;
+    'page': number;
     /**
      * Page size
      */
-    'limit'?: number;
+    'limit': number;
     /**
      * Total number of pages
      */
-    'totalPages'?: number;
+    'totalPages': number;
 }
 /**
  * Paginated punishment list response
@@ -299,23 +324,23 @@ export interface AdminPagedPunishmentResponse {
     /**
      * Punishments on the current page
      */
-    'data'?: Array<AdminPunishmentListItem>;
+    'data': Array<AdminPunishmentListItem>;
     /**
      * Total number of punishments matching the filters
      */
-    'total'?: number;
+    'total': number;
     /**
      * Current page (1-indexed)
      */
-    'page'?: number;
+    'page': number;
     /**
      * Page size
      */
-    'limit'?: number;
+    'limit': number;
     /**
      * Total number of pages
      */
-    'totalPages'?: number;
+    'totalPages': number;
 }
 /**
  * Full player detail including punishment history and all known usernames
@@ -324,11 +349,11 @@ export interface AdminPlayerDetailResponse {
     /**
      * Internal player ID
      */
-    'id'?: number;
+    'id': number;
     /**
      * Player Minecraft UUID
      */
-    'uuid'?: string;
+    'uuid': string;
     /**
      * Most recently seen username
      */
@@ -336,11 +361,11 @@ export interface AdminPlayerDetailResponse {
     /**
      * Whether this player still has first-join status
      */
-    'firstJoin'?: boolean;
+    'firstJoin': boolean;
     /**
      * Timestamp of first connection (ISO-8601)
      */
-    'firstLogin'?: string;
+    'firstLogin': string;
     /**
      * Timestamp of most recent connection (ISO-8601)
      */
@@ -348,15 +373,15 @@ export interface AdminPlayerDetailResponse {
     /**
      * Raw punishment score
      */
-    'punishmentPointsRaw'?: number;
+    'punishmentPointsRaw': number;
     /**
      * Punishment score as a percentage
      */
-    'punishmentPointsPercent'?: number;
+    'punishmentPointsPercent': number;
     /**
      * All usernames this player has used, newest first
      */
-    'usernameHistory'?: Array<AdminUsernameHistoryEntry>;
+    'usernameHistory': Array<AdminUsernameHistoryEntry>;
 }
 /**
  * Lightweight player reference used in search results and punishment evaluations
@@ -365,7 +390,7 @@ export interface AdminPlayerSearchResult {
     /**
      * Player Minecraft UUID
      */
-    'uuid'?: string;
+    'uuid': string;
     /**
      * Most recently seen username, null if never recorded
      */
@@ -378,11 +403,11 @@ export interface AdminPlayerSummary {
     /**
      * Internal player ID
      */
-    'id'?: number;
+    'id': number;
     /**
      * Player Minecraft UUID
      */
-    'uuid'?: string;
+    'uuid': string;
     /**
      * Most recently seen username, null if never recorded
      */
@@ -390,11 +415,11 @@ export interface AdminPlayerSummary {
     /**
      * Whether this player still has first-join status
      */
-    'firstJoin'?: boolean;
+    'firstJoin': boolean;
     /**
      * Timestamp of first connection (ISO-8601)
      */
-    'firstLogin'?: string;
+    'firstLogin': string;
     /**
      * Timestamp of most recent connection (ISO-8601)
      */
@@ -402,11 +427,11 @@ export interface AdminPlayerSummary {
     /**
      * Raw punishment score (sum of weighted punishment values)
      */
-    'punishmentPointsRaw'?: number;
+    'punishmentPointsRaw': number;
     /**
      * Punishment score as a percentage. Values above 100 indicate future punishments should be permanent.
      */
-    'punishmentPointsPercent'?: number;
+    'punishmentPointsPercent': number;
 }
 /**
  * Batch punishment draft — one evaluation per target
@@ -415,7 +440,7 @@ export interface AdminPunishmentDraftResponse {
     /**
      * Ordered list of evaluations, one per target in the request
      */
-    'evaluations'?: Array<AdminPunishmentEvaluation>;
+    'evaluations': Array<AdminPunishmentEvaluation>;
 }
 /**
  * Evaluation of a punishment\'s impact on a single target
@@ -424,27 +449,27 @@ export interface AdminPunishmentEvaluation {
     /**
      * The target this evaluation applies to
      */
-    'target'?: AdminPunishmentTarget;
+    'target': AdminPunishmentTarget;
     /**
      * Players affected — one player for UUID targets, all players on the IP for connection targets
      */
-    'affectedPlayers'?: Array<AdminPlayerSearchResult>;
+    'affectedPlayers': Array<AdminPlayerSearchResult>;
     /**
      * Current punishment score before applying this punishment (0–100+)
      */
-    'currentScore'?: number;
+    'currentScore': number;
     /**
      * Points this punishment would add to the score
      */
-    'pointsToAdd'?: number;
+    'pointsToAdd': number;
     /**
      * Projected score after applying this punishment
      */
-    'newScore'?: number;
+    'newScore': number;
     /**
      * Whether this punishment would be permanent based on the current score threshold
      */
-    'willBePermanent'?: boolean;
+    'willBePermanent': boolean;
     /**
      * Resolved duration in seconds — null if permanent or a WARNING
      */
@@ -452,15 +477,15 @@ export interface AdminPunishmentEvaluation {
     /**
      * Number of existing punishments on this target
      */
-    'previousPunishmentCount'?: number;
+    'previousPunishmentCount': number;
     /**
      * True when the target is an IP address (connection punishment) rather than a player UUID
      */
-    'isConnectionTarget'?: boolean;
+    'isConnectionTarget': boolean;
     /**
      * The effective punishment type that will be applied — may differ from the requested type if escalated to BAN at threshold
      */
-    'effectiveType'?: PunishmentType;
+    'effectiveType': PunishmentType;
 }
 
 
@@ -487,15 +512,15 @@ export interface AdminPunishmentSearchResponse {
     /**
      * Search kind — PLAYER for UUID/username searches, IP for IP address searches
      */
-    'kind'?: SearchKind;
+    'kind': SearchKind;
     /**
      * Matching players — only populated when kind=\'player\'
      */
-    'players'?: Array<AdminPlayerSearchResult>;
+    'players': Array<AdminPlayerSearchResult>;
     /**
      * Matching IP addresses with their associated players — only populated when kind=\'ip\'
      */
-    'ipResults'?: Array<AdminIpSearchResult>;
+    'ipResults': Array<AdminIpSearchResult>;
 }
 
 
@@ -519,11 +544,11 @@ export interface AdminUsernameHistoryEntry {
     /**
      * The username at this point in time
      */
-    'username'?: string;
+    'username': string;
     /**
      * When this username was first observed (ISO-8601)
      */
-    'changedAt'?: string;
+    'changedAt': string;
 }
 export interface ChatMessageDTO {
     'id': number;
@@ -563,23 +588,23 @@ export interface ConnectionGetConnectionDetailsResponse {
     /**
      * The analyzed IPv4 address
      */
-    'ipAddress'?: string;
+    'ipAddress': string;
     /**
      * Approximate geographic location of the IP address. Returns \'Local, N/A\' for localhost or private IPs.
      */
-    'approximateLocation'?: string;
+    'approximateLocation': string;
     /**
      * Confidence score representing the percentage of VPN detection services that flagged this IP as suspicious. Range: 0.0 (clean) to 100.0 (definitely VPN/proxy).
      */
-    'percentPositive'?: number;
+    'percentPositive': number;
     /**
      * Total number of VPN detection services successfully queried during the last check.
      */
-    'numberOfChecks'?: number;
+    'numberOfChecks': number;
     /**
      * Indicates if this IP address has been administratively bypassed.
      */
-    'isBypassed'?: boolean;
+    'isBypassed': boolean;
     /**
      * Expiration timestamp for the bypass (ISO-8601 format). Null if not bypassed or bypass is permanent.
      */
@@ -587,7 +612,7 @@ export interface ConnectionGetConnectionDetailsResponse {
     /**
      * Results from each VPN detection service that checked this IP address
      */
-    'results'?: Array<AdminConnectionCheckResult>;
+    'results': Array<AdminConnectionCheckResult>;
     /**
      * Player information associated with this connection. Only populated when \'associate_uuid\' query parameter is provided.
      */
@@ -595,7 +620,7 @@ export interface ConnectionGetConnectionDetailsResponse {
     /**
      * Combined list of active punishments for both the IP address and player UUID (if provided). Only includes non-expired punishments.
      */
-    'punishments'?: Array<PunishmentGetPunishmentResponse>;
+    'punishments': Array<PunishmentGetPunishmentResponse>;
     /**
      * Join enforcement result. Only populated when \'associate_uuid\' query parameter is provided. Contains the final allow/deny decision and a formatted kick message if denied.
      */
@@ -655,19 +680,19 @@ export interface PlayerGetPlayerInformation {
     /**
      * Indicates whether this is the player\'s first time joining the server.
      */
-    'firstJoin'?: boolean;
+    'firstJoin': boolean;
     /**
      * Timestamp of when the player first connected to the server (ISO-8601 format).
      */
-    'firstLogin'?: string;
+    'firstLogin': string;
     /**
      * Raw punishment score calculated as: SUM((base_weight × severity/10)). Used for tracking overall punishment severity.
      */
-    'punishmentPointsRaw'?: number;
+    'punishmentPointsRaw': number;
     /**
      * Punishment score as a percentage (0-100). When >100% before applying a new punishment, the new punishment should be made permanent.
      */
-    'punishmentPointsPercent'?: number;
+    'punishmentPointsPercent': number;
 }
 /**
  * Punishment information including reason, type, creator, and expiration
@@ -676,11 +701,11 @@ export interface PunishmentGetPunishmentResponse {
     /**
      * Unique identifier for the punishment
      */
-    'id'?: number;
+    'id': number;
     /**
      * Reason for the punishment, shown to the punished player
      */
-    'reason'?: string;
+    'reason': string;
     /**
      * Internal administrator notes — not shown to the punished player
      */
@@ -688,15 +713,15 @@ export interface PunishmentGetPunishmentResponse {
     /**
      * Type of punishment
      */
-    'type'?: PunishmentType;
+    'type': PunishmentType;
     /**
      * Severity level (1=Minor, 2=Moderate, 3=Severe, 4=Critical)
      */
-    'severity'?: number;
+    'severity': number;
     /**
      * Username or identifier of the person who created this punishment
      */
-    'createdBy'?: string;
+    'createdBy': string;
     /**
      * Timestamp when the punishment expires (ISO-8601 format). Null for permanent punishments.
      */
@@ -704,7 +729,7 @@ export interface PunishmentGetPunishmentResponse {
     /**
      * Timestamp when the punishment was created (ISO-8601 format)
      */
-    'createdAt'?: string;
+    'createdAt': string;
 }
 
 
@@ -715,7 +740,7 @@ export interface PunishmentSeveritiesResponse {
     /**
      * List of punishment types with their severity durations
      */
-    'punishmentTypes'?: Array<PunishmentSeveritiesResponsePunishmentTypeInfo>;
+    'punishmentTypes': Array<PunishmentSeveritiesResponsePunishmentTypeInfo>;
 }
 /**
  * Punishment type with severity information
@@ -724,11 +749,11 @@ export interface PunishmentSeveritiesResponsePunishmentTypeInfo {
     /**
      * Type of punishment
      */
-    'type'?: PunishmentType;
+    'type': PunishmentType;
     /**
      * List of severity levels with durations
      */
-    'severities'?: Array<PunishmentSeveritiesResponseSeverityInfo>;
+    'severities': Array<PunishmentSeveritiesResponseSeverityInfo>;
 }
 
 
@@ -739,11 +764,11 @@ export interface PunishmentSeveritiesResponseSeverityInfo {
     /**
      * Severity level
      */
-    'severity'?: number;
+    'severity': number;
     /**
      * Duration in seconds (0 means no duration)
      */
-    'durationSeconds'?: number;
+    'durationSeconds': number;
 }
 
 export const PunishmentTargetType = {
@@ -1386,6 +1411,40 @@ export class AdminClientCredentialsApi extends BaseAPI {
  */
 export const AdminConnectionsApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
+        /**
+         * Iterates every connection_check row where both city and country are NULL and re-runs that row\'s source VPN service to populate location data. Concurrency is capped to avoid overwhelming external providers. Synchronous — returns once the run completes.
+         * @summary Backfill missing location data
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        backfillLocation: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/admin/connection/backfill-location`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
         /**
          * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
          * @summary Create connection bypass
@@ -1604,6 +1663,18 @@ export const AdminConnectionsApiAxiosParamCreator = function (configuration?: Co
 export const AdminConnectionsApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = AdminConnectionsApiAxiosParamCreator(configuration)
     return {
+        /**
+         * Iterates every connection_check row where both city and country are NULL and re-runs that row\'s source VPN service to populate location data. Concurrency is capped to avoid overwhelming external providers. Synchronous — returns once the run completes.
+         * @summary Backfill missing location data
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async backfillLocation(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminBackfillLocationResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.backfillLocation(options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminConnectionsApi.backfillLocation']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
         /**
          * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
          * @summary Create connection bypass
@@ -1676,6 +1747,15 @@ export const AdminConnectionsApiFp = function(configuration?: Configuration) {
 export const AdminConnectionsApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
     const localVarFp = AdminConnectionsApiFp(configuration)
     return {
+        /**
+         * Iterates every connection_check row where both city and country are NULL and re-runs that row\'s source VPN service to populate location data. Concurrency is capped to avoid overwhelming external providers. Synchronous — returns once the run completes.
+         * @summary Backfill missing location data
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        backfillLocation(options?: RawAxiosRequestConfig): AxiosPromise<AdminBackfillLocationResponse> {
+            return localVarFp.backfillLocation(options).then((request) => request(axios, basePath));
+        },
         /**
          * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
          * @summary Create connection bypass
@@ -1734,6 +1814,16 @@ export const AdminConnectionsApiFactory = function (configuration?: Configuratio
  * AdminConnectionsApi - object-oriented interface
  */
 export class AdminConnectionsApi extends BaseAPI {
+    /**
+     * Iterates every connection_check row where both city and country are NULL and re-runs that row\'s source VPN service to populate location data. Concurrency is capped to avoid overwhelming external providers. Synchronous — returns once the run completes.
+     * @summary Backfill missing location data
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public backfillLocation(options?: RawAxiosRequestConfig) {
+        return AdminConnectionsApiFp(this.configuration).backfillLocation(options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * Creates a temporary bypass for an IP address, expiring at the specified epoch timestamp (milliseconds since Unix epoch).
      * @summary Create connection bypass