@frak-labs/react-sdk 0.1.0-beta.8d103039 → 0.1.0-beta.b0bd1f8a

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/dist/index.d.cts CHANGED
@@ -1,386 +1,368 @@
1
- import { Context } from 'react';
2
- import { CSSProperties } from 'react';
3
- import type { DisplayEmbeddedWalletParamsType } from '@frak-labs/core-sdk';
4
- import type { DisplayModalParamsType } from '@frak-labs/core-sdk';
5
- import { FragmentProps } from 'react';
6
- import { FrakClient } from '@frak-labs/core-sdk';
7
- import { FrakRpcError } from '@frak-labs/frame-connector';
8
- import { FrakWalletSdkConfig } from '@frak-labs/core-sdk';
9
- import { FunctionComponentElement } from 'react';
10
- import type { GetProductInformationReturnType } from '@frak-labs/core-sdk';
11
- import { Hex } from 'viem';
12
- import type { ModalRpcStepsResultType } from '@frak-labs/core-sdk';
13
- import type { ModalStepTypes } from '@frak-labs/core-sdk';
14
- import type { OpenSsoParamsType } from '@frak-labs/core-sdk';
15
- import type { OpenSsoReturnType } from '@frak-labs/core-sdk';
16
- import type { PrepareSsoParamsType } from '@frak-labs/core-sdk';
17
- import { ProcessReferralOptions } from '@frak-labs/core-sdk/actions';
18
- import { PropsWithChildren } from 'react';
19
- import { ProviderProps } from 'react';
20
- import { ReactNode } from 'react';
21
- import type { SendInteractionParamsType } from '@frak-labs/core-sdk';
22
- import type { SendInteractionReturnType } from '@frak-labs/core-sdk';
23
- import { SendTransactionParams } from '@frak-labs/core-sdk/actions';
24
- import type { SendTransactionReturnType } from '@frak-labs/core-sdk';
25
- import { SiweAuthenticateModalParams } from '@frak-labs/core-sdk/actions';
26
- import type { SiweAuthenticateReturnType } from '@frak-labs/core-sdk';
27
- import { UseMutationOptions } from '@tanstack/react-query';
28
- import { UseMutationResult } from '@tanstack/react-query';
29
- import { UseQueryOptions } from '@tanstack/react-query';
30
- import { UseQueryResult } from '@tanstack/react-query';
31
- import type { WalletStatusReturnType } from '@frak-labs/core-sdk';
32
-
33
- /**
34
- * The context that will keep the Frak Wallet SDK configuration
35
- * @ignore
36
- */
37
- export declare const FrakConfigContext: Context<FrakWalletSdkConfig | undefined>;
38
-
39
- /**
40
- * Simple config provider for the Frak Wallet SDK
41
- *
42
- * Should be wrapped within a {@link @tanstack/react-query!QueryClientProvider | `QueryClientProvider`}
43
- *
44
- * @group provider
45
- *
46
- * @param parameters
47
- */
48
- export declare function FrakConfigProvider(parameters: PropsWithChildren<FrakConfigProviderProps>): FunctionComponentElement<ProviderProps<FrakWalletSdkConfig | undefined>>;
49
-
50
- /**
51
- * Props to instantiate the Frak Wallet SDK configuration provider
52
- *
53
- * @group provider
54
- */
55
- export declare type FrakConfigProviderProps = {
56
- /**
57
- * The wanted Frak configuration
58
- * @see {@link @frak-labs/core-sdk!index.FrakWalletSdkConfig | FrakWalletSdkConfig}
59
- */
60
- config: FrakWalletSdkConfig;
61
- };
62
-
63
- /**
64
- * The context that will keep the Frak Wallet SDK client
65
- * @ignore
66
- */
67
- export declare const FrakIFrameClientContext: Context<FrakClient | undefined>;
68
-
69
- /**
70
- * Props to instantiate the Frak Wallet SDK configuration provider
71
- *
72
- * @group provider
73
- */
74
- export declare type FrakIFrameClientProps = {
75
- config: FrakWalletSdkConfig;
76
- };
77
-
78
- /**
79
- * IFrame client provider for the Frak Wallet SDK
80
- * It will automatically create the frak wallet iFrame (required for the wallet to communicate with the SDK securely), and provide it in the context
81
- *
82
- * @group provider
83
- *
84
- * @remarks
85
- * This provider must be wrapped within a {@link FrakConfigProvider} to work properly
86
- *
87
- * @param args
88
- * @param args.style - Some custom styles to apply to the iFrame
89
- * @param args.children - Descedant components that will have access to the Frak Client
90
- */
91
- export declare function FrakIFrameClientProvider({ style, children, }: {
92
- style?: CSSProperties;
93
- children?: ReactNode;
94
- }): FunctionComponentElement<FragmentProps>;
95
-
96
- /** @ignore */
97
- declare type MutationOptions = Omit<UseMutationOptions<SendTransactionReturnType, FrakRpcError, SendTransactionParams>, "mutationFn" | "mutationKey">;
98
-
99
- /** @ignore */
100
- declare type MutationOptions_2 = Omit<UseMutationOptions<SendInteractionReturnType, FrakRpcError, SendInteractionParamsType>, "mutationFn" | "mutationKey">;
101
-
102
- /** @inline */
103
- declare type MutationOptions_3 = Omit<UseMutationOptions<SiweAuthenticateReturnType, FrakRpcError, SiweAuthenticateModalParams>, "mutationFn" | "mutationKey">;
104
-
105
- /** @ignore */
106
- declare type MutationOptions_4<T extends ModalStepTypes[]> = Omit<UseMutationOptions<ModalRpcStepsResultType<T>, FrakRpcError, DisplayModalParamsType<T>>, "mutationFn" | "mutationKey">;
107
-
108
- /** @ignore */
109
- declare type MutationOptions_5 = Omit<UseMutationOptions<OpenSsoReturnType, FrakRpcError, OpenSsoParamsType>, "mutationFn" | "mutationKey">;
110
-
111
- /** @ignore */
112
- declare type QueryOptions = Omit<UseQueryOptions<GetProductInformationReturnType, FrakRpcError, undefined>, "queryKey" | "queryFn">;
113
-
114
- /**
115
- * Hook that return a mutation helping to display a modal to the user
116
- *
117
- * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.displayModal | `displayModal()`} action
118
- *
119
- * @param args
120
- *
121
- * @typeParam T
122
- * The modal steps types to display (the result will correspond to the steps types asked in params)
123
- * An array of {@link @frak-labs/core-sdk!index.ModalStepTypes | `ModalStepTypes`}
124
- * If not provided, it will default to a generic array of `ModalStepTypes`
125
- *
126
- * @group hooks
127
- *
128
- * @returns
129
- * The mutation hook wrapping the `displayModal()` action
130
- * The `mutate` and `mutateAsync` argument is of type {@link @frak-labs/core-sdk!index.DisplayModalParamsType | `DisplayModalParamsType<T>`}, with type params `T` being the modal steps types to display
131
- * The `data` result is a {@link @frak-labs/core-sdk!index.ModalRpcStepsResultType | `ModalRpcStepsResultType`}
132
- *
133
- * @see {@link @frak-labs/core-sdk!actions.displayModal | `displayModal()`} for more info about the underlying action
134
- * @see {@link @tanstack/react-query!useMutation | `useMutation()`} for more info about the mutation options and response
135
- */
136
- export declare function useDisplayModal<T extends ModalStepTypes[] = ModalStepTypes[]>({ mutations, }?: UseDisplayModalParams<T>): UseMutationResult< { [K in T[number]["key"]]: Extract<T[number], {
137
- key: K;
138
- }>["returns"]; }, FrakRpcError<undefined>, DisplayModalParamsType<T>, unknown>;
139
-
140
- /** @inline */
141
- declare interface UseDisplayModalParams<T extends ModalStepTypes[] = ModalStepTypes[]> {
142
- /**
143
- * Optional mutation options, see {@link @tanstack/react-query!useMutation | `useMutation()`} for more infos
144
- */
145
- mutations?: MutationOptions_4<T>;
146
- }
147
-
148
- /**
149
- * Get the current Frak client
150
- *
151
- * @group hooks
152
- */
153
- export declare function useFrakClient(): FrakClient | undefined;
154
-
155
- /**
156
- * Get the current Frak config
157
- * @throws {FrakRpcError} if the config is not found (only if this hooks is used outside a FrakConfigProvider)
158
- * @group hooks
159
- *
160
- * @see {@link @frak-labs/react-sdk!FrakConfigProvider | FrakConfigProvider} for the config provider
161
- * @see {@link @frak-labs/core-sdk!index.FrakWalletSdkConfig | FrakWalletSdkConfig} for the config type
162
- */
163
- export declare function useFrakConfig(): FrakWalletSdkConfig;
164
-
165
- /**
166
- * Hook that return a query helping to get the current product information
167
- *
168
- * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.getProductInformation | `getProductInformation()`} action
169
- *
170
- * @param args
171
- *
172
- * @group hooks
173
- *
174
- * @returns
175
- * The query hook wrapping the `getProductInformation()` action
176
- * The `data` result is a {@link @frak-labs/core-sdk!index.GetProductInformationReturnType | `GetProductInformationReturnType`}
177
- *
178
- * @see {@link @frak-labs/core-sdk!actions.getProductInformation | `getProductInformation()`} for more info about the underlying action
179
- * @see {@link @tanstack/react-query!useQuery | `useQuery()`} for more info about the useQuery options and response
180
- */
181
- export declare function useGetProductInformation({ query, }?: UseGetProductInformationParams): UseQueryResult<undefined, FrakRpcError<undefined>>;
182
-
183
- /** @inline */
184
- declare interface UseGetProductInformationParams {
185
- /**
186
- * Optional query options, see {@link @tanstack/react-query!useQuery | `useQuery()`} for more infos
187
- */
188
- query?: QueryOptions;
189
- }
190
-
191
- /**
192
- * Hook that return a mutation helping to open the SSO page
193
- *
194
- * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.openSso | `openSso()`} action
195
- *
196
- * @param args
197
- *
198
- * @group hooks
199
- *
200
- * @returns
201
- * The mutation hook wrapping the `openSso()` action
202
- * The `mutate` and `mutateAsync` argument is of type {@link @frak-labs/core-sdk!index.OpenSsoParamsType | `OpenSsoParamsType`}
203
- * The mutation doesn't output any value
204
- *
205
- * @see {@link @frak-labs/core-sdk!actions.openSso | `openSso()`} for more info about the underlying action
206
- * @see {@link @tanstack/react-query!useMutation | `useMutation()`} for more info about the mutation options and response
207
- */
208
- export declare function useOpenSso({ mutations }?: UseOpenSsoParams): UseMutationResult< {
209
- wallet?: Hex;
210
- }, FrakRpcError<undefined>, OpenSsoParamsType, unknown>;
211
-
212
- /** @inline */
213
- declare interface UseOpenSsoParams {
214
- /**
215
- * Optional mutation options, see {@link @tanstack/react-query!useMutation | `useMutation()`} for more infos
216
- */
217
- mutations?: MutationOptions_5;
218
- }
219
-
220
- /**
221
- * Hook that generates SSO URL for popup flow
222
- *
223
- * This is a **synchronous** hook (no async calls) that generates the SSO URL
224
- * client-side without communicating with the wallet iframe.
225
- *
226
- * @param params - SSO parameters for URL generation
227
- *
228
- * @group hooks
229
- *
230
- * @returns
231
- * Object containing:
232
- * - `ssoUrl`: Generated SSO URL (or undefined if client not ready)
233
- * - `isReady`: Boolean indicating if URL is available
234
- *
235
- * @example
236
- * ```tsx
237
- * function MyComponent() {
238
- * const { data } = usePrepareSso({
239
- * metadata: { logoUrl: "..." },
240
- * directExit: true
241
- * });
242
- *
243
- * const handleClick = () => {
244
- * if (ssoUrl) {
245
- * window.open(data?.ssoUrl, "_blank");
246
- * }
247
- * };
248
- *
249
- * return <button onClick={handleClick} disabled={!isReady}>Login</button>;
250
- * }
251
- * ```
252
- *
253
- * @see {@link @frak-labs/core-sdk!actions.prepareSso | `prepareSso()`} for the underlying action
254
- * @see {@link @frak-labs/core-sdk!actions.openSso | `openSso()`} for the recommended high-level API
255
- */
256
- export declare function usePrepareSso(params: PrepareSsoParamsType): UseQueryResult< {
257
- ssoUrl: string;
258
- }, Error>;
259
-
260
- /**
261
- * Helper hook to automatically submit a referral interaction when detected
262
- *
263
- * @group hooks
264
- *
265
- * @param args
266
- * @param args.productId - The product id to interact with (if not specified will be recomputed from the current domain)
267
- * @param args.modalConfig - The modal configuration to display if the user is not logged in
268
- * @param args.options - Some options for the referral interaction
269
- *
270
- * @returns The resulting referral state, or a potential error
271
- *
272
- * @description This function will automatically handle the referral interaction process
273
- *
274
- * @see {@link @frak-labs/core-sdk!actions.processReferral | `processReferral()`} for more details on the automatic referral handling process
275
- */
276
- export declare function useReferralInteraction({ productId, modalConfig, options, }?: {
277
- productId?: Hex;
278
- modalConfig?: DisplayEmbeddedWalletParamsType;
279
- options?: ProcessReferralOptions;
280
- }): Error | ("error" | "no-referrer" | "idle" | "processing" | "success" | "no-wallet" | "no-session" | "self-referral");
281
-
282
- /**
283
- * Hook that return a mutation helping to send a user interaction
284
- *
285
- * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.sendInteraction | `sendInteraction()`} action
286
- *
287
- * @param args
288
- *
289
- * @group hooks
290
- *
291
- * @returns
292
- * The mutation hook wrapping the `sendInteraction()` action
293
- * The `mutate` and `mutateAsync` argument is of type {@link @frak-labs/core-sdk!index.SendInteractionParamsType | `SendInteractionParamsType`}
294
- * The `data` result is a {@link @frak-labs/core-sdk!index.SendInteractionReturnType | `SendInteractionReturnType`}
295
- *
296
- * @see {@link @frak-labs/core-sdk!actions.sendInteraction | `sendInteraction()`} for more info about the underlying action
297
- * @see {@link @tanstack/react-query!useMutation | `useMutation()`} for more info about the mutation options and response
298
- */
299
- export declare function useSendInteraction({ mutations, }?: UseSendInteractionParams): UseMutationResult< {
300
- delegationId: string;
301
- }, FrakRpcError<undefined>, SendInteractionParamsType, unknown>;
302
-
303
- /** @inline */
304
- declare interface UseSendInteractionParams {
305
- /**
306
- * Optional mutation options, see {@link @tanstack/react-query!useMutation | `useMutation()`} for more infos
307
- */
308
- mutations?: MutationOptions_2;
309
- }
310
-
311
- /**
312
- * Hook that return a mutation helping to send a transaction
313
- *
314
- * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.sendTransaction | `sendTransaction()`} action
315
- *
316
- * @param args
317
- *
318
- * @group hooks
319
- *
320
- * @returns
321
- * The mutation hook wrapping the `sendTransaction()` action
322
- * The `mutate` and `mutateAsync` argument is of type {@link @frak-labs/core-sdk!actions.SendTransactionParams | `SendTransactionParams`}
323
- * The `data` result is a {@link @frak-labs/core-sdk!index.SendTransactionReturnType | `SendTransactionReturnType`}
324
- *
325
- * @see {@link @frak-labs/core-sdk!actions.sendTransaction | `sendTransaction()`} for more info about the underlying action
326
- * @see {@link @tanstack/react-query!useMutation | `useMutation()`} for more info about the mutation options and response
327
- */
328
- export declare function useSendTransactionAction({ mutations, }?: UseSendTransactionParams): UseMutationResult< {
329
- hash: Hex;
330
- }, FrakRpcError<undefined>, SendTransactionParams, unknown>;
331
-
332
- /** @inline */
333
- declare interface UseSendTransactionParams {
334
- /**
335
- * Optional mutation options, see {@link @tanstack/react-query!useMutation | `useMutation()`} for more infos
336
- */
337
- mutations?: MutationOptions;
338
- }
339
-
340
- /**
341
- * Hook that return a mutation helping to send perform a SIWE authentication
342
- *
343
- * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.sendTransaction | `sendTransaction()`} action
344
- *
345
- * @param args
346
- *
347
- * @group hooks
348
- *
349
- * @returns
350
- * The mutation hook wrapping the `siweAuthenticate()` action
351
- * The `mutate` and `mutateAsync` argument is of type {@link @frak-labs/core-sdk!actions.SiweAuthenticateModalParams | `SiweAuthenticateModalParams`}
352
- * The `data` result is a {@link @frak-labs/core-sdk!index.SiweAuthenticateReturnType | `SiweAuthenticateReturnType`}
353
- *
354
- * @see {@link @frak-labs/core-sdk!actions.siweAuthenticate | `siweAuthenticate()`} for more info about the underlying action
355
- * @see {@link @tanstack/react-query!useMutation | `useMutation()`} for more info about the mutation options and response
356
- */
357
- export declare function useSiweAuthenticate({ mutations, }?: UseSiweAuthenticateParams): UseMutationResult< {
358
- signature: Hex;
359
- message: string;
360
- }, FrakRpcError<undefined>, SiweAuthenticateModalParams, unknown>;
361
-
362
- /** @ignore */
363
- declare interface UseSiweAuthenticateParams {
364
- /**
365
- * Optional mutation options, see {@link @tanstack/react-query!useMutation | `useMutation()`} for more infos
366
- */
367
- mutations?: MutationOptions_3;
368
- }
369
-
370
- /**
371
- * Hook that return a query helping to get the current wallet status.
372
- *
373
- * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.watchWalletStatus | `watchWalletStatus()`} action
374
- *
375
- * @group hooks
376
- *
377
- * @returns
378
- * The query hook wrapping the `watchWalletStatus()` action
379
- * The `data` result is a {@link @frak-labs/core-sdk!index.WalletStatusReturnType | `WalletStatusReturnType`}
380
- *
381
- * @see {@link @frak-labs/core-sdk!actions.watchWalletStatus | `watchWalletStatus()`} for more info about the underlying action
382
- * @see {@link @tanstack/react-query!useQuery | `useQuery()`} for more info about the useQuery response
383
- */
384
- export declare function useWalletStatus(): UseQueryResult<WalletStatusReturnType, Error>;
385
-
386
- export { }
1
+ import * as _frak_labs_core_sdk0 from "@frak-labs/core-sdk";
2
+ import { DisplayEmbeddedWalletParamsType, DisplayModalParamsType, FrakClient, FrakWalletSdkConfig, GetProductInformationReturnType, ModalRpcStepsResultType, ModalStepTypes, OpenSsoParamsType, OpenSsoReturnType, PrepareSsoParamsType, SendInteractionParamsType, SendInteractionReturnType, SendTransactionReturnType, SiweAuthenticateReturnType, WalletStatusReturnType } from "@frak-labs/core-sdk";
3
+ import { ProcessReferralOptions, SendTransactionParams, SiweAuthenticateModalParams } from "@frak-labs/core-sdk/actions";
4
+ import { Hex } from "viem";
5
+ import * as _tanstack_react_query0 from "@tanstack/react-query";
6
+ import { UseMutationOptions, UseQueryOptions } from "@tanstack/react-query";
7
+ import { FrakRpcError } from "@frak-labs/frame-connector";
8
+ import * as react2 from "react";
9
+ import { CSSProperties, PropsWithChildren, ReactNode } from "react";
10
+
11
+ //#region src/hook/helper/useReferralInteraction.d.ts
12
+
13
+ /**
14
+ * Helper hook to automatically submit a referral interaction when detected
15
+ *
16
+ * @group hooks
17
+ *
18
+ * @param args
19
+ * @param args.productId - The product id to interact with (if not specified will be recomputed from the current domain)
20
+ * @param args.modalConfig - The modal configuration to display if the user is not logged in
21
+ * @param args.options - Some options for the referral interaction
22
+ *
23
+ * @returns The resulting referral state, or a potential error
24
+ *
25
+ * @description This function will automatically handle the referral interaction process
26
+ *
27
+ * @see {@link @frak-labs/core-sdk!actions.processReferral | `processReferral()`} for more details on the automatic referral handling process
28
+ */
29
+ declare function useReferralInteraction({
30
+ productId,
31
+ modalConfig,
32
+ options
33
+ }?: {
34
+ productId?: Hex;
35
+ modalConfig?: DisplayEmbeddedWalletParamsType;
36
+ options?: ProcessReferralOptions;
37
+ }): Error | ("processing" | "no-referrer" | "idle" | "success" | "no-wallet" | "no-session" | "error" | "self-referral");
38
+ //#endregion
39
+ //#region src/hook/useDisplayModal.d.ts
40
+ /** @ignore */
41
+ type MutationOptions$4<T extends ModalStepTypes[]> = Omit<UseMutationOptions<ModalRpcStepsResultType<T>, FrakRpcError, DisplayModalParamsType<T>>, "mutationFn" | "mutationKey">;
42
+ /** @inline */
43
+ interface UseDisplayModalParams<T extends ModalStepTypes[] = ModalStepTypes[]> {
44
+ /**
45
+ * Optional mutation options, see {@link @tanstack/react-query!useMutation | `useMutation()`} for more infos
46
+ */
47
+ mutations?: MutationOptions$4<T>;
48
+ }
49
+ /**
50
+ * Hook that return a mutation helping to display a modal to the user
51
+ *
52
+ * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.displayModal | `displayModal()`} action
53
+ *
54
+ * @param args
55
+ *
56
+ * @typeParam T
57
+ * The modal steps types to display (the result will correspond to the steps types asked in params)
58
+ * An array of {@link @frak-labs/core-sdk!index.ModalStepTypes | `ModalStepTypes`}
59
+ * If not provided, it will default to a generic array of `ModalStepTypes`
60
+ *
61
+ * @group hooks
62
+ *
63
+ * @returns
64
+ * The mutation hook wrapping the `displayModal()` action
65
+ * The `mutate` and `mutateAsync` argument is of type {@link @frak-labs/core-sdk!index.DisplayModalParamsType | `DisplayModalParamsType<T>`}, with type params `T` being the modal steps types to display
66
+ * The `data` result is a {@link @frak-labs/core-sdk!index.ModalRpcStepsResultType | `ModalRpcStepsResultType`}
67
+ *
68
+ * @see {@link @frak-labs/core-sdk!actions.displayModal | `displayModal()`} for more info about the underlying action
69
+ * @see {@link @tanstack/react-query!useMutation | `useMutation()`} for more info about the mutation options and response
70
+ */
71
+ declare function useDisplayModal<T extends ModalStepTypes[] = ModalStepTypes[]>({
72
+ mutations
73
+ }?: UseDisplayModalParams<T>): _tanstack_react_query0.UseMutationResult<ModalRpcStepsResultType<T>, FrakRpcError<undefined>, DisplayModalParamsType<T>, unknown>;
74
+ //#endregion
75
+ //#region src/hook/useFrakClient.d.ts
76
+ /**
77
+ * Get the current Frak client
78
+ *
79
+ * @group hooks
80
+ */
81
+ declare function useFrakClient(): _frak_labs_core_sdk0.FrakClient | undefined;
82
+ //#endregion
83
+ //#region src/hook/useFrakConfig.d.ts
84
+ /**
85
+ * Get the current Frak config
86
+ * @throws {FrakRpcError} if the config is not found (only if this hooks is used outside a FrakConfigProvider)
87
+ * @group hooks
88
+ *
89
+ * @see {@link @frak-labs/react-sdk!FrakConfigProvider | FrakConfigProvider} for the config provider
90
+ * @see {@link @frak-labs/core-sdk!index.FrakWalletSdkConfig | FrakWalletSdkConfig} for the config type
91
+ */
92
+ declare function useFrakConfig(): _frak_labs_core_sdk0.FrakWalletSdkConfig;
93
+ //#endregion
94
+ //#region src/hook/useGetProductInformation.d.ts
95
+ /** @ignore */
96
+ type QueryOptions = Omit<UseQueryOptions<GetProductInformationReturnType, FrakRpcError, undefined>, "queryKey" | "queryFn">;
97
+ /** @inline */
98
+ interface UseGetProductInformationParams {
99
+ /**
100
+ * Optional query options, see {@link @tanstack/react-query!useQuery | `useQuery()`} for more infos
101
+ */
102
+ query?: QueryOptions;
103
+ }
104
+ /**
105
+ * Hook that return a query helping to get the current product information
106
+ *
107
+ * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.getProductInformation | `getProductInformation()`} action
108
+ *
109
+ * @param args
110
+ *
111
+ * @group hooks
112
+ *
113
+ * @returns
114
+ * The query hook wrapping the `getProductInformation()` action
115
+ * The `data` result is a {@link @frak-labs/core-sdk!index.GetProductInformationReturnType | `GetProductInformationReturnType`}
116
+ *
117
+ * @see {@link @frak-labs/core-sdk!actions.getProductInformation | `getProductInformation()`} for more info about the underlying action
118
+ * @see {@link @tanstack/react-query!useQuery | `useQuery()`} for more info about the useQuery options and response
119
+ */
120
+ declare function useGetProductInformation({
121
+ query
122
+ }?: UseGetProductInformationParams): _tanstack_react_query0.UseQueryResult<undefined, FrakRpcError<undefined>>;
123
+ //#endregion
124
+ //#region src/hook/useOpenSso.d.ts
125
+ /** @ignore */
126
+ type MutationOptions$3 = Omit<UseMutationOptions<OpenSsoReturnType, FrakRpcError, OpenSsoParamsType>, "mutationFn" | "mutationKey">;
127
+ /** @inline */
128
+ interface UseOpenSsoParams {
129
+ /**
130
+ * Optional mutation options, see {@link @tanstack/react-query!useMutation | `useMutation()`} for more infos
131
+ */
132
+ mutations?: MutationOptions$3;
133
+ }
134
+ /**
135
+ * Hook that return a mutation helping to open the SSO page
136
+ *
137
+ * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.openSso | `openSso()`} action
138
+ *
139
+ * @param args
140
+ *
141
+ * @group hooks
142
+ *
143
+ * @returns
144
+ * The mutation hook wrapping the `openSso()` action
145
+ * The `mutate` and `mutateAsync` argument is of type {@link @frak-labs/core-sdk!index.OpenSsoParamsType | `OpenSsoParamsType`}
146
+ * The mutation doesn't output any value
147
+ *
148
+ * @see {@link @frak-labs/core-sdk!actions.openSso | `openSso()`} for more info about the underlying action
149
+ * @see {@link @tanstack/react-query!useMutation | `useMutation()`} for more info about the mutation options and response
150
+ */
151
+ declare function useOpenSso({
152
+ mutations
153
+ }?: UseOpenSsoParams): _tanstack_react_query0.UseMutationResult<OpenSsoReturnType, FrakRpcError<undefined>, OpenSsoParamsType, unknown>;
154
+ //#endregion
155
+ //#region src/hook/usePrepareSso.d.ts
156
+ /**
157
+ * Hook that generates SSO URL for popup flow
158
+ *
159
+ * This is a **synchronous** hook (no async calls) that generates the SSO URL
160
+ * client-side without communicating with the wallet iframe.
161
+ *
162
+ * @param params - SSO parameters for URL generation
163
+ *
164
+ * @group hooks
165
+ *
166
+ * @returns
167
+ * Object containing:
168
+ * - `ssoUrl`: Generated SSO URL (or undefined if client not ready)
169
+ * - `isReady`: Boolean indicating if URL is available
170
+ *
171
+ * @example
172
+ * ```tsx
173
+ * function MyComponent() {
174
+ * const { data } = usePrepareSso({
175
+ * metadata: { logoUrl: "..." },
176
+ * directExit: true
177
+ * });
178
+ *
179
+ * const handleClick = () => {
180
+ * if (ssoUrl) {
181
+ * window.open(data?.ssoUrl, "_blank");
182
+ * }
183
+ * };
184
+ *
185
+ * return <button onClick={handleClick} disabled={!isReady}>Login</button>;
186
+ * }
187
+ * ```
188
+ *
189
+ * @see {@link @frak-labs/core-sdk!actions.prepareSso | `prepareSso()`} for the underlying action
190
+ * @see {@link @frak-labs/core-sdk!actions.openSso | `openSso()`} for the recommended high-level API
191
+ */
192
+ declare function usePrepareSso(params: PrepareSsoParamsType): _tanstack_react_query0.UseQueryResult<_frak_labs_core_sdk0.PrepareSsoReturnType, Error>;
193
+ //#endregion
194
+ //#region src/hook/useSendInteraction.d.ts
195
+ /** @ignore */
196
+ type MutationOptions$2 = Omit<UseMutationOptions<SendInteractionReturnType, FrakRpcError, SendInteractionParamsType>, "mutationFn" | "mutationKey">;
197
+ /** @inline */
198
+ interface UseSendInteractionParams {
199
+ /**
200
+ * Optional mutation options, see {@link @tanstack/react-query!useMutation | `useMutation()`} for more infos
201
+ */
202
+ mutations?: MutationOptions$2;
203
+ }
204
+ /**
205
+ * Hook that return a mutation helping to send a user interaction
206
+ *
207
+ * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.sendInteraction | `sendInteraction()`} action
208
+ *
209
+ * @param args
210
+ *
211
+ * @group hooks
212
+ *
213
+ * @returns
214
+ * The mutation hook wrapping the `sendInteraction()` action
215
+ * The `mutate` and `mutateAsync` argument is of type {@link @frak-labs/core-sdk!index.SendInteractionParamsType | `SendInteractionParamsType`}
216
+ * The `data` result is a {@link @frak-labs/core-sdk!index.SendInteractionReturnType | `SendInteractionReturnType`}
217
+ *
218
+ * @see {@link @frak-labs/core-sdk!actions.sendInteraction | `sendInteraction()`} for more info about the underlying action
219
+ * @see {@link @tanstack/react-query!useMutation | `useMutation()`} for more info about the mutation options and response
220
+ */
221
+ declare function useSendInteraction({
222
+ mutations
223
+ }?: UseSendInteractionParams): _tanstack_react_query0.UseMutationResult<SendInteractionReturnType, FrakRpcError<undefined>, SendInteractionParamsType, unknown>;
224
+ //#endregion
225
+ //#region src/hook/useSendTransaction.d.ts
226
+ /** @ignore */
227
+ type MutationOptions$1 = Omit<UseMutationOptions<SendTransactionReturnType, FrakRpcError, SendTransactionParams>, "mutationFn" | "mutationKey">;
228
+ /** @inline */
229
+ interface UseSendTransactionParams {
230
+ /**
231
+ * Optional mutation options, see {@link @tanstack/react-query!useMutation | `useMutation()`} for more infos
232
+ */
233
+ mutations?: MutationOptions$1;
234
+ }
235
+ /**
236
+ * Hook that return a mutation helping to send a transaction
237
+ *
238
+ * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.sendTransaction | `sendTransaction()`} action
239
+ *
240
+ * @param args
241
+ *
242
+ * @group hooks
243
+ *
244
+ * @returns
245
+ * The mutation hook wrapping the `sendTransaction()` action
246
+ * The `mutate` and `mutateAsync` argument is of type {@link @frak-labs/core-sdk!actions.SendTransactionParams | `SendTransactionParams`}
247
+ * The `data` result is a {@link @frak-labs/core-sdk!index.SendTransactionReturnType | `SendTransactionReturnType`}
248
+ *
249
+ * @see {@link @frak-labs/core-sdk!actions.sendTransaction | `sendTransaction()`} for more info about the underlying action
250
+ * @see {@link @tanstack/react-query!useMutation | `useMutation()`} for more info about the mutation options and response
251
+ */
252
+ declare function useSendTransactionAction({
253
+ mutations
254
+ }?: UseSendTransactionParams): _tanstack_react_query0.UseMutationResult<SendTransactionReturnType, FrakRpcError<undefined>, SendTransactionParams, unknown>;
255
+ //#endregion
256
+ //#region src/hook/useSiweAuthenticate.d.ts
257
+ /** @inline */
258
+ type MutationOptions = Omit<UseMutationOptions<SiweAuthenticateReturnType, FrakRpcError, SiweAuthenticateModalParams>, "mutationFn" | "mutationKey">;
259
+ /** @ignore */
260
+ interface UseSiweAuthenticateParams {
261
+ /**
262
+ * Optional mutation options, see {@link @tanstack/react-query!useMutation | `useMutation()`} for more infos
263
+ */
264
+ mutations?: MutationOptions;
265
+ }
266
+ /**
267
+ * Hook that return a mutation helping to send perform a SIWE authentication
268
+ *
269
+ * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.sendTransaction | `sendTransaction()`} action
270
+ *
271
+ * @param args
272
+ *
273
+ * @group hooks
274
+ *
275
+ * @returns
276
+ * The mutation hook wrapping the `siweAuthenticate()` action
277
+ * The `mutate` and `mutateAsync` argument is of type {@link @frak-labs/core-sdk!actions.SiweAuthenticateModalParams | `SiweAuthenticateModalParams`}
278
+ * The `data` result is a {@link @frak-labs/core-sdk!index.SiweAuthenticateReturnType | `SiweAuthenticateReturnType`}
279
+ *
280
+ * @see {@link @frak-labs/core-sdk!actions.siweAuthenticate | `siweAuthenticate()`} for more info about the underlying action
281
+ * @see {@link @tanstack/react-query!useMutation | `useMutation()`} for more info about the mutation options and response
282
+ */
283
+ declare function useSiweAuthenticate({
284
+ mutations
285
+ }?: UseSiweAuthenticateParams): _tanstack_react_query0.UseMutationResult<SiweAuthenticateReturnType, FrakRpcError<undefined>, SiweAuthenticateModalParams, unknown>;
286
+ //#endregion
287
+ //#region src/hook/useWalletStatus.d.ts
288
+ /**
289
+ * Hook that return a query helping to get the current wallet status.
290
+ *
291
+ * It's a {@link @tanstack/react-query!home | `tanstack`} wrapper around the {@link @frak-labs/core-sdk!actions.watchWalletStatus | `watchWalletStatus()`} action
292
+ *
293
+ * @group hooks
294
+ *
295
+ * @returns
296
+ * The query hook wrapping the `watchWalletStatus()` action
297
+ * The `data` result is a {@link @frak-labs/core-sdk!index.WalletStatusReturnType | `WalletStatusReturnType`}
298
+ *
299
+ * @see {@link @frak-labs/core-sdk!actions.watchWalletStatus | `watchWalletStatus()`} for more info about the underlying action
300
+ * @see {@link @tanstack/react-query!useQuery | `useQuery()`} for more info about the useQuery response
301
+ */
302
+ declare function useWalletStatus(): _tanstack_react_query0.UseQueryResult<WalletStatusReturnType, Error>;
303
+ //#endregion
304
+ //#region src/provider/FrakConfigProvider.d.ts
305
+ /**
306
+ * The context that will keep the Frak Wallet SDK configuration
307
+ * @ignore
308
+ */
309
+ declare const FrakConfigContext: react2.Context<FrakWalletSdkConfig | undefined>;
310
+ /**
311
+ * Props to instantiate the Frak Wallet SDK configuration provider
312
+ *
313
+ * @group provider
314
+ */
315
+ type FrakConfigProviderProps = {
316
+ /**
317
+ * The wanted Frak configuration
318
+ * @see {@link @frak-labs/core-sdk!index.FrakWalletSdkConfig | FrakWalletSdkConfig}
319
+ */
320
+ config: FrakWalletSdkConfig;
321
+ };
322
+ /**
323
+ * Simple config provider for the Frak Wallet SDK
324
+ *
325
+ * Should be wrapped within a {@link @tanstack/react-query!QueryClientProvider | `QueryClientProvider`}
326
+ *
327
+ * @group provider
328
+ *
329
+ * @param parameters
330
+ */
331
+ declare function FrakConfigProvider(parameters: PropsWithChildren<FrakConfigProviderProps>): react2.FunctionComponentElement<react2.ProviderProps<FrakWalletSdkConfig | undefined>>;
332
+ //#endregion
333
+ //#region src/provider/FrakIFrameClientProvider.d.ts
334
+ /**
335
+ * The context that will keep the Frak Wallet SDK client
336
+ * @ignore
337
+ */
338
+ declare const FrakIFrameClientContext: react2.Context<FrakClient | undefined>;
339
+ /**
340
+ * Props to instantiate the Frak Wallet SDK configuration provider
341
+ *
342
+ * @group provider
343
+ */
344
+ type FrakIFrameClientProps = {
345
+ config: FrakWalletSdkConfig;
346
+ };
347
+ /**
348
+ * IFrame client provider for the Frak Wallet SDK
349
+ * It will automatically create the frak wallet iFrame (required for the wallet to communicate with the SDK securely), and provide it in the context
350
+ *
351
+ * @group provider
352
+ *
353
+ * @remarks
354
+ * This provider must be wrapped within a {@link FrakConfigProvider} to work properly
355
+ *
356
+ * @param args
357
+ * @param args.style - Some custom styles to apply to the iFrame
358
+ * @param args.children - Descedant components that will have access to the Frak Client
359
+ */
360
+ declare function FrakIFrameClientProvider({
361
+ style,
362
+ children
363
+ }: {
364
+ style?: CSSProperties;
365
+ children?: ReactNode;
366
+ }): react2.FunctionComponentElement<react2.FragmentProps>;
367
+ //#endregion
368
+ export { FrakConfigContext, FrakConfigProvider, type FrakConfigProviderProps, FrakIFrameClientContext, type FrakIFrameClientProps, FrakIFrameClientProvider, useDisplayModal, useFrakClient, useFrakConfig, useGetProductInformation, useOpenSso, usePrepareSso, useReferralInteraction, useSendInteraction, useSendTransactionAction, useSiweAuthenticate, useWalletStatus };