@ensnode/ensnode-react 0.35.0 → 0.36.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.
package/README.md CHANGED
@@ -181,7 +181,7 @@ const { data, isLoading, error, refetch } = useRecords({
181
181
 
182
182
  ### `usePrimaryName`
183
183
 
184
- 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.
184
+ 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 chainId-specific Primary Name is not defined, but 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.
185
185
 
186
186
  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.
187
187
 
@@ -204,7 +204,7 @@ const { data, isLoading, error, refetch } = usePrimaryName({
204
204
 
205
205
  ### `usePrimaryNames`
206
206
 
207
- 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.
207
+ Hook that resolves the primary names of the provided `address` on the specified chainIds, via ENSNode, which implements Protocol Acceleration for indexed names. For each Primary Name, if the chainId-specific Primary Name is not defined, but 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 not_ query the Default EVM Chain Id (`0`) directly, and should rely on the aforementioned per-chain defaulting behavior.
208
208
 
209
209
  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.
210
210
 
package/dist/index.cjs CHANGED
@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
20
20
  // src/index.ts
21
21
  var index_exports = {};
22
22
  __export(index_exports, {
23
+ ASSUME_IMMUTABLE_QUERY: () => ASSUME_IMMUTABLE_QUERY,
23
24
  ENSNodeContext: () => ENSNodeContext,
24
25
  ENSNodeProvider: () => ENSNodeProvider,
25
26
  createConfig: () => createConfig,
@@ -28,7 +29,8 @@ __export(index_exports, {
28
29
  useIndexingStatus: () => useIndexingStatus,
29
30
  usePrimaryName: () => usePrimaryName,
30
31
  usePrimaryNames: () => usePrimaryNames,
31
- useRecords: () => useRecords
32
+ useRecords: () => useRecords,
33
+ useResolvedIdentity: () => useResolvedIdentity
32
34
  });
33
35
  module.exports = __toCommonJS(index_exports);
34
36
 
@@ -76,8 +78,10 @@ function ENSNodeProvider(parameters) {
76
78
  retry: 3,
77
79
  staleTime: 1e3 * 60 * 5,
78
80
  // 5 minutes
79
- gcTime: 1e3 * 60 * 30
81
+ gcTime: 1e3 * 60 * 30,
80
82
  // 30 minutes
83
+ refetchInterval: 1e3 * 10
84
+ // 10 seconds
81
85
  }
82
86
  },
83
87
  ...queryClientOptions
@@ -118,6 +122,13 @@ var import_react_query2 = require("@tanstack/react-query");
118
122
 
119
123
  // src/utils/query.ts
120
124
  var import_ensnode_sdk2 = require("@ensnode/ensnode-sdk");
125
+ var ASSUME_IMMUTABLE_QUERY = {
126
+ staleTime: Infinity,
127
+ gcTime: Infinity,
128
+ refetchOnWindowFocus: false,
129
+ refetchOnReconnect: false,
130
+ refetchOnMount: false
131
+ };
121
132
  var queryKeys = {
122
133
  base: (url) => ["ensnode", url],
123
134
  resolve: (url) => [...queryKeys.base(url), "resolve"],
@@ -125,7 +136,7 @@ var queryKeys = {
125
136
  primaryName: (url, args) => [...queryKeys.resolve(url), "primary-name", args],
126
137
  primaryNames: (url, args) => [...queryKeys.resolve(url), "primary-names", args],
127
138
  config: (url) => [...queryKeys.base(url), "config"],
128
- indexingStatus: (url, args) => [...queryKeys.base(url), "config", args]
139
+ indexingStatus: (url) => [...queryKeys.base(url), "indexing-status"]
129
140
  };
130
141
  function createRecordsQueryOptions(config, args) {
131
142
  return {
@@ -167,13 +178,13 @@ function createENSIndexerConfigQueryOptions(config) {
167
178
  }
168
179
  };
169
180
  }
170
- function createIndexingStatusQueryOptions(config, args) {
181
+ function createIndexingStatusQueryOptions(config) {
171
182
  return {
172
183
  enabled: true,
173
- queryKey: queryKeys.indexingStatus(config.client.url.href, args),
184
+ queryKey: queryKeys.indexingStatus(config.client.url.href),
174
185
  queryFn: async () => {
175
186
  const client = new import_ensnode_sdk2.ENSNodeClient(config.client);
176
- return client.indexingStatus(args);
187
+ return client.indexingStatus();
177
188
  }
178
189
  };
179
190
  }
@@ -230,6 +241,7 @@ function useENSIndexerConfig(parameters = {}) {
230
241
  const queryOptions = createENSIndexerConfigQueryOptions(_config);
231
242
  const options = {
232
243
  ...queryOptions,
244
+ ...ASSUME_IMMUTABLE_QUERY,
233
245
  ...query,
234
246
  enabled: query.enabled ?? queryOptions.enabled
235
247
  };
@@ -239,14 +251,59 @@ function useENSIndexerConfig(parameters = {}) {
239
251
  // src/hooks/useIndexingStatus.ts
240
252
  var import_react_query6 = require("@tanstack/react-query");
241
253
  function useIndexingStatus(parameters = {}) {
242
- const { config, query = {}, ...args } = parameters;
254
+ const { config, query = {} } = parameters;
243
255
  const _config = useENSNodeConfig(config);
244
- const queryOptions = createIndexingStatusQueryOptions(_config, { ...args });
256
+ const queryOptions = createIndexingStatusQueryOptions(_config);
245
257
  const options = {
246
258
  ...queryOptions,
259
+ refetchInterval: 10 * 1e3,
260
+ // 10 seconds - indexing status changes frequently
247
261
  ...query,
248
262
  enabled: query.enabled ?? queryOptions.enabled
249
263
  };
250
264
  return (0, import_react_query6.useQuery)(options);
251
265
  }
266
+
267
+ // src/hooks/useResolvedIdentity.ts
268
+ var import_ensnode_sdk3 = require("@ensnode/ensnode-sdk");
269
+ function useResolvedIdentity(parameters) {
270
+ const { identity, namespaceId, ...args } = parameters;
271
+ const {
272
+ data: primaryNameData,
273
+ status,
274
+ ...query
275
+ } = usePrimaryName({
276
+ address: identity.address,
277
+ chainId: (0, import_ensnode_sdk3.getResolvePrimaryNameChainIdParam)(identity.chainId, namespaceId),
278
+ ...args
279
+ });
280
+ let result;
281
+ if (status === "pending") {
282
+ result = identity;
283
+ } else if (status === "error") {
284
+ result = {
285
+ resolutionStatus: import_ensnode_sdk3.ResolutionStatusIds.Unknown,
286
+ chainId: identity.chainId,
287
+ address: identity.address
288
+ };
289
+ } else if (primaryNameData.name === null) {
290
+ result = {
291
+ resolutionStatus: import_ensnode_sdk3.ResolutionStatusIds.Unnamed,
292
+ chainId: identity.chainId,
293
+ address: identity.address,
294
+ name: null
295
+ };
296
+ } else {
297
+ result = {
298
+ resolutionStatus: import_ensnode_sdk3.ResolutionStatusIds.Named,
299
+ chainId: identity.chainId,
300
+ address: identity.address,
301
+ name: primaryNameData.name
302
+ };
303
+ }
304
+ return {
305
+ ...query,
306
+ identity: result
307
+ };
308
+ }
252
309
  //# sourceMappingURL=index.cjs.map
@@ -1 +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 * 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"]}
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","../src/hooks/useResolvedIdentity.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\";\nexport { ASSUME_IMMUTABLE_QUERY } from \"./utils/query\";\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 refetchInterval: 1000 * 10, // 10 seconds\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?: { url?: string | URL }): 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 { UndefinedInitialDataOptions } from \"@tanstack/react-query\";\nimport type { ENSNodeConfig } from \"../types\";\n\n/**\n * Immutable query options for data that is assumed to be immutable and should only be fetched once per full page refresh per unique key.\n * Similar to SWR's immutable: true API.\n *\n * Use this for data that is assumed not to change (e.g., records for a specific name) until the next full page refresh.\n *\n * @example\n * ```tsx\n * useRecords({\n * name: \"vitalik.eth\",\n * selection: { texts: [\"avatar\"] },\n * query: ASSUME_IMMUTABLE_QUERY\n * })\n * ```\n */\nexport const ASSUME_IMMUTABLE_QUERY = {\n staleTime: Infinity,\n gcTime: Infinity,\n refetchOnWindowFocus: false,\n refetchOnReconnect: false,\n refetchOnMount: false,\n} as const satisfies Partial<UndefinedInitialDataOptions>;\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) => [...queryKeys.base(url), \"indexing-status\"] 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(config: ENSNodeConfig) {\n return {\n enabled: true,\n queryKey: queryKeys.indexingStatus(config.client.url.href),\n queryFn: async () => {\n const client = new ENSNodeClient(config.client);\n return client.indexingStatus();\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 { ASSUME_IMMUTABLE_QUERY, 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 ...ASSUME_IMMUTABLE_QUERY,\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 = {} } = parameters;\n const _config = useENSNodeConfig(config);\n\n const queryOptions = createIndexingStatusQueryOptions(_config);\n\n const options = {\n ...queryOptions,\n refetchInterval: 10 * 1000, // 10 seconds - indexing status changes frequently\n ...query,\n enabled: query.enabled ?? queryOptions.enabled,\n };\n\n return useQuery(options);\n}\n","\"use client\";\n\nimport {\n ENSNamespaceId,\n Identity,\n NamedIdentity,\n ResolutionStatusIds,\n ResolvedIdentity,\n UnknownIdentity,\n UnnamedIdentity,\n UnresolvedIdentity,\n getResolvePrimaryNameChainIdParam,\n} from \"@ensnode/ensnode-sdk\";\nimport { usePrimaryName } from \"./usePrimaryName\";\n\n// TODO: `namespaceId` ideally would not be a parameter for this hook.\n// Ideally it should come from the active namespace context and be a nested hook within this hook.\n// However, currently this hook lives in ENSAdmin and not in `ensnode-react`.\n/**\n * Parameters for the useResolvedIdentity hook.\n */\nexport interface UseResolvedIdentityParameters {\n identity: UnresolvedIdentity;\n namespaceId: ENSNamespaceId;\n}\n\n/**\n * Hook to perform ENSIP-19 primary name resolution to resolve an\n * {@link UnresolvedIdentity} into a {@link ResolvedIdentity}.\n *\n * @param parameters - Configuration object for the hook\n * @param parameters.identity - An {@link UnresolvedIdentity} containing the {@link DefaultableChainId}\n * and {@link Address} to resolve.\n * @param parameters.namespaceId - The {@link ENSNamespaceId} that `identity.chainId` should be interpreted\n * through (via {@link getResolvePrimaryNameChainIdParam}) to determine the literal\n * chainId that should be used for ENSIP-19 primary name resolution.\n *\n * @returns An object containing:\n * - `identity`: An {@link Identity} with one of four possible {@link ResolutionStatusIds}:\n * - {@link ResolutionStatusIds.Unresolved}: While the query is pending (loading state).\n * - {@link ResolutionStatusIds.Unknown}: If an error occurs during resolution.\n * - {@link ResolutionStatusIds.Unnamed}: If the resolution found no primary name.\n * - {@link ResolutionStatusIds.Named}: If a primary name is successfully resolved.\n * - All other properties from the underlying {@link usePrimaryName} query (e.g., `isLoading`, `error`, `refetch`, etc.)\n */\nexport function useResolvedIdentity(parameters: UseResolvedIdentityParameters) {\n const { identity, namespaceId, ...args } = parameters;\n\n const {\n data: primaryNameData,\n status,\n ...query\n } = usePrimaryName({\n address: identity.address,\n chainId: getResolvePrimaryNameChainIdParam(identity.chainId, namespaceId),\n ...args,\n });\n\n let result: Identity;\n\n if (status === \"pending\") {\n // loading state\n // return the `UnresolvedIdentity` to support loading state functionality.\n result = identity;\n } else if (status === \"error\") {\n result = {\n resolutionStatus: ResolutionStatusIds.Unknown,\n chainId: identity.chainId,\n address: identity.address,\n } satisfies UnknownIdentity;\n } else if (primaryNameData.name === null) {\n result = {\n resolutionStatus: ResolutionStatusIds.Unnamed,\n chainId: identity.chainId,\n address: identity.address,\n name: null,\n } satisfies UnnamedIdentity;\n } else {\n result = {\n resolutionStatus: ResolutionStatusIds.Named,\n chainId: identity.chainId,\n address: identity.address,\n name: primaryNameData.name,\n } satisfies NamedIdentity;\n }\n\n return {\n ...query,\n identity: result,\n };\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","import_ensnode_sdk"]}
package/dist/index.d.cts CHANGED
@@ -2,7 +2,7 @@ import * as _tanstack_react_query from '@tanstack/react-query';
2
2
  import { QueryObserverOptions, QueryClient } from '@tanstack/react-query';
3
3
  export { QueryClient } from '@tanstack/react-query';
4
4
  import * as _ensnode_ensnode_sdk from '@ensnode/ensnode-sdk';
5
- import { ClientOptions, ResolverRecordsSelection, ResolveRecordsRequest, ResolveRecordsResponse, ResolvePrimaryNameRequest, ResolvePrimaryNameResponse, ResolvePrimaryNamesRequest, ResolvePrimaryNamesResponse, ConfigResponse, IndexingStatusRequest, IndexingStatusResponse } from '@ensnode/ensnode-sdk';
5
+ import { ClientOptions, ResolverRecordsSelection, ResolveRecordsRequest, ResolveRecordsResponse, ResolvePrimaryNameRequest, ResolvePrimaryNameResponse, ResolvePrimaryNamesRequest, ResolvePrimaryNamesResponse, ConfigResponse, IndexingStatusRequest, IndexingStatusResponse, UnresolvedIdentity, ENSNamespaceId, Identity } from '@ensnode/ensnode-sdk';
6
6
  export { ResolverRecordsSelection } from '@ensnode/ensnode-sdk';
7
7
  import * as react from 'react';
8
8
 
@@ -207,6 +207,207 @@ declare function useENSIndexerConfig(parameters?: ConfigParameter & UseENSIndexe
207
207
 
208
208
  interface UseIndexingStatusParameters extends IndexingStatusRequest, QueryParameter<IndexingStatusResponse> {
209
209
  }
210
- declare function useIndexingStatus(parameters?: ConfigParameter & UseIndexingStatusParameters): _tanstack_react_query.UseQueryResult<_ensnode_ensnode_sdk.ENSIndexerOverallIndexingStatus, Error>;
210
+ declare function useIndexingStatus(parameters?: ConfigParameter & UseIndexingStatusParameters): _tanstack_react_query.UseQueryResult<IndexingStatusResponse, Error>;
211
211
 
212
- export { type ConfigParameter, type ENSNodeConfig, ENSNodeContext, ENSNodeProvider, type ENSNodeProviderProps, type QueryParameter, type UsePrimaryNameParameters, type UsePrimaryNamesParameters, type UseRecordsParameters, createConfig, useENSIndexerConfig, useENSNodeConfig, useIndexingStatus, usePrimaryName, usePrimaryNames, useRecords };
212
+ /**
213
+ * Parameters for the useResolvedIdentity hook.
214
+ */
215
+ interface UseResolvedIdentityParameters {
216
+ identity: UnresolvedIdentity;
217
+ namespaceId: ENSNamespaceId;
218
+ }
219
+ /**
220
+ * Hook to perform ENSIP-19 primary name resolution to resolve an
221
+ * {@link UnresolvedIdentity} into a {@link ResolvedIdentity}.
222
+ *
223
+ * @param parameters - Configuration object for the hook
224
+ * @param parameters.identity - An {@link UnresolvedIdentity} containing the {@link DefaultableChainId}
225
+ * and {@link Address} to resolve.
226
+ * @param parameters.namespaceId - The {@link ENSNamespaceId} that `identity.chainId` should be interpreted
227
+ * through (via {@link getResolvePrimaryNameChainIdParam}) to determine the literal
228
+ * chainId that should be used for ENSIP-19 primary name resolution.
229
+ *
230
+ * @returns An object containing:
231
+ * - `identity`: An {@link Identity} with one of four possible {@link ResolutionStatusIds}:
232
+ * - {@link ResolutionStatusIds.Unresolved}: While the query is pending (loading state).
233
+ * - {@link ResolutionStatusIds.Unknown}: If an error occurs during resolution.
234
+ * - {@link ResolutionStatusIds.Unnamed}: If the resolution found no primary name.
235
+ * - {@link ResolutionStatusIds.Named}: If a primary name is successfully resolved.
236
+ * - All other properties from the underlying {@link usePrimaryName} query (e.g., `isLoading`, `error`, `refetch`, etc.)
237
+ */
238
+ declare function useResolvedIdentity(parameters: UseResolvedIdentityParameters): {
239
+ identity: Identity;
240
+ error: Error;
241
+ isError: true;
242
+ isPending: false;
243
+ isLoading: false;
244
+ isLoadingError: false;
245
+ isRefetchError: true;
246
+ isSuccess: false;
247
+ isPlaceholderData: false;
248
+ dataUpdatedAt: number;
249
+ errorUpdatedAt: number;
250
+ failureCount: number;
251
+ failureReason: Error | null;
252
+ errorUpdateCount: number;
253
+ isFetched: boolean;
254
+ isFetchedAfterMount: boolean;
255
+ isFetching: boolean;
256
+ isInitialLoading: boolean;
257
+ isPaused: boolean;
258
+ isRefetching: boolean;
259
+ isStale: boolean;
260
+ refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse, Error>>;
261
+ fetchStatus: _tanstack_react_query.FetchStatus;
262
+ promise: Promise<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse>;
263
+ } | {
264
+ identity: Identity;
265
+ error: null;
266
+ isError: false;
267
+ isPending: false;
268
+ isLoading: false;
269
+ isLoadingError: false;
270
+ isRefetchError: false;
271
+ isSuccess: true;
272
+ isPlaceholderData: false;
273
+ dataUpdatedAt: number;
274
+ errorUpdatedAt: number;
275
+ failureCount: number;
276
+ failureReason: Error | null;
277
+ errorUpdateCount: number;
278
+ isFetched: boolean;
279
+ isFetchedAfterMount: boolean;
280
+ isFetching: boolean;
281
+ isInitialLoading: boolean;
282
+ isPaused: boolean;
283
+ isRefetching: boolean;
284
+ isStale: boolean;
285
+ refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse, Error>>;
286
+ fetchStatus: _tanstack_react_query.FetchStatus;
287
+ promise: Promise<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse>;
288
+ } | {
289
+ identity: Identity;
290
+ error: Error;
291
+ isError: true;
292
+ isPending: false;
293
+ isLoading: false;
294
+ isLoadingError: true;
295
+ isRefetchError: false;
296
+ isSuccess: false;
297
+ isPlaceholderData: false;
298
+ dataUpdatedAt: number;
299
+ errorUpdatedAt: number;
300
+ failureCount: number;
301
+ failureReason: Error | null;
302
+ errorUpdateCount: number;
303
+ isFetched: boolean;
304
+ isFetchedAfterMount: boolean;
305
+ isFetching: boolean;
306
+ isInitialLoading: boolean;
307
+ isPaused: boolean;
308
+ isRefetching: boolean;
309
+ isStale: boolean;
310
+ refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse, Error>>;
311
+ fetchStatus: _tanstack_react_query.FetchStatus;
312
+ promise: Promise<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse>;
313
+ } | {
314
+ identity: Identity;
315
+ error: null;
316
+ isError: false;
317
+ isPending: true;
318
+ isLoading: true;
319
+ isLoadingError: false;
320
+ isRefetchError: false;
321
+ isSuccess: false;
322
+ isPlaceholderData: false;
323
+ dataUpdatedAt: number;
324
+ errorUpdatedAt: number;
325
+ failureCount: number;
326
+ failureReason: Error | null;
327
+ errorUpdateCount: number;
328
+ isFetched: boolean;
329
+ isFetchedAfterMount: boolean;
330
+ isFetching: boolean;
331
+ isInitialLoading: boolean;
332
+ isPaused: boolean;
333
+ isRefetching: boolean;
334
+ isStale: boolean;
335
+ refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse, Error>>;
336
+ fetchStatus: _tanstack_react_query.FetchStatus;
337
+ promise: Promise<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse>;
338
+ } | {
339
+ identity: Identity;
340
+ error: null;
341
+ isError: false;
342
+ isPending: true;
343
+ isLoadingError: false;
344
+ isRefetchError: false;
345
+ isSuccess: false;
346
+ isPlaceholderData: false;
347
+ dataUpdatedAt: number;
348
+ errorUpdatedAt: number;
349
+ failureCount: number;
350
+ failureReason: Error | null;
351
+ errorUpdateCount: number;
352
+ isFetched: boolean;
353
+ isFetchedAfterMount: boolean;
354
+ isFetching: boolean;
355
+ isLoading: boolean;
356
+ isInitialLoading: boolean;
357
+ isPaused: boolean;
358
+ isRefetching: boolean;
359
+ isStale: boolean;
360
+ refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse, Error>>;
361
+ fetchStatus: _tanstack_react_query.FetchStatus;
362
+ promise: Promise<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse>;
363
+ } | {
364
+ identity: Identity;
365
+ isError: false;
366
+ error: null;
367
+ isPending: false;
368
+ isLoading: false;
369
+ isLoadingError: false;
370
+ isRefetchError: false;
371
+ isSuccess: true;
372
+ isPlaceholderData: true;
373
+ dataUpdatedAt: number;
374
+ errorUpdatedAt: number;
375
+ failureCount: number;
376
+ failureReason: Error | null;
377
+ errorUpdateCount: number;
378
+ isFetched: boolean;
379
+ isFetchedAfterMount: boolean;
380
+ isFetching: boolean;
381
+ isInitialLoading: boolean;
382
+ isPaused: boolean;
383
+ isRefetching: boolean;
384
+ isStale: boolean;
385
+ refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse, Error>>;
386
+ fetchStatus: _tanstack_react_query.FetchStatus;
387
+ promise: Promise<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse>;
388
+ };
389
+
390
+ /**
391
+ * Immutable query options for data that is assumed to be immutable and should only be fetched once per full page refresh per unique key.
392
+ * Similar to SWR's immutable: true API.
393
+ *
394
+ * Use this for data that is assumed not to change (e.g., records for a specific name) until the next full page refresh.
395
+ *
396
+ * @example
397
+ * ```tsx
398
+ * useRecords({
399
+ * name: "vitalik.eth",
400
+ * selection: { texts: ["avatar"] },
401
+ * query: ASSUME_IMMUTABLE_QUERY
402
+ * })
403
+ * ```
404
+ */
405
+ declare const ASSUME_IMMUTABLE_QUERY: {
406
+ readonly staleTime: number;
407
+ readonly gcTime: number;
408
+ readonly refetchOnWindowFocus: false;
409
+ readonly refetchOnReconnect: false;
410
+ readonly refetchOnMount: false;
411
+ };
412
+
413
+ export { ASSUME_IMMUTABLE_QUERY, type ConfigParameter, type ENSNodeConfig, ENSNodeContext, ENSNodeProvider, type ENSNodeProviderProps, type QueryParameter, type UsePrimaryNameParameters, type UsePrimaryNamesParameters, type UseRecordsParameters, type UseResolvedIdentityParameters, createConfig, useENSIndexerConfig, useENSNodeConfig, useIndexingStatus, usePrimaryName, usePrimaryNames, useRecords, useResolvedIdentity };
package/dist/index.d.ts CHANGED
@@ -2,7 +2,7 @@ import * as _tanstack_react_query from '@tanstack/react-query';
2
2
  import { QueryObserverOptions, QueryClient } from '@tanstack/react-query';
3
3
  export { QueryClient } from '@tanstack/react-query';
4
4
  import * as _ensnode_ensnode_sdk from '@ensnode/ensnode-sdk';
5
- import { ClientOptions, ResolverRecordsSelection, ResolveRecordsRequest, ResolveRecordsResponse, ResolvePrimaryNameRequest, ResolvePrimaryNameResponse, ResolvePrimaryNamesRequest, ResolvePrimaryNamesResponse, ConfigResponse, IndexingStatusRequest, IndexingStatusResponse } from '@ensnode/ensnode-sdk';
5
+ import { ClientOptions, ResolverRecordsSelection, ResolveRecordsRequest, ResolveRecordsResponse, ResolvePrimaryNameRequest, ResolvePrimaryNameResponse, ResolvePrimaryNamesRequest, ResolvePrimaryNamesResponse, ConfigResponse, IndexingStatusRequest, IndexingStatusResponse, UnresolvedIdentity, ENSNamespaceId, Identity } from '@ensnode/ensnode-sdk';
6
6
  export { ResolverRecordsSelection } from '@ensnode/ensnode-sdk';
7
7
  import * as react from 'react';
8
8
 
@@ -207,6 +207,207 @@ declare function useENSIndexerConfig(parameters?: ConfigParameter & UseENSIndexe
207
207
 
208
208
  interface UseIndexingStatusParameters extends IndexingStatusRequest, QueryParameter<IndexingStatusResponse> {
209
209
  }
210
- declare function useIndexingStatus(parameters?: ConfigParameter & UseIndexingStatusParameters): _tanstack_react_query.UseQueryResult<_ensnode_ensnode_sdk.ENSIndexerOverallIndexingStatus, Error>;
210
+ declare function useIndexingStatus(parameters?: ConfigParameter & UseIndexingStatusParameters): _tanstack_react_query.UseQueryResult<IndexingStatusResponse, Error>;
211
211
 
212
- export { type ConfigParameter, type ENSNodeConfig, ENSNodeContext, ENSNodeProvider, type ENSNodeProviderProps, type QueryParameter, type UsePrimaryNameParameters, type UsePrimaryNamesParameters, type UseRecordsParameters, createConfig, useENSIndexerConfig, useENSNodeConfig, useIndexingStatus, usePrimaryName, usePrimaryNames, useRecords };
212
+ /**
213
+ * Parameters for the useResolvedIdentity hook.
214
+ */
215
+ interface UseResolvedIdentityParameters {
216
+ identity: UnresolvedIdentity;
217
+ namespaceId: ENSNamespaceId;
218
+ }
219
+ /**
220
+ * Hook to perform ENSIP-19 primary name resolution to resolve an
221
+ * {@link UnresolvedIdentity} into a {@link ResolvedIdentity}.
222
+ *
223
+ * @param parameters - Configuration object for the hook
224
+ * @param parameters.identity - An {@link UnresolvedIdentity} containing the {@link DefaultableChainId}
225
+ * and {@link Address} to resolve.
226
+ * @param parameters.namespaceId - The {@link ENSNamespaceId} that `identity.chainId` should be interpreted
227
+ * through (via {@link getResolvePrimaryNameChainIdParam}) to determine the literal
228
+ * chainId that should be used for ENSIP-19 primary name resolution.
229
+ *
230
+ * @returns An object containing:
231
+ * - `identity`: An {@link Identity} with one of four possible {@link ResolutionStatusIds}:
232
+ * - {@link ResolutionStatusIds.Unresolved}: While the query is pending (loading state).
233
+ * - {@link ResolutionStatusIds.Unknown}: If an error occurs during resolution.
234
+ * - {@link ResolutionStatusIds.Unnamed}: If the resolution found no primary name.
235
+ * - {@link ResolutionStatusIds.Named}: If a primary name is successfully resolved.
236
+ * - All other properties from the underlying {@link usePrimaryName} query (e.g., `isLoading`, `error`, `refetch`, etc.)
237
+ */
238
+ declare function useResolvedIdentity(parameters: UseResolvedIdentityParameters): {
239
+ identity: Identity;
240
+ error: Error;
241
+ isError: true;
242
+ isPending: false;
243
+ isLoading: false;
244
+ isLoadingError: false;
245
+ isRefetchError: true;
246
+ isSuccess: false;
247
+ isPlaceholderData: false;
248
+ dataUpdatedAt: number;
249
+ errorUpdatedAt: number;
250
+ failureCount: number;
251
+ failureReason: Error | null;
252
+ errorUpdateCount: number;
253
+ isFetched: boolean;
254
+ isFetchedAfterMount: boolean;
255
+ isFetching: boolean;
256
+ isInitialLoading: boolean;
257
+ isPaused: boolean;
258
+ isRefetching: boolean;
259
+ isStale: boolean;
260
+ refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse, Error>>;
261
+ fetchStatus: _tanstack_react_query.FetchStatus;
262
+ promise: Promise<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse>;
263
+ } | {
264
+ identity: Identity;
265
+ error: null;
266
+ isError: false;
267
+ isPending: false;
268
+ isLoading: false;
269
+ isLoadingError: false;
270
+ isRefetchError: false;
271
+ isSuccess: true;
272
+ isPlaceholderData: false;
273
+ dataUpdatedAt: number;
274
+ errorUpdatedAt: number;
275
+ failureCount: number;
276
+ failureReason: Error | null;
277
+ errorUpdateCount: number;
278
+ isFetched: boolean;
279
+ isFetchedAfterMount: boolean;
280
+ isFetching: boolean;
281
+ isInitialLoading: boolean;
282
+ isPaused: boolean;
283
+ isRefetching: boolean;
284
+ isStale: boolean;
285
+ refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse, Error>>;
286
+ fetchStatus: _tanstack_react_query.FetchStatus;
287
+ promise: Promise<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse>;
288
+ } | {
289
+ identity: Identity;
290
+ error: Error;
291
+ isError: true;
292
+ isPending: false;
293
+ isLoading: false;
294
+ isLoadingError: true;
295
+ isRefetchError: false;
296
+ isSuccess: false;
297
+ isPlaceholderData: false;
298
+ dataUpdatedAt: number;
299
+ errorUpdatedAt: number;
300
+ failureCount: number;
301
+ failureReason: Error | null;
302
+ errorUpdateCount: number;
303
+ isFetched: boolean;
304
+ isFetchedAfterMount: boolean;
305
+ isFetching: boolean;
306
+ isInitialLoading: boolean;
307
+ isPaused: boolean;
308
+ isRefetching: boolean;
309
+ isStale: boolean;
310
+ refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse, Error>>;
311
+ fetchStatus: _tanstack_react_query.FetchStatus;
312
+ promise: Promise<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse>;
313
+ } | {
314
+ identity: Identity;
315
+ error: null;
316
+ isError: false;
317
+ isPending: true;
318
+ isLoading: true;
319
+ isLoadingError: false;
320
+ isRefetchError: false;
321
+ isSuccess: false;
322
+ isPlaceholderData: false;
323
+ dataUpdatedAt: number;
324
+ errorUpdatedAt: number;
325
+ failureCount: number;
326
+ failureReason: Error | null;
327
+ errorUpdateCount: number;
328
+ isFetched: boolean;
329
+ isFetchedAfterMount: boolean;
330
+ isFetching: boolean;
331
+ isInitialLoading: boolean;
332
+ isPaused: boolean;
333
+ isRefetching: boolean;
334
+ isStale: boolean;
335
+ refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse, Error>>;
336
+ fetchStatus: _tanstack_react_query.FetchStatus;
337
+ promise: Promise<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse>;
338
+ } | {
339
+ identity: Identity;
340
+ error: null;
341
+ isError: false;
342
+ isPending: true;
343
+ isLoadingError: false;
344
+ isRefetchError: false;
345
+ isSuccess: false;
346
+ isPlaceholderData: false;
347
+ dataUpdatedAt: number;
348
+ errorUpdatedAt: number;
349
+ failureCount: number;
350
+ failureReason: Error | null;
351
+ errorUpdateCount: number;
352
+ isFetched: boolean;
353
+ isFetchedAfterMount: boolean;
354
+ isFetching: boolean;
355
+ isLoading: boolean;
356
+ isInitialLoading: boolean;
357
+ isPaused: boolean;
358
+ isRefetching: boolean;
359
+ isStale: boolean;
360
+ refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse, Error>>;
361
+ fetchStatus: _tanstack_react_query.FetchStatus;
362
+ promise: Promise<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse>;
363
+ } | {
364
+ identity: Identity;
365
+ isError: false;
366
+ error: null;
367
+ isPending: false;
368
+ isLoading: false;
369
+ isLoadingError: false;
370
+ isRefetchError: false;
371
+ isSuccess: true;
372
+ isPlaceholderData: true;
373
+ dataUpdatedAt: number;
374
+ errorUpdatedAt: number;
375
+ failureCount: number;
376
+ failureReason: Error | null;
377
+ errorUpdateCount: number;
378
+ isFetched: boolean;
379
+ isFetchedAfterMount: boolean;
380
+ isFetching: boolean;
381
+ isInitialLoading: boolean;
382
+ isPaused: boolean;
383
+ isRefetching: boolean;
384
+ isStale: boolean;
385
+ refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse, Error>>;
386
+ fetchStatus: _tanstack_react_query.FetchStatus;
387
+ promise: Promise<_ensnode_ensnode_sdk.ResolvePrimaryNameResponse>;
388
+ };
389
+
390
+ /**
391
+ * Immutable query options for data that is assumed to be immutable and should only be fetched once per full page refresh per unique key.
392
+ * Similar to SWR's immutable: true API.
393
+ *
394
+ * Use this for data that is assumed not to change (e.g., records for a specific name) until the next full page refresh.
395
+ *
396
+ * @example
397
+ * ```tsx
398
+ * useRecords({
399
+ * name: "vitalik.eth",
400
+ * selection: { texts: ["avatar"] },
401
+ * query: ASSUME_IMMUTABLE_QUERY
402
+ * })
403
+ * ```
404
+ */
405
+ declare const ASSUME_IMMUTABLE_QUERY: {
406
+ readonly staleTime: number;
407
+ readonly gcTime: number;
408
+ readonly refetchOnWindowFocus: false;
409
+ readonly refetchOnReconnect: false;
410
+ readonly refetchOnMount: false;
411
+ };
412
+
413
+ export { ASSUME_IMMUTABLE_QUERY, type ConfigParameter, type ENSNodeConfig, ENSNodeContext, ENSNodeProvider, type ENSNodeProviderProps, type QueryParameter, type UsePrimaryNameParameters, type UsePrimaryNamesParameters, type UseRecordsParameters, type UseResolvedIdentityParameters, createConfig, useENSIndexerConfig, useENSNodeConfig, useIndexingStatus, usePrimaryName, usePrimaryNames, useRecords, useResolvedIdentity };
package/dist/index.js CHANGED
@@ -42,8 +42,10 @@ function ENSNodeProvider(parameters) {
42
42
  retry: 3,
43
43
  staleTime: 1e3 * 60 * 5,
44
44
  // 5 minutes
45
- gcTime: 1e3 * 60 * 30
45
+ gcTime: 1e3 * 60 * 30,
46
46
  // 30 minutes
47
+ refetchInterval: 1e3 * 10
48
+ // 10 seconds
47
49
  }
48
50
  },
49
51
  ...queryClientOptions
@@ -86,6 +88,13 @@ import { useQuery } from "@tanstack/react-query";
86
88
  import {
87
89
  ENSNodeClient as ENSNodeClient2
88
90
  } from "@ensnode/ensnode-sdk";
91
+ var ASSUME_IMMUTABLE_QUERY = {
92
+ staleTime: Infinity,
93
+ gcTime: Infinity,
94
+ refetchOnWindowFocus: false,
95
+ refetchOnReconnect: false,
96
+ refetchOnMount: false
97
+ };
89
98
  var queryKeys = {
90
99
  base: (url) => ["ensnode", url],
91
100
  resolve: (url) => [...queryKeys.base(url), "resolve"],
@@ -93,7 +102,7 @@ var queryKeys = {
93
102
  primaryName: (url, args) => [...queryKeys.resolve(url), "primary-name", args],
94
103
  primaryNames: (url, args) => [...queryKeys.resolve(url), "primary-names", args],
95
104
  config: (url) => [...queryKeys.base(url), "config"],
96
- indexingStatus: (url, args) => [...queryKeys.base(url), "config", args]
105
+ indexingStatus: (url) => [...queryKeys.base(url), "indexing-status"]
97
106
  };
98
107
  function createRecordsQueryOptions(config, args) {
99
108
  return {
@@ -135,13 +144,13 @@ function createENSIndexerConfigQueryOptions(config) {
135
144
  }
136
145
  };
137
146
  }
138
- function createIndexingStatusQueryOptions(config, args) {
147
+ function createIndexingStatusQueryOptions(config) {
139
148
  return {
140
149
  enabled: true,
141
- queryKey: queryKeys.indexingStatus(config.client.url.href, args),
150
+ queryKey: queryKeys.indexingStatus(config.client.url.href),
142
151
  queryFn: async () => {
143
152
  const client = new ENSNodeClient2(config.client);
144
- return client.indexingStatus(args);
153
+ return client.indexingStatus();
145
154
  }
146
155
  };
147
156
  }
@@ -198,6 +207,7 @@ function useENSIndexerConfig(parameters = {}) {
198
207
  const queryOptions = createENSIndexerConfigQueryOptions(_config);
199
208
  const options = {
200
209
  ...queryOptions,
210
+ ...ASSUME_IMMUTABLE_QUERY,
201
211
  ...query,
202
212
  enabled: query.enabled ?? queryOptions.enabled
203
213
  };
@@ -207,17 +217,66 @@ function useENSIndexerConfig(parameters = {}) {
207
217
  // src/hooks/useIndexingStatus.ts
208
218
  import { useQuery as useQuery5 } from "@tanstack/react-query";
209
219
  function useIndexingStatus(parameters = {}) {
210
- const { config, query = {}, ...args } = parameters;
220
+ const { config, query = {} } = parameters;
211
221
  const _config = useENSNodeConfig(config);
212
- const queryOptions = createIndexingStatusQueryOptions(_config, { ...args });
222
+ const queryOptions = createIndexingStatusQueryOptions(_config);
213
223
  const options = {
214
224
  ...queryOptions,
225
+ refetchInterval: 10 * 1e3,
226
+ // 10 seconds - indexing status changes frequently
215
227
  ...query,
216
228
  enabled: query.enabled ?? queryOptions.enabled
217
229
  };
218
230
  return useQuery5(options);
219
231
  }
232
+
233
+ // src/hooks/useResolvedIdentity.ts
234
+ import {
235
+ ResolutionStatusIds,
236
+ getResolvePrimaryNameChainIdParam
237
+ } from "@ensnode/ensnode-sdk";
238
+ function useResolvedIdentity(parameters) {
239
+ const { identity, namespaceId, ...args } = parameters;
240
+ const {
241
+ data: primaryNameData,
242
+ status,
243
+ ...query
244
+ } = usePrimaryName({
245
+ address: identity.address,
246
+ chainId: getResolvePrimaryNameChainIdParam(identity.chainId, namespaceId),
247
+ ...args
248
+ });
249
+ let result;
250
+ if (status === "pending") {
251
+ result = identity;
252
+ } else if (status === "error") {
253
+ result = {
254
+ resolutionStatus: ResolutionStatusIds.Unknown,
255
+ chainId: identity.chainId,
256
+ address: identity.address
257
+ };
258
+ } else if (primaryNameData.name === null) {
259
+ result = {
260
+ resolutionStatus: ResolutionStatusIds.Unnamed,
261
+ chainId: identity.chainId,
262
+ address: identity.address,
263
+ name: null
264
+ };
265
+ } else {
266
+ result = {
267
+ resolutionStatus: ResolutionStatusIds.Named,
268
+ chainId: identity.chainId,
269
+ address: identity.address,
270
+ name: primaryNameData.name
271
+ };
272
+ }
273
+ return {
274
+ ...query,
275
+ identity: result
276
+ };
277
+ }
220
278
  export {
279
+ ASSUME_IMMUTABLE_QUERY,
221
280
  ENSNodeContext,
222
281
  ENSNodeProvider,
223
282
  createConfig,
@@ -226,6 +285,7 @@ export {
226
285
  useIndexingStatus,
227
286
  usePrimaryName,
228
287
  usePrimaryNames,
229
- useRecords
288
+ useRecords,
289
+ useResolvedIdentity
230
290
  };
231
291
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +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 * 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"]}
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","../src/hooks/useResolvedIdentity.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 refetchInterval: 1000 * 10, // 10 seconds\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?: { url?: string | URL }): 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 { UndefinedInitialDataOptions } from \"@tanstack/react-query\";\nimport type { ENSNodeConfig } from \"../types\";\n\n/**\n * Immutable query options for data that is assumed to be immutable and should only be fetched once per full page refresh per unique key.\n * Similar to SWR's immutable: true API.\n *\n * Use this for data that is assumed not to change (e.g., records for a specific name) until the next full page refresh.\n *\n * @example\n * ```tsx\n * useRecords({\n * name: \"vitalik.eth\",\n * selection: { texts: [\"avatar\"] },\n * query: ASSUME_IMMUTABLE_QUERY\n * })\n * ```\n */\nexport const ASSUME_IMMUTABLE_QUERY = {\n staleTime: Infinity,\n gcTime: Infinity,\n refetchOnWindowFocus: false,\n refetchOnReconnect: false,\n refetchOnMount: false,\n} as const satisfies Partial<UndefinedInitialDataOptions>;\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) => [...queryKeys.base(url), \"indexing-status\"] 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(config: ENSNodeConfig) {\n return {\n enabled: true,\n queryKey: queryKeys.indexingStatus(config.client.url.href),\n queryFn: async () => {\n const client = new ENSNodeClient(config.client);\n return client.indexingStatus();\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 { ASSUME_IMMUTABLE_QUERY, 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 ...ASSUME_IMMUTABLE_QUERY,\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 = {} } = parameters;\n const _config = useENSNodeConfig(config);\n\n const queryOptions = createIndexingStatusQueryOptions(_config);\n\n const options = {\n ...queryOptions,\n refetchInterval: 10 * 1000, // 10 seconds - indexing status changes frequently\n ...query,\n enabled: query.enabled ?? queryOptions.enabled,\n };\n\n return useQuery(options);\n}\n","\"use client\";\n\nimport {\n ENSNamespaceId,\n Identity,\n NamedIdentity,\n ResolutionStatusIds,\n ResolvedIdentity,\n UnknownIdentity,\n UnnamedIdentity,\n UnresolvedIdentity,\n getResolvePrimaryNameChainIdParam,\n} from \"@ensnode/ensnode-sdk\";\nimport { usePrimaryName } from \"./usePrimaryName\";\n\n// TODO: `namespaceId` ideally would not be a parameter for this hook.\n// Ideally it should come from the active namespace context and be a nested hook within this hook.\n// However, currently this hook lives in ENSAdmin and not in `ensnode-react`.\n/**\n * Parameters for the useResolvedIdentity hook.\n */\nexport interface UseResolvedIdentityParameters {\n identity: UnresolvedIdentity;\n namespaceId: ENSNamespaceId;\n}\n\n/**\n * Hook to perform ENSIP-19 primary name resolution to resolve an\n * {@link UnresolvedIdentity} into a {@link ResolvedIdentity}.\n *\n * @param parameters - Configuration object for the hook\n * @param parameters.identity - An {@link UnresolvedIdentity} containing the {@link DefaultableChainId}\n * and {@link Address} to resolve.\n * @param parameters.namespaceId - The {@link ENSNamespaceId} that `identity.chainId` should be interpreted\n * through (via {@link getResolvePrimaryNameChainIdParam}) to determine the literal\n * chainId that should be used for ENSIP-19 primary name resolution.\n *\n * @returns An object containing:\n * - `identity`: An {@link Identity} with one of four possible {@link ResolutionStatusIds}:\n * - {@link ResolutionStatusIds.Unresolved}: While the query is pending (loading state).\n * - {@link ResolutionStatusIds.Unknown}: If an error occurs during resolution.\n * - {@link ResolutionStatusIds.Unnamed}: If the resolution found no primary name.\n * - {@link ResolutionStatusIds.Named}: If a primary name is successfully resolved.\n * - All other properties from the underlying {@link usePrimaryName} query (e.g., `isLoading`, `error`, `refetch`, etc.)\n */\nexport function useResolvedIdentity(parameters: UseResolvedIdentityParameters) {\n const { identity, namespaceId, ...args } = parameters;\n\n const {\n data: primaryNameData,\n status,\n ...query\n } = usePrimaryName({\n address: identity.address,\n chainId: getResolvePrimaryNameChainIdParam(identity.chainId, namespaceId),\n ...args,\n });\n\n let result: Identity;\n\n if (status === \"pending\") {\n // loading state\n // return the `UnresolvedIdentity` to support loading state functionality.\n result = identity;\n } else if (status === \"error\") {\n result = {\n resolutionStatus: ResolutionStatusIds.Unknown,\n chainId: identity.chainId,\n address: identity.address,\n } satisfies UnknownIdentity;\n } else if (primaryNameData.name === null) {\n result = {\n resolutionStatus: ResolutionStatusIds.Unnamed,\n chainId: identity.chainId,\n address: identity.address,\n name: null,\n } satisfies UnnamedIdentity;\n } else {\n result = {\n resolutionStatus: ResolutionStatusIds.Named,\n chainId: identity.chainId,\n address: identity.address,\n name: primaryNameData.name,\n } satisfies NamedIdentity;\n }\n\n return {\n ...query,\n identity: result,\n };\n}\n"],"mappings":"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","names":["ENSNodeClient","useQuery","useQuery","useQuery","useQuery","useQuery","useQuery","useQuery","useQuery"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ensnode/ensnode-react",
3
- "version": "0.35.0",
3
+ "version": "0.36.0",
4
4
  "type": "module",
5
5
  "description": "React hooks and providers for ENSNode",
6
6
  "license": "MIT",
@@ -39,17 +39,15 @@
39
39
  "@testing-library/user-event": "^14.5.2",
40
40
  "@types/node": "^22.14.0",
41
41
  "@types/react": "^18.3.17",
42
- "@vitest/coverage-v8": "^3.1.1",
43
- "jsdom": "^26.0.0",
44
42
  "react": "^18.3.1",
45
43
  "react-dom": "^18.3.1",
46
44
  "tsup": "^8.3.6",
47
45
  "typescript": "^5.7.3",
48
- "vitest": "^3.1.1",
49
- "@ensnode/shared-configs": "0.35.0"
46
+ "vitest": "^3.2.4",
47
+ "@ensnode/shared-configs": "0.36.0"
50
48
  },
51
49
  "dependencies": {
52
- "@ensnode/ensnode-sdk": "0.35.0"
50
+ "@ensnode/ensnode-sdk": "0.36.0"
53
51
  },
54
52
  "scripts": {
55
53
  "prepublish": "tsup",