ad2app-lib 1.10.0 → 1.14.0

package/dist/publish-limits/index.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * 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.
+ *
+ * Provenance:
+ *  - Per-platform values are the CORRECTED figures from
+ *    ad2app-frontend/src/components/social/compose/platformConstants.ts
+ *    (PLATFORM_CONFIGS[*].charLimit / maxImages / maxVideos / acceptsVideo /
+ *    acceptsImages / metadata.mediaConstraints.maxVideoDuration).
+ *  - MAX_UPLOAD_BYTES matches ad2app-backend
+ *    src/modules/late/late-media-upload.service.ts MAX_FILE_SIZE_BYTES + FR-105.
+ *
+ * Wave 2 (separate PRs) makes ad2app-frontend and ad2app-backend import from
+ * here instead of carrying their own copies, and deletes the stale
+ * per-platform maxImageSize/maxVideoSize byte values that this table
+ * deliberately does NOT carry forward (they were never the real enforced
+ * cap — MAX_UPLOAD_BYTES is).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_PUBLISH_PLATFORMS = exports.PUBLISH_LIMITS = exports.MAX_UPLOAD_BYTES = void 0;
+/**
+ * The universal media-upload byte cap ad2app enforces on every publish,
+ * regardless of destination platform. This is ad2app's own operational
+ * choice (all media flows through the /late/uploadMedia path), NOT a
+ * per-platform maximum — do not read this as "what X/Instagram/etc. allow."
+ */
+exports.MAX_UPLOAD_BYTES = 500 * 1024 * 1024;
+/** Per-platform compose/publish limits for all 10 connectable platforms. */
+exports.PUBLISH_LIMITS = {
+    twitter: {
+        charLimit: 280,
+        maxImages: 4,
+        maxVideos: 1,
+        maxVideoDurationSec: 3600,
+        acceptsVideo: true,
+        acceptsImages: true,
+    },
+    instagram: {
+        charLimit: 2200,
+        maxImages: 10,
+        maxVideos: 1,
+        maxVideoDurationSec: 3600,
+        acceptsVideo: true,
+        acceptsImages: true,
+    },
+    tiktok: {
+        charLimit: 2200,
+        maxImages: 35,
+        maxVideos: 1,
+        maxVideoDurationSec: 600,
+        acceptsVideo: true,
+        acceptsImages: true,
+    },
+    linkedin: {
+        charLimit: 3000,
+        maxImages: 9,
+        maxVideos: 1,
+        maxVideoDurationSec: 3600,
+        acceptsVideo: true,
+        acceptsImages: true,
+    },
+    facebook: {
+        charLimit: 63206,
+        maxImages: 10,
+        maxVideos: 1,
+        maxVideoDurationSec: 3600,
+        acceptsVideo: true,
+        acceptsImages: true,
+    },
+    youtube: {
+        charLimit: 5000,
+        maxImages: 0,
+        maxVideos: 1,
+        maxVideoDurationSec: 43200,
+        acceptsVideo: true,
+        acceptsImages: false,
+    },
+    threads: {
+        charLimit: 500,
+        maxImages: 10,
+        maxVideos: 1,
+        maxVideoDurationSec: 300,
+        acceptsVideo: true,
+        acceptsImages: true,
+    },
+    reddit: {
+        charLimit: 40000,
+        maxImages: 20,
+        maxVideos: 1,
+        maxVideoDurationSec: 3600,
+        acceptsVideo: true,
+        acceptsImages: true,
+    },
+    pinterest: {
+        charLimit: 500,
+        maxImages: 1,
+        maxVideos: 1,
+        maxVideoDurationSec: 900,
+        acceptsVideo: true,
+        acceptsImages: true,
+    },
+    bluesky: {
+        charLimit: 300,
+        maxImages: 4,
+        maxVideos: 1,
+        maxVideoDurationSec: 60,
+        acceptsVideo: true,
+        acceptsImages: true,
+    },
+};
+/** All publish platforms, canonical order (mirrors PUBLISH_LIMITS key order). */
+exports.ALL_PUBLISH_PLATFORMS = Object.keys(exports.PUBLISH_LIMITS);

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

@@ -0,0 +1,26 @@
+/**
+ * Publish-limits domain — types.
+ *
+ * AD2-1140 Wave 1: canonicalizes the per-platform compose/publish limits that
+ * previously lived only as a hand-copied constant in ad2app-frontend
+ * (platformConstants.ts) plus the universal media-size cap enforced in
+ * ad2app-backend (late-media-upload.service.ts). Wave 2 makes both consumers
+ * import from here instead of carrying their own copies.
+ */
+/** The 10 platforms ad2app can publish to. Matches the frontend's SocialPlatform union. */
+export type PublishPlatform = 'twitter' | 'instagram' | 'tiktok' | 'linkedin' | 'facebook' | 'youtube' | 'threads' | 'reddit' | 'pinterest' | 'bluesky';
+/** Per-platform compose/publish limits (content, not file-size — see MAX_UPLOAD_BYTES for that). */
+export interface PlatformPublishLimits {
+    /** Max caption/body length in characters. */
+    charLimit: number;
+    /** Max still images per post (0 = platform does not accept images). */
+    maxImages: number;
+    /** Max videos per post (0 = platform does not accept video). */
+    maxVideos: number;
+    /** Max video duration in seconds. */
+    maxVideoDurationSec: number;
+    /** Whether the platform accepts video media at all. */
+    acceptsVideo: boolean;
+    /** Whether the platform accepts image media at all. */
+    acceptsImages: boolean;
+}

package/dist/publish-limits/types.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Publish-limits domain — types.
+ *
+ * AD2-1140 Wave 1: canonicalizes the per-platform compose/publish limits that
+ * previously lived only as a hand-copied constant in ad2app-frontend
+ * (platformConstants.ts) plus the universal media-size cap enforced in
+ * ad2app-backend (late-media-upload.service.ts). Wave 2 makes both consumers
+ * import from here instead of carrying their own copies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -4,6 +4,12 @@
  * Covers KPI summaries, daily engagement entries, best-time-to-post slots,
  * per-post timeline snapshots, content decay windows, and follower stats.
  */
+/**
+ * The upstream sources an analytics response aggregates. Used by
+ * `failedSources` to name which of them were unavailable.
+ */
+export declare const ANALYTICS_SOURCES: readonly ["daily-metrics", "follower-stats", "content-decay", "top-posts"];
+export type AnalyticsSource = (typeof ANALYTICS_SOURCES)[number];
 /**
  * Aggregated KPI figures for the selected date range.
  * Returned by GET /social/analytics.
@@ -11,8 +17,33 @@
 export declare class SchedulingAnalyticsKpiDTO {
     impressions: number;
     reach: number;
+    /** Total engagements (likes, comments, shares, saves) across all selected platforms. */
+    engagements: number;
+    /** Total video/media views across all selected platforms. */
+    views: number;
     engagementRate: number;
     followerGrowth: number;
+    /**
+     * Sources that were unavailable when this response was assembled
+     * (AD2-1045). Absent/empty = all sources healthy. When present, the
+     * numeric fields contain only data from the healthy sources — a partial
+     * outage must never read as real zeros.
+     */
+    failedSources?: AnalyticsSource[];
+    /**
+     * Structural availability of the impressions metric (AD2-1078) — distinct
+     * from `failedSources`, which is a transient per-fetch outage. False when
+     * the connected platform mix fundamentally does not expose impressions
+     * (e.g. Instagram Graph API v22+ dropped it): an honest "—" beats a fake
+     * 0, which reads as "zero people saw this". Absent/true = available.
+     */
+    impressionsAvailable?: boolean;
+    /**
+     * Structural availability of the reach metric (AD2-1078). False when the
+     * connected platform mix fundamentally never exposes reach (e.g. TikTok).
+     * Absent/true = available.
+     */
+    reachAvailable?: boolean;
     constructor(data: SchedulingAnalyticsKpiDTO);
 }
 /**
@@ -73,7 +104,11 @@ export declare class SchedulingPostTimelineEntryDTO {
  * Returned by GET /social/analytics/content-decay.
  */
 export declare class SchedulingContentDecayDTO {
-    window: '1h' | '6h' | '24h' | '7d';
+    /**
+     * Zernio now returns aggregate bucket labels (e.g. "0-6h", "6-12h"), not
+     * the old fixed windows — widened accordingly (AD2-1061, 2026-07-03).
+     */
+    window: string;
     platform: string;
     /** Percentage of peak engagement remaining at this window */
     pct: number;

package/dist/types/scheduling/I_SchedulingAnalytics.js

@@ -6,7 +6,18 @@
  * per-post timeline snapshots, content decay windows, and follower stats.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchedulingFollowerStatDTO = exports.SchedulingContentDecayDTO = exports.SchedulingPostTimelineEntryDTO = exports.SchedulingBestTimeSlotDTO = exports.SchedulingAnalyticsParamsDTO = exports.SchedulingAnalyticsEntryDTO = exports.SchedulingAnalyticsKpiDTO = void 0;
+exports.SchedulingFollowerStatDTO = exports.SchedulingContentDecayDTO = exports.SchedulingPostTimelineEntryDTO = exports.SchedulingBestTimeSlotDTO = exports.SchedulingAnalyticsParamsDTO = exports.SchedulingAnalyticsEntryDTO = exports.SchedulingAnalyticsKpiDTO = exports.ANALYTICS_SOURCES = void 0;
+// ── Analytics sources (AD2-1045) ──────────────────────────────────────────────
+/**
+ * The upstream sources an analytics response aggregates. Used by
+ * `failedSources` to name which of them were unavailable.
+ */
+exports.ANALYTICS_SOURCES = [
+    'daily-metrics',
+    'follower-stats',
+    'content-decay',
+    'top-posts',
+];
 // ── SchedulingAnalyticsKpiDTO ─────────────────────────────────────────────────
 /**
  * Aggregated KPI figures for the selected date range.
@@ -16,8 +27,19 @@ class SchedulingAnalyticsKpiDTO {
     constructor(data) {
         this.impressions = data.impressions;
         this.reach = data.reach;
+        this.engagements = data.engagements;
+        this.views = data.views;
         this.engagementRate = data.engagementRate;
         this.followerGrowth = data.followerGrowth;
+        if (data.failedSources !== undefined) {
+            this.failedSources = data.failedSources;
+        }
+        if (data.impressionsAvailable !== undefined) {
+            this.impressionsAvailable = data.impressionsAvailable;
+        }
+        if (data.reachAvailable !== undefined) {
+            this.reachAvailable = data.reachAvailable;
+        }
     }
 }
 exports.SchedulingAnalyticsKpiDTO = SchedulingAnalyticsKpiDTO;

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

@@ -44,6 +44,14 @@ export declare class SchedulingInboxCommentDTO {
     authorAvatarUrl?: string;
     text: string;
     createdAt: string;
+    /** Likes on the comment, verbatim from Zernio (AD2-1088). Absent, never backfilled to 0. */
+    likeCount?: number;
+    /** Replies count on the comment, verbatim from Zernio (AD2-1088). */
+    replyCount?: number;
+    /** True when OUR connected account authored it — the answered state (AD2-1088). */
+    isOwner?: boolean;
+    /** Parent comment id on nested replies (AD2-1088). Absent on top-level comments. */
+    parentId?: string;
     replies?: SchedulingInboxCommentDTO[];
     constructor(data: SchedulingInboxCommentDTO);
 }

package/dist/types/scheduling/I_SchedulingInbox.js

@@ -55,6 +55,10 @@ class SchedulingInboxCommentDTO {
         this.authorAvatarUrl = data.authorAvatarUrl;
         this.text = data.text;
         this.createdAt = data.createdAt;
+        this.likeCount = data.likeCount;
+        this.replyCount = data.replyCount;
+        this.isOwner = data.isOwner;
+        this.parentId = data.parentId;
         this.replies = data.replies;
     }
 }

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

@@ -37,8 +37,45 @@ export declare class SchedulingCreatePostDTO {
 export declare class SchedulingUpdatePostDTO {
     content?: string;
     scheduledAt?: string;
+    /**
+     * Per-platform targets for the edit patch (C2, AD2-1026) — the backend's
+     * `UpdatePostDTO` intersects this on top locally today; promoted here so
+     * the type ships from the lib instead of a local clone.
+     */
+    platforms?: SchedulingPlatformTargetDTO[];
+    /** Full media array for the edit patch (C2, AD2-1026), same shape as create. */
+    mediaItems?: SchedulingMediaItemDTO[];
     constructor(data?: Partial<SchedulingUpdatePostDTO>);
 }
+/**
+ * One media item on the edit-load response — verbatim from the live Zernio
+ * post's mediaItems (Post.mediaItems → MediaItem, OpenAPI v1.0.4:3223).
+ * Distinct from `SchedulingMediaItemDTO` (the create/update input shape):
+ * every field here is optional and `type` additionally allows `gif`/`document`
+ * to match what a fetched post can actually carry (T022b, AD2-1026).
+ */
+export declare class SchedulingPostMediaItemDTO {
+    type?: 'image' | 'video' | 'gif' | 'document';
+    url?: string;
+    title?: string;
+    constructor(data?: Partial<SchedulingPostMediaItemDTO>);
+}
+/**
+ * One per-platform target on the edit-load response — the request-shape
+ * subset of Zernio's PlatformTarget (OpenAPI v1.0.4:3275): `platform`,
+ * `accountId` (always normalized to the plain string id — Zernio expands it
+ * to an account object on fetched posts, yaml:3282), and
+ * `platformSpecificData` VERBATIM (yaml:3297, additionalProperties: true).
+ * Response-only fields (status, platformPostUrl, errors) are never exposed
+ * here — they already live on platformStatuses/postUrls/platformErrors
+ * (T022b, AD2-1026).
+ */
+export declare class SchedulingPostTargetDTO {
+    platform: string;
+    accountId?: string;
+    platformSpecificData?: Record<string, unknown>;
+    constructor(data?: Partial<SchedulingPostTargetDTO>);
+}
 /** Response DTO representing a single post returned from the API. */
 export declare class SchedulingPostDTO {
     id: string;
@@ -55,6 +92,25 @@ export declare class SchedulingPostDTO {
     contentSnippet?: string;
     createdAt: string;
     updatedAt: string;
+    /**
+     * Media-miniature pass-through fields (C1, AD2-1083) — present only when
+     * the cache row has a stored thumbnail/media URL, absent otherwise (never
+     * an empty string).
+     */
+    thumbnailUrl?: string;
+    mediaUrl?: string;
+    /**
+     * Edit-load fields for compose edit mode (C2, AD2-1026 + T022b):
+     * `content` is the COMPLETE caption (the cache only stores the 280-char
+     * `contentSnippet`); `mediaItems`/`platformTargets` are the full per-post
+     * media array and per-platform accountIds + compose settings. All three
+     * ride the live Zernio fetch: present when it succeeds (arrays may be
+     * possibly-empty = known-empty), ALL absent when it fails, which blocks
+     * edit frontend-side.
+     */
+    content?: string;
+    mediaItems?: SchedulingPostMediaItemDTO[];
+    platformTargets?: SchedulingPostTargetDTO[];
     constructor(data: SchedulingPostDTO);
 }
 /** Query parameters for listing posts with optional filters. */

package/dist/types/scheduling/I_SchedulingPost.js

@@ -6,7 +6,7 @@
  * and the media items attached to a post.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchedulingContentCalendarDTO = exports.SchedulingPostListParamsDTO = exports.SchedulingPostDTO = exports.SchedulingUpdatePostDTO = exports.SchedulingCreatePostDTO = exports.SchedulingMediaItemDTO = exports.SchedulingPlatformTargetDTO = exports.SchedulingPostStatus = void 0;
+exports.SchedulingContentCalendarDTO = exports.SchedulingPostListParamsDTO = exports.SchedulingPostDTO = exports.SchedulingPostTargetDTO = exports.SchedulingPostMediaItemDTO = exports.SchedulingUpdatePostDTO = exports.SchedulingCreatePostDTO = exports.SchedulingMediaItemDTO = exports.SchedulingPlatformTargetDTO = exports.SchedulingPostStatus = void 0;
 // ── Enums ─────────────────────────────────────────────────────────────────────
 var SchedulingPostStatus;
 (function (SchedulingPostStatus) {
@@ -60,9 +60,50 @@ class SchedulingUpdatePostDTO {
             return;
         this.content = data.content;
         this.scheduledAt = data.scheduledAt;
+        this.platforms = data.platforms;
+        this.mediaItems = data.mediaItems;
     }
 }
 exports.SchedulingUpdatePostDTO = SchedulingUpdatePostDTO;
+// ── SchedulingPostMediaItemDTO ────────────────────────────────────────────────
+/**
+ * One media item on the edit-load response — verbatim from the live Zernio
+ * post's mediaItems (Post.mediaItems → MediaItem, OpenAPI v1.0.4:3223).
+ * Distinct from `SchedulingMediaItemDTO` (the create/update input shape):
+ * every field here is optional and `type` additionally allows `gif`/`document`
+ * to match what a fetched post can actually carry (T022b, AD2-1026).
+ */
+class SchedulingPostMediaItemDTO {
+    constructor(data) {
+        if (!data)
+            return;
+        this.type = data.type;
+        this.url = data.url;
+        this.title = data.title;
+    }
+}
+exports.SchedulingPostMediaItemDTO = SchedulingPostMediaItemDTO;
+// ── SchedulingPostTargetDTO ───────────────────────────────────────────────────
+/**
+ * One per-platform target on the edit-load response — the request-shape
+ * subset of Zernio's PlatformTarget (OpenAPI v1.0.4:3275): `platform`,
+ * `accountId` (always normalized to the plain string id — Zernio expands it
+ * to an account object on fetched posts, yaml:3282), and
+ * `platformSpecificData` VERBATIM (yaml:3297, additionalProperties: true).
+ * Response-only fields (status, platformPostUrl, errors) are never exposed
+ * here — they already live on platformStatuses/postUrls/platformErrors
+ * (T022b, AD2-1026).
+ */
+class SchedulingPostTargetDTO {
+    constructor(data) {
+        if (!data)
+            return;
+        this.platform = data.platform;
+        this.accountId = data.accountId;
+        this.platformSpecificData = data.platformSpecificData;
+    }
+}
+exports.SchedulingPostTargetDTO = SchedulingPostTargetDTO;
 // ── SchedulingPostDTO ─────────────────────────────────────────────────────────
 /** Response DTO representing a single post returned from the API. */
 class SchedulingPostDTO {
@@ -79,6 +120,11 @@ class SchedulingPostDTO {
         this.contentSnippet = data.contentSnippet;
         this.createdAt = data.createdAt;
         this.updatedAt = data.updatedAt;
+        this.thumbnailUrl = data.thumbnailUrl;
+        this.mediaUrl = data.mediaUrl;
+        this.content = data.content;
+        this.mediaItems = data.mediaItems;
+        this.platformTargets = data.platformTargets;
     }
 }
 exports.SchedulingPostDTO = SchedulingPostDTO;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ad2app-lib",
-  "version": "1.10.0",
+  "version": "1.14.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "commonjs",
@@ -10,6 +10,7 @@
     "./api": "./dist/api/index.js",
     "./legal": "./dist/legal/index.js",
     "./analytics": "./dist/analytics/index.js",
+    "./publish-limits": "./dist/publish-limits/index.js",
     "./brand": "./brand/brand.mjs"
   },
   "typesVersions": {
@@ -29,6 +30,9 @@
       "analytics": [
         "dist/analytics/index.d.ts"
       ],
+      "publish-limits": [
+        "dist/publish-limits/index.d.ts"
+      ],
       "brand": [
         "brand/brand.d.ts"
       ],

package/src/legal/meta.ts

@@ -1,5 +1,5 @@
 export const LEGAL_META = {
-  lastUpdated: '10 June 2026',
+  lastUpdated: '6 July 2026',
   contactEmail: 'kontakt@ad2.app',
   controllerName: 'Ad2app sp. z o.o.',
   controllerAddress: 'ul. Juliana Smulikowskiego 4A/21, 00-389 Warszawa, Poland',