ad2app-lib 1.10.0 → 1.11.0

package/package.json

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

package/src/types/scheduling/I_SchedulingAnalytics.test.ts

@@ -0,0 +1,39 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import {
+  ANALYTICS_SOURCES,
+  SchedulingAnalyticsKpiDTO,
+} from './I_SchedulingAnalytics';
+
+// AD2-1045 — the analytics partial-failure signal: a KPI response can name
+// which sources were unavailable so a swallowed Zernio failure is never
+// presented as real zeros.
+
+test('ANALYTICS_SOURCES names the four analytics sources', () => {
+  assert.deepEqual(
+    [...ANALYTICS_SOURCES],
+    ['daily-metrics', 'follower-stats', 'content-decay', 'top-posts'],
+  );
+});
+
+test('SchedulingAnalyticsKpiDTO carries failedSources when provided', () => {
+  const kpi = new SchedulingAnalyticsKpiDTO({
+    impressions: 10,
+    reach: 5,
+    engagementRate: 1.2,
+    followerGrowth: 3,
+    failedSources: ['follower-stats'],
+  });
+  assert.deepEqual(kpi.failedSources, ['follower-stats']);
+});
+
+test('failedSources is optional and absent by default (backward compatible)', () => {
+  const kpi = new SchedulingAnalyticsKpiDTO({
+    impressions: 10,
+    reach: 5,
+    engagementRate: 1.2,
+    followerGrowth: 3,
+  });
+  assert.equal(kpi.failedSources, undefined);
+  assert.equal('failedSources' in JSON.parse(JSON.stringify(kpi)), false);
+});

package/src/types/scheduling/I_SchedulingAnalytics.ts

@@ -5,6 +5,21 @@
  * per-post timeline snapshots, content decay windows, and follower stats.
  */
 
+// ── Analytics sources (AD2-1045) ──────────────────────────────────────────────
+
+/**
+ * The upstream sources an analytics response aggregates. Used by
+ * `failedSources` to name which of them were unavailable.
+ */
+export const ANALYTICS_SOURCES = [
+  'daily-metrics',
+  'follower-stats',
+  'content-decay',
+  'top-posts',
+] as const;
+
+export type AnalyticsSource = (typeof ANALYTICS_SOURCES)[number];
+
 // ── SchedulingAnalyticsKpiDTO ─────────────────────────────────────────────────
 
 /**
@@ -16,12 +31,22 @@ export class SchedulingAnalyticsKpiDTO {
   reach: 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[];
 
   constructor(data: SchedulingAnalyticsKpiDTO) {
     this.impressions = data.impressions;
     this.reach = data.reach;
     this.engagementRate = data.engagementRate;
     this.followerGrowth = data.followerGrowth;
+    if (data.failedSources !== undefined) {
+      this.failedSources = data.failedSources;
+    }
   }
 }
 
@@ -131,7 +156,11 @@ export class SchedulingPostTimelineEntryDTO {
  * Returned by GET /social/analytics/content-decay.
  */
 export 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;