@takaro/apiclient 0.0.0-dev.7ef2191 → 0.0.0-dev.814dfa1

package/src/generated/api.ts

@@ -3322,6 +3322,315 @@ export interface EventEntityKilled {
    */
   msg?: string;
 }
+/**
+ *
+ * @export
+ * @interface EventExploreCursorDTO
+ */
+export interface EventExploreCursorDTO {
+  /**
+   *
+   * @type {NOTDOMAINSCOPEDTakaroModelDTOCreatedAt}
+   * @memberof EventExploreCursorDTO
+   */
+  time: NOTDOMAINSCOPEDTakaroModelDTOCreatedAt;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreCursorDTO
+   */
+  id: string;
+}
+/**
+ *
+ * @export
+ * @interface EventExploreFiltersDTO
+ */
+export interface EventExploreFiltersDTO {
+  /**
+   *
+   * @type {Array<string>}
+   * @memberof EventExploreFiltersDTO
+   */
+  id?: Array<string>;
+  /**
+   *
+   * @type {Array<string>}
+   * @memberof EventExploreFiltersDTO
+   */
+  eventName?: Array<EventExploreFiltersDTOEventNameEnum>;
+  /**
+   *
+   * @type {Array<string>}
+   * @memberof EventExploreFiltersDTO
+   */
+  playerId?: Array<string>;
+  /**
+   *
+   * @type {Array<string>}
+   * @memberof EventExploreFiltersDTO
+   */
+  gameserverId?: Array<string>;
+  /**
+   *
+   * @type {Array<string>}
+   * @memberof EventExploreFiltersDTO
+   */
+  moduleId?: Array<string>;
+  /**
+   *
+   * @type {Array<string>}
+   * @memberof EventExploreFiltersDTO
+   */
+  userId?: Array<string>;
+  /**
+   *
+   * @type {Array<string>}
+   * @memberof EventExploreFiltersDTO
+   */
+  actingUserId?: Array<string>;
+  /**
+   *
+   * @type {Array<string>}
+   * @memberof EventExploreFiltersDTO
+   */
+  actingModuleId?: Array<string>;
+}
+
+export const EventExploreFiltersDTOEventNameEnum = {
+  RoleAssigned: 'role-assigned',
+  RoleRemoved: 'role-removed',
+  RoleCreated: 'role-created',
+  RoleUpdated: 'role-updated',
+  RoleDeleted: 'role-deleted',
+  CommandExecuted: 'command-executed',
+  CommandExecutionDenied: 'command-execution-denied',
+  HookExecuted: 'hook-executed',
+  CronjobExecuted: 'cronjob-executed',
+  CurrencyAdded: 'currency-added',
+  CurrencyDeducted: 'currency-deducted',
+  CurrencyResetAll: 'currency-reset-all',
+  SettingsSet: 'settings-set',
+  PlayerNewIpDetected: 'player-new-ip-detected',
+  PlayerNewNameDetected: 'player-new-name-detected',
+  ServerStatusChanged: 'server-status-changed',
+  ModuleCreated: 'module-created',
+  ModuleUpdated: 'module-updated',
+  ModuleDeleted: 'module-deleted',
+  ModuleInstalled: 'module-installed',
+  ModuleUninstalled: 'module-uninstalled',
+  PlayerCreated: 'player-created',
+  ShopListingCreated: 'shop-listing-created',
+  ShopListingUpdated: 'shop-listing-updated',
+  ShopListingDeleted: 'shop-listing-deleted',
+  ShopOrderCreated: 'shop-order-created',
+  ShopOrderStatusChanged: 'shop-order-status-changed',
+  ShopOrderDeliveryFailed: 'shop-order-delivery-failed',
+  PlayerLinked: 'player-linked',
+  GameserverCreated: 'gameserver-created',
+  GameserverUpdated: 'gameserver-updated',
+  GameserverDeleted: 'gameserver-deleted',
+  PlayerBanned: 'player-banned',
+  PlayerUnbanned: 'player-unbanned',
+  PlayerDeleted: 'player-deleted',
+  ShopActionExecuted: 'shop-action-executed',
+  PlayerInventoryChanged: 'player-inventory-changed',
+  EventRateLimited: 'event-rate-limited',
+  PlayerSyncSnapshot: 'player-sync-snapshot',
+  PlayerConnected: 'player-connected',
+  PlayerDisconnected: 'player-disconnected',
+  ChatMessage: 'chat-message',
+  PlayerDeath: 'player-death',
+  EntityKilled: 'entity-killed',
+} as const;
+
+export type EventExploreFiltersDTOEventNameEnum =
+  (typeof EventExploreFiltersDTOEventNameEnum)[keyof typeof EventExploreFiltersDTOEventNameEnum];
+
+/**
+ *
+ * @export
+ * @interface EventExploreInputDTO
+ */
+export interface EventExploreInputDTO {
+  /**
+   *
+   * @type {EventExploreFiltersDTO}
+   * @memberof EventExploreInputDTO
+   */
+  filters?: EventExploreFiltersDTO;
+  /**
+   *
+   * @type {Array<any>}
+   * @memberof EventExploreInputDTO
+   */
+  metaFilters?: Array<any>;
+  /**
+   *
+   * @type {NOTDOMAINSCOPEDTakaroModelDTOCreatedAt}
+   * @memberof EventExploreInputDTO
+   */
+  startDate?: NOTDOMAINSCOPEDTakaroModelDTOCreatedAt;
+  /**
+   *
+   * @type {NOTDOMAINSCOPEDTakaroModelDTOCreatedAt}
+   * @memberof EventExploreInputDTO
+   */
+  endDate?: NOTDOMAINSCOPEDTakaroModelDTOCreatedAt;
+  /**
+   *
+   * @type {EventExploreCursorDTO}
+   * @memberof EventExploreInputDTO
+   */
+  cursor?: EventExploreCursorDTO;
+  /**
+   *
+   * @type {number}
+   * @memberof EventExploreInputDTO
+   */
+  limit?: number;
+}
+/**
+ *
+ * @export
+ * @interface EventExploreOutputDTO
+ */
+export interface EventExploreOutputDTO {
+  /**
+   *
+   * @type {Array<EventExploreRowDTO>}
+   * @memberof EventExploreOutputDTO
+   */
+  rows: Array<EventExploreRowDTO>;
+  /**
+   *
+   * @type {any}
+   * @memberof EventExploreOutputDTO
+   */
+  nextCursor?: any;
+}
+/**
+ *
+ * @export
+ * @interface EventExploreOutputDTOAPI
+ */
+export interface EventExploreOutputDTOAPI {
+  /**
+   *
+   * @type {EventExploreOutputDTO}
+   * @memberof EventExploreOutputDTOAPI
+   */
+  data: EventExploreOutputDTO;
+  /**
+   *
+   * @type {MetadataOutput}
+   * @memberof EventExploreOutputDTOAPI
+   */
+  meta: MetadataOutput;
+}
+/**
+ *
+ * @export
+ * @interface EventExploreRowDTO
+ */
+export interface EventExploreRowDTO {
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  id: string;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  eventName: string;
+  /**
+   *
+   * @type {NOTDOMAINSCOPEDTakaroModelDTOCreatedAt}
+   * @memberof EventExploreRowDTO
+   */
+  createdAt: NOTDOMAINSCOPEDTakaroModelDTOCreatedAt;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  playerId?: string;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  playerName?: string;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  gameserverId?: string;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  gameServerName?: string;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  moduleId?: string;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  moduleName?: string;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  userId?: string;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  userName?: string;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  actingUserId?: string;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  actingUserName?: string;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  actingModuleId?: string;
+  /**
+   *
+   * @type {string}
+   * @memberof EventExploreRowDTO
+   */
+  actingModuleName?: string;
+  /**
+   *
+   * @type {object}
+   * @memberof EventExploreRowDTO
+   */
+  meta: object;
+}
 /**
  *
  * @export
@@ -3826,6 +4135,168 @@ export const EventSearchInputDTOSortDirectionEnum = {
 export type EventSearchInputDTOSortDirectionEnum =
   (typeof EventSearchInputDTOSortDirectionEnum)[keyof typeof EventSearchInputDTOSortDirectionEnum];
 
+/**
+ *
+ * @export
+ * @interface EventVolumeDimensionTotalDTO
+ */
+export interface EventVolumeDimensionTotalDTO {
+  /**
+   *
+   * @type {string}
+   * @memberof EventVolumeDimensionTotalDTO
+   */
+  key: string;
+  /**
+   * Resolved display name (populated when groupBy=gameServerId). Null for the
+   * "other" bucket or when the entity no longer exists.
+   * @type {string}
+   * @memberof EventVolumeDimensionTotalDTO
+   */
+  name?: string | null;
+  /**
+   *
+   * @type {number}
+   * @memberof EventVolumeDimensionTotalDTO
+   */
+  count: number;
+}
+/**
+ *
+ * @export
+ * @interface EventVolumeInputDTO
+ */
+export interface EventVolumeInputDTO {
+  /**
+   *
+   * @type {EventExploreFiltersDTO}
+   * @memberof EventVolumeInputDTO
+   */
+  filters?: EventExploreFiltersDTO;
+  /**
+   *
+   * @type {Array<any>}
+   * @memberof EventVolumeInputDTO
+   */
+  metaFilters?: Array<any>;
+  /**
+   *
+   * @type {NOTDOMAINSCOPEDTakaroModelDTOCreatedAt}
+   * @memberof EventVolumeInputDTO
+   */
+  startDate?: NOTDOMAINSCOPEDTakaroModelDTOCreatedAt;
+  /**
+   *
+   * @type {NOTDOMAINSCOPEDTakaroModelDTOCreatedAt}
+   * @memberof EventVolumeInputDTO
+   */
+  endDate?: NOTDOMAINSCOPEDTakaroModelDTOCreatedAt;
+  /**
+   *
+   * @type {string}
+   * @memberof EventVolumeInputDTO
+   */
+  groupBy?: EventVolumeInputDTOGroupByEnum;
+  /**
+   * Optional preset period name (e.g. "24h", "7d") enabling result caching
+   * for standard preset windows with empty filters.
+   * @type {string}
+   * @memberof EventVolumeInputDTO
+   */
+  period?: string;
+}
+
+export const EventVolumeInputDTOGroupByEnum = {
+  EventName: 'eventName',
+  GameServerId: 'gameServerId',
+} as const;
+
+export type EventVolumeInputDTOGroupByEnum =
+  (typeof EventVolumeInputDTOGroupByEnum)[keyof typeof EventVolumeInputDTOGroupByEnum];
+
+/**
+ *
+ * @export
+ * @interface EventVolumeOutputDTO
+ */
+export interface EventVolumeOutputDTO {
+  /**
+   *
+   * @type {Array<EventVolumeSeriesDTO>}
+   * @memberof EventVolumeOutputDTO
+   */
+  series: Array<EventVolumeSeriesDTO>;
+  /**
+   *
+   * @type {Array<EventVolumeDimensionTotalDTO>}
+   * @memberof EventVolumeOutputDTO
+   */
+  totalsByDimension: Array<EventVolumeDimensionTotalDTO>;
+}
+/**
+ *
+ * @export
+ * @interface EventVolumeOutputDTOAPI
+ */
+export interface EventVolumeOutputDTOAPI {
+  /**
+   *
+   * @type {EventVolumeOutputDTO}
+   * @memberof EventVolumeOutputDTOAPI
+   */
+  data: EventVolumeOutputDTO;
+  /**
+   *
+   * @type {MetadataOutput}
+   * @memberof EventVolumeOutputDTOAPI
+   */
+  meta: MetadataOutput;
+}
+/**
+ *
+ * @export
+ * @interface EventVolumePointDTO
+ */
+export interface EventVolumePointDTO {
+  /**
+   *
+   * @type {NOTDOMAINSCOPEDTakaroModelDTOCreatedAt}
+   * @memberof EventVolumePointDTO
+   */
+  timestamp: NOTDOMAINSCOPEDTakaroModelDTOCreatedAt;
+  /**
+   *
+   * @type {number}
+   * @memberof EventVolumePointDTO
+   */
+  value: number;
+}
+/**
+ *
+ * @export
+ * @interface EventVolumeSeriesDTO
+ */
+export interface EventVolumeSeriesDTO {
+  /**
+   *
+   * @type {string}
+   * @memberof EventVolumeSeriesDTO
+   */
+  key: string;
+  /**
+   * Resolved display name (populated when groupBy=gameServerId). Null for the
+   * "other" bucket or when the entity no longer exists.
+   * @type {string}
+   * @memberof EventVolumeSeriesDTO
+   */
+  name?: string | null;
+  /**
+   *
+   * @type {Array<EventVolumePointDTO>}
+   * @memberof EventVolumeSeriesDTO
+   */
+  points: Array<EventVolumePointDTO>;
+}
 /**
  *
  * @export
@@ -24752,6 +25223,80 @@ export const EventApiAxiosParamCreator = function (configuration?: Configuration
         options: localVarRequestOptions,
       };
     },
+    /**
+     * Cursor-paginated event search powered by ClickHouse. Rows are hydrated with current entity names (player, gameserver, module, user) from Postgres. Use the returned `nextCursor` to fetch older events; pass `cursor: null` (or omit) to start from the newest.   Required permissions: `READ_EVENTS`<br> OperationId: `EventControllerExplore`
+     * @summary Explore events (ClickHouse-backed)
+     * @param {EventExploreInputDTO} [eventExploreInputDTO] EventExploreInputDTO
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    eventControllerExplore: async (
+      eventExploreInputDTO?: EventExploreInputDTO,
+      options: RawAxiosRequestConfig = {},
+    ): Promise<RequestArgs> => {
+      const localVarPath = `/event/explore`;
+      // 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 domainAuth required
+
+      localVarHeaderParameter['Content-Type'] = 'application/json';
+
+      setSearchParams(localVarUrlObj, localVarQueryParameter);
+      let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+      localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+      localVarRequestOptions.data = serializeDataIfNeeded(eventExploreInputDTO, localVarRequestOptions, configuration);
+
+      return {
+        url: toPathString(localVarUrlObj),
+        options: localVarRequestOptions,
+      };
+    },
+    /**
+     * Returns time-bucketed event counts, optionally stacked by event name or game server. Accepts the same filter shape as `/event/explore` so the graph matches the stream. Bucket size adapts to the range. Caches preset-period queries with empty filters/metaFilters.   Required permissions: `READ_EVENTS`<br> OperationId: `EventControllerExploreVolume`
+     * @summary Get event volume time-series with optional grouping
+     * @param {EventVolumeInputDTO} [eventVolumeInputDTO] EventVolumeInputDTO
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    eventControllerExploreVolume: async (
+      eventVolumeInputDTO?: EventVolumeInputDTO,
+      options: RawAxiosRequestConfig = {},
+    ): Promise<RequestArgs> => {
+      const localVarPath = `/event/explore/volume`;
+      // 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 domainAuth required
+
+      localVarHeaderParameter['Content-Type'] = 'application/json';
+
+      setSearchParams(localVarUrlObj, localVarQueryParameter);
+      let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+      localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+      localVarRequestOptions.data = serializeDataIfNeeded(eventVolumeInputDTO, localVarRequestOptions, configuration);
+
+      return {
+        url: toPathString(localVarUrlObj),
+        options: localVarRequestOptions,
+      };
+    },
     /**
      * Export events matching the search criteria to CSV format. Accepts the same parameters as the search endpoint. Maximum time range is 90 days.   Required permissions: `READ_EVENTS`<br> OperationId: `EventControllerExport`
      * @summary Export events to CSV
@@ -24929,6 +25474,55 @@ export const EventApiFp = function (configuration?: Configuration) {
           configuration,
         )(axios, localVarOperationServerBasePath || basePath);
     },
+    /**
+     * Cursor-paginated event search powered by ClickHouse. Rows are hydrated with current entity names (player, gameserver, module, user) from Postgres. Use the returned `nextCursor` to fetch older events; pass `cursor: null` (or omit) to start from the newest.   Required permissions: `READ_EVENTS`<br> OperationId: `EventControllerExplore`
+     * @summary Explore events (ClickHouse-backed)
+     * @param {EventExploreInputDTO} [eventExploreInputDTO] EventExploreInputDTO
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    async eventControllerExplore(
+      eventExploreInputDTO?: EventExploreInputDTO,
+      options?: RawAxiosRequestConfig,
+    ): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<EventExploreOutputDTOAPI>> {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.eventControllerExplore(eventExploreInputDTO, options);
+      const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+      const localVarOperationServerBasePath =
+        operationServerMap['EventApi.eventControllerExplore']?.[localVarOperationServerIndex]?.url;
+      return (axios, basePath) =>
+        createRequestFunction(
+          localVarAxiosArgs,
+          globalAxios,
+          BASE_PATH,
+          configuration,
+        )(axios, localVarOperationServerBasePath || basePath);
+    },
+    /**
+     * Returns time-bucketed event counts, optionally stacked by event name or game server. Accepts the same filter shape as `/event/explore` so the graph matches the stream. Bucket size adapts to the range. Caches preset-period queries with empty filters/metaFilters.   Required permissions: `READ_EVENTS`<br> OperationId: `EventControllerExploreVolume`
+     * @summary Get event volume time-series with optional grouping
+     * @param {EventVolumeInputDTO} [eventVolumeInputDTO] EventVolumeInputDTO
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    async eventControllerExploreVolume(
+      eventVolumeInputDTO?: EventVolumeInputDTO,
+      options?: RawAxiosRequestConfig,
+    ): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<EventVolumeOutputDTOAPI>> {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.eventControllerExploreVolume(
+        eventVolumeInputDTO,
+        options,
+      );
+      const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+      const localVarOperationServerBasePath =
+        operationServerMap['EventApi.eventControllerExploreVolume']?.[localVarOperationServerIndex]?.url;
+      return (axios, basePath) =>
+        createRequestFunction(
+          localVarAxiosArgs,
+          globalAxios,
+          BASE_PATH,
+          configuration,
+        )(axios, localVarOperationServerBasePath || basePath);
+    },
     /**
      * Export events matching the search criteria to CSV format. Accepts the same parameters as the search endpoint. Maximum time range is 90 days.   Required permissions: `READ_EVENTS`<br> OperationId: `EventControllerExport`
      * @summary Export events to CSV
@@ -25047,6 +25641,36 @@ export const EventApiFactory = function (configuration?: Configuration, basePath
     ): AxiosPromise<EventOutputDTO> {
       return localVarFp.eventControllerCreate(eventCreateDTO, options).then((request) => request(axios, basePath));
     },
+    /**
+     * Cursor-paginated event search powered by ClickHouse. Rows are hydrated with current entity names (player, gameserver, module, user) from Postgres. Use the returned `nextCursor` to fetch older events; pass `cursor: null` (or omit) to start from the newest.   Required permissions: `READ_EVENTS`<br> OperationId: `EventControllerExplore`
+     * @summary Explore events (ClickHouse-backed)
+     * @param {EventExploreInputDTO} [eventExploreInputDTO] EventExploreInputDTO
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    eventControllerExplore(
+      eventExploreInputDTO?: EventExploreInputDTO,
+      options?: RawAxiosRequestConfig,
+    ): AxiosPromise<EventExploreOutputDTOAPI> {
+      return localVarFp
+        .eventControllerExplore(eventExploreInputDTO, options)
+        .then((request) => request(axios, basePath));
+    },
+    /**
+     * Returns time-bucketed event counts, optionally stacked by event name or game server. Accepts the same filter shape as `/event/explore` so the graph matches the stream. Bucket size adapts to the range. Caches preset-period queries with empty filters/metaFilters.   Required permissions: `READ_EVENTS`<br> OperationId: `EventControllerExploreVolume`
+     * @summary Get event volume time-series with optional grouping
+     * @param {EventVolumeInputDTO} [eventVolumeInputDTO] EventVolumeInputDTO
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    eventControllerExploreVolume(
+      eventVolumeInputDTO?: EventVolumeInputDTO,
+      options?: RawAxiosRequestConfig,
+    ): AxiosPromise<EventVolumeOutputDTOAPI> {
+      return localVarFp
+        .eventControllerExploreVolume(eventVolumeInputDTO, options)
+        .then((request) => request(axios, basePath));
+    },
     /**
      * Export events matching the search criteria to CSV format. Accepts the same parameters as the search endpoint. Maximum time range is 90 days.   Required permissions: `READ_EVENTS`<br> OperationId: `EventControllerExport`
      * @summary Export events to CSV
@@ -25122,6 +25746,34 @@ export class EventApi extends BaseAPI {
       .then((request) => request(this.axios, this.basePath));
   }
 
+  /**
+   * Cursor-paginated event search powered by ClickHouse. Rows are hydrated with current entity names (player, gameserver, module, user) from Postgres. Use the returned `nextCursor` to fetch older events; pass `cursor: null` (or omit) to start from the newest.   Required permissions: `READ_EVENTS`<br> OperationId: `EventControllerExplore`
+   * @summary Explore events (ClickHouse-backed)
+   * @param {EventExploreInputDTO} [eventExploreInputDTO] EventExploreInputDTO
+   * @param {*} [options] Override http request option.
+   * @throws {RequiredError}
+   * @memberof EventApi
+   */
+  public eventControllerExplore(eventExploreInputDTO?: EventExploreInputDTO, options?: RawAxiosRequestConfig) {
+    return EventApiFp(this.configuration)
+      .eventControllerExplore(eventExploreInputDTO, options)
+      .then((request) => request(this.axios, this.basePath));
+  }
+
+  /**
+   * Returns time-bucketed event counts, optionally stacked by event name or game server. Accepts the same filter shape as `/event/explore` so the graph matches the stream. Bucket size adapts to the range. Caches preset-period queries with empty filters/metaFilters.   Required permissions: `READ_EVENTS`<br> OperationId: `EventControllerExploreVolume`
+   * @summary Get event volume time-series with optional grouping
+   * @param {EventVolumeInputDTO} [eventVolumeInputDTO] EventVolumeInputDTO
+   * @param {*} [options] Override http request option.
+   * @throws {RequiredError}
+   * @memberof EventApi
+   */
+  public eventControllerExploreVolume(eventVolumeInputDTO?: EventVolumeInputDTO, options?: RawAxiosRequestConfig) {
+    return EventApiFp(this.configuration)
+      .eventControllerExploreVolume(eventVolumeInputDTO, options)
+      .then((request) => request(this.axios, this.basePath));
+  }
+
   /**
    * Export events matching the search criteria to CSV format. Accepts the same parameters as the search endpoint. Maximum time range is 90 days.   Required permissions: `READ_EVENTS`<br> OperationId: `EventControllerExport`
    * @summary Export events to CSV

package/src/lib/baseClient.ts

@@ -23,11 +23,17 @@ export class BaseApiClient<T extends IBaseApiClientConfig> {
   };
 
   constructor(protected readonly config: T) {
+    // Browsers refuse to let JS set the User-Agent header (it's a "forbidden header").
+    // Only include it when running outside a browser context (Node.js / server-side).
+    // Use globalThis so this compiles under both DOM and non-DOM TypeScript lib targets.
+    const isBrowser =
+      typeof (globalThis as Record<string, unknown>)['window'] !== 'undefined' &&
+      typeof (globalThis as Record<string, unknown>)['document'] !== 'undefined';
     const axiosConfig: AxiosRequestConfig = {
       baseURL: this.config.url,
       headers: {
         'Content-Type': 'application/json',
-        'User-Agent': 'Takaro-API-Client',
+        ...(!isBrowser && { 'User-Agent': 'Takaro-API-Client' }),
       },
       withCredentials: true,
     };