@connect-xyz/withdraw-js 0.35.0 → 0.36.0

package/README.md

@@ -68,6 +68,9 @@ const withdraw = new Withdraw({
   onEvent: ({ type, data }) => {
     console.log('Event received:', type, data);
   },
+  onLoaded: () => {
+    console.log('Withdraw widget loaded and ready');
+  },
 });
 
 // Render the widget to a container element
@@ -101,6 +104,7 @@ withdraw.destroy();
 | `onClose`      | `() => void`                      | No       | -              | Callback when the widget is closed                 |
 | `onWithdrawal` | `({ data }) => void`              | No       | -              | Callback for withdrawal completed                  |
 | `onEvent`      | `({ type, data }) => void`        | No       | -              | Callback for general events                        |
+| `onLoaded`     | `() => void`                      | No       | -              | Callback when the widget is loaded and ready       |
 
 ### Constructor
 
@@ -119,6 +123,7 @@ Creates a new Withdraw instance with the provided configuration.
   - `onClose` (function, optional): Close callback
   - `onWithdrawal` (function, optional): Withdrawal callback
   - `onEvent` (function, optional): General event callback
+  - `onLoaded` (function, optional): Callback when widget is loaded and ready
 
 ### Methods
 
@@ -214,6 +219,16 @@ onEvent: ({ type, data }) => {
 };
 ```
 
+### onLoaded
+
+Called when the Withdraw widget has fully loaded and is ready for user interaction. This callback is useful for showing loading states or performing actions once the widget is initialized.
+
+```javascript
+onLoaded: () => {
+  // Widget is fully loaded and ready
+};
+```
+
 ## Browser Support
 
 - Chrome/Edge 90+

package/dist/index.d.ts

@@ -317,6 +317,8 @@ declare type CommonCallbacks<TEvent = AppEvent> = {
     onClose?: () => void;
     /** Called when a general event occurs */
     onEvent?: (event: TEvent) => void;
+    /** Called when the widget has loaded and is ready */
+    onLoaded?: () => void;
 };
 
 export declare type ConnectWithdrawElement = SdkElement<WithdrawConfig>;
@@ -396,7 +398,8 @@ declare type Theme = 'auto' | 'light' | 'dark';
  *   onError: ({ error, reason }) => console.error(error, reason),
  *   onClose: () => console.log('Withdraw closed'),
  *   onWithdrawal: ({ data }) => console.log('Withdrawal', data),
- *   onEvent: ({ type, data }) => console.log('Event', type, data)
+ *   onEvent: ({ type, data }) => console.log('Event', type, data),
+ *   onLoaded: () => console.log('Withdraw widget loaded and ready')
  * });
  *
  * // Render to a container

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@connect-xyz/withdraw-js",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",