backend-manager 5.0.143 → 5.0.144

package/CHANGELOG.md

@@ -14,6 +14,15 @@ 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.144] - 2026-03-13
+### Added
+- `User.resolveSubscription()` static method that derives calculated subscription fields (plan, active, trialing, cancelling) from raw user data
+
+# [5.0.143] - 2026-03-13
+### Changed
+- `sendOrderEmail()` now accepts a `copy` parameter to control whether admin receives a copy (defaults to `true` for backward compat)
+- Abandoned cart reminder emails no longer send admin copies (`copy: false`) to reduce inbox noise
+
 # [5.0.140] - 2026-03-12
 ### Fixed
 - Chargebee meta_data backfill not including `orderId`, causing `getOrderId()` to fail on future webhooks

package/package.json

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

package/src/manager/helpers/user.js

@@ -345,4 +345,34 @@ function User(Manager, settings) {
   return self;
 }
 
+// Resolves calculated subscription fields that require derivation logic
+// Raw data (product.id, status, trial, cancellation) is on the user object directly
+// Returns: { plan, active, trialing, cancelling }
+// - plan: the plan ID the user effectively has access to RIGHT NOW ('basic' if cancelled/suspended)
+// - active: user has active access (active, trialing, or cancelling)
+// - trialing: user is in an active trial (status is 'active' but trial hasn't expired)
+// - cancelling: cancellation is pending (status is 'active' but cancellation.pending is true)
+User.resolveSubscription = function resolveSubscription(account) {
+  const subscription = (account?.subscription || account?.properties?.subscription) || {};
+  const productId = subscription.product?.id || 'basic';
+
+  let trialing = false;
+  let cancelling = false;
+
+  if (productId !== 'basic' && subscription.status === 'active') {
+    trialing = !!(subscription.trial?.claimed
+      && subscription.trial?.expires?.timestampUNIX > Math.floor(Date.now() / 1000));
+    cancelling = !trialing && !!subscription.cancellation?.pending;
+  }
+
+  const active = (productId !== 'basic' && subscription.status === 'active');
+
+  return {
+    plan: active ? productId : 'basic',
+    active,
+    trialing,
+    cancelling,
+  };
+};
+
 module.exports = User;