@blizzard-api/client 5.4.0 → 5.4.1

package/dist/index.d.ts

@@ -198,7 +198,7 @@ declare class BlizzardApiClient {
  * @param onTokenRefresh Callback function to handle token refresh. If set to `true`, the client will automatically refresh the token. If set to `false`, the client will not refresh the token. If set to a function, the function will be called with the new token.
  * @returns A new Blizzard API client.
  */
-declare const createBlizzardApiClient: (options: ClientOptions, onTokenRefresh?: ((token: AccessToken) => void) | boolean) => Promise<BlizzardApiClient>;
+export declare const createBlizzardApiClient: (options: ClientOptions, onTokenRefresh?: ((token: AccessToken) => void) | boolean) => Promise<BlizzardApiClient>;
 //#endregion
-export { type AccessToken, type AccessTokenRequestArguments, type ClientOptions, type ValidateAccessTokenArguments, type ValidateAccessTokenResponse, createBlizzardApiClient, createBlizzardApiClient as default };
+export { type AccessToken, type AccessTokenRequestArguments, type ClientOptions, type ValidateAccessTokenArguments, type ValidateAccessTokenResponse, createBlizzardApiClient as default };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["setTimeout"],"sources":["../src/client/utilities.ts","../src/client/client.ts","../src/client/create-client.ts"],"sourcesContent":["import type { ClientOptions } from './types';\n\nconst sleep = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms));\n\nexport interface WithRateLimitRetryOptions {\n  maxAttempts?: number;\n  retryOnRateLimit?: boolean;\n}\n\nconst getRateLimitDelay = (attempt: number, response?: Pick<Response, 'headers'>): number => {\n  const retryAfterHeader = response?.headers.get('Retry-After');\n  if (retryAfterHeader) {\n    const retryAfterSeconds = Math.trunc(Number(retryAfterHeader));\n    if (!Number.isNaN(retryAfterSeconds)) {\n      return retryAfterSeconds * 1000;\n    }\n  }\n\n  // eslint-disable-next-line sonarjs/pseudo-random\n  return Math.min(250 * 2 ** attempt, 5000) + Math.random() * 250;\n};\n\nexport const withRateLimitRetry = async <T>(\n  request: () => Promise<T>,\n  { maxAttempts = 3, retryOnRateLimit = true }: WithRateLimitRetryOptions = {},\n): Promise<T> => {\n  const retryAttempts = Math.max(1, Math.trunc(maxAttempts || 3));\n  let attempt = 0;\n\n  while (true) {\n    try {\n      return await request();\n    } catch (error: unknown) {\n      const response = (error as { response?: Response })?.response;\n      if (!retryOnRateLimit || response?.status !== 429 || attempt >= retryAttempts - 1) {\n        throw error;\n      }\n\n      const delayMs = getRateLimitDelay(attempt, response);\n      attempt += 1;\n      await sleep(delayMs);\n    }\n  }\n};\n\nexport const validateClientOptions = (options: ClientOptions): void => {\n  if (!options.key) {\n    throw new Error(`Client missing 'key' parameter`);\n  }\n  if (!options.secret) {\n    throw new Error(`Client missing 'secret' parameter`);\n  }\n  if (!options.origin) {\n    throw new Error(`Client missing 'origin' parameter`);\n  }\n};\n","import { stringify } from 'node:querystring';\r\nimport { getBlizzardApi } from '@blizzard-api/core';\r\nimport type { Locales, Origins, Resource } from '@blizzard-api/core';\r\nimport ky from 'ky';\r\nimport type {\r\n  AccessToken,\r\n  AccessTokenRequestArguments,\r\n  ClientOptions,\r\n  ValidateAccessTokenArguments,\r\n  ValidateAccessTokenResponse,\r\n} from './types';\r\nimport { validateClientOptions, withRateLimitRetry } from './utilities';\r\n\r\n/**\r\n * A Blizzard API client.\r\n * @classdesc A client to interact with the Blizzard API.\r\n * @example\r\n * const client = new BlizzardApiClient({\r\n *  key: 'client',\r\n *  secret: 'secret',\r\n *  origin: 'eu',\r\n *  locale: 'en_GB',\r\n *  token: 'access'\r\n * });\r\n */\r\nexport class BlizzardApiClient {\r\n  public defaults: {\r\n    key: string;\r\n    locale: Locales;\r\n    maxAttempts: number;\r\n    origin: Origins;\r\n    retryOnRateLimit: boolean;\r\n    secret: string;\r\n    token?: string;\r\n  };\r\n\r\n  private ky;\r\n\r\n  constructor(options: ClientOptions) {\r\n    validateClientOptions(options);\r\n\r\n    const { locale, origin } = getBlizzardApi(options.origin, options.locale);\r\n    this.defaults = {\r\n      key: options.key,\r\n      locale: locale,\r\n      maxAttempts: Math.max(1, options.maxAttempts ?? 3),\r\n      origin: origin,\r\n      retryOnRateLimit: options.retryOnRateLimit ?? true,\r\n      secret: options.secret,\r\n      token: options.token,\r\n    };\r\n    const kyOptions = {\r\n      timeout: 15_000,\r\n      ...options.kyOptions,\r\n    };\r\n    this.ky = ky.create(kyOptions);\r\n  }\r\n\r\n  /**\r\n   * Get an access token.\r\n   * @param options The access token request arguments. See {@link AccessTokenRequestArguments}.\r\n   * @returns The access token. See {@link AccessToken}.\r\n   * @example\r\n   * const response = await client.getAccessToken();\r\n   * const { access_token, token_type, expires_in, sub } = response;\r\n   * console.log(access_token, token_type, expires_in, sub);\r\n   * // => 'access'\r\n   * // => 'bearer'\r\n   * // => 86399\r\n   * // => 'client-id'\r\n   */\r\n  public getAccessToken = async (options?: AccessTokenRequestArguments): Promise<AccessToken> => {\r\n    const { key, secret } = { ...this.defaults, ...options };\r\n    const basicAuth = Buffer.from(`${key}:${secret}`).toString('base64');\r\n\r\n    return withRateLimitRetry(\r\n      async () =>\r\n        this.ky\r\n          .post<AccessToken>(`https://oauth.battle.net/token`, {\r\n            headers: {\r\n              Authorization: `Basic ${basicAuth}`,\r\n              'Content-Type': 'application/json',\r\n            },\r\n            searchParams: {\r\n              grant_type: 'client_credentials',\r\n            },\r\n          })\r\n          .json(),\r\n      {\r\n        maxAttempts: this.defaults.maxAttempts,\r\n        retryOnRateLimit: this.defaults.retryOnRateLimit,\r\n      },\r\n    );\r\n  };\r\n\r\n  /**\r\n   * Get the request configuration.\r\n   * @param resource The resource to fetch. See {@link Resource}.\r\n   * @param options Client options. See {@link ClientOptions}.\r\n   * @returns The request configuration.\r\n   */\r\n  public getRequestConfig<T, Protected extends boolean = false>(\r\n    resource: Resource<T, object, Protected>,\r\n    options?: Partial<ClientOptions>,\r\n  ): {\r\n    headers: Record<string, string> & {\r\n      Authorization: `Bearer ${string}`;\r\n      'Battlenet-Namespace'?: string;\r\n      'Content-Type': 'application/json';\r\n    };\r\n    searchParams: Record<string, unknown> & { locale: ReturnType<typeof getBlizzardApi>['locale'] };\r\n  } {\r\n    const config = { ...this.defaults, ...options };\r\n    if (!config.token) {\r\n      throw new Error('No token has been set for this client.');\r\n    }\r\n\r\n    const endpoint = getBlizzardApi(config.origin, config.locale);\r\n\r\n    const namespace = resource.namespace\r\n      ? { 'Battlenet-Namespace': `${resource.namespace}-${endpoint.origin}` }\r\n      : undefined;\r\n\r\n    // Build a new object with the defined parameters so we never mutate the\r\n    // caller's resource, which may be reused across requests.\r\n    const parameters: Record<string, unknown> = {};\r\n    if (resource.parameters) {\r\n      for (const [key, value] of Object.entries(resource.parameters as Record<string, unknown>)) {\r\n        if (value !== undefined) {\r\n          parameters[key] = value;\r\n        }\r\n      }\r\n    }\r\n\r\n    return {\r\n      headers: {\r\n        ...namespace,\r\n        Authorization: `Bearer ${config.token}`,\r\n        'Content-Type': 'application/json',\r\n      },\r\n      searchParams: {\r\n        ...parameters,\r\n        locale: endpoint.locale,\r\n      },\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Get the request URL.\r\n   * @param resource The resource to fetch. See {@link Resource}.\r\n   * @param options Client options. See {@link ClientOptions}.\r\n   * @returns The request URL.\r\n   */\r\n  public getRequestUrl<T, Protected extends boolean = false>(\r\n    resource: Resource<T, object, Protected>,\r\n    options?: Partial<ClientOptions>,\r\n  ) {\r\n    const config = { ...this.defaults, ...options };\r\n    const endpoint = getBlizzardApi(config.origin, config.locale);\r\n\r\n    const backslashSeparator = resource.path.startsWith('/') ? '' : '/';\r\n\r\n    return `${endpoint.hostname}${backslashSeparator}${resource.path}`;\r\n  }\r\n\r\n  /**\r\n   * Refresh the access token.\r\n   * @param options The access token request arguments. See {@link AccessTokenRequestArguments}.\r\n   * @returns The access token. See {@link AccessToken}.\r\n   * @example\r\n   * const response = await client.refreshAccessToken();\r\n   * const { access_token, token_type, expires_in, sub } = response;\r\n   * console.log(access_token, token_type, expires_in, sub);\r\n   * // => 'access'\r\n   * // => 'bearer'\r\n   * // => 86399\r\n   * // => 'client-id'\r\n   */\r\n  public refreshAccessToken = async (options?: AccessTokenRequestArguments): Promise<AccessToken> => {\r\n    const response = await this.getAccessToken(options);\r\n    this.setAccessToken(response.access_token);\r\n    return response;\r\n  };\r\n\r\n  /**\r\n   * Send a request to the Blizzard API.\r\n   * @param resource The resource to fetch. See {@link Resource}.\r\n   * @param options Client options. See {@link ClientOptions}.\r\n   * @returns The response from the Blizzard API.\r\n   */\r\n  public async sendRequest<T, Protected extends boolean = false>(\r\n    resource: Resource<T, object, Protected>,\r\n    options?: Partial<ClientOptions>,\r\n  ): Promise<T | undefined> {\r\n    const url = new URL(this.getRequestUrl(resource, options));\r\n    const config = this.getRequestConfig(resource, options);\r\n\r\n    for (const [key, value] of Object.entries(config.searchParams)) {\r\n      url.searchParams.set(key, String(value));\r\n    }\r\n\r\n    const response = await withRateLimitRetry(\r\n      async () =>\r\n        this.ky.get<T>(url, {\r\n          ...options?.kyOptions,\r\n          headers: {\r\n            ...config.headers,\r\n            ...options?.kyOptions?.headers,\r\n          },\r\n        }),\r\n      {\r\n        maxAttempts: this.defaults.maxAttempts,\r\n        retryOnRateLimit: this.defaults.retryOnRateLimit,\r\n      },\r\n    );\r\n\r\n    // Some endpoints return a 204 status code with no content,\r\n    // while others return a 200 status code with an empty body.\r\n    // We must check for empty responses before trying to parse JSON, otherwise\r\n    // a valid empty payload can be treated as invalid JSON and crash the client.\r\n    if (response.status === 204 || response.headers.get('Content-Length') === '0') {\r\n      return;\r\n    }\r\n\r\n    const text = await response.text();\r\n    if (!text.trim()) {\r\n      return;\r\n    }\r\n\r\n    return JSON.parse(text) as T;\r\n  }\r\n\r\n  /**\r\n   * Set the access token.\r\n   * @param token The access token.\r\n   */\r\n  public setAccessToken = (token: string): void => {\r\n    this.defaults.token = token;\r\n  };\r\n\r\n  /**\r\n   * Validate an access token.\r\n   * @param options The validate access token arguments. See {@link ValidateAccessTokenArguments}.\r\n   * @returns The response from the Blizzard API. See {@link ValidateAccessTokenResponse}.\r\n   * @example\r\n   * const response = await client.validateAccessToken({ token: 'access' });\r\n   * console.log(response.client_id);\r\n   * // => 'client-id'\r\n   */\r\n  public validateAccessToken = async (options?: ValidateAccessTokenArguments): Promise<ValidateAccessTokenResponse> => {\r\n    const { origin, token } = { ...this.defaults, ...options };\r\n\r\n    if (!token) {\r\n      throw new Error('No token has been set previously or been passed to the validateAccessToken method.');\r\n    }\r\n\r\n    return withRateLimitRetry(\r\n      async () =>\r\n        this.ky\r\n          .post<ValidateAccessTokenResponse>(`https://${origin}.battle.net/oauth/check_token`, {\r\n            body: stringify({ token }),\r\n            headers: {\r\n              'Content-Type': 'application/x-www-form-urlencoded',\r\n            },\r\n          })\r\n          .json(),\r\n      {\r\n        maxAttempts: this.defaults.maxAttempts,\r\n        retryOnRateLimit: this.defaults.retryOnRateLimit,\r\n      },\r\n    );\r\n  };\r\n}\r\n","//We have to explicitly import setTimeout because of https://github.com/electron/electron/issues/21162#issuecomment-554792447\r\nimport { setTimeout } from 'node:timers';\r\nimport { BlizzardApiClient } from './client';\r\nimport type { AccessToken, ClientOptions } from './types';\r\nimport { validateClientOptions } from './utilities';\r\n\r\n/**\r\n * How long before a token's actual expiry it should be refreshed, in milliseconds.\r\n * This buffer avoids using a token that could expire mid-request.\r\n */\r\nconst REFRESH_BUFFER_MS = 60_000;\r\n\r\n/**\r\n * Calculate the delay (in milliseconds) to wait before refreshing a token, based on the\r\n * token's remaining lifetime.\r\n * @param lifetimeInSeconds The token's lifetime in seconds, as returned in the `expires_in`\r\n * field when requesting a new access token.\r\n * @returns The delay in milliseconds before the token should be refreshed.\r\n */\r\nconst getRefreshDelayFromLifetime = (lifetimeInSeconds: number): number => lifetimeInSeconds * 1000 - REFRESH_BUFFER_MS;\r\n\r\n/**\r\n * Calculate the delay (in milliseconds) to wait before refreshing a token, based on the\r\n * token's absolute expiry time.\r\n * @param expiryInSeconds The token's expiry as a Unix timestamp in seconds, as returned in the\r\n * `exp` field when validating an existing access token.\r\n * @returns The delay in milliseconds before the token should be refreshed. May be negative if the\r\n * token is already within its refresh buffer or expired.\r\n */\r\nconst getRefreshDelayFromExpiry = (expiryInSeconds: number): number =>\r\n  expiryInSeconds * 1000 - REFRESH_BUFFER_MS - Date.now();\r\n\r\n/**\r\n * Create a new Blizzard API client.\r\n * @param options Client options, see {@link ClientOptions} & https://develop.battle.net/documentation/guides/getting-started\r\n * @param onTokenRefresh Callback function to handle token refresh. If set to `true`, the client will automatically refresh the token. If set to `false`, the client will not refresh the token. If set to a function, the function will be called with the new token.\r\n * @returns A new Blizzard API client.\r\n */\r\nexport const createBlizzardApiClient = async (\r\n  options: ClientOptions,\r\n  onTokenRefresh: ((token: AccessToken) => void) | boolean = true,\r\n): Promise<BlizzardApiClient> => {\r\n  const { token } = options;\r\n  validateClientOptions(options);\r\n\r\n  const client = new BlizzardApiClient(options);\r\n\r\n  //Schedule a token refresh after the given delay, without keeping the process alive.\r\n  const scheduleRefresh = (delayInMilliseconds: number) => {\r\n    const timeout = setTimeout(() => void refreshToken(), delayInMilliseconds);\r\n    //Unref the timeout so the process can exit while a refresh is pending.\r\n    timeout.unref();\r\n  };\r\n\r\n  const refreshToken = async () => {\r\n    const response = await client.refreshAccessToken();\r\n\r\n    if (typeof onTokenRefresh === 'function') {\r\n      onTokenRefresh(response);\r\n    }\r\n\r\n    scheduleRefresh(getRefreshDelayFromLifetime(response.expires_in));\r\n  };\r\n\r\n  //If tokenRefresh is false, return the client without refreshing the token\r\n  if (!onTokenRefresh) {\r\n    return client;\r\n  }\r\n\r\n  if (token) {\r\n    try {\r\n      //If token is set, validate the token\r\n      const validatedToken = await client.validateAccessToken({ token });\r\n      const refreshDelay = getRefreshDelayFromExpiry(validatedToken.exp);\r\n      //If the token is already within its refresh buffer, refresh it now.\r\n      if (refreshDelay <= 0) {\r\n        await refreshToken();\r\n      } else {\r\n        //Otherwise schedule a refresh for when the token nears expiry.\r\n        scheduleRefresh(refreshDelay);\r\n      }\r\n    } catch {\r\n      //If token is invalid, refresh the token\r\n      await refreshToken();\r\n    }\r\n  } else {\r\n    //If token is not set, refresh the token\r\n    await refreshToken();\r\n  }\r\n\r\n  return client;\r\n};\r\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["setTimeout"],"sources":["../src/client/utilities.ts","../src/client/client.ts","../src/client/create-client.ts"],"sourcesContent":["import type { ClientOptions } from './types';\n\nconst sleep = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms));\n\nexport interface WithRateLimitRetryOptions {\n  maxAttempts?: number;\n  retryOnRateLimit?: boolean;\n}\n\nconst getRateLimitDelay = (attempt: number, response?: Pick<Response, 'headers'>): number => {\n  const retryAfterHeader = response?.headers.get('Retry-After');\n  if (retryAfterHeader) {\n    const retryAfterSeconds = Math.trunc(Number(retryAfterHeader));\n    if (!Number.isNaN(retryAfterSeconds)) {\n      return retryAfterSeconds * 1000;\n    }\n  }\n\n  // eslint-disable-next-line sonarjs/pseudo-random\n  return Math.min(250 * 2 ** attempt, 5000) + Math.random() * 250;\n};\n\nexport const withRateLimitRetry = async <T>(\n  request: () => Promise<T>,\n  { maxAttempts = 3, retryOnRateLimit = true }: WithRateLimitRetryOptions = {},\n): Promise<T> => {\n  const retryAttempts = Math.max(1, Math.trunc(maxAttempts || 3));\n  let attempt = 0;\n\n  while (true) {\n    try {\n      return await request();\n    } catch (error: unknown) {\n      const response = (error as { response?: Response })?.response;\n      if (!retryOnRateLimit || response?.status !== 429 || attempt >= retryAttempts - 1) {\n        throw error;\n      }\n\n      const delayMs = getRateLimitDelay(attempt, response);\n      attempt += 1;\n      await sleep(delayMs);\n    }\n  }\n};\n\nexport const validateClientOptions = (options: ClientOptions): void => {\n  if (!options.key) {\n    throw new Error(`Client missing 'key' parameter`);\n  }\n  if (!options.secret) {\n    throw new Error(`Client missing 'secret' parameter`);\n  }\n  if (!options.origin) {\n    throw new Error(`Client missing 'origin' parameter`);\n  }\n};\n","import { stringify } from 'node:querystring';\nimport { getBlizzardApi } from '@blizzard-api/core';\nimport type { Locales, Origins, Resource } from '@blizzard-api/core';\nimport ky from 'ky';\nimport type {\n  AccessToken,\n  AccessTokenRequestArguments,\n  ClientOptions,\n  ValidateAccessTokenArguments,\n  ValidateAccessTokenResponse,\n} from './types';\nimport { validateClientOptions, withRateLimitRetry } from './utilities';\n\n/**\n * A Blizzard API client.\n * @classdesc A client to interact with the Blizzard API.\n * @example\n * const client = new BlizzardApiClient({\n *  key: 'client',\n *  secret: 'secret',\n *  origin: 'eu',\n *  locale: 'en_GB',\n *  token: 'access'\n * });\n */\nexport class BlizzardApiClient {\n  public defaults: {\n    key: string;\n    locale: Locales;\n    maxAttempts: number;\n    origin: Origins;\n    retryOnRateLimit: boolean;\n    secret: string;\n    token?: string;\n  };\n\n  private ky;\n\n  constructor(options: ClientOptions) {\n    validateClientOptions(options);\n\n    const { locale, origin } = getBlizzardApi(options.origin, options.locale);\n    this.defaults = {\n      key: options.key,\n      locale: locale,\n      maxAttempts: Math.max(1, options.maxAttempts ?? 3),\n      origin: origin,\n      retryOnRateLimit: options.retryOnRateLimit ?? true,\n      secret: options.secret,\n      token: options.token,\n    };\n    const kyOptions = {\n      timeout: 15_000,\n      ...options.kyOptions,\n    };\n    this.ky = ky.create(kyOptions);\n  }\n\n  /**\n   * Get an access token.\n   * @param options The access token request arguments. See {@link AccessTokenRequestArguments}.\n   * @returns The access token. See {@link AccessToken}.\n   * @example\n   * const response = await client.getAccessToken();\n   * const { access_token, token_type, expires_in, sub } = response;\n   * console.log(access_token, token_type, expires_in, sub);\n   * // => 'access'\n   * // => 'bearer'\n   * // => 86399\n   * // => 'client-id'\n   */\n  public getAccessToken = async (options?: AccessTokenRequestArguments): Promise<AccessToken> => {\n    const { key, secret } = { ...this.defaults, ...options };\n    const basicAuth = Buffer.from(`${key}:${secret}`).toString('base64');\n\n    return withRateLimitRetry(\n      async () =>\n        this.ky\n          .post<AccessToken>(`https://oauth.battle.net/token`, {\n            headers: {\n              Authorization: `Basic ${basicAuth}`,\n              'Content-Type': 'application/json',\n            },\n            searchParams: {\n              grant_type: 'client_credentials',\n            },\n          })\n          .json(),\n      {\n        maxAttempts: this.defaults.maxAttempts,\n        retryOnRateLimit: this.defaults.retryOnRateLimit,\n      },\n    );\n  };\n\n  /**\n   * Get the request configuration.\n   * @param resource The resource to fetch. See {@link Resource}.\n   * @param options Client options. See {@link ClientOptions}.\n   * @returns The request configuration.\n   */\n  public getRequestConfig<T, Protected extends boolean = false>(\n    resource: Resource<T, object, Protected>,\n    options?: Partial<ClientOptions>,\n  ): {\n    headers: Record<string, string> & {\n      Authorization: `Bearer ${string}`;\n      'Battlenet-Namespace'?: string;\n      'Content-Type': 'application/json';\n    };\n    searchParams: Record<string, unknown> & { locale: ReturnType<typeof getBlizzardApi>['locale'] };\n  } {\n    const config = { ...this.defaults, ...options };\n    if (!config.token) {\n      throw new Error('No token has been set for this client.');\n    }\n\n    const endpoint = getBlizzardApi(config.origin, config.locale);\n\n    const namespace = resource.namespace\n      ? { 'Battlenet-Namespace': `${resource.namespace}-${endpoint.origin}` }\n      : undefined;\n\n    // Build a new object with the defined parameters so we never mutate the\n    // caller's resource, which may be reused across requests.\n    const parameters: Record<string, unknown> = {};\n    if (resource.parameters) {\n      for (const [key, value] of Object.entries(resource.parameters as Record<string, unknown>)) {\n        if (value !== undefined) {\n          parameters[key] = value;\n        }\n      }\n    }\n\n    return {\n      headers: {\n        ...namespace,\n        Authorization: `Bearer ${config.token}`,\n        'Content-Type': 'application/json',\n      },\n      searchParams: {\n        ...parameters,\n        locale: endpoint.locale,\n      },\n    };\n  }\n\n  /**\n   * Get the request URL.\n   * @param resource The resource to fetch. See {@link Resource}.\n   * @param options Client options. See {@link ClientOptions}.\n   * @returns The request URL.\n   */\n  public getRequestUrl<T, Protected extends boolean = false>(\n    resource: Resource<T, object, Protected>,\n    options?: Partial<ClientOptions>,\n  ) {\n    const config = { ...this.defaults, ...options };\n    const endpoint = getBlizzardApi(config.origin, config.locale);\n\n    const backslashSeparator = resource.path.startsWith('/') ? '' : '/';\n\n    return `${endpoint.hostname}${backslashSeparator}${resource.path}`;\n  }\n\n  /**\n   * Refresh the access token.\n   * @param options The access token request arguments. See {@link AccessTokenRequestArguments}.\n   * @returns The access token. See {@link AccessToken}.\n   * @example\n   * const response = await client.refreshAccessToken();\n   * const { access_token, token_type, expires_in, sub } = response;\n   * console.log(access_token, token_type, expires_in, sub);\n   * // => 'access'\n   * // => 'bearer'\n   * // => 86399\n   * // => 'client-id'\n   */\n  public refreshAccessToken = async (options?: AccessTokenRequestArguments): Promise<AccessToken> => {\n    const response = await this.getAccessToken(options);\n    this.setAccessToken(response.access_token);\n    return response;\n  };\n\n  /**\n   * Send a request to the Blizzard API.\n   * @param resource The resource to fetch. See {@link Resource}.\n   * @param options Client options. See {@link ClientOptions}.\n   * @returns The response from the Blizzard API.\n   */\n  public async sendRequest<T, Protected extends boolean = false>(\n    resource: Resource<T, object, Protected>,\n    options?: Partial<ClientOptions>,\n  ): Promise<T | undefined> {\n    const url = new URL(this.getRequestUrl(resource, options));\n    const config = this.getRequestConfig(resource, options);\n\n    for (const [key, value] of Object.entries(config.searchParams)) {\n      url.searchParams.set(key, String(value));\n    }\n\n    const response = await withRateLimitRetry(\n      async () =>\n        this.ky.get<T>(url, {\n          ...options?.kyOptions,\n          headers: {\n            ...config.headers,\n            ...options?.kyOptions?.headers,\n          },\n        }),\n      {\n        maxAttempts: this.defaults.maxAttempts,\n        retryOnRateLimit: this.defaults.retryOnRateLimit,\n      },\n    );\n\n    // Some endpoints return a 204 status code with no content,\n    // while others return a 200 status code with an empty body.\n    // We must check for empty responses before trying to parse JSON, otherwise\n    // a valid empty payload can be treated as invalid JSON and crash the client.\n    if (response.status === 204 || response.headers.get('Content-Length') === '0') {\n      return;\n    }\n\n    const text = await response.text();\n    if (!text.trim()) {\n      return;\n    }\n\n    return JSON.parse(text) as T;\n  }\n\n  /**\n   * Set the access token.\n   * @param token The access token.\n   */\n  public setAccessToken = (token: string): void => {\n    this.defaults.token = token;\n  };\n\n  /**\n   * Validate an access token.\n   * @param options The validate access token arguments. See {@link ValidateAccessTokenArguments}.\n   * @returns The response from the Blizzard API. See {@link ValidateAccessTokenResponse}.\n   * @example\n   * const response = await client.validateAccessToken({ token: 'access' });\n   * console.log(response.client_id);\n   * // => 'client-id'\n   */\n  public validateAccessToken = async (options?: ValidateAccessTokenArguments): Promise<ValidateAccessTokenResponse> => {\n    const { origin, token } = { ...this.defaults, ...options };\n\n    if (!token) {\n      throw new Error('No token has been set previously or been passed to the validateAccessToken method.');\n    }\n\n    return withRateLimitRetry(\n      async () =>\n        this.ky\n          .post<ValidateAccessTokenResponse>(`https://${origin}.battle.net/oauth/check_token`, {\n            body: stringify({ token }),\n            headers: {\n              'Content-Type': 'application/x-www-form-urlencoded',\n            },\n          })\n          .json(),\n      {\n        maxAttempts: this.defaults.maxAttempts,\n        retryOnRateLimit: this.defaults.retryOnRateLimit,\n      },\n    );\n  };\n}\n","//We have to explicitly import setTimeout because of https://github.com/electron/electron/issues/21162#issuecomment-554792447\nimport { setTimeout } from 'node:timers';\nimport { BlizzardApiClient } from './client';\nimport type { AccessToken, ClientOptions } from './types';\nimport { validateClientOptions } from './utilities';\n\n/**\n * How long before a token's actual expiry it should be refreshed, in milliseconds.\n * This buffer avoids using a token that could expire mid-request.\n */\nconst REFRESH_BUFFER_MS = 60_000;\n\n/**\n * Calculate the delay (in milliseconds) to wait before refreshing a token, based on the\n * token's remaining lifetime.\n * @param lifetimeInSeconds The token's lifetime in seconds, as returned in the `expires_in`\n * field when requesting a new access token.\n * @returns The delay in milliseconds before the token should be refreshed.\n */\nconst getRefreshDelayFromLifetime = (lifetimeInSeconds: number): number => lifetimeInSeconds * 1000 - REFRESH_BUFFER_MS;\n\n/**\n * Calculate the delay (in milliseconds) to wait before refreshing a token, based on the\n * token's absolute expiry time.\n * @param expiryInSeconds The token's expiry as a Unix timestamp in seconds, as returned in the\n * `exp` field when validating an existing access token.\n * @returns The delay in milliseconds before the token should be refreshed. May be negative if the\n * token is already within its refresh buffer or expired.\n */\nconst getRefreshDelayFromExpiry = (expiryInSeconds: number): number =>\n  expiryInSeconds * 1000 - REFRESH_BUFFER_MS - Date.now();\n\n/**\n * Create a new Blizzard API client.\n * @param options Client options, see {@link ClientOptions} & https://develop.battle.net/documentation/guides/getting-started\n * @param onTokenRefresh Callback function to handle token refresh. If set to `true`, the client will automatically refresh the token. If set to `false`, the client will not refresh the token. If set to a function, the function will be called with the new token.\n * @returns A new Blizzard API client.\n */\nexport const createBlizzardApiClient = async (\n  options: ClientOptions,\n  onTokenRefresh: ((token: AccessToken) => void) | boolean = true,\n): Promise<BlizzardApiClient> => {\n  const { token } = options;\n  validateClientOptions(options);\n\n  const client = new BlizzardApiClient(options);\n\n  //Schedule a token refresh after the given delay, without keeping the process alive.\n  const scheduleRefresh = (delayInMilliseconds: number) => {\n    const timeout = setTimeout(() => void refreshToken(), delayInMilliseconds);\n    //Unref the timeout so the process can exit while a refresh is pending.\n    timeout.unref();\n  };\n\n  const refreshToken = async () => {\n    const response = await client.refreshAccessToken();\n\n    if (typeof onTokenRefresh === 'function') {\n      onTokenRefresh(response);\n    }\n\n    scheduleRefresh(getRefreshDelayFromLifetime(response.expires_in));\n  };\n\n  //If tokenRefresh is false, return the client without refreshing the token\n  if (!onTokenRefresh) {\n    return client;\n  }\n\n  if (token) {\n    try {\n      //If token is set, validate the token\n      const validatedToken = await client.validateAccessToken({ token });\n      const refreshDelay = getRefreshDelayFromExpiry(validatedToken.exp);\n      //If the token is already within its refresh buffer, refresh it now.\n      if (refreshDelay <= 0) {\n        await refreshToken();\n      } else {\n        //Otherwise schedule a refresh for when the token nears expiry.\n        scheduleRefresh(refreshDelay);\n      }\n    } catch {\n      //If token is invalid, refresh the token\n      await refreshToken();\n    }\n  } else {\n    //If token is not set, refresh the token\n    await refreshToken();\n  }\n\n  return client;\n};\n"],"mappings":";;;;;AAEA,MAAM,SAAS,OAA8B,IAAI,SAAS,YAAY,WAAW,SAAS,EAAE,CAAC;AAO7F,MAAM,qBAAqB,SAAiB,aAAiD;CAC3F,MAAM,mBAAmB,UAAU,QAAQ,IAAI,aAAa;CAC5D,IAAI,kBAAkB;EACpB,MAAM,oBAAoB,KAAK,MAAM,OAAO,gBAAgB,CAAC;EAC7D,IAAI,CAAC,OAAO,MAAM,iBAAiB,GACjC,OAAO,oBAAoB;CAE/B;CAGA,OAAO,KAAK,IAAI,MAAM,KAAK,SAAS,GAAI,IAAI,KAAK,OAAO,IAAI;AAC9D;AAEA,MAAa,qBAAqB,OAChC,SACA,EAAE,cAAc,GAAG,mBAAmB,SAAoC,CAAC,MAC5D;CACf,MAAM,gBAAgB,KAAK,IAAI,GAAG,KAAK,MAAM,eAAe,CAAC,CAAC;CAC9D,IAAI,UAAU;CAEd,OAAO,MACL,IAAI;EACF,OAAO,MAAM,QAAQ;CACvB,SAAS,OAAgB;EACvB,MAAM,WAAY,OAAmC;EACrD,IAAI,CAAC,oBAAoB,UAAU,WAAW,OAAO,WAAW,gBAAgB,GAC9E,MAAM;EAGR,MAAM,UAAU,kBAAkB,SAAS,QAAQ;EACnD,WAAW;EACX,MAAM,MAAM,OAAO;CACrB;AAEJ;AAEA,MAAa,yBAAyB,YAAiC;CACrE,IAAI,CAAC,QAAQ,KACX,MAAM,IAAI,MAAM,gCAAgC;CAElD,IAAI,CAAC,QAAQ,QACX,MAAM,IAAI,MAAM,mCAAmC;CAErD,IAAI,CAAC,QAAQ,QACX,MAAM,IAAI,MAAM,mCAAmC;AAEvD;;;;;;;;;;;;;;;AC9BA,IAAa,oBAAb,MAA+B;CAC7B;CAUA;CAEA,YAAY,SAAwB;EAClC,sBAAsB,OAAO;EAE7B,MAAM,EAAE,QAAQ,WAAW,eAAe,QAAQ,QAAQ,QAAQ,MAAM;EACxE,KAAK,WAAW;GACd,KAAK,QAAQ;GACL;GACR,aAAa,KAAK,IAAI,GAAG,QAAQ,eAAe,CAAC;GACzC;GACR,kBAAkB,QAAQ,oBAAoB;GAC9C,QAAQ,QAAQ;GAChB,OAAO,QAAQ;EACjB;EACA,MAAM,YAAY;GAChB,SAAS;GACT,GAAG,QAAQ;EACb;EACA,KAAK,KAAK,GAAG,OAAO,SAAS;CAC/B;;;;;;;;;;;;;;CAeA,iBAAwB,OAAO,YAAgE;EAC7F,MAAM,EAAE,KAAK,WAAW;GAAE,GAAG,KAAK;GAAU,GAAG;EAAQ;EACvD,MAAM,YAAY,OAAO,KAAK,GAAG,IAAI,GAAG,QAAQ,CAAC,CAAC,SAAS,QAAQ;EAEnE,OAAO,mBACL,YACE,KAAK,GACF,KAAkB,kCAAkC;GACnD,SAAS;IACP,eAAe,SAAS;IACxB,gBAAgB;GAClB;GACA,cAAc,EACZ,YAAY,qBACd;EACF,CAAC,CAAC,CACD,KAAK,GACV;GACE,aAAa,KAAK,SAAS;GAC3B,kBAAkB,KAAK,SAAS;EAClC,CACF;CACF;;;;;;;CAQA,iBACE,UACA,SAQA;EACA,MAAM,SAAS;GAAE,GAAG,KAAK;GAAU,GAAG;EAAQ;EAC9C,IAAI,CAAC,OAAO,OACV,MAAM,IAAI,MAAM,wCAAwC;EAG1D,MAAM,WAAW,eAAe,OAAO,QAAQ,OAAO,MAAM;EAE5D,MAAM,YAAY,SAAS,YACvB,EAAE,uBAAuB,GAAG,SAAS,UAAU,GAAG,SAAS,SAAS,IACpE,KAAA;EAIJ,MAAM,aAAsC,CAAC;EAC7C,IAAI,SAAS,YACN;QAAA,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,UAAqC,GACtF,IAAI,UAAU,KAAA,GACZ,WAAW,OAAO;EAAA;EAKxB,OAAO;GACL,SAAS;IACP,GAAG;IACH,eAAe,UAAU,OAAO;IAChC,gBAAgB;GAClB;GACA,cAAc;IACZ,GAAG;IACH,QAAQ,SAAS;GACnB;EACF;CACF;;;;;;;CAQA,cACE,UACA,SACA;EACA,MAAM,SAAS;GAAE,GAAG,KAAK;GAAU,GAAG;EAAQ;EAC9C,MAAM,WAAW,eAAe,OAAO,QAAQ,OAAO,MAAM;EAE5D,MAAM,qBAAqB,SAAS,KAAK,WAAW,GAAG,IAAI,KAAK;EAEhE,OAAO,GAAG,SAAS,WAAW,qBAAqB,SAAS;CAC9D;;;;;;;;;;;;;;CAeA,qBAA4B,OAAO,YAAgE;EACjG,MAAM,WAAW,MAAM,KAAK,eAAe,OAAO;EAClD,KAAK,eAAe,SAAS,YAAY;EACzC,OAAO;CACT;;;;;;;CAQA,MAAa,YACX,UACA,SACwB;EACxB,MAAM,MAAM,IAAI,IAAI,KAAK,cAAc,UAAU,OAAO,CAAC;EACzD,MAAM,SAAS,KAAK,iBAAiB,UAAU,OAAO;EAEtD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,YAAY,GAC3D,IAAI,aAAa,IAAI,KAAK,OAAO,KAAK,CAAC;EAGzC,MAAM,WAAW,MAAM,mBACrB,YACE,KAAK,GAAG,IAAO,KAAK;GAClB,GAAG,SAAS;GACZ,SAAS;IACP,GAAG,OAAO;IACV,GAAG,SAAS,WAAW;GACzB;EACF,CAAC,GACH;GACE,aAAa,KAAK,SAAS;GAC3B,kBAAkB,KAAK,SAAS;EAClC,CACF;EAMA,IAAI,SAAS,WAAW,OAAO,SAAS,QAAQ,IAAI,gBAAgB,MAAM,KACxE;EAGF,MAAM,OAAO,MAAM,SAAS,KAAK;EACjC,IAAI,CAAC,KAAK,KAAK,GACb;EAGF,OAAO,KAAK,MAAM,IAAI;CACxB;;;;;CAMA,kBAAyB,UAAwB;EAC/C,KAAK,SAAS,QAAQ;CACxB;;;;;;;;;;CAWA,sBAA6B,OAAO,YAAiF;EACnH,MAAM,EAAE,QAAQ,UAAU;GAAE,GAAG,KAAK;GAAU,GAAG;EAAQ;EAEzD,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,oFAAoF;EAGtG,OAAO,mBACL,YACE,KAAK,GACF,KAAkC,WAAW,OAAO,gCAAgC;GACnF,MAAM,UAAU,EAAE,MAAM,CAAC;GACzB,SAAS,EACP,gBAAgB,oCAClB;EACF,CAAC,CAAC,CACD,KAAK,GACV;GACE,aAAa,KAAK,SAAS;GAC3B,kBAAkB,KAAK,SAAS;EAClC,CACF;CACF;AACF;;;;;;;ACtQA,MAAM,oBAAoB;;;;;;;;AAS1B,MAAM,+BAA+B,sBAAsC,oBAAoB,MAAO;;;;;;;;;AAUtG,MAAM,6BAA6B,oBACjC,kBAAkB,MAAO,oBAAoB,KAAK,IAAI;;;;;;;AAQxD,MAAa,0BAA0B,OACrC,SACA,iBAA2D,SAC5B;CAC/B,MAAM,EAAE,UAAU;CAClB,sBAAsB,OAAO;CAE7B,MAAM,SAAS,IAAI,kBAAkB,OAAO;CAG5C,MAAM,mBAAmB,wBAAgC;EAGvD,mBAFiC,KAAK,aAAa,GAAG,mBAEhD,CAAC,CAAC,MAAM;CAChB;CAEA,MAAM,eAAe,YAAY;EAC/B,MAAM,WAAW,MAAM,OAAO,mBAAmB;EAEjD,IAAI,OAAO,mBAAmB,YAC5B,eAAe,QAAQ;EAGzB,gBAAgB,4BAA4B,SAAS,UAAU,CAAC;CAClE;CAGA,IAAI,CAAC,gBACH,OAAO;CAGT,IAAI,OACF,IAAI;EAEF,MAAM,iBAAiB,MAAM,OAAO,oBAAoB,EAAE,MAAM,CAAC;EACjE,MAAM,eAAe,0BAA0B,eAAe,GAAG;EAEjE,IAAI,gBAAgB,GAClB,MAAM,aAAa;OAGnB,gBAAgB,YAAY;CAEhC,QAAQ;EAEN,MAAM,aAAa;CACrB;MAGA,MAAM,aAAa;CAGrB,OAAO;AACT"}

package/package.json

@@ -1,18 +1,37 @@
 {
   "name": "@blizzard-api/client",
-  "version": "5.4.0",
+  "version": "5.4.1",
+  "description": "A node.js client to integrate with the blizzard battle.net api.",
+  "keywords": [
+    "api",
+    "battle.net",
+    "battlenet",
+    "blizzard",
+    "bnet",
+    "classic",
+    "d3",
+    "diablo",
+    "hearthstone",
+    "hs",
+    "retail",
+    "sc2",
+    "starcraft",
+    "warcraft",
+    "world of warcraft",
+    "wow"
+  ],
   "license": "MIT",
   "author": "Putro",
-  "description": "A node.js client to integrate with the blizzard battle.net api.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Pewtro/blizzard-api.git",
     "directory": "packages/client"
   },
+  "files": [
+    "dist"
+  ],
   "type": "module",
-  "engines": {
-    "node": "^22.13.0 || ^24 || ^26"
-  },
+  "sideEffects": false,
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -22,41 +41,22 @@
       "default": "./dist/index.js"
     }
   },
-  "files": [
-    "dist"
-  ],
-  "sideEffects": false,
-  "keywords": [
-    "blizzard",
-    "battlenet",
-    "battle.net",
-    "bnet",
-    "api",
-    "world of warcraft",
-    "warcraft",
-    "wow",
-    "classic",
-    "retail",
-    "starcraft",
-    "sc2",
-    "diablo",
-    "d3",
-    "hs",
-    "hearthstone"
-  ],
   "dependencies": {
     "ky": "2.1.0"
   },
+  "devDependencies": {
+    "@blizzard-api/classic-wow": "4.1.3",
+    "@blizzard-api/core": "4.1.3",
+    "@blizzard-api/d3": "3.1.2",
+    "@blizzard-api/hs": "3.2.0",
+    "@blizzard-api/sc2": "3.1.3",
+    "@blizzard-api/wow": "4.1.2"
+  },
   "peerDependencies": {
-    "@blizzard-api/core": "4.1.2"
+    "@blizzard-api/core": "4.1.3"
   },
-  "devDependencies": {
-    "@blizzard-api/core": "4.1.2",
-    "@blizzard-api/hs": "3.1.2",
-    "@blizzard-api/sc2": "3.1.2",
-    "@blizzard-api/d3": "3.1.1",
-    "@blizzard-api/classic-wow": "4.1.1",
-    "@blizzard-api/wow": "4.1.0"
+  "engines": {
+    "node": "^22.13.0 || ^24 || ^26"
   },
   "scripts": {
     "build": "tsdown",