@tagadapay/plugin-sdk 2.6.0 → 2.6.4

package/dist/react/types.d.ts

@@ -150,3 +150,112 @@ export interface Order {
     };
     relatedOrders?: Order[];
 }
+export interface PaymentSummary {
+    id: string;
+    status: string;
+    amount: number;
+    currency: string;
+    createdAt: string;
+    updatedAt?: string;
+    provider?: string;
+    metadata?: Record<string, any>;
+}
+export interface PromotionSummary {
+    id: string;
+    code?: string | null;
+    type?: string;
+    amount?: number;
+    description?: string | null;
+}
+export interface OrderAdjustmentSummary {
+    type: string;
+    amount: number;
+    description: string;
+}
+export interface OrderWithRelations extends Order {
+    customer?: Customer;
+    store?: Store;
+    account?: {
+        id: string;
+        name?: string;
+    } | undefined;
+    items: OrderItem[];
+    payments?: PaymentSummary[];
+    summaries: OrderSummary[];
+    checkoutSession?: {
+        id?: string;
+        returnUrl?: string;
+        [key: string]: any;
+    };
+    promotions?: PromotionSummary[];
+    subscriptions?: any[];
+    adjustments: OrderAdjustmentSummary[];
+}
+export interface CustomerAddress {
+    company?: string;
+    firstName: string;
+    lastName: string;
+    address1: string;
+    city: string;
+    country: string;
+    state: string;
+    postal: string;
+    phone?: string;
+    email?: string;
+}
+export interface CustomerOrderSummary {
+    id: string;
+    storeId: string;
+    accountId: string;
+    createdAt: string;
+    updatedAt: string;
+    status: string;
+    cancelledAt: string | null;
+    cancelledReason: string | null;
+    paidAt: string | null;
+    paidAmount: number | null;
+    openAt: string | null;
+    abandonedAt: string | null;
+    currency: string;
+    externalCustomerType: string | null;
+    externalCustomerId: string | null;
+    externalOrderId: string | null;
+    billingAddress: CustomerAddress;
+    shippingAddress: Omit<CustomerAddress, 'email'>;
+    pickupAddress: any | null;
+    taxesIncluded: boolean;
+    draft: boolean;
+    checkoutSessionId: string | null;
+    sessionHash: string | null;
+    customerId: string;
+    createdFrom: string | null;
+    paymentInstrumentId: string | null;
+    refundedAt: string | null;
+    refundedAmount: number | null;
+    metadata?: Record<string, any>;
+}
+export interface CustomerInfos {
+    customer: {
+        id: string;
+        email: string | null;
+        firstName: string | null;
+        lastName: string | null;
+        externalCustomerId: string | null;
+        lastOrderId: string | null;
+        accountId: string;
+        storeId: string;
+        billingAddress: CustomerAddress | null;
+        shippingAddress: Omit<CustomerAddress, 'email'> | null;
+        currency: string | null;
+        locale: string | null;
+        draft: boolean;
+        acceptsMarketing: boolean;
+        createdAt: string;
+        updatedAt: string;
+        metadata: Record<string, any>;
+        device: any | null;
+        orders: CustomerOrderSummary[];
+        subscriptions: any[];
+    };
+    promotionCodes: any[];
+}

package/dist/react/utils/tokenStorage.js

@@ -10,6 +10,7 @@ export function setClientToken(token) {
     if (typeof window !== 'undefined') {
         try {
             localStorage.setItem(TOKEN_KEY, token);
+            window.dispatchEvent(new Event('storage'));
         }
         catch (error) {
             console.error('Failed to save token to localStorage:', error);

package/dist/v2/core/googleAutocomplete.js

@@ -8,7 +8,7 @@ export class GoogleAutocompleteCore {
      */
     static initialize(apiKey) {
         this.apiKey = apiKey;
-        if (typeof window !== 'undefined' && window.google) {
+        if (typeof window !== 'undefined' && window.google?.maps?.places) {
             this.service = new window.google.maps.places.AutocompleteService();
         }
     }
@@ -25,7 +25,10 @@ export class GoogleAutocompleteCore {
                 types: options.types || ['address'],
                 componentRestrictions: options.componentRestrictions,
             }, (predictions, status) => {
-                if (status === window.google.maps.places.PlacesServiceStatus.OK && predictions) {
+                if (typeof window !== 'undefined' &&
+                    window.google?.maps?.places &&
+                    status === window.google.maps.places.PlacesServiceStatus.OK &&
+                    predictions) {
                     resolve(predictions);
                 }
                 else {
@@ -38,7 +41,7 @@ export class GoogleAutocompleteCore {
      * Get place details
      */
     static async getPlaceDetails(placeId) {
-        if (typeof window === 'undefined' || !window.google) {
+        if (typeof window === 'undefined' || !window.google?.maps?.places) {
             return null;
         }
         return new Promise((resolve, reject) => {
@@ -47,7 +50,10 @@ export class GoogleAutocompleteCore {
                 placeId,
                 fields: ['place_id', 'formatted_address', 'address_components', 'geometry'],
             }, (place, status) => {
-                if (status === window.google.maps.places.PlacesServiceStatus.OK && place) {
+                if (typeof window !== 'undefined' &&
+                    window.google?.maps?.places &&
+                    status === window.google.maps.places.PlacesServiceStatus.OK &&
+                    place) {
                     resolve(place);
                 }
                 else {

package/dist/v2/core/resources/checkout.d.ts

@@ -20,6 +20,7 @@ export interface CheckoutInitParams {
     customerMetadata?: Record<string, unknown>;
     metadata?: Record<string, unknown>;
     storeId?: string;
+    customerId?: string;
     customer?: {
         currency?: string;
         locale?: string;

package/dist/v2/core/resources/checkout.js

@@ -10,6 +10,7 @@ export class CheckoutResource {
      * Initialize a new checkout session
      */
     async initCheckout(params) {
+        // Pass all params including customerId to prevent duplicate customer creation
         return this.apiClient.post('/api/v1/checkout/session/init', params);
     }
     /**

package/dist/v2/react/hooks/useCheckoutQuery.d.ts

@@ -19,6 +19,7 @@ export interface UseCheckoutQueryResult {
     }>;
     refresh: () => Promise<void>;
     updateLineItems: (lineItems: CheckoutLineItem[]) => Promise<any>;
+    updateLineItemsOptimistic: (lineItems: CheckoutLineItem[]) => void;
     setItemQuantity: (variantId: string, quantity: number, priceId?: string) => Promise<any>;
     updateCustomer: (data: {
         email: string;

package/dist/v2/react/hooks/useCheckoutQuery.js

@@ -2,7 +2,7 @@
  * Checkout Hook using TanStack Query
  * Replaces the coordinator pattern with automatic cache invalidation
  */
-import { useCallback, useState, useEffect, useMemo } from 'react';
+import { useCallback, useState, useEffect, useMemo, useRef } from 'react';
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
 import { CheckoutResource } from '../../core/resources/checkout';
 import { useTagadaContext } from '../providers/TagadaProvider';
@@ -14,7 +14,46 @@ export function useCheckoutQuery(options = {}) {
     const { storeId } = usePluginConfig();
     const currency = useCurrency();
     const queryClient = useQueryClient();
-    const { isSessionInitialized } = useTagadaContext();
+    const { isSessionInitialized, session } = useTagadaContext();
+    // Track pending session promises to avoid creating multiple promises
+    const pendingSessionPromise = useRef(null);
+    const sessionResolvers = useRef(new Set());
+    // Resolve all pending promises when session becomes ready
+    useEffect(() => {
+        if (isSessionInitialized && sessionResolvers.current.size > 0) {
+            console.log('✅ [useCheckout] CMS session ready, resolving pending promises');
+            sessionResolvers.current.forEach(resolve => resolve());
+            sessionResolvers.current.clear();
+            pendingSessionPromise.current = null;
+        }
+    }, [isSessionInitialized]);
+    // Clean, event-driven session waiting - no polling needed
+    const waitForSession = useCallback(async () => {
+        if (isSessionInitialized) {
+            return Promise.resolve();
+        }
+        // Reuse existing promise if one is pending
+        if (pendingSessionPromise.current) {
+            return pendingSessionPromise.current;
+        }
+        console.log('⏳ [useCheckout] Waiting for CMS session to be initialized...');
+        // Create new promise that will be resolved by useEffect above
+        pendingSessionPromise.current = new Promise((resolve, reject) => {
+            // Add resolver to set for useEffect to call
+            sessionResolvers.current.add(resolve);
+            // Safety timeout
+            setTimeout(() => {
+                if (sessionResolvers.current.has(resolve)) {
+                    sessionResolvers.current.delete(resolve);
+                    if (sessionResolvers.current.size === 0) {
+                        pendingSessionPromise.current = null;
+                    }
+                    reject(new Error('Session initialization timeout. Please refresh the page and try again.'));
+                }
+            }, 10000);
+        });
+        return pendingSessionPromise.current;
+    }, [isSessionInitialized]);
     // Create checkout resource client
     const checkoutResource = useMemo(() => {
         try {
@@ -55,6 +94,8 @@ export function useCheckoutQuery(options = {}) {
                 ...params,
                 storeId: params.storeId || storeId,
                 returnUrl: params.returnUrl || window.location.origin,
+                // Include customerId from session to prevent duplicate customer creation
+                customerId: params.customerId || session?.customerId,
                 customer: {
                     ...params.customer,
                     currency: params.customer?.currency ?? currency.code,
@@ -75,7 +116,7 @@ export function useCheckoutQuery(options = {}) {
         },
     });
     // Order bump functionality removed - use useOrderBumpQuery instead
-    // Line items mutation
+    // Line items mutation with optimistic updates
     const lineItemsMutation = useMutation({
         mutationFn: ({ lineItems }) => {
             if (!checkout?.checkoutSession?.id) {
@@ -83,7 +124,38 @@ export function useCheckoutQuery(options = {}) {
             }
             return checkoutResource.updateLineItems(checkout.checkoutSession.id, lineItems);
         },
-        onSuccess: () => {
+        onMutate: async ({ lineItems }) => {
+            // Cancel any outgoing refetches (so they don't overwrite our optimistic update)
+            await queryClient.cancelQueries({ queryKey: ['checkout', checkoutToken] });
+            // Snapshot the previous value
+            const previousCheckout = queryClient.getQueryData(['checkout', checkoutToken]);
+            // Optimistically update the checkout data
+            if (previousCheckout && checkout?.checkoutSession?.id) {
+                const optimisticCheckout = {
+                    ...previousCheckout,
+                    checkoutSession: {
+                        ...previousCheckout.checkoutSession,
+                        sessionLineItems: lineItems.map(item => ({
+                            variantId: item.variantId,
+                            quantity: item.quantity,
+                            priceId: item.priceId,
+                            isOrderBump: false, // Default for line items
+                        })),
+                    },
+                };
+                queryClient.setQueryData(['checkout', checkoutToken], optimisticCheckout);
+            }
+            // Return a context object with the snapshotted value
+            return { previousCheckout };
+        },
+        onError: (err, _variables, context) => {
+            // If the mutation fails, use the context returned from onMutate to roll back
+            if (context && typeof context === 'object' && 'previousCheckout' in context) {
+                queryClient.setQueryData(['checkout', checkoutToken], context.previousCheckout);
+            }
+        },
+        onSettled: () => {
+            // Always refetch after error or success to ensure we have the latest data
             if (checkoutToken) {
                 void queryClient.invalidateQueries({ queryKey: ['checkout', checkoutToken] });
             }
@@ -173,6 +245,8 @@ export function useCheckoutQuery(options = {}) {
         isSuccess,
         // Actions
         init: async (params) => {
+            // Wait for session to be initialized to ensure we have customerId
+            await waitForSession();
             const result = await initMutation.mutateAsync(params);
             // Update internal token state so the query can fetch the checkout data
             setInternalToken(result.checkoutToken);
@@ -185,6 +259,7 @@ export function useCheckoutQuery(options = {}) {
         refresh,
         // Checkout operations
         updateLineItems: (lineItems) => lineItemsMutation.mutateAsync({ lineItems }),
+        updateLineItemsOptimistic: (lineItems) => lineItemsMutation.mutate({ lineItems }),
         setItemQuantity: (variantId, quantity, priceId) => quantityMutation.mutateAsync({ variantId, quantity, priceId }),
         updateCustomer: (data) => customerMutation.mutateAsync(data),
         updateCustomerAndSessionInfo: (data) => customerAndSessionMutation.mutateAsync(data),

package/dist/v2/react/hooks/useOrderBumpQuery.d.ts

@@ -5,7 +5,6 @@
 export interface UseOrderBumpQueryOptions {
     checkoutToken: string | null;
     offerId: string;
-    productId?: string;
     checkout?: any;
 }
 export interface UseOrderBumpQueryResult {

package/dist/v2/react/hooks/useOrderBumpQuery.js

@@ -6,7 +6,7 @@ import { useState, useCallback, useEffect } from 'react';
 import { useApiMutation, useInvalidateQuery, getGlobalApiClient } from './useApiQuery';
 import { useCheckoutQuery } from './useCheckoutQuery';
 export function useOrderBumpQuery(options) {
-    const { checkoutToken, offerId, productId, checkout: providedCheckout } = options;
+    const { checkoutToken, offerId, checkout: providedCheckout } = options;
     const { invalidateCheckout, invalidatePromotions } = useInvalidateQuery();
     const client = getGlobalApiClient();
     // Use checkout query only if no checkout is provided
@@ -23,11 +23,12 @@ export function useOrderBumpQuery(options) {
         if (!checkout?.checkoutSession?.sessionLineItems) {
             return false;
         }
-        const targetProductId = productId || offerId;
+        // Check if any order bump items exist in sessionLineItems
+        // The offerId is the upsell offer ID, but we check for isOrderBump === true
         return checkout.checkoutSession.sessionLineItems.some((item) => {
-            return item.isOrderBump === true && item.productId === targetProductId;
+            return item.isOrderBump === true;
         });
-    }, [checkout?.checkoutSession?.sessionLineItems, offerId, productId]);
+    }, [checkout?.checkoutSession?.sessionLineItems]);
     // State management
     const [isSelected, setIsSelected] = useState(() => checkOrderBumpSelection());
     const [error, setError] = useState(null);
@@ -82,7 +83,7 @@ export function useOrderBumpQuery(options) {
             const error = err instanceof Error ? err : new Error('Failed to toggle order bump');
             return { success: false, error: error.message };
         }
-    }, [checkout?.checkoutSession?.id, isSelected, toggleMutation, offerId, productId, checkoutToken, actualCheckoutToken]);
+    }, [checkout?.checkoutSession?.id, isSelected, toggleMutation, offerId, checkoutToken, actualCheckoutToken]);
     return {
         isSelected,
         isToggling: toggleMutation.isPending,

package/dist/v2/react/providers/TagadaProvider.js

@@ -41,11 +41,11 @@ const InitializationLoader = () => (_jsxs("div", { style: {
                 borderTop: '1.5px solid #9ca3af',
                 borderRadius: '50%',
                 animation: 'tagada-spin 1s linear infinite',
-            } }), _jsx("span", { children: "Loading..." }), _jsx("style", { children: `
-        @keyframes tagada-spin {
-          0% { transform: rotate(0deg); }
-          100% { transform: rotate(360deg); }
-        }
+            } }), _jsx("span", { children: "Loading..." }), _jsx("style", { children: `
+        @keyframes tagada-spin {
+          0% { transform: rotate(0deg); }
+          100% { transform: rotate(360deg); }
+        }
       ` })] }));
 const TagadaContext = createContext(null);
 // Global instance tracking for TagadaProvider

package/package.json

@@ -1,90 +1,90 @@
-{
-  "name": "@tagadapay/plugin-sdk",
-  "version": "2.6.0",
-  "description": "Modern React SDK for building Tagada Pay plugins",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
-    },
-    "./react": {
-      "types": "./dist/react/index.d.ts",
-      "import": "./dist/react/index.js",
-      "require": "./dist/react/index.js"
-    },
-    "./v2": {
-      "types": "./dist/v2/index.d.ts",
-      "import": "./dist/v2/index.js",
-      "require": "./dist/v2/index.js"
-    }
-  },
-  "scripts": {
-    "build": "tsc",
-    "clean": "rm -rf dist",
-    "lint": "echo \"No linting configured\"",
-    "test": "echo \"No tests yet\" && exit 0",
-    "dev": "tsc --watch",
-    "prepublishOnly": "npm run clean && npm run build",
-    "publish:patch": "npm version patch && npm publish",
-    "publish:minor": "npm version minor && npm publish",
-    "publish:major": "npm version major && npm publish",
-    "publish:beta": "npm version prerelease --preid=beta && npm publish --tag beta",
-    "publish:alpha": "npm version prerelease --preid=alpha && npm publish --tag alpha",
-    "version:patch": "npm version patch",
-    "version:minor": "npm version minor",
-    "version:major": "npm version major",
-    "version:beta": "npm version prerelease --preid=beta",
-    "version:alpha": "npm version prerelease --preid=alpha",
-    "version:check": "node version-sync.js check",
-    "version:sync": "node version-sync.js sync",
-    "version:list": "node version-sync.js list",
-    "version:next": "node version-sync.js next",
-    "postversion": "echo \"✅ Version updated to $(node -p 'require(\"./package.json\").version')\" && git push && git push --tags"
-  },
-  "keywords": [
-    "tagadapay",
-    "cms",
-    "plugin",
-    "sdk",
-    "react",
-    "typescript"
-  ],
-  "author": "Tagada Pay",
-  "license": "MIT",
-  "dependencies": {
-    "@basis-theory/apple-pay-js": "^2.0.2",
-    "@basis-theory/basis-theory-js": "^4.30.0",
-    "@basis-theory/basis-theory-react": "^1.32.5",
-    "@basis-theory/web-threeds": "^1.0.1",
-    "@tanstack/react-query": "^5.90.2",
-    "axios": "^1.10.0",
-    "iso3166-2-db": "^2.3.11",
-    "react-intl": "^7.1.11",
-    "swr": "^2.3.6"
-  },
-  "devDependencies": {
-    "@types/node": "^18.0.0",
-    "@types/react": "^19",
-    "@types/react-dom": "^19",
-    "typescript": "^5.0.0"
-  },
-  "peerDependencies": {
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
-  },
-  "files": [
-    "dist/**/*",
-    "README.md"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tagadapay/plugin-sdk.git"
-  },
-  "bugs": {
-    "url": "https://github.com/tagadapay/plugin-sdk/issues"
-  },
-  "homepage": "https://github.com/tagadapay/plugin-sdk#readme"
-}
+{
+  "name": "@tagadapay/plugin-sdk",
+  "version": "2.6.4",
+  "description": "Modern React SDK for building Tagada Pay plugins",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "require": "./dist/react/index.js"
+    },
+    "./v2": {
+      "types": "./dist/v2/index.d.ts",
+      "import": "./dist/v2/index.js",
+      "require": "./dist/v2/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "lint": "echo \"No linting configured\"",
+    "test": "echo \"No tests yet\" && exit 0",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run clean && npm run build",
+    "publish:patch": "npm version patch && npm publish",
+    "publish:minor": "npm version minor && npm publish",
+    "publish:major": "npm version major && npm publish",
+    "publish:beta": "npm version prerelease --preid=beta && npm publish --tag beta",
+    "publish:alpha": "npm version prerelease --preid=alpha && npm publish --tag alpha",
+    "version:patch": "npm version patch",
+    "version:minor": "npm version minor",
+    "version:major": "npm version major",
+    "version:beta": "npm version prerelease --preid=beta",
+    "version:alpha": "npm version prerelease --preid=alpha",
+    "version:check": "node version-sync.js check",
+    "version:sync": "node version-sync.js sync",
+    "version:list": "node version-sync.js list",
+    "version:next": "node version-sync.js next",
+    "postversion": "echo \"✅ Version updated to $(node -p 'require(\"./package.json\").version')\" && (git push && git push --tags || echo \"⚠️ Git push failed - you may need to pull and push manually\")"
+  },
+  "keywords": [
+    "tagadapay",
+    "cms",
+    "plugin",
+    "sdk",
+    "react",
+    "typescript"
+  ],
+  "author": "Tagada Pay",
+  "license": "MIT",
+  "dependencies": {
+    "@basis-theory/apple-pay-js": "^2.0.2",
+    "@basis-theory/basis-theory-js": "^4.30.0",
+    "@basis-theory/basis-theory-react": "^1.32.5",
+    "@basis-theory/web-threeds": "^1.0.1",
+    "@tanstack/react-query": "^5.90.2",
+    "axios": "^1.10.0",
+    "iso3166-2-db": "^2.3.11",
+    "react-intl": "^7.1.11",
+    "swr": "^2.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^18.0.0",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tagadapay/plugin-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tagadapay/plugin-sdk/issues"
+  },
+  "homepage": "https://github.com/tagadapay/plugin-sdk#readme"
+}