ad2app-lib 1.40.0 → 1.41.0

package/dist/publish-limits/index.d.ts

@@ -2,8 +2,11 @@
  * Canonical publish-limits source of truth for ad2app (AD2-1140 Wave 1).
  *
  * Single source of truth for (a) the per-platform compose/publish limits
- * (character count, image/video counts, max video duration) and (b) the
- * universal media-upload byte cap ad2app itself enforces.
+ * (character count, image/video counts, max video duration), (b) the
+ * universal media-upload byte cap ad2app itself enforces, and (c) which
+ * platforms a PUBLISHED post can be deleted from through our vendor
+ * (UNPUBLISHABLE_PLATFORMS / canUnpublish, ad2app-backend#303), kept here
+ * because it is the same kind of per-platform publishing capability.
  *
  * Provenance:
  *  - Per-platform values are the CORRECTED figures from

package/dist/publish-limits/index.js

@@ -3,8 +3,11 @@
  * Canonical publish-limits source of truth for ad2app (AD2-1140 Wave 1).
  *
  * Single source of truth for (a) the per-platform compose/publish limits
- * (character count, image/video counts, max video duration) and (b) the
- * universal media-upload byte cap ad2app itself enforces.
+ * (character count, image/video counts, max video duration), (b) the
+ * universal media-upload byte cap ad2app itself enforces, and (c) which
+ * platforms a PUBLISHED post can be deleted from through our vendor
+ * (UNPUBLISHABLE_PLATFORMS / canUnpublish, ad2app-backend#303), kept here
+ * because it is the same kind of per-platform publishing capability.
  *
  * Provenance:
  *  - Per-platform values are the CORRECTED figures from

package/dist/types/scheduling/I_SchedulingProUpgrade.d.ts

@@ -6,6 +6,17 @@
  */
 export type SchedulingSubscriptionTier = 'free' | 'starter' | 'pro';
 export type SchedulingSubscriptionStatus = 'active' | 'canceled' | 'expired';
+/**
+ * Constructor input. Takes `maxAccounts`, or the deprecated `maxPlatforms` so
+ * code written against 1.40.0 keeps compiling; either way both fields are set.
+ */
+export type SchedulingSubscriptionInfoInput = Pick<SchedulingSubscriptionInfoDTO, 'tier' | 'status' | 'expiresAt'> & ({
+    maxAccounts: number;
+    maxPlatforms?: number;
+} | {
+    /** @deprecated Pass `maxAccounts` (ad2app-backend#301). */
+    maxPlatforms: number;
+});
 /**
  * Current subscription state for the authenticated user.
  * Returned by GET /social/subscription.
@@ -14,8 +25,14 @@ export declare class SchedulingSubscriptionInfoDTO {
     tier: SchedulingSubscriptionTier;
     status: SchedulingSubscriptionStatus;
     expiresAt: string | null;
+    /** How many social accounts the plan lets the user connect (free 0, starter 4, pro 10). */
+    maxAccounts: number;
+    /**
+     * @deprecated The cap counts accounts, not platforms (ad2app-backend#301).
+     * Read `maxAccounts`. Always equal to it; removed in a later release.
+     */
     maxPlatforms: number;
-    constructor(data: SchedulingSubscriptionInfoDTO);
+    constructor(data: SchedulingSubscriptionInfoInput);
 }
 /**
  * Response DTO for POST /social/subscription/checkout.
@@ -38,6 +55,16 @@ export interface SchedulingPlanPriceDTO {
     amount: number;
     currency: string;
     interval: string;
+    /**
+     * How many social accounts the plan lets the user connect. Optional only so
+     * 1.40.0-era literals still compile and because a backend older than this
+     * release omits it; read `maxAccounts ?? maxPlatforms`.
+     */
+    maxAccounts?: number;
+    /**
+     * @deprecated The cap counts accounts, not platforms (ad2app-backend#301).
+     * Read `maxAccounts`. Always equal to it; removed in a later release.
+     */
     maxPlatforms: number;
 }
 export declare class SchedulingProductPricesDTO {

package/dist/types/scheduling/I_SchedulingProUpgrade.js

@@ -7,17 +7,18 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SchedulingProUpgradeDTO = exports.SchedulingProductPricesDTO = exports.SchedulingPortalSessionResultDTO = exports.SchedulingCheckoutSessionResultDTO = exports.SchedulingSubscriptionInfoDTO = void 0;
-// ── SchedulingSubscriptionInfoDTO ────────────────────────────────────────────
 /**
  * Current subscription state for the authenticated user.
  * Returned by GET /social/subscription.
  */
 class SchedulingSubscriptionInfoDTO {
     constructor(data) {
+        const maxAccounts = 'maxAccounts' in data ? data.maxAccounts : data.maxPlatforms;
         this.tier = data.tier;
         this.status = data.status;
         this.expiresAt = data.expiresAt;
-        this.maxPlatforms = data.maxPlatforms;
+        this.maxAccounts = maxAccounts;
+        this.maxPlatforms = maxAccounts;
     }
 }
 exports.SchedulingSubscriptionInfoDTO = SchedulingSubscriptionInfoDTO;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ad2app-lib",
-  "version": "1.40.0",
+  "version": "1.41.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "commonjs",

package/src/publish-limits/index.ts

@@ -2,8 +2,11 @@
  * Canonical publish-limits source of truth for ad2app (AD2-1140 Wave 1).
  *
  * Single source of truth for (a) the per-platform compose/publish limits
- * (character count, image/video counts, max video duration) and (b) the
- * universal media-upload byte cap ad2app itself enforces.
+ * (character count, image/video counts, max video duration), (b) the
+ * universal media-upload byte cap ad2app itself enforces, and (c) which
+ * platforms a PUBLISHED post can be deleted from through our vendor
+ * (UNPUBLISHABLE_PLATFORMS / canUnpublish, ad2app-backend#303), kept here
+ * because it is the same kind of per-platform publishing capability.
  *
  * Provenance:
  *  - Per-platform values are the CORRECTED figures from

package/src/types/scheduling/I_SchedulingProUpgrade.ts

@@ -15,6 +15,22 @@ export type SchedulingSubscriptionStatus = 'active' | 'canceled' | 'expired';
 
 // ── SchedulingSubscriptionInfoDTO ────────────────────────────────────────────
 
+/**
+ * Constructor input. Takes `maxAccounts`, or the deprecated `maxPlatforms` so
+ * code written against 1.40.0 keeps compiling; either way both fields are set.
+ */
+export type SchedulingSubscriptionInfoInput = Pick<
+  SchedulingSubscriptionInfoDTO,
+  'tier' | 'status' | 'expiresAt'
+> &
+  (
+    | { maxAccounts: number; maxPlatforms?: number }
+    | {
+        /** @deprecated Pass `maxAccounts` (ad2app-backend#301). */
+        maxPlatforms: number;
+      }
+  );
+
 /**
  * Current subscription state for the authenticated user.
  * Returned by GET /social/subscription.
@@ -23,13 +39,21 @@ export class SchedulingSubscriptionInfoDTO {
   tier: SchedulingSubscriptionTier;
   status: SchedulingSubscriptionStatus;
   expiresAt: string | null;
+  /** How many social accounts the plan lets the user connect (free 0, starter 4, pro 10). */
+  maxAccounts: number;
+  /**
+   * @deprecated The cap counts accounts, not platforms (ad2app-backend#301).
+   * Read `maxAccounts`. Always equal to it; removed in a later release.
+   */
   maxPlatforms: number;
 
-  constructor(data: SchedulingSubscriptionInfoDTO) {
+  constructor(data: SchedulingSubscriptionInfoInput) {
+    const maxAccounts = 'maxAccounts' in data ? data.maxAccounts : data.maxPlatforms;
     this.tier = data.tier;
     this.status = data.status;
     this.expiresAt = data.expiresAt;
-    this.maxPlatforms = data.maxPlatforms;
+    this.maxAccounts = maxAccounts;
+    this.maxPlatforms = maxAccounts;
   }
 }
 
@@ -68,6 +92,16 @@ export interface SchedulingPlanPriceDTO {
   amount: number;
   currency: string;
   interval: string;
+  /**
+   * How many social accounts the plan lets the user connect. Optional only so
+   * 1.40.0-era literals still compile and because a backend older than this
+   * release omits it; read `maxAccounts ?? maxPlatforms`.
+   */
+  maxAccounts?: number;
+  /**
+   * @deprecated The cap counts accounts, not platforms (ad2app-backend#301).
+   * Read `maxAccounts`. Always equal to it; removed in a later release.
+   */
   maxPlatforms: number;
 }
 

package/src/types/scheduling/subscription-allowance.test.ts

@@ -0,0 +1,75 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+
+import { SchedulingPlanPriceDTO, SchedulingSubscriptionInfoDTO } from './I_SchedulingProUpgrade';
+
+/**
+ * ad2app-backend#301 — the plan cap counts connected ACCOUNTS. `maxPlatforms`
+ * named the wrong unit on a public response, so `maxAccounts` replaces it and
+ * `maxPlatforms` stays, deprecated, with the identical value until readers
+ * (the MCP connector first) have moved.
+ */
+
+test('subscription info carries maxAccounts', () => {
+	const info = new SchedulingSubscriptionInfoDTO({
+		tier: 'starter',
+		status: 'active',
+		expiresAt: null,
+		maxAccounts: 4,
+	});
+
+	assert.equal(info.maxAccounts, 4);
+});
+
+test('the deprecated maxPlatforms always equals maxAccounts', () => {
+	const info = new SchedulingSubscriptionInfoDTO({
+		tier: 'pro',
+		status: 'active',
+		expiresAt: null,
+		maxAccounts: 10,
+	});
+
+	assert.equal(info.maxPlatforms, 10);
+});
+
+test('a plan price carries both fields', () => {
+	const price: SchedulingPlanPriceDTO = {
+		tier: 'starter',
+		amount: 1600,
+		currency: 'USD',
+		interval: 'month',
+		maxAccounts: 4,
+		maxPlatforms: 4,
+	};
+
+	assert.equal(price.maxAccounts, price.maxPlatforms);
+});
+
+/**
+ * 1.41.0 is a minor release. Code written against 1.40.0 still passes
+ * `maxPlatforms` and builds plan-price literals without `maxAccounts`; both
+ * must keep compiling (backend and frontend master do exactly this).
+ */
+test('the 1.40.0 constructor call still works and fills both fields', () => {
+	const info = new SchedulingSubscriptionInfoDTO({
+		tier: 'starter',
+		status: 'active',
+		expiresAt: null,
+		maxPlatforms: 4,
+	});
+
+	assert.equal(info.maxAccounts, 4);
+	assert.equal(info.maxPlatforms, 4);
+});
+
+test('a 1.40.0 plan-price literal without maxAccounts still type-checks', () => {
+	const price: SchedulingPlanPriceDTO = {
+		tier: 'pro',
+		amount: 3300,
+		currency: 'USD',
+		interval: 'month',
+		maxPlatforms: 10,
+	};
+
+	assert.equal(price.maxAccounts ?? price.maxPlatforms, 10);
+});