@0xsequence/connect 5.0.8 → 5.1.0

package/dist/cjs/hooks/useProjectAccessKey.js

@@ -2,6 +2,23 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useProjectAccessKey = void 0;
 const ConnectConfig_js_1 = require("../contexts/ConnectConfig.js");
+/**
+ * Hook to access the project access key from the Sequence Connect configuration.
+ *
+ * The project access key is a required configuration parameter used to authenticate and
+ * identify your application with Sequence services. It is used across various SDK features
+ * including marketplace integration and wallet connections.
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useProjectAccessKey} for more detailed documentation.
+ *
+ * @returns {string} The project access key configured for the application
+ *
+ * @example
+ * ```tsx
+ * const projectAccessKey = useProjectAccessKey()
+ * const marketplaceClient = new MarketplaceIndexer(apiUrl, projectAccessKey)
+ * ```
+ */
 const useProjectAccessKey = () => {
     const { projectAccessKey } = (0, ConnectConfig_js_1.useConnectConfigContext)();
     return projectAccessKey;

package/dist/cjs/hooks/useProjectAccessKey.js.map

@@ -1 +1 @@
-{"version":3,"file":"useProjectAccessKey.js","sourceRoot":"","sources":["../../../src/hooks/useProjectAccessKey.ts"],"names":[],"mappings":";;;AAAA,mEAAsE;AAE/D,MAAM,mBAAmB,GAAG,GAAG,EAAE;IACtC,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAA,0CAAuB,GAAE,CAAA;IAEtD,OAAO,gBAAgB,CAAA;AACzB,CAAC,CAAA;AAJY,QAAA,mBAAmB,uBAI/B"}
+{"version":3,"file":"useProjectAccessKey.js","sourceRoot":"","sources":["../../../src/hooks/useProjectAccessKey.ts"],"names":[],"mappings":";;;AAAA,mEAAsE;AAEtE;;;;;;;;;;;;;;;;GAgBG;AACI,MAAM,mBAAmB,GAAG,GAAG,EAAE;IACtC,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAA,0CAAuB,GAAE,CAAA;IAEtD,OAAO,gBAAgB,CAAA;AACzB,CAAC,CAAA;AAJY,QAAA,mBAAmB,uBAI/B"}

package/dist/cjs/hooks/useSignInEmail.d.ts

@@ -1,2 +1,22 @@
+/**
+ * Hook to retrieve the email address associated with the currently connected wallet.
+ *
+ * This hook monitors the connection status and retrieves the stored email address when a wallet
+ * is connected. It works with both WaaS (Wallet-as-a-Service) and universal wallet types.
+ * The email is cleared when the wallet is disconnected.
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useSignInEmail} for more detailed documentation.
+ *
+ * @returns {string | null} The email address of the connected wallet user, or null if not connected
+ * or no email is associated
+ *
+ * @example
+ * ```tsx
+ * const email = useSignInEmail()
+ * if (email) {
+ *   console.log('Connected user email:', email)
+ * }
+ * ```
+ */
 export declare const useSignInEmail: () => string | null;
 //# sourceMappingURL=useSignInEmail.d.ts.map

package/dist/cjs/hooks/useSignInEmail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSignInEmail.d.ts","sourceRoot":"","sources":["../../../src/hooks/useSignInEmail.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,cAAc,qBAoB1B,CAAA"}
+{"version":3,"file":"useSignInEmail.d.ts","sourceRoot":"","sources":["../../../src/hooks/useSignInEmail.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,qBAoB1B,CAAA"}

package/dist/cjs/hooks/useSignInEmail.js

@@ -5,6 +5,26 @@ exports.useSignInEmail = void 0;
 const react_1 = require("react");
 const wagmi_1 = require("wagmi");
 const localStorage_1 = require("../constants/localStorage");
+/**
+ * Hook to retrieve the email address associated with the currently connected wallet.
+ *
+ * This hook monitors the connection status and retrieves the stored email address when a wallet
+ * is connected. It works with both WaaS (Wallet-as-a-Service) and universal wallet types.
+ * The email is cleared when the wallet is disconnected.
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useSignInEmail} for more detailed documentation.
+ *
+ * @returns {string | null} The email address of the connected wallet user, or null if not connected
+ * or no email is associated
+ *
+ * @example
+ * ```tsx
+ * const email = useSignInEmail()
+ * if (email) {
+ *   console.log('Connected user email:', email)
+ * }
+ * ```
+ */
 const useSignInEmail = () => {
     const { storage } = (0, wagmi_1.useConfig)();
     const { isConnected } = (0, wagmi_1.useAccount)();

package/dist/cjs/hooks/useSignInEmail.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSignInEmail.js","sourceRoot":"","sources":["../../../src/hooks/useSignInEmail.ts"],"names":[],"mappings":";AAAA,YAAY,CAAA;;;AAEZ,iCAA2C;AAC3C,iCAA6C;AAE7C,4DAA2D;AAEpD,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAA,iBAAS,GAAE,CAAA;IAC/B,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,kBAAU,GAAE,CAAA;IACpC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAgB,IAAI,CAAC,CAAA;IAEvD,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;QAC5B,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,OAAO,CAAC,8BAAe,CAAC,eAAe,CAAC,CAAA;QAE3E,QAAQ,CAAC,WAAqB,CAAC,CAAA;IACjC,CAAC,CAAA;IAED,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,WAAW,EAAE,CAAC;YAChB,UAAU,EAAE,CAAA;QACd,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC;IACH,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAA;IAEjB,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AApBY,QAAA,cAAc,kBAoB1B"}
+{"version":3,"file":"useSignInEmail.js","sourceRoot":"","sources":["../../../src/hooks/useSignInEmail.ts"],"names":[],"mappings":";AAAA,YAAY,CAAA;;;AAEZ,iCAA2C;AAC3C,iCAA6C;AAE7C,4DAA2D;AAE3D;;;;;;;;;;;;;;;;;;;GAmBG;AACI,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAA,iBAAS,GAAE,CAAA;IAC/B,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,kBAAU,GAAE,CAAA;IACpC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAgB,IAAI,CAAC,CAAA;IAEvD,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;QAC5B,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,OAAO,CAAC,8BAAe,CAAC,eAAe,CAAC,CAAA;QAE3E,QAAQ,CAAC,WAAqB,CAAC,CAAA;IACjC,CAAC,CAAA;IAED,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,WAAW,EAAE,CAAC;YAChB,UAAU,EAAE,CAAA;QACd,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC;IACH,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAA;IAEjB,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AApBY,QAAA,cAAc,kBAoB1B"}

package/dist/cjs/hooks/useTheme.d.ts

@@ -1,3 +1,29 @@
+/**
+ * Hook to access and modify the theme and modal position settings.
+ *
+ * This hook provides access to the current theme (light/dark) and modal position settings,
+ * along with functions to update these values. The modal position can be set to various
+ * predefined positions on the screen.
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useTheme} for more detailed documentation.
+ *
+ * @returns {Object} An object containing:
+ * - `theme` - The current theme setting
+ * - `setTheme` - Function to update the theme
+ * - `position` - The current modal position ('center', 'top-right', 'bottom-left', etc.)
+ * - `setPosition` - Function to update the modal position
+ *
+ * @example
+ * ```tsx
+ * const { theme, setTheme, position, setPosition } = useTheme()
+ *
+ * // Change theme
+ * setTheme('dark')
+ *
+ * // Update modal position
+ * setPosition('top-right')
+ * ```
+ */
 export declare const useTheme: () => {
     setTheme: import("react").Dispatch<import("react").SetStateAction<import("@0xsequence/design-system").Theme>>;
     theme: import("@0xsequence/design-system").Theme;

package/dist/cjs/hooks/useTheme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTheme.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ;;;;;CASpB,CAAA"}
+{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTheme.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,QAAQ;;;;;CASpB,CAAA"}

package/dist/cjs/hooks/useTheme.js

@@ -2,6 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useTheme = void 0;
 const Theme_1 = require("../contexts/Theme");
+/**
+ * Hook to access and modify the theme and modal position settings.
+ *
+ * This hook provides access to the current theme (light/dark) and modal position settings,
+ * along with functions to update these values. The modal position can be set to various
+ * predefined positions on the screen.
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useTheme} for more detailed documentation.
+ *
+ * @returns {Object} An object containing:
+ * - `theme` - The current theme setting
+ * - `setTheme` - Function to update the theme
+ * - `position` - The current modal position ('center', 'top-right', 'bottom-left', etc.)
+ * - `setPosition` - Function to update the modal position
+ *
+ * @example
+ * ```tsx
+ * const { theme, setTheme, position, setPosition } = useTheme()
+ *
+ * // Change theme
+ * setTheme('dark')
+ *
+ * // Update modal position
+ * setPosition('top-right')
+ * ```
+ */
 const useTheme = () => {
     const { setTheme, theme, position, setPosition } = (0, Theme_1.useThemeContext)();
     return {

package/dist/cjs/hooks/useTheme.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTheme.js","sourceRoot":"","sources":["../../../src/hooks/useTheme.ts"],"names":[],"mappings":";;;AAAA,6CAAmD;AAE5C,MAAM,QAAQ,GAAG,GAAG,EAAE;IAC3B,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAA,uBAAe,GAAE,CAAA;IAEpE,OAAO;QACL,QAAQ;QACR,KAAK;QACL,QAAQ;QACR,WAAW;KACZ,CAAA;AACH,CAAC,CAAA;AATY,QAAA,QAAQ,YASpB"}
+{"version":3,"file":"useTheme.js","sourceRoot":"","sources":["../../../src/hooks/useTheme.ts"],"names":[],"mappings":";;;AAAA,6CAAmD;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,MAAM,QAAQ,GAAG,GAAG,EAAE;IAC3B,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAA,uBAAe,GAAE,CAAA;IAEpE,OAAO;QACL,QAAQ;QACR,KAAK;QACL,QAAQ;QACR,WAAW;KACZ,CAAA;AACH,CAAC,CAAA;AATY,QAAA,QAAQ,YASpB"}

package/dist/cjs/hooks/useWaasConfirmationHandler.d.ts

@@ -6,5 +6,44 @@ export type WaasRequestConfirmation = {
     txs?: commons.transaction.Transaction[];
     chainId?: number;
 };
+/**
+ * Hook to handle transaction and message signing confirmations for WaaS (Wallet-as-a-Service) connections.
+ *
+ * This hook sets up confirmation handlers for signing transactions and messages when using a WaaS connector.
+ * It manages the state of pending confirmations and provides functions to confirm or reject signing requests.
+ *
+ * @param waasConnector - The WaaS connector instance to handle confirmations for (optional)
+ *
+ * @returns A tuple containing:
+ * - [0] {@link WaasRequestConfirmation} | undefined - The current pending request confirmation info or undefined if none
+ * - [1] `(id: string) => void` - Function to confirm a pending request by ID
+ * - [2] `(id: string) => void` - Function to reject a pending request by ID
+ *
+ * The {@link WaasRequestConfirmation} object contains:
+ * - `id` - Unique identifier for the request
+ * - `type` - Either 'signTransaction' or 'signMessage'
+ * - `message?` - Optional message to sign (for signMessage requests)
+ * - `txs?` - Optional array of transactions (for signTransaction requests)
+ * - `chainId?` - Optional chain ID for the request
+ *
+ * @example
+ * ```tsx
+ * const [
+ *   pendingRequestConfirmation,
+ *   confirmPendingRequest,
+ *   rejectPendingRequest
+ * ] = useWaasConfirmationHandler(waasConnector)
+ *
+ * // When user confirms the request
+ * if (pendingRequestConfirmation) {
+ *   confirmPendingRequest(pendingRequestConfirmation.id)
+ * }
+ *
+ * // When user rejects the request
+ * if (pendingRequestConfirmation) {
+ *   rejectPendingRequest(pendingRequestConfirmation.id)
+ * }
+ * ```
+ */
 export declare function useWaasConfirmationHandler(waasConnector?: any): [WaasRequestConfirmation | undefined, (id: string) => void, (id: string) => void];
 //# sourceMappingURL=useWaasConfirmationHandler.d.ts.map

package/dist/cjs/hooks/useWaasConfirmationHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWaasConfirmationHandler.d.ts","sourceRoot":"","sources":["../../../src/hooks/useWaasConfirmationHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAO1C,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAA;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,CAAA;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,wBAAgB,0BAA0B,CACxC,aAAa,CAAC,EAAE,GAAG,GAClB,CAAC,uBAAuB,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC,CAkDnF"}
+{"version":3,"file":"useWaasConfirmationHandler.d.ts","sourceRoot":"","sources":["../../../src/hooks/useWaasConfirmationHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAO1C,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAA;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,CAAA;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,CAAC,EAAE,GAAG,GAClB,CAAC,uBAAuB,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC,CAkDnF"}

package/dist/cjs/hooks/useWaasConfirmationHandler.js

@@ -4,6 +4,45 @@ exports.useWaasConfirmationHandler = useWaasConfirmationHandler;
 const react_1 = require("react");
 const deferred_1 = require("../utils/deferred");
 let _pendingConfirmation;
+/**
+ * Hook to handle transaction and message signing confirmations for WaaS (Wallet-as-a-Service) connections.
+ *
+ * This hook sets up confirmation handlers for signing transactions and messages when using a WaaS connector.
+ * It manages the state of pending confirmations and provides functions to confirm or reject signing requests.
+ *
+ * @param waasConnector - The WaaS connector instance to handle confirmations for (optional)
+ *
+ * @returns A tuple containing:
+ * - [0] {@link WaasRequestConfirmation} | undefined - The current pending request confirmation info or undefined if none
+ * - [1] `(id: string) => void` - Function to confirm a pending request by ID
+ * - [2] `(id: string) => void` - Function to reject a pending request by ID
+ *
+ * The {@link WaasRequestConfirmation} object contains:
+ * - `id` - Unique identifier for the request
+ * - `type` - Either 'signTransaction' or 'signMessage'
+ * - `message?` - Optional message to sign (for signMessage requests)
+ * - `txs?` - Optional array of transactions (for signTransaction requests)
+ * - `chainId?` - Optional chain ID for the request
+ *
+ * @example
+ * ```tsx
+ * const [
+ *   pendingRequestConfirmation,
+ *   confirmPendingRequest,
+ *   rejectPendingRequest
+ * ] = useWaasConfirmationHandler(waasConnector)
+ *
+ * // When user confirms the request
+ * if (pendingRequestConfirmation) {
+ *   confirmPendingRequest(pendingRequestConfirmation.id)
+ * }
+ *
+ * // When user rejects the request
+ * if (pendingRequestConfirmation) {
+ *   rejectPendingRequest(pendingRequestConfirmation.id)
+ * }
+ * ```
+ */
 function useWaasConfirmationHandler(waasConnector) {
     const [pendingRequestConfirmation, setPendingRequestConfirmation] = (0, react_1.useState)();
     function confirmPendingRequest(id) {

package/dist/cjs/hooks/useWaasConfirmationHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"useWaasConfirmationHandler.js","sourceRoot":"","sources":["../../../src/hooks/useWaasConfirmationHandler.ts"],"names":[],"mappings":";;AAeA,gEAoDC;AAlED,iCAA2C;AAE3C,gDAA4C;AAE5C,IAAI,oBAA8E,CAAA;AAUlF,SAAgB,0BAA0B,CACxC,aAAmB;IAEnB,MAAM,CAAC,0BAA0B,EAAE,6BAA6B,CAAC,GAAG,IAAA,gBAAQ,GAAuC,CAAA;IAEnH,SAAS,qBAAqB,CAAC,EAAU;QACvC,oBAAoB,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACtD,6BAA6B,CAAC,SAAS,CAAC,CAAA;QACxC,oBAAoB,GAAG,SAAS,CAAA;IAClC,CAAC;IAED,SAAS,oBAAoB,CAAC,EAAU;QACtC,oBAAoB,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;QACvD,6BAA6B,CAAC,SAAS,CAAC,CAAA;QACxC,oBAAoB,GAAG,SAAS,CAAA;IAClC,CAAC;IAED,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,KAAK,UAAU,KAAK;YAClB,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,OAAM;YACR,CAAC;YAED,MAAM,YAAY,GAAG,aAAa,CAAC,oBAAoB,CAAA;YAEvD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAM;YACR,CAAC;YAED,YAAY,CAAC,0BAA0B,GAAG;gBACxC,6BAA6B,CAC3B,EAAU,EACV,GAAsC,EACtC,OAAe;oBAEf,MAAM,OAAO,GAAG,IAAI,mBAAQ,EAAsC,CAAA;oBAClE,6BAA6B,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;oBAC9G,oBAAoB,GAAG,OAAO,CAAA;oBAC9B,OAAO,OAAO,CAAC,OAAO,CAAA;gBACxB,CAAC;gBACD,yBAAyB,CAAC,EAAU,EAAE,OAAe,EAAE,OAAe;oBACpE,MAAM,OAAO,GAAG,IAAI,mBAAQ,EAAsC,CAAA;oBAClE,6BAA6B,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;oBAC5E,oBAAoB,GAAG,OAAO,CAAA;oBAC9B,OAAO,OAAO,CAAC,OAAO,CAAA;gBACxB,CAAC;aACF,CAAA;QACH,CAAC;QACD,KAAK,EAAE,CAAA;IACT,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,0BAA0B,EAAE,qBAAqB,EAAE,oBAAoB,CAAC,CAAA;AAClF,CAAC"}
+{"version":3,"file":"useWaasConfirmationHandler.js","sourceRoot":"","sources":["../../../src/hooks/useWaasConfirmationHandler.ts"],"names":[],"mappings":";;AAsDA,gEAoDC;AAzGD,iCAA2C;AAE3C,gDAA4C;AAE5C,IAAI,oBAA8E,CAAA;AAUlF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,SAAgB,0BAA0B,CACxC,aAAmB;IAEnB,MAAM,CAAC,0BAA0B,EAAE,6BAA6B,CAAC,GAAG,IAAA,gBAAQ,GAAuC,CAAA;IAEnH,SAAS,qBAAqB,CAAC,EAAU;QACvC,oBAAoB,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACtD,6BAA6B,CAAC,SAAS,CAAC,CAAA;QACxC,oBAAoB,GAAG,SAAS,CAAA;IAClC,CAAC;IAED,SAAS,oBAAoB,CAAC,EAAU;QACtC,oBAAoB,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;QACvD,6BAA6B,CAAC,SAAS,CAAC,CAAA;QACxC,oBAAoB,GAAG,SAAS,CAAA;IAClC,CAAC;IAED,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,KAAK,UAAU,KAAK;YAClB,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,OAAM;YACR,CAAC;YAED,MAAM,YAAY,GAAG,aAAa,CAAC,oBAAoB,CAAA;YAEvD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAM;YACR,CAAC;YAED,YAAY,CAAC,0BAA0B,GAAG;gBACxC,6BAA6B,CAC3B,EAAU,EACV,GAAsC,EACtC,OAAe;oBAEf,MAAM,OAAO,GAAG,IAAI,mBAAQ,EAAsC,CAAA;oBAClE,6BAA6B,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;oBAC9G,oBAAoB,GAAG,OAAO,CAAA;oBAC9B,OAAO,OAAO,CAAC,OAAO,CAAA;gBACxB,CAAC;gBACD,yBAAyB,CAAC,EAAU,EAAE,OAAe,EAAE,OAAe;oBACpE,MAAM,OAAO,GAAG,IAAI,mBAAQ,EAAsC,CAAA;oBAClE,6BAA6B,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;oBAC5E,oBAAoB,GAAG,OAAO,CAAA;oBAC9B,OAAO,OAAO,CAAC,OAAO,CAAA;gBACxB,CAAC;aACF,CAAA;QACH,CAAC;QACD,KAAK,EAAE,CAAA;IACT,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,0BAA0B,EAAE,qBAAqB,EAAE,oBAAoB,CAAC,CAAA;AAClF,CAAC"}

package/dist/cjs/hooks/useWaasEmailAuth.d.ts

@@ -8,6 +8,52 @@ interface SuccessResultV2 {
     version: 2;
     signInResponse: SignInResponse;
 }
+/**
+ * Hook to handle email-based authentication flow for WaaS (Wallet-as-a-Service).
+ *
+ * This hook manages the complete email authentication process, including:
+ * - Initiating email authentication
+ * - Handling verification code submission
+ * - Managing loading and error states
+ * - Supporting both v1 (idToken) and v2 (SignInResponse) authentication formats
+ *
+ * @param {ExtendedConnector} [params.connector] - The WaaS connector to use for authentication.
+ *        Optional because the user might not have selected a connector yet.
+ * @param {Function} params.onSuccess - Callback function called when authentication succeeds.
+ *        Receives either a v1 result (with idToken) or v2 result (with SignInResponse).
+ *
+ * @returns {Object} An object containing:
+ * - `inProgress` - Whether authentication is currently in progress
+ * - `loading` - Whether a specific authentication operation is loading
+ * - `error` - Any error that occurred during authentication
+ * - `initiateAuth` - Function to start the email authentication process
+ * - `sendChallengeAnswer` - Function to submit the verification code
+ * - `cancel` - Function to cancel the authentication process
+ * - `resetError` - Function to clear any error state
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   inProgress,
+ *   loading,
+ *   error,
+ *   initiateAuth,
+ *   sendChallengeAnswer,
+ *   resetError
+ * } = useEmailAuth({
+ *   connector: emailConnector,
+ *   onSuccess: async (result) => {
+ *     if ('signInResponse' in result) {
+ *       // Handle v2 authentication
+ *       await storage.setItem('email', result.signInResponse.email)
+ *     } else {
+ *       // Handle v1 authentication
+ *       await storage.setItem('idToken', result.idToken)
+ *     }
+ *   }
+ * })
+ * ```
+ */
 export declare function useEmailAuth({ connector, onSuccess }: {
     connector?: ExtendedConnector;
     onSuccess: (result: SuccessResultV1 | SuccessResultV2) => void;

package/dist/cjs/hooks/useWaasEmailAuth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWaasEmailAuth.d.ts","sourceRoot":"","sources":["../../../src/hooks/useWaasEmailAuth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAK/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE5C,UAAU,eAAe;IACvB,OAAO,EAAE,CAAC,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,CAAC,CAAA;IACV,cAAc,EAAE,cAAc,CAAA;CAC/B;AAED,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,SAAS,EACV,EAAE;IACD,SAAS,CAAC,EAAE,iBAAiB,CAAA;IAC7B,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,KAAK,IAAI,CAAA;CAC/D;;;;2BAYkC,MAAM;mCACE,MAAM;;;;;;;0BAmBZ,MAAM;kCA2BE,MAAM;;;EAwClD"}
+{"version":3,"file":"useWaasEmailAuth.d.ts","sourceRoot":"","sources":["../../../src/hooks/useWaasEmailAuth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAK/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE5C,UAAU,eAAe;IACvB,OAAO,EAAE,CAAC,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,CAAC,CAAA;IACV,cAAc,EAAE,cAAc,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,SAAS,EACV,EAAE;IACD,SAAS,CAAC,EAAE,iBAAiB,CAAA;IAC7B,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,KAAK,IAAI,CAAA;CAC/D;;;;2BAYkC,MAAM;mCACE,MAAM;;;;;;;0BAmBZ,MAAM;kCA2BE,MAAM;;;EAwClD"}

package/dist/cjs/hooks/useWaasEmailAuth.js

@@ -4,6 +4,52 @@ exports.useEmailAuth = useEmailAuth;
 const react_1 = require("react");
 // import { EmailWaasOptions } from '../connectors/email/emailWaas'
 const wagmiConnectors_1 = require("../connectors/wagmiConnectors");
+/**
+ * Hook to handle email-based authentication flow for WaaS (Wallet-as-a-Service).
+ *
+ * This hook manages the complete email authentication process, including:
+ * - Initiating email authentication
+ * - Handling verification code submission
+ * - Managing loading and error states
+ * - Supporting both v1 (idToken) and v2 (SignInResponse) authentication formats
+ *
+ * @param {ExtendedConnector} [params.connector] - The WaaS connector to use for authentication.
+ *        Optional because the user might not have selected a connector yet.
+ * @param {Function} params.onSuccess - Callback function called when authentication succeeds.
+ *        Receives either a v1 result (with idToken) or v2 result (with SignInResponse).
+ *
+ * @returns {Object} An object containing:
+ * - `inProgress` - Whether authentication is currently in progress
+ * - `loading` - Whether a specific authentication operation is loading
+ * - `error` - Any error that occurred during authentication
+ * - `initiateAuth` - Function to start the email authentication process
+ * - `sendChallengeAnswer` - Function to submit the verification code
+ * - `cancel` - Function to cancel the authentication process
+ * - `resetError` - Function to clear any error state
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   inProgress,
+ *   loading,
+ *   error,
+ *   initiateAuth,
+ *   sendChallengeAnswer,
+ *   resetError
+ * } = useEmailAuth({
+ *   connector: emailConnector,
+ *   onSuccess: async (result) => {
+ *     if ('signInResponse' in result) {
+ *       // Handle v2 authentication
+ *       await storage.setItem('email', result.signInResponse.email)
+ *     } else {
+ *       // Handle v1 authentication
+ *       await storage.setItem('idToken', result.idToken)
+ *     }
+ *   }
+ * })
+ * ```
+ */
 function useEmailAuth({ connector, onSuccess }) {
     const [_email, setEmail] = (0, react_1.useState)('');
     const [error, setError] = (0, react_1.useState)();

package/dist/cjs/hooks/useWaasEmailAuth.js.map

@@ -1 +1 @@
-{"version":3,"file":"useWaasEmailAuth.js","sourceRoot":"","sources":["../../../src/hooks/useWaasEmailAuth.ts"],"names":[],"mappings":";;AAiBA,oCAyGC;AAzHD,iCAAgC;AAEhC,mEAAmE;AACnE,mEAA0D;AAa1D,SAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,SAAS,EAIV;IACC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAC,EAAE,CAAC,CAAA;IACvC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,GAAqB,CAAA;IACvD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,IAAA,gBAAQ,EAAC,EAAE,CAAC,CAAA;IAC7C,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,IAAA,gBAAQ,GAA4C,CAAA;IAElG,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,SAAS;YAChB,YAAY,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE,GAAE,CAAC;YAC1C,mBAAmB,EAAE,KAAK,EAAE,OAAe,EAAE,EAAE,GAAE,CAAC;YAClD,UAAU,EAAE,GAAG,EAAE,GAAE,CAAC;SACrB,CAAA;IACH,CAAC;IAED,MAAM,eAAe,GAAG,GAAG,EAAE;QAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;QAC7C,CAAC;QAED,MAAM,YAAY,GAA8B,SAAiB,CAAC,YAAY,CAAA;QAE9E,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;QAC5D,CAAC;QAED,OAAO,YAAY,CAAA;IACrB,CAAC,CAAA;IAED,MAAM,YAAY,GAAG,KAAK,EAAE,KAAa,EAAE,EAAE;QAC3C,+DAA+D;QAC/D,MAAM,IAAI,GAAG,eAAe,EAAE,CAAA;QAE9B,UAAU,CAAC,IAAI,CAAC,CAAA;QAChB,QAAQ,CAAC,SAAS,CAAC,CAAA;QAEnB,IAAI,CAAC,uBAAuB,CAAC,KAAK,EAAC,eAAe,EAAC,EAAE;YACnD,kBAAkB,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;QAEF,IAAI;aACD,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,IAAA,4BAAU,GAAE,CAAC;aAC/B,IAAI,CAAC,cAAc,CAAC,EAAE;YACrB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,CAAA;YAEzC,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC;gBACzB,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;YAChC,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,CAAC,EAAE;YACX,QAAQ,CAAC,GAAG,CAAC,CAAA;QACf,CAAC,CAAC,CAAA;QAEJ,UAAU,CAAC,KAAK,CAAC,CAAA;IACnB,CAAC,CAAA;IAED,MAAM,mBAAmB,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QACnD,+DAA+D;QAC/D,iCAAiC;QAEjC,UAAU,CAAC,IAAI,CAAC,CAAA;QAChB,QAAQ,CAAC,SAAS,CAAC,CAAA;QAEnB,YAAY;QACZ,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QAClE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,eAAe,CAAC,MAAM,CAAC,CAAA;QAC/B,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,QAAQ,CAAC,GAAG,CAAC,CAAA;QACf,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,KAAK,CAAC,CAAA;QACnB,CAAC;IACH,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,UAAU,CAAC,KAAK,CAAC,CAAA;QACjB,kBAAkB,CAAC,IAAI,CAAC,CAAA;QACxB,QAAQ,CAAC,SAAS,CAAC,CAAA;IACrB,CAAC,CAAA;IAED,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,QAAQ,CAAC,SAAS,CAAC,CAAA;IACrB,CAAC,CAAA;IAED,OAAO;QACL,UAAU,EAAE,OAAO,IAAI,CAAC,CAAC,QAAQ;QACjC,OAAO;QACP,KAAK;QACL,YAAY;QACZ,mBAAmB;QACnB,MAAM;QACN,UAAU;KACX,CAAA;AACH,CAAC"}
+{"version":3,"file":"useWaasEmailAuth.js","sourceRoot":"","sources":["../../../src/hooks/useWaasEmailAuth.ts"],"names":[],"mappings":"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"}

package/dist/cjs/hooks/useWaasEmailConflict.d.ts

@@ -1,7 +1,46 @@
+/**
+ * Represents formatted email conflict information returned by the hook.
+ * This is a user-friendly version of the EmailConflictInfo from the WaaS service.
+ */
 export type FormattedEmailConflictInfo = {
+    /** The email address that caused the conflict */
     email: string;
+    /** User-friendly description of the account type (e.g., 'Google login', 'Email login') */
     type: string;
 };
+/**
+ * Hook to handle email conflict detection and resolution for WaaS (Wallet-as-a-Service) authentication.
+ *
+ * This hook monitors all WaaS connectors for email conflicts that occur during sign-in attempts.
+ * A conflict happens when a user tries to sign up with an email that's already associated with
+ * a different authentication method (e.g., trying to use Google sign-in when the email was
+ * previously used with Apple sign-in).
+ *
+ * @returns An object containing:
+ * - `toggleEmailConflictModal` - Function to manually show/hide the conflict modal
+ * - `isEmailConflictOpen` - Whether the conflict modal is currently open
+ * - `emailConflictInfo` - Formatted information about the conflict (email and account type)
+ * - `forceCreate` - Function to force create a new account despite the conflict
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   isEmailConflictOpen,
+ *   emailConflictInfo,
+ *   toggleEmailConflictModal
+ * } = useEmailConflict()
+ *
+ * // When a conflict is detected
+ * if (isEmailConflictOpen && emailConflictInfo) {
+ *   console.log(
+ *     `Email ${emailConflictInfo.email} is already used with ${emailConflictInfo.type}`
+ *   )
+ * }
+ *
+ * // Close the conflict modal
+ * toggleEmailConflictModal(false)
+ * ```
+ */
 export declare const useEmailConflict: () => {
     toggleEmailConflictModal: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     isEmailConflictOpen: boolean;

package/dist/cjs/hooks/useWaasEmailConflict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWaasEmailConflict.d.ts","sourceRoot":"","sources":["../../../src/hooks/useWaasEmailConflict.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AA6BD,eAAO,MAAM,gBAAgB;;;uBAiCpB,0BAA0B;;CAKlC,CAAA"}
+{"version":3,"file":"useWaasEmailConflict.d.ts","sourceRoot":"","sources":["../../../src/hooks/useWaasEmailConflict.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,gBAAgB;;;uBAiCpB,0BAA0B;;CAKlC,CAAA"}

package/dist/cjs/hooks/useWaasEmailConflict.js

@@ -4,6 +4,12 @@ exports.useEmailConflict = void 0;
 const waas_1 = require("@0xsequence/waas");
 const react_1 = require("react");
 const wagmi_1 = require("wagmi");
+/**
+ * Helper function to convert raw account type information into user-friendly text.
+ *
+ * @param info - The raw email conflict information from WaaS
+ * @returns A user-friendly string describing the account type
+ */
 const accountTypeText = (info) => {
     if (!info) {
         return 'Unknown account type';
@@ -26,6 +32,39 @@ const accountTypeText = (info) => {
     }
     return info.type;
 };
+/**
+ * Hook to handle email conflict detection and resolution for WaaS (Wallet-as-a-Service) authentication.
+ *
+ * This hook monitors all WaaS connectors for email conflicts that occur during sign-in attempts.
+ * A conflict happens when a user tries to sign up with an email that's already associated with
+ * a different authentication method (e.g., trying to use Google sign-in when the email was
+ * previously used with Apple sign-in).
+ *
+ * @returns An object containing:
+ * - `toggleEmailConflictModal` - Function to manually show/hide the conflict modal
+ * - `isEmailConflictOpen` - Whether the conflict modal is currently open
+ * - `emailConflictInfo` - Formatted information about the conflict (email and account type)
+ * - `forceCreate` - Function to force create a new account despite the conflict
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   isEmailConflictOpen,
+ *   emailConflictInfo,
+ *   toggleEmailConflictModal
+ * } = useEmailConflict()
+ *
+ * // When a conflict is detected
+ * if (isEmailConflictOpen && emailConflictInfo) {
+ *   console.log(
+ *     `Email ${emailConflictInfo.email} is already used with ${emailConflictInfo.type}`
+ *   )
+ * }
+ *
+ * // Close the conflict modal
+ * toggleEmailConflictModal(false)
+ * ```
+ */
 const useEmailConflict = () => {
     const { connectors } = (0, wagmi_1.useConnect)();
     const forceCreateFuncRef = (0, react_1.useRef)(null);

package/dist/cjs/hooks/useWaasEmailConflict.js.map

@@ -1 +1 @@
-{"version":3,"file":"useWaasEmailConflict.js","sourceRoot":"","sources":["../../../src/hooks/useWaasEmailConflict.ts"],"names":[],"mappings":";;;AAAA,2CAAgF;AAChF,iCAAmD;AACnD,iCAAkC;AAOlC,MAAM,eAAe,GAAG,CAAC,IAA8B,EAAE,EAAE;IACzD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,sBAAsB,CAAA;IAC/B,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAY,CAAC,OAAO,EAAE,CAAC;QACvC,OAAO,eAAe,CAAA;IACxB,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAY,CAAC,KAAK,EAAE,CAAC;QACrC,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAY,CAAC,IAAI,EAAE,CAAC;QACpC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,KAAK,6BAA6B;gBAChC,OAAO,cAAc,CAAA;YACvB,KAAK,2BAA2B;gBAC9B,OAAO,aAAa,CAAA;YACtB;gBACE,OAAO,sBAAsB,CAAA;QACjC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAA;AAClB,CAAC,CAAA;AAEM,MAAM,gBAAgB,GAAG,GAAG,EAAE;IACnC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAA,kBAAU,GAAE,CAAA;IACnC,MAAM,kBAAkB,GAAG,IAAA,cAAM,EAAmD,IAAI,CAAC,CAAA;IACzF,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,IAAA,gBAAQ,EAA2B,IAAI,CAAC,CAAA;IAE1F,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAE,SAAiB,CAAC,YAAY,CAAC,CAAA;IACxF,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAE,SAAiB,CAAC,YAA4B,CAAC,CAAA;IAEtG,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,0CAA0C;YAC1C,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CACzC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;gBAC/C,kBAAkB,CAAC,OAAO,GAAG,WAAW,CAAA;gBACxC,oBAAoB,CAAC,IAAI,CAAC,CAAA;gBAC1B,WAAW,CAAC,IAAI,CAAC,CAAA;YACnB,CAAC,CAAC,CACH,CAAA;YAED,sDAAsD;YACtD,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAA;YAC3C,CAAC,CAAA;QACH,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO;QACL,wBAAwB,EAAE,WAAW;QACrC,mBAAmB,EAAE,MAAM;QAC3B,iBAAiB,EAAE;YACjB,KAAK,EAAE,iBAAiB,EAAE,KAAK,IAAI,SAAS;YAC5C,IAAI,EAAE,eAAe,CAAC,iBAAiB,CAAC;SACX;QAC/B,WAAW,EAAE,KAAK,IAAI,EAAE;YACtB,OAAO,kBAAkB,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAA;QAC3C,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAtCY,QAAA,gBAAgB,oBAsC5B"}
+{"version":3,"file":"useWaasEmailConflict.js","sourceRoot":"","sources":["../../../src/hooks/useWaasEmailConflict.ts"],"names":[],"mappings":";;;AAAA,2CAAgF;AAChF,iCAAmD;AACnD,iCAAkC;AAalC;;;;;GAKG;AACH,MAAM,eAAe,GAAG,CAAC,IAA8B,EAAE,EAAE;IACzD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,sBAAsB,CAAA;IAC/B,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAY,CAAC,OAAO,EAAE,CAAC;QACvC,OAAO,eAAe,CAAA;IACxB,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAY,CAAC,KAAK,EAAE,CAAC;QACrC,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAY,CAAC,IAAI,EAAE,CAAC;QACpC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,KAAK,6BAA6B;gBAChC,OAAO,cAAc,CAAA;YACvB,KAAK,2BAA2B;gBAC9B,OAAO,aAAa,CAAA;YACtB;gBACE,OAAO,sBAAsB,CAAA;QACjC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAA;AAClB,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACI,MAAM,gBAAgB,GAAG,GAAG,EAAE;IACnC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAA,kBAAU,GAAE,CAAA;IACnC,MAAM,kBAAkB,GAAG,IAAA,cAAM,EAAmD,IAAI,CAAC,CAAA;IACzF,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,IAAA,gBAAQ,EAA2B,IAAI,CAAC,CAAA;IAE1F,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAE,SAAiB,CAAC,YAAY,CAAC,CAAA;IACxF,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAE,SAAiB,CAAC,YAA4B,CAAC,CAAA;IAEtG,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,0CAA0C;YAC1C,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CACzC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;gBAC/C,kBAAkB,CAAC,OAAO,GAAG,WAAW,CAAA;gBACxC,oBAAoB,CAAC,IAAI,CAAC,CAAA;gBAC1B,WAAW,CAAC,IAAI,CAAC,CAAA;YACnB,CAAC,CAAC,CACH,CAAA;YAED,sDAAsD;YACtD,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAA;YAC3C,CAAC,CAAA;QACH,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO;QACL,wBAAwB,EAAE,WAAW;QACrC,mBAAmB,EAAE,MAAM;QAC3B,iBAAiB,EAAE;YACjB,KAAK,EAAE,iBAAiB,EAAE,KAAK,IAAI,SAAS;YAC5C,IAAI,EAAE,eAAe,CAAC,iBAAiB,CAAC;SACX;QAC/B,WAAW,EAAE,KAAK,IAAI,EAAE;YACtB,OAAO,kBAAkB,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAA;QAC3C,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAtCY,QAAA,gBAAgB,oBAsC5B"}

package/dist/cjs/hooks/useWaasGetLinkedWalletsSignature.d.ts

@@ -1,13 +1,73 @@
 import { Address } from 'viem';
 import { Connector } from 'wagmi';
+/**
+ * Result object returned by the useWaasGetLinkedWalletsSignature hook.
+ * Contains all necessary information about the signature for wallet linking.
+ */
 interface UseWaasSignatureForLinkingResult {
+    /** The message that was signed */
     message: string | undefined;
+    /** The signature of the message */
     signature: string | undefined;
+    /** The address that signed the message */
     address: string | undefined;
+    /** The chain ID used for signing */
     chainId: number;
+    /** Whether the signature is currently being generated */
     loading: boolean;
+    /** Any error that occurred during signature generation */
     error: Error | null;
 }
+/**
+ * Hook to manage signatures required for linking wallets in a WaaS (Wallet-as-a-Service) context.
+ *
+ * This hook handles the generation and caching of signatures that are used to prove ownership
+ * of a parent wallet when linking child wallets. The signatures are cached in localStorage
+ * for 24 hours to avoid unnecessary re-signing.
+ *
+ * Features:
+ * - Automatic signature generation when needed
+ * - 24-hour signature caching in localStorage
+ * - Automatic cleanup of old signatures
+ * - Error handling for signature generation
+ *
+ * @param connection - The current wallet connection object containing:
+ *   - accounts: Array of connected addresses (uses the first one)
+ *   - chainId: The current chain ID
+ *   - connector: The wallet connector instance
+ *
+ * @returns An object containing:
+ * - `message` - The message that was signed
+ * - `signature` - The generated signature
+ * - `address` - The address that signed the message
+ * - `chainId` - The chain ID used for signing
+ * - `loading` - Whether signature generation is in progress
+ * - `error` - Any error that occurred during the process
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   message,
+ *   signature,
+ *   address,
+ *   loading,
+ *   error
+ * } = useWaasGetLinkedWalletsSignature(waasConnection)
+ *
+ * if (loading) {
+ *   return <div>Generating signature...</div>
+ * }
+ *
+ * if (error) {
+ *   return <div>Error: {error.message}</div>
+ * }
+ *
+ * if (signature) {
+ *   // Use the signature for wallet linking
+ *   console.log(`Got signature from ${address} for message: ${message}`)
+ * }
+ * ```
+ */
 export declare const useWaasGetLinkedWalletsSignature: (connection: {
     accounts: readonly [Address, ...Address[]];
     chainId: number;

package/dist/cjs/hooks/useWaasGetLinkedWalletsSignature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWaasGetLinkedWalletsSignature.d.ts","sourceRoot":"","sources":["../../../src/hooks/useWaasGetLinkedWalletsSignature.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAIjC,UAAU,gCAAgC;IACxC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAKD,eAAO,MAAM,gCAAgC,GAC3C,YACI;IACE,QAAQ,EAAE,SAAS,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,SAAS,CAAA;CACrB,GACD,SAAS,KACZ,gCAwIF,CAAA"}
+{"version":3,"file":"useWaasGetLinkedWalletsSignature.d.ts","sourceRoot":"","sources":["../../../src/hooks/useWaasGetLinkedWalletsSignature.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAIjC;;;GAGG;AACH,UAAU,gCAAgC;IACxC,kCAAkC;IAClC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,mCAAmC;IACnC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAA;IAChB,0DAA0D;IAC1D,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,gCAAgC,GAC3C,YACI;IACE,QAAQ,EAAE,SAAS,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,SAAS,CAAA;CACrB,GACD,SAAS,KACZ,gCAwIF,CAAA"}