@frak-labs/react-sdk 0.1.0-beta.ebc9d3a3 → 0.1.0-beta.f3715ed5

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