backend-manager 5.0.156 → 5.0.157

package/CHANGELOG.md

@@ -14,6 +14,20 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - `Fixed` for any bug fixes.
 - `Security` in case of vulnerabilities.
 
+# [5.0.157] - 2026-03-17
+### Added
+- Campaign template variables via `powertools.template()` — `{brand.name}`, `{season.name}`, `{holiday.name}`, `{date.month}`, `{date.year}`, `{date.full}`
+- Separate SEASONS (Winter/Spring/Summer/Fall) and HOLIDAYS (New Year, Valentine's Day, Black Friday, Christmas, etc.) maps
+- Audit logging in `getSegmentContacts()` — logs export start, poll status, download count, timeout
+
+### Changed
+- Seed sale campaign: quarterly → monthly on 15th, uses `{holiday.name}` template vars, targets free + cancelled + churned users, excludes paid
+- Prune cron calls segment export with 3-minute timeout for large segments
+
+### Fixed
+- S3 presigned URL download broken by wonderful-fetch cache buster — set `cacheBreaker: false`
+- CSV header parsing: normalize to lowercase for case-insensitive column matching
+
 # [5.0.156] - 2026-03-17
 ### Added
 - Marketing campaign system with full CRUD routes (`POST/GET/PUT/DELETE /marketing/campaign`)

package/package.json

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

package/src/cli/commands/setup-tests/helpers/seed-campaigns.js

@@ -13,25 +13,19 @@ const moment = require('moment');
  */
 
 /**
- * Get the next occurrence of a quarterly date from now.
- * Quarters: Jan 1, Apr 1, Jul 1, Oct 1.
+ * Get the next occurrence of a specific day of month.
+ * @param {number} dayOfMonth - Day (1-31)
+ * @param {number} hour - Hour (UTC)
  */
-function nextQuarter(hour) {
-  const now = moment.utc();
-  const quarters = [
-    moment.utc({ month: 0, day: 1, hour }),
-    moment.utc({ month: 3, day: 1, hour }),
-    moment.utc({ month: 6, day: 1, hour }),
-    moment.utc({ month: 9, day: 1, hour }),
-  ];
+function nextMonthDay(dayOfMonth, hour) {
+  const next = moment.utc().startOf('month').date(dayOfMonth).hour(hour);
 
-  for (const q of quarters) {
-    if (q.year(now.year()).isAfter(now)) {
-      return q.year(now.year()).unix();
-    }
+  // If this month's date has passed, go to next month
+  if (next.isBefore(moment.utc())) {
+    next.add(1, 'month');
   }
 
-  return quarters[0].year(now.year() + 1).unix();
+  return next.unix();
 }
 
 /**
@@ -56,30 +50,31 @@ function buildSeedCampaigns() {
 
   return [
     {
-      id: '_recurring-quarterly-sale',
+      id: '_recurring-monthly-sale',
       doc: {
         settings: {
-          name: 'Quarterly Sale',
-          subject: 'Limited Time — Upgrade & Save!',
-          preheader: 'Our biggest discount this quarter',
+          name: '{holiday.name} Sale',
+          subject: '{holiday.name} Sale — Upgrade & Save!',
+          preheader: 'Limited time offer from {brand.name}',
           content: [
-            '# Quarterly Sale',
+            '# {holiday.name} Sale',
             '',
-            'For a limited time, upgrade your plan and save big.',
+            'For a limited time, upgrade your **{brand.name}** plan and save big.',
             '',
             'Don\'t miss out — this offer ends soon!',
           ].join('\n'),
           template: 'default',
           sender: 'marketing',
           providers: ['sendgrid'],
-          segments: ['subscription_free'],
-          excludeSegments: [],
+          segments: ['subscription_free', 'subscription_cancelled', 'subscription_churned'],
+          excludeSegments: ['subscription_paid'],
         },
-        sendAt: nextQuarter(14),
+        sendAt: nextMonthDay(15, 14),
         status: 'pending',
         type: 'email',
         recurrence: {
-          pattern: 'quarterly',
+          pattern: 'monthly',
+          day: 15,
           hour: 14,
         },
         metadata: {
@@ -87,14 +82,15 @@ function buildSeedCampaigns() {
           updated: { timestamp: nowISO, timestampUNIX: nowUNIX },
         },
       },
-      // Fields enforced on every setup run (deep path → value)
       enforced: {
         'type': 'email',
-        'recurrence.pattern': 'quarterly',
+        'recurrence.pattern': 'monthly',
+        'recurrence.day': 15,
         'recurrence.hour': 14,
         'settings.providers': ['sendgrid'],
         'settings.sender': 'marketing',
-        'settings.segments': ['subscription_free'],
+        'settings.segments': ['subscription_free', 'subscription_cancelled', 'subscription_churned'],
+        'settings.excludeSegments': ['subscription_paid'],
       },
     },
     {

package/src/manager/cron/daily/marketing-prune.js

@@ -95,7 +95,7 @@ async function stagePrune(Manager, assistant) {
       return;
     }
 
-    const exportResult = await sendgridProvider.getSegmentContacts(pruneSegmentId);
+    const exportResult = await sendgridProvider.getSegmentContacts(pruneSegmentId, 180000);
 
     if (!exportResult.success) {
       assistant.error('Marketing prune: Failed to export segment:', exportResult.error);

package/src/manager/libraries/email/marketing/index.js

@@ -271,9 +271,22 @@ Marketing.prototype.sendCampaign = async function (settings) {
   const results = {};
   const promises = [];
 
-  // Convert markdown content to HTML, then tag links with UTM params
+  // Resolve campaign-level variables: {brand.name}, {season}, {year}, etc.
+  // Uses single braces via powertools.template() — distinct from {{template}} vars handled by SendGrid
   const brand = Manager.config?.brand;
-  let contentHtml = settings.content ? md.render(settings.content) : '';
+  const templateContext = buildTemplateContext(brand);
+  const template = require('node-powertools').template;
+
+  const resolvedSettings = {
+    ...settings,
+    name: template(settings.name || '', templateContext),
+    subject: template(settings.subject || '', templateContext),
+    preheader: template(settings.preheader || '', templateContext),
+    content: template(settings.content || '', templateContext),
+  };
+
+  // Convert markdown content to HTML, then tag links with UTM params
+  let contentHtml = resolvedSettings.content ? md.render(resolvedSettings.content) : '';
 
   if (contentHtml) {
     contentHtml = tagLinks(contentHtml, {
@@ -300,7 +313,7 @@ Marketing.prototype.sendCampaign = async function (settings) {
   // Beehiiv: segment resolution will go here when Beehiiv segments are supported
 
   assistant.log('Marketing.sendCampaign():', {
-    name: settings.name,
+    name: resolvedSettings.name,
     providers: useProviders,
     sendAt: settings.sendAt || 'draft',
   });
@@ -308,7 +321,7 @@ Marketing.prototype.sendCampaign = async function (settings) {
   // --- SendGrid ---
   if (useProviders.includes('sendgrid') && self.providers.sendgrid) {
     const sgSettings = {
-      ...settings,
+      ...resolvedSettings,
       segments: resolvedSegments.sendgrid?.segments || [],
       excludeSegments: resolvedSegments.sendgrid?.excludeSegments || [],
     };
@@ -324,9 +337,9 @@ Marketing.prototype.sendCampaign = async function (settings) {
   if (useProviders.includes('beehiiv') && self.providers.beehiiv) {
     promises.push(
       beehiivProvider.createPost({
-        title: settings.name,
-        subject: settings.subject,
-        preheader: settings.preheader,
+        title: resolvedSettings.name,
+        subject: resolvedSettings.subject,
+        preheader: resolvedSettings.preheader,
         content: contentHtml,
         sendAt: settings.sendAt,
         segments: settings.segments,
@@ -459,4 +472,73 @@ Marketing.prototype.listCampaigns = async function (options) {
   return sendgridProvider.listSingleSends(options);
 };
 
+// --- Campaign variable resolution ---
+
+const SEASONS = {
+  0: 'Winter',   // Jan
+  1: 'Winter',   // Feb
+  2: 'Spring',   // Mar
+  3: 'Spring',   // Apr
+  4: 'Spring',   // May
+  5: 'Summer',   // Jun
+  6: 'Summer',   // Jul
+  7: 'Summer',   // Aug
+  8: 'Fall',     // Sep
+  9: 'Fall',     // Oct
+  10: 'Fall',    // Nov
+  11: 'Winter',  // Dec
+};
+
+const HOLIDAYS = {
+  0: 'New Year',          // Jan
+  1: 'Valentine\'s Day',  // Feb
+  2: 'Spring',            // Mar
+  3: 'Spring',            // Apr
+  4: 'Memorial Day',      // May
+  5: 'Summer',            // Jun
+  6: 'Independence Day',  // Jul
+  7: 'Back to School',    // Aug
+  8: 'Labor Day',         // Sep
+  9: 'Halloween',         // Oct
+  10: 'Black Friday',     // Nov
+  11: 'Christmas',        // Dec
+};
+
+const MONTH_NAMES = [
+  'January', 'February', 'March', 'April', 'May', 'June',
+  'July', 'August', 'September', 'October', 'November', 'December',
+];
+
+/**
+ * Build template context for campaign variable resolution.
+ * Used with powertools.template() — supports nested paths like {brand.name}.
+ *
+ * Available variables:
+ *   {brand.name}, {brand.id}, {brand.url}
+ *   {season.name}    — Winter, Spring, Summer, Fall
+ *   {holiday.name}   — New Year, Valentine's Day, Black Friday, Christmas, etc.
+ *   {date.month}     — January, February, etc.
+ *   {date.year}      — 2026
+ *   {date.full}      — March 17, 2026
+ */
+function buildTemplateContext(brand) {
+  const now = new Date();
+  const month = now.getMonth();
+
+  return {
+    brand: brand || {},
+    season: {
+      name: SEASONS[month],
+    },
+    holiday: {
+      name: HOLIDAYS[month],
+    },
+    date: {
+      month: MONTH_NAMES[month],
+      year: String(now.getFullYear()),
+      full: now.toLocaleDateString('en-US', { month: 'long', day: 'numeric', year: 'numeric' }),
+    },
+  };
+}
+
 module.exports = Marketing;

package/src/manager/libraries/email/providers/sendgrid.js

@@ -495,11 +495,15 @@ async function getSegmentContacts(segmentId, maxWaitMs = 60000) {
       return { success: false, error: 'Failed to start export' };
     }
 
+    console.log(`SendGrid getSegmentContacts: Export started (job: ${exportData.id})`);
+
     // Poll for completion
     const startTime = Date.now();
+    let pollCount = 0;
 
     while (Date.now() - startTime < maxWaitMs) {
       await new Promise(r => setTimeout(r, 3000));
+      pollCount++;
 
       const statusData = await fetch(`${BASE_URL}/marketing/contacts/exports/${exportData.id}`, {
         response: 'json',
@@ -507,11 +511,14 @@ async function getSegmentContacts(segmentId, maxWaitMs = 60000) {
         timeout: 10000,
       });
 
+      console.log(`SendGrid getSegmentContacts: Poll #${pollCount} — ${statusData.status} (${Date.now() - startTime}ms)`);
+
       if (statusData.status === 'ready' && statusData.urls?.length) {
-        // Download CSV
+        // Download CSV — disable cacheBreaker to preserve presigned S3 URL signature
         const csvText = await fetch(statusData.urls[0], {
           response: 'text',
           timeout: 30000,
+          cacheBreaker: false,
         });
 
         // Parse CSV — first line is headers, find email and id columns
@@ -521,7 +528,7 @@ async function getSegmentContacts(segmentId, maxWaitMs = 60000) {
           return { success: true, contacts: [] };
         }
 
-        const headerCols = lines[0].split(',');
+        const headerCols = lines[0].split(',').map(h => h.replace(/"/g, '').trim().toLowerCase());
         const emailIdx = headerCols.indexOf('email');
         const idIdx = headerCols.indexOf('contact_id');
 
@@ -537,14 +544,18 @@ async function getSegmentContacts(segmentId, maxWaitMs = 60000) {
           }
         }
 
+        console.log(`SendGrid getSegmentContacts: Downloaded ${contacts.length} contacts (${Date.now() - startTime}ms)`);
+
         return { success: true, contacts };
       }
 
       if (statusData.status === 'failure') {
+        console.error('SendGrid getSegmentContacts: Export failed');
         return { success: false, error: 'Export failed' };
       }
     }
 
+    console.error(`SendGrid getSegmentContacts: Timed out after ${maxWaitMs}ms (${pollCount} polls)`);
     return { success: false, error: 'Export timed out' };
   } catch (e) {
     console.error('SendGrid getSegmentContacts error:', e);