@ensnode/ensnode-react 0.0.0-next-20260102143513
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/LICENSE +21 -0
- package/README.md +339 -0
- package/dist/index.cjs +418 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +553 -0
- package/dist/index.d.ts +553 -0
- package/dist/index.js +404 -0
- package/dist/index.js.map +1 -0
- package/package.json +58 -0
package/dist/index.cjs
ADDED
|
@@ -0,0 +1,418 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
+
var __export = (target, all) => {
|
|
7
|
+
for (var name in all)
|
|
8
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
9
|
+
};
|
|
10
|
+
var __copyProps = (to, from, except, desc) => {
|
|
11
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
12
|
+
for (let key of __getOwnPropNames(from))
|
|
13
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
14
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
15
|
+
}
|
|
16
|
+
return to;
|
|
17
|
+
};
|
|
18
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
19
|
+
|
|
20
|
+
// src/index.ts
|
|
21
|
+
var index_exports = {};
|
|
22
|
+
__export(index_exports, {
|
|
23
|
+
ASSUME_IMMUTABLE_QUERY: () => ASSUME_IMMUTABLE_QUERY,
|
|
24
|
+
ENSNodeContext: () => ENSNodeContext,
|
|
25
|
+
ENSNodeProvider: () => ENSNodeProvider,
|
|
26
|
+
createConfig: () => createConfig,
|
|
27
|
+
createConfigQueryOptions: () => createConfigQueryOptions,
|
|
28
|
+
createIndexingStatusQueryOptions: () => createIndexingStatusQueryOptions,
|
|
29
|
+
createNameTokensQueryOptions: () => createNameTokensQueryOptions,
|
|
30
|
+
createPrimaryNameQueryOptions: () => createPrimaryNameQueryOptions,
|
|
31
|
+
createPrimaryNamesQueryOptions: () => createPrimaryNamesQueryOptions,
|
|
32
|
+
createRecordsQueryOptions: () => createRecordsQueryOptions,
|
|
33
|
+
createRegistrarActionsQueryOptions: () => createRegistrarActionsQueryOptions,
|
|
34
|
+
queryKeys: () => queryKeys,
|
|
35
|
+
useENSNodeConfig: () => useENSNodeConfig,
|
|
36
|
+
useENSNodeSDKConfig: () => useENSNodeSDKConfig,
|
|
37
|
+
useIndexingStatus: () => useIndexingStatus,
|
|
38
|
+
useNameTokens: () => useNameTokens,
|
|
39
|
+
usePrimaryName: () => usePrimaryName,
|
|
40
|
+
usePrimaryNames: () => usePrimaryNames,
|
|
41
|
+
useRecords: () => useRecords,
|
|
42
|
+
useRegistrarActions: () => useRegistrarActions,
|
|
43
|
+
useResolvedIdentity: () => useResolvedIdentity,
|
|
44
|
+
useSwrQuery: () => useSwrQuery
|
|
45
|
+
});
|
|
46
|
+
module.exports = __toCommonJS(index_exports);
|
|
47
|
+
|
|
48
|
+
// src/context.ts
|
|
49
|
+
var import_react = require("react");
|
|
50
|
+
var ENSNodeContext = (0, import_react.createContext)(void 0);
|
|
51
|
+
ENSNodeContext.displayName = "ENSNodeContext";
|
|
52
|
+
|
|
53
|
+
// src/hooks/useENSNodeConfig.ts
|
|
54
|
+
var import_react_query = require("@tanstack/react-query");
|
|
55
|
+
|
|
56
|
+
// src/utils/query.ts
|
|
57
|
+
var import_ensnode_sdk = require("@ensnode/ensnode-sdk");
|
|
58
|
+
var ASSUME_IMMUTABLE_QUERY = {
|
|
59
|
+
staleTime: Infinity,
|
|
60
|
+
gcTime: Infinity,
|
|
61
|
+
refetchOnWindowFocus: false,
|
|
62
|
+
refetchOnReconnect: false,
|
|
63
|
+
refetchOnMount: false
|
|
64
|
+
};
|
|
65
|
+
var queryKeys = {
|
|
66
|
+
base: (url) => ["ensnode", url],
|
|
67
|
+
resolve: (url) => [...queryKeys.base(url), "resolve"],
|
|
68
|
+
records: (url, args) => [...queryKeys.resolve(url), "records", args],
|
|
69
|
+
primaryName: (url, args) => [...queryKeys.resolve(url), "primary-name", args],
|
|
70
|
+
primaryNames: (url, args) => [...queryKeys.resolve(url), "primary-names", args],
|
|
71
|
+
config: (url) => [...queryKeys.base(url), "config"],
|
|
72
|
+
indexingStatus: (url) => [...queryKeys.base(url), "indexing-status"],
|
|
73
|
+
registrarActions: (url, args) => [...queryKeys.base(url), "registrar-actions", args],
|
|
74
|
+
nameTokens: (url, args) => [...queryKeys.base(url), "name-tokens", args]
|
|
75
|
+
};
|
|
76
|
+
function createRecordsQueryOptions(config, args) {
|
|
77
|
+
return {
|
|
78
|
+
enabled: true,
|
|
79
|
+
queryKey: queryKeys.records(config.client.url.href, args),
|
|
80
|
+
queryFn: async () => {
|
|
81
|
+
const client = new import_ensnode_sdk.ENSNodeClient(config.client);
|
|
82
|
+
return client.resolveRecords(args.name, args.selection, args);
|
|
83
|
+
}
|
|
84
|
+
};
|
|
85
|
+
}
|
|
86
|
+
function createPrimaryNameQueryOptions(config, args) {
|
|
87
|
+
return {
|
|
88
|
+
enabled: true,
|
|
89
|
+
queryKey: queryKeys.primaryName(config.client.url.href, args),
|
|
90
|
+
queryFn: async () => {
|
|
91
|
+
const client = new import_ensnode_sdk.ENSNodeClient(config.client);
|
|
92
|
+
return client.resolvePrimaryName(args.address, args.chainId, args);
|
|
93
|
+
}
|
|
94
|
+
};
|
|
95
|
+
}
|
|
96
|
+
function createPrimaryNamesQueryOptions(config, args) {
|
|
97
|
+
return {
|
|
98
|
+
enabled: true,
|
|
99
|
+
queryKey: queryKeys.primaryNames(config.client.url.href, args),
|
|
100
|
+
queryFn: async () => {
|
|
101
|
+
const client = new import_ensnode_sdk.ENSNodeClient(config.client);
|
|
102
|
+
return client.resolvePrimaryNames(args.address, args);
|
|
103
|
+
}
|
|
104
|
+
};
|
|
105
|
+
}
|
|
106
|
+
function createConfigQueryOptions(config) {
|
|
107
|
+
return {
|
|
108
|
+
enabled: true,
|
|
109
|
+
queryKey: queryKeys.config(config.client.url.href),
|
|
110
|
+
queryFn: async () => {
|
|
111
|
+
const client = new import_ensnode_sdk.ENSNodeClient(config.client);
|
|
112
|
+
return client.config();
|
|
113
|
+
}
|
|
114
|
+
};
|
|
115
|
+
}
|
|
116
|
+
function createIndexingStatusQueryOptions(config) {
|
|
117
|
+
return {
|
|
118
|
+
enabled: true,
|
|
119
|
+
queryKey: queryKeys.indexingStatus(config.client.url.href),
|
|
120
|
+
queryFn: async () => {
|
|
121
|
+
const client = new import_ensnode_sdk.ENSNodeClient(config.client);
|
|
122
|
+
return client.indexingStatus();
|
|
123
|
+
}
|
|
124
|
+
};
|
|
125
|
+
}
|
|
126
|
+
function createRegistrarActionsQueryOptions(config, args) {
|
|
127
|
+
return {
|
|
128
|
+
enabled: true,
|
|
129
|
+
queryKey: queryKeys.registrarActions(config.client.url.href, args),
|
|
130
|
+
queryFn: async () => {
|
|
131
|
+
const client = new import_ensnode_sdk.ENSNodeClient(config.client);
|
|
132
|
+
return client.registrarActions(args);
|
|
133
|
+
}
|
|
134
|
+
};
|
|
135
|
+
}
|
|
136
|
+
function createNameTokensQueryOptions(config, args) {
|
|
137
|
+
return {
|
|
138
|
+
enabled: true,
|
|
139
|
+
queryKey: queryKeys.nameTokens(config.client.url.href, args),
|
|
140
|
+
queryFn: async () => {
|
|
141
|
+
const client = new import_ensnode_sdk.ENSNodeClient(config.client);
|
|
142
|
+
return client.nameTokens(args);
|
|
143
|
+
}
|
|
144
|
+
};
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
// src/hooks/useENSNodeSDKConfig.ts
|
|
148
|
+
var import_react2 = require("react");
|
|
149
|
+
function useENSNodeSDKConfig(config) {
|
|
150
|
+
const contextConfig = (0, import_react2.useContext)(ENSNodeContext);
|
|
151
|
+
const resolvedConfig = config ?? contextConfig;
|
|
152
|
+
if (!resolvedConfig) {
|
|
153
|
+
throw new Error(
|
|
154
|
+
"useENSNodeSDKConfig must be used within an ENSNodeProvider or you must pass a config parameter"
|
|
155
|
+
);
|
|
156
|
+
}
|
|
157
|
+
return resolvedConfig;
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
// src/hooks/useENSNodeConfig.ts
|
|
161
|
+
function useENSNodeConfig(parameters = {}) {
|
|
162
|
+
const { config, query = {} } = parameters;
|
|
163
|
+
const _config = useENSNodeSDKConfig(config);
|
|
164
|
+
const queryOptions = createConfigQueryOptions(_config);
|
|
165
|
+
const options = {
|
|
166
|
+
...queryOptions,
|
|
167
|
+
...ASSUME_IMMUTABLE_QUERY,
|
|
168
|
+
...query,
|
|
169
|
+
enabled: query.enabled ?? queryOptions.enabled
|
|
170
|
+
};
|
|
171
|
+
return (0, import_react_query.useQuery)(options);
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
// src/hooks/useIndexingStatus.ts
|
|
175
|
+
var import_react_query2 = require("@tanstack/react-query");
|
|
176
|
+
function useIndexingStatus(parameters = {}) {
|
|
177
|
+
const { config, query = {} } = parameters;
|
|
178
|
+
const _config = useENSNodeSDKConfig(config);
|
|
179
|
+
const queryOptions = createIndexingStatusQueryOptions(_config);
|
|
180
|
+
const options = {
|
|
181
|
+
...queryOptions,
|
|
182
|
+
refetchInterval: 10 * 1e3,
|
|
183
|
+
// 10 seconds - indexing status changes frequently
|
|
184
|
+
...query,
|
|
185
|
+
enabled: query.enabled ?? queryOptions.enabled
|
|
186
|
+
};
|
|
187
|
+
return (0, import_react_query2.useQuery)(options);
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
// src/hooks/useNameTokens.ts
|
|
191
|
+
var import_react_query3 = require("@tanstack/react-query");
|
|
192
|
+
function useNameTokens(parameters) {
|
|
193
|
+
const { config, query = {} } = parameters;
|
|
194
|
+
const _config = useENSNodeSDKConfig(config);
|
|
195
|
+
const queryOptions = createNameTokensQueryOptions(_config, parameters);
|
|
196
|
+
return (0, import_react_query3.useQuery)({
|
|
197
|
+
...queryOptions,
|
|
198
|
+
refetchInterval: false,
|
|
199
|
+
// no refetching - assume data is immutable until a full page refresh
|
|
200
|
+
...query,
|
|
201
|
+
enabled: query.enabled ?? queryOptions.enabled
|
|
202
|
+
});
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
// src/hooks/usePrimaryName.ts
|
|
206
|
+
var import_react_query4 = require("@tanstack/react-query");
|
|
207
|
+
function usePrimaryName(parameters) {
|
|
208
|
+
const { config, query = {}, address, ...args } = parameters;
|
|
209
|
+
const _config = useENSNodeSDKConfig(config);
|
|
210
|
+
const canEnable = address !== null;
|
|
211
|
+
const queryOptions = canEnable ? createPrimaryNameQueryOptions(_config, { ...args, address }) : { enabled: false, queryKey: ["disabled"] };
|
|
212
|
+
const options = {
|
|
213
|
+
...queryOptions,
|
|
214
|
+
...query,
|
|
215
|
+
enabled: canEnable && (query.enabled ?? queryOptions.enabled)
|
|
216
|
+
};
|
|
217
|
+
return (0, import_react_query4.useQuery)(options);
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
// src/hooks/usePrimaryNames.ts
|
|
221
|
+
var import_react_query5 = require("@tanstack/react-query");
|
|
222
|
+
function usePrimaryNames(parameters) {
|
|
223
|
+
const { config, query = {}, address, ...args } = parameters;
|
|
224
|
+
const _config = useENSNodeSDKConfig(config);
|
|
225
|
+
const canEnable = address !== null;
|
|
226
|
+
const queryOptions = canEnable ? createPrimaryNamesQueryOptions(_config, { ...args, address }) : { enabled: false, queryKey: ["disabled"] };
|
|
227
|
+
const options = {
|
|
228
|
+
...queryOptions,
|
|
229
|
+
...query,
|
|
230
|
+
enabled: canEnable && (query.enabled ?? queryOptions.enabled)
|
|
231
|
+
};
|
|
232
|
+
return (0, import_react_query5.useQuery)(options);
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
// src/hooks/useRecords.ts
|
|
236
|
+
var import_react_query6 = require("@tanstack/react-query");
|
|
237
|
+
function useRecords(parameters) {
|
|
238
|
+
const { config, query = {}, name, ...args } = parameters;
|
|
239
|
+
const _config = useENSNodeSDKConfig(config);
|
|
240
|
+
const canEnable = name !== null;
|
|
241
|
+
const queryOptions = canEnable ? createRecordsQueryOptions(_config, { ...args, name }) : { enabled: false, queryKey: ["disabled"] };
|
|
242
|
+
const options = {
|
|
243
|
+
...queryOptions,
|
|
244
|
+
...query,
|
|
245
|
+
enabled: canEnable && (query.enabled ?? queryOptions.enabled)
|
|
246
|
+
};
|
|
247
|
+
return (0, import_react_query6.useQuery)(options);
|
|
248
|
+
}
|
|
249
|
+
|
|
250
|
+
// src/hooks/useRegistrarActions.ts
|
|
251
|
+
var import_react_query7 = require("@tanstack/react-query");
|
|
252
|
+
function useRegistrarActions(parameters = {}) {
|
|
253
|
+
const { config, query = {} } = parameters;
|
|
254
|
+
const _config = useENSNodeSDKConfig(config);
|
|
255
|
+
const queryOptions = createRegistrarActionsQueryOptions(_config, parameters);
|
|
256
|
+
const options = {
|
|
257
|
+
...queryOptions,
|
|
258
|
+
refetchInterval: 10 * 1e3,
|
|
259
|
+
// 10 seconds - latest registrar actions change frequently
|
|
260
|
+
...query,
|
|
261
|
+
enabled: query.enabled ?? queryOptions.enabled
|
|
262
|
+
};
|
|
263
|
+
return (0, import_react_query7.useQuery)(options);
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
// src/hooks/useResolvedIdentity.ts
|
|
267
|
+
var import_ensnode_sdk2 = require("@ensnode/ensnode-sdk");
|
|
268
|
+
function useResolvedIdentity(parameters) {
|
|
269
|
+
const { identity, accelerate, query: _query = {} } = parameters;
|
|
270
|
+
const { data } = useENSNodeConfig();
|
|
271
|
+
const namespace = data?.ensIndexerPublicConfig.namespace;
|
|
272
|
+
const {
|
|
273
|
+
data: primaryNameData,
|
|
274
|
+
status,
|
|
275
|
+
...query
|
|
276
|
+
} = usePrimaryName({
|
|
277
|
+
address: identity.address,
|
|
278
|
+
chainId: (0, import_ensnode_sdk2.getResolvePrimaryNameChainIdParam)(
|
|
279
|
+
identity.chainId,
|
|
280
|
+
// NOTE: defaulting here for typechecking, but enabled prevents fetching before namespace is known
|
|
281
|
+
namespace ?? import_ensnode_sdk2.ENSNamespaceIds.Mainnet
|
|
282
|
+
),
|
|
283
|
+
accelerate,
|
|
284
|
+
query: {
|
|
285
|
+
..._query,
|
|
286
|
+
enabled: (_query.enabled ?? true) && namespace !== void 0
|
|
287
|
+
}
|
|
288
|
+
});
|
|
289
|
+
let result;
|
|
290
|
+
if (status === "pending") {
|
|
291
|
+
result = identity;
|
|
292
|
+
} else if (status === "error") {
|
|
293
|
+
result = {
|
|
294
|
+
resolutionStatus: import_ensnode_sdk2.ResolutionStatusIds.Unknown,
|
|
295
|
+
chainId: identity.chainId,
|
|
296
|
+
address: identity.address
|
|
297
|
+
};
|
|
298
|
+
} else if (primaryNameData.name === null) {
|
|
299
|
+
result = {
|
|
300
|
+
resolutionStatus: import_ensnode_sdk2.ResolutionStatusIds.Unnamed,
|
|
301
|
+
chainId: identity.chainId,
|
|
302
|
+
address: identity.address,
|
|
303
|
+
name: null
|
|
304
|
+
};
|
|
305
|
+
} else {
|
|
306
|
+
result = {
|
|
307
|
+
resolutionStatus: import_ensnode_sdk2.ResolutionStatusIds.Named,
|
|
308
|
+
chainId: identity.chainId,
|
|
309
|
+
address: identity.address,
|
|
310
|
+
name: primaryNameData.name
|
|
311
|
+
};
|
|
312
|
+
}
|
|
313
|
+
return {
|
|
314
|
+
...query,
|
|
315
|
+
identity: result
|
|
316
|
+
};
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
// src/hooks/useSwrQuery.ts
|
|
320
|
+
var import_react_query8 = require("@tanstack/react-query");
|
|
321
|
+
var import_react3 = require("react");
|
|
322
|
+
function useSwrQuery(options, queryClient) {
|
|
323
|
+
const queryClientFromContext = (0, import_react_query8.useQueryClient)();
|
|
324
|
+
const derivedQueryClient = queryClient ?? queryClientFromContext;
|
|
325
|
+
const cachedSuccessfulResult = derivedQueryClient.getQueryData(options.queryKey);
|
|
326
|
+
const queryResult = (0, import_react_query8.useQuery)(
|
|
327
|
+
{
|
|
328
|
+
...options,
|
|
329
|
+
// cached result can never be stale
|
|
330
|
+
staleTime: cachedSuccessfulResult ? Infinity : void 0,
|
|
331
|
+
// cached result can never be removed by garbage collector
|
|
332
|
+
gcTime: cachedSuccessfulResult ? Infinity : void 0
|
|
333
|
+
},
|
|
334
|
+
queryClient
|
|
335
|
+
);
|
|
336
|
+
const memoizedQueryResult = (0, import_react3.useMemo)(() => {
|
|
337
|
+
if (queryResult.isError && cachedSuccessfulResult) {
|
|
338
|
+
return {
|
|
339
|
+
...queryResult,
|
|
340
|
+
// set error props
|
|
341
|
+
isError: false,
|
|
342
|
+
error: null,
|
|
343
|
+
isRefetchError: false,
|
|
344
|
+
isLoadingError: false,
|
|
345
|
+
// st success props
|
|
346
|
+
isSuccess: true,
|
|
347
|
+
status: "success",
|
|
348
|
+
data: cachedSuccessfulResult
|
|
349
|
+
};
|
|
350
|
+
}
|
|
351
|
+
return queryResult;
|
|
352
|
+
}, [queryResult, cachedSuccessfulResult]);
|
|
353
|
+
return memoizedQueryResult;
|
|
354
|
+
}
|
|
355
|
+
|
|
356
|
+
// src/provider.tsx
|
|
357
|
+
var import_react_query9 = require("@tanstack/react-query");
|
|
358
|
+
var import_react4 = require("react");
|
|
359
|
+
var import_ensnode_sdk3 = require("@ensnode/ensnode-sdk");
|
|
360
|
+
function ENSNodeInternalProvider({
|
|
361
|
+
children,
|
|
362
|
+
config
|
|
363
|
+
}) {
|
|
364
|
+
const memoizedConfig = (0, import_react4.useMemo)(() => config, [config]);
|
|
365
|
+
return (0, import_react4.createElement)(ENSNodeContext.Provider, { value: memoizedConfig }, children);
|
|
366
|
+
}
|
|
367
|
+
function ENSNodeProvider(parameters) {
|
|
368
|
+
const { children, config, queryClient, queryClientOptions } = parameters;
|
|
369
|
+
let hasExistingQueryClient = false;
|
|
370
|
+
try {
|
|
371
|
+
hasExistingQueryClient = Boolean((0, import_react_query9.useQueryClient)());
|
|
372
|
+
} catch {
|
|
373
|
+
hasExistingQueryClient = false;
|
|
374
|
+
}
|
|
375
|
+
if (queryClient) {
|
|
376
|
+
if (!hasExistingQueryClient) {
|
|
377
|
+
throw new Error(
|
|
378
|
+
"When providing a custom queryClient, you must wrap your app with QueryClientProvider. Either remove the queryClient prop to use auto-managed setup, or wrap with QueryClientProvider."
|
|
379
|
+
);
|
|
380
|
+
}
|
|
381
|
+
return (0, import_react4.createElement)(ENSNodeInternalProvider, { config, children });
|
|
382
|
+
}
|
|
383
|
+
if (hasExistingQueryClient) {
|
|
384
|
+
return (0, import_react4.createElement)(ENSNodeInternalProvider, { config, children });
|
|
385
|
+
}
|
|
386
|
+
const defaultQueryClient = (0, import_react4.useMemo)(
|
|
387
|
+
() => new import_react_query9.QueryClient({
|
|
388
|
+
defaultOptions: {
|
|
389
|
+
queries: {
|
|
390
|
+
retry: 3,
|
|
391
|
+
staleTime: 1e3 * 60 * 5,
|
|
392
|
+
// 5 minutes
|
|
393
|
+
gcTime: 1e3 * 60 * 30,
|
|
394
|
+
// 30 minutes
|
|
395
|
+
refetchInterval: 1e3 * 10
|
|
396
|
+
// 10 seconds
|
|
397
|
+
}
|
|
398
|
+
},
|
|
399
|
+
...queryClientOptions
|
|
400
|
+
}),
|
|
401
|
+
[queryClientOptions]
|
|
402
|
+
);
|
|
403
|
+
return (0, import_react4.createElement)(
|
|
404
|
+
import_react_query9.QueryClientProvider,
|
|
405
|
+
{ client: defaultQueryClient },
|
|
406
|
+
(0, import_react4.createElement)(ENSNodeInternalProvider, { config, children })
|
|
407
|
+
);
|
|
408
|
+
}
|
|
409
|
+
function createConfig(options) {
|
|
410
|
+
const url = options?.url ? new URL(options.url) : import_ensnode_sdk3.ENSNodeClient.defaultOptions().url;
|
|
411
|
+
return {
|
|
412
|
+
client: {
|
|
413
|
+
...import_ensnode_sdk3.ENSNodeClient.defaultOptions(),
|
|
414
|
+
url
|
|
415
|
+
}
|
|
416
|
+
};
|
|
417
|
+
}
|
|
418
|
+
//# sourceMappingURL=index.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/context.ts","../src/hooks/useENSNodeConfig.ts","../src/utils/query.ts","../src/hooks/useENSNodeSDKConfig.ts","../src/hooks/useIndexingStatus.ts","../src/hooks/useNameTokens.ts","../src/hooks/usePrimaryName.ts","../src/hooks/usePrimaryNames.ts","../src/hooks/useRecords.ts","../src/hooks/useRegistrarActions.ts","../src/hooks/useResolvedIdentity.ts","../src/hooks/useSwrQuery.ts","../src/provider.tsx"],"sourcesContent":["export type { QueryClient } from \"@tanstack/react-query\";\n\nexport type { ResolverRecordsSelection } from \"@ensnode/ensnode-sdk\";\n\nexport * from \"./context\";\nexport * from \"./hooks\";\nexport * from \"./provider\";\nexport * from \"./types\";\nexport * from \"./utils/query\";\n","import { createContext } from \"react\";\n\nimport type { ENSNodeSDKConfig } from \"./types\";\n\n/**\n * React context for ENSNode configuration\n */\nexport const ENSNodeContext = createContext<ENSNodeSDKConfig | undefined>(undefined);\n\n/**\n * Display name for debugging\n */\nENSNodeContext.displayName = \"ENSNodeContext\";\n","import { useQuery } from \"@tanstack/react-query\";\n\nimport type { ConfigResponse } from \"@ensnode/ensnode-sdk\";\n\nimport type { QueryParameter, WithSDKConfigParameter } from \"../types\";\nimport { ASSUME_IMMUTABLE_QUERY, createConfigQueryOptions } from \"../utils/query\";\nimport { useENSNodeSDKConfig } from \"./useENSNodeSDKConfig\";\n\ntype UseENSNodeConfigParameters = QueryParameter<ConfigResponse>;\n\nexport function useENSNodeConfig(\n parameters: WithSDKConfigParameter & UseENSNodeConfigParameters = {},\n) {\n const { config, query = {} } = parameters;\n const _config = useENSNodeSDKConfig(config);\n\n const queryOptions = createConfigQueryOptions(_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","\"use client\";\n\nimport type { UndefinedInitialDataOptions } from \"@tanstack/react-query\";\n\nimport {\n ENSNodeClient,\n type NameTokensRequest,\n type RegistrarActionsRequest,\n type ResolvePrimaryNameRequest,\n type ResolvePrimaryNamesRequest,\n type ResolveRecordsRequest,\n type ResolverRecordsSelection,\n} from \"@ensnode/ensnode-sdk\";\n\nimport type { ENSNodeSDKConfig } 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 registrarActions: (url: string, args: RegistrarActionsRequest) =>\n [...queryKeys.base(url), \"registrar-actions\", args] as const,\n\n nameTokens: (url: string, args: NameTokensRequest) =>\n [...queryKeys.base(url), \"name-tokens\", args] as const,\n};\n\n/**\n * Creates query options for Records Resolution\n */\nexport function createRecordsQueryOptions<SELECTION extends ResolverRecordsSelection>(\n config: ENSNodeSDKConfig,\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: ENSNodeSDKConfig,\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: ENSNodeSDKConfig,\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 ENSNode Config API\n */\nexport function createConfigQueryOptions(config: ENSNodeSDKConfig) {\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 ENSNode Indexing Status API\n */\nexport function createIndexingStatusQueryOptions(config: ENSNodeSDKConfig) {\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\n/**\n * Creates query options for ENSNode Registrar Actions API\n */\nexport function createRegistrarActionsQueryOptions(\n config: ENSNodeSDKConfig,\n args: RegistrarActionsRequest,\n) {\n return {\n enabled: true,\n queryKey: queryKeys.registrarActions(config.client.url.href, args),\n queryFn: async () => {\n const client = new ENSNodeClient(config.client);\n\n return client.registrarActions(args);\n },\n };\n}\n\n/**\n * Creates query options for Name Tokens API\n */\nexport function createNameTokensQueryOptions(config: ENSNodeSDKConfig, args: NameTokensRequest) {\n return {\n enabled: true,\n queryKey: queryKeys.nameTokens(config.client.url.href, args),\n queryFn: async () => {\n const client = new ENSNodeClient(config.client);\n\n return client.nameTokens(args);\n },\n };\n}\n","\"use client\";\n\nimport { useContext } from \"react\";\n\nimport { ENSNodeContext } from \"../context\";\nimport type { ENSNodeSDKConfig } from \"../types\";\n\n/**\n * Hook to access the ENSNodeSDKConfig 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 useENSNodeSDKConfig<TConfig extends ENSNodeSDKConfig = ENSNodeSDKConfig>(\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 \"useENSNodeSDKConfig must be used within an ENSNodeProvider or you must pass a config parameter\",\n );\n }\n\n return resolvedConfig as TConfig;\n}\n","import { useQuery } from \"@tanstack/react-query\";\n\nimport type { IndexingStatusRequest, IndexingStatusResponse } from \"@ensnode/ensnode-sdk\";\n\nimport type { QueryParameter, WithSDKConfigParameter } from \"../types\";\nimport { createIndexingStatusQueryOptions } from \"../utils/query\";\nimport { useENSNodeSDKConfig } from \"./useENSNodeSDKConfig\";\n\ninterface UseIndexingStatusParameters\n extends IndexingStatusRequest,\n QueryParameter<IndexingStatusResponse> {}\n\nexport function useIndexingStatus(\n parameters: WithSDKConfigParameter & UseIndexingStatusParameters = {},\n) {\n const { config, query = {} } = parameters;\n const _config = useENSNodeSDKConfig(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","import { useQuery } from \"@tanstack/react-query\";\n\nimport type { NameTokensRequest, NameTokensResponse } from \"@ensnode/ensnode-sdk\";\n\nimport type { QueryParameter, WithSDKConfigParameter } from \"../types\";\nimport { createNameTokensQueryOptions } from \"../utils/query\";\nimport { useENSNodeSDKConfig } from \"./useENSNodeSDKConfig\";\n\ntype UseNameTokensParameters = NameTokensRequest & QueryParameter<NameTokensResponse>;\n\n/**\n * Use Name Tokens hook\n *\n * Query ENSNode Name Tokens API.\n */\nexport function useNameTokens(parameters: WithSDKConfigParameter & UseNameTokensParameters) {\n const { config, query = {} } = parameters;\n const _config = useENSNodeSDKConfig(config);\n\n const queryOptions = createNameTokensQueryOptions(_config, parameters);\n\n return useQuery({\n ...queryOptions,\n refetchInterval: false, // no refetching - assume data is immutable until a full page refresh\n ...query,\n enabled: query.enabled ?? queryOptions.enabled,\n });\n}\n","\"use client\";\n\nimport { useQuery } from \"@tanstack/react-query\";\n\nimport type { UsePrimaryNameParameters, WithSDKConfigParameter } from \"../types\";\nimport { createPrimaryNameQueryOptions } from \"../utils/query\";\nimport { useENSNodeSDKConfig } from \"./useENSNodeSDKConfig\";\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 * accelerate: true, // Attempt Protocol Acceleration\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 & WithSDKConfigParameter) {\n const { config, query = {}, address, ...args } = parameters;\n const _config = useENSNodeSDKConfig(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\";\n\nimport type { UsePrimaryNamesParameters, WithSDKConfigParameter } from \"../types\";\nimport { createPrimaryNamesQueryOptions } from \"../utils/query\";\nimport { useENSNodeSDKConfig } from \"./useENSNodeSDKConfig\";\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 & WithSDKConfigParameter) {\n const { config, query = {}, address, ...args } = parameters;\n const _config = useENSNodeSDKConfig(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","\"use client\";\n\nimport { useQuery } from \"@tanstack/react-query\";\n\nimport type { ResolverRecordsSelection } from \"@ensnode/ensnode-sdk\";\n\nimport type { UseRecordsParameters, WithSDKConfigParameter } from \"../types\";\nimport { createRecordsQueryOptions } from \"../utils/query\";\nimport { useENSNodeSDKConfig } from \"./useENSNodeSDKConfig\";\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> & WithSDKConfigParameter,\n) {\n const { config, query = {}, name, ...args } = parameters;\n const _config = useENSNodeSDKConfig(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","import { useQuery } from \"@tanstack/react-query\";\n\nimport type { RegistrarActionsRequest, RegistrarActionsResponse } from \"@ensnode/ensnode-sdk\";\n\nimport type { QueryParameter, WithSDKConfigParameter } from \"../types\";\nimport { createRegistrarActionsQueryOptions } from \"../utils/query\";\nimport { useENSNodeSDKConfig } from \"./useENSNodeSDKConfig\";\n\ninterface UseRegistrarActionsParameters\n extends RegistrarActionsRequest,\n QueryParameter<RegistrarActionsResponse> {}\n\n/**\n * Use Registrar Actions hook\n *\n * Query ENSNode Registrar Actions API.\n */\nexport function useRegistrarActions(\n parameters: WithSDKConfigParameter & UseRegistrarActionsParameters = {},\n) {\n const { config, query = {} } = parameters;\n const _config = useENSNodeSDKConfig(config);\n\n const queryOptions = createRegistrarActionsQueryOptions(_config, parameters);\n\n const options = {\n ...queryOptions,\n refetchInterval: 10 * 1000, // 10 seconds - latest registrar actions change frequently\n ...query,\n enabled: query.enabled ?? queryOptions.enabled,\n };\n\n return useQuery(options);\n}\n","\"use client\";\n\nimport {\n type ENSNamespaceId,\n ENSNamespaceIds,\n getResolvePrimaryNameChainIdParam,\n type Identity,\n type NamedIdentity,\n ResolutionStatusIds,\n ResolvedIdentity,\n type UnknownIdentity,\n type UnnamedIdentity,\n type UnresolvedIdentity,\n} from \"@ensnode/ensnode-sdk\";\n\nimport type { UseResolvedIdentityParameters } from \"../types\";\nimport { useENSNodeConfig } from \"./useENSNodeConfig\";\nimport { usePrimaryName } from \"./usePrimaryName\";\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 * @param parameters.accelerate - Whether to attempt Protocol Acceleration (default: false)\n * when resolving the primary name.\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, accelerate, query: _query = {} } = parameters;\n\n const { data } = useENSNodeConfig();\n const namespace = data?.ensIndexerPublicConfig.namespace;\n\n const {\n data: primaryNameData,\n status,\n ...query\n } = usePrimaryName({\n address: identity.address,\n chainId: getResolvePrimaryNameChainIdParam(\n identity.chainId,\n // NOTE: defaulting here for typechecking, but enabled prevents fetching before namespace is known\n namespace ?? ENSNamespaceIds.Mainnet,\n ),\n accelerate,\n query: {\n ..._query,\n enabled: (_query.enabled ?? true) && namespace !== undefined,\n },\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","import {\n type DefaultError,\n type DefinedInitialDataOptions,\n type DefinedUseQueryResult,\n type QueryClient,\n type QueryKey,\n type QueryObserverSuccessResult,\n type UndefinedInitialDataOptions,\n type UseQueryOptions,\n type UseQueryResult,\n useQuery,\n useQueryClient,\n} from \"@tanstack/react-query\";\nimport { useMemo } from \"react\";\n\n/**\n * Use Stale-While-Revalidate Query\n *\n * This hooks is a proxy for {@link useQuery} with addition of the following\n * semantics:\n * - if the query has been resolved successfully just once,\n * the query result will always be success with data being the previously\n * cached result,\n * - the cached result can never go stale, or be garbage collected\n * - the cached result can be only overridden by the current result when\n * the query is successfully re-fetched (in other words,\n * the `options.queryFn` returns a resolved promise).\n *\n * Please note how there can be any number of failed queries before one\n * succeeds. In such case, no successful result has ever been cached and\n * the query fails (`isError: true`, `error` is available) until\n * the first successful resolution (`isSuccess: true`, `data` is available).\n *\n * @example\n * ```tsx\n * const swrQuery = useSwrQuery({\n * queryKey: ['data'],\n * queryFn: fetchData,\n * });\n *\n * if (swrQuery.isPending) {\n * // Show loading state while there's no cached successful result and\n * // no query attempt was finished yet.\n * return <>Loading...</>;\n * }\n *\n * if (swrQuery.isError) {\n * // Show error state when query attempt fails and\n * // no cached successful result is available.\n * return <>Error: {swrQuery.error.message}</>;\n * }\n *\n * // Otherwise, show data when the cached successful result is available.\n * return <>Data: {JSON.stringify(swrQuery.data)}</>;\n * ```\n */\nexport function useSwrQuery<\n TQueryFnData = unknown,\n TError = DefaultError,\n TData = TQueryFnData,\n TQueryKey extends QueryKey = QueryKey,\n>(\n options: DefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>,\n queryClient?: QueryClient,\n): DefinedUseQueryResult<NoInfer<TData>, TError>;\nexport function useSwrQuery<\n TQueryFnData = unknown,\n TError = DefaultError,\n TData = TQueryFnData,\n TQueryKey extends QueryKey = QueryKey,\n>(\n options: UndefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>,\n queryClient?: QueryClient,\n): UseQueryResult<NoInfer<TData>, TError>;\nexport function useSwrQuery<\n TQueryFnData = unknown,\n TError = DefaultError,\n TData = TQueryFnData,\n TQueryKey extends QueryKey = QueryKey,\n>(\n options: UseQueryOptions<TQueryFnData, TError, TData, TQueryKey>,\n queryClient?: QueryClient,\n): UseQueryResult<NoInfer<TData>, TError>;\nexport function useSwrQuery<\n TQueryFnData = unknown,\n TError = DefaultError,\n TData = TQueryFnData,\n TQueryKey extends QueryKey = QueryKey,\n>(\n options: UseQueryOptions<TQueryFnData, TError, TData, TQueryKey>,\n queryClient?: QueryClient,\n): UseQueryResult<NoInfer<TData>, TError> {\n const queryClientFromContext = useQueryClient();\n const derivedQueryClient = queryClient ?? queryClientFromContext;\n\n // cacheResult, if available, is always the last successfully resolved query data\n const cachedSuccessfulResult = derivedQueryClient.getQueryData<TData>(options.queryKey);\n\n const queryResult = useQuery(\n {\n ...options,\n // cached result can never be stale\n staleTime: cachedSuccessfulResult ? Infinity : undefined,\n // cached result can never be removed by garbage collector\n gcTime: cachedSuccessfulResult ? Infinity : undefined,\n },\n queryClient,\n );\n\n // memoize query results to avoid unnecessary UI re-rendering\n const memoizedQueryResult = useMemo(() => {\n // If the query result is error\n // and the cachedSuccessfulResult is available\n // override the query result to be success, replacing the unsuccessful\n // result with the most recent cachedSuccessfulResult\n if (queryResult.isError && cachedSuccessfulResult) {\n return {\n ...queryResult,\n // set error props\n isError: false,\n error: null,\n isRefetchError: false,\n isLoadingError: false,\n // st success props\n isSuccess: true,\n status: \"success\",\n data: cachedSuccessfulResult,\n } satisfies QueryObserverSuccessResult<TData, TError>;\n }\n\n return queryResult;\n }, [queryResult, cachedSuccessfulResult]);\n\n return memoizedQueryResult;\n}\n","/** biome-ignore-all lint/correctness/useHookAtTopLevel: conditional hooks used correctly here */\n\"use client\";\n\nimport { QueryClient, QueryClientProvider, useQueryClient } from \"@tanstack/react-query\";\nimport { createElement, useMemo } from \"react\";\n\nimport { ENSNodeClient } from \"@ensnode/ensnode-sdk\";\n\nimport { ENSNodeContext } from \"./context\";\nimport type { ENSNodeSDKConfig } from \"./types\";\n\nexport interface ENSNodeProviderProps {\n /** ENSNode configuration */\n config: ENSNodeSDKConfig;\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: ENSNodeSDKConfig;\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 }): ENSNodeSDKConfig {\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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAA8B;AAOvB,IAAM,qBAAiB,4BAA4C,MAAS;AAKnF,eAAe,cAAc;;;ACZ7B,yBAAyB;;;ACIzB,yBAQO;AAmBA,IAAM,yBAAyB;AAAA,EACpC,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,sBAAsB;AAAA,EACtB,oBAAoB;AAAA,EACpB,gBAAgB;AAClB;AAKO,IAAM,YAAY;AAAA,EACvB,MAAM,CAAC,QAAgB,CAAC,WAAW,GAAG;AAAA,EAEtC,SAAS,CAAC,QAAgB,CAAC,GAAG,UAAU,KAAK,GAAG,GAAG,SAAS;AAAA,EAE5D,SAAS,CAAC,KAAa,SACrB,CAAC,GAAG,UAAU,QAAQ,GAAG,GAAG,WAAW,IAAI;AAAA,EAE7C,aAAa,CAAC,KAAa,SACzB,CAAC,GAAG,UAAU,QAAQ,GAAG,GAAG,gBAAgB,IAAI;AAAA,EAElD,cAAc,CAAC,KAAa,SAC1B,CAAC,GAAG,UAAU,QAAQ,GAAG,GAAG,iBAAiB,IAAI;AAAA,EAEnD,QAAQ,CAAC,QAAgB,CAAC,GAAG,UAAU,KAAK,GAAG,GAAG,QAAQ;AAAA,EAE1D,gBAAgB,CAAC,QAAgB,CAAC,GAAG,UAAU,KAAK,GAAG,GAAG,iBAAiB;AAAA,EAE3E,kBAAkB,CAAC,KAAa,SAC9B,CAAC,GAAG,UAAU,KAAK,GAAG,GAAG,qBAAqB,IAAI;AAAA,EAEpD,YAAY,CAAC,KAAa,SACxB,CAAC,GAAG,UAAU,KAAK,GAAG,GAAG,eAAe,IAAI;AAChD;AAKO,SAAS,0BACd,QACA,MACA;AACA,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU,UAAU,QAAQ,OAAO,OAAO,IAAI,MAAM,IAAI;AAAA,IACxD,SAAS,YAAY;AACnB,YAAM,SAAS,IAAI,iCAAc,OAAO,MAAM;AAC9C,aAAO,OAAO,eAAe,KAAK,MAAM,KAAK,WAAW,IAAI;AAAA,IAC9D;AAAA,EACF;AACF;AAKO,SAAS,8BACd,QACA,MACA;AACA,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU,UAAU,YAAY,OAAO,OAAO,IAAI,MAAM,IAAI;AAAA,IAC5D,SAAS,YAAY;AACnB,YAAM,SAAS,IAAI,iCAAc,OAAO,MAAM;AAC9C,aAAO,OAAO,mBAAmB,KAAK,SAAS,KAAK,SAAS,IAAI;AAAA,IACnE;AAAA,EACF;AACF;AAKO,SAAS,+BACd,QACA,MACA;AACA,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU,UAAU,aAAa,OAAO,OAAO,IAAI,MAAM,IAAI;AAAA,IAC7D,SAAS,YAAY;AACnB,YAAM,SAAS,IAAI,iCAAc,OAAO,MAAM;AAC9C,aAAO,OAAO,oBAAoB,KAAK,SAAS,IAAI;AAAA,IACtD;AAAA,EACF;AACF;AAKO,SAAS,yBAAyB,QAA0B;AACjE,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU,UAAU,OAAO,OAAO,OAAO,IAAI,IAAI;AAAA,IACjD,SAAS,YAAY;AACnB,YAAM,SAAS,IAAI,iCAAc,OAAO,MAAM;AAC9C,aAAO,OAAO,OAAO;AAAA,IACvB;AAAA,EACF;AACF;AAKO,SAAS,iCAAiC,QAA0B;AACzE,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU,UAAU,eAAe,OAAO,OAAO,IAAI,IAAI;AAAA,IACzD,SAAS,YAAY;AACnB,YAAM,SAAS,IAAI,iCAAc,OAAO,MAAM;AAC9C,aAAO,OAAO,eAAe;AAAA,IAC/B;AAAA,EACF;AACF;AAKO,SAAS,mCACd,QACA,MACA;AACA,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU,UAAU,iBAAiB,OAAO,OAAO,IAAI,MAAM,IAAI;AAAA,IACjE,SAAS,YAAY;AACnB,YAAM,SAAS,IAAI,iCAAc,OAAO,MAAM;AAE9C,aAAO,OAAO,iBAAiB,IAAI;AAAA,IACrC;AAAA,EACF;AACF;AAKO,SAAS,6BAA6B,QAA0B,MAAyB;AAC9F,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU,UAAU,WAAW,OAAO,OAAO,IAAI,MAAM,IAAI;AAAA,IAC3D,SAAS,YAAY;AACnB,YAAM,SAAS,IAAI,iCAAc,OAAO,MAAM;AAE9C,aAAO,OAAO,WAAW,IAAI;AAAA,IAC/B;AAAA,EACF;AACF;;;AC/KA,IAAAA,gBAA2B;AAYpB,SAAS,oBACd,QACS;AACT,QAAM,oBAAgB,0BAAW,cAAc;AAG/C,QAAM,iBAAiB,UAAU;AAEjC,MAAI,CAAC,gBAAgB;AACnB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;;;AFnBO,SAAS,iBACd,aAAkE,CAAC,GACnE;AACA,QAAM,EAAE,QAAQ,QAAQ,CAAC,EAAE,IAAI;AAC/B,QAAM,UAAU,oBAAoB,MAAM;AAE1C,QAAM,eAAe,yBAAyB,OAAO;AAErD,QAAM,UAAU;AAAA,IACd,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,IACH,SAAS,MAAM,WAAW,aAAa;AAAA,EACzC;AAEA,aAAO,6BAAS,OAAO;AACzB;;;AG1BA,IAAAC,sBAAyB;AAYlB,SAAS,kBACd,aAAmE,CAAC,GACpE;AACA,QAAM,EAAE,QAAQ,QAAQ,CAAC,EAAE,IAAI;AAC/B,QAAM,UAAU,oBAAoB,MAAM;AAE1C,QAAM,eAAe,iCAAiC,OAAO;AAE7D,QAAM,UAAU;AAAA,IACd,GAAG;AAAA,IACH,iBAAiB,KAAK;AAAA;AAAA,IACtB,GAAG;AAAA,IACH,SAAS,MAAM,WAAW,aAAa;AAAA,EACzC;AAEA,aAAO,8BAAS,OAAO;AACzB;;;AC5BA,IAAAC,sBAAyB;AAelB,SAAS,cAAc,YAA8D;AAC1F,QAAM,EAAE,QAAQ,QAAQ,CAAC,EAAE,IAAI;AAC/B,QAAM,UAAU,oBAAoB,MAAM;AAE1C,QAAM,eAAe,6BAA6B,SAAS,UAAU;AAErE,aAAO,8BAAS;AAAA,IACd,GAAG;AAAA,IACH,iBAAiB;AAAA;AAAA,IACjB,GAAG;AAAA,IACH,SAAS,MAAM,WAAW,aAAa;AAAA,EACzC,CAAC;AACH;;;ACzBA,IAAAC,sBAAyB;AAsClB,SAAS,eAAe,YAA+D;AAC5F,QAAM,EAAE,QAAQ,QAAQ,CAAC,GAAG,SAAS,GAAG,KAAK,IAAI;AACjD,QAAM,UAAU,oBAAoB,MAAM;AAE1C,QAAM,YAAY,YAAY;AAE9B,QAAM,eAAe,YACjB,8BAA8B,SAAS,EAAE,GAAG,MAAM,QAAQ,CAAC,IAC3D,EAAE,SAAS,OAAO,UAAU,CAAC,UAAU,EAAW;AAEtD,QAAM,UAAU;AAAA,IACd,GAAG;AAAA,IACH,GAAG;AAAA,IACH,SAAS,cAAc,MAAM,WAAW,aAAa;AAAA,EACvD;AAEA,aAAO,8BAAS,OAAO;AACzB;;;ACvDA,IAAAC,sBAAyB;AAwClB,SAAS,gBAAgB,YAAgE;AAC9F,QAAM,EAAE,QAAQ,QAAQ,CAAC,GAAG,SAAS,GAAG,KAAK,IAAI;AACjD,QAAM,UAAU,oBAAoB,MAAM;AAE1C,QAAM,YAAY,YAAY;AAE9B,QAAM,eAAe,YACjB,+BAA+B,SAAS,EAAE,GAAG,MAAM,QAAQ,CAAC,IAC5D,EAAE,SAAS,OAAO,UAAU,CAAC,UAAU,EAAW;AAEtD,QAAM,UAAU;AAAA,IACd,GAAG;AAAA,IACH,GAAG;AAAA,IACH,SAAS,cAAc,MAAM,WAAW,aAAa;AAAA,EACvD;AAEA,aAAO,8BAAS,OAAO;AACzB;;;ACzDA,IAAAC,sBAAyB;AAkDlB,SAAS,WACd,YACA;AACA,QAAM,EAAE,QAAQ,QAAQ,CAAC,GAAG,MAAM,GAAG,KAAK,IAAI;AAC9C,QAAM,UAAU,oBAAoB,MAAM;AAE1C,QAAM,YAAY,SAAS;AAE3B,QAAM,eAAe,YACjB,0BAA0B,SAAS,EAAE,GAAG,MAAM,KAAK,CAAC,IACpD,EAAE,SAAS,OAAO,UAAU,CAAC,UAAU,EAAW;AAEtD,QAAM,UAAU;AAAA,IACd,GAAG;AAAA,IACH,GAAG;AAAA,IACH,SAAS,cAAc,MAAM,WAAW,aAAa;AAAA,EACvD;AAEA,aAAO,8BAAS,OAAO;AACzB;;;ACvEA,IAAAC,sBAAyB;AAiBlB,SAAS,oBACd,aAAqE,CAAC,GACtE;AACA,QAAM,EAAE,QAAQ,QAAQ,CAAC,EAAE,IAAI;AAC/B,QAAM,UAAU,oBAAoB,MAAM;AAE1C,QAAM,eAAe,mCAAmC,SAAS,UAAU;AAE3E,QAAM,UAAU;AAAA,IACd,GAAG;AAAA,IACH,iBAAiB,KAAK;AAAA;AAAA,IACtB,GAAG;AAAA,IACH,SAAS,MAAM,WAAW,aAAa;AAAA,EACzC;AAEA,aAAO,8BAAS,OAAO;AACzB;;;AC/BA,IAAAC,sBAWO;AA2BA,SAAS,oBAAoB,YAA2C;AAC7E,QAAM,EAAE,UAAU,YAAY,OAAO,SAAS,CAAC,EAAE,IAAI;AAErD,QAAM,EAAE,KAAK,IAAI,iBAAiB;AAClC,QAAM,YAAY,MAAM,uBAAuB;AAE/C,QAAM;AAAA,IACJ,MAAM;AAAA,IACN;AAAA,IACA,GAAG;AAAA,EACL,IAAI,eAAe;AAAA,IACjB,SAAS,SAAS;AAAA,IAClB,aAAS;AAAA,MACP,SAAS;AAAA;AAAA,MAET,aAAa,oCAAgB;AAAA,IAC/B;AAAA,IACA;AAAA,IACA,OAAO;AAAA,MACL,GAAG;AAAA,MACH,UAAU,OAAO,WAAW,SAAS,cAAc;AAAA,IACrD;AAAA,EACF,CAAC;AAED,MAAI;AAEJ,MAAI,WAAW,WAAW;AAGxB,aAAS;AAAA,EACX,WAAW,WAAW,SAAS;AAC7B,aAAS;AAAA,MACP,kBAAkB,wCAAoB;AAAA,MACtC,SAAS,SAAS;AAAA,MAClB,SAAS,SAAS;AAAA,IACpB;AAAA,EACF,WAAW,gBAAgB,SAAS,MAAM;AACxC,aAAS;AAAA,MACP,kBAAkB,wCAAoB;AAAA,MACtC,SAAS,SAAS;AAAA,MAClB,SAAS,SAAS;AAAA,MAClB,MAAM;AAAA,IACR;AAAA,EACF,OAAO;AACL,aAAS;AAAA,MACP,kBAAkB,wCAAoB;AAAA,MACtC,SAAS,SAAS;AAAA,MAClB,SAAS,SAAS;AAAA,MAClB,MAAM,gBAAgB;AAAA,IACxB;AAAA,EACF;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,UAAU;AAAA,EACZ;AACF;;;AChGA,IAAAC,sBAYO;AACP,IAAAC,gBAAwB;AAsEjB,SAAS,YAMd,SACA,aACwC;AACxC,QAAM,6BAAyB,oCAAe;AAC9C,QAAM,qBAAqB,eAAe;AAG1C,QAAM,yBAAyB,mBAAmB,aAAoB,QAAQ,QAAQ;AAEtF,QAAM,kBAAc;AAAA,IAClB;AAAA,MACE,GAAG;AAAA;AAAA,MAEH,WAAW,yBAAyB,WAAW;AAAA;AAAA,MAE/C,QAAQ,yBAAyB,WAAW;AAAA,IAC9C;AAAA,IACA;AAAA,EACF;AAGA,QAAM,0BAAsB,uBAAQ,MAAM;AAKxC,QAAI,YAAY,WAAW,wBAAwB;AACjD,aAAO;AAAA,QACL,GAAG;AAAA;AAAA,QAEH,SAAS;AAAA,QACT,OAAO;AAAA,QACP,gBAAgB;AAAA,QAChB,gBAAgB;AAAA;AAAA,QAEhB,WAAW;AAAA,QACX,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAEA,WAAO;AAAA,EACT,GAAG,CAAC,aAAa,sBAAsB,CAAC;AAExC,SAAO;AACT;;;ACnIA,IAAAC,sBAAiE;AACjE,IAAAC,gBAAuC;AAEvC,IAAAC,sBAA8B;AAsB9B,SAAS,wBAAwB;AAAA,EAC/B;AAAA,EACA;AACF,GAGG;AAED,QAAM,qBAAiB,uBAAQ,MAAM,QAAQ,CAAC,MAAM,CAAC;AAErD,aAAO,6BAAc,eAAe,UAAU,EAAE,OAAO,eAAe,GAAG,QAAQ;AACnF;AAEO,SAAS,gBAAgB,YAA2D;AACzF,QAAM,EAAE,UAAU,QAAQ,aAAa,mBAAmB,IAAI;AAG9D,MAAI,yBAAyB;AAC7B,MAAI;AACF,6BAAyB,YAAQ,oCAAe,CAAC;AAAA,EACnD,QAAQ;AAEN,6BAAyB;AAAA,EAC3B;AAGA,MAAI,aAAa;AACf,QAAI,CAAC,wBAAwB;AAC3B,YAAM,IAAI;AAAA,QACR;AAAA,MAEF;AAAA,IACF;AACA,eAAO,6BAAc,yBAAyB,EAAE,QAAQ,SAAS,CAAC;AAAA,EACpE;AAGA,MAAI,wBAAwB;AAC1B,eAAO,6BAAc,yBAAyB,EAAE,QAAQ,SAAS,CAAC;AAAA,EACpE;AAGA,QAAM,yBAAqB;AAAA,IACzB,MACE,IAAI,gCAAY;AAAA,MACd,gBAAgB;AAAA,QACd,SAAS;AAAA,UACP,OAAO;AAAA,UACP,WAAW,MAAO,KAAK;AAAA;AAAA,UACvB,QAAQ,MAAO,KAAK;AAAA;AAAA,UACpB,iBAAiB,MAAO;AAAA;AAAA,QAC1B;AAAA,MACF;AAAA,MACA,GAAG;AAAA,IACL,CAAC;AAAA,IACH,CAAC,kBAAkB;AAAA,EACrB;AAEA,aAAO;AAAA,IACL;AAAA,IACA,EAAE,QAAQ,mBAAmB;AAAA,QAC7B,6BAAc,yBAAyB,EAAE,QAAQ,SAAS,CAAC;AAAA,EAC7D;AACF;AAKO,SAAS,aAAa,SAAoD;AAC/E,QAAM,MAAM,SAAS,MAAM,IAAI,IAAI,QAAQ,GAAG,IAAI,kCAAc,eAAe,EAAE;AAEjF,SAAO;AAAA,IACL,QAAQ;AAAA,MACN,GAAG,kCAAc,eAAe;AAAA,MAChC;AAAA,IACF;AAAA,EACF;AACF;","names":["import_react","import_react_query","import_react_query","import_react_query","import_react_query","import_react_query","import_react_query","import_ensnode_sdk","import_react_query","import_react","import_react_query","import_react","import_ensnode_sdk"]}
|