npm - @ensnode/ensrainbow-sdk - Versions diffs - 0.33.0 → 0.34.0 - Mend

@ensnode/ensrainbow-sdk 0.33.0 → 0.34.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/dist/client.d.ts CHANGED Viewed

@@ -1,9 +1,13 @@
-import { LabelHash, Label } from '@ensnode/ensnode-sdk';
+import { EnsRainbowClientLabelSet, LabelHash, Label, EnsRainbowServerLabelSet } 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
+         */
         heal(labelHash: LabelHash): Promise<HealResponse>;
         health(): Promise<HealthResponse>;
         version(): Promise<VersionResponse>;
@@ -59,7 +63,8 @@ declare namespace EnsRainbow {
     }
     export interface CountSuccess extends BaseCountResponse<typeof StatusCode.Success, never> {
         status: typeof StatusCode.Success;
-        /** The total count of labels that can be healed by the ENSRainbow instance. Always a non-negative integer. */
+        /** The total count of labels that can be healed by the ENSRainbow instance. Always a
+         * non-negative integer. */
         count: number;
         timestamp: string;
         error?: never;
@@ -82,9 +87,13 @@ declare namespace EnsRainbow {
          */
         version: string;
         /**
-         * ENSRainbow schema version.
+         * ENSRainbow database schema version.
          */
-        schema_version: number;
+        dbSchemaVersion: number;
+        /**
+         * The EnsRainbowServerLabelSet managed by the ENSRainbow server.
+         */
+        labelSet: EnsRainbowServerLabelSet;
     }
     /**
      * Interface for the version endpoint response
@@ -106,6 +115,22 @@ interface EnsRainbowApiClientOptions {
      * The URL of an ENSRainbow API endpoint.
      */
     endpointUrl: URL;
+    /**
+     * Optional label set preferences that the ENSRainbow server at endpointUrl is expected to
+     * support. If provided, enables deterministic heal results across time, such that only
+     * labels from label sets with versions less than or equal to this value will be returned.
+     * Therefore, even if the ENSRainbow server later ingests label sets with greater versions
+     * than this value, the results returned across time can be deterministic. If
+     * provided, heal operations with this EnsRainbowApiClient will validate the ENSRainbow
+     * server manages a compatible label set. If not provided no specific labelSetId validation
+     * will be performed during heal operations.
+     * If `labelSetId` is provided without `labelSetVersion`, the server will use the latest
+     * available version.
+     * If `labelSetVersion` is defined, only labels from sets less than or equal to this value
+     * will be returned.
+     * When `labelSetVersion` is defined, `labelSetId` must also be defined.
+     */
+    labelSet?: EnsRainbowClientLabelSet;
 }
 /**
  * ENSRainbow API client
@@ -123,6 +148,7 @@ interface EnsRainbowApiClientOptions {
 declare class EnsRainbowApiClient implements EnsRainbow.ApiClient {
     private readonly options;
     private readonly cache;
+    private readonly labelSetSearchParams;
     static readonly DEFAULT_CACHE_CAPACITY = 1000;
     /**
      * Create default client options.
@@ -143,8 +169,8 @@ declare class EnsRainbowApiClient implements EnsRainbow.ApiClient {
      *
      * @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
-     * @throws if the request fails due to network failures, DNS lookup failures, request timeouts, CORS violations, or Invalid URLs
-     *
+     * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,
+     * CORS violations, or Invalid URLs
      * @example
      * ```typescript
      * const response = await client.heal(
@@ -177,9 +203,10 @@ declare class EnsRainbowApiClient implements EnsRainbow.ApiClient {
     /**
      * Get Count of Healable Labels
      *
-     * @returns a `CountResponse` indicating the result and the timestamp of the request and the number of healable labels if successful
-     * @throws if the request fails due to network failures, DNS lookup failures, request timeouts, CORS violations, or Invalid URLs
-     *
+     * @returns a `CountResponse` indicating the result and the timestamp of the request and the
+     * number of healable labels if successful
+     * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,
+     * CORS violations, or Invalid URLs
      * @example
      *
      * const response = await client.count();
@@ -196,8 +223,8 @@ declare class EnsRainbowApiClient implements EnsRainbow.ApiClient {
     count(): Promise<EnsRainbow.CountResponse>;
     /**
      *
-     * Simple verification that the service is running, either in your local setup or for the provided hosted instance
-     *
+     * Simple verification that the service is running, either in your local setup or for the
+     * provided hosted instance.
      * @returns a status of ENS Rainbow service
      * @example
      *
@@ -214,8 +241,8 @@ declare class EnsRainbowApiClient implements EnsRainbow.ApiClient {
      * Get the version information of the ENSRainbow service
      *
      * @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
-     *
+     * @throws if the request fails due to network failures, DNS lookup failures, request
+     * timeouts, CORS violations, or invalid URLs
      * @example
      * ```typescript
      * const response = await client.version();
@@ -224,8 +251,14 @@ declare class EnsRainbowApiClient implements EnsRainbow.ApiClient {
      *
      * // {
      * //   "status": "success",
-     * //   "version": "0.1.0",
-     * //   "schema_version": 2
+     * //   "versionInfo": {
+     * //     "version": "0.1.0",
+     * //     "dbSchemaVersion": 2,
+     * //     "labelSet": {
+     * //       "labelSetId": "subgraph",
+     * //       "labelSetVersion": 0
+     * //     }
+     * //   }
      * // }
      * ```
      */

package/dist/client.js CHANGED Viewed

@@ -1,5 +1,8 @@
 // src/client.ts
 import { LruCache } from "@ensnode/ensnode-sdk";
+import {
+  buildEnsRainbowClientLabelSet
+} from "@ensnode/ensnode-sdk";
 // src/consts.ts
 var DEFAULT_ENSRAINBOW_URL = "https://api.ensrainbow.io";
@@ -17,6 +20,7 @@ var ErrorCode = {
 var EnsRainbowApiClient = class _EnsRainbowApiClient {
   options;
   cache;
+  labelSetSearchParams;
   static DEFAULT_CACHE_CAPACITY = 1e3;
   /**
    * Create default client options.
@@ -26,17 +30,35 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
   static defaultOptions() {
     return {
       endpointUrl: new URL(DEFAULT_ENSRAINBOW_URL),
-      cacheCapacity: _EnsRainbowApiClient.DEFAULT_CACHE_CAPACITY
+      cacheCapacity: _EnsRainbowApiClient.DEFAULT_CACHE_CAPACITY,
+      labelSet: buildEnsRainbowClientLabelSet()
     };
   }
   constructor(options = {}) {
+    const { labelSet: optionsLabelSet, ...rest } = options;
+    const defaultOptions = _EnsRainbowApiClient.defaultOptions();
+    const copiedLabelSet = buildEnsRainbowClientLabelSet(
+      optionsLabelSet?.labelSetId,
+      optionsLabelSet?.labelSetVersion
+    );
     this.options = {
-      ..._EnsRainbowApiClient.defaultOptions(),
-      ...options
+      ...defaultOptions,
+      ...rest,
+      labelSet: copiedLabelSet
     };
     this.cache = new LruCache(
       this.options.cacheCapacity
     );
+    this.labelSetSearchParams = new URLSearchParams();
+    if (this.options.labelSet?.labelSetId !== void 0) {
+      this.labelSetSearchParams.append("label_set_id", this.options.labelSet.labelSetId);
+    }
+    if (this.options.labelSet?.labelSetVersion !== void 0) {
+      this.labelSetSearchParams.append(
+        "label_set_version",
+        this.options.labelSet.labelSetVersion.toString()
+      );
+    }
   }
   /**
    * Attempt to heal a labelHash to its original label.
@@ -50,8 +72,8 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
    *
    * @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
-   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts, CORS violations, or Invalid URLs
-   *
+   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,
+   * CORS violations, or Invalid URLs
    * @example
    * ```typescript
    * const response = await client.heal(
@@ -82,10 +104,12 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
    */
   async heal(labelHash) {
     const cachedResult = this.cache.get(labelHash);
-    if (cachedResult) {
-      return cachedResult;
-    }
-    const response = await fetch(new URL(`/v1/heal/${labelHash}`, this.options.endpointUrl));
+    if (cachedResult) return cachedResult;
+    const url = new URL(`/v1/heal/${labelHash}`, 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);
@@ -95,9 +119,10 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
   /**
    * Get Count of Healable Labels
    *
-   * @returns a `CountResponse` indicating the result and the timestamp of the request and the number of healable labels if successful
-   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts, CORS violations, or Invalid URLs
-   *
+   * @returns a `CountResponse` indicating the result and the timestamp of the request and the
+   * number of healable labels if successful
+   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,
+   * CORS violations, or Invalid URLs
    * @example
    *
    * const response = await client.count();
@@ -117,8 +142,8 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
   }
   /**
    *
-   * Simple verification that the service is running, either in your local setup or for the provided hosted instance
-   *
+   * Simple verification that the service is running, either in your local setup or for the
+   * provided hosted instance.
    * @returns a status of ENS Rainbow service
    * @example
    *
@@ -138,8 +163,8 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
    * Get the version information of the ENSRainbow service
    *
    * @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
-   *
+   * @throws if the request fails due to network failures, DNS lookup failures, request
+   * timeouts, CORS violations, or invalid URLs
    * @example
    * ```typescript
    * const response = await client.version();
@@ -148,8 +173,14 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
    *
    * // {
    * //   "status": "success",
-   * //   "version": "0.1.0",
-   * //   "schema_version": 2
+   * //   "versionInfo": {
+   * //     "version": "0.1.0",
+   * //     "dbSchemaVersion": 2,
+   * //     "labelSet": {
+   * //       "labelSetId": "subgraph",
+   * //       "labelSetVersion": 0
+   * //     }
+   * //   }
    * // }
    * ```
    */
@@ -165,7 +196,8 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
   getOptions() {
     const deepCopy = {
       cacheCapacity: this.options.cacheCapacity,
-      endpointUrl: new URL(this.options.endpointUrl.href)
+      endpointUrl: new URL(this.options.endpointUrl.href),
+      labelSet: this.options.labelSet ? { ...this.options.labelSet } : void 0
     };
     return Object.freeze(deepCopy);
   }

package/dist/client.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/client.ts","../src/consts.ts"],"sourcesContent":["import { type Cache, Label, type LabelHash, LruCache } from \"@ensnode/ensnode-sdk\";\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 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 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 schema version.\n /\n schema_version: number;\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/\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\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 };\n }\n\n constructor(options: Partial<EnsRainbow.ApiClientOptions> = {}) {\n this.options = {\n ...EnsRainbowApiClient.defaultOptions(),\n ...options,\n };\n\n this.cache = new LruCache<LabelHash, EnsRainbow.CacheableHealResponse>(\n this.options.cacheCapacity,\n );\n }\n\n /\n Attempt to 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, CORS violations, or Invalid URLs\n \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\n if (cachedResult) {\n return cachedResult;\n }\n\n const response = await fetch(new URL(`/v1/heal/${labelHash}`, this.options.endpointUrl));\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 number of healable labels if successful\n * @throws if the request fails due to network failures, DNS lookup failures, request timeouts, CORS violations, or Invalid URLs\n \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 provided hosted instance\n \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 timeouts, CORS violations, or Invalid URLs\n \n @example\n * ```typescript\n * const response = await client.version();\n \n console.log(response);\n \n // {\n * // \"status\": \"success\",\n * // \"version\": \"0.1.0\",\n * // \"schema_version\": 2\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 } 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":";AAAA,SAA4C,gBAAgB;;;ACArD,IAAM,yBAAyB;AAE/B,IAAM,aAAa;AAAA,EACxB,SAAS;AAAA,EACT,OAAO;AACT;AAEO,IAAM,YAAY;AAAA,EACvB,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,aAAa;AACf;;;ADgJO,IAAM,sBAAN,MAAM,qBAAoD;AAAA,EAC9C;AAAA,EACA;AAAA,EAEjB,OAAuB,yBAAyB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOhD,OAAO,iBAA8C;AACnD,WAAO;AAAA,MACL,aAAa,IAAI,IAAI,sBAAsB;AAAA,MAC3C,eAAe,qBAAoB;AAAA,IACrC;AAAA,EACF;AAAA,EAEA,YAAY,UAAgD,CAAC,GAAG;AAC9D,SAAK,UAAU;AAAA,MACb,GAAG,qBAAoB,eAAe;AAAA,MACtC,GAAG;AAAA,IACL;AAEA,SAAK,QAAQ,IAAI;AAAA,MACf,KAAK,QAAQ;AAAA,IACf;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA4CA,MAAM,KAAK,WAAwD;AACjE,UAAM,eAAe,KAAK,MAAM,IAAI,SAAS;AAE7C,QAAI,cAAc;AAChB,aAAO;AAAA,IACT;AAEA,UAAM,WAAW,MAAM,MAAM,IAAI,IAAI,YAAY,SAAS,IAAI,KAAK,QAAQ,WAAW,CAAC;AACvF,UAAM,eAAgB,MAAM,SAAS,KAAK;AAE1C,QAAI,wBAAwB,YAAY,GAAG;AACzC,WAAK,MAAM,IAAI,WAAW,YAAY;AAAA,IACxC;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,MAAM,QAA2C;AAC/C,UAAM,WAAW,MAAM,MAAM,IAAI,IAAI,oBAAoB,KAAK,QAAQ,WAAW,CAAC;AAElF,WAAO,SAAS,KAAK;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,MAAM,SAA6C;AACjD,UAAM,WAAW,MAAM,MAAM,IAAI,IAAI,WAAW,KAAK,QAAQ,WAAW,CAAC;AAEzE,WAAO,SAAS,KAAK;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,MAAM,UAA+C;AACnD,UAAM,WAAW,MAAM,MAAM,IAAI,IAAI,eAAe,KAAK,QAAQ,WAAW,CAAC;AAE7E,WAAO,SAAS,KAAK;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAmD;AAEjD,UAAM,WAAW;AAAA,MACf,eAAe,KAAK,QAAQ;AAAA,MAC5B,aAAa,IAAI,IAAI,KAAK,QAAQ,YAAY,IAAI;AAAA,IACpD;AAEA,WAAO,OAAO,OAAO,QAAQ;AAAA,EAC/B;AACF;AAQO,IAAM,cAAc,CACzB,aACqC;AACrC,SAAO,SAAS,WAAW,WAAW;AACxC;AAUO,IAAM,0BAA0B,CACrC,aACiD;AACjD,SAAO,SAAS,WAAW,WAAW,WAAW,SAAS,cAAc,UAAU;AACpF;","names":[]}
1	+ {"version":3,"sources":["../src/client.ts","../src/consts.ts"],"sourcesContent":["import { type Cache, Label, type LabelHash, LruCache } from \"@ensnode/ensnode-sdk\";\nimport {\n type EnsRainbowClientLabelSet,\n type EnsRainbowServerLabelSet,\n buildEnsRainbowClientLabelSet,\n} from \"@ensnode/ensnode-sdk\";\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 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":[]}

package/dist/index.d.ts CHANGED Viewed

@@ -1,5 +1,3 @@
 export { EnsRainbow, EnsRainbowApiClient, EnsRainbowApiClientOptions, isCacheableHealResponse, isHealError } from './client.js';
 export { DEFAULT_ENSRAINBOW_URL, ErrorCode, StatusCode } from './consts.js';
-export { labelHashToBytes } from './labelUtils.js';
-import '@ensnode/ensnode-sdk';
-import 'viem';
+export { EnsRainbowClientLabelSet, EnsRainbowServerLabelSet, LabelSetId, LabelSetVersion, buildEnsRainbowClientLabelSet } from '@ensnode/ensnode-sdk';

package/dist/index.js CHANGED Viewed

@@ -1,5 +1,8 @@
 // src/client.ts
 import { LruCache } from "@ensnode/ensnode-sdk";
+import {
+  buildEnsRainbowClientLabelSet
+} from "@ensnode/ensnode-sdk";
 // src/consts.ts
 var DEFAULT_ENSRAINBOW_URL = "https://api.ensrainbow.io";
@@ -17,6 +20,7 @@ var ErrorCode = {
 var EnsRainbowApiClient = class _EnsRainbowApiClient {
   options;
   cache;
+  labelSetSearchParams;
   static DEFAULT_CACHE_CAPACITY = 1e3;
   /**
    * Create default client options.
@@ -26,17 +30,35 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
   static defaultOptions() {
     return {
       endpointUrl: new URL(DEFAULT_ENSRAINBOW_URL),
-      cacheCapacity: _EnsRainbowApiClient.DEFAULT_CACHE_CAPACITY
+      cacheCapacity: _EnsRainbowApiClient.DEFAULT_CACHE_CAPACITY,
+      labelSet: buildEnsRainbowClientLabelSet()
     };
   }
   constructor(options = {}) {
+    const { labelSet: optionsLabelSet, ...rest } = options;
+    const defaultOptions = _EnsRainbowApiClient.defaultOptions();
+    const copiedLabelSet = buildEnsRainbowClientLabelSet(
+      optionsLabelSet?.labelSetId,
+      optionsLabelSet?.labelSetVersion
+    );
     this.options = {
-      ..._EnsRainbowApiClient.defaultOptions(),
-      ...options
+      ...defaultOptions,
+      ...rest,
+      labelSet: copiedLabelSet
     };
     this.cache = new LruCache(
       this.options.cacheCapacity
     );
+    this.labelSetSearchParams = new URLSearchParams();
+    if (this.options.labelSet?.labelSetId !== void 0) {
+      this.labelSetSearchParams.append("label_set_id", this.options.labelSet.labelSetId);
+    }
+    if (this.options.labelSet?.labelSetVersion !== void 0) {
+      this.labelSetSearchParams.append(
+        "label_set_version",
+        this.options.labelSet.labelSetVersion.toString()
+      );
+    }
   }
   /**
    * Attempt to heal a labelHash to its original label.
@@ -50,8 +72,8 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
    *
    * @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
-   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts, CORS violations, or Invalid URLs
-   *
+   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,
+   * CORS violations, or Invalid URLs
    * @example
    * ```typescript
    * const response = await client.heal(
@@ -82,10 +104,12 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
    */
   async heal(labelHash) {
     const cachedResult = this.cache.get(labelHash);
-    if (cachedResult) {
-      return cachedResult;
-    }
-    const response = await fetch(new URL(`/v1/heal/${labelHash}`, this.options.endpointUrl));
+    if (cachedResult) return cachedResult;
+    const url = new URL(`/v1/heal/${labelHash}`, 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);
@@ -95,9 +119,10 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
   /**
    * Get Count of Healable Labels
    *
-   * @returns a `CountResponse` indicating the result and the timestamp of the request and the number of healable labels if successful
-   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts, CORS violations, or Invalid URLs
-   *
+   * @returns a `CountResponse` indicating the result and the timestamp of the request and the
+   * number of healable labels if successful
+   * @throws if the request fails due to network failures, DNS lookup failures, request timeouts,
+   * CORS violations, or Invalid URLs
    * @example
    *
    * const response = await client.count();
@@ -117,8 +142,8 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
   }
   /**
    *
-   * Simple verification that the service is running, either in your local setup or for the provided hosted instance
-   *
+   * Simple verification that the service is running, either in your local setup or for the
+   * provided hosted instance.
    * @returns a status of ENS Rainbow service
    * @example
    *
@@ -138,8 +163,8 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
    * Get the version information of the ENSRainbow service
    *
    * @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
-   *
+   * @throws if the request fails due to network failures, DNS lookup failures, request
+   * timeouts, CORS violations, or invalid URLs
    * @example
    * ```typescript
    * const response = await client.version();
@@ -148,8 +173,14 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
    *
    * // {
    * //   "status": "success",
-   * //   "version": "0.1.0",
-   * //   "schema_version": 2
+   * //   "versionInfo": {
+   * //     "version": "0.1.0",
+   * //     "dbSchemaVersion": 2,
+   * //     "labelSet": {
+   * //       "labelSetId": "subgraph",
+   * //       "labelSetVersion": 0
+   * //     }
+   * //   }
    * // }
    * ```
    */
@@ -165,7 +196,8 @@ var EnsRainbowApiClient = class _EnsRainbowApiClient {
   getOptions() {
     const deepCopy = {
       cacheCapacity: this.options.cacheCapacity,
-      endpointUrl: new URL(this.options.endpointUrl.href)
+      endpointUrl: new URL(this.options.endpointUrl.href),
+      labelSet: this.options.labelSet ? { ...this.options.labelSet } : void 0
     };
     return Object.freeze(deepCopy);
   }
@@ -177,38 +209,15 @@ var isCacheableHealResponse = (response) => {
   return response.status === StatusCode.Success || response.errorCode !== ErrorCode.ServerError;
 };
-// src/label-utils.ts
-import { hexToBytes } from "viem";
-function labelHashToBytes(labelHash) {
-  try {
-    if (labelHash.length !== 66) {
-      throw new Error(`Invalid labelHash length ${labelHash.length} characters (expected 66)`);
-    }
-    if (labelHash !== labelHash.toLowerCase()) {
-      throw new Error("Labelhash must be in lowercase");
-    }
-    if (!labelHash.startsWith("0x")) {
-      throw new Error("Labelhash must be 0x-prefixed");
-    }
-    const bytes = hexToBytes(labelHash);
-    if (bytes.length !== 32) {
-      throw new Error(`Invalid labelHash length ${bytes.length} bytes (expected 32)`);
-    }
-    return bytes;
-  } catch (e) {
-    if (e instanceof Error) {
-      throw e;
-    }
-    throw new Error("Invalid hex format");
-  }
-}
+// src/index.ts
+import { buildEnsRainbowClientLabelSet as buildEnsRainbowClientLabelSet2 } from "@ensnode/ensnode-sdk";
 export {
   DEFAULT_ENSRAINBOW_URL,
   EnsRainbowApiClient,
   ErrorCode,
   StatusCode,
+  buildEnsRainbowClientLabelSet2 as buildEnsRainbowClientLabelSet,
   isCacheableHealResponse,
-  isHealError,
-  labelHashToBytes
+  isHealError
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/client.ts","../src/consts.ts","../src/label-utils.ts"],"sourcesContent":["import { type Cache, Label, type LabelHash, LruCache } from \"@ensnode/ensnode-sdk\";\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 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 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 schema version.\n /\n schema_version: number;\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/\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\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 };\n }\n\n constructor(options: Partial<EnsRainbow.ApiClientOptions> = {}) {\n this.options = {\n ...EnsRainbowApiClient.defaultOptions(),\n ...options,\n };\n\n this.cache = new LruCache<LabelHash, EnsRainbow.CacheableHealResponse>(\n this.options.cacheCapacity,\n );\n }\n\n /\n Attempt to 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, CORS violations, or Invalid URLs\n \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\n if (cachedResult) {\n return cachedResult;\n }\n\n const response = await fetch(new URL(`/v1/heal/${labelHash}`, this.options.endpointUrl));\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 number of healable labels if successful\n * @throws if the request fails due to network failures, DNS lookup failures, request timeouts, CORS violations, or Invalid URLs\n \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 provided hosted instance\n \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 timeouts, CORS violations, or Invalid URLs\n \n @example\n * ```typescript\n * const response = await client.version();\n \n console.log(response);\n \n // {\n * // \"status\": \"success\",\n * // \"version\": \"0.1.0\",\n * // \"schema_version\": 2\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 } 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","import type { LabelHash } from \"@ensnode/ensnode-sdk\";\nimport { ByteArray, hexToBytes } from \"viem\";\n\n/\n Converts a Labelhash to bytes, with validation\n * @param labelHash The Labelhash to convert\n * @returns A ByteArray containing the bytes\n * @throws Error if `labelHash` is not a valid 32-byte hex string\n */\nexport function labelHashToBytes(labelHash: LabelHash): ByteArray {\n try {\n if (labelHash.length !== 66) {\n throw new Error(`Invalid labelHash length ${labelHash.length} characters (expected 66)`);\n }\n if (labelHash !== labelHash.toLowerCase()) {\n throw new Error(\"Labelhash must be in lowercase\");\n }\n if (!labelHash.startsWith(\"0x\")) {\n throw new Error(\"Labelhash must be 0x-prefixed\");\n }\n const bytes = hexToBytes(labelHash);\n if (bytes.length !== 32) {\n // should be redundant but keeping it for the principle of defensive programming\n throw new Error(`Invalid labelHash length ${bytes.length} bytes (expected 32)`);\n }\n return bytes;\n } catch (e) {\n if (e instanceof Error) {\n throw e;\n }\n throw new Error(\"Invalid hex format\");\n }\n}\n"],"mappings":"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","names":[]}
1	+ {"version":3,"sources":["../src/client.ts","../src/consts.ts","../src/index.ts"],"sourcesContent":["import { type Cache, Label, type LabelHash, LruCache } from \"@ensnode/ensnode-sdk\";\nimport {\n type EnsRainbowClientLabelSet,\n type EnsRainbowServerLabelSet,\n buildEnsRainbowClientLabelSet,\n} from \"@ensnode/ensnode-sdk\";\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 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","export from \"./client\";\nexport * from \"./consts\";\n\n// 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\n// Re-export utility functions and classes from ensnode-sdk that are needed by consumers\nexport { buildEnsRainbowClientLabelSet } from \"@ensnode/ensnode-sdk\";\n"],"mappings":"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","names":["buildEnsRainbowClientLabelSet"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ensnode/ensrainbow-sdk",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "type": "module",
   "description": "ENSRainbow SDK for interacting with the ENSRainbow API.",
   "license": "MIT",
@@ -30,10 +30,6 @@
     "./consts": {
       "types": "./dist/consts.d.ts",
       "default": "./dist/consts.js"
-    },
-    "./label-utils": {
-      "types": "./dist/label-utils.d.ts",
-      "default": "./dist/label-utils.js"
     }
   },
   "publishConfig": {
@@ -47,14 +43,14 @@
     "tsup": "^8.3.6",
     "typescript": "^5.7.3",
     "vitest": "^3.1.1",
-    "@ensnode/shared-configs": "0.33.0",
-    "@ensnode/ensnode-sdk": "0.33.0"
+    "@ensnode/shared-configs": "0.34.0",
+    "@ensnode/ensnode-sdk": "0.34.0"
   },
   "scripts": {
     "prepublish": "tsup",
     "test": "vitest",
     "typecheck": "tsc --noEmit",
-    "lint": "biome check --write",
+    "lint": "biome check --write .",
     "lint:ci": "biome ci"
   },
   "main": "./dist/index.js",

package/dist/label-utils.d.ts DELETED Viewed

@@ -1,3 +0,0 @@
-import '@ensnode/ensnode-sdk';
-import 'viem';
-export { labelHashToBytes } from './labelUtils.js';

package/dist/label-utils.js DELETED Viewed

@@ -1,29 +0,0 @@
-// src/label-utils.ts
-import { hexToBytes } from "viem";
-function labelHashToBytes(labelHash) {
-  try {
-    if (labelHash.length !== 66) {
-      throw new Error(`Invalid labelHash length ${labelHash.length} characters (expected 66)`);
-    }
-    if (labelHash !== labelHash.toLowerCase()) {
-      throw new Error("Labelhash must be in lowercase");
-    }
-    if (!labelHash.startsWith("0x")) {
-      throw new Error("Labelhash must be 0x-prefixed");
-    }
-    const bytes = hexToBytes(labelHash);
-    if (bytes.length !== 32) {
-      throw new Error(`Invalid labelHash length ${bytes.length} bytes (expected 32)`);
-    }
-    return bytes;
-  } catch (e) {
-    if (e instanceof Error) {
-      throw e;
-    }
-    throw new Error("Invalid hex format");
-  }
-}
-export {
-  labelHashToBytes
-};
-//# sourceMappingURL=label-utils.js.map

package/dist/label-utils.js.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"sources":["../src/label-utils.ts"],"sourcesContent":["import type { LabelHash } from \"@ensnode/ensnode-sdk\";\nimport { ByteArray, hexToBytes } from \"viem\";\n\n/**\n * Converts a Labelhash to bytes, with validation\n * @param labelHash The Labelhash to convert\n * @returns A ByteArray containing the bytes\n * @throws Error if `labelHash` is not a valid 32-byte hex string\n */\nexport function labelHashToBytes(labelHash: LabelHash): ByteArray {\n try {\n if (labelHash.length !== 66) {\n throw new Error(`Invalid labelHash length ${labelHash.length} characters (expected 66)`);\n }\n if (labelHash !== labelHash.toLowerCase()) {\n throw new Error(\"Labelhash must be in lowercase\");\n }\n if (!labelHash.startsWith(\"0x\")) {\n throw new Error(\"Labelhash must be 0x-prefixed\");\n }\n const bytes = hexToBytes(labelHash);\n if (bytes.length !== 32) {\n // should be redundant but keeping it for the principle of defensive programming\n throw new Error(`Invalid labelHash length ${bytes.length} bytes (expected 32)`);\n }\n return bytes;\n } catch (e) {\n if (e instanceof Error) {\n throw e;\n }\n throw new Error(\"Invalid hex format\");\n }\n}\n"],"mappings":";AACA,SAAoB,kBAAkB;AAQ/B,SAAS,iBAAiB,WAAiC;AAChE,MAAI;AACF,QAAI,UAAU,WAAW,IAAI;AAC3B,YAAM,IAAI,MAAM,4BAA4B,UAAU,MAAM,2BAA2B;AAAA,IACzF;AACA,QAAI,cAAc,UAAU,YAAY,GAAG;AACzC,YAAM,IAAI,MAAM,gCAAgC;AAAA,IAClD;AACA,QAAI,CAAC,UAAU,WAAW,IAAI,GAAG;AAC/B,YAAM,IAAI,MAAM,+BAA+B;AAAA,IACjD;AACA,UAAM,QAAQ,WAAW,SAAS;AAClC,QAAI,MAAM,WAAW,IAAI;AAEvB,YAAM,IAAI,MAAM,4BAA4B,MAAM,MAAM,sBAAsB;AAAA,IAChF;AACA,WAAO;AAAA,EACT,SAAS,GAAG;AACV,QAAI,aAAa,OAAO;AACtB,YAAM;AAAA,IACR;AACA,UAAM,IAAI,MAAM,oBAAoB;AAAA,EACtC;AACF;","names":[]}

package/dist/labelUtils.d.ts DELETED Viewed

@@ -1,12 +0,0 @@
-import { LabelHash } from '@ensnode/ensnode-sdk';
-import { ByteArray } from 'viem';
-/**
- * Converts a Labelhash to bytes, with validation
- * @param labelHash The Labelhash to convert
- * @returns A ByteArray containing the bytes
- * @throws Error if `labelHash` is not a valid 32-byte hex string
- */
-declare function labelHashToBytes(labelHash: LabelHash): ByteArray;
-export { labelHashToBytes };

package/dist/labelUtils.js DELETED Viewed

@@ -1,29 +0,0 @@
-// src/label-utils.ts
-import { hexToBytes } from "viem";
-function labelHashToBytes(labelHash) {
-  try {
-    if (labelHash.length !== 66) {
-      throw new Error(`Invalid labelHash length ${labelHash.length} characters (expected 66)`);
-    }
-    if (labelHash !== labelHash.toLowerCase()) {
-      throw new Error("Labelhash must be in lowercase");
-    }
-    if (!labelHash.startsWith("0x")) {
-      throw new Error("Labelhash must be 0x-prefixed");
-    }
-    const bytes = hexToBytes(labelHash);
-    if (bytes.length !== 32) {
-      throw new Error(`Invalid labelHash length ${bytes.length} bytes (expected 32)`);
-    }
-    return bytes;
-  } catch (e) {
-    if (e instanceof Error) {
-      throw e;
-    }
-    throw new Error("Invalid hex format");
-  }
-}
-export {
-  labelHashToBytes
-};
-//# sourceMappingURL=labelUtils.js.map

package/dist/labelUtils.js.map DELETED Viewed

@@ -1 +0,0 @@