backend-manager 5.0.149 → 5.0.150

package/CHANGELOG.md

@@ -14,6 +14,19 @@ 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.150] - 2026-03-16
+### Added
+- `marketing` config section in `backend-manager-config.json` — per-brand control over SendGrid and Beehiiv provider availability
+- Beehiiv provider reads `publicationId` from config (skips fuzzy-match API call) with in-memory cache
+
+### Changed
+- Provider availability resolved once in Marketing constructor from `config.marketing` + env vars instead of per-request
+- Removed `providers` parameter from `add()`, `sync()`, `remove()` and all route/schema callers
+
+### Removed
+- `DEFAULT_PROVIDERS` constant — no longer needed with config-driven provider resolution
+- Provider-selection tests — no longer applicable
+
 # [5.0.149] - 2026-03-14
 ### Added
 - Modular email library (`libraries/email/`) — replaces monolithic `libraries/email.js` with provider-based architecture

package/package.json

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

package/src/manager/functions/core/actions/api/general/add-marketing-contact.js

@@ -29,7 +29,6 @@ Module.prototype.main = function () {
 
     // Admin-only options
     const tags = isAdmin ? (requestPayload.tags || []) : [];
-    const providers = isAdmin ? (requestPayload.providers || ['sendgrid', 'beehiiv']) : ['sendgrid', 'beehiiv'];
     const skipValidation = isAdmin ? (requestPayload.skipValidation || false) : false;
 
     // Validate email is provided
@@ -114,7 +113,6 @@ Module.prototype.main = function () {
         firstName,
         lastName,
         source,
-        providers,
       });
     }
 

package/src/manager/functions/core/actions/api/general/remove-marketing-contact.js

@@ -22,7 +22,6 @@ Module.prototype.main = function () {
 
     // Extract parameters
     const email = (requestPayload.email || '').trim().toLowerCase();
-    const providers = requestPayload.providers || ['sendgrid', 'beehiiv'];
 
     // Validate email is provided
     if (!email) {
@@ -31,7 +30,7 @@ Module.prototype.main = function () {
 
     // Remove from providers
     const mailer = Manager.Email(assistant);
-    const providerResults = await mailer.remove(email, { providers });
+    const providerResults = await mailer.remove(email);
 
     // Log result
     assistant.log('remove-marketing-contact result:', {

package/src/manager/libraries/email/constants.js

@@ -84,8 +84,6 @@ const SENDERS = {
   },
 };
 
-// Default marketing providers — SSOT for all provider loops
-const DEFAULT_PROVIDERS = ['sendgrid', 'beehiiv'];
 
 // SendGrid limit for scheduled emails (72 hours, but use 71 for buffer)
 const SEND_AT_LIMIT = 71;
@@ -234,7 +232,6 @@ module.exports = {
   GROUPS,
   SENDERS,
   FIELDS,
-  DEFAULT_PROVIDERS,
   SEND_AT_LIMIT,
   sanitizeImagesForEmail,
   encode,

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

@@ -74,16 +74,9 @@ Email.prototype.build = function (settings) {
 };
 
 /**
- * Sync a user's data to marketing providers (SendGrid + Beehiiv).
+ * Add a new contact to enabled marketing providers (lightweight, no full user doc needed).
  *
- * @param {object} userDoc - Full user document from Firestore
- * @param {object} [options] - { providers: array of provider names (default: DEFAULT_PROVIDERS) }
- * @returns {{ sendgrid?: object, beehiiv?: object }}
- */
-/**
- * Add a new contact to marketing providers (lightweight, no full user doc needed).
- *
- * @param {object} options - { email, firstName, lastName, source, customFields, providers }
+ * @param {object} options - { email, firstName, lastName, source, customFields }
  * @returns {{ sendgrid?: object, beehiiv?: object }}
  */
 Email.prototype.add = function (options) {
@@ -91,25 +84,23 @@ Email.prototype.add = function (options) {
 };
 
 /**
- * Sync a user's full data to marketing providers (SendGrid + Beehiiv).
+ * Sync a user's full data to enabled marketing providers.
  *
- * @param {object} userDoc - Full user document from Firestore
- * @param {object} [options] - { providers: array of provider names (default: DEFAULT_PROVIDERS) }
+ * @param {string|object} userDocOrUid - UID string or full user document from Firestore
  * @returns {{ sendgrid?: object, beehiiv?: object }}
  */
-Email.prototype.sync = function (userDoc, options) {
-  return this._marketing.sync(userDoc, options);
+Email.prototype.sync = function (userDocOrUid) {
+  return this._marketing.sync(userDocOrUid);
 };
 
 /**
- * Remove a contact from all marketing providers.
+ * Remove a contact from all enabled marketing providers.
  *
  * @param {string} email - Email address to remove
- * @param {object} [options] - { providers: array of provider names (default: DEFAULT_PROVIDERS) }
  * @returns {{ sendgrid?: object, beehiiv?: object }}
  */
-Email.prototype.remove = function (email, options) {
-  return this._marketing.remove(email, options);
+Email.prototype.remove = function (email) {
+  return this._marketing.remove(email);
 };
 
 /**

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

@@ -25,7 +25,7 @@
  */
 const _ = require('lodash');
 
-const { TEMPLATES, GROUPS, SENDERS, DEFAULT_PROVIDERS } = require('../constants.js');
+const { TEMPLATES, GROUPS, SENDERS } = require('../constants.js');
 const sendgridProvider = require('../providers/sendgrid.js');
 const beehiivProvider = require('../providers/beehiiv.js');
 
@@ -36,11 +36,19 @@ function Marketing(assistant) {
   self.Manager = assistant.Manager;
   self.admin = self.Manager.libraries.admin;
 
+  // Resolve provider availability from config + env
+  const marketing = self.Manager.config?.marketing || {};
+
+  self.providers = {
+    sendgrid: marketing.sendgrid?.enabled !== false && !!process.env.SENDGRID_API_KEY,
+    beehiiv: marketing.beehiiv?.enabled !== false && !!process.env.BEEHIIV_API_KEY,
+  };
+
   return self;
 }
 
 /**
- * Add a new contact to all providers (lightweight — no full user doc needed).
+ * Add a new contact to enabled providers (lightweight — no full user doc needed).
  * Used by newsletter subscribe and admin bulk import.
  *
  * @param {object} options
@@ -49,33 +57,29 @@ function Marketing(assistant) {
  * @param {string} [options.lastName]
  * @param {string} [options.source] - UTM source
  * @param {object} [options.customFields] - Extra SendGrid custom fields (keyed by field ID)
- * @param {Array<string>} [options.providers] - Which providers (default: all available)
  * @returns {{ sendgrid?: object, beehiiv?: object }}
  */
 Marketing.prototype.add = async function (options) {
   const self = this;
   const assistant = self.assistant;
-  const { email, firstName, lastName, source, customFields, providers } = options;
+  const { email, firstName, lastName, source, customFields } = options;
 
   if (!email) {
     assistant.warn('Marketing.add(): No email provided, skipping');
     return {};
   }
 
-  const shouldAdd = !assistant.isTesting() || process.env.TEST_EXTENDED_MODE;
-  const addProviders = providers || DEFAULT_PROVIDERS;
-  const results = {};
-
-  if (!shouldAdd) {
+  if (assistant.isTesting() && !process.env.TEST_EXTENDED_MODE) {
     assistant.log('Marketing.add(): Skipping providers (testing mode)');
-    return results;
+    return {};
   }
 
   assistant.log('Marketing.add():', { email });
 
+  const results = {};
   const promises = [];
 
-  if (addProviders.includes('sendgrid') && process.env.SENDGRID_API_KEY) {
+  if (self.providers.sendgrid) {
     promises.push(
       sendgridProvider.addContact({
         email,
@@ -86,7 +90,7 @@ Marketing.prototype.add = async function (options) {
     );
   }
 
-  if (addProviders.includes('beehiiv') && process.env.BEEHIIV_API_KEY) {
+  if (self.providers.beehiiv) {
     promises.push(
       beehiivProvider.addContact({
         email,
@@ -109,14 +113,11 @@ Marketing.prototype.add = async function (options) {
  * Upserts the contact with all custom fields derived from the user doc.
  *
  * @param {string|object} userDocOrUid - UID string (fetches from Firestore) or full user document object
- * @param {object} [options]
- * @param {Array<string>} [options.providers] - Which providers to sync to (default: all available)
  * @returns {{ sendgrid?: object, beehiiv?: object }}
  */
-Marketing.prototype.sync = async function (userDocOrUid, options) {
+Marketing.prototype.sync = async function (userDocOrUid) {
   const self = this;
   const assistant = self.assistant;
-  const { providers } = options || {};
 
   // Resolve UID to user doc if string
   let userDoc;
@@ -145,13 +146,9 @@ Marketing.prototype.sync = async function (userDocOrUid, options) {
     return {};
   }
 
-  const shouldSync = !assistant.isTesting() || process.env.TEST_EXTENDED_MODE;
-  const syncProviders = providers || DEFAULT_PROVIDERS;
-  const results = {};
-
-  if (!shouldSync) {
+  if (assistant.isTesting() && !process.env.TEST_EXTENDED_MODE) {
     assistant.log('Marketing.sync(): Skipping providers (testing mode)');
-    return results;
+    return {};
   }
 
   assistant.log('Marketing.sync():', { email });
@@ -159,9 +156,10 @@ Marketing.prototype.sync = async function (userDocOrUid, options) {
   const firstName = _.get(userDoc, 'personal.name.first');
   const lastName = _.get(userDoc, 'personal.name.last');
   const source = _.get(userDoc, 'attribution.utm.tags.utm_source');
+  const results = {};
   const promises = [];
 
-  if (syncProviders.includes('sendgrid') && process.env.SENDGRID_API_KEY) {
+  if (self.providers.sendgrid) {
     promises.push(
       sendgridProvider.buildFields(userDoc).then((customFields) =>
         sendgridProvider.addContact({
@@ -174,7 +172,7 @@ Marketing.prototype.sync = async function (userDocOrUid, options) {
     );
   }
 
-  if (syncProviders.includes('beehiiv') && process.env.BEEHIIV_API_KEY) {
+  if (self.providers.beehiiv) {
     promises.push(
       beehiivProvider.addContact({
         email,
@@ -194,38 +192,33 @@ Marketing.prototype.sync = async function (userDocOrUid, options) {
 };
 
 /**
- * Remove a contact from all providers.
+ * Remove a contact from all enabled providers.
  *
  * @param {string} email - Email address to remove
- * @param {object} [options]
- * @param {Array<string>} [options.providers] - Which providers to remove from (default: all available)
  * @returns {{ sendgrid?: object, beehiiv?: object }}
  */
-Marketing.prototype.remove = async function (email, options) {
+Marketing.prototype.remove = async function (email) {
   const self = this;
   const assistant = self.assistant;
-  const { providers } = options || {};
 
   if (!email) {
     assistant.warn('Marketing.remove(): No email provided, skipping');
     return {};
   }
 
-  const removeProviders = providers || DEFAULT_PROVIDERS;
-  const results = {};
-
   assistant.log('Marketing.remove():', { email });
 
+  const results = {};
   const promises = [];
 
-  if (removeProviders.includes('sendgrid') && process.env.SENDGRID_API_KEY) {
+  if (self.providers.sendgrid) {
     promises.push(
       sendgridProvider.removeContact(email)
         .then((r) => { results.sendgrid = r; })
     );
   }
 
-  if (removeProviders.includes('beehiiv') && process.env.BEEHIIV_API_KEY) {
+  if (self.providers.beehiiv) {
     promises.push(
       beehiivProvider.removeContact(email)
         .then((r) => { results.beehiiv = r; })
@@ -259,8 +252,8 @@ Marketing.prototype.sendCampaign = async function (settings) {
   const Manager = self.Manager;
   const assistant = self.assistant;
 
-  if (!process.env.SENDGRID_API_KEY) {
-    return { success: false, error: 'SENDGRID_API_KEY not set' };
+  if (!self.providers.sendgrid) {
+    return { success: false, error: 'SendGrid not enabled' };
   }
 
   const templateId = TEMPLATES[settings.template] || settings.template || TEMPLATES['default'];

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

@@ -136,7 +136,22 @@ async function removeSubscriber(email, publicationId) {
  * @param {string} brandName
  * @returns {string|null} Publication ID or null
  */
+let _publicationIdCache = null;
+
 async function getPublicationId() {
+  if (_publicationIdCache) {
+    return _publicationIdCache;
+  }
+
+  // Use publicationId from config if set (skips API call)
+  const configPubId = Manager.config?.marketing?.beehiiv?.publicationId;
+
+  if (configPubId) {
+    _publicationIdCache = configPubId;
+    return configPubId;
+  }
+
+  // Fuzzy-match by brand name
   const brandName = Manager.config.brand?.name;
 
   if (!brandName) {
@@ -168,6 +183,7 @@ async function getPublicationId() {
       );
 
       if (matchedPub) {
+        _publicationIdCache = matchedPub.id;
         return matchedPub.id;
       }
 

package/src/manager/routes/marketing/contact/delete.js

@@ -18,7 +18,6 @@ module.exports = async ({ assistant, Manager, settings, analytics }) => {
 
   // Extract parameters
   const email = (settings.email || '').trim().toLowerCase();
-  const providers = settings.providers;
 
   // Validate email is provided
   if (!email) {
@@ -27,7 +26,7 @@ module.exports = async ({ assistant, Manager, settings, analytics }) => {
 
   // Remove from providers
   const mailer = Manager.Email(assistant);
-  const providerResults = await mailer.remove(email, { providers });
+  const providerResults = await mailer.remove(email);
 
   // Log result
   assistant.log('marketing/contact delete result:', {

package/src/manager/routes/marketing/contact/post.js

@@ -5,7 +5,6 @@
 const recaptcha = require('../../../libraries/recaptcha.js');
 const { validate: validateEmail, ALL_CHECKS } = require('../../../libraries/email/validation.js');
 const { inferContact } = require('../../../libraries/infer-contact.js');
-const { DEFAULT_PROVIDERS } = require('../../../libraries/email/constants.js');
 
 module.exports = async ({ assistant, Manager, settings, analytics }) => {
 
@@ -23,7 +22,6 @@ module.exports = async ({ assistant, Manager, settings, analytics }) => {
 
   // Admin-only options
   const tags = isAdmin ? settings.tags : [];
-  const providers = isAdmin ? settings.providers : DEFAULT_PROVIDERS;
   const skipValidation = isAdmin ? settings.skipValidation : false;
 
   // Email validation — run free checks before reCAPTCHA/rate limit
@@ -105,7 +103,6 @@ module.exports = async ({ assistant, Manager, settings, analytics }) => {
       firstName,
       lastName,
       source,
-      providers,
     });
   }
 

package/src/manager/schemas/marketing/contact/delete.js

@@ -1,9 +1,6 @@
 /**
  * Schema for DELETE /marketing/contact
  */
-const { DEFAULT_PROVIDERS } = require('../../../libraries/email/constants.js');
-
 module.exports = () => ({
   email: { types: ['string'], default: undefined, required: true },
-  providers: { types: ['array'], default: DEFAULT_PROVIDERS },
 });

package/src/manager/schemas/marketing/contact/post.js

@@ -1,15 +1,12 @@
 /**
  * Schema for POST /marketing/contact
  */
-const { DEFAULT_PROVIDERS } = require('../../../libraries/email/constants.js');
-
 module.exports = () => ({
   email: { types: ['string'], default: undefined, required: true },
   firstName: { types: ['string'], default: '' },
   lastName: { types: ['string'], default: '' },
   source: { types: ['string'], default: 'unknown' },
   tags: { types: ['array'], default: [] },
-  providers: { types: ['array'], default: DEFAULT_PROVIDERS },
   skipValidation: { types: ['boolean'], default: false },
   'g-recaptcha-response': { types: ['string'], default: undefined },
 });

package/templates/backend-manager-config.json

@@ -122,6 +122,15 @@
       // Add more products/tiers here
     ],
   },
+  marketing: {
+    sendgrid: {
+      enabled: true,
+    },
+    beehiiv: {
+      enabled: false,
+      // publicationId: 'pub_xxxxx',  // Set to skip fuzzy-match API call
+    },
+  },
   firebaseConfig: {
     apiKey: '123-456',
     authDomain: 'PROJECT-ID.firebaseapp.com',

package/test/functions/general/add-marketing-contact.js

@@ -206,46 +206,7 @@ module.exports = {
       },
     },
 
-    // Test 7: Admin can specify providers
-    {
-      name: 'admin-specify-providers',
-      auth: 'admin',
-      timeout: 30000,
-
-      async run({ http, assert, config, state }) {
-        const testEmail = TEST_EMAILS.valid(config.domain);
-        state.testEmail = testEmail;
-
-        const response = await http.command('general:add-marketing-contact', {
-          email: testEmail,
-          source: 'bem-test',
-          providers: ['sendgrid'], // Only SendGrid, not Beehiiv
-          // No firstName/lastName - should be inferred as "Rachel Greene"
-        });
-
-        assert.isSuccess(response, 'Add marketing contact with specific providers should succeed');
-
-        // Only check providers if TEST_EXTENDED_MODE is set (external APIs are called)
-        if (process.env.TEST_EXTENDED_MODE) {
-          // Should only have sendgrid result
-          if (response.data?.providers) {
-            assert.hasProperty(response.data.providers, 'sendgrid', 'Should have SendGrid result');
-          }
-          state.sendgridAdded = response.data?.providers?.sendgrid?.success;
-          // Beehiiv not called since we only specified sendgrid
-        }
-      },
-
-      async cleanup({ state, http }) {
-        if (!process.env.TEST_EXTENDED_MODE || !state.testEmail) {
-          return;
-        }
-
-        await http.command('general:remove-marketing-contact', { email: state.testEmail });
-      },
-    },
-
-    // Test 8: Mailbox verification (only runs if TEST_EXTENDED_MODE and ZEROBOUNCE_API_KEY are set)
+    // Test 7: Mailbox verification (only runs if TEST_EXTENDED_MODE and ZEROBOUNCE_API_KEY are set)
     {
       name: 'mailbox-validation',
       auth: 'admin',

package/test/routes/marketing/contact.js

@@ -208,44 +208,7 @@ module.exports = {
       },
     },
 
-    // Test 7: Admin can specify providers
-    {
-      name: 'add-admin-specify-providers',
-      auth: 'admin',
-      timeout: 30000,
-
-      async run({ http, assert, config, state }) {
-        const testEmail = TEST_EMAILS.valid(config.domain);
-        state.testEmail = testEmail;
-
-        const response = await http.post('marketing/contact', {
-          email: testEmail,
-          source: 'bem-test',
-          providers: ['sendgrid'], // Only SendGrid, not Beehiiv
-          // No firstName/lastName - should be inferred as "Rachel Greene"
-        });
-
-        assert.isSuccess(response, 'Add marketing contact with specific providers should succeed');
-
-        // Provider calls only happen in extended mode
-        if (process.env.TEST_EXTENDED_MODE) {
-          // Should only have sendgrid result (since we specified providers: ['sendgrid'])
-          assert.hasProperty(response.data.providers, 'sendgrid', 'Should have SendGrid result');
-          state.sendgridAdded = response.data?.providers?.sendgrid?.success;
-          // Beehiiv not called since we only specified sendgrid
-        }
-      },
-
-      async cleanup({ state, http }) {
-        if (!process.env.TEST_EXTENDED_MODE || !state.testEmail) {
-          return;
-        }
-
-        await http.delete('marketing/contact', { email: state.testEmail });
-      },
-    },
-
-    // Test 8: Mailbox verification (only runs if TEST_EXTENDED_MODE and ZEROBOUNCE_API_KEY are set)
+    // Test 7: Mailbox verification (only runs if TEST_EXTENDED_MODE and ZEROBOUNCE_API_KEY are set)
     {
       name: 'add-mailbox-validation',
       auth: 'admin',