@lavapayments/checkout 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,96 @@
+# Lava Checkout
+
+A React package that provides hooks for integrating Lava's wallet-based checkout experience into your AI application.
+
+## Installation
+
+```bash
+npm install --save @lavapayments/checkout
+# or
+yarn add @lavapayments/checkout
+```
+
+## Usage
+
+### Basic Implementation
+
+```jsx
+import { useLavaCheckout } from '@lavapayments/checkout';
+import { useState } from 'react';
+
+function CheckoutButton() {
+  const [connectionId, setConnectionId] = useState(null);
+  
+  const { open } = useLavaCheckout({
+    onSuccess: ({ connectionId }) => {
+      console.log('Checkout successful!');
+      setConnectionId(connectionId);
+      // Store the connectionId for your application
+      saveConnectionIdToDatabase(userId, connectionId);
+    },
+    onCancel: ({ checkoutSessionId }) => {
+      console.log('Checkout cancelled:', checkoutSessionId);
+    }
+  });
+
+  return (
+    <button
+      onClick={() => {
+        // Request a checkout session token from your backend
+        fetch('/api/create-checkout-session')
+          .then(res => res.json())
+          .then(data => {
+            // Open the checkout modal with the session token
+            open(data.checkout_session_token);
+          });
+      }}
+    >
+      Connect Wallet
+    </button>
+  );
+}
+```
+
+### Top-up Implementation
+
+To allow users to add funds to an existing wallet:
+
+```jsx
+import { useLavaCheckout } from '@lavapayments/checkout';
+
+function TopUpButton({ connectionId }) {
+  const { open } = useLavaCheckout({
+    onSuccess: () => {
+      console.log('Top-up successful!');
+      // Refresh balance display
+    },
+    onCancel: () => {
+      console.log('Top-up cancelled');
+    }
+  });
+
+  return (
+    <button
+      onClick={() => {
+        // Request a top-up checkout session token from your backend
+        fetch('/api/create-topup-session', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ connectionId })
+        })
+          .then(res => res.json())
+          .then(data => {
+            // Open the checkout modal with the session token
+            open(data.checkout_session_token);
+          });
+      }}
+    >
+      Add Funds
+    </button>
+  );
+}
+```
+
+## Related Documentation
+
+For complete documentation on Lava's usage-based billing system and backend integration, visit [lavapayments.com](https://www.lavapayments.com).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lavapayments/checkout",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "private": false,
   "description": "Lava Checkout",
   "main": "dist/index.js",
@@ -25,8 +25,8 @@
   "author": "Lava",
   "license": "MIT",
   "peerDependencies": {
-    "react": "^16.8.0 || ^17.0.0 || ^18.0.0",
-    "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0"
+    "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+    "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",