ad2app-lib 1.39.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
@@ -62,3 +65,16 @@ export declare const MAX_UPLOAD_BYTES: number;
 export declare const PUBLISH_LIMITS: Record<PublishPlatform, PlatformPublishLimits>;
 /** All publish platforms, canonical order (mirrors PUBLISH_LIMITS key order). */
 export declare const ALL_PUBLISH_PLATFORMS: PublishPlatform[];
+/**
+ * Platforms where an already-PUBLISHED post can be deleted through our vendor
+ * (ad2app-backend#303). Mirrors the `platform` enum of Zernio's
+ * POST /v1/posts/{postId}/unpublish (openapi 1.0.4), intersected with ours.
+ * Instagram and TikTok are absent because the vendor does not support them:
+ * a post published there stays live until the creator deletes it in that app.
+ *
+ * An allowlist on purpose: a platform nobody has checked reads as "stays live",
+ * which is the claim that cannot mislead a creator into thinking a post is gone.
+ */
+export declare const UNPUBLISHABLE_PLATFORMS: readonly PublishPlatform[];
+/** Whether a published post on `platform` can be deleted from the platform by ad2app. */
+export declare function canUnpublish(platform: string): boolean;

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
@@ -51,7 +54,8 @@
  * cap — MAX_UPLOAD_BYTES is).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ALL_PUBLISH_PLATFORMS = exports.PUBLISH_LIMITS = exports.MAX_UPLOAD_BYTES = void 0;
+exports.UNPUBLISHABLE_PLATFORMS = exports.ALL_PUBLISH_PLATFORMS = exports.PUBLISH_LIMITS = exports.MAX_UPLOAD_BYTES = void 0;
+exports.canUnpublish = canUnpublish;
 /**
  * The universal media-upload byte cap ad2app enforces on every publish,
  * regardless of destination platform. This is ad2app's own operational
@@ -146,3 +150,27 @@ exports.PUBLISH_LIMITS = {
 };
 /** All publish platforms, canonical order (mirrors PUBLISH_LIMITS key order). */
 exports.ALL_PUBLISH_PLATFORMS = Object.keys(exports.PUBLISH_LIMITS);
+/**
+ * Platforms where an already-PUBLISHED post can be deleted through our vendor
+ * (ad2app-backend#303). Mirrors the `platform` enum of Zernio's
+ * POST /v1/posts/{postId}/unpublish (openapi 1.0.4), intersected with ours.
+ * Instagram and TikTok are absent because the vendor does not support them:
+ * a post published there stays live until the creator deletes it in that app.
+ *
+ * An allowlist on purpose: a platform nobody has checked reads as "stays live",
+ * which is the claim that cannot mislead a creator into thinking a post is gone.
+ */
+exports.UNPUBLISHABLE_PLATFORMS = [
+    'twitter',
+    'linkedin',
+    'facebook',
+    'youtube',
+    'threads',
+    'reddit',
+    'pinterest',
+    'bluesky',
+];
+/** Whether a published post on `platform` can be deleted from the platform by ad2app. */
+function canUnpublish(platform) {
+    return exports.UNPUBLISHABLE_PLATFORMS.includes(platform);
+}

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.39.0",
+  "version": "1.41.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "commonjs",

package/src/publish-limits/index.test.ts

@@ -9,7 +9,13 @@
 import assert from 'node:assert/strict';
 import { test } from 'node:test';
 
-import { ALL_PUBLISH_PLATFORMS, MAX_UPLOAD_BYTES, PUBLISH_LIMITS } from './index';
+import {
+  ALL_PUBLISH_PLATFORMS,
+  canUnpublish,
+  MAX_UPLOAD_BYTES,
+  PUBLISH_LIMITS,
+  UNPUBLISHABLE_PLATFORMS,
+} from './index';
 import type { PublishPlatform } from './types';
 
 const EXPECTED_PLATFORMS: PublishPlatform[] = [
@@ -114,3 +120,22 @@ test('PlatformPublishLimits contract does not carry per-platform byte-size field
     ].sort(),
   );
 });
+
+test('canUnpublish: Instagram and TikTok published posts cannot be deleted by ad2app (backend#303)', () => {
+  assert.equal(canUnpublish('instagram'), false);
+  assert.equal(canUnpublish('tiktok'), false);
+  for (const platform of ALL_PUBLISH_PLATFORMS.filter((p) => p !== 'instagram' && p !== 'tiktok')) {
+    assert.equal(canUnpublish(platform), true, `${platform} should be unpublishable`);
+  }
+});
+
+test('canUnpublish: an unknown platform reads as not unpublishable', () => {
+  assert.equal(canUnpublish('snapchat'), false);
+  assert.equal(canUnpublish(''), false);
+});
+
+test('UNPUBLISHABLE_PLATFORMS only names platforms ad2app publishes to', () => {
+  for (const platform of UNPUBLISHABLE_PLATFORMS) {
+    assert.ok(platform in PUBLISH_LIMITS, `${platform} is not a publish platform`);
+  }
+});

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
@@ -152,3 +155,29 @@ export const PUBLISH_LIMITS: Record<PublishPlatform, PlatformPublishLimits> = {
 export const ALL_PUBLISH_PLATFORMS: PublishPlatform[] = Object.keys(
   PUBLISH_LIMITS,
 ) as PublishPlatform[];
+
+/**
+ * Platforms where an already-PUBLISHED post can be deleted through our vendor
+ * (ad2app-backend#303). Mirrors the `platform` enum of Zernio's
+ * POST /v1/posts/{postId}/unpublish (openapi 1.0.4), intersected with ours.
+ * Instagram and TikTok are absent because the vendor does not support them:
+ * a post published there stays live until the creator deletes it in that app.
+ *
+ * An allowlist on purpose: a platform nobody has checked reads as "stays live",
+ * which is the claim that cannot mislead a creator into thinking a post is gone.
+ */
+export const UNPUBLISHABLE_PLATFORMS: readonly PublishPlatform[] = [
+  'twitter',
+  'linkedin',
+  'facebook',
+  'youtube',
+  'threads',
+  'reddit',
+  'pinterest',
+  'bluesky',
+];
+
+/** Whether a published post on `platform` can be deleted from the platform by ad2app. */
+export function canUnpublish(platform: string): boolean {
+  return (UNPUBLISHABLE_PLATFORMS as readonly string[]).includes(platform);
+}

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);
+});