@streamlayer/sl-eslib 5.248.0 → 5.249.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamlayer/sl-eslib",
-  "version": "5.248.0",
+  "version": "5.249.0",
   "publishConfig": {
     "access": "public"
   },

package/streamlayer/analytics/v2/studio/dashboard_pb.d.ts

@@ -2315,6 +2315,26 @@ export declare type AdDetailsResponse_AdDetailsResponseMeta = Message<"streamlay
 export declare const AdDetailsResponse_AdDetailsResponseMetaSchema: GenMessage<AdDetailsResponse_AdDetailsResponseMeta>;
 
 /**
+ * External Ad totals (currently scoped to EXPOSED_PAUSED_AD topicType=14; the same handler
+ * covers any future external-ad topicType — it scans an "external ad" metric pipeline distinct
+ * from the poll/video/display metrics served by AdTotal).
+ *
+ * Contract: backend aggregates over the event_ids the caller provides. It does NOT resolve
+ * "which events a template/card is currently attached to" — that lookup belongs on the frontend
+ * (templates service / cards-events relation in PG). The frontend builds event_ids before calling.
+ *
+ * Two UI contexts use this same RPC:
+ *   - Modules/Library (template view, SLW-6925 scenario 1): FE resolves the list of currently
+ *     attached event_ids and passes them. If the template is attached to 0 events — FE renders
+ *     zeros locally and does NOT call this RPC (no events ⇒ no analytics by definition).
+ *   - Local event (SLW-6925 scenario 2): FE passes event_ids=[currentEventId].
+ *
+ * Aggregation is SQL-level: sumIf for counts, uniqCombinedMergeIf for Reach (deduplicates
+ * unique devices across events — no double-counting), rates (CTR, fill rate, interaction rate)
+ * are computed from aggregated totals, not averaged per event. Detach is handled naturally:
+ * when an event is unbound from a template, FE re-resolves the list and the next call sees
+ * a smaller event_ids array — the unbound event's metrics drop out of the result.
+ *
  * @generated from message streamlayer.analytics.v2.studio.AdPauseTotalRequestFilter
  */
 export declare type AdPauseTotalRequestFilter = Message<"streamlayer.analytics.v2.studio.AdPauseTotalRequestFilter"> & {
@@ -2324,14 +2344,14 @@ export declare type AdPauseTotalRequestFilter = Message<"streamlayer.analytics.v
   organizationId?: string;
 
   /**
-   * required (minItems=1)
+   * required (minItems=1); FE resolves list of currently-attached events for templates view
    *
    * @generated from field: repeated uint64 event_ids = 2;
    */
   eventIds: bigint[];
 
   /**
-   * question ids
+   * card / template ids
    *
    * @generated from field: repeated string topic_ids = 3;
    */