@ensnode/ensnode-react 0.34.0 → 0.35.0

package/README.md

@@ -155,6 +155,8 @@ const config = createConfig({
 
 Hook that resolves records for an ENS name (Forward Resolution), via ENSNode, which implements Protocol Acceleration for indexed names.
 
+The returned `name` field, if set, is guaranteed to be a normalized name. If the name record returned by the resolver is not normalized, `null` is returned as if no name record was set.
+
 #### Parameters
 
 - `name`: The ENS Name whose records to resolve
@@ -181,6 +183,8 @@ const { data, isLoading, error, refetch } = useRecords({
 
 Hook that resolves the primary name of the provided `address` on the specified `chainId`, via ENSNode, which implements Protocol Acceleration for indexed names. If the `address` specifies a valid [ENSIP-19 Default Name](https://docs.ens.domains/ensip/19/#default-primary-name), the Default Name will be returned. You _may_ query the Default EVM Chain Id (`0`) in order to determine the `address`'s Default Name directly.
 
+The returned Primary Name, if set, is guaranteed to be a [Normalized Name](https://ensnode.io/docs/reference/terminology#normalized-name). If the primary name set for the address is not normalized, `null` is returned as if no primary name was set.
+
 #### Parameters
 
 - `address`: The Address whose Primary Name to resolve
@@ -202,6 +206,8 @@ const { data, isLoading, error, refetch } = usePrimaryName({
 
 Hook that resolves the primary names of the provided `address` on the specified chainIds, via ENSNode, which implements Protocol Acceleration for indexed names. If the `address` specifies a valid [ENSIP-19 Default Name](https://docs.ens.domains/ensip/19/#default-primary-name), the Default Name will be returned for all chainIds for which there is not a chain-specific Primary Name. To avoid misuse, you _may not_ query the Default EVM Chain Id (`0`) directly, and should rely on the aforementioned per-chain defaulting behavior.
 
+Each returned Primary Name, if set, is guaranteed to be a [Normalized Name](https://ensnode.io/docs/reference/terminology#normalized-name). If the primary name set for the address on any chain is not normalized, `null` is returned for that chain as if no primary name was set.
+
 #### Parameters
 
 - `address`: The Address whose Primary Names to resolve

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/context.ts","../src/hooks/useENSNodeConfig.ts","../src/hooks/useRecords.ts","../src/utils/query.ts","../src/hooks/usePrimaryName.ts","../src/hooks/usePrimaryNames.ts","../src/hooks/useENSIndexerConfig.ts","../src/hooks/useIndexingStatus.ts"],"sourcesContent":["export type { QueryClient } from \"@tanstack/react-query\";\n\nexport type { ResolverRecordsSelection } from \"@ensnode/ensnode-sdk\";\n\nexport * from \"./provider\";\nexport * from \"./context\";\nexport * from \"./hooks\";\nexport * from \"./types\";\n","\"use client\";\n\nimport { ENSNodeClient } from \"@ensnode/ensnode-sdk\";\nimport { QueryClient, QueryClientProvider, useQueryClient } from \"@tanstack/react-query\";\nimport { createElement, useMemo } from \"react\";\n\nimport { ENSNodeContext } from \"./context\";\nimport type { ENSNodeConfig } from \"./types\";\n\nexport interface ENSNodeProviderProps {\n  /** ENSNode configuration */\n  config: ENSNodeConfig;\n\n  /**\n   * Optional QueryClient instance. If provided, you must wrap your app with QueryClientProvider yourself.\n   * If not provided, ENSNodeProvider will create and manage its own QueryClient internally.\n   */\n  queryClient?: QueryClient;\n\n  /**\n   * Custom query client options when auto-creating a QueryClient.\n   * Only used when queryClient is not provided.\n   */\n  queryClientOptions?: ConstructorParameters<typeof QueryClient>[0];\n}\n\nfunction ENSNodeInternalProvider({\n  children,\n  config,\n}: {\n  children: React.ReactNode;\n  config: ENSNodeConfig;\n}) {\n  // Memoize the config to prevent unnecessary re-renders\n  const memoizedConfig = useMemo(() => config, [config]);\n\n  return createElement(ENSNodeContext.Provider, { value: memoizedConfig }, children);\n}\n\nexport function ENSNodeProvider(parameters: React.PropsWithChildren<ENSNodeProviderProps>) {\n  const { children, config, queryClient, queryClientOptions } = parameters;\n\n  // Check if we're already inside a QueryClientProvider\n  let hasExistingQueryClient = false;\n  try {\n    hasExistingQueryClient = Boolean(useQueryClient());\n  } catch {\n    // useQueryClient throws if not inside a QueryClientProvider\n    hasExistingQueryClient = false;\n  }\n\n  // If user provided a queryClient, they must handle QueryClientProvider themselves\n  if (queryClient) {\n    if (!hasExistingQueryClient) {\n      throw new Error(\n        \"When providing a custom queryClient, you must wrap your app with QueryClientProvider. \" +\n          \"Either remove the queryClient prop to use auto-managed setup, or wrap with QueryClientProvider.\",\n      );\n    }\n    return createElement(ENSNodeInternalProvider, { config, children });\n  }\n\n  // If already inside a QueryClientProvider, just use that\n  if (hasExistingQueryClient) {\n    return createElement(ENSNodeInternalProvider, { config, children });\n  }\n\n  // Create our own QueryClient and QueryClientProvider\n  const defaultQueryClient = useMemo(\n    () =>\n      new QueryClient({\n        defaultOptions: {\n          queries: {\n            retry: 3,\n            staleTime: 1000 * 60 * 5, // 5 minutes\n            gcTime: 1000 * 60 * 30, // 30 minutes\n          },\n        },\n        ...queryClientOptions,\n      }),\n    [queryClientOptions],\n  );\n\n  return createElement(\n    QueryClientProvider,\n    { client: defaultQueryClient },\n    createElement(ENSNodeInternalProvider, { config, children }),\n  );\n}\n\n/**\n * Helper function to create ENSNode configuration\n */\nexport function createConfig(options?: {\n  url?: string | URL;\n}): ENSNodeConfig {\n  const url = options?.url ? new URL(options.url) : ENSNodeClient.defaultOptions().url;\n\n  return {\n    client: {\n      ...ENSNodeClient.defaultOptions(),\n      url,\n    },\n  };\n}\n","import { createContext } from \"react\";\n\nimport type { ENSNodeConfig } from \"./types\";\n\n/**\n * React context for ENSNode configuration\n */\nexport const ENSNodeContext = createContext<ENSNodeConfig | undefined>(undefined);\n\n/**\n * Display name for debugging\n */\nENSNodeContext.displayName = \"ENSNodeContext\";\n","\"use client\";\n\nimport { useContext } from \"react\";\nimport { ENSNodeContext } from \"../context\";\nimport type { ENSNodeConfig } from \"../types\";\n\n/**\n * Hook to access the ENSNode configuration from context or parameters\n *\n * @param parameters - Optional config parameter that overrides context\n * @returns The ENSNode configuration\n * @throws Error if no config is available in context or parameters\n */\nexport function useENSNodeConfig<TConfig extends ENSNodeConfig = ENSNodeConfig>(\n  config: TConfig | undefined,\n): TConfig {\n  const contextConfig = useContext(ENSNodeContext);\n\n  // Use provided config or fall back to context\n  const resolvedConfig = config ?? contextConfig;\n\n  if (!resolvedConfig) {\n    throw new Error(\n      \"useENSNodeConfig must be used within an ENSNodeProvider or you must pass a config parameter\",\n    );\n  }\n\n  return resolvedConfig as TConfig;\n}\n","\"use client\";\n\nimport type { ResolverRecordsSelection } from \"@ensnode/ensnode-sdk\";\nimport { useQuery } from \"@tanstack/react-query\";\n\nimport type { ConfigParameter, UseRecordsParameters } from \"../types\";\nimport { createRecordsQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\n/**\n * Resolves records for an ENS name (Forward Resolution).\n *\n * @param parameters - Configuration for the ENS name resolution\n * @returns Query result with resolved records\n *\n * @example\n * ```typescript\n * import { useRecords } from \"@ensnode/ensnode-react\";\n *\n * function DisplayNameRecords() {\n *   const { data, isLoading, error } = useRecords({\n *     name: \"jesse.base.eth\",\n *     selection: {\n *       addresses: [60], // ETH CoinType\n *       texts: [\"avatar\", \"com.twitter\"]\n *     }\n *   });\n *\n *   if (isLoading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       <h3>Resolved Records for vitalik.eth</h3>\n *       {data.records.addresses && (\n *         <p>ETH Address: {data.records.addresses[60]}</p>\n *       )}\n *       {data.records.texts && (\n *         <div>\n *           <p>Avatar: {data.records.texts.avatar}</p>\n *           <p>Twitter: {data.records.texts[\"com.twitter\"]}</p>\n *         </div>\n *       )}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useRecords<SELECTION extends ResolverRecordsSelection>(\n  parameters: UseRecordsParameters<SELECTION> & ConfigParameter,\n) {\n  const { config, query = {}, name, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const canEnable = name !== null;\n\n  const queryOptions = canEnable\n    ? createRecordsQueryOptions(_config, { ...args, name })\n    : { enabled: false, queryKey: [\"disabled\"] as const };\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: canEnable && (query.enabled ?? queryOptions.enabled),\n  };\n\n  return useQuery(options);\n}\n","\"use client\";\n\nimport {\n  ENSNodeClient,\n  IndexingStatusRequest,\n  ResolvePrimaryNameRequest,\n  ResolvePrimaryNamesRequest,\n  ResolveRecordsRequest,\n  ResolverRecordsSelection,\n} from \"@ensnode/ensnode-sdk\";\nimport type { ENSNodeConfig } from \"../types\";\n\n/**\n * Query keys for hooks. Simply keys by path and arguments.\n */\nexport const queryKeys = {\n  base: (url: string) => [\"ensnode\", url] as const,\n\n  resolve: (url: string) => [...queryKeys.base(url), \"resolve\"] as const,\n\n  records: (url: string, args: ResolveRecordsRequest<any>) =>\n    [...queryKeys.resolve(url), \"records\", args] as const,\n\n  primaryName: (url: string, args: ResolvePrimaryNameRequest) =>\n    [...queryKeys.resolve(url), \"primary-name\", args] as const,\n\n  primaryNames: (url: string, args: ResolvePrimaryNamesRequest) =>\n    [...queryKeys.resolve(url), \"primary-names\", args] as const,\n\n  config: (url: string) => [...queryKeys.base(url), \"config\"] as const,\n\n  indexingStatus: (url: string, args: IndexingStatusRequest) =>\n    [...queryKeys.base(url), \"config\", args] as const,\n};\n\n/**\n * Creates query options for Records Resolution\n */\nexport function createRecordsQueryOptions<SELECTION extends ResolverRecordsSelection>(\n  config: ENSNodeConfig,\n  args: ResolveRecordsRequest<SELECTION>,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.records(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.resolveRecords(args.name, args.selection, args);\n    },\n  };\n}\n\n/**\n * Creates query options for Primary Name Resolution\n */\nexport function createPrimaryNameQueryOptions(\n  config: ENSNodeConfig,\n  args: ResolvePrimaryNameRequest,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.primaryName(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.resolvePrimaryName(args.address, args.chainId, args);\n    },\n  };\n}\n\n/**\n * Creates query options for Primary Name Resolution\n */\nexport function createPrimaryNamesQueryOptions(\n  config: ENSNodeConfig,\n  args: ResolvePrimaryNamesRequest,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.primaryNames(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.resolvePrimaryNames(args.address, args);\n    },\n  };\n}\n\n/**\n * Creates query options for ENSIndexer Config API\n */\nexport function createENSIndexerConfigQueryOptions(config: ENSNodeConfig) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.config(config.client.url.href),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.config();\n    },\n  };\n}\n\n/**\n * Creates query options for ENSIndexer Indexing Status API\n */\nexport function createIndexingStatusQueryOptions(\n  config: ENSNodeConfig,\n  args: IndexingStatusRequest,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.indexingStatus(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.indexingStatus(args);\n    },\n  };\n}\n","\"use client\";\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { ConfigParameter, UsePrimaryNameParameters } from \"../types\";\nimport { createPrimaryNameQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\n/**\n * Resolves the primary name of a specified address (Reverse Resolution).\n *\n * @param parameters - Configuration for the address resolution\n * @returns Query result with resolved primary name\n *\n * @example\n * ```typescript\n * import { usePrimaryName } from \"@ensnode/ensnode-react\";\n *\n * function DisplayPrimaryNameAndAvatar() {\n *   const { data, isLoading, error } = usePrimaryName({\n *     address: \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\n *     chainId: 1, // Ethereum Mainnet\n *   });\n *\n *   if (isLoading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       <h3>Primary Name (for Mainnet)</h3>\n *       <p>{data.name ?? \"No Primary Name\"}</p>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function usePrimaryName(parameters: UsePrimaryNameParameters & ConfigParameter) {\n  const { config, query = {}, address, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const canEnable = address !== null;\n\n  const queryOptions = canEnable\n    ? createPrimaryNameQueryOptions(_config, { ...args, address })\n    : { enabled: false, queryKey: [\"disabled\"] as const };\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: canEnable && (query.enabled ?? queryOptions.enabled),\n  };\n\n  return useQuery(options);\n}\n","\"use client\";\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { ConfigParameter, UsePrimaryNamesParameters } from \"../types\";\nimport { createPrimaryNamesQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\n/**\n * Resolves the primary names of a specified address across multiple chains.\n *\n * @param parameters - Configuration for the address resolution\n * @returns Query result with resolved primary names\n *\n * @example\n * ```typescript\n * import { usePrimaryNames } from \"@ensnode/ensnode-react\";\n *\n * function DisplayPrimaryNames() {\n *   const { data, isLoading, error } = usePrimaryNames({\n *     address: \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\n *   });\n *\n *   if (isLoading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       {Object.entries(data.names).map(([chainId, name]) => (\n *         <div key={chainId}>\n *           <h3>Primary Name (Chain Id: {chainId})</h3>\n *           <p>{name}</p>\n *         </div>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function usePrimaryNames(parameters: UsePrimaryNamesParameters & ConfigParameter) {\n  const { config, query = {}, address, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const canEnable = address !== null;\n\n  const queryOptions = canEnable\n    ? createPrimaryNamesQueryOptions(_config, { ...args, address })\n    : { enabled: false, queryKey: [\"disabled\"] as const };\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: canEnable && (query.enabled ?? queryOptions.enabled),\n  };\n\n  return useQuery(options);\n}\n","import { ConfigResponse } from \"@ensnode/ensnode-sdk\";\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport { ConfigParameter, QueryParameter } from \"../types\";\nimport { createENSIndexerConfigQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\ntype UseENSIndexerConfigParameters = QueryParameter<ConfigResponse>;\n\nexport function useENSIndexerConfig(\n  parameters: ConfigParameter & UseENSIndexerConfigParameters = {},\n) {\n  const { config, query = {} } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const queryOptions = createENSIndexerConfigQueryOptions(_config);\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: query.enabled ?? queryOptions.enabled,\n  };\n\n  return useQuery(options);\n}\n","import { IndexingStatusRequest, IndexingStatusResponse } from \"@ensnode/ensnode-sdk\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { ConfigParameter, QueryParameter } from \"../types\";\nimport { createIndexingStatusQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\ninterface UseIndexingStatusParameters\n  extends IndexingStatusRequest,\n    QueryParameter<IndexingStatusResponse> {}\n\nexport function useIndexingStatus(parameters: ConfigParameter & UseIndexingStatusParameters = {}) {\n  const { config, query = {}, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const queryOptions = createIndexingStatusQueryOptions(_config, { ...args });\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: query.enabled ?? queryOptions.enabled,\n  };\n\n  return useQuery(options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,yBAA8B;AAC9B,yBAAiE;AACjE,IAAAA,gBAAuC;;;ACJvC,mBAA8B;AAOvB,IAAM,qBAAiB,4BAAyC,MAAS;AAKhF,eAAe,cAAc;;;ADc7B,SAAS,wBAAwB;AAAA,EAC/B;AAAA,EACA;AACF,GAGG;AAED,QAAM,qBAAiB,uBAAQ,MAAM,QAAQ,CAAC,MAAM,CAAC;AAErD,aAAO,6BAAc,eAAe,UAAU,EAAE,OAAO,eAAe,GAAG,QAAQ;AACnF;AAEO,SAAS,gBAAgB,YAA2D;AACzF,QAAM,EAAE,UAAU,QAAQ,aAAa,mBAAmB,IAAI;AAG9D,MAAI,yBAAyB;AAC7B,MAAI;AACF,6BAAyB,YAAQ,mCAAe,CAAC;AAAA,EACnD,QAAQ;AAEN,6BAAyB;AAAA,EAC3B;AAGA,MAAI,aAAa;AACf,QAAI,CAAC,wBAAwB;AAC3B,YAAM,IAAI;AAAA,QACR;AAAA,MAEF;AAAA,IACF;AACA,eAAO,6BAAc,yBAAyB,EAAE,QAAQ,SAAS,CAAC;AAAA,EACpE;AAGA,MAAI,wBAAwB;AAC1B,eAAO,6BAAc,yBAAyB,EAAE,QAAQ,SAAS,CAAC;AAAA,EACpE;AAGA,QAAM,yBAAqB;AAAA,IACzB,MACE,IAAI,+BAAY;AAAA,MACd,gBAAgB;AAAA,QACd,SAAS;AAAA,UACP,OAAO;AAAA,UACP,WAAW,MAAO,KAAK;AAAA;AAAA,UACvB,QAAQ,MAAO,KAAK;AAAA;AAAA,QACtB;AAAA,MACF;AAAA,MACA,GAAG;AAAA,IACL,CAAC;AAAA,IACH,CAAC,kBAAkB;AAAA,EACrB;AAEA,aAAO;AAAA,IACL;AAAA,IACA,EAAE,QAAQ,mBAAmB;AAAA,QAC7B,6BAAc,yBAAyB,EAAE,QAAQ,SAAS,CAAC;AAAA,EAC7D;AACF;AAKO,SAAS,aAAa,SAEX;AAChB,QAAM,MAAM,SAAS,MAAM,IAAI,IAAI,QAAQ,GAAG,IAAI,iCAAc,eAAe,EAAE;AAEjF,SAAO;AAAA,IACL,QAAQ;AAAA,MACN,GAAG,iCAAc,eAAe;AAAA,MAChC;AAAA,IACF;AAAA,EACF;AACF;;;AEtGA,IAAAC,gBAA2B;AAWpB,SAAS,iBACd,QACS;AACT,QAAM,oBAAgB,0BAAW,cAAc;AAG/C,QAAM,iBAAiB,UAAU;AAEjC,MAAI,CAAC,gBAAgB;AACnB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;;;ACzBA,IAAAC,sBAAyB;;;ACDzB,IAAAC,sBAOO;AAMA,IAAM,YAAY;AAAA,EACvB,MAAM,CAAC,QAAgB,CAAC,WAAW,GAAG;AAAA,EAEtC,SAAS,CAAC,QAAgB,CAAC,GAAG,UAAU,KAAK,GAAG,GAAG,SAAS;AAAA,EAE5D,SAAS,CAAC,KAAa,SACrB,CAAC,GAAG,UAAU,QAAQ,GAAG,GAAG,WAAW,IAAI;AAAA,EAE7C,aAAa,CAAC,KAAa,SACzB,CAAC,GAAG,UAAU,QAAQ,GAAG,GAAG,gBAAgB,IAAI;AAAA,EAElD,cAAc,CAAC,KAAa,SAC1B,CAAC,GAAG,UAAU,QAAQ,GAAG,GAAG,iBAAiB,IAAI;AAAA,EAEnD,QAAQ,CAAC,QAAgB,CAAC,GAAG,UAAU,KAAK,GAAG,GAAG,QAAQ;AAAA,EAE1D,gBAAgB,CAAC,KAAa,SAC5B,CAAC,GAAG,UAAU,KAAK,GAAG,GAAG,UAAU,IAAI;AAC3C;AAKO,SAAS,0BACd,QACA,MACA;AACA,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU,UAAU,QAAQ,OAAO,OAAO,IAAI,MAAM,IAAI;AAAA,IACxD,SAAS,YAAY;AACnB,YAAM,SAAS,IAAI,kCAAc,OAAO,MAAM;AAC9C,aAAO,OAAO,eAAe,KAAK,MAAM,KAAK,WAAW,IAAI;AAAA,IAC9D;AAAA,EACF;AACF;AAKO,SAAS,8BACd,QACA,MACA;AACA,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU,UAAU,YAAY,OAAO,OAAO,IAAI,MAAM,IAAI;AAAA,IAC5D,SAAS,YAAY;AACnB,YAAM,SAAS,IAAI,kCAAc,OAAO,MAAM;AAC9C,aAAO,OAAO,mBAAmB,KAAK,SAAS,KAAK,SAAS,IAAI;AAAA,IACnE;AAAA,EACF;AACF;AAKO,SAAS,+BACd,QACA,MACA;AACA,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU,UAAU,aAAa,OAAO,OAAO,IAAI,MAAM,IAAI;AAAA,IAC7D,SAAS,YAAY;AACnB,YAAM,SAAS,IAAI,kCAAc,OAAO,MAAM;AAC9C,aAAO,OAAO,oBAAoB,KAAK,SAAS,IAAI;AAAA,IACtD;AAAA,EACF;AACF;AAKO,SAAS,mCAAmC,QAAuB;AACxE,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU,UAAU,OAAO,OAAO,OAAO,IAAI,IAAI;AAAA,IACjD,SAAS,YAAY;AACnB,YAAM,SAAS,IAAI,kCAAc,OAAO,MAAM;AAC9C,aAAO,OAAO,OAAO;AAAA,IACvB;AAAA,EACF;AACF;AAKO,SAAS,iCACd,QACA,MACA;AACA,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU,UAAU,eAAe,OAAO,OAAO,IAAI,MAAM,IAAI;AAAA,IAC/D,SAAS,YAAY;AACnB,YAAM,SAAS,IAAI,kCAAc,OAAO,MAAM;AAC9C,aAAO,OAAO,eAAe,IAAI;AAAA,IACnC;AAAA,EACF;AACF;;;ADnEO,SAAS,WACd,YACA;AACA,QAAM,EAAE,QAAQ,QAAQ,CAAC,GAAG,MAAM,GAAG,KAAK,IAAI;AAC9C,QAAM,UAAU,iBAAiB,MAAM;AAEvC,QAAM,YAAY,SAAS;AAE3B,QAAM,eAAe,YACjB,0BAA0B,SAAS,EAAE,GAAG,MAAM,KAAK,CAAC,IACpD,EAAE,SAAS,OAAO,UAAU,CAAC,UAAU,EAAW;AAEtD,QAAM,UAAU;AAAA,IACd,GAAG;AAAA,IACH,GAAG;AAAA,IACH,SAAS,cAAc,MAAM,WAAW,aAAa;AAAA,EACvD;AAEA,aAAO,8BAAS,OAAO;AACzB;;;AEjEA,IAAAC,sBAAyB;AAiClB,SAAS,eAAe,YAAwD;AACrF,QAAM,EAAE,QAAQ,QAAQ,CAAC,GAAG,SAAS,GAAG,KAAK,IAAI;AACjD,QAAM,UAAU,iBAAiB,MAAM;AAEvC,QAAM,YAAY,YAAY;AAE9B,QAAM,eAAe,YACjB,8BAA8B,SAAS,EAAE,GAAG,MAAM,QAAQ,CAAC,IAC3D,EAAE,SAAS,OAAO,UAAU,CAAC,UAAU,EAAW;AAEtD,QAAM,UAAU;AAAA,IACd,GAAG;AAAA,IACH,GAAG;AAAA,IACH,SAAS,cAAc,MAAM,WAAW,aAAa;AAAA,EACvD;AAEA,aAAO,8BAAS,OAAO;AACzB;;;AClDA,IAAAC,sBAAyB;AAoClB,SAAS,gBAAgB,YAAyD;AACvF,QAAM,EAAE,QAAQ,QAAQ,CAAC,GAAG,SAAS,GAAG,KAAK,IAAI;AACjD,QAAM,UAAU,iBAAiB,MAAM;AAEvC,QAAM,YAAY,YAAY;AAE9B,QAAM,eAAe,YACjB,+BAA+B,SAAS,EAAE,GAAG,MAAM,QAAQ,CAAC,IAC5D,EAAE,SAAS,OAAO,UAAU,CAAC,UAAU,EAAW;AAEtD,QAAM,UAAU;AAAA,IACd,GAAG;AAAA,IACH,GAAG;AAAA,IACH,SAAS,cAAc,MAAM,WAAW,aAAa;AAAA,EACvD;AAEA,aAAO,8BAAS,OAAO;AACzB;;;ACrDA,IAAAC,sBAAyB;AAOlB,SAAS,oBACd,aAA8D,CAAC,GAC/D;AACA,QAAM,EAAE,QAAQ,QAAQ,CAAC,EAAE,IAAI;AAC/B,QAAM,UAAU,iBAAiB,MAAM;AAEvC,QAAM,eAAe,mCAAmC,OAAO;AAE/D,QAAM,UAAU;AAAA,IACd,GAAG;AAAA,IACH,GAAG;AAAA,IACH,SAAS,MAAM,WAAW,aAAa;AAAA,EACzC;AAEA,aAAO,8BAAS,OAAO;AACzB;;;ACvBA,IAAAC,sBAAyB;AASlB,SAAS,kBAAkB,aAA4D,CAAC,GAAG;AAChG,QAAM,EAAE,QAAQ,QAAQ,CAAC,GAAG,GAAG,KAAK,IAAI;AACxC,QAAM,UAAU,iBAAiB,MAAM;AAEvC,QAAM,eAAe,iCAAiC,SAAS,EAAE,GAAG,KAAK,CAAC;AAE1E,QAAM,UAAU;AAAA,IACd,GAAG;AAAA,IACH,GAAG;AAAA,IACH,SAAS,MAAM,WAAW,aAAa;AAAA,EACzC;AAEA,aAAO,8BAAS,OAAO;AACzB;","names":["import_react","import_react","import_react_query","import_ensnode_sdk","import_react_query","import_react_query","import_react_query","import_react_query"]}
+{"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/context.ts","../src/hooks/useENSNodeConfig.ts","../src/hooks/useRecords.ts","../src/utils/query.ts","../src/hooks/usePrimaryName.ts","../src/hooks/usePrimaryNames.ts","../src/hooks/useENSIndexerConfig.ts","../src/hooks/useIndexingStatus.ts"],"sourcesContent":["export type { QueryClient } from \"@tanstack/react-query\";\n\nexport type { ResolverRecordsSelection } from \"@ensnode/ensnode-sdk\";\n\nexport * from \"./provider\";\nexport * from \"./context\";\nexport * from \"./hooks\";\nexport * from \"./types\";\n","\"use client\";\n\nimport { ENSNodeClient } from \"@ensnode/ensnode-sdk\";\nimport { QueryClient, QueryClientProvider, useQueryClient } from \"@tanstack/react-query\";\nimport { createElement, useMemo } from \"react\";\n\nimport { ENSNodeContext } from \"./context\";\nimport type { ENSNodeConfig } from \"./types\";\n\nexport interface ENSNodeProviderProps {\n  /** ENSNode configuration */\n  config: ENSNodeConfig;\n\n  /**\n   * Optional QueryClient instance. If provided, you must wrap your app with QueryClientProvider yourself.\n   * If not provided, ENSNodeProvider will create and manage its own QueryClient internally.\n   */\n  queryClient?: QueryClient;\n\n  /**\n   * Custom query client options when auto-creating a QueryClient.\n   * Only used when queryClient is not provided.\n   */\n  queryClientOptions?: ConstructorParameters<typeof QueryClient>[0];\n}\n\nfunction ENSNodeInternalProvider({\n  children,\n  config,\n}: {\n  children: React.ReactNode;\n  config: ENSNodeConfig;\n}) {\n  // Memoize the config to prevent unnecessary re-renders\n  const memoizedConfig = useMemo(() => config, [config]);\n\n  return createElement(ENSNodeContext.Provider, { value: memoizedConfig }, children);\n}\n\nexport function ENSNodeProvider(parameters: React.PropsWithChildren<ENSNodeProviderProps>) {\n  const { children, config, queryClient, queryClientOptions } = parameters;\n\n  // Check if we're already inside a QueryClientProvider\n  let hasExistingQueryClient = false;\n  try {\n    hasExistingQueryClient = Boolean(useQueryClient());\n  } catch {\n    // useQueryClient throws if not inside a QueryClientProvider\n    hasExistingQueryClient = false;\n  }\n\n  // If user provided a queryClient, they must handle QueryClientProvider themselves\n  if (queryClient) {\n    if (!hasExistingQueryClient) {\n      throw new Error(\n        \"When providing a custom queryClient, you must wrap your app with QueryClientProvider. \" +\n          \"Either remove the queryClient prop to use auto-managed setup, or wrap with QueryClientProvider.\",\n      );\n    }\n    return createElement(ENSNodeInternalProvider, { config, children });\n  }\n\n  // If already inside a QueryClientProvider, just use that\n  if (hasExistingQueryClient) {\n    return createElement(ENSNodeInternalProvider, { config, children });\n  }\n\n  // Create our own QueryClient and QueryClientProvider\n  const defaultQueryClient = useMemo(\n    () =>\n      new QueryClient({\n        defaultOptions: {\n          queries: {\n            retry: 3,\n            staleTime: 1000 * 60 * 5, // 5 minutes\n            gcTime: 1000 * 60 * 30, // 30 minutes\n          },\n        },\n        ...queryClientOptions,\n      }),\n    [queryClientOptions],\n  );\n\n  return createElement(\n    QueryClientProvider,\n    { client: defaultQueryClient },\n    createElement(ENSNodeInternalProvider, { config, children }),\n  );\n}\n\n/**\n * Helper function to create ENSNode configuration\n */\nexport function createConfig(options?: {\n  url?: string | URL;\n}): ENSNodeConfig {\n  const url = options?.url ? new URL(options.url) : ENSNodeClient.defaultOptions().url;\n\n  return {\n    client: {\n      ...ENSNodeClient.defaultOptions(),\n      url,\n    },\n  };\n}\n","import { createContext } from \"react\";\n\nimport type { ENSNodeConfig } from \"./types\";\n\n/**\n * React context for ENSNode configuration\n */\nexport const ENSNodeContext = createContext<ENSNodeConfig | undefined>(undefined);\n\n/**\n * Display name for debugging\n */\nENSNodeContext.displayName = \"ENSNodeContext\";\n","\"use client\";\n\nimport { useContext } from \"react\";\nimport { ENSNodeContext } from \"../context\";\nimport type { ENSNodeConfig } from \"../types\";\n\n/**\n * Hook to access the ENSNode configuration from context or parameters\n *\n * @param parameters - Optional config parameter that overrides context\n * @returns The ENSNode configuration\n * @throws Error if no config is available in context or parameters\n */\nexport function useENSNodeConfig<TConfig extends ENSNodeConfig = ENSNodeConfig>(\n  config: TConfig | undefined,\n): TConfig {\n  const contextConfig = useContext(ENSNodeContext);\n\n  // Use provided config or fall back to context\n  const resolvedConfig = config ?? contextConfig;\n\n  if (!resolvedConfig) {\n    throw new Error(\n      \"useENSNodeConfig must be used within an ENSNodeProvider or you must pass a config parameter\",\n    );\n  }\n\n  return resolvedConfig as TConfig;\n}\n","\"use client\";\n\nimport type { ResolverRecordsSelection } from \"@ensnode/ensnode-sdk\";\nimport { useQuery } from \"@tanstack/react-query\";\n\nimport type { ConfigParameter, UseRecordsParameters } from \"../types\";\nimport { createRecordsQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\n/**\n * Resolves records for an ENS name (Forward Resolution).\n *\n * The returned `name` field, if set, is guaranteed to be a normalized name.\n * If the name record returned by the resolver is not normalized, `null` is returned as if no name record was set.\n *\n * @param parameters - Configuration for the ENS name resolution\n * @returns Query result with resolved records\n *\n * @example\n * ```typescript\n * import { useRecords } from \"@ensnode/ensnode-react\";\n *\n * function DisplayNameRecords() {\n *   const { data, isLoading, error } = useRecords({\n *     name: \"jesse.base.eth\",\n *     selection: {\n *       addresses: [60], // ETH CoinType\n *       texts: [\"avatar\", \"com.twitter\"]\n *     }\n *   });\n *\n *   if (isLoading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       <h3>Resolved Records for vitalik.eth</h3>\n *       {data.records.addresses && (\n *         <p>ETH Address: {data.records.addresses[60]}</p>\n *       )}\n *       {data.records.texts && (\n *         <div>\n *           <p>Avatar: {data.records.texts.avatar}</p>\n *           <p>Twitter: {data.records.texts[\"com.twitter\"]}</p>\n *         </div>\n *       )}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useRecords<SELECTION extends ResolverRecordsSelection>(\n  parameters: UseRecordsParameters<SELECTION> & ConfigParameter,\n) {\n  const { config, query = {}, name, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const canEnable = name !== null;\n\n  const queryOptions = canEnable\n    ? createRecordsQueryOptions(_config, { ...args, name })\n    : { enabled: false, queryKey: [\"disabled\"] as const };\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: canEnable && (query.enabled ?? queryOptions.enabled),\n  };\n\n  return useQuery(options);\n}\n","\"use client\";\n\nimport {\n  ENSNodeClient,\n  IndexingStatusRequest,\n  ResolvePrimaryNameRequest,\n  ResolvePrimaryNamesRequest,\n  ResolveRecordsRequest,\n  ResolverRecordsSelection,\n} from \"@ensnode/ensnode-sdk\";\nimport type { ENSNodeConfig } from \"../types\";\n\n/**\n * Query keys for hooks. Simply keys by path and arguments.\n */\nexport const queryKeys = {\n  base: (url: string) => [\"ensnode\", url] as const,\n\n  resolve: (url: string) => [...queryKeys.base(url), \"resolve\"] as const,\n\n  records: (url: string, args: ResolveRecordsRequest<any>) =>\n    [...queryKeys.resolve(url), \"records\", args] as const,\n\n  primaryName: (url: string, args: ResolvePrimaryNameRequest) =>\n    [...queryKeys.resolve(url), \"primary-name\", args] as const,\n\n  primaryNames: (url: string, args: ResolvePrimaryNamesRequest) =>\n    [...queryKeys.resolve(url), \"primary-names\", args] as const,\n\n  config: (url: string) => [...queryKeys.base(url), \"config\"] as const,\n\n  indexingStatus: (url: string, args: IndexingStatusRequest) =>\n    [...queryKeys.base(url), \"config\", args] as const,\n};\n\n/**\n * Creates query options for Records Resolution\n */\nexport function createRecordsQueryOptions<SELECTION extends ResolverRecordsSelection>(\n  config: ENSNodeConfig,\n  args: ResolveRecordsRequest<SELECTION>,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.records(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.resolveRecords(args.name, args.selection, args);\n    },\n  };\n}\n\n/**\n * Creates query options for Primary Name Resolution\n */\nexport function createPrimaryNameQueryOptions(\n  config: ENSNodeConfig,\n  args: ResolvePrimaryNameRequest,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.primaryName(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.resolvePrimaryName(args.address, args.chainId, args);\n    },\n  };\n}\n\n/**\n * Creates query options for Primary Name Resolution\n */\nexport function createPrimaryNamesQueryOptions(\n  config: ENSNodeConfig,\n  args: ResolvePrimaryNamesRequest,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.primaryNames(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.resolvePrimaryNames(args.address, args);\n    },\n  };\n}\n\n/**\n * Creates query options for ENSIndexer Config API\n */\nexport function createENSIndexerConfigQueryOptions(config: ENSNodeConfig) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.config(config.client.url.href),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.config();\n    },\n  };\n}\n\n/**\n * Creates query options for ENSIndexer Indexing Status API\n */\nexport function createIndexingStatusQueryOptions(\n  config: ENSNodeConfig,\n  args: IndexingStatusRequest,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.indexingStatus(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.indexingStatus(args);\n    },\n  };\n}\n","\"use client\";\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { ConfigParameter, UsePrimaryNameParameters } from \"../types\";\nimport { createPrimaryNameQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\n/**\n * Resolves the primary name of a specified address (Reverse Resolution).\n *\n * The returned Primary Name, if set, is guaranteed to be a normalized name.\n * If the primary name set for the address is not normalized, `null` is returned as if no primary name was set.\n *\n * @param parameters - Configuration for the address resolution\n * @returns Query result with resolved primary name\n *\n * @example\n * ```typescript\n * import { usePrimaryName } from \"@ensnode/ensnode-react\";\n *\n * function DisplayPrimaryNameAndAvatar() {\n *   const { data, isLoading, error } = usePrimaryName({\n *     address: \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\n *     chainId: 1, // Ethereum Mainnet\n *   });\n *\n *   if (isLoading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       <h3>Primary Name (for Mainnet)</h3>\n *       <p>{data.name ?? \"No Primary Name\"}</p>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function usePrimaryName(parameters: UsePrimaryNameParameters & ConfigParameter) {\n  const { config, query = {}, address, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const canEnable = address !== null;\n\n  const queryOptions = canEnable\n    ? createPrimaryNameQueryOptions(_config, { ...args, address })\n    : { enabled: false, queryKey: [\"disabled\"] as const };\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: canEnable && (query.enabled ?? queryOptions.enabled),\n  };\n\n  return useQuery(options);\n}\n","\"use client\";\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { ConfigParameter, UsePrimaryNamesParameters } from \"../types\";\nimport { createPrimaryNamesQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\n/**\n * Resolves the primary names of a specified address across multiple chains.\n *\n * Each returned Primary Name, if set, is guaranteed to be a normalized name.\n * If the primary name set for the address on any chain is not normalized, `null` is returned for that chain as if no primary name was set.\n *\n * @param parameters - Configuration for the address resolution\n * @returns Query result with resolved primary names\n *\n * @example\n * ```typescript\n * import { usePrimaryNames } from \"@ensnode/ensnode-react\";\n *\n * function DisplayPrimaryNames() {\n *   const { data, isLoading, error } = usePrimaryNames({\n *     address: \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\n *   });\n *\n *   if (isLoading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       {Object.entries(data.names).map(([chainId, name]) => (\n *         <div key={chainId}>\n *           <h3>Primary Name (Chain Id: {chainId})</h3>\n *           <p>{name}</p>\n *         </div>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function usePrimaryNames(parameters: UsePrimaryNamesParameters & ConfigParameter) {\n  const { config, query = {}, address, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const canEnable = address !== null;\n\n  const queryOptions = canEnable\n    ? createPrimaryNamesQueryOptions(_config, { ...args, address })\n    : { enabled: false, queryKey: [\"disabled\"] as const };\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: canEnable && (query.enabled ?? queryOptions.enabled),\n  };\n\n  return useQuery(options);\n}\n","import { ConfigResponse } from \"@ensnode/ensnode-sdk\";\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport { ConfigParameter, QueryParameter } from \"../types\";\nimport { createENSIndexerConfigQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\ntype UseENSIndexerConfigParameters = QueryParameter<ConfigResponse>;\n\nexport function useENSIndexerConfig(\n  parameters: ConfigParameter & UseENSIndexerConfigParameters = {},\n) {\n  const { config, query = {} } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const queryOptions = createENSIndexerConfigQueryOptions(_config);\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: query.enabled ?? queryOptions.enabled,\n  };\n\n  return useQuery(options);\n}\n","import { IndexingStatusRequest, IndexingStatusResponse } from \"@ensnode/ensnode-sdk\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { ConfigParameter, QueryParameter } from \"../types\";\nimport { createIndexingStatusQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\ninterface UseIndexingStatusParameters\n  extends IndexingStatusRequest,\n    QueryParameter<IndexingStatusResponse> {}\n\nexport function useIndexingStatus(parameters: ConfigParameter & UseIndexingStatusParameters = {}) {\n  const { config, query = {}, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const queryOptions = createIndexingStatusQueryOptions(_config, { ...args });\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: query.enabled ?? queryOptions.enabled,\n  };\n\n  return useQuery(options);\n}\n"],"mappings":"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","names":["import_react","import_react","import_react_query","import_ensnode_sdk","import_react_query","import_react_query","import_react_query","import_react_query"]}

package/dist/index.d.cts

@@ -92,6 +92,9 @@ declare function useENSNodeConfig<TConfig extends ENSNodeConfig = ENSNodeConfig>
 /**
  * Resolves records for an ENS name (Forward Resolution).
  *
+ * The returned `name` field, if set, is guaranteed to be a normalized name.
+ * If the name record returned by the resolver is not normalized, `null` is returned as if no name record was set.
+ *
  * @param parameters - Configuration for the ENS name resolution
  * @returns Query result with resolved records
  *
@@ -133,6 +136,9 @@ declare function useRecords<SELECTION extends ResolverRecordsSelection>(paramete
 /**
  * Resolves the primary name of a specified address (Reverse Resolution).
  *
+ * The returned Primary Name, if set, is guaranteed to be a normalized name.
+ * If the primary name set for the address is not normalized, `null` is returned as if no primary name was set.
+ *
  * @param parameters - Configuration for the address resolution
  * @returns Query result with resolved primary name
  *
@@ -163,6 +169,9 @@ declare function usePrimaryName(parameters: UsePrimaryNameParameters & ConfigPar
 /**
  * Resolves the primary names of a specified address across multiple chains.
  *
+ * Each returned Primary Name, if set, is guaranteed to be a normalized name.
+ * If the primary name set for the address on any chain is not normalized, `null` is returned for that chain as if no primary name was set.
+ *
  * @param parameters - Configuration for the address resolution
  * @returns Query result with resolved primary names
  *

package/dist/index.d.ts

@@ -92,6 +92,9 @@ declare function useENSNodeConfig<TConfig extends ENSNodeConfig = ENSNodeConfig>
 /**
  * Resolves records for an ENS name (Forward Resolution).
  *
+ * The returned `name` field, if set, is guaranteed to be a normalized name.
+ * If the name record returned by the resolver is not normalized, `null` is returned as if no name record was set.
+ *
  * @param parameters - Configuration for the ENS name resolution
  * @returns Query result with resolved records
  *
@@ -133,6 +136,9 @@ declare function useRecords<SELECTION extends ResolverRecordsSelection>(paramete
 /**
  * Resolves the primary name of a specified address (Reverse Resolution).
  *
+ * The returned Primary Name, if set, is guaranteed to be a normalized name.
+ * If the primary name set for the address is not normalized, `null` is returned as if no primary name was set.
+ *
  * @param parameters - Configuration for the address resolution
  * @returns Query result with resolved primary name
  *
@@ -163,6 +169,9 @@ declare function usePrimaryName(parameters: UsePrimaryNameParameters & ConfigPar
 /**
  * Resolves the primary names of a specified address across multiple chains.
  *
+ * Each returned Primary Name, if set, is guaranteed to be a normalized name.
+ * If the primary name set for the address on any chain is not normalized, `null` is returned for that chain as if no primary name was set.
+ *
  * @param parameters - Configuration for the address resolution
  * @returns Query result with resolved primary names
  *

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/provider.tsx","../src/context.ts","../src/hooks/useENSNodeConfig.ts","../src/hooks/useRecords.ts","../src/utils/query.ts","../src/hooks/usePrimaryName.ts","../src/hooks/usePrimaryNames.ts","../src/hooks/useENSIndexerConfig.ts","../src/hooks/useIndexingStatus.ts"],"sourcesContent":["\"use client\";\n\nimport { ENSNodeClient } from \"@ensnode/ensnode-sdk\";\nimport { QueryClient, QueryClientProvider, useQueryClient } from \"@tanstack/react-query\";\nimport { createElement, useMemo } from \"react\";\n\nimport { ENSNodeContext } from \"./context\";\nimport type { ENSNodeConfig } from \"./types\";\n\nexport interface ENSNodeProviderProps {\n  /** ENSNode configuration */\n  config: ENSNodeConfig;\n\n  /**\n   * Optional QueryClient instance. If provided, you must wrap your app with QueryClientProvider yourself.\n   * If not provided, ENSNodeProvider will create and manage its own QueryClient internally.\n   */\n  queryClient?: QueryClient;\n\n  /**\n   * Custom query client options when auto-creating a QueryClient.\n   * Only used when queryClient is not provided.\n   */\n  queryClientOptions?: ConstructorParameters<typeof QueryClient>[0];\n}\n\nfunction ENSNodeInternalProvider({\n  children,\n  config,\n}: {\n  children: React.ReactNode;\n  config: ENSNodeConfig;\n}) {\n  // Memoize the config to prevent unnecessary re-renders\n  const memoizedConfig = useMemo(() => config, [config]);\n\n  return createElement(ENSNodeContext.Provider, { value: memoizedConfig }, children);\n}\n\nexport function ENSNodeProvider(parameters: React.PropsWithChildren<ENSNodeProviderProps>) {\n  const { children, config, queryClient, queryClientOptions } = parameters;\n\n  // Check if we're already inside a QueryClientProvider\n  let hasExistingQueryClient = false;\n  try {\n    hasExistingQueryClient = Boolean(useQueryClient());\n  } catch {\n    // useQueryClient throws if not inside a QueryClientProvider\n    hasExistingQueryClient = false;\n  }\n\n  // If user provided a queryClient, they must handle QueryClientProvider themselves\n  if (queryClient) {\n    if (!hasExistingQueryClient) {\n      throw new Error(\n        \"When providing a custom queryClient, you must wrap your app with QueryClientProvider. \" +\n          \"Either remove the queryClient prop to use auto-managed setup, or wrap with QueryClientProvider.\",\n      );\n    }\n    return createElement(ENSNodeInternalProvider, { config, children });\n  }\n\n  // If already inside a QueryClientProvider, just use that\n  if (hasExistingQueryClient) {\n    return createElement(ENSNodeInternalProvider, { config, children });\n  }\n\n  // Create our own QueryClient and QueryClientProvider\n  const defaultQueryClient = useMemo(\n    () =>\n      new QueryClient({\n        defaultOptions: {\n          queries: {\n            retry: 3,\n            staleTime: 1000 * 60 * 5, // 5 minutes\n            gcTime: 1000 * 60 * 30, // 30 minutes\n          },\n        },\n        ...queryClientOptions,\n      }),\n    [queryClientOptions],\n  );\n\n  return createElement(\n    QueryClientProvider,\n    { client: defaultQueryClient },\n    createElement(ENSNodeInternalProvider, { config, children }),\n  );\n}\n\n/**\n * Helper function to create ENSNode configuration\n */\nexport function createConfig(options?: {\n  url?: string | URL;\n}): ENSNodeConfig {\n  const url = options?.url ? new URL(options.url) : ENSNodeClient.defaultOptions().url;\n\n  return {\n    client: {\n      ...ENSNodeClient.defaultOptions(),\n      url,\n    },\n  };\n}\n","import { createContext } from \"react\";\n\nimport type { ENSNodeConfig } from \"./types\";\n\n/**\n * React context for ENSNode configuration\n */\nexport const ENSNodeContext = createContext<ENSNodeConfig | undefined>(undefined);\n\n/**\n * Display name for debugging\n */\nENSNodeContext.displayName = \"ENSNodeContext\";\n","\"use client\";\n\nimport { useContext } from \"react\";\nimport { ENSNodeContext } from \"../context\";\nimport type { ENSNodeConfig } from \"../types\";\n\n/**\n * Hook to access the ENSNode configuration from context or parameters\n *\n * @param parameters - Optional config parameter that overrides context\n * @returns The ENSNode configuration\n * @throws Error if no config is available in context or parameters\n */\nexport function useENSNodeConfig<TConfig extends ENSNodeConfig = ENSNodeConfig>(\n  config: TConfig | undefined,\n): TConfig {\n  const contextConfig = useContext(ENSNodeContext);\n\n  // Use provided config or fall back to context\n  const resolvedConfig = config ?? contextConfig;\n\n  if (!resolvedConfig) {\n    throw new Error(\n      \"useENSNodeConfig must be used within an ENSNodeProvider or you must pass a config parameter\",\n    );\n  }\n\n  return resolvedConfig as TConfig;\n}\n","\"use client\";\n\nimport type { ResolverRecordsSelection } from \"@ensnode/ensnode-sdk\";\nimport { useQuery } from \"@tanstack/react-query\";\n\nimport type { ConfigParameter, UseRecordsParameters } from \"../types\";\nimport { createRecordsQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\n/**\n * Resolves records for an ENS name (Forward Resolution).\n *\n * @param parameters - Configuration for the ENS name resolution\n * @returns Query result with resolved records\n *\n * @example\n * ```typescript\n * import { useRecords } from \"@ensnode/ensnode-react\";\n *\n * function DisplayNameRecords() {\n *   const { data, isLoading, error } = useRecords({\n *     name: \"jesse.base.eth\",\n *     selection: {\n *       addresses: [60], // ETH CoinType\n *       texts: [\"avatar\", \"com.twitter\"]\n *     }\n *   });\n *\n *   if (isLoading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       <h3>Resolved Records for vitalik.eth</h3>\n *       {data.records.addresses && (\n *         <p>ETH Address: {data.records.addresses[60]}</p>\n *       )}\n *       {data.records.texts && (\n *         <div>\n *           <p>Avatar: {data.records.texts.avatar}</p>\n *           <p>Twitter: {data.records.texts[\"com.twitter\"]}</p>\n *         </div>\n *       )}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useRecords<SELECTION extends ResolverRecordsSelection>(\n  parameters: UseRecordsParameters<SELECTION> & ConfigParameter,\n) {\n  const { config, query = {}, name, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const canEnable = name !== null;\n\n  const queryOptions = canEnable\n    ? createRecordsQueryOptions(_config, { ...args, name })\n    : { enabled: false, queryKey: [\"disabled\"] as const };\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: canEnable && (query.enabled ?? queryOptions.enabled),\n  };\n\n  return useQuery(options);\n}\n","\"use client\";\n\nimport {\n  ENSNodeClient,\n  IndexingStatusRequest,\n  ResolvePrimaryNameRequest,\n  ResolvePrimaryNamesRequest,\n  ResolveRecordsRequest,\n  ResolverRecordsSelection,\n} from \"@ensnode/ensnode-sdk\";\nimport type { ENSNodeConfig } from \"../types\";\n\n/**\n * Query keys for hooks. Simply keys by path and arguments.\n */\nexport const queryKeys = {\n  base: (url: string) => [\"ensnode\", url] as const,\n\n  resolve: (url: string) => [...queryKeys.base(url), \"resolve\"] as const,\n\n  records: (url: string, args: ResolveRecordsRequest<any>) =>\n    [...queryKeys.resolve(url), \"records\", args] as const,\n\n  primaryName: (url: string, args: ResolvePrimaryNameRequest) =>\n    [...queryKeys.resolve(url), \"primary-name\", args] as const,\n\n  primaryNames: (url: string, args: ResolvePrimaryNamesRequest) =>\n    [...queryKeys.resolve(url), \"primary-names\", args] as const,\n\n  config: (url: string) => [...queryKeys.base(url), \"config\"] as const,\n\n  indexingStatus: (url: string, args: IndexingStatusRequest) =>\n    [...queryKeys.base(url), \"config\", args] as const,\n};\n\n/**\n * Creates query options for Records Resolution\n */\nexport function createRecordsQueryOptions<SELECTION extends ResolverRecordsSelection>(\n  config: ENSNodeConfig,\n  args: ResolveRecordsRequest<SELECTION>,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.records(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.resolveRecords(args.name, args.selection, args);\n    },\n  };\n}\n\n/**\n * Creates query options for Primary Name Resolution\n */\nexport function createPrimaryNameQueryOptions(\n  config: ENSNodeConfig,\n  args: ResolvePrimaryNameRequest,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.primaryName(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.resolvePrimaryName(args.address, args.chainId, args);\n    },\n  };\n}\n\n/**\n * Creates query options for Primary Name Resolution\n */\nexport function createPrimaryNamesQueryOptions(\n  config: ENSNodeConfig,\n  args: ResolvePrimaryNamesRequest,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.primaryNames(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.resolvePrimaryNames(args.address, args);\n    },\n  };\n}\n\n/**\n * Creates query options for ENSIndexer Config API\n */\nexport function createENSIndexerConfigQueryOptions(config: ENSNodeConfig) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.config(config.client.url.href),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.config();\n    },\n  };\n}\n\n/**\n * Creates query options for ENSIndexer Indexing Status API\n */\nexport function createIndexingStatusQueryOptions(\n  config: ENSNodeConfig,\n  args: IndexingStatusRequest,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.indexingStatus(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.indexingStatus(args);\n    },\n  };\n}\n","\"use client\";\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { ConfigParameter, UsePrimaryNameParameters } from \"../types\";\nimport { createPrimaryNameQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\n/**\n * Resolves the primary name of a specified address (Reverse Resolution).\n *\n * @param parameters - Configuration for the address resolution\n * @returns Query result with resolved primary name\n *\n * @example\n * ```typescript\n * import { usePrimaryName } from \"@ensnode/ensnode-react\";\n *\n * function DisplayPrimaryNameAndAvatar() {\n *   const { data, isLoading, error } = usePrimaryName({\n *     address: \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\n *     chainId: 1, // Ethereum Mainnet\n *   });\n *\n *   if (isLoading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       <h3>Primary Name (for Mainnet)</h3>\n *       <p>{data.name ?? \"No Primary Name\"}</p>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function usePrimaryName(parameters: UsePrimaryNameParameters & ConfigParameter) {\n  const { config, query = {}, address, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const canEnable = address !== null;\n\n  const queryOptions = canEnable\n    ? createPrimaryNameQueryOptions(_config, { ...args, address })\n    : { enabled: false, queryKey: [\"disabled\"] as const };\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: canEnable && (query.enabled ?? queryOptions.enabled),\n  };\n\n  return useQuery(options);\n}\n","\"use client\";\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { ConfigParameter, UsePrimaryNamesParameters } from \"../types\";\nimport { createPrimaryNamesQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\n/**\n * Resolves the primary names of a specified address across multiple chains.\n *\n * @param parameters - Configuration for the address resolution\n * @returns Query result with resolved primary names\n *\n * @example\n * ```typescript\n * import { usePrimaryNames } from \"@ensnode/ensnode-react\";\n *\n * function DisplayPrimaryNames() {\n *   const { data, isLoading, error } = usePrimaryNames({\n *     address: \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\n *   });\n *\n *   if (isLoading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       {Object.entries(data.names).map(([chainId, name]) => (\n *         <div key={chainId}>\n *           <h3>Primary Name (Chain Id: {chainId})</h3>\n *           <p>{name}</p>\n *         </div>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function usePrimaryNames(parameters: UsePrimaryNamesParameters & ConfigParameter) {\n  const { config, query = {}, address, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const canEnable = address !== null;\n\n  const queryOptions = canEnable\n    ? createPrimaryNamesQueryOptions(_config, { ...args, address })\n    : { enabled: false, queryKey: [\"disabled\"] as const };\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: canEnable && (query.enabled ?? queryOptions.enabled),\n  };\n\n  return useQuery(options);\n}\n","import { ConfigResponse } from \"@ensnode/ensnode-sdk\";\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport { ConfigParameter, QueryParameter } from \"../types\";\nimport { createENSIndexerConfigQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\ntype UseENSIndexerConfigParameters = QueryParameter<ConfigResponse>;\n\nexport function useENSIndexerConfig(\n  parameters: ConfigParameter & UseENSIndexerConfigParameters = {},\n) {\n  const { config, query = {} } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const queryOptions = createENSIndexerConfigQueryOptions(_config);\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: query.enabled ?? queryOptions.enabled,\n  };\n\n  return useQuery(options);\n}\n","import { IndexingStatusRequest, IndexingStatusResponse } from \"@ensnode/ensnode-sdk\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { ConfigParameter, QueryParameter } from \"../types\";\nimport { createIndexingStatusQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\ninterface UseIndexingStatusParameters\n  extends IndexingStatusRequest,\n    QueryParameter<IndexingStatusResponse> {}\n\nexport function useIndexingStatus(parameters: ConfigParameter & UseIndexingStatusParameters = {}) {\n  const { config, query = {}, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const queryOptions = createIndexingStatusQueryOptions(_config, { ...args });\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: query.enabled ?? queryOptions.enabled,\n  };\n\n  return useQuery(options);\n}\n"],"mappings":"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","names":["ENSNodeClient","useQuery","useQuery","useQuery","useQuery","useQuery","useQuery","useQuery","useQuery"]}
+{"version":3,"sources":["../src/provider.tsx","../src/context.ts","../src/hooks/useENSNodeConfig.ts","../src/hooks/useRecords.ts","../src/utils/query.ts","../src/hooks/usePrimaryName.ts","../src/hooks/usePrimaryNames.ts","../src/hooks/useENSIndexerConfig.ts","../src/hooks/useIndexingStatus.ts"],"sourcesContent":["\"use client\";\n\nimport { ENSNodeClient } from \"@ensnode/ensnode-sdk\";\nimport { QueryClient, QueryClientProvider, useQueryClient } from \"@tanstack/react-query\";\nimport { createElement, useMemo } from \"react\";\n\nimport { ENSNodeContext } from \"./context\";\nimport type { ENSNodeConfig } from \"./types\";\n\nexport interface ENSNodeProviderProps {\n  /** ENSNode configuration */\n  config: ENSNodeConfig;\n\n  /**\n   * Optional QueryClient instance. If provided, you must wrap your app with QueryClientProvider yourself.\n   * If not provided, ENSNodeProvider will create and manage its own QueryClient internally.\n   */\n  queryClient?: QueryClient;\n\n  /**\n   * Custom query client options when auto-creating a QueryClient.\n   * Only used when queryClient is not provided.\n   */\n  queryClientOptions?: ConstructorParameters<typeof QueryClient>[0];\n}\n\nfunction ENSNodeInternalProvider({\n  children,\n  config,\n}: {\n  children: React.ReactNode;\n  config: ENSNodeConfig;\n}) {\n  // Memoize the config to prevent unnecessary re-renders\n  const memoizedConfig = useMemo(() => config, [config]);\n\n  return createElement(ENSNodeContext.Provider, { value: memoizedConfig }, children);\n}\n\nexport function ENSNodeProvider(parameters: React.PropsWithChildren<ENSNodeProviderProps>) {\n  const { children, config, queryClient, queryClientOptions } = parameters;\n\n  // Check if we're already inside a QueryClientProvider\n  let hasExistingQueryClient = false;\n  try {\n    hasExistingQueryClient = Boolean(useQueryClient());\n  } catch {\n    // useQueryClient throws if not inside a QueryClientProvider\n    hasExistingQueryClient = false;\n  }\n\n  // If user provided a queryClient, they must handle QueryClientProvider themselves\n  if (queryClient) {\n    if (!hasExistingQueryClient) {\n      throw new Error(\n        \"When providing a custom queryClient, you must wrap your app with QueryClientProvider. \" +\n          \"Either remove the queryClient prop to use auto-managed setup, or wrap with QueryClientProvider.\",\n      );\n    }\n    return createElement(ENSNodeInternalProvider, { config, children });\n  }\n\n  // If already inside a QueryClientProvider, just use that\n  if (hasExistingQueryClient) {\n    return createElement(ENSNodeInternalProvider, { config, children });\n  }\n\n  // Create our own QueryClient and QueryClientProvider\n  const defaultQueryClient = useMemo(\n    () =>\n      new QueryClient({\n        defaultOptions: {\n          queries: {\n            retry: 3,\n            staleTime: 1000 * 60 * 5, // 5 minutes\n            gcTime: 1000 * 60 * 30, // 30 minutes\n          },\n        },\n        ...queryClientOptions,\n      }),\n    [queryClientOptions],\n  );\n\n  return createElement(\n    QueryClientProvider,\n    { client: defaultQueryClient },\n    createElement(ENSNodeInternalProvider, { config, children }),\n  );\n}\n\n/**\n * Helper function to create ENSNode configuration\n */\nexport function createConfig(options?: {\n  url?: string | URL;\n}): ENSNodeConfig {\n  const url = options?.url ? new URL(options.url) : ENSNodeClient.defaultOptions().url;\n\n  return {\n    client: {\n      ...ENSNodeClient.defaultOptions(),\n      url,\n    },\n  };\n}\n","import { createContext } from \"react\";\n\nimport type { ENSNodeConfig } from \"./types\";\n\n/**\n * React context for ENSNode configuration\n */\nexport const ENSNodeContext = createContext<ENSNodeConfig | undefined>(undefined);\n\n/**\n * Display name for debugging\n */\nENSNodeContext.displayName = \"ENSNodeContext\";\n","\"use client\";\n\nimport { useContext } from \"react\";\nimport { ENSNodeContext } from \"../context\";\nimport type { ENSNodeConfig } from \"../types\";\n\n/**\n * Hook to access the ENSNode configuration from context or parameters\n *\n * @param parameters - Optional config parameter that overrides context\n * @returns The ENSNode configuration\n * @throws Error if no config is available in context or parameters\n */\nexport function useENSNodeConfig<TConfig extends ENSNodeConfig = ENSNodeConfig>(\n  config: TConfig | undefined,\n): TConfig {\n  const contextConfig = useContext(ENSNodeContext);\n\n  // Use provided config or fall back to context\n  const resolvedConfig = config ?? contextConfig;\n\n  if (!resolvedConfig) {\n    throw new Error(\n      \"useENSNodeConfig must be used within an ENSNodeProvider or you must pass a config parameter\",\n    );\n  }\n\n  return resolvedConfig as TConfig;\n}\n","\"use client\";\n\nimport type { ResolverRecordsSelection } from \"@ensnode/ensnode-sdk\";\nimport { useQuery } from \"@tanstack/react-query\";\n\nimport type { ConfigParameter, UseRecordsParameters } from \"../types\";\nimport { createRecordsQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\n/**\n * Resolves records for an ENS name (Forward Resolution).\n *\n * The returned `name` field, if set, is guaranteed to be a normalized name.\n * If the name record returned by the resolver is not normalized, `null` is returned as if no name record was set.\n *\n * @param parameters - Configuration for the ENS name resolution\n * @returns Query result with resolved records\n *\n * @example\n * ```typescript\n * import { useRecords } from \"@ensnode/ensnode-react\";\n *\n * function DisplayNameRecords() {\n *   const { data, isLoading, error } = useRecords({\n *     name: \"jesse.base.eth\",\n *     selection: {\n *       addresses: [60], // ETH CoinType\n *       texts: [\"avatar\", \"com.twitter\"]\n *     }\n *   });\n *\n *   if (isLoading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       <h3>Resolved Records for vitalik.eth</h3>\n *       {data.records.addresses && (\n *         <p>ETH Address: {data.records.addresses[60]}</p>\n *       )}\n *       {data.records.texts && (\n *         <div>\n *           <p>Avatar: {data.records.texts.avatar}</p>\n *           <p>Twitter: {data.records.texts[\"com.twitter\"]}</p>\n *         </div>\n *       )}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useRecords<SELECTION extends ResolverRecordsSelection>(\n  parameters: UseRecordsParameters<SELECTION> & ConfigParameter,\n) {\n  const { config, query = {}, name, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const canEnable = name !== null;\n\n  const queryOptions = canEnable\n    ? createRecordsQueryOptions(_config, { ...args, name })\n    : { enabled: false, queryKey: [\"disabled\"] as const };\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: canEnable && (query.enabled ?? queryOptions.enabled),\n  };\n\n  return useQuery(options);\n}\n","\"use client\";\n\nimport {\n  ENSNodeClient,\n  IndexingStatusRequest,\n  ResolvePrimaryNameRequest,\n  ResolvePrimaryNamesRequest,\n  ResolveRecordsRequest,\n  ResolverRecordsSelection,\n} from \"@ensnode/ensnode-sdk\";\nimport type { ENSNodeConfig } from \"../types\";\n\n/**\n * Query keys for hooks. Simply keys by path and arguments.\n */\nexport const queryKeys = {\n  base: (url: string) => [\"ensnode\", url] as const,\n\n  resolve: (url: string) => [...queryKeys.base(url), \"resolve\"] as const,\n\n  records: (url: string, args: ResolveRecordsRequest<any>) =>\n    [...queryKeys.resolve(url), \"records\", args] as const,\n\n  primaryName: (url: string, args: ResolvePrimaryNameRequest) =>\n    [...queryKeys.resolve(url), \"primary-name\", args] as const,\n\n  primaryNames: (url: string, args: ResolvePrimaryNamesRequest) =>\n    [...queryKeys.resolve(url), \"primary-names\", args] as const,\n\n  config: (url: string) => [...queryKeys.base(url), \"config\"] as const,\n\n  indexingStatus: (url: string, args: IndexingStatusRequest) =>\n    [...queryKeys.base(url), \"config\", args] as const,\n};\n\n/**\n * Creates query options for Records Resolution\n */\nexport function createRecordsQueryOptions<SELECTION extends ResolverRecordsSelection>(\n  config: ENSNodeConfig,\n  args: ResolveRecordsRequest<SELECTION>,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.records(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.resolveRecords(args.name, args.selection, args);\n    },\n  };\n}\n\n/**\n * Creates query options for Primary Name Resolution\n */\nexport function createPrimaryNameQueryOptions(\n  config: ENSNodeConfig,\n  args: ResolvePrimaryNameRequest,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.primaryName(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.resolvePrimaryName(args.address, args.chainId, args);\n    },\n  };\n}\n\n/**\n * Creates query options for Primary Name Resolution\n */\nexport function createPrimaryNamesQueryOptions(\n  config: ENSNodeConfig,\n  args: ResolvePrimaryNamesRequest,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.primaryNames(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.resolvePrimaryNames(args.address, args);\n    },\n  };\n}\n\n/**\n * Creates query options for ENSIndexer Config API\n */\nexport function createENSIndexerConfigQueryOptions(config: ENSNodeConfig) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.config(config.client.url.href),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.config();\n    },\n  };\n}\n\n/**\n * Creates query options for ENSIndexer Indexing Status API\n */\nexport function createIndexingStatusQueryOptions(\n  config: ENSNodeConfig,\n  args: IndexingStatusRequest,\n) {\n  return {\n    enabled: true,\n    queryKey: queryKeys.indexingStatus(config.client.url.href, args),\n    queryFn: async () => {\n      const client = new ENSNodeClient(config.client);\n      return client.indexingStatus(args);\n    },\n  };\n}\n","\"use client\";\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { ConfigParameter, UsePrimaryNameParameters } from \"../types\";\nimport { createPrimaryNameQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\n/**\n * Resolves the primary name of a specified address (Reverse Resolution).\n *\n * The returned Primary Name, if set, is guaranteed to be a normalized name.\n * If the primary name set for the address is not normalized, `null` is returned as if no primary name was set.\n *\n * @param parameters - Configuration for the address resolution\n * @returns Query result with resolved primary name\n *\n * @example\n * ```typescript\n * import { usePrimaryName } from \"@ensnode/ensnode-react\";\n *\n * function DisplayPrimaryNameAndAvatar() {\n *   const { data, isLoading, error } = usePrimaryName({\n *     address: \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\n *     chainId: 1, // Ethereum Mainnet\n *   });\n *\n *   if (isLoading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       <h3>Primary Name (for Mainnet)</h3>\n *       <p>{data.name ?? \"No Primary Name\"}</p>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function usePrimaryName(parameters: UsePrimaryNameParameters & ConfigParameter) {\n  const { config, query = {}, address, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const canEnable = address !== null;\n\n  const queryOptions = canEnable\n    ? createPrimaryNameQueryOptions(_config, { ...args, address })\n    : { enabled: false, queryKey: [\"disabled\"] as const };\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: canEnable && (query.enabled ?? queryOptions.enabled),\n  };\n\n  return useQuery(options);\n}\n","\"use client\";\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { ConfigParameter, UsePrimaryNamesParameters } from \"../types\";\nimport { createPrimaryNamesQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\n/**\n * Resolves the primary names of a specified address across multiple chains.\n *\n * Each returned Primary Name, if set, is guaranteed to be a normalized name.\n * If the primary name set for the address on any chain is not normalized, `null` is returned for that chain as if no primary name was set.\n *\n * @param parameters - Configuration for the address resolution\n * @returns Query result with resolved primary names\n *\n * @example\n * ```typescript\n * import { usePrimaryNames } from \"@ensnode/ensnode-react\";\n *\n * function DisplayPrimaryNames() {\n *   const { data, isLoading, error } = usePrimaryNames({\n *     address: \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\n *   });\n *\n *   if (isLoading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       {Object.entries(data.names).map(([chainId, name]) => (\n *         <div key={chainId}>\n *           <h3>Primary Name (Chain Id: {chainId})</h3>\n *           <p>{name}</p>\n *         </div>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function usePrimaryNames(parameters: UsePrimaryNamesParameters & ConfigParameter) {\n  const { config, query = {}, address, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const canEnable = address !== null;\n\n  const queryOptions = canEnable\n    ? createPrimaryNamesQueryOptions(_config, { ...args, address })\n    : { enabled: false, queryKey: [\"disabled\"] as const };\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: canEnable && (query.enabled ?? queryOptions.enabled),\n  };\n\n  return useQuery(options);\n}\n","import { ConfigResponse } from \"@ensnode/ensnode-sdk\";\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport { ConfigParameter, QueryParameter } from \"../types\";\nimport { createENSIndexerConfigQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\ntype UseENSIndexerConfigParameters = QueryParameter<ConfigResponse>;\n\nexport function useENSIndexerConfig(\n  parameters: ConfigParameter & UseENSIndexerConfigParameters = {},\n) {\n  const { config, query = {} } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const queryOptions = createENSIndexerConfigQueryOptions(_config);\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: query.enabled ?? queryOptions.enabled,\n  };\n\n  return useQuery(options);\n}\n","import { IndexingStatusRequest, IndexingStatusResponse } from \"@ensnode/ensnode-sdk\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { ConfigParameter, QueryParameter } from \"../types\";\nimport { createIndexingStatusQueryOptions } from \"../utils/query\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\n\ninterface UseIndexingStatusParameters\n  extends IndexingStatusRequest,\n    QueryParameter<IndexingStatusResponse> {}\n\nexport function useIndexingStatus(parameters: ConfigParameter & UseIndexingStatusParameters = {}) {\n  const { config, query = {}, ...args } = parameters;\n  const _config = useENSNodeConfig(config);\n\n  const queryOptions = createIndexingStatusQueryOptions(_config, { ...args });\n\n  const options = {\n    ...queryOptions,\n    ...query,\n    enabled: query.enabled ?? queryOptions.enabled,\n  };\n\n  return useQuery(options);\n}\n"],"mappings":"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","names":["ENSNodeClient","useQuery","useQuery","useQuery","useQuery","useQuery","useQuery","useQuery","useQuery"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ensnode/ensnode-react",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "type": "module",
   "description": "React hooks and providers for ENSNode",
   "license": "MIT",
@@ -46,10 +46,10 @@
     "tsup": "^8.3.6",
     "typescript": "^5.7.3",
     "vitest": "^3.1.1",
-    "@ensnode/shared-configs": "0.34.0"
+    "@ensnode/shared-configs": "0.35.0"
   },
   "dependencies": {
-    "@ensnode/ensnode-sdk": "0.34.0"
+    "@ensnode/ensnode-sdk": "0.35.0"
   },
   "scripts": {
     "prepublish": "tsup",