@frak-labs/react-sdk 0.0.19 → 0.1.0-beta.263acd1e

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