@payvia-sdk/sdk 1.1.4 → 1.2.0

package/README.md

@@ -23,7 +23,7 @@ Copy `payvia.js` into your extension folder.
 ### Option 2: npm
 
 ```bash
-npm install payvia-sdk
+npm install @payvia-sdk/sdk
 ```
 
 ## Basic Usage

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@payvia-sdk/sdk",
-  "version": "1.1.4",
-  "description": "A lightweight JavaScript SDK for connecting your Chrome Extension / SaaS app to PayVia, for accepting PayPal payments and managing subscriptions, license validation, tier-based feature gating, trial management and monthly / yearly / lifetime plans",
+  "version": "1.2.0",
+  "description": "A lightweight JavaScript SDK for connecting your Chrome Extension / SaaS app to PayVia, for accepting PayPal and Tranzila payments and managing subscriptions, license validation, tier-based feature gating, trial management and monthly / yearly / lifetime plans",
   "main": "payvia.js",
   "type": "module",
   "exports": {

package/payvia.js

@@ -276,6 +276,8 @@ function PayVia(apiKey) {
                     isTrial: response.isTrial || false,
                     trialExpiresAt: response.trialExpiresAt || null,
                     daysRemaining: response.daysRemaining || null,
+                    canceledAt: response.canceledAt || null,
+                    currentPeriodEnd: response.currentPeriodEnd || null,
                     checkedAt: response.checkedAt || Date.now(),
                     ttl: response.ttl || DEFAULT_TTL_MS,
                     signature: response.signature || null,
@@ -322,6 +324,11 @@ function PayVia(apiKey) {
      * Build user object from cache data
      */
     function buildUserFromCache(identity, cache, fromCache) {
+        const canceledAt = cache.canceledAt ? new Date(cache.canceledAt) : null;
+        const currentPeriodEnd = cache.currentPeriodEnd ? new Date(cache.currentPeriodEnd) : null;
+        const isCanceled = !!canceledAt;
+        const cancelGraceActive = isCanceled && currentPeriodEnd && currentPeriodEnd > new Date();
+
         return {
             id: identity.id,
             email: identity.email,
@@ -334,6 +341,10 @@ function PayVia(apiKey) {
             isTrial: cache.isTrial || false,
             trialExpiresAt: cache.trialExpiresAt ? new Date(cache.trialExpiresAt) : null,
             daysRemaining: cache.daysRemaining || null,
+            canceledAt: canceledAt,
+            currentPeriodEnd: currentPeriodEnd,
+            isCanceled: isCanceled,
+            cancelGraceActive: cancelGraceActive,
             fromCache: fromCache,
             checkedAt: cache.checkedAt || null,
             ttl: cache.ttl || null,
@@ -525,15 +536,12 @@ function PayVia(apiKey) {
 
         if (mode === 'pricing') {
             // Pricing mode: Get secure token, show all plans
-            if (!customerEmail) {
-                throw new Error('Email is required for payment. Please provide an email address.');
-            }
-
+            // Email is optional — PayPal will collect it during checkout for anon users
             const tokenResponse = await apiRequest('/api/v1/checkout/token', {
                 method: 'POST',
                 body: JSON.stringify({
                     customerId: identity.id,
-                    customerEmail: customerEmail,
+                    customerEmail: customerEmail || undefined,
                     mode: 'pricing',
                 }),
             });
@@ -552,15 +560,12 @@ function PayVia(apiKey) {
             if (!options.planId) {
                 throw new Error('planId is required for hosted mode');
             }
-            if (!customerEmail) {
-                throw new Error('Email is required for payment. Please provide an email address.');
-            }
-
+            // Email is optional — PayPal will collect it during checkout for anon users
             const tokenResponse = await apiRequest('/api/v1/checkout/token', {
                 method: 'POST',
                 body: JSON.stringify({
                     customerId: identity.id,
-                    customerEmail: customerEmail,
+                    customerEmail: customerEmail || undefined,
                     planId: options.planId,
                     mode: 'checkout',
                 }),
@@ -576,7 +581,7 @@ function PayVia(apiKey) {
 
             return { mode: 'hosted', checkoutUrl };
         } else {
-            // Direct mode: Call API and redirect straight to PayPal (original behavior)
+            // Direct mode: Call API and redirect to payment provider
             if (!options.planId) {
                 throw new Error('planId is required for direct mode');
             }
@@ -587,13 +592,15 @@ function PayVia(apiKey) {
                     body: JSON.stringify({
                         planId: options.planId,
                         customerId: identity.id,
-                        customerEmail: customerEmail || '',
+                        customerEmail: customerEmail || undefined,
                         successUrl: options.successUrl || 'https://payvia.site/success',
                         cancelUrl: options.cancelUrl || 'https://payvia.site/cancel',
                     }),
                 });
 
-                // Open PayPal checkout in new tab
+                // Open checkout URL in new tab
+                // For Tranzila iframe mode, the URL is the iframe source — opening it
+                // directly in a new tab works fine (Tranzila renders as a full page too)
                 if (response.checkoutUrl) {
                     if (typeof chrome !== 'undefined' && chrome.tabs) {
                         chrome.tabs.create({ url: response.checkoutUrl });
@@ -602,6 +609,7 @@ function PayVia(apiKey) {
                     }
                 }
 
+                // response includes: checkoutUrl, sessionId, provider ("PayPal"|"Tranzila"), mode (null|"iframe"|"redirect")
                 return response;
             } catch (error) {
                 console.error('PayVia: Failed to open payment page', error);