@tagadapay/plugin-sdk 4.0.2 → 4.0.4

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

@@ -286,11 +286,11 @@ export declare class OffersResource {
     /**
      * Pay with checkout session
      */
-    payWithCheckoutSession(checkoutSessionId: string, orderId?: string): Promise<void>;
+    payWithCheckoutSession(checkoutSessionId: string, orderId?: string, initiatedBy?: 'merchant' | 'customer'): Promise<void>;
     /**
      * Pay for an offer directly
      */
-    payOffer(offerId: string, orderId?: string): Promise<any>;
+    payOffer(offerId: string, orderId?: string, initiatedBy?: 'merchant' | 'customer'): Promise<any>;
     /**
      * Transform offer to checkout session with dynamic variant selection
      * Uses lineItems from the offer to create a new checkout session

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

@@ -3,6 +3,7 @@
  * Axios-based API client for offers endpoints
  */
 import { isDraftMode } from '../utils/previewMode';
+import { getAssignedPaymentInitiator } from '../funnelClient';
 export class OffersResource {
     constructor(apiClient) {
         this.apiClient = apiClient;
@@ -69,13 +70,14 @@ export class OffersResource {
      * @param mainOrderId - Optional main order ID (for upsells)
      */
     async payPreviewedOffer(offerId, currency = '', lineItems, returnUrl, mainOrderId, initiatedBy) {
+        const effectiveInitiatedBy = initiatedBy ?? getAssignedPaymentInitiator();
         console.log('💳 [OffersResource] Calling pay-preview API:', {
             offerId,
             currency,
             lineItems,
             returnUrl,
             mainOrderId,
-            initiatedBy,
+            initiatedBy: effectiveInitiatedBy,
             endpoint: `/api/v1/offers/${offerId}/pay-preview`,
         });
         const response = await this.apiClient.post(`/api/v1/offers/${offerId}/pay-preview`, {
@@ -84,7 +86,7 @@ export class OffersResource {
             lineItems,
             returnUrl: returnUrl || (typeof window !== 'undefined' ? window.location.href : ''),
             mainOrderId,
-            ...(initiatedBy ? { initiatedBy } : {}),
+            ...(effectiveInitiatedBy ? { initiatedBy: effectiveInitiatedBy } : {}),
         });
         console.log('📥 [OffersResource] Pay-preview API response:', response);
         return response;
@@ -151,13 +153,15 @@ export class OffersResource {
     /**
      * Pay with checkout session
      */
-    async payWithCheckoutSession(checkoutSessionId, orderId) {
+    async payWithCheckoutSession(checkoutSessionId, orderId, initiatedBy) {
         // 🎯 Check draft mode from URL, localStorage, or cookie
         const draft = isDraftMode();
+        const effectiveInitiatedBy = initiatedBy ?? getAssignedPaymentInitiator();
         await this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/pay`, {
             checkoutSessionId,
             draft, // 🎯 Use dynamic draft mode instead of hardcoded false
             returnUrl: typeof window !== 'undefined' ? window.location.href : '',
+            ...(effectiveInitiatedBy ? { initiatedBy: effectiveInitiatedBy } : {}),
             metadata: {
                 comingFromPostPurchase: true,
                 postOrder: orderId,
@@ -169,13 +173,15 @@ export class OffersResource {
     /**
      * Pay for an offer directly
      */
-    async payOffer(offerId, orderId) {
+    async payOffer(offerId, orderId, initiatedBy) {
         // 🎯 Check draft mode from URL, localStorage, or cookie
         const draft = isDraftMode();
+        const effectiveInitiatedBy = initiatedBy ?? getAssignedPaymentInitiator();
         return this.apiClient.post(`/api/v1/offers/${offerId}/pay`, {
             offerId,
             draft, // 🎯 Use dynamic draft mode instead of hardcoded false
             returnUrl: typeof window !== 'undefined' ? window.location.href : '',
+            ...(effectiveInitiatedBy ? { initiatedBy: effectiveInitiatedBy } : {}),
             metadata: orderId ? {
                 comingFromPostPurchase: true,
                 postOrder: orderId,

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

@@ -1,6 +1,14 @@
 /**
  * useOffer Hook - Single offer workflow with checkout session management
  *
+ * @deprecated Use `usePreviewOffer` instead. `usePreviewOffer` is the
+ * supported hook for post-checkout upsell pages: it skips the upfront
+ * checkout-session round-trip, recomputes pricing client-side, and applies
+ * the CRM-configured MIT/CIT payment initiator automatically via the
+ * shared OffersResource auto-pickup. `useOfferQuery` (aliased as `useOffer`)
+ * remains exported for backwards compatibility but will be removed in a
+ * future major version.
+ *
  * Behavior copied from useOffersQuery but simplified for a single offer:
  * 1. Fetches offer data
  * 2. Auto-initializes checkout session when mainOrderId is provided
@@ -106,4 +114,7 @@ export interface UseOfferQueryResult {
     /** Whether variant is loading for a product */
     isLoadingVariant: (productId: string) => boolean;
 }
+/**
+ * @deprecated Use `usePreviewOffer` instead. See module-level JSDoc.
+ */
 export declare function useOfferQuery(options: UseOfferQueryOptions): UseOfferQueryResult;

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

@@ -1,6 +1,14 @@
 /**
  * useOffer Hook - Single offer workflow with checkout session management
  *
+ * @deprecated Use `usePreviewOffer` instead. `usePreviewOffer` is the
+ * supported hook for post-checkout upsell pages: it skips the upfront
+ * checkout-session round-trip, recomputes pricing client-side, and applies
+ * the CRM-configured MIT/CIT payment initiator automatically via the
+ * shared OffersResource auto-pickup. `useOfferQuery` (aliased as `useOffer`)
+ * remains exported for backwards compatibility but will be removed in a
+ * future major version.
+ *
  * Behavior copied from useOffersQuery but simplified for a single offer:
  * 1. Fetches offer data
  * 2. Auto-initializes checkout session when mainOrderId is provided
@@ -14,6 +22,9 @@ import { OffersResource } from '../../core/resources/offers';
 import { useTagadaContext } from '../providers/TagadaProvider';
 import { getGlobalApiClient } from './useApiQuery';
 import { usePluginConfig } from './usePluginConfig';
+/**
+ * @deprecated Use `usePreviewOffer` instead. See module-level JSDoc.
+ */
 export function useOfferQuery(options) {
     const { offerId, enabled = true, mainOrderId: rawMainOrderId } = options;
     const { storeId } = usePluginConfig();

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

@@ -10,7 +10,6 @@
 import { useQuery } from '@tanstack/react-query';
 import { useCallback, useEffect, useMemo, useState } from 'react';
 import { OffersResource } from '../../core/resources/offers';
-import { getAssignedPaymentInitiator } from '../../core/funnelClient';
 import { getGlobalApiClient } from './useApiQuery';
 export function usePreviewOffer(options) {
     const { offerId, currency: requestedCurrency = '', initialSelections = {} } = options;
@@ -235,12 +234,9 @@ export function usePreviewOffer(options) {
         }
         setIsPaying(true);
         try {
-            // Auto-pickup: stepConfig.paymentInitiator from the funnel client is
-            // applied when the caller does not pass an explicit override. This
-            // way the MIT/CIT toggle in the CRM step config takes effect for
-            // every consumer of usePreviewOffer without per-template wiring.
-            const initiatedBy = payOptions?.initiatedBy ?? getAssignedPaymentInitiator();
-            const result = await offersResource.payPreviewedOffer(offerId, effectiveCurrency, lineItemsForPreview, typeof window !== 'undefined' ? window.location.href : undefined, mainOrderId, initiatedBy);
+            // initiatedBy auto-picks from stepConfig.paymentInitiator inside
+            // OffersResource.payPreviewedOffer when not supplied here.
+            const result = await offersResource.payPreviewedOffer(offerId, effectiveCurrency, lineItemsForPreview, typeof window !== 'undefined' ? window.location.href : undefined, mainOrderId, payOptions?.initiatedBy);
             console.log('[usePreviewOffer] Payment initiated:', result);
             return {
                 checkoutUrl: result.checkout.checkoutUrl,

package/dist/v2/react/index.d.ts

@@ -33,6 +33,7 @@ export { queryKeys, useApiMutation, useApiQuery, useInvalidateQuery, usePreloadQ
 export { useCheckoutQuery as useCheckout } from './hooks/useCheckoutQuery';
 export { useCurrency } from './hooks/useCurrency';
 export { useDiscountsQuery as useDiscounts } from './hooks/useDiscountsQuery';
+/** @deprecated Use `usePreviewOffer` instead. */
 export { useOfferQuery as useOffer } from './hooks/useOfferQuery';
 export { useOrderBumpQuery as useOrderBump } from './hooks/useOrderBumpQuery';
 export { useOrderQuery as useOrder } from './hooks/useOrderQuery';

package/dist/v2/react/index.js

@@ -35,6 +35,7 @@ export { queryKeys, useApiMutation, useApiQuery, useInvalidateQuery, usePreloadQ
 export { useCheckoutQuery as useCheckout } from './hooks/useCheckoutQuery';
 export { useCurrency } from './hooks/useCurrency';
 export { useDiscountsQuery as useDiscounts } from './hooks/useDiscountsQuery';
+/** @deprecated Use `usePreviewOffer` instead. */
 export { useOfferQuery as useOffer } from './hooks/useOfferQuery';
 export { useOrderBumpQuery as useOrderBump } from './hooks/useOrderBumpQuery';
 export { useOrderQuery as useOrder } from './hooks/useOrderQuery';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tagadapay/plugin-sdk",
-  "version": "4.0.2",
+  "version": "4.0.4",
   "description": "Modern React SDK for building Tagada Pay plugins",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",