backend-manager 5.0.145 → 5.0.147

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backend-manager",
-  "version": "5.0.145",
+  "version": "5.0.147",
   "description": "Quick tools for developing Firebase functions",
   "main": "src/manager/index.js",
   "bin": {

package/src/manager/events/firestore/payments-webhooks/analytics.js

@@ -19,13 +19,13 @@ const fetch = require('wonderful-fetch');
  * Track payment events across analytics platforms (non-blocking)
  * Fires GA4, Meta, and TikTok independently with per-platform payloads
  */
-function trackPayment({ category, transitionName, eventType, unified, uid, processor, assistant }) {
+function trackPayment({ category, transitionName, eventType, unified, order, uid, processor, assistant }) {
   const Manager = assistant.Manager;
   const config = Manager.config;
 
   try {
     // Resolve what kind of payment event this is
-    const resolved = resolvePaymentEvent(category, transitionName, eventType, unified);
+    const resolved = resolvePaymentEvent(category, transitionName, eventType, unified, order);
 
     if (!resolved) {
       assistant.log(`trackPayment: skipped — no trackable event (category=${category}, transition=${transitionName || 'null'}, eventType=${eventType})`);
@@ -53,13 +53,16 @@ function trackPayment({ category, transitionName, eventType, unified, uid, proce
  * Determine what kind of payment event occurred and extract common fields
  * Returns null if nothing should be tracked
  */
-function resolvePaymentEvent(category, transitionName, eventType, unified) {
+function resolvePaymentEvent(category, transitionName, eventType, unified, order) {
   const productId = unified.product?.id;
   const productName = unified.product?.name;
   const frequency = unified.payment?.frequency || null;
   const isTrial = unified.trial?.claimed === true;
   const resourceId = unified.payment?.resourceId;
-  const price = unified.payment?.price || 0;
+  const price = parseFloat(unified.payment?.price || 0);
+
+  // Compute actual amount paid (accounting for trial and discount)
+  const value = resolveActualValue(price, isTrial, order?.discount);
 
   const base = { productId, productName, frequency, resourceId, isTrial };
 
@@ -70,7 +73,7 @@ function resolvePaymentEvent(category, transitionName, eventType, unified) {
     }
 
     if (transitionName === 'new-subscription') {
-      return { ...base, reason: 'first-purchase', value: price, isRecurring: false };
+      return { ...base, reason: 'first-purchase', value, isRecurring: false };
     }
 
     if (transitionName === 'payment-recovered') {
@@ -78,6 +81,7 @@ function resolvePaymentEvent(category, transitionName, eventType, unified) {
     }
 
     // No transition but a payment event fired (renewal)
+    // Renewals always use full price (discount is one-time only)
     if (!transitionName && isPaymentEvent(eventType) && price > 0) {
       return { ...base, reason: 'renewal', value: price, isRecurring: true };
     }
@@ -88,7 +92,7 @@ function resolvePaymentEvent(category, transitionName, eventType, unified) {
   // --- One-time transitions ---
   if (category === 'one-time') {
     if (transitionName === 'purchase-completed') {
-      return { ...base, reason: 'one-time-purchase', value: price, isRecurring: false, productId: productId || 'unknown', productName: productName || 'Unknown' };
+      return { ...base, reason: 'one-time-purchase', value, isRecurring: false, productId: productId || 'unknown', productName: productName || 'Unknown' };
     }
 
     return null;
@@ -97,6 +101,22 @@ function resolvePaymentEvent(category, transitionName, eventType, unified) {
   return null;
 }
 
+/**
+ * Compute the actual amount paid, accounting for trial and promo discount
+ * Trial = $0, discount = price - savings, otherwise full price
+ */
+function resolveActualValue(price, isTrial, discount) {
+  if (isTrial) {
+    return 0;
+  }
+
+  if (discount?.valid === true && discount?.percent > 0) {
+    return parseFloat((price - (price * discount.percent / 100)).toFixed(2));
+  }
+
+  return price;
+}
+
 /**
  * Check if a webhook event type represents a payment being made
  */

package/src/manager/events/firestore/payments-webhooks/on-write.js

@@ -281,7 +281,7 @@ async function processPaymentEvent({ category, library, resource, resourceType,
   // Track payment analytics (non-blocking)
   // Fires independently of transitions — renewals have no transition but still need tracking
   if (shouldRunHandlers) {
-    trackPayment({ category, transitionName, eventType, unified, uid, processor, assistant });
+    trackPayment({ category, transitionName, eventType, unified, order, uid, processor, assistant });
   }
 
   // Write unified subscription to user doc (subscriptions only)

package/src/manager/events/firestore/payments-webhooks/transitions/subscription/new-subscription.js

@@ -10,7 +10,12 @@ module.exports = async function ({ before, after, order, uid, userDoc, assistant
   const brandName = assistant.Manager.config.brand?.name || '';
   const planName = after.product?.name || '';
 
-  assistant.log(`Transition [subscription/new-subscription]: uid=${uid}, product=${after.product?.id}, frequency=${after.payment?.frequency}, trial=${isTrial}`);
+  // Pre-compute discount values for the email template
+  const price = parseFloat(order.unified?.payment?.price || 0);
+  const discount = order.discount;
+  const hasPromoDiscount = discount?.valid === true && discount?.percent > 0;
+
+  assistant.log(`Transition [subscription/new-subscription]: uid=${uid}, product=${after.product?.id}, frequency=${after.payment?.frequency}, trial=${isTrial}, discount=${hasPromoDiscount ? discount.code : 'none'}`);
 
   sendOrderEmail({
     template: 'main/order/confirmation',
@@ -26,6 +31,20 @@ module.exports = async function ({ before, after, order, uid, userDoc, assistant
           ...(isTrial && after.trial?.expires?.timestamp && {
             trialExpires: formatDate(after.trial.expires.timestamp),
           }),
+          ...(hasPromoDiscount && {
+            promoCode: discount.code,
+            promoPercent: discount.percent,
+            promoSavings: (price * discount.percent / 100).toFixed(2),
+          }),
+          // Amount charged on the first real payment (after trial if applicable)
+          firstChargeAmount: hasPromoDiscount
+            ? (price - (price * discount.percent / 100)).toFixed(2)
+            : price.toFixed(2),
+          totalToday: isTrial
+            ? '0.00'
+            : hasPromoDiscount
+              ? (price - (price * discount.percent / 100)).toFixed(2)
+              : price.toFixed(2),
         },
       },
     },