backend-manager 5.0.159 → 5.0.161

package/CHANGELOG.md

@@ -14,6 +14,21 @@ 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.161] - 2026-03-18
+### Added
+- Port conflict detection in `serve` command — checks and kills blocking processes before starting Firebase server
+
+### Changed
+- Unblocked common team/role email local parts (`user`, `email`, `mail`, `hello`, `info`, `admin`, `support`, `contact`) from validation blocklist, as these are legitimate addresses
+
+# [5.0.160] - 2026-03-18
+### Added
+- Beehiiv `resolveSegmentIds()` — fetches segments from API, builds name→ID cache (same pattern as SendGrid)
+- Beehiiv segment resolution in `sendCampaign()` — SSOT keys auto-translate to Beehiiv segment IDs
+
+### Changed
+- Beehiiv `createPost()` now receives resolved segment IDs instead of raw SSOT keys
+
 # [5.0.159] - 2026-03-18
 ### Added
 - Audience-specific email discount codes: `UPGRADE15`, `COMEBACK20`, `MISSYOU25`, `TRYAGAIN10` with eligibility validation per user

package/package.json

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

package/src/cli/commands/serve.js

@@ -11,6 +11,12 @@ class ServeCommand extends BaseCommand {
     const port = self.argv.port || self.argv?._?.[1] || '5000';
     const projectDir = self.firebaseProjectPath;
 
+    // Check for port conflicts before starting server
+    const canProceed = await this.checkAndKillBlockingProcesses({ serving: parseInt(port, 10) });
+    if (!canProceed) {
+      throw new Error('Port conflicts could not be resolved');
+    }
+
     // Start BEM watcher in background
     const watcher = new WatchCommand(self);
     watcher.startBackground();

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

@@ -317,7 +317,14 @@ Marketing.prototype.sendCampaign = async function (settings) {
     };
   }
 
-  // Beehiiv: segment resolution will go here when Beehiiv segments are supported
+  if (useProviders.includes('beehiiv') && self.providers.beehiiv) {
+    const segmentIdMap = await beehiivProvider.resolveSegmentIds();
+
+    resolvedSegments.beehiiv = {
+      segments: (resolvedSettings.segments || []).map(key => segmentIdMap[key] || key).filter(Boolean),
+      excludeSegments: (resolvedSettings.excludeSegments || []).map(key => segmentIdMap[key] || key).filter(Boolean),
+    };
+  }
 
   assistant.log('Marketing.sendCampaign():', {
     name: resolvedSettings.name,
@@ -349,8 +356,8 @@ Marketing.prototype.sendCampaign = async function (settings) {
         preheader: resolvedSettings.preheader,
         content: contentHtml,
         sendAt: settings.sendAt,
-        segments: settings.segments,
-        excludeSegments: settings.excludeSegments,
+        segments: resolvedSegments.beehiiv?.segments || [],
+        excludeSegments: resolvedSegments.beehiiv?.excludeSegments || [],
       })
         .then((r) => { results.beehiiv = r; })
         .catch((e) => { results.beehiiv = { success: false, error: e.message }; })

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

@@ -274,6 +274,47 @@ function buildFields(userDoc) {
   return fields;
 }
 
+// Cached segment name → Beehiiv segment ID map
+let _segmentIdCache = null;
+
+/**
+ * Fetch segment definitions from Beehiiv and build a name → id map.
+ * Segments are created by OMEGA with names matching the SSOT keys in constants.js.
+ * Cached in memory for the lifetime of the process.
+ *
+ * @returns {object} Map of segment name → Beehiiv segment ID
+ */
+async function resolveSegmentIds() {
+  if (_segmentIdCache) {
+    return _segmentIdCache;
+  }
+
+  const publicationId = await getPublicationId();
+
+  if (!publicationId) {
+    return {};
+  }
+
+  try {
+    const data = await fetch(`${BASE_URL}/publications/${publicationId}/segments?limit=100`, {
+      response: 'json',
+      headers: headers(),
+      timeout: 10000,
+    });
+
+    _segmentIdCache = {};
+
+    for (const segment of (data.data || [])) {
+      _segmentIdCache[segment.name] = segment.id;
+    }
+
+    return _segmentIdCache;
+  } catch (e) {
+    console.error('Beehiiv resolveSegmentIds error:', e);
+    return {};
+  }
+}
+
 // --- Campaigns (Posts) ---
 
 /**
@@ -362,6 +403,9 @@ async function createPost(options) {
 }
 
 module.exports = {
+  // Resolution
+  resolveSegmentIds,
+
   // Contacts
   addContact,
   removeContact,

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

@@ -37,10 +37,12 @@ const BLOCKED_LOCAL_PARTS = new Set([
   'asdf', 'qwerty', 'zxcv', 'asd', 'qwe',
   'aaa', 'bbb', 'xxx', 'zzz',
   'abc', 'abc123', 'abcdef',
+  // Team
+  // 'user', 'email', 'mail', 'hello', 'info',
+  // 'admin', 'administrator', 'support',
+  // 'contact',
   // Placeholder
-  'user', 'email', 'mail', 'hello', 'info',
-  'admin', 'administrator', 'support',
-  'contact', 'name', 'firstname', 'lastname',
+  'name', 'firstname', 'lastname',
   'foo', 'bar', 'baz', 'foobar',
   'null', 'undefined', 'none', 'anonymous',
 ]);