ad2app-lib 1.39.0 → 1.40.0

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

@@ -62,3 +62,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

@@ -51,7 +51,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 +147,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ad2app-lib",
-  "version": "1.39.0",
+  "version": "1.40.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

@@ -152,3 +152,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);
+}