web-manager 4.1.23 → 4.1.24

package/CHANGELOG.md

@@ -14,6 +14,11 @@ 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.
 
+---
+## [4.1.24] - 2026-03-13
+### Added
+- Added `resolveSubscription()` method to Auth module that derives calculated subscription fields (plan, active, trialing, cancelling) from raw backend data.
+
 ---
 ## [4.1.22] - 2026-03-11
 ### Changed

package/dist/modules/auth.js

@@ -218,6 +218,37 @@ class Auth {
     });
   }
 
+  // Resolves calculated subscription fields that require derivation logic
+  // Raw data (product.id, status, trial, cancellation) is on account.subscription 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 (backend status is 'active' but trial hasn't expired)
+  // - cancelling: cancellation is pending (backend status is 'active' but cancellation.pending is true)
+  resolveSubscription(account) {
+    const subscription = (account || this.manager.storage().get('auth', {})?.account)?.subscription || {};
+    const productId = subscription.product?.id || 'basic';
+
+    // Derive trial and cancelling states from raw backend data
+    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,
+    };
+  }
+
   // Get ID token for the current user
   async getIdToken(forceRefresh = false) {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web-manager",
-  "version": "4.1.23",
+  "version": "4.1.24",
   "description": "Easily access important variables such as the query string, current domain, and current page in a single object.",
   "main": "dist/index.js",
   "module": "src/index.js",