clarion-shared-types 1.0.110 → 1.0.112

package/dist/cjs/index.js

@@ -41,6 +41,7 @@ __exportStar(require("./modules/partner/index"), exports);
 __exportStar(require("./modules/support/index"), exports);
 __exportStar(require("./modules/safety/index"), exports);
 __exportStar(require("./modules/billing/index"), exports);
+__exportStar(require("./modules/newsfeed/index"), exports);
 // Interfaces
 __exportStar(require("./modules/common/interfaces/server-message"), exports);
 __exportStar(require("./modules/common/interfaces/pagination"), exports);

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,UAAU;AACV,uDAAqC;AACrC,+DAA6C;AAC7C,yDAAuC;AACvC,6DAA2C;AAC3C,uDAAqC;AACrC,uDAAqC;AACrC,iEAA+C;AAC/C,gEAA8C;AAC9C,2DAAyC;AACzC,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC;AACpC,sDAAoC;AACpC,yDAAuC;AACvC,mEAAiD;AACjD,+DAA6C;AAC7C,uDAAqC;AACrC,0DAAwC;AACxC,2DAAyC;AACzC,8DAA4C;AAC5C,iEAA+C;AAC/C,+DAA6C;AAC7C,0DAAwC;AACxC,0DAAwC;AACxC,yDAAuC;AACvC,0DAAwC;AAExC,aAAa;AACb,6EAA2D;AAC3D,yEAAuD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,UAAU;AACV,uDAAqC;AACrC,+DAA6C;AAC7C,yDAAuC;AACvC,6DAA2C;AAC3C,uDAAqC;AACrC,uDAAqC;AACrC,iEAA+C;AAC/C,gEAA8C;AAC9C,2DAAyC;AACzC,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC;AACpC,sDAAoC;AACpC,yDAAuC;AACvC,mEAAiD;AACjD,+DAA6C;AAC7C,uDAAqC;AACrC,0DAAwC;AACxC,2DAAyC;AACzC,8DAA4C;AAC5C,iEAA+C;AAC/C,+DAA6C;AAC7C,0DAAwC;AACxC,0DAAwC;AACxC,yDAAuC;AACvC,0DAAwC;AACxC,2DAAyC;AAEzC,aAAa;AACb,6EAA2D;AAC3D,yEAAuD"}

package/dist/cjs/modules/newsfeed/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Interfaces
+__exportStar(require("./interfaces/newsfeed-analytics"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/modules/newsfeed/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/newsfeed/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,aAAa;AACb,kEAAgD"}

package/dist/cjs/modules/newsfeed/interfaces/newsfeed-analytics.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Newsfeed analytics (the admin's Newsfeed Analytics): what an organization published
+ * to its members, and how the members responded - likes, comments, shares - when, how
+ * quickly, and to what kind of post.
+ *
+ * One read, computed by clarion-newsfeed from one consistent snapshot, so every number
+ * on a dashboard agrees with every other. Counts, durations and the organization's own
+ * posts only: never a member's name, never who liked, commented or shared.
+ *
+ * Posts are counted by when they were FIRST published (a post archived and published
+ * again counts once). Responses are counted by when they were made, whenever the post
+ * was published. A like that was taken back is gone (an unlike deletes it), so likes
+ * are the likes still standing - the ones taken back are counted separately, from the
+ * events the service emitted. Comments are every comment written, including any since
+ * hidden by a moderator or removed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=newsfeed-analytics.js.map

package/dist/cjs/modules/newsfeed/interfaces/newsfeed-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsfeed-analytics.js","sourceRoot":"","sources":["../../../../../src/modules/newsfeed/interfaces/newsfeed-analytics.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/cjs/modules/partner/index.js

@@ -24,6 +24,7 @@ __exportStar(require("./interfaces/partner-dispatch-progress.dto"), exports);
 __exportStar(require("./interfaces/partner-dispatch.dto"), exports);
 __exportStar(require("./interfaces/incident-partner-routing.dto"), exports);
 __exportStar(require("./interfaces/partner-membership.dto"), exports);
+__exportStar(require("./interfaces/partner-analytics"), exports);
 // Utilities
 __exportStar(require("./utils/partner-display.util"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/modules/partner/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/partner/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,wDAAsC;AAEtC,oBAAoB;AACpB,oEAAkD;AAClD,uEAAqD;AACrD,yEAAuD;AACvD,6EAA2D;AAC3D,oEAAkD;AAClD,4EAA0D;AAC1D,sEAAoD;AAEpD,YAAY;AACZ,+DAA6C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/partner/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,wDAAsC;AAEtC,oBAAoB;AACpB,oEAAkD;AAClD,uEAAqD;AACrD,yEAAuD;AACvD,6EAA2D;AAC3D,oEAAkD;AAClD,4EAA0D;AAC1D,sEAAoD;AACpD,iEAA+C;AAE/C,YAAY;AACZ,+DAA6C"}

package/dist/cjs/modules/partner/interfaces/partner-analytics.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Partner analytics (the admin's Partner Analytics): the partnerships an organization
+ * has with third-party responders, the emergencies routed to them and what became of
+ * each, how the partners' systems answered, and the subscribers registered with them.
+ *
+ * One read, computed by clarion-partner-services from one consistent snapshot, so every
+ * number on a dashboard agrees with every other. Counts, durations and the names an
+ * organization gave its own partnerships only: never a caller's name, a phone number,
+ * a member id, a payload or a partner's error text.
+ *
+ * Emergencies are counted by when they were ROUTED (the dispatch was raised) and shown
+ * as they stand now: a dispatch raised in the period and delivered after it counts as
+ * delivered. Partner calls and memberships are counted by when they happened.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=partner-analytics.js.map

package/dist/cjs/modules/partner/interfaces/partner-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partner-analytics.js","sourceRoot":"","sources":["../../../../../src/modules/partner/interfaces/partner-analytics.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG"}

package/dist/cjs/modules/permission/enums/permission-actions.enum.js

@@ -26,6 +26,12 @@ var PermissionActions;
     // allowed to read than a base URL and a coverage rule.
     PermissionActions["READ_PARTNER_MEMBERSHIP"] = "read:partner-membership";
     PermissionActions["MANAGE_PARTNER_MEMBERSHIP"] = "manage:partner-membership";
+    // Partner Analytics: the partnerships, the emergencies routed through them and
+    // what became of each, how the partners' systems answered, and the members
+    // registered with them - totals, rates and durations only, never a caller, a
+    // member id or a payload. Held by everybody who reads partnerships; scoped by
+    // clarion-partner-services to the caller's organization or control centre.
+    PermissionActions["READ_PARTNER_ANALYTICS"] = "read:partner-analytics";
     // Module: ControlCentre
     PermissionActions["CREATE_CONTROL_CENTRE"] = "create:control-centre";
     PermissionActions["READ_CONTROL_CENTRE"] = "read:control-centre";
@@ -210,6 +216,9 @@ var PermissionActions;
     PermissionActions["READ_NEWSFEED_FEED"] = "read:newsfeed-feed";
     PermissionActions["ENGAGE_NEWSFEED_POST"] = "engage:newsfeed-post";
     PermissionActions["MODERATE_NEWSFEED_COMMENT"] = "moderate:newsfeed-comment";
+    // Newsfeed Analytics: what was published and how the members responded - totals
+    // only. Held by everybody who reads the posts as staff do (read:newsfeed-post).
+    PermissionActions["READ_NEWSFEED_ANALYTICS"] = "read:newsfeed-analytics";
     // Module: Alert Intake
     // The channels the PUBLIC reaches an organization on without the app - its SMS
     // short code, WhatsApp number and mailbox (clarion-alerts) - configuring them, and

package/dist/cjs/modules/permission/enums/permission-actions.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"permission-actions.enum.js","sourceRoot":"","sources":["../../../../../src/modules/permission/enums/permission-actions.enum.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"permission-actions.enum.js","sourceRoot":"","sources":["../../../../../src/modules/permission/enums/permission-actions.enum.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -25,6 +25,7 @@ export * from './modules/partner/index';
 export * from './modules/support/index';
 export * from './modules/safety/index';
 export * from './modules/billing/index';
+export * from './modules/newsfeed/index';
 // Interfaces
 export * from './modules/common/interfaces/server-message';
 export * from './modules/common/interfaces/pagination';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AAExC,aAAa;AACb,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AAEzC,aAAa;AACb,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC"}

package/dist/esm/modules/newsfeed/index.js

@@ -0,0 +1,3 @@
+// Interfaces
+export * from './interfaces/newsfeed-analytics';
+//# sourceMappingURL=index.js.map

package/dist/esm/modules/newsfeed/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/newsfeed/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,cAAc,iCAAiC,CAAC"}

package/dist/esm/modules/newsfeed/interfaces/newsfeed-analytics.js

@@ -0,0 +1,18 @@
+/**
+ * Newsfeed analytics (the admin's Newsfeed Analytics): what an organization published
+ * to its members, and how the members responded - likes, comments, shares - when, how
+ * quickly, and to what kind of post.
+ *
+ * One read, computed by clarion-newsfeed from one consistent snapshot, so every number
+ * on a dashboard agrees with every other. Counts, durations and the organization's own
+ * posts only: never a member's name, never who liked, commented or shared.
+ *
+ * Posts are counted by when they were FIRST published (a post archived and published
+ * again counts once). Responses are counted by when they were made, whenever the post
+ * was published. A like that was taken back is gone (an unlike deletes it), so likes
+ * are the likes still standing - the ones taken back are counted separately, from the
+ * events the service emitted. Comments are every comment written, including any since
+ * hidden by a moderator or removed.
+ */
+export {};
+//# sourceMappingURL=newsfeed-analytics.js.map

package/dist/esm/modules/newsfeed/interfaces/newsfeed-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsfeed-analytics.js","sourceRoot":"","sources":["../../../../../src/modules/newsfeed/interfaces/newsfeed-analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/esm/modules/partner/index.js

@@ -8,6 +8,7 @@ export * from './interfaces/partner-dispatch-progress.dto';
 export * from './interfaces/partner-dispatch.dto';
 export * from './interfaces/incident-partner-routing.dto';
 export * from './interfaces/partner-membership.dto';
+export * from './interfaces/partner-analytics';
 // Utilities
 export * from './utils/partner-display.util';
 //# sourceMappingURL=index.js.map

package/dist/esm/modules/partner/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/partner/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,uBAAuB,CAAC;AAEtC,oBAAoB;AACpB,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qCAAqC,CAAC;AAEpD,YAAY;AACZ,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/partner/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,uBAAuB,CAAC;AAEtC,oBAAoB;AACpB,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAE/C,YAAY;AACZ,cAAc,8BAA8B,CAAC"}

package/dist/esm/modules/partner/interfaces/partner-analytics.js

@@ -0,0 +1,16 @@
+/**
+ * Partner analytics (the admin's Partner Analytics): the partnerships an organization
+ * has with third-party responders, the emergencies routed to them and what became of
+ * each, how the partners' systems answered, and the subscribers registered with them.
+ *
+ * One read, computed by clarion-partner-services from one consistent snapshot, so every
+ * number on a dashboard agrees with every other. Counts, durations and the names an
+ * organization gave its own partnerships only: never a caller's name, a phone number,
+ * a member id, a payload or a partner's error text.
+ *
+ * Emergencies are counted by when they were ROUTED (the dispatch was raised) and shown
+ * as they stand now: a dispatch raised in the period and delivered after it counts as
+ * delivered. Partner calls and memberships are counted by when they happened.
+ */
+export {};
+//# sourceMappingURL=partner-analytics.js.map

package/dist/esm/modules/partner/interfaces/partner-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partner-analytics.js","sourceRoot":"","sources":["../../../../../src/modules/partner/interfaces/partner-analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/esm/modules/permission/enums/permission-actions.enum.js

@@ -23,6 +23,12 @@ export var PermissionActions;
     // allowed to read than a base URL and a coverage rule.
     PermissionActions["READ_PARTNER_MEMBERSHIP"] = "read:partner-membership";
     PermissionActions["MANAGE_PARTNER_MEMBERSHIP"] = "manage:partner-membership";
+    // Partner Analytics: the partnerships, the emergencies routed through them and
+    // what became of each, how the partners' systems answered, and the members
+    // registered with them - totals, rates and durations only, never a caller, a
+    // member id or a payload. Held by everybody who reads partnerships; scoped by
+    // clarion-partner-services to the caller's organization or control centre.
+    PermissionActions["READ_PARTNER_ANALYTICS"] = "read:partner-analytics";
     // Module: ControlCentre
     PermissionActions["CREATE_CONTROL_CENTRE"] = "create:control-centre";
     PermissionActions["READ_CONTROL_CENTRE"] = "read:control-centre";
@@ -207,6 +213,9 @@ export var PermissionActions;
     PermissionActions["READ_NEWSFEED_FEED"] = "read:newsfeed-feed";
     PermissionActions["ENGAGE_NEWSFEED_POST"] = "engage:newsfeed-post";
     PermissionActions["MODERATE_NEWSFEED_COMMENT"] = "moderate:newsfeed-comment";
+    // Newsfeed Analytics: what was published and how the members responded - totals
+    // only. Held by everybody who reads the posts as staff do (read:newsfeed-post).
+    PermissionActions["READ_NEWSFEED_ANALYTICS"] = "read:newsfeed-analytics";
     // Module: Alert Intake
     // The channels the PUBLIC reaches an organization on without the app - its SMS
     // short code, WhatsApp number and mailbox (clarion-alerts) - configuring them, and

package/dist/esm/modules/permission/enums/permission-actions.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"permission-actions.enum.js","sourceRoot":"","sources":["../../../../../src/modules/permission/enums/permission-actions.enum.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"permission-actions.enum.js","sourceRoot":"","sources":["../../../../../src/modules/permission/enums/permission-actions.enum.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -24,5 +24,6 @@ export * from './modules/partner/index';
 export * from './modules/support/index';
 export * from './modules/safety/index';
 export * from './modules/billing/index';
+export * from './modules/newsfeed/index';
 export * from './modules/common/interfaces/server-message';
 export * from './modules/common/interfaces/pagination';

package/dist/types/modules/newsfeed/index.d.ts

@@ -0,0 +1 @@
+export * from './interfaces/newsfeed-analytics';

package/dist/types/modules/newsfeed/interfaces/newsfeed-analytics.d.ts

@@ -0,0 +1,324 @@
+/**
+ * Newsfeed analytics (the admin's Newsfeed Analytics): what an organization published
+ * to its members, and how the members responded - likes, comments, shares - when, how
+ * quickly, and to what kind of post.
+ *
+ * One read, computed by clarion-newsfeed from one consistent snapshot, so every number
+ * on a dashboard agrees with every other. Counts, durations and the organization's own
+ * posts only: never a member's name, never who liked, commented or shared.
+ *
+ * Posts are counted by when they were FIRST published (a post archived and published
+ * again counts once). Responses are counted by when they were made, whenever the post
+ * was published. A like that was taken back is gone (an unlike deletes it), so likes
+ * are the likes still standing - the ones taken back are counted separately, from the
+ * events the service emitted. Comments are every comment written, including any since
+ * hidden by a moderator or removed.
+ */
+/** How the period is cut into points for the charts. Chosen by the service from the length of the period. */
+export type NewsfeedAnalyticsBucket = 'hour' | 'day' | 'week' | 'month';
+export interface NewsfeedAnalyticsRange {
+    /** Inclusive, ISO 8601. The first post's creation when the period asked for was "forever". */
+    from: string;
+    /** Exclusive, ISO 8601. */
+    to: string;
+    bucket: NewsfeedAnalyticsBucket;
+    /** IANA time zone the buckets, the times of day and the hour-of-week grid are cut in. */
+    timeZone: string;
+}
+/** A count by a key (a status, a kind, a band), largest first unless the section says otherwise. */
+export interface NewsfeedAnalyticsCount<K extends string = string> {
+    key: K;
+    count: number;
+}
+/** Median and 90th percentile of one duration, in seconds; null when nothing was measured. */
+export interface NewsfeedAnalyticsDuration {
+    median: number | null;
+    p90: number | null;
+    /** How many were measured. */
+    count: number;
+}
+/** What was published in the period, and the feed as it stands now. */
+export interface NewsfeedAnalyticsPosts {
+    /** First published in the period. */
+    published: number;
+    /** Of those, written as a draft and published later (more than a minute after it was written). */
+    draftedFirst: number;
+    /** Of those, published the moment they were written. */
+    publishedStraightAway: number;
+    /** From written to published, for those drafted first. */
+    draftToPublish: NewsfeedAnalyticsDuration;
+    /** Written in the period, published or not. */
+    written: number;
+    /** Of those published in the period: with at least one image, with a video, with no media at all. */
+    withImages: number;
+    withVideo: number;
+    textOnly: number;
+    /** Images and videos attached to the posts published in the period. */
+    mediaItems: number;
+    /** Staff who published in the period. */
+    authors: number;
+    /** Of those published in the period: archived since, and deleted since. */
+    archivedSince: number;
+    deletedSince: number;
+    /** NOW, whatever the period: the posts members can see, drafts waiting, archived and deleted posts. */
+    liveNow: number;
+    draftsNow: number;
+    archivedNow: number;
+    deletedNow: number;
+    /** When the oldest draft still waiting was written; null when there is none. */
+    oldestDraftAt: string | null;
+    /** The last time anything was published - whatever the period. */
+    lastPublishedAt: string | null;
+    /** Every post now by where it stands: PUBLISHED, DRAFT, ARCHIVED, DELETED - zeros included. */
+    byStatus: NewsfeedAnalyticsCount[];
+    /** The posts published in the period by kind: TEXT, IMAGE (one), GALLERY (several), VIDEO - zeros included. */
+    byKind: NewsfeedAnalyticsCount[];
+}
+/** How the members responded in the period. */
+export interface NewsfeedAnalyticsEngagement {
+    /** Likes, comments and shares made in the period. */
+    total: number;
+    /** Likes made in the period and still standing. */
+    likes: number;
+    /** Likes taken back in the period - they are not in `likes`. */
+    unliked: number;
+    /** Comments written in the period, replies included. */
+    comments: number;
+    shares: number;
+    /** Members who responded at all - and who liked, commented, shared (a member can be all three). */
+    members: number;
+    likers: number;
+    commenters: number;
+    sharers: number;
+    /** Members whose first response to this feed, ever, was in the period. */
+    newMembers: number;
+    /** Members who responded to more than one post in the period. */
+    repeatMembers: number;
+    /** Posts that drew any response in the period, whenever they were published. */
+    postsResponded: number;
+    /** Of the posts published in the period: those that have drawn a response, by the end of the period. */
+    publishedResponded: number;
+    /** Responses drawn by the posts published in the period, by the end of the period. */
+    publishedResponses: number;
+    /** publishedResponses / posts published in the period; null when nothing was published. */
+    perPublishedPost: number | null;
+    /** From a post published in the period going out to its first like, comment or share. */
+    firstResponse: NewsfeedAnalyticsDuration;
+    /** Of the responses to the posts published in the period, the share made in each post's first 24 hours, as a percentage. */
+    firstDayShare: number | null;
+    /** The period's responses by how old the post was: H1 (first hour), H6, D1, D3, W1, M1, OLDER - in that order. */
+    byPostAge: NewsfeedAnalyticsCount[];
+    /** The posts published in the period by the responses they drew: NONE, 1-2, 3-5, 6-10, 11-25, 26+ - in that order. */
+    postsByResponses: NewsfeedAnalyticsCount[];
+    /** The members who responded, by how many times: 1, 2-3, 4-10, 11+ - in that order. */
+    membersByResponses: NewsfeedAnalyticsCount[];
+    /** The members who responded, by what they did: LIKED, COMMENTED or SHARED only, or SEVERAL. */
+    membersByKind: NewsfeedAnalyticsCount[];
+}
+/** The conversation under the posts. */
+export interface NewsfeedAnalyticsComments {
+    /** Written in the period. */
+    written: number;
+    /** Of those, replies to another comment. */
+    replies: number;
+    commenters: number;
+    /** Posts commented on in the period. */
+    postsDiscussed: number;
+    /** Of those written in the period, where they stand now: VISIBLE, HIDDEN by a moderator, REMOVED. */
+    visible: number;
+    hidden: number;
+    removed: number;
+    /** Every comment a moderator is holding back now, whenever it was written. */
+    hiddenNow: number;
+}
+/** Posts members passed on. */
+export interface NewsfeedAnalyticsShares {
+    shares: number;
+    sharers: number;
+    /** Posts shared in the period. */
+    postsShared: number;
+    /** Where the app says it went: WHATSAPP, SMS, EMAIL, SYSTEM_SHARE (the phone's share sheet), COPIED_LINK, OTHER. */
+    byTarget: NewsfeedAnalyticsCount[];
+    /**
+     * The app the phone's share sheet handed it to, when the phone said - an Android
+     * package such as `com.whatsapp` - or NOT_RECORDED. The ten most used.
+     */
+    byApp: NewsfeedAnalyticsCount[];
+}
+/** One group of the posts published in the period, and what they drew by the end of it. */
+export interface NewsfeedAnalyticsContentRow {
+    key: string;
+    posts: number;
+    /** Posts that drew at least one response. */
+    responded: number;
+    likes: number;
+    comments: number;
+    shares: number;
+}
+/** What draws a response: the posts published in the period, grouped four ways. */
+export interface NewsfeedAnalyticsContent {
+    /** TEXT, IMAGE, GALLERY, VIDEO - zeros included. */
+    byKind: NewsfeedAnalyticsContentRow[];
+    /** SHORT (under 280 characters), MEDIUM (280 to 999), LONG (1,000 and more) - zeros included. */
+    byLength: NewsfeedAnalyticsContentRow[];
+    /** When it went out, in `range.timeZone`: NIGHT (00-06), MORNING (06-12), AFTERNOON (12-18), EVENING (18-24) - zeros included. */
+    byDaypart: NewsfeedAnalyticsContentRow[];
+    /** TITLED or UNTITLED - zeros included. */
+    byTitle: NewsfeedAnalyticsContentRow[];
+}
+/** One kind of event the service handed on, and how that went. */
+export interface NewsfeedAnalyticsDeliveryType {
+    /** The event, e.g. newsfeed.post.published. */
+    type: string;
+    events: number;
+    delivered: number;
+    /** Failed and being retried, or given up on. */
+    failed: number;
+    /** Not handed on yet. */
+    waiting: number;
+    medianLagSeconds: number | null;
+}
+/**
+ * Behind the scenes: the events clarion-newsfeed handed to the platform about these
+ * posts in the period. A published post's event is what clarion-notification turns into
+ * the push members receive, so `announcements` is whether members were told.
+ */
+export interface NewsfeedAnalyticsDelivery {
+    events: number;
+    delivered: number;
+    /** Not handed on yet (pending or being sent). */
+    waiting: number;
+    /** Failed, and to be tried again. */
+    retrying: number;
+    /** Failed every attempt - nobody was told. */
+    gaveUp: number;
+    /** Delivered, but not at the first attempt. */
+    retried: number;
+    /** From the event being written to it being handed on - delivered ones. */
+    lag: NewsfeedAnalyticsDuration;
+    /** Published-post events: the push announcements. */
+    announcements: number;
+    announcementsDelivered: number;
+    byType: NewsfeedAnalyticsDeliveryType[];
+}
+/** One post: what it is, and how members responded - in the period, and in all by the end of it. */
+export interface NewsfeedAnalyticsPostRow {
+    id: number;
+    organizationId: number;
+    countryCode: string;
+    /** The title, or the opening of the text when it has none. */
+    title: string;
+    hasTitle: boolean;
+    /** PUBLISHED, DRAFT or ARCHIVED. */
+    status: string;
+    deleted: boolean;
+    /** TEXT, IMAGE, GALLERY or VIDEO. */
+    kind: string;
+    images: number;
+    videos: number;
+    publishedAt: string | null;
+    /** In the period. */
+    responses: number;
+    likes: number;
+    comments: number;
+    shares: number;
+    members: number;
+    /** In all, by the end of the period. */
+    totalLikes: number;
+    totalComments: number;
+    totalShares: number;
+    /** From publishing to its first response; null when it has none. */
+    firstResponseSeconds: number | null;
+}
+/** One country's posts. */
+export interface NewsfeedAnalyticsCountryRow {
+    countryCode: string;
+    published: number;
+    liveNow: number;
+    likes: number;
+    comments: number;
+    shares: number;
+    members: number;
+}
+/** A Super-Admin's view of every organization: one row each, busiest first. */
+export interface NewsfeedAnalyticsOrganizationRow {
+    organizationId: number;
+    published: number;
+    liveNow: number;
+    draftsNow: number;
+    likes: number;
+    comments: number;
+    shares: number;
+    members: number;
+    postsResponded: number;
+    /** Responses per post published in the period, by the end of it. */
+    perPublishedPost: number | null;
+    lastPublishedAt: string | null;
+}
+/** One point on the charts: a bucket of the period. */
+export interface NewsfeedAnalyticsPoint {
+    /** Local wall-clock start of the bucket, in `range.timeZone` (no offset). */
+    bucket: string;
+    published: number;
+    likes: number;
+    comments: number;
+    shares: number;
+    /** Likes taken back. */
+    unliked: number;
+    /** Members who responded in the bucket. */
+    members: number;
+}
+/** One hour of the week: the responses made in it, and the posts published in it. Weekday 1 is Monday. */
+export interface NewsfeedAnalyticsHeatCell {
+    weekday: number;
+    hour: number;
+    responses: number;
+    published: number;
+}
+/** The previous period of the same length, for the change on each headline figure. */
+export interface NewsfeedAnalyticsPrevious {
+    from: string;
+    to: string;
+    published: number;
+    likes: number;
+    unliked: number;
+    comments: number;
+    shares: number;
+    members: number;
+    newMembers: number;
+    postsResponded: number;
+    medianSecondsToFirstResponse: number | null;
+}
+export interface NewsfeedAnalytics {
+    /** Whose figures: one organization, or null for every organization. */
+    organizationId: number | null;
+    /** The one country the figures are narrowed to, or null for every country. */
+    countryCode: string | null;
+    range: NewsfeedAnalyticsRange;
+    generatedAt: string;
+    previous: NewsfeedAnalyticsPrevious | null;
+    /** The countries posts were written for, in scope and whatever country is chosen - for narrowing to one. */
+    countryOptions: NewsfeedAnalyticsCount[];
+    posts: NewsfeedAnalyticsPosts;
+    engagement: NewsfeedAnalyticsEngagement;
+    comments: NewsfeedAnalyticsComments;
+    shares: NewsfeedAnalyticsShares;
+    content: NewsfeedAnalyticsContent;
+    delivery: NewsfeedAnalyticsDelivery;
+    timeline: NewsfeedAnalyticsPoint[];
+    /** All 168 hours of the week, Monday first, zeros included. */
+    heatmap: NewsfeedAnalyticsHeatCell[];
+    /** Posts published in the period or responded to in it, most responses in the period first - at most 50. */
+    topPosts: NewsfeedAnalyticsPostRow[];
+    byCountry: NewsfeedAnalyticsCountryRow[];
+    /** A Super-Admin looking at every organization only. */
+    byOrganization?: NewsfeedAnalyticsOrganizationRow[];
+}
+/** What a dashboard asks: the period, one country - and, for a Super-Admin, whose figures. */
+export interface NewsfeedAnalyticsQuery {
+    from?: string;
+    to?: string;
+    timeZone?: string;
+    organizationId?: number;
+    countryCode?: string;
+}

package/dist/types/modules/partner/index.d.ts

@@ -6,4 +6,5 @@ export * from './interfaces/partner-dispatch-progress.dto';
 export * from './interfaces/partner-dispatch.dto';
 export * from './interfaces/incident-partner-routing.dto';
 export * from './interfaces/partner-membership.dto';
+export * from './interfaces/partner-analytics';
 export * from './utils/partner-display.util';

package/dist/types/modules/partner/interfaces/partner-analytics.d.ts

@@ -0,0 +1,378 @@
+/**
+ * Partner analytics (the admin's Partner Analytics): the partnerships an organization
+ * has with third-party responders, the emergencies routed to them and what became of
+ * each, how the partners' systems answered, and the subscribers registered with them.
+ *
+ * One read, computed by clarion-partner-services from one consistent snapshot, so every
+ * number on a dashboard agrees with every other. Counts, durations and the names an
+ * organization gave its own partnerships only: never a caller's name, a phone number,
+ * a member id, a payload or a partner's error text.
+ *
+ * Emergencies are counted by when they were ROUTED (the dispatch was raised) and shown
+ * as they stand now: a dispatch raised in the period and delivered after it counts as
+ * delivered. Partner calls and memberships are counted by when they happened.
+ */
+/** How the period is cut into points for the charts. Chosen by the service from the length of the period. */
+export type PartnerAnalyticsBucket = 'hour' | 'day' | 'week' | 'month';
+export interface PartnerAnalyticsRange {
+    /** Inclusive, ISO 8601. The first partnership's creation when the period asked for was "forever". */
+    from: string;
+    /** Exclusive, ISO 8601. */
+    to: string;
+    bucket: PartnerAnalyticsBucket;
+    /** IANA time zone the buckets and the hour-of-week grid are cut in. */
+    timeZone: string;
+}
+/** A count by a key (a status, a reason, a capability), largest first unless the section says otherwise. */
+export interface PartnerAnalyticsCount<K extends string = string> {
+    key: K;
+    count: number;
+}
+/** A partnership the dashboard can be narrowed to - every one in scope, whatever is being shown. */
+export interface PartnerAnalyticsPartnershipOption {
+    id: number;
+    organizationId: number;
+    name: string;
+    providerCode: string;
+    environment: string;
+    enabled: boolean;
+}
+/**
+ * The partnerships as configured now, and how each has been used in the period.
+ *
+ * Figures (`raised` onwards) are the period's; everything before them is the
+ * partnership's configuration and health as they stand now.
+ */
+export interface PartnerAnalyticsPartnershipRow {
+    integrationId: number;
+    organizationId: number;
+    /** Null: every control centre in the organization may route through it. */
+    controlCentreId: number | null;
+    name: string;
+    providerCode: string;
+    environment: string;
+    enabled: boolean;
+    /** AUTO, MANUAL or DISABLED. */
+    routingMode: string;
+    /** The last health check's verdict: HEALTHY, DEGRADED, UNREACHABLE or UNKNOWN. */
+    status: string;
+    capabilities: string[];
+    membershipEnabled: boolean;
+    requireCoverForDispatch: boolean;
+    countryCode: string;
+    coverageRules: number;
+    enabledCoverageRules: number;
+    lastSuccessAt: string | null;
+    lastErrorAt: string | null;
+    lastHealthCheckAt: string | null;
+    createdAt: string;
+    /** Emergencies routed to it in the period. */
+    raised: number;
+    /** Of those, reached the partner (sent at least once). */
+    delivered: number;
+    failed: number;
+    acknowledged: number;
+    /** delivered / (delivered + failed), as a percentage; null when nothing was attempted. */
+    deliveryRate: number | null;
+    medianSecondsToAcknowledge: number | null;
+    /** Calls made to the partner's system in the period, and those that failed. */
+    calls: number;
+    failedCalls: number;
+    /** Memberships registered and live now, and those waiting for a person to act. */
+    activeMembers: number;
+    membersNeedingAttention: number;
+}
+/** The partnerships in scope, as configured now. */
+export interface PartnerAnalyticsPartnerships {
+    total: number;
+    enabled: number;
+    disabled: number;
+    /** Routing modes of the ENABLED partnerships. */
+    autoRouting: number;
+    manualRouting: number;
+    routingOff: number;
+    production: number;
+    sandbox: number;
+    /** Health of the ENABLED partnerships. */
+    healthy: number;
+    degraded: number;
+    unreachable: number;
+    unknown: number;
+    membershipEnabled: number;
+    /** Withhold an emergency from the partner when the caller is not covered. */
+    coverGate: number;
+    coverageRules: number;
+    enabledCoverageRules: number;
+    byProvider: PartnerAnalyticsCount[];
+    /** Services bought, a partnership counted once under each of its capabilities. */
+    byCapability: PartnerAnalyticsCount[];
+    /** What the enabled coverage rules match on: ALL, INCIDENT_TYPE, INCIDENT_CATEGORY, EMERGENCY_TYPE. */
+    rulesByMatchType: PartnerAnalyticsCount[];
+    rows: PartnerAnalyticsPartnershipRow[];
+}
+/** Median and 90th percentile of one duration, in seconds; null when nothing was measured. */
+export interface PartnerAnalyticsDuration {
+    median: number | null;
+    p90: number | null;
+    /** How many were measured. */
+    count: number;
+}
+/** A row per routing mode: AUTO goes straight out; MANUAL waits for an operator to confirm it. */
+export interface PartnerAnalyticsModeRow {
+    mode: string;
+    raised: number;
+    delivered: number;
+    failed: number;
+    /** Rejected by an operator, or left to expire, or cancelled before it went. */
+    declined: number;
+}
+/** A row per partner: what it was sent and how it answered. */
+export interface PartnerAnalyticsProviderRow {
+    provider: string;
+    raised: number;
+    delivered: number;
+    failed: number;
+    acknowledged: number;
+    medianSecondsToAcknowledge: number | null;
+}
+/** Emergencies routed to partners in the period, as they stand now. */
+export interface PartnerAnalyticsDispatches {
+    /** Dispatches raised in the period - one per incident per partnership. */
+    raised: number;
+    /** Distinct incidents among them. */
+    incidents: number;
+    /** Reached the partner at least once (whatever became of them afterwards). */
+    delivered: number;
+    /** The partner assigned a responder - a crew or a vehicle is on it. */
+    acknowledged: number;
+    /** The partner closed it as done (a partner that never reports back never closes one). */
+    completed: number;
+    /** Could not be delivered: refused, or out of attempts. */
+    failed: number;
+    /** An operator declined to send it. */
+    rejected: number;
+    /** Nobody decided before the approval window closed. */
+    expired: number;
+    /** Stopped before it was sent. */
+    cancelled: number;
+    /** Stood down after it reached the partner. */
+    withdrawn: number;
+    /** Still waiting for an operator to confirm it, now. */
+    awaitingDecision: number;
+    /** Queued or being sent, now. */
+    inFlight: number;
+    /** delivered / (delivered + failed) - of the dispatches that were tried, the share that got through. */
+    deliveryRate: number | null;
+    /** acknowledged / delivered. */
+    acknowledgementRate: number | null;
+    /** completed / delivered. */
+    completionRate: number | null;
+    /** Delivered on the first attempt / delivered. */
+    firstAttemptRate: number | null;
+    /** Needed more than one attempt. */
+    retried: number;
+    /** Average attempts of the dispatches that were tried at all. */
+    averageAttempts: number | null;
+    timings: {
+        /** From routing to reaching the partner - for MANUAL, the operator's decision included. */
+        toSend: PartnerAnalyticsDuration;
+        /** From reaching the partner to the partner assigning a responder. */
+        toAcknowledge: PartnerAnalyticsDuration;
+        /** From reaching the partner to the partner closing it - completed ones only. */
+        toClose: PartnerAnalyticsDuration;
+        /** MANUAL only: from routing to an operator confirming or rejecting it. */
+        toDecide: PartnerAnalyticsDuration;
+    };
+    approvals: {
+        /** Dispatches routed in MANUAL mode. */
+        needed: number;
+        approved: number;
+        rejected: number;
+        expired: number;
+        /** Still waiting, now. */
+        waiting: number;
+        /** approved / (approved + rejected + expired). */
+        approvalRate: number | null;
+    };
+    /** Every status, in lifecycle order, zeros included. */
+    byStatus: PartnerAnalyticsCount[];
+    byMode: PartnerAnalyticsModeRow[];
+    byProvider: PartnerAnalyticsProviderRow[];
+    byCapability: PartnerAnalyticsCount[];
+    byCountry: PartnerAnalyticsCount[];
+    /** From the incident as it was routed. */
+    byEmergencyType: PartnerAnalyticsCount[];
+    byChannel: PartnerAnalyticsCount[];
+    byPriority: PartnerAnalyticsCount[];
+    /** Why the failed ones failed. */
+    failureReasons: PartnerAnalyticsCount[];
+    /**
+     * Whether the partner was told who the emergency was about: IDENTIFIED,
+     * COVERED_NOT_REGISTERED, NOT_COVERED, IDENTIFIER_REJECTED - or NOT_RECORDED for a
+     * dispatch made before this was kept.
+     */
+    memberIdentification: PartnerAnalyticsCount[];
+    /** The partner's own view, now: ACTIVE, CLOSED, UNKNOWN - or NONE when never heard. */
+    engagement: PartnerAnalyticsCount[];
+}
+/** Calls made to the partners' systems on the emergencies' behalf - sending, signing in, checking progress, standing down. */
+export interface PartnerAnalyticsCalls {
+    calls: number;
+    succeeded: number;
+    failed: number;
+    successRate: number | null;
+    medianMs: number | null;
+    p95Ms: number | null;
+    /** SEND (DISPATCH), AUTHENTICATE, FETCH_STATUS, WITHDRAW, AMEND, LOOKUP... */
+    byOperation: {
+        operation: string;
+        calls: number;
+        failed: number;
+        medianMs: number | null;
+        p95Ms: number | null;
+    }[];
+    /** 2xx, 3xx, 4xx, 5xx - or NO_RESPONSE when the partner never answered. */
+    byResponse: PartnerAnalyticsCount[];
+    failureReasons: PartnerAnalyticsCount[];
+}
+/** Subscribers registered with partners ahead of any emergency. */
+export interface PartnerAnalyticsMemberships {
+    /** Every membership in scope, now. */
+    total: number;
+    /** Registered, and the partner's cover has started and not ended. */
+    covered: number;
+    /** Registered, but the partner's cover has not started yet (a waiting period). */
+    waitingPeriod: number;
+    /** INCOMPLETE_PROFILE, NEEDS_REVIEW or FAILED: a person has to act. */
+    needsAttention: number;
+    /** Created in the period. */
+    created: number;
+    /** Given a member id by the partner in the period. */
+    provisioned: number;
+    /** From the membership being created to the partner issuing a member id - those provisioned in the period. */
+    medianHoursToProvision: number | null;
+    /** Every status, in lifecycle order, zeros included. */
+    byStatus: PartnerAnalyticsCount[];
+    /** The partner's standing for registered members: PENDING_ACTIVATION, ACTIVE, SUSPENDED, LAPSED, UNKNOWN. */
+    byMemberState: PartnerAnalyticsCount[];
+    /** INDIVIDUAL_SUBSCRIBER or CORPORATE_MEMBER. */
+    bySubjectType: PartnerAnalyticsCount[];
+    /** Why registrations failed or were stopped, now. */
+    failureReasons: PartnerAnalyticsCount[];
+    /** What stops incomplete profiles being sent: a field, and whether it is MISSING or MALFORMED. */
+    missingDetails: {
+        field: string;
+        problem: string;
+        count: number;
+    }[];
+    dependents: number;
+    /** Dependents the partner has accepted. */
+    dependentsAccepted: number;
+    /** No longer covered here, but the partner keeps them to the end of the term. */
+    pendingRemoval: number;
+    /** People who declined to give a detail a partner asks for - in the period, and ever. */
+    declined: number;
+    declinedTotal: number;
+    /** Partnerships whose partner has no memberships feature, and those it is currently rate limiting. */
+    unsupportedPartnerships: number;
+    throttledPartnerships: number;
+}
+/** One kind of incident routed to partners. Names are the organization's own taxonomy. */
+export interface PartnerAnalyticsIncidentTypeRow {
+    incidentTypeId: number | null;
+    name: string | null;
+    category: string | null;
+    raised: number;
+    delivered: number;
+    failed: number;
+    acknowledged: number;
+    medianSecondsToAcknowledge: number | null;
+}
+/** One point on the charts: a bucket of the period. */
+export interface PartnerAnalyticsPoint {
+    /** Local wall-clock start of the bucket, in `range.timeZone` (no offset). */
+    bucket: string;
+    /** Dispatches raised in the bucket, and what became of them. */
+    raised: number;
+    delivered: number;
+    failed: number;
+    /** Rejected, expired or cancelled. */
+    declined: number;
+    /** Still waiting or being sent, now. */
+    pending: number;
+    acknowledged: number;
+    /** Of the dispatches that reached the partner in the bucket. */
+    medianSecondsToAcknowledge: number | null;
+    calls: number;
+    failedCalls: number;
+    medianCallMs: number | null;
+    membershipsCreated: number;
+    membershipsProvisioned: number;
+}
+/** One hour of the week: emergencies routed in it. Weekday 1 is Monday. */
+export interface PartnerAnalyticsHeatCell {
+    weekday: number;
+    hour: number;
+    raised: number;
+}
+/** The previous period of the same length, for the change on each headline figure. */
+export interface PartnerAnalyticsPrevious {
+    from: string;
+    to: string;
+    raised: number;
+    delivered: number;
+    failed: number;
+    acknowledged: number;
+    completed: number;
+    declined: number;
+    medianSecondsToSend: number | null;
+    medianSecondsToAcknowledge: number | null;
+    calls: number;
+    failedCalls: number;
+    membershipsCreated: number;
+    membershipsProvisioned: number;
+}
+/** A Super-Admin's view of every organization: one row each, busiest first. */
+export interface PartnerAnalyticsOrganizationRow {
+    organizationId: number;
+    partnerships: number;
+    enabledPartnerships: number;
+    raised: number;
+    delivered: number;
+    failed: number;
+    deliveryRate: number | null;
+    activeMembers: number;
+    calls: number;
+    failedCalls: number;
+}
+export interface PartnerAnalytics {
+    /** Whose figures: one organization (and one control centre in it), or null for every organization. */
+    organizationId: number | null;
+    controlCentreId: number | null;
+    /** The one partnership the figures are narrowed to, or null for all of them. */
+    integrationId: number | null;
+    range: PartnerAnalyticsRange;
+    generatedAt: string;
+    previous: PartnerAnalyticsPrevious | null;
+    timeline: PartnerAnalyticsPoint[];
+    /** All 168 hours of the week, Monday first, zeros included. */
+    heatmap: PartnerAnalyticsHeatCell[];
+    /** Every partnership in scope, for narrowing the dashboard to one. */
+    partnershipOptions: PartnerAnalyticsPartnershipOption[];
+    partnerships: PartnerAnalyticsPartnerships;
+    dispatches: PartnerAnalyticsDispatches;
+    calls: PartnerAnalyticsCalls;
+    memberships: PartnerAnalyticsMemberships;
+    /** The kinds of incident routed, busiest first - at most 25. */
+    incidentTypes: PartnerAnalyticsIncidentTypeRow[];
+    /** A Super-Admin looking at every organization only. */
+    byOrganization?: PartnerAnalyticsOrganizationRow[];
+}
+/** What a dashboard asks: the period, one partnership - and, for a Super-Admin, whose figures. */
+export interface PartnerAnalyticsQuery {
+    from?: string;
+    to?: string;
+    timeZone?: string;
+    organizationId?: number;
+    integrationId?: number;
+}

package/dist/types/modules/permission/enums/permission-actions.enum.d.ts

@@ -14,6 +14,7 @@ export declare enum PermissionActions {
     RESEND_PARTNER_DISPATCH = "resend:partner-dispatch",
     READ_PARTNER_MEMBERSHIP = "read:partner-membership",
     MANAGE_PARTNER_MEMBERSHIP = "manage:partner-membership",
+    READ_PARTNER_ANALYTICS = "read:partner-analytics",
     CREATE_CONTROL_CENTRE = "create:control-centre",
     READ_CONTROL_CENTRE = "read:control-centre",
     UPDATE_CONTROL_CENTRE = "update:control-centre",
@@ -166,6 +167,7 @@ export declare enum PermissionActions {
     READ_NEWSFEED_FEED = "read:newsfeed-feed",
     ENGAGE_NEWSFEED_POST = "engage:newsfeed-post",
     MODERATE_NEWSFEED_COMMENT = "moderate:newsfeed-comment",
+    READ_NEWSFEED_ANALYTICS = "read:newsfeed-analytics",
     CREATE_ALERT_INTAKE_CONNECTION = "create:alert-intake-connection",
     READ_ALERT_INTAKE_CONNECTION = "read:alert-intake-connection",
     UPDATE_ALERT_INTAKE_CONNECTION = "update:alert-intake-connection",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clarion-shared-types",
-  "version": "1.0.110",
+  "version": "1.0.112",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",