@ensnode/ensrainbow-sdk 1.5.1 → 1.7.0

package/dist/client.d.ts

@@ -1,15 +1,26 @@
-import { EnsRainbowClientLabelSet, LabelHash, Label, EnsRainbowServerLabelSet } from '@ensnode/ensnode-sdk';
+import { EnsRainbowClientLabelSet, LabelHash, EncodedLabelHash, Label, EnsRainbowServerLabelSet, EnsRainbowPublicConfig } from '@ensnode/ensnode-sdk';
 
 declare namespace EnsRainbow {
     export type ApiClientOptions = EnsRainbowApiClientOptions;
     export interface ApiClient {
         count(): Promise<CountResponse>;
         /**
-         * Heal a labelhash to its original label
-         * @param labelHash The labelhash to heal
+         * Get the public configuration of the ENSRainbow service
          */
-        heal(labelHash: LabelHash): Promise<HealResponse>;
+        config(): Promise<ENSRainbowPublicConfig>;
+        /**
+         * Heal a labelHash to its original label.
+         * Accepts a strict `LabelHash`, an `EncodedLabelHash` (bracket-enclosed), or any string
+         * that can be normalized (missing `0x` prefix, uppercase hex chars, or 63-char hex).
+         * Returns a `HealBadRequestError` if the input cannot be normalized to a valid labelHash.
+         */
+        heal(labelHash: LabelHash | EncodedLabelHash | string): Promise<HealResponse>;
         health(): Promise<HealthResponse>;
+        /**
+         * Get the version information of the ENSRainbow service
+         *
+         * @deprecated Use {@link ApiClient.config} instead. This method will be removed in a future version.
+         */
         version(): Promise<VersionResponse>;
         getOptions(): Readonly<EnsRainbowApiClientOptions>;
     }
@@ -80,6 +91,8 @@ declare namespace EnsRainbow {
     export type CountResponse = CountSuccess | CountServerError;
     /**
      * ENSRainbow version information.
+     *
+     * @deprecated Use {@link ENSRainbowPublicConfig} instead. This type will be removed in a future version.
      */
     export interface VersionInfo {
         /**
@@ -97,11 +110,20 @@ declare namespace EnsRainbow {
     }
     /**
      * Interface for the version endpoint response
+     *
+     * @deprecated Use {@link ENSRainbowPublicConfig} instead. This type will be removed in a future version.
      */
     export interface VersionResponse {
         status: typeof StatusCode.Success;
         versionInfo: VersionInfo;
     }
+    /**
+     * Complete public configuration object for ENSRainbow.
+     *
+     * Contains all public configuration information about the ENSRainbow service instance,
+     * including version, label set information, and record counts.
+     */
+    export type ENSRainbowPublicConfig = EnsRainbowPublicConfig;
     export {  };
 }
 interface EnsRainbowApiClientOptions {
@@ -167,8 +189,11 @@ declare class EnsRainbowApiClient implements EnsRainbow.ApiClient {
      * - Labels can contain any valid string, including dots, null bytes, or be empty
      * - Clients should handle all possible string values appropriately
      *
-     * @param labelHash all lowercase 64-digit hex string with 0x prefix (total length of 66 characters)
-     * @returns a `HealResponse` indicating the result of the request and the healed label if successful
+     * @param labelHash - A labelHash to heal, either as a strict `LabelHash`, an `EncodedLabelHash`
+     * (bracket-enclosed), or any string that can be normalized (missing `0x` prefix, uppercase hex
+     * chars, or 63-char hex are all accepted and normalized automatically).
+     * @returns a `HealResponse` indicating the result of the request and the healed label if successful.
+     * Returns a `HealBadRequestError` if the input cannot be normalized to a valid labelHash.
      * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,
      * CORS violations, or Invalid URLs
      * @example
@@ -199,7 +224,7 @@ declare class EnsRainbowApiClient implements EnsRainbow.ApiClient {
      * // }
      * ```
      */
-    heal(labelHash: LabelHash): Promise<EnsRainbow.HealResponse>;
+    heal(labelHash: LabelHash | EncodedLabelHash | string): Promise<EnsRainbow.HealResponse>;
     /**
      * Get Count of Healable Labels
      *
@@ -237,9 +262,14 @@ declare class EnsRainbowApiClient implements EnsRainbow.ApiClient {
      * // }
      */
     health(): Promise<EnsRainbow.HealthResponse>;
+    /**
+     * Get the public configuration of the ENSRainbow service.
+     */
+    config(): Promise<EnsRainbow.ENSRainbowPublicConfig>;
     /**
      * Get the version information of the ENSRainbow service
      *
+     * @deprecated Use {@link EnsRainbowApiClient.config} instead. This method will be removed in a future version.
      * @returns the version information of the ENSRainbow service
      * @throws if the request fails due to network failures, DNS lookup failures, request
      * timeouts, CORS violations, or invalid URLs

package/dist/client.js

@@ -1,7 +1,8 @@
 // src/client.ts
 import {
   buildEnsRainbowClientLabelSet,
-  LruCache
+  LruCache,
+  parseLabelHashOrEncodedLabelHash
 } from "@ensnode/ensnode-sdk";
 
 // src/consts.ts
@@ -70,8 +71,11 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
    * - Labels can contain any valid string, including dots, null bytes, or be empty
    * - Clients should handle all possible string values appropriately
    *
-   * @param labelHash all lowercase 64-digit hex string with 0x prefix (total length of 66 characters)
-   * @returns a `HealResponse` indicating the result of the request and the healed label if successful
+   * @param labelHash - A labelHash to heal, either as a strict `LabelHash`, an `EncodedLabelHash`
+   * (bracket-enclosed), or any string that can be normalized (missing `0x` prefix, uppercase hex
+   * chars, or 63-char hex are all accepted and normalized automatically).
+   * @returns a `HealResponse` indicating the result of the request and the healed label if successful.
+   * Returns a `HealBadRequestError` if the input cannot be normalized to a valid labelHash.
    * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,
    * CORS violations, or Invalid URLs
    * @example
@@ -103,16 +107,26 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
    * ```
    */
   async heal(labelHash) {
-    const cachedResult = this.cache.get(labelHash);
+    let normalizedLabelHash;
+    try {
+      normalizedLabelHash = parseLabelHashOrEncodedLabelHash(labelHash);
+    } catch (error) {
+      return {
+        status: StatusCode.Error,
+        error: error instanceof Error ? error.message : String(error),
+        errorCode: ErrorCode.BadRequest
+      };
+    }
+    const cachedResult = this.cache.get(normalizedLabelHash);
     if (cachedResult) return cachedResult;
-    const url = new URL(`/v1/heal/${labelHash}`, this.options.endpointUrl);
+    const url = new URL(`/v1/heal/${normalizedLabelHash}`, this.options.endpointUrl);
     this.labelSetSearchParams.forEach((value, key) => {
       url.searchParams.append(key, value);
     });
     const response = await fetch(url);
     const healResponse = await response.json();
     if (isCacheableHealResponse(healResponse)) {
-      this.cache.set(labelHash, healResponse);
+      this.cache.set(normalizedLabelHash, healResponse);
     }
     return healResponse;
   }
@@ -159,9 +173,20 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
     const response = await fetch(new URL("/health", this.options.endpointUrl));
     return response.json();
   }
+  /**
+   * Get the public configuration of the ENSRainbow service.
+   */
+  async config() {
+    const response = await fetch(new URL("/v1/config", this.options.endpointUrl));
+    if (!response.ok) {
+      throw new Error(`Failed to fetch ENSRainbow config: ${response.statusText}`);
+    }
+    return response.json();
+  }
   /**
    * Get the version information of the ENSRainbow service
    *
+   * @deprecated Use {@link EnsRainbowApiClient.config} instead. This method will be removed in a future version.
    * @returns the version information of the ENSRainbow service
    * @throws if the request fails due to network failures, DNS lookup failures, request
    * timeouts, CORS violations, or invalid URLs

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/consts.ts"],"sourcesContent":["import {\n  buildEnsRainbowClientLabelSet,\n  type Cache,\n  type EnsRainbowClientLabelSet,\n  type EnsRainbowServerLabelSet,\n  type Label,\n  type LabelHash,\n  LruCache,\n} from \"@ensnode/ensnode-sdk\";\n\nimport { DEFAULT_ENSRAINBOW_URL, ErrorCode, StatusCode } from \"./consts\";\n\nexport namespace EnsRainbow {\n  export type ApiClientOptions = EnsRainbowApiClientOptions;\n\n  export interface ApiClient {\n    count(): Promise<CountResponse>;\n\n    /**\n     * Heal a labelhash to its original label\n     * @param labelHash The labelhash to heal\n     */\n    heal(labelHash: LabelHash): Promise<HealResponse>;\n\n    health(): Promise<HealthResponse>;\n\n    version(): Promise<VersionResponse>;\n\n    getOptions(): Readonly<EnsRainbowApiClientOptions>;\n  }\n\n  type StatusCode = (typeof StatusCode)[keyof typeof StatusCode];\n\n  type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n\n  export interface HealthResponse {\n    status: \"ok\";\n  }\n\n  export interface BaseHealResponse<Status extends StatusCode, Error extends ErrorCode> {\n    status: Status;\n    label?: Label | never;\n    error?: string | never;\n    errorCode?: Error | never;\n  }\n\n  export interface HealSuccess extends BaseHealResponse<typeof StatusCode.Success, never> {\n    status: typeof StatusCode.Success;\n    label: Label;\n    error?: never;\n    errorCode?: never;\n  }\n\n  export interface HealNotFoundError\n    extends BaseHealResponse<typeof StatusCode.Error, typeof ErrorCode.NotFound> {\n    status: typeof StatusCode.Error;\n    label?: never;\n    error: string;\n    errorCode: typeof ErrorCode.NotFound;\n  }\n\n  export interface HealServerError\n    extends BaseHealResponse<typeof StatusCode.Error, typeof ErrorCode.ServerError> {\n    status: typeof StatusCode.Error;\n    label?: never;\n    error: string;\n    errorCode: typeof ErrorCode.ServerError;\n  }\n\n  export interface HealBadRequestError\n    extends BaseHealResponse<typeof StatusCode.Error, typeof ErrorCode.BadRequest> {\n    status: typeof StatusCode.Error;\n    label?: never;\n    error: string;\n    errorCode: typeof ErrorCode.BadRequest;\n  }\n\n  export type HealResponse =\n    | HealSuccess\n    | HealNotFoundError\n    | HealServerError\n    | HealBadRequestError;\n  export type HealError = Exclude<HealResponse, HealSuccess>;\n\n  /**\n   * Server errors should not be cached.\n   */\n  export type CacheableHealResponse = Exclude<HealResponse, HealServerError>;\n\n  export interface BaseCountResponse<Status extends StatusCode, Error extends ErrorCode> {\n    status: Status;\n    count?: number | never;\n    timestamp?: string | never;\n    error?: string | never;\n    errorCode?: Error | never;\n  }\n\n  export interface CountSuccess extends BaseCountResponse<typeof StatusCode.Success, never> {\n    status: typeof StatusCode.Success;\n    /** The total count of labels that can be healed by the ENSRainbow instance. Always a\n     * non-negative integer. */\n    count: number;\n    timestamp: string;\n    error?: never;\n    errorCode?: never;\n  }\n\n  export interface CountServerError\n    extends BaseCountResponse<typeof StatusCode.Error, typeof ErrorCode.ServerError> {\n    status: typeof StatusCode.Error;\n    count?: never;\n    timestamp?: never;\n    error: string;\n    errorCode: typeof ErrorCode.ServerError;\n  }\n\n  export type CountResponse = CountSuccess | CountServerError;\n\n  /**\n   * ENSRainbow version information.\n   */\n  export interface VersionInfo {\n    /**\n     * ENSRainbow version.\n     */\n    version: string;\n\n    /**\n     * ENSRainbow database schema version.\n     */\n    dbSchemaVersion: number;\n\n    /**\n     * The EnsRainbowServerLabelSet managed by the ENSRainbow server.\n     */\n    labelSet: EnsRainbowServerLabelSet;\n  }\n\n  /**\n   * Interface for the version endpoint response\n   */\n  export interface VersionResponse {\n    status: typeof StatusCode.Success;\n    versionInfo: VersionInfo;\n  }\n}\n\nexport interface EnsRainbowApiClientOptions {\n  /**\n   * The maximum number of `HealResponse` values to cache.\n   * Must be a non-negative integer.\n   * Setting to 0 will disable caching.\n   */\n  cacheCapacity: number;\n\n  /**\n   * The URL of an ENSRainbow API endpoint.\n   */\n  endpointUrl: URL;\n\n  /**\n   * Optional label set preferences that the ENSRainbow server at endpointUrl is expected to\n   * support. If provided, enables deterministic heal results across time, such that only\n   * labels from label sets with versions less than or equal to this value will be returned.\n   * Therefore, even if the ENSRainbow server later ingests label sets with greater versions\n   * than this value, the results returned across time can be deterministic. If\n   * provided, heal operations with this EnsRainbowApiClient will validate the ENSRainbow\n   * server manages a compatible label set. If not provided no specific labelSetId validation\n   * will be performed during heal operations.\n   * If `labelSetId` is provided without `labelSetVersion`, the server will use the latest\n   * available version.\n   * If `labelSetVersion` is defined, only labels from sets less than or equal to this value\n   * will be returned.\n   * When `labelSetVersion` is defined, `labelSetId` must also be defined.\n   */\n  labelSet?: EnsRainbowClientLabelSet;\n}\n\n/**\n * ENSRainbow API client\n *\n * @example\n * ```typescript\n * // default options\n * const client = new EnsRainbowApiClient();\n * // custom options\n * const client = new EnsRainbowApiClient({\n *  endpointUrl: new URL(\"https://api.ensrainbow.io\"),\n * });\n * ```\n */\nexport class EnsRainbowApiClient implements EnsRainbow.ApiClient {\n  private readonly options: EnsRainbowApiClientOptions;\n  private readonly cache: Cache<LabelHash, EnsRainbow.CacheableHealResponse>;\n  private readonly labelSetSearchParams: URLSearchParams;\n\n  public static readonly DEFAULT_CACHE_CAPACITY = 1000;\n\n  /**\n   * Create default client options.\n   *\n   * @returns default options\n   */\n  static defaultOptions(): EnsRainbow.ApiClientOptions {\n    return {\n      endpointUrl: new URL(DEFAULT_ENSRAINBOW_URL),\n      cacheCapacity: EnsRainbowApiClient.DEFAULT_CACHE_CAPACITY,\n      labelSet: buildEnsRainbowClientLabelSet(),\n    };\n  }\n\n  constructor(options: Partial<EnsRainbow.ApiClientOptions> = {}) {\n    const { labelSet: optionsLabelSet, ...rest } = options;\n    const defaultOptions = EnsRainbowApiClient.defaultOptions();\n\n    const copiedLabelSet = buildEnsRainbowClientLabelSet(\n      optionsLabelSet?.labelSetId,\n      optionsLabelSet?.labelSetVersion,\n    );\n\n    this.options = {\n      ...defaultOptions,\n      ...rest,\n      labelSet: copiedLabelSet,\n    };\n\n    this.cache = new LruCache<LabelHash, EnsRainbow.CacheableHealResponse>(\n      this.options.cacheCapacity,\n    );\n\n    // Pre-compute query parameters for label set options\n    this.labelSetSearchParams = new URLSearchParams();\n    if (this.options.labelSet?.labelSetId !== undefined) {\n      this.labelSetSearchParams.append(\"label_set_id\", this.options.labelSet.labelSetId);\n    }\n    if (this.options.labelSet?.labelSetVersion !== undefined) {\n      this.labelSetSearchParams.append(\n        \"label_set_version\",\n        this.options.labelSet.labelSetVersion.toString(),\n      );\n    }\n  }\n\n  /**\n   * Attempt to [heal](https://ensnode.io/ensrainbow/concepts/glossary#heal) a labelHash to its original label.\n   *\n   * Note on returned labels: ENSRainbow returns labels exactly as they are\n   * represented in source rainbow table data. This means:\n   *\n   * - Labels may or may not be ENS-normalized\n   * - Labels can contain any valid string, including dots, null bytes, or be empty\n   * - Clients should handle all possible string values appropriately\n   *\n   * @param labelHash all lowercase 64-digit hex string with 0x prefix (total length of 66 characters)\n   * @returns a `HealResponse` indicating the result of the request and the healed label if successful\n   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,\n   * CORS violations, or Invalid URLs\n   * @example\n   * ```typescript\n   * const response = await client.heal(\n   *   \"0xaf2caa1c2ca1d027f1ac823b529d0a67cd144264b2789fa2ea4d63a67c7103cc\"\n   * );\n   *\n   * console.log(response);\n   *\n   * // Output:\n   * // {\n   * //   status: \"success\",\n   * //   label: \"vitalik\"\n   * // }\n   *\n   * const notFoundResponse = await client.heal(\n   *   \"0xf64dc17ae2e2b9b16dbcb8cb05f35a2e6080a5ff1dc53ac0bc48f0e79111f264\"\n   * );\n   *\n   * console.log(notFoundResponse);\n   *\n   * // Output:\n   * // {\n   * //   status: \"error\",\n   * //   error: \"Label not found\",\n   * //   errorCode: 404\n   * // }\n   * ```\n   */\n  async heal(labelHash: LabelHash): Promise<EnsRainbow.HealResponse> {\n    const cachedResult = this.cache.get(labelHash);\n    if (cachedResult) return cachedResult;\n\n    const url = new URL(`/v1/heal/${labelHash}`, this.options.endpointUrl);\n\n    // Apply pre-computed label set query parameters\n    this.labelSetSearchParams.forEach((value, key) => {\n      url.searchParams.append(key, value);\n    });\n\n    const response = await fetch(url);\n    const healResponse = (await response.json()) as EnsRainbow.HealResponse;\n\n    if (isCacheableHealResponse(healResponse)) {\n      this.cache.set(labelHash, healResponse);\n    }\n\n    return healResponse;\n  }\n\n  /**\n   * Get Count of Healable Labels\n   *\n   * @returns a `CountResponse` indicating the result and the timestamp of the request and the\n   * number of healable labels if successful\n   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,\n   * CORS violations, or Invalid URLs\n   * @example\n   *\n   * const response = await client.count();\n   *\n   * console.log(response);\n   *\n   * // {\n   * //   \"status\": \"success\",\n   * //   \"count\": 133856894,\n   * //   \"timestamp\": \"2024-01-30T11:18:56Z\"\n   * // }\n   *\n   */\n  async count(): Promise<EnsRainbow.CountResponse> {\n    const response = await fetch(new URL(\"/v1/labels/count\", this.options.endpointUrl));\n\n    return response.json() as Promise<EnsRainbow.CountResponse>;\n  }\n\n  /**\n   *\n   * Simple verification that the service is running, either in your local setup or for the\n   * provided hosted instance.\n   * @returns a status of ENS Rainbow service\n   * @example\n   *\n   * const response = await client.health();\n   *\n   * console.log(response);\n   *\n   * // {\n   * //   \"status\": \"ok\",\n   * // }\n   */\n  async health(): Promise<EnsRainbow.HealthResponse> {\n    const response = await fetch(new URL(\"/health\", this.options.endpointUrl));\n\n    return response.json() as Promise<EnsRainbow.HealthResponse>;\n  }\n\n  /**\n   * Get the version information of the ENSRainbow service\n   *\n   * @returns the version information of the ENSRainbow service\n   * @throws if the request fails due to network failures, DNS lookup failures, request\n   * timeouts, CORS violations, or invalid URLs\n   * @example\n   * ```typescript\n   * const response = await client.version();\n   *\n   * console.log(response);\n   *\n   * // {\n   * //   \"status\": \"success\",\n   * //   \"versionInfo\": {\n   * //     \"version\": \"0.1.0\",\n   * //     \"dbSchemaVersion\": 2,\n   * //     \"labelSet\": {\n   * //       \"labelSetId\": \"subgraph\",\n   * //       \"labelSetVersion\": 0\n   * //     }\n   * //   }\n   * // }\n   * ```\n   */\n  async version(): Promise<EnsRainbow.VersionResponse> {\n    const response = await fetch(new URL(\"/v1/version\", this.options.endpointUrl));\n\n    return response.json() as Promise<EnsRainbow.VersionResponse>;\n  }\n\n  /**\n   * Get a copy of the current client options.\n   *\n   * @returns a copy of the current client options.\n   */\n  getOptions(): Readonly<EnsRainbowApiClientOptions> {\n    // build a deep copy to prevent modification\n    const deepCopy = {\n      cacheCapacity: this.options.cacheCapacity,\n      endpointUrl: new URL(this.options.endpointUrl.href),\n      labelSet: this.options.labelSet ? { ...this.options.labelSet } : undefined,\n    } satisfies EnsRainbowApiClientOptions;\n\n    return Object.freeze(deepCopy);\n  }\n}\n\n/**\n * Determine if a heal response is an error.\n *\n * @param response the heal response to check\n * @returns true if the response is an error, false otherwise\n */\nexport const isHealError = (\n  response: EnsRainbow.HealResponse,\n): response is EnsRainbow.HealError => {\n  return response.status === StatusCode.Error;\n};\n\n/**\n * Determine if a heal response is cacheable.\n *\n * Server errors at not cachable and should be retried.\n *\n * @param response the heal response to check\n * @returns true if the response is cacheable, false otherwise\n */\nexport const isCacheableHealResponse = (\n  response: EnsRainbow.HealResponse,\n): response is EnsRainbow.CacheableHealResponse => {\n  return response.status === StatusCode.Success || response.errorCode !== ErrorCode.ServerError;\n};\n","export const DEFAULT_ENSRAINBOW_URL = \"https://api.ensrainbow.io\" as const;\n\nexport const StatusCode = {\n  Success: \"success\",\n  Error: \"error\",\n} as const;\n\nexport const ErrorCode = {\n  BadRequest: 400,\n  NotFound: 404,\n  ServerError: 500,\n} as const;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/client.ts","../src/consts.ts"],"sourcesContent":["import {\n  buildEnsRainbowClientLabelSet,\n  type Cache,\n  type EncodedLabelHash,\n  type EnsRainbowClientLabelSet,\n  type EnsRainbowPublicConfig,\n  type EnsRainbowServerLabelSet,\n  type Label,\n  type LabelHash,\n  LruCache,\n  parseLabelHashOrEncodedLabelHash,\n} from \"@ensnode/ensnode-sdk\";\n\nimport { DEFAULT_ENSRAINBOW_URL, ErrorCode, StatusCode } from \"./consts\";\n\nexport namespace EnsRainbow {\n  export type ApiClientOptions = EnsRainbowApiClientOptions;\n\n  export interface ApiClient {\n    count(): Promise<CountResponse>;\n\n    /**\n     * Get the public configuration of the ENSRainbow service\n     */\n    config(): Promise<ENSRainbowPublicConfig>;\n\n    /**\n     * Heal a labelHash to its original label.\n     * Accepts a strict `LabelHash`, an `EncodedLabelHash` (bracket-enclosed), or any string\n     * that can be normalized (missing `0x` prefix, uppercase hex chars, or 63-char hex).\n     * Returns a `HealBadRequestError` if the input cannot be normalized to a valid labelHash.\n     */\n    heal(labelHash: LabelHash | EncodedLabelHash | string): Promise<HealResponse>;\n\n    health(): Promise<HealthResponse>;\n\n    /**\n     * Get the version information of the ENSRainbow service\n     *\n     * @deprecated Use {@link ApiClient.config} instead. This method will be removed in a future version.\n     */\n    version(): Promise<VersionResponse>;\n\n    getOptions(): Readonly<EnsRainbowApiClientOptions>;\n  }\n\n  type StatusCode = (typeof StatusCode)[keyof typeof StatusCode];\n\n  type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n\n  export interface HealthResponse {\n    status: \"ok\";\n  }\n\n  export interface BaseHealResponse<Status extends StatusCode, Error extends ErrorCode> {\n    status: Status;\n    label?: Label | never;\n    error?: string | never;\n    errorCode?: Error | never;\n  }\n\n  export interface HealSuccess extends BaseHealResponse<typeof StatusCode.Success, never> {\n    status: typeof StatusCode.Success;\n    label: Label;\n    error?: never;\n    errorCode?: never;\n  }\n\n  export interface HealNotFoundError\n    extends BaseHealResponse<typeof StatusCode.Error, typeof ErrorCode.NotFound> {\n    status: typeof StatusCode.Error;\n    label?: never;\n    error: string;\n    errorCode: typeof ErrorCode.NotFound;\n  }\n\n  export interface HealServerError\n    extends BaseHealResponse<typeof StatusCode.Error, typeof ErrorCode.ServerError> {\n    status: typeof StatusCode.Error;\n    label?: never;\n    error: string;\n    errorCode: typeof ErrorCode.ServerError;\n  }\n\n  export interface HealBadRequestError\n    extends BaseHealResponse<typeof StatusCode.Error, typeof ErrorCode.BadRequest> {\n    status: typeof StatusCode.Error;\n    label?: never;\n    error: string;\n    errorCode: typeof ErrorCode.BadRequest;\n  }\n\n  export type HealResponse =\n    | HealSuccess\n    | HealNotFoundError\n    | HealServerError\n    | HealBadRequestError;\n  export type HealError = Exclude<HealResponse, HealSuccess>;\n\n  /**\n   * Server errors should not be cached.\n   */\n  export type CacheableHealResponse = Exclude<HealResponse, HealServerError>;\n\n  export interface BaseCountResponse<Status extends StatusCode, Error extends ErrorCode> {\n    status: Status;\n    count?: number | never;\n    timestamp?: string | never;\n    error?: string | never;\n    errorCode?: Error | never;\n  }\n\n  export interface CountSuccess extends BaseCountResponse<typeof StatusCode.Success, never> {\n    status: typeof StatusCode.Success;\n    /** The total count of labels that can be healed by the ENSRainbow instance. Always a\n     * non-negative integer. */\n    count: number;\n    timestamp: string;\n    error?: never;\n    errorCode?: never;\n  }\n\n  export interface CountServerError\n    extends BaseCountResponse<typeof StatusCode.Error, typeof ErrorCode.ServerError> {\n    status: typeof StatusCode.Error;\n    count?: never;\n    timestamp?: never;\n    error: string;\n    errorCode: typeof ErrorCode.ServerError;\n  }\n\n  export type CountResponse = CountSuccess | CountServerError;\n\n  /**\n   * ENSRainbow version information.\n   *\n   * @deprecated Use {@link ENSRainbowPublicConfig} instead. This type will be removed in a future version.\n   */\n  export interface VersionInfo {\n    /**\n     * ENSRainbow version.\n     */\n    version: string;\n\n    /**\n     * ENSRainbow database schema version.\n     */\n    dbSchemaVersion: number;\n\n    /**\n     * The EnsRainbowServerLabelSet managed by the ENSRainbow server.\n     */\n    labelSet: EnsRainbowServerLabelSet;\n  }\n\n  /**\n   * Interface for the version endpoint response\n   *\n   * @deprecated Use {@link ENSRainbowPublicConfig} instead. This type will be removed in a future version.\n   */\n  export interface VersionResponse {\n    status: typeof StatusCode.Success;\n    versionInfo: VersionInfo;\n  }\n\n  /**\n   * Complete public configuration object for ENSRainbow.\n   *\n   * Contains all public configuration information about the ENSRainbow service instance,\n   * including version, label set information, and record counts.\n   */\n  export type ENSRainbowPublicConfig = EnsRainbowPublicConfig;\n}\n\nexport interface EnsRainbowApiClientOptions {\n  /**\n   * The maximum number of `HealResponse` values to cache.\n   * Must be a non-negative integer.\n   * Setting to 0 will disable caching.\n   */\n  cacheCapacity: number;\n\n  /**\n   * The URL of an ENSRainbow API endpoint.\n   */\n  endpointUrl: URL;\n\n  /**\n   * Optional label set preferences that the ENSRainbow server at endpointUrl is expected to\n   * support. If provided, enables deterministic heal results across time, such that only\n   * labels from label sets with versions less than or equal to this value will be returned.\n   * Therefore, even if the ENSRainbow server later ingests label sets with greater versions\n   * than this value, the results returned across time can be deterministic. If\n   * provided, heal operations with this EnsRainbowApiClient will validate the ENSRainbow\n   * server manages a compatible label set. If not provided no specific labelSetId validation\n   * will be performed during heal operations.\n   * If `labelSetId` is provided without `labelSetVersion`, the server will use the latest\n   * available version.\n   * If `labelSetVersion` is defined, only labels from sets less than or equal to this value\n   * will be returned.\n   * When `labelSetVersion` is defined, `labelSetId` must also be defined.\n   */\n  labelSet?: EnsRainbowClientLabelSet;\n}\n\n/**\n * ENSRainbow API client\n *\n * @example\n * ```typescript\n * // default options\n * const client = new EnsRainbowApiClient();\n * // custom options\n * const client = new EnsRainbowApiClient({\n *  endpointUrl: new URL(\"https://api.ensrainbow.io\"),\n * });\n * ```\n */\nexport class EnsRainbowApiClient implements EnsRainbow.ApiClient {\n  private readonly options: EnsRainbowApiClientOptions;\n  private readonly cache: Cache<LabelHash, EnsRainbow.CacheableHealResponse>;\n  private readonly labelSetSearchParams: URLSearchParams;\n\n  public static readonly DEFAULT_CACHE_CAPACITY = 1000;\n\n  /**\n   * Create default client options.\n   *\n   * @returns default options\n   */\n  static defaultOptions(): EnsRainbow.ApiClientOptions {\n    return {\n      endpointUrl: new URL(DEFAULT_ENSRAINBOW_URL),\n      cacheCapacity: EnsRainbowApiClient.DEFAULT_CACHE_CAPACITY,\n      labelSet: buildEnsRainbowClientLabelSet(),\n    };\n  }\n\n  constructor(options: Partial<EnsRainbow.ApiClientOptions> = {}) {\n    const { labelSet: optionsLabelSet, ...rest } = options;\n    const defaultOptions = EnsRainbowApiClient.defaultOptions();\n\n    const copiedLabelSet = buildEnsRainbowClientLabelSet(\n      optionsLabelSet?.labelSetId,\n      optionsLabelSet?.labelSetVersion,\n    );\n\n    this.options = {\n      ...defaultOptions,\n      ...rest,\n      labelSet: copiedLabelSet,\n    };\n\n    this.cache = new LruCache<LabelHash, EnsRainbow.CacheableHealResponse>(\n      this.options.cacheCapacity,\n    );\n\n    // Pre-compute query parameters for label set options\n    this.labelSetSearchParams = new URLSearchParams();\n    if (this.options.labelSet?.labelSetId !== undefined) {\n      this.labelSetSearchParams.append(\"label_set_id\", this.options.labelSet.labelSetId);\n    }\n    if (this.options.labelSet?.labelSetVersion !== undefined) {\n      this.labelSetSearchParams.append(\n        \"label_set_version\",\n        this.options.labelSet.labelSetVersion.toString(),\n      );\n    }\n  }\n\n  /**\n   * Attempt to [heal](https://ensnode.io/ensrainbow/concepts/glossary#heal) a labelHash to its original label.\n   *\n   * Note on returned labels: ENSRainbow returns labels exactly as they are\n   * represented in source rainbow table data. This means:\n   *\n   * - Labels may or may not be ENS-normalized\n   * - Labels can contain any valid string, including dots, null bytes, or be empty\n   * - Clients should handle all possible string values appropriately\n   *\n   * @param labelHash - A labelHash to heal, either as a strict `LabelHash`, an `EncodedLabelHash`\n   * (bracket-enclosed), or any string that can be normalized (missing `0x` prefix, uppercase hex\n   * chars, or 63-char hex are all accepted and normalized automatically).\n   * @returns a `HealResponse` indicating the result of the request and the healed label if successful.\n   * Returns a `HealBadRequestError` if the input cannot be normalized to a valid labelHash.\n   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,\n   * CORS violations, or Invalid URLs\n   * @example\n   * ```typescript\n   * const response = await client.heal(\n   *   \"0xaf2caa1c2ca1d027f1ac823b529d0a67cd144264b2789fa2ea4d63a67c7103cc\"\n   * );\n   *\n   * console.log(response);\n   *\n   * // Output:\n   * // {\n   * //   status: \"success\",\n   * //   label: \"vitalik\"\n   * // }\n   *\n   * const notFoundResponse = await client.heal(\n   *   \"0xf64dc17ae2e2b9b16dbcb8cb05f35a2e6080a5ff1dc53ac0bc48f0e79111f264\"\n   * );\n   *\n   * console.log(notFoundResponse);\n   *\n   * // Output:\n   * // {\n   * //   status: \"error\",\n   * //   error: \"Label not found\",\n   * //   errorCode: 404\n   * // }\n   * ```\n   */\n  async heal(labelHash: LabelHash | EncodedLabelHash | string): Promise<EnsRainbow.HealResponse> {\n    let normalizedLabelHash: LabelHash;\n\n    try {\n      normalizedLabelHash = parseLabelHashOrEncodedLabelHash(labelHash);\n    } catch (error) {\n      return {\n        status: StatusCode.Error,\n        error: error instanceof Error ? error.message : String(error),\n        errorCode: ErrorCode.BadRequest,\n      } as EnsRainbow.HealBadRequestError;\n    }\n\n    const cachedResult = this.cache.get(normalizedLabelHash);\n    if (cachedResult) return cachedResult;\n\n    const url = new URL(`/v1/heal/${normalizedLabelHash}`, this.options.endpointUrl);\n\n    // Apply pre-computed label set query parameters\n    this.labelSetSearchParams.forEach((value, key) => {\n      url.searchParams.append(key, value);\n    });\n\n    const response = await fetch(url);\n    const healResponse = (await response.json()) as EnsRainbow.HealResponse;\n\n    if (isCacheableHealResponse(healResponse)) {\n      this.cache.set(normalizedLabelHash, healResponse);\n    }\n\n    return healResponse;\n  }\n\n  /**\n   * Get Count of Healable Labels\n   *\n   * @returns a `CountResponse` indicating the result and the timestamp of the request and the\n   * number of healable labels if successful\n   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,\n   * CORS violations, or Invalid URLs\n   * @example\n   *\n   * const response = await client.count();\n   *\n   * console.log(response);\n   *\n   * // {\n   * //   \"status\": \"success\",\n   * //   \"count\": 133856894,\n   * //   \"timestamp\": \"2024-01-30T11:18:56Z\"\n   * // }\n   *\n   */\n  async count(): Promise<EnsRainbow.CountResponse> {\n    const response = await fetch(new URL(\"/v1/labels/count\", this.options.endpointUrl));\n\n    return response.json() as Promise<EnsRainbow.CountResponse>;\n  }\n\n  /**\n   *\n   * Simple verification that the service is running, either in your local setup or for the\n   * provided hosted instance.\n   * @returns a status of ENS Rainbow service\n   * @example\n   *\n   * const response = await client.health();\n   *\n   * console.log(response);\n   *\n   * // {\n   * //   \"status\": \"ok\",\n   * // }\n   */\n  async health(): Promise<EnsRainbow.HealthResponse> {\n    const response = await fetch(new URL(\"/health\", this.options.endpointUrl));\n\n    return response.json() as Promise<EnsRainbow.HealthResponse>;\n  }\n\n  /**\n   * Get the public configuration of the ENSRainbow service.\n   */\n  async config(): Promise<EnsRainbow.ENSRainbowPublicConfig> {\n    const response = await fetch(new URL(\"/v1/config\", this.options.endpointUrl));\n\n    if (!response.ok) {\n      throw new Error(`Failed to fetch ENSRainbow config: ${response.statusText}`);\n    }\n\n    return response.json() as Promise<EnsRainbow.ENSRainbowPublicConfig>;\n  }\n\n  /**\n   * Get the version information of the ENSRainbow service\n   *\n   * @deprecated Use {@link EnsRainbowApiClient.config} instead. This method will be removed in a future version.\n   * @returns the version information of the ENSRainbow service\n   * @throws if the request fails due to network failures, DNS lookup failures, request\n   * timeouts, CORS violations, or invalid URLs\n   * @example\n   * ```typescript\n   * const response = await client.version();\n   *\n   * console.log(response);\n   *\n   * // {\n   * //   \"status\": \"success\",\n   * //   \"versionInfo\": {\n   * //     \"version\": \"0.1.0\",\n   * //     \"dbSchemaVersion\": 2,\n   * //     \"labelSet\": {\n   * //       \"labelSetId\": \"subgraph\",\n   * //       \"labelSetVersion\": 0\n   * //     }\n   * //   }\n   * // }\n   * ```\n   */\n  async version(): Promise<EnsRainbow.VersionResponse> {\n    const response = await fetch(new URL(\"/v1/version\", this.options.endpointUrl));\n\n    return response.json() as Promise<EnsRainbow.VersionResponse>;\n  }\n\n  /**\n   * Get a copy of the current client options.\n   *\n   * @returns a copy of the current client options.\n   */\n  getOptions(): Readonly<EnsRainbowApiClientOptions> {\n    // build a deep copy to prevent modification\n    const deepCopy = {\n      cacheCapacity: this.options.cacheCapacity,\n      endpointUrl: new URL(this.options.endpointUrl.href),\n      labelSet: this.options.labelSet ? { ...this.options.labelSet } : undefined,\n    } satisfies EnsRainbowApiClientOptions;\n\n    return Object.freeze(deepCopy);\n  }\n}\n\n/**\n * Determine if a heal response is an error.\n *\n * @param response the heal response to check\n * @returns true if the response is an error, false otherwise\n */\nexport const isHealError = (\n  response: EnsRainbow.HealResponse,\n): response is EnsRainbow.HealError => {\n  return response.status === StatusCode.Error;\n};\n\n/**\n * Determine if a heal response is cacheable.\n *\n * Server errors at not cachable and should be retried.\n *\n * @param response the heal response to check\n * @returns true if the response is cacheable, false otherwise\n */\nexport const isCacheableHealResponse = (\n  response: EnsRainbow.HealResponse,\n): response is EnsRainbow.CacheableHealResponse => {\n  return response.status === StatusCode.Success || response.errorCode !== ErrorCode.ServerError;\n};\n","export const DEFAULT_ENSRAINBOW_URL = \"https://api.ensrainbow.io\" as const;\n\nexport const StatusCode = {\n  Success: \"success\",\n  Error: \"error\",\n} as const;\n\nexport const ErrorCode = {\n  BadRequest: 400,\n  NotFound: 404,\n  ServerError: 500,\n} as const;\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -4,7 +4,8 @@ import { buildEnsRainbowClientLabelSet as buildEnsRainbowClientLabelSet2 } from
 // src/client.ts
 import {
   buildEnsRainbowClientLabelSet,
-  LruCache
+  LruCache,
+  parseLabelHashOrEncodedLabelHash
 } from "@ensnode/ensnode-sdk";
 
 // src/consts.ts
@@ -73,8 +74,11 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
    * - Labels can contain any valid string, including dots, null bytes, or be empty
    * - Clients should handle all possible string values appropriately
    *
-   * @param labelHash all lowercase 64-digit hex string with 0x prefix (total length of 66 characters)
-   * @returns a `HealResponse` indicating the result of the request and the healed label if successful
+   * @param labelHash - A labelHash to heal, either as a strict `LabelHash`, an `EncodedLabelHash`
+   * (bracket-enclosed), or any string that can be normalized (missing `0x` prefix, uppercase hex
+   * chars, or 63-char hex are all accepted and normalized automatically).
+   * @returns a `HealResponse` indicating the result of the request and the healed label if successful.
+   * Returns a `HealBadRequestError` if the input cannot be normalized to a valid labelHash.
    * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,
    * CORS violations, or Invalid URLs
    * @example
@@ -106,16 +110,26 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
    * ```
    */
   async heal(labelHash) {
-    const cachedResult = this.cache.get(labelHash);
+    let normalizedLabelHash;
+    try {
+      normalizedLabelHash = parseLabelHashOrEncodedLabelHash(labelHash);
+    } catch (error) {
+      return {
+        status: StatusCode.Error,
+        error: error instanceof Error ? error.message : String(error),
+        errorCode: ErrorCode.BadRequest
+      };
+    }
+    const cachedResult = this.cache.get(normalizedLabelHash);
     if (cachedResult) return cachedResult;
-    const url = new URL(`/v1/heal/${labelHash}`, this.options.endpointUrl);
+    const url = new URL(`/v1/heal/${normalizedLabelHash}`, this.options.endpointUrl);
     this.labelSetSearchParams.forEach((value, key) => {
       url.searchParams.append(key, value);
     });
     const response = await fetch(url);
     const healResponse = await response.json();
     if (isCacheableHealResponse(healResponse)) {
-      this.cache.set(labelHash, healResponse);
+      this.cache.set(normalizedLabelHash, healResponse);
     }
     return healResponse;
   }
@@ -162,9 +176,20 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
     const response = await fetch(new URL("/health", this.options.endpointUrl));
     return response.json();
   }
+  /**
+   * Get the public configuration of the ENSRainbow service.
+   */
+  async config() {
+    const response = await fetch(new URL("/v1/config", this.options.endpointUrl));
+    if (!response.ok) {
+      throw new Error(`Failed to fetch ENSRainbow config: ${response.statusText}`);
+    }
+    return response.json();
+  }
   /**
    * Get the version information of the ENSRainbow service
    *
+   * @deprecated Use {@link EnsRainbowApiClient.config} instead. This method will be removed in a future version.
    * @returns the version information of the ENSRainbow service
    * @throws if the request fails due to network failures, DNS lookup failures, request
    * timeouts, CORS violations, or invalid URLs

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/consts.ts"],"sourcesContent":["// Re-export types from ensnode-sdk that are needed by consumers\nexport type {\n  EnsRainbowClientLabelSet,\n  EnsRainbowServerLabelSet,\n  LabelSetId,\n  LabelSetVersion,\n} from \"@ensnode/ensnode-sdk\";\n// Re-export utility functions and classes from ensnode-sdk that are needed by consumers\nexport { buildEnsRainbowClientLabelSet } from \"@ensnode/ensnode-sdk\";\n\nexport * from \"./client\";\nexport * from \"./consts\";\n","import {\n  buildEnsRainbowClientLabelSet,\n  type Cache,\n  type EnsRainbowClientLabelSet,\n  type EnsRainbowServerLabelSet,\n  type Label,\n  type LabelHash,\n  LruCache,\n} from \"@ensnode/ensnode-sdk\";\n\nimport { DEFAULT_ENSRAINBOW_URL, ErrorCode, StatusCode } from \"./consts\";\n\nexport namespace EnsRainbow {\n  export type ApiClientOptions = EnsRainbowApiClientOptions;\n\n  export interface ApiClient {\n    count(): Promise<CountResponse>;\n\n    /**\n     * Heal a labelhash to its original label\n     * @param labelHash The labelhash to heal\n     */\n    heal(labelHash: LabelHash): Promise<HealResponse>;\n\n    health(): Promise<HealthResponse>;\n\n    version(): Promise<VersionResponse>;\n\n    getOptions(): Readonly<EnsRainbowApiClientOptions>;\n  }\n\n  type StatusCode = (typeof StatusCode)[keyof typeof StatusCode];\n\n  type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n\n  export interface HealthResponse {\n    status: \"ok\";\n  }\n\n  export interface BaseHealResponse<Status extends StatusCode, Error extends ErrorCode> {\n    status: Status;\n    label?: Label | never;\n    error?: string | never;\n    errorCode?: Error | never;\n  }\n\n  export interface HealSuccess extends BaseHealResponse<typeof StatusCode.Success, never> {\n    status: typeof StatusCode.Success;\n    label: Label;\n    error?: never;\n    errorCode?: never;\n  }\n\n  export interface HealNotFoundError\n    extends BaseHealResponse<typeof StatusCode.Error, typeof ErrorCode.NotFound> {\n    status: typeof StatusCode.Error;\n    label?: never;\n    error: string;\n    errorCode: typeof ErrorCode.NotFound;\n  }\n\n  export interface HealServerError\n    extends BaseHealResponse<typeof StatusCode.Error, typeof ErrorCode.ServerError> {\n    status: typeof StatusCode.Error;\n    label?: never;\n    error: string;\n    errorCode: typeof ErrorCode.ServerError;\n  }\n\n  export interface HealBadRequestError\n    extends BaseHealResponse<typeof StatusCode.Error, typeof ErrorCode.BadRequest> {\n    status: typeof StatusCode.Error;\n    label?: never;\n    error: string;\n    errorCode: typeof ErrorCode.BadRequest;\n  }\n\n  export type HealResponse =\n    | HealSuccess\n    | HealNotFoundError\n    | HealServerError\n    | HealBadRequestError;\n  export type HealError = Exclude<HealResponse, HealSuccess>;\n\n  /**\n   * Server errors should not be cached.\n   */\n  export type CacheableHealResponse = Exclude<HealResponse, HealServerError>;\n\n  export interface BaseCountResponse<Status extends StatusCode, Error extends ErrorCode> {\n    status: Status;\n    count?: number | never;\n    timestamp?: string | never;\n    error?: string | never;\n    errorCode?: Error | never;\n  }\n\n  export interface CountSuccess extends BaseCountResponse<typeof StatusCode.Success, never> {\n    status: typeof StatusCode.Success;\n    /** The total count of labels that can be healed by the ENSRainbow instance. Always a\n     * non-negative integer. */\n    count: number;\n    timestamp: string;\n    error?: never;\n    errorCode?: never;\n  }\n\n  export interface CountServerError\n    extends BaseCountResponse<typeof StatusCode.Error, typeof ErrorCode.ServerError> {\n    status: typeof StatusCode.Error;\n    count?: never;\n    timestamp?: never;\n    error: string;\n    errorCode: typeof ErrorCode.ServerError;\n  }\n\n  export type CountResponse = CountSuccess | CountServerError;\n\n  /**\n   * ENSRainbow version information.\n   */\n  export interface VersionInfo {\n    /**\n     * ENSRainbow version.\n     */\n    version: string;\n\n    /**\n     * ENSRainbow database schema version.\n     */\n    dbSchemaVersion: number;\n\n    /**\n     * The EnsRainbowServerLabelSet managed by the ENSRainbow server.\n     */\n    labelSet: EnsRainbowServerLabelSet;\n  }\n\n  /**\n   * Interface for the version endpoint response\n   */\n  export interface VersionResponse {\n    status: typeof StatusCode.Success;\n    versionInfo: VersionInfo;\n  }\n}\n\nexport interface EnsRainbowApiClientOptions {\n  /**\n   * The maximum number of `HealResponse` values to cache.\n   * Must be a non-negative integer.\n   * Setting to 0 will disable caching.\n   */\n  cacheCapacity: number;\n\n  /**\n   * The URL of an ENSRainbow API endpoint.\n   */\n  endpointUrl: URL;\n\n  /**\n   * Optional label set preferences that the ENSRainbow server at endpointUrl is expected to\n   * support. If provided, enables deterministic heal results across time, such that only\n   * labels from label sets with versions less than or equal to this value will be returned.\n   * Therefore, even if the ENSRainbow server later ingests label sets with greater versions\n   * than this value, the results returned across time can be deterministic. If\n   * provided, heal operations with this EnsRainbowApiClient will validate the ENSRainbow\n   * server manages a compatible label set. If not provided no specific labelSetId validation\n   * will be performed during heal operations.\n   * If `labelSetId` is provided without `labelSetVersion`, the server will use the latest\n   * available version.\n   * If `labelSetVersion` is defined, only labels from sets less than or equal to this value\n   * will be returned.\n   * When `labelSetVersion` is defined, `labelSetId` must also be defined.\n   */\n  labelSet?: EnsRainbowClientLabelSet;\n}\n\n/**\n * ENSRainbow API client\n *\n * @example\n * ```typescript\n * // default options\n * const client = new EnsRainbowApiClient();\n * // custom options\n * const client = new EnsRainbowApiClient({\n *  endpointUrl: new URL(\"https://api.ensrainbow.io\"),\n * });\n * ```\n */\nexport class EnsRainbowApiClient implements EnsRainbow.ApiClient {\n  private readonly options: EnsRainbowApiClientOptions;\n  private readonly cache: Cache<LabelHash, EnsRainbow.CacheableHealResponse>;\n  private readonly labelSetSearchParams: URLSearchParams;\n\n  public static readonly DEFAULT_CACHE_CAPACITY = 1000;\n\n  /**\n   * Create default client options.\n   *\n   * @returns default options\n   */\n  static defaultOptions(): EnsRainbow.ApiClientOptions {\n    return {\n      endpointUrl: new URL(DEFAULT_ENSRAINBOW_URL),\n      cacheCapacity: EnsRainbowApiClient.DEFAULT_CACHE_CAPACITY,\n      labelSet: buildEnsRainbowClientLabelSet(),\n    };\n  }\n\n  constructor(options: Partial<EnsRainbow.ApiClientOptions> = {}) {\n    const { labelSet: optionsLabelSet, ...rest } = options;\n    const defaultOptions = EnsRainbowApiClient.defaultOptions();\n\n    const copiedLabelSet = buildEnsRainbowClientLabelSet(\n      optionsLabelSet?.labelSetId,\n      optionsLabelSet?.labelSetVersion,\n    );\n\n    this.options = {\n      ...defaultOptions,\n      ...rest,\n      labelSet: copiedLabelSet,\n    };\n\n    this.cache = new LruCache<LabelHash, EnsRainbow.CacheableHealResponse>(\n      this.options.cacheCapacity,\n    );\n\n    // Pre-compute query parameters for label set options\n    this.labelSetSearchParams = new URLSearchParams();\n    if (this.options.labelSet?.labelSetId !== undefined) {\n      this.labelSetSearchParams.append(\"label_set_id\", this.options.labelSet.labelSetId);\n    }\n    if (this.options.labelSet?.labelSetVersion !== undefined) {\n      this.labelSetSearchParams.append(\n        \"label_set_version\",\n        this.options.labelSet.labelSetVersion.toString(),\n      );\n    }\n  }\n\n  /**\n   * Attempt to [heal](https://ensnode.io/ensrainbow/concepts/glossary#heal) a labelHash to its original label.\n   *\n   * Note on returned labels: ENSRainbow returns labels exactly as they are\n   * represented in source rainbow table data. This means:\n   *\n   * - Labels may or may not be ENS-normalized\n   * - Labels can contain any valid string, including dots, null bytes, or be empty\n   * - Clients should handle all possible string values appropriately\n   *\n   * @param labelHash all lowercase 64-digit hex string with 0x prefix (total length of 66 characters)\n   * @returns a `HealResponse` indicating the result of the request and the healed label if successful\n   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,\n   * CORS violations, or Invalid URLs\n   * @example\n   * ```typescript\n   * const response = await client.heal(\n   *   \"0xaf2caa1c2ca1d027f1ac823b529d0a67cd144264b2789fa2ea4d63a67c7103cc\"\n   * );\n   *\n   * console.log(response);\n   *\n   * // Output:\n   * // {\n   * //   status: \"success\",\n   * //   label: \"vitalik\"\n   * // }\n   *\n   * const notFoundResponse = await client.heal(\n   *   \"0xf64dc17ae2e2b9b16dbcb8cb05f35a2e6080a5ff1dc53ac0bc48f0e79111f264\"\n   * );\n   *\n   * console.log(notFoundResponse);\n   *\n   * // Output:\n   * // {\n   * //   status: \"error\",\n   * //   error: \"Label not found\",\n   * //   errorCode: 404\n   * // }\n   * ```\n   */\n  async heal(labelHash: LabelHash): Promise<EnsRainbow.HealResponse> {\n    const cachedResult = this.cache.get(labelHash);\n    if (cachedResult) return cachedResult;\n\n    const url = new URL(`/v1/heal/${labelHash}`, this.options.endpointUrl);\n\n    // Apply pre-computed label set query parameters\n    this.labelSetSearchParams.forEach((value, key) => {\n      url.searchParams.append(key, value);\n    });\n\n    const response = await fetch(url);\n    const healResponse = (await response.json()) as EnsRainbow.HealResponse;\n\n    if (isCacheableHealResponse(healResponse)) {\n      this.cache.set(labelHash, healResponse);\n    }\n\n    return healResponse;\n  }\n\n  /**\n   * Get Count of Healable Labels\n   *\n   * @returns a `CountResponse` indicating the result and the timestamp of the request and the\n   * number of healable labels if successful\n   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,\n   * CORS violations, or Invalid URLs\n   * @example\n   *\n   * const response = await client.count();\n   *\n   * console.log(response);\n   *\n   * // {\n   * //   \"status\": \"success\",\n   * //   \"count\": 133856894,\n   * //   \"timestamp\": \"2024-01-30T11:18:56Z\"\n   * // }\n   *\n   */\n  async count(): Promise<EnsRainbow.CountResponse> {\n    const response = await fetch(new URL(\"/v1/labels/count\", this.options.endpointUrl));\n\n    return response.json() as Promise<EnsRainbow.CountResponse>;\n  }\n\n  /**\n   *\n   * Simple verification that the service is running, either in your local setup or for the\n   * provided hosted instance.\n   * @returns a status of ENS Rainbow service\n   * @example\n   *\n   * const response = await client.health();\n   *\n   * console.log(response);\n   *\n   * // {\n   * //   \"status\": \"ok\",\n   * // }\n   */\n  async health(): Promise<EnsRainbow.HealthResponse> {\n    const response = await fetch(new URL(\"/health\", this.options.endpointUrl));\n\n    return response.json() as Promise<EnsRainbow.HealthResponse>;\n  }\n\n  /**\n   * Get the version information of the ENSRainbow service\n   *\n   * @returns the version information of the ENSRainbow service\n   * @throws if the request fails due to network failures, DNS lookup failures, request\n   * timeouts, CORS violations, or invalid URLs\n   * @example\n   * ```typescript\n   * const response = await client.version();\n   *\n   * console.log(response);\n   *\n   * // {\n   * //   \"status\": \"success\",\n   * //   \"versionInfo\": {\n   * //     \"version\": \"0.1.0\",\n   * //     \"dbSchemaVersion\": 2,\n   * //     \"labelSet\": {\n   * //       \"labelSetId\": \"subgraph\",\n   * //       \"labelSetVersion\": 0\n   * //     }\n   * //   }\n   * // }\n   * ```\n   */\n  async version(): Promise<EnsRainbow.VersionResponse> {\n    const response = await fetch(new URL(\"/v1/version\", this.options.endpointUrl));\n\n    return response.json() as Promise<EnsRainbow.VersionResponse>;\n  }\n\n  /**\n   * Get a copy of the current client options.\n   *\n   * @returns a copy of the current client options.\n   */\n  getOptions(): Readonly<EnsRainbowApiClientOptions> {\n    // build a deep copy to prevent modification\n    const deepCopy = {\n      cacheCapacity: this.options.cacheCapacity,\n      endpointUrl: new URL(this.options.endpointUrl.href),\n      labelSet: this.options.labelSet ? { ...this.options.labelSet } : undefined,\n    } satisfies EnsRainbowApiClientOptions;\n\n    return Object.freeze(deepCopy);\n  }\n}\n\n/**\n * Determine if a heal response is an error.\n *\n * @param response the heal response to check\n * @returns true if the response is an error, false otherwise\n */\nexport const isHealError = (\n  response: EnsRainbow.HealResponse,\n): response is EnsRainbow.HealError => {\n  return response.status === StatusCode.Error;\n};\n\n/**\n * Determine if a heal response is cacheable.\n *\n * Server errors at not cachable and should be retried.\n *\n * @param response the heal response to check\n * @returns true if the response is cacheable, false otherwise\n */\nexport const isCacheableHealResponse = (\n  response: EnsRainbow.HealResponse,\n): response is EnsRainbow.CacheableHealResponse => {\n  return response.status === StatusCode.Success || response.errorCode !== ErrorCode.ServerError;\n};\n","export const DEFAULT_ENSRAINBOW_URL = \"https://api.ensrainbow.io\" as const;\n\nexport const StatusCode = {\n  Success: \"success\",\n  Error: \"error\",\n} as const;\n\nexport const ErrorCode = {\n  BadRequest: 400,\n  NotFound: 404,\n  ServerError: 500,\n} as const;\n"],"mappings":"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","names":["buildEnsRainbowClientLabelSet"]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/consts.ts"],"sourcesContent":["// Re-export types from ensnode-sdk that are needed by consumers\nexport type {\n  EnsRainbowClientLabelSet,\n  EnsRainbowServerLabelSet,\n  LabelSetId,\n  LabelSetVersion,\n} from \"@ensnode/ensnode-sdk\";\n// Re-export utility functions and classes from ensnode-sdk that are needed by consumers\nexport { buildEnsRainbowClientLabelSet } from \"@ensnode/ensnode-sdk\";\n\nexport * from \"./client\";\nexport * from \"./consts\";\n","import {\n  buildEnsRainbowClientLabelSet,\n  type Cache,\n  type EncodedLabelHash,\n  type EnsRainbowClientLabelSet,\n  type EnsRainbowPublicConfig,\n  type EnsRainbowServerLabelSet,\n  type Label,\n  type LabelHash,\n  LruCache,\n  parseLabelHashOrEncodedLabelHash,\n} from \"@ensnode/ensnode-sdk\";\n\nimport { DEFAULT_ENSRAINBOW_URL, ErrorCode, StatusCode } from \"./consts\";\n\nexport namespace EnsRainbow {\n  export type ApiClientOptions = EnsRainbowApiClientOptions;\n\n  export interface ApiClient {\n    count(): Promise<CountResponse>;\n\n    /**\n     * Get the public configuration of the ENSRainbow service\n     */\n    config(): Promise<ENSRainbowPublicConfig>;\n\n    /**\n     * Heal a labelHash to its original label.\n     * Accepts a strict `LabelHash`, an `EncodedLabelHash` (bracket-enclosed), or any string\n     * that can be normalized (missing `0x` prefix, uppercase hex chars, or 63-char hex).\n     * Returns a `HealBadRequestError` if the input cannot be normalized to a valid labelHash.\n     */\n    heal(labelHash: LabelHash | EncodedLabelHash | string): Promise<HealResponse>;\n\n    health(): Promise<HealthResponse>;\n\n    /**\n     * Get the version information of the ENSRainbow service\n     *\n     * @deprecated Use {@link ApiClient.config} instead. This method will be removed in a future version.\n     */\n    version(): Promise<VersionResponse>;\n\n    getOptions(): Readonly<EnsRainbowApiClientOptions>;\n  }\n\n  type StatusCode = (typeof StatusCode)[keyof typeof StatusCode];\n\n  type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n\n  export interface HealthResponse {\n    status: \"ok\";\n  }\n\n  export interface BaseHealResponse<Status extends StatusCode, Error extends ErrorCode> {\n    status: Status;\n    label?: Label | never;\n    error?: string | never;\n    errorCode?: Error | never;\n  }\n\n  export interface HealSuccess extends BaseHealResponse<typeof StatusCode.Success, never> {\n    status: typeof StatusCode.Success;\n    label: Label;\n    error?: never;\n    errorCode?: never;\n  }\n\n  export interface HealNotFoundError\n    extends BaseHealResponse<typeof StatusCode.Error, typeof ErrorCode.NotFound> {\n    status: typeof StatusCode.Error;\n    label?: never;\n    error: string;\n    errorCode: typeof ErrorCode.NotFound;\n  }\n\n  export interface HealServerError\n    extends BaseHealResponse<typeof StatusCode.Error, typeof ErrorCode.ServerError> {\n    status: typeof StatusCode.Error;\n    label?: never;\n    error: string;\n    errorCode: typeof ErrorCode.ServerError;\n  }\n\n  export interface HealBadRequestError\n    extends BaseHealResponse<typeof StatusCode.Error, typeof ErrorCode.BadRequest> {\n    status: typeof StatusCode.Error;\n    label?: never;\n    error: string;\n    errorCode: typeof ErrorCode.BadRequest;\n  }\n\n  export type HealResponse =\n    | HealSuccess\n    | HealNotFoundError\n    | HealServerError\n    | HealBadRequestError;\n  export type HealError = Exclude<HealResponse, HealSuccess>;\n\n  /**\n   * Server errors should not be cached.\n   */\n  export type CacheableHealResponse = Exclude<HealResponse, HealServerError>;\n\n  export interface BaseCountResponse<Status extends StatusCode, Error extends ErrorCode> {\n    status: Status;\n    count?: number | never;\n    timestamp?: string | never;\n    error?: string | never;\n    errorCode?: Error | never;\n  }\n\n  export interface CountSuccess extends BaseCountResponse<typeof StatusCode.Success, never> {\n    status: typeof StatusCode.Success;\n    /** The total count of labels that can be healed by the ENSRainbow instance. Always a\n     * non-negative integer. */\n    count: number;\n    timestamp: string;\n    error?: never;\n    errorCode?: never;\n  }\n\n  export interface CountServerError\n    extends BaseCountResponse<typeof StatusCode.Error, typeof ErrorCode.ServerError> {\n    status: typeof StatusCode.Error;\n    count?: never;\n    timestamp?: never;\n    error: string;\n    errorCode: typeof ErrorCode.ServerError;\n  }\n\n  export type CountResponse = CountSuccess | CountServerError;\n\n  /**\n   * ENSRainbow version information.\n   *\n   * @deprecated Use {@link ENSRainbowPublicConfig} instead. This type will be removed in a future version.\n   */\n  export interface VersionInfo {\n    /**\n     * ENSRainbow version.\n     */\n    version: string;\n\n    /**\n     * ENSRainbow database schema version.\n     */\n    dbSchemaVersion: number;\n\n    /**\n     * The EnsRainbowServerLabelSet managed by the ENSRainbow server.\n     */\n    labelSet: EnsRainbowServerLabelSet;\n  }\n\n  /**\n   * Interface for the version endpoint response\n   *\n   * @deprecated Use {@link ENSRainbowPublicConfig} instead. This type will be removed in a future version.\n   */\n  export interface VersionResponse {\n    status: typeof StatusCode.Success;\n    versionInfo: VersionInfo;\n  }\n\n  /**\n   * Complete public configuration object for ENSRainbow.\n   *\n   * Contains all public configuration information about the ENSRainbow service instance,\n   * including version, label set information, and record counts.\n   */\n  export type ENSRainbowPublicConfig = EnsRainbowPublicConfig;\n}\n\nexport interface EnsRainbowApiClientOptions {\n  /**\n   * The maximum number of `HealResponse` values to cache.\n   * Must be a non-negative integer.\n   * Setting to 0 will disable caching.\n   */\n  cacheCapacity: number;\n\n  /**\n   * The URL of an ENSRainbow API endpoint.\n   */\n  endpointUrl: URL;\n\n  /**\n   * Optional label set preferences that the ENSRainbow server at endpointUrl is expected to\n   * support. If provided, enables deterministic heal results across time, such that only\n   * labels from label sets with versions less than or equal to this value will be returned.\n   * Therefore, even if the ENSRainbow server later ingests label sets with greater versions\n   * than this value, the results returned across time can be deterministic. If\n   * provided, heal operations with this EnsRainbowApiClient will validate the ENSRainbow\n   * server manages a compatible label set. If not provided no specific labelSetId validation\n   * will be performed during heal operations.\n   * If `labelSetId` is provided without `labelSetVersion`, the server will use the latest\n   * available version.\n   * If `labelSetVersion` is defined, only labels from sets less than or equal to this value\n   * will be returned.\n   * When `labelSetVersion` is defined, `labelSetId` must also be defined.\n   */\n  labelSet?: EnsRainbowClientLabelSet;\n}\n\n/**\n * ENSRainbow API client\n *\n * @example\n * ```typescript\n * // default options\n * const client = new EnsRainbowApiClient();\n * // custom options\n * const client = new EnsRainbowApiClient({\n *  endpointUrl: new URL(\"https://api.ensrainbow.io\"),\n * });\n * ```\n */\nexport class EnsRainbowApiClient implements EnsRainbow.ApiClient {\n  private readonly options: EnsRainbowApiClientOptions;\n  private readonly cache: Cache<LabelHash, EnsRainbow.CacheableHealResponse>;\n  private readonly labelSetSearchParams: URLSearchParams;\n\n  public static readonly DEFAULT_CACHE_CAPACITY = 1000;\n\n  /**\n   * Create default client options.\n   *\n   * @returns default options\n   */\n  static defaultOptions(): EnsRainbow.ApiClientOptions {\n    return {\n      endpointUrl: new URL(DEFAULT_ENSRAINBOW_URL),\n      cacheCapacity: EnsRainbowApiClient.DEFAULT_CACHE_CAPACITY,\n      labelSet: buildEnsRainbowClientLabelSet(),\n    };\n  }\n\n  constructor(options: Partial<EnsRainbow.ApiClientOptions> = {}) {\n    const { labelSet: optionsLabelSet, ...rest } = options;\n    const defaultOptions = EnsRainbowApiClient.defaultOptions();\n\n    const copiedLabelSet = buildEnsRainbowClientLabelSet(\n      optionsLabelSet?.labelSetId,\n      optionsLabelSet?.labelSetVersion,\n    );\n\n    this.options = {\n      ...defaultOptions,\n      ...rest,\n      labelSet: copiedLabelSet,\n    };\n\n    this.cache = new LruCache<LabelHash, EnsRainbow.CacheableHealResponse>(\n      this.options.cacheCapacity,\n    );\n\n    // Pre-compute query parameters for label set options\n    this.labelSetSearchParams = new URLSearchParams();\n    if (this.options.labelSet?.labelSetId !== undefined) {\n      this.labelSetSearchParams.append(\"label_set_id\", this.options.labelSet.labelSetId);\n    }\n    if (this.options.labelSet?.labelSetVersion !== undefined) {\n      this.labelSetSearchParams.append(\n        \"label_set_version\",\n        this.options.labelSet.labelSetVersion.toString(),\n      );\n    }\n  }\n\n  /**\n   * Attempt to [heal](https://ensnode.io/ensrainbow/concepts/glossary#heal) a labelHash to its original label.\n   *\n   * Note on returned labels: ENSRainbow returns labels exactly as they are\n   * represented in source rainbow table data. This means:\n   *\n   * - Labels may or may not be ENS-normalized\n   * - Labels can contain any valid string, including dots, null bytes, or be empty\n   * - Clients should handle all possible string values appropriately\n   *\n   * @param labelHash - A labelHash to heal, either as a strict `LabelHash`, an `EncodedLabelHash`\n   * (bracket-enclosed), or any string that can be normalized (missing `0x` prefix, uppercase hex\n   * chars, or 63-char hex are all accepted and normalized automatically).\n   * @returns a `HealResponse` indicating the result of the request and the healed label if successful.\n   * Returns a `HealBadRequestError` if the input cannot be normalized to a valid labelHash.\n   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,\n   * CORS violations, or Invalid URLs\n   * @example\n   * ```typescript\n   * const response = await client.heal(\n   *   \"0xaf2caa1c2ca1d027f1ac823b529d0a67cd144264b2789fa2ea4d63a67c7103cc\"\n   * );\n   *\n   * console.log(response);\n   *\n   * // Output:\n   * // {\n   * //   status: \"success\",\n   * //   label: \"vitalik\"\n   * // }\n   *\n   * const notFoundResponse = await client.heal(\n   *   \"0xf64dc17ae2e2b9b16dbcb8cb05f35a2e6080a5ff1dc53ac0bc48f0e79111f264\"\n   * );\n   *\n   * console.log(notFoundResponse);\n   *\n   * // Output:\n   * // {\n   * //   status: \"error\",\n   * //   error: \"Label not found\",\n   * //   errorCode: 404\n   * // }\n   * ```\n   */\n  async heal(labelHash: LabelHash | EncodedLabelHash | string): Promise<EnsRainbow.HealResponse> {\n    let normalizedLabelHash: LabelHash;\n\n    try {\n      normalizedLabelHash = parseLabelHashOrEncodedLabelHash(labelHash);\n    } catch (error) {\n      return {\n        status: StatusCode.Error,\n        error: error instanceof Error ? error.message : String(error),\n        errorCode: ErrorCode.BadRequest,\n      } as EnsRainbow.HealBadRequestError;\n    }\n\n    const cachedResult = this.cache.get(normalizedLabelHash);\n    if (cachedResult) return cachedResult;\n\n    const url = new URL(`/v1/heal/${normalizedLabelHash}`, this.options.endpointUrl);\n\n    // Apply pre-computed label set query parameters\n    this.labelSetSearchParams.forEach((value, key) => {\n      url.searchParams.append(key, value);\n    });\n\n    const response = await fetch(url);\n    const healResponse = (await response.json()) as EnsRainbow.HealResponse;\n\n    if (isCacheableHealResponse(healResponse)) {\n      this.cache.set(normalizedLabelHash, healResponse);\n    }\n\n    return healResponse;\n  }\n\n  /**\n   * Get Count of Healable Labels\n   *\n   * @returns a `CountResponse` indicating the result and the timestamp of the request and the\n   * number of healable labels if successful\n   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,\n   * CORS violations, or Invalid URLs\n   * @example\n   *\n   * const response = await client.count();\n   *\n   * console.log(response);\n   *\n   * // {\n   * //   \"status\": \"success\",\n   * //   \"count\": 133856894,\n   * //   \"timestamp\": \"2024-01-30T11:18:56Z\"\n   * // }\n   *\n   */\n  async count(): Promise<EnsRainbow.CountResponse> {\n    const response = await fetch(new URL(\"/v1/labels/count\", this.options.endpointUrl));\n\n    return response.json() as Promise<EnsRainbow.CountResponse>;\n  }\n\n  /**\n   *\n   * Simple verification that the service is running, either in your local setup or for the\n   * provided hosted instance.\n   * @returns a status of ENS Rainbow service\n   * @example\n   *\n   * const response = await client.health();\n   *\n   * console.log(response);\n   *\n   * // {\n   * //   \"status\": \"ok\",\n   * // }\n   */\n  async health(): Promise<EnsRainbow.HealthResponse> {\n    const response = await fetch(new URL(\"/health\", this.options.endpointUrl));\n\n    return response.json() as Promise<EnsRainbow.HealthResponse>;\n  }\n\n  /**\n   * Get the public configuration of the ENSRainbow service.\n   */\n  async config(): Promise<EnsRainbow.ENSRainbowPublicConfig> {\n    const response = await fetch(new URL(\"/v1/config\", this.options.endpointUrl));\n\n    if (!response.ok) {\n      throw new Error(`Failed to fetch ENSRainbow config: ${response.statusText}`);\n    }\n\n    return response.json() as Promise<EnsRainbow.ENSRainbowPublicConfig>;\n  }\n\n  /**\n   * Get the version information of the ENSRainbow service\n   *\n   * @deprecated Use {@link EnsRainbowApiClient.config} instead. This method will be removed in a future version.\n   * @returns the version information of the ENSRainbow service\n   * @throws if the request fails due to network failures, DNS lookup failures, request\n   * timeouts, CORS violations, or invalid URLs\n   * @example\n   * ```typescript\n   * const response = await client.version();\n   *\n   * console.log(response);\n   *\n   * // {\n   * //   \"status\": \"success\",\n   * //   \"versionInfo\": {\n   * //     \"version\": \"0.1.0\",\n   * //     \"dbSchemaVersion\": 2,\n   * //     \"labelSet\": {\n   * //       \"labelSetId\": \"subgraph\",\n   * //       \"labelSetVersion\": 0\n   * //     }\n   * //   }\n   * // }\n   * ```\n   */\n  async version(): Promise<EnsRainbow.VersionResponse> {\n    const response = await fetch(new URL(\"/v1/version\", this.options.endpointUrl));\n\n    return response.json() as Promise<EnsRainbow.VersionResponse>;\n  }\n\n  /**\n   * Get a copy of the current client options.\n   *\n   * @returns a copy of the current client options.\n   */\n  getOptions(): Readonly<EnsRainbowApiClientOptions> {\n    // build a deep copy to prevent modification\n    const deepCopy = {\n      cacheCapacity: this.options.cacheCapacity,\n      endpointUrl: new URL(this.options.endpointUrl.href),\n      labelSet: this.options.labelSet ? { ...this.options.labelSet } : undefined,\n    } satisfies EnsRainbowApiClientOptions;\n\n    return Object.freeze(deepCopy);\n  }\n}\n\n/**\n * Determine if a heal response is an error.\n *\n * @param response the heal response to check\n * @returns true if the response is an error, false otherwise\n */\nexport const isHealError = (\n  response: EnsRainbow.HealResponse,\n): response is EnsRainbow.HealError => {\n  return response.status === StatusCode.Error;\n};\n\n/**\n * Determine if a heal response is cacheable.\n *\n * Server errors at not cachable and should be retried.\n *\n * @param response the heal response to check\n * @returns true if the response is cacheable, false otherwise\n */\nexport const isCacheableHealResponse = (\n  response: EnsRainbow.HealResponse,\n): response is EnsRainbow.CacheableHealResponse => {\n  return response.status === StatusCode.Success || response.errorCode !== ErrorCode.ServerError;\n};\n","export const DEFAULT_ENSRAINBOW_URL = \"https://api.ensrainbow.io\" as const;\n\nexport const StatusCode = {\n  Success: \"success\",\n  Error: \"error\",\n} as const;\n\nexport const ErrorCode = {\n  BadRequest: 400,\n  NotFound: 404,\n  ServerError: 500,\n} as const;\n"],"mappings":"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","names":["buildEnsRainbowClientLabelSet"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ensnode/ensrainbow-sdk",
-  "version": "1.5.1",
+  "version": "1.7.0",
   "type": "module",
   "description": "ENSRainbow SDK for interacting with the ENSRainbow API.",
   "license": "MIT",
@@ -42,13 +42,13 @@
     "tsup": "^8.3.6",
     "typescript": "^5.7.3",
     "vitest": "^4.0.2",
-    "@ensnode/shared-configs": "1.5.1",
-    "@ensnode/ensnode-sdk": "1.5.1"
+    "@ensnode/shared-configs": "1.7.0",
+    "@ensnode/ensnode-sdk": "1.7.0"
   },
   "scripts": {
     "prepublish": "tsup",
     "test": "vitest",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsgo --noEmit",
     "lint": "biome check --write .",
     "lint:ci": "biome ci"
   },