@moneybar.online/moneybar 9.1.1 → 9.1.3

package/README.md

@@ -144,17 +144,49 @@ window.moneyBar.attachToButton('#my-btn', (userContext) => {
   // User info
   userContext.email              // String - User's email (if signed in)
   userContext.name               // String - User's name (if available)
-
-  // Subscription details (for premium users)
-  userContext.subscriptionType          // 'one-time', 'monthly', 'quarterly', 'yearly'
-  userContext.subscriptionExpiresAt     // ISO date string
-  userContext.subscriptionDaysRemaining // Number - Days until subscription expires
-  userContext.isSubscriptionActive      // true/false - Is subscription active?
+  userContext.user               // Object - Full Supabase user object
+
+  // Subscription details (only for subscription users)
+  userContext.subscriptionType          // 'monthly', 'quarterly', 'yearly'
+  userContext.subscriptionId            // String - Subscription ID
+  userContext.subscriptionExpiresAt     // ISO date string - When subscription expires
+  userContext.subscriptionDaysRemaining // Number - Days until expiry
+  userContext.isSubscriptionActive      // true/false - Active or cancelled
+  userContext.nextBillingDate           // ISO date string - Next billing date
+  userContext.billingFrequency          // String - 'monthly', 'quarterly', etc.
   userContext.customerId                // String - Customer ID for portal access
 
 });
 ```
 
+### UserContext for Different Payment Types
+
+**One-Time Payment:**
+```javascript
+{
+  isPremium: true,
+  subscriptionType: 'one-time',  // Indicates one-time payment
+  // No subscription fields (expiresAt, nextBillingDate, etc.)
+}
+```
+
+**Subscription Payment:**
+```javascript
+{
+  isPremium: true,
+  subscriptionType: 'monthly',            // or 'quarterly', 'yearly'
+  subscriptionId: 'sub_xxx',
+  subscriptionExpiresAt: '2026-02-06',
+  subscriptionDaysRemaining: 31,
+  isSubscriptionActive: true,             // false if cancelled
+  nextBillingDate: '2026-02-06',
+  billingFrequency: 'monthly',
+  customerId: 'cus_xxx'                   // For customer portal
+}
+```
+
+**Note:** Payment amounts, transaction IDs, and billing details are available in your Dodo Payments dashboard.
+
 ---
 
 ## Common Patterns
@@ -219,6 +251,141 @@ window.moneyBar.attachToButton('#convert-btn', (ctx) => {
 
 ---
 
+## Integrating Your Existing Functions
+
+MoneyBar works with your existing functions. Here's how to integrate them properly:
+
+### Basic Integration
+
+```javascript
+// Your existing function
+async function generatePDF(userId, template) {
+  const response = await fetch('/api/generate-pdf', {
+    method: 'POST',
+    body: JSON.stringify({ userId, template })
+  });
+
+  if (!response.ok) {
+    throw new Error('PDF generation failed');
+  }
+
+  return await response.json();
+}
+
+// Integrate with MoneyBar
+window.moneyBar.attachToButton('#generate-pdf-btn', async (userContext) => {
+
+  if (userContext.isPremium) {
+    // Premium: Unlimited access
+    try {
+      const result = await generatePDF(userContext.email, 'premium-template');
+      alert('✅ PDF generated successfully!');
+    } catch (error) {
+      alert('❌ Error: ' + error.message);
+      throw error; // Re-throw to prevent count increment
+    }
+
+  } else {
+    // Free: Limited attempts
+    try {
+      const result = await generatePDF(userContext.email, 'basic-template');
+      const remaining = userContext.remaining - 1;
+      alert(`✅ PDF generated! ${remaining} attempts remaining.`);
+    } catch (error) {
+      alert(`❌ Error: ${error.message}\n\nYou still have ${userContext.remaining} attempts.`);
+      throw error; // Re-throw to prevent count increment
+    }
+  }
+});
+```
+
+### How Success/Error Handling Works
+
+**Critical: Count increments ONLY if your function succeeds**
+
+```javascript
+window.moneyBar.attachToButton('#my-btn', async (userContext) => {
+
+  try {
+    // Your async function runs FIRST
+    await yourCustomFunction();
+
+    // ✅ SUCCESS PATH:
+    // - Function completed without error
+    // - MoneyBar increments count AFTER this
+    // - User consumed 1 attempt
+
+  } catch (error) {
+    // ❌ ERROR PATH:
+    // - Function threw an error
+    // - Re-throw the error to prevent count increment
+    // - User does NOT consume an attempt
+
+    console.error('Function failed:', error);
+    throw error; // IMPORTANT: Re-throw to prevent count increment
+  }
+});
+```
+
+### Real-World Example: API Call with Error Handling
+
+```javascript
+// Your existing API function
+async function processImage(imageUrl, format) {
+  const response = await fetch('https://api.yourapp.com/process', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ imageUrl, format })
+  });
+
+  if (!response.ok) {
+    const error = await response.json();
+    throw new Error(error.message || 'Processing failed');
+  }
+
+  return await response.json();
+}
+
+// Integrate with MoneyBar
+window.moneyBar.attachToButton('#process-image-btn', async (userContext) => {
+
+  const imageUrl = document.getElementById('image-url').value;
+  const format = userContext.isPremium ? 'high-quality' : 'standard';
+
+  try {
+    const result = await processImage(imageUrl, format);
+
+    // Success
+    if (userContext.isPremium) {
+      alert('✅ Image processed in high quality!');
+    } else {
+      const remaining = userContext.remaining - 1;
+      alert(`✅ Image processed! ${remaining} attempts remaining.`);
+    }
+
+  } catch (error) {
+    // Error - API failed, network issue, etc.
+    if (userContext.isPremium) {
+      alert('❌ Processing failed: ' + error.message);
+    } else {
+      alert(`❌ Processing failed: ${error.message}\n\nNo attempt used. You still have ${userContext.remaining} attempts.`);
+    }
+
+    throw error; // Re-throw to prevent count increment
+  }
+});
+```
+
+### Key Points
+
+1. **Async Functions**: MoneyBar automatically waits for async functions to complete
+2. **Error Handling**: If your function throws an error, count does NOT increment
+3. **Re-throw Errors**: Always `throw error;` in catch blocks to prevent count increment
+4. **Success/Error Feedback**: Show different messages based on outcome and user type
+5. **userContext.isPremium**: Use this to provide different features/quality for premium users
+
+---
+
 ## What MoneyBar Handles Automatically
 
 ✅ **Authentication** - Google sign-in (more providers coming)
@@ -248,18 +415,13 @@ window.moneyBar.attachToButton('#convert-btn', (ctx) => {
 
 ## Getting Your Security Key
 
-Run this SQL in Supabase SQL Editor:
+**MoneyBar is currently in private beta.**
 
-```sql
-SELECT generate_security_key(
-  'my-app-name',           -- Your app identifier
-  'yourdomain.com',        -- Your domain
-  'your@email.com',        -- Your email
-  3                        -- Free attempt limit
-);
-```
+To get a security key for beta testing, please contact the authors:
+- **Email**: ravi@cloudworks.com
+- **GitHub**: [Open an issue](https://github.com/ravi-cloudworks/moneybar/issues)
 
-Copy the returned `sk_...` key into your config.
+We'll provide you with a security key and help you get set up!
 
 ---
 

package/example-template.html

@@ -94,52 +94,54 @@
     window.moneyBar.attachToButton('#my-custom-btn', async (userContext) => {
 
       // ⚠️ TOGGLE THIS TO TEST ERROR SCENARIO
-      const TEST_ERROR = true; // Set to true to test error handling
+      const TEST_ERROR = false ; // Set to true to test error handling
 
       console.log('📊 UserContext:', userContext);
 
       if (userContext.isPremium) {
-        alert('Premium user! Calling custom function...');
-
+        // Premium user - unlimited access
         try {
           // Call your custom function
           const result = await customX(TEST_ERROR);
           console.log('✅ Success:', result);
-          alert('Success: ' + JSON.stringify(result));
+          alert('✅ Success! (Premium - unlimited access)');
 
-          // ✅ If we reach here: count WILL be incremented
+          // ✅ If we reach here: count WILL be incremented (but premium has no limits)
 
         } catch (error) {
           // ❌ If error thrown: count will NOT be incremented
           console.error('❌ Custom function error:', error.message);
-          alert('❌ Error: ' + error.message + '\n\nCount NOT incremented!');
+          alert('❌ Error: ' + error.message + '\n\n(Premium - no attempt counted)');
 
           // Re-throw to prevent count increment
           throw error;
         }
 
       } else {
-        alert(`Free user. ${userContext.remaining} attempts remaining`);
-
+        // Free user - limited attempts
         try {
           // Call your custom function
           const result = await customX(TEST_ERROR);
           console.log('✅ Success:', result);
-          alert('Success: ' + JSON.stringify(result));
+
+          // Success - show NEW remaining count (after this action)
+          const newRemaining = userContext.remaining - 1;
+          alert(`✅ Success!\n\nYou have ${newRemaining} attempts remaining.`);
 
           // ✅ If we reach here: count WILL be incremented
 
         } catch (error) {
           // ❌ If error thrown: count will NOT be incremented
           console.error('❌ Error:', error.message);
-          alert('❌ Error: ' + error.message + '\n\nCount NOT incremented!');
+
+          // Error - show UNCHANGED remaining count (action failed, no count used)
+          alert(`❌ Error: ${error.message}\n\nYou still have ${userContext.remaining} attempts remaining.`);
 
           // Re-throw to prevent count increment
           throw error;
         }
       }
     });
-
     // ========================================
     // HOW TO TEST:
     // ========================================

package/moneybar-config-template.js

@@ -8,7 +8,7 @@
 
 // Self-contained bundle (works without import map)
 // Use specific version to avoid CDN cache issues
-import { MoneyBar } from 'https://cdn.jsdelivr.net/npm/@moneybar.online/moneybar@9.1.0/dist/index.bundle.js';
+import { MoneyBar } from 'https://cdn.jsdelivr.net/npm/@moneybar.online/moneybar@9.1.2/dist/index.bundle.js';
 
 // For NPM projects:
 // import { MoneyBar } from '@moneybar.online/moneybar';
@@ -72,11 +72,11 @@ const CONFIG = {
   },
 
   // Success message after action (optional)
-  successMessage: {
-    enabled: true,
-    title: 'Success!',
-    message: 'Your action completed successfully.'
-  },
+  // successMessage: {
+  //   enabled: true,
+  //   title: 'Success!',
+  //   message: 'Your action completed successfully.'
+  // },
 
   // ========================================
   // ⚠️ DO NOT MODIFY - REQUIRED CONFIGURATION

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moneybar.online/moneybar",
-  "version": "9.1.1",
+  "version": "9.1.3",
   "description": "The navbar of monetization. Fix the 3 money-blocking stages: forced sign-ins, silent drop-offs, and broken payment flows. Turn browsers into buyers.",
   "main": "dist/index.esm.js",
   "module": "dist/index.esm.js",