clarion-shared-types 1.0.113 → 1.0.114

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

@@ -25,6 +25,7 @@ __exportStar(require("./interfaces/chat-conversation-with-participants"), export
 __exportStar(require("./interfaces/chat-message"), exports);
 __exportStar(require("./interfaces/chat-participant"), exports);
 __exportStar(require("./interfaces/chat-presence-info"), exports);
+__exportStar(require("./interfaces/chat-analytics"), exports);
 // constants
 __exportStar(require("./constants/chat-ws-events"), exports);
 __exportStar(require("./constants/chat-room-names"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/chat/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,wEAAsD;AACtD,sEAAoD;AACpD,iEAA+C;AAC/C,qEAAmD;AAEnD,aAAa;AACb,iEAA+C;AAC/C,mFAAiE;AACjE,4DAA0C;AAC1C,gEAA8C;AAC9C,kEAAgD;AAEhD,YAAY;AACZ,6DAA2C;AAC3C,8DAA4C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/chat/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,wEAAsD;AACtD,sEAAoD;AACpD,iEAA+C;AAC/C,qEAAmD;AAEnD,aAAa;AACb,iEAA+C;AAC/C,mFAAiE;AACjE,4DAA0C;AAC1C,gEAA8C;AAC9C,kEAAgD;AAChD,8DAA4C;AAE5C,YAAY;AACZ,6DAA2C;AAC3C,8DAA4C"}

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

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Chat analytics (the admin's Chat Analytics): how the conversations on Clarion went over
+ * a period - incident chats, Follow Me chats and direct chats - how much was written and
+ * by whom, and above all how quickly a member who wrote was answered.
+ *
+ * One read, computed by clarion-chat from one consistent snapshot, with who each person
+ * is from clarion-authentication. Counts, rates and durations only: never a message, a
+ * member's name or a trip's label. The only people named are STAFF - the control room,
+ * responders and administrators - as agents are on the support analytics.
+ *
+ * DURATIONS ARE IN SECONDS, like every analytics contract.
+ *
+ * How it is counted:
+ *  - A conversation belongs to the organization, control centre and country of the
+ *    person who STARTED it: the member who raised the SOS, the traveller on a Follow Me
+ *    trip, the administrator who opened a direct chat. clarion-chat keeps no organization
+ *    of its own. Everything written in a conversation is its organization's, whoever
+ *    wrote it - a guardian, or a responder from another organization.
+ *  - What a conversation is for (`ChatAnalyticsContext`): INCIDENT is an incident's chat,
+ *    including a Follow Me chat that an SOS adopted; FOLLOW_ME a trip's; DIRECT one person
+ *    to another; GROUP any other group.
+ *  - Who writes (`ChatAnalyticsSenderKind`), from the roles a person holds NOW: anybody
+ *    with a control-centre role is the CONTROL_ROOM, then RESPONDER, then ADMINISTRATOR
+ *    (organization roles, Super-Admin) - together, STAFF. Everybody else is a MEMBER: the
+ *    people the service is for, their guardians included. UNKNOWN is an account that no
+ *    longer exists. Whoever started an incident's or a Follow Me chat from the app is its
+ *    MEMBER there, whatever else they hold - staff raise SOSes too.
+ *  - A member's TURN starts with a member's message that opens a conversation or follows
+ *    a staff message. It is ANSWERED by the first staff message after it, and the wait is
+ *    the time between. Turns started in the period, answered whenever.
+ *  - System messages are counted on their own and never take part in a turn.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=chat-analytics.js.map

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

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

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

@@ -54,6 +54,9 @@ var PermissionActions;
     PermissionActions["READ_INCIDENT"] = "read:incident";
     PermissionActions["UPDATE_INCIDENT"] = "update:incident";
     PermissionActions["DELETE_INCIDENT"] = "delete:incident";
+    // Chat Analytics: how the chats went and how quickly members were answered - totals
+    // only. Held by exactly the roles that read the user analytics.
+    PermissionActions["READ_CHAT_ANALYTICS"] = "read:chat-analytics";
     PermissionActions["CREATE_INCIDENT_CATEGORY_TYPE"] = "create:incident-category-type";
     PermissionActions["READ_INCIDENT_CATEGORY_TYPE"] = "read:incident-category-type";
     PermissionActions["UPDATE_INCIDENT_CATEGORY_TYPE"] = "update:incident-category-type";

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":";;;AAAA,IAAY,iBAmSX;AAnSD,WAAY,iBAAiB;IACzB,uBAAuB;IACvB,gEAA2C,CAAA;IAC3C,4DAAuC,CAAA;IACvC,gEAA2C,CAAA;IAC3C,gEAA2C,CAAA;IAE3C,kBAAkB;IAClB,sDAAiC,CAAA;IACjC,kDAA6B,CAAA;IAC7B,sDAAiC,CAAA;IACjC,sDAAiC,CAAA;IACjC,wEAAwE;IACxE,mEAAmE;IACnE,oEAA+C,CAAA;IAC/C,0EAAqD,CAAA;IACrD,wEAAmD,CAAA;IACnD,wEAAmD,CAAA;IACnD,wEAAmD,CAAA;IACnD,2EAA2E;IAC3E,4EAA4E;IAC5E,qEAAqE;IACrE,uDAAuD;IACvD,wEAAmD,CAAA;IACnD,4EAAuD,CAAA;IACvD,+EAA+E;IAC/E,2EAA2E;IAC3E,6EAA6E;IAC7E,8EAA8E;IAC9E,2EAA2E;IAC3E,sEAAiD,CAAA;IAEjD,wBAAwB;IACxB,oEAA+C,CAAA;IAC/C,gEAA2C,CAAA;IAC3C,oEAA+C,CAAA;IAC/C,oEAA+C,CAAA;IAE/C,eAAe;IACf,gDAA2B,CAAA;IAC3B,4CAAuB,CAAA;IACvB,gDAA2B,CAAA;IAC3B,gDAA2B,CAAA;IAE3B,eAAe;IACf,gDAA2B,CAAA;IAC3B,4CAAuB,CAAA;IACvB,gDAA2B,CAAA;IAC3B,gDAA2B,CAAA;IAC3B,4GAA4G;IAC5G,gEAA2C,CAAA;IAE3C,mBAAmB;IACnB,wDAAmC,CAAA;IACnC,oDAA+B,CAAA;IAC/B,wDAAmC,CAAA;IACnC,wDAAmC,CAAA;IACnC,oFAAoF;IACpF,gEAAgE;IAChE,gEAA2C,CAAA;IAC3C,oFAA+D,CAAA;IAC/D,gFAA2D,CAAA;IAC3D,oFAA+D,CAAA;IAC/D,oFAA+D,CAAA;IAE/D,uBAAuB;IACvB,kEAA6C,CAAA;IAC7C,8DAAyC,CAAA;IACzC,kEAA6C,CAAA;IAC7C,kEAA6C,CAAA;IAE7C,4EAA4E;IAC5E,wEAAwE;IACxE,6EAA6E;IAC7E,qDAAqD;IACrD,gGAA2E,CAAA;IAC3E,4FAAuE,CAAA;IACvE,gGAA2E,CAAA;IAC3E,gGAA2E,CAAA;IAC3E,sFAAiE,CAAA;IACjE,kFAA6D,CAAA;IAC7D,sFAAiE,CAAA;IACjE,sFAAiE,CAAA;IACjE,sEAAiD,CAAA;IACjD,oEAA+C,CAAA;IAC/C,0EAAqD,CAAA;IACrD,8EAAyD,CAAA;IAEzD,kBAAkB;IAClB,EAAE;IACF,2EAA2E;IAC3E,0EAA0E;IAC1E,uEAAuE;IACvE,+BAA+B;IAC/B,oEAA+C,CAAA;IAC/C,gEAA2C,CAAA;IAC3C,oEAA+C,CAAA;IAC/C,oEAA+C,CAAA;IAC/C,kEAA6C,CAAA;IAC7C,gEAA2C,CAAA;IAC3C,kFAA6D,CAAA;IAC7D,sFAAiE,CAAA;IACjE,kEAA6C,CAAA;IAC7C,oEAA+C,CAAA;IAC/C,yEAAyE;IACzE,gEAA2C,CAAA;IAC3C;;;OAGG;IACH,8DAAyC,CAAA;IACzC,mFAAmF;IACnF,wEAAmD,CAAA;IACnD,oEAA+C,CAAA;IAC/C,gFAAgF;IAChF,sEAAiD,CAAA;IACjD,wEAAmD,CAAA;IACnD,0EAAqD,CAAA;IACrD,0EAAqD,CAAA;IACrD,kEAA6C,CAAA;IAC7C,gEAA2C,CAAA;IAC3C,8DAAyC,CAAA;IACzC,kFAA6D,CAAA;IAC7D,gEAA2C,CAAA;IAC3C,2EAA2E;IAC3E,mDAAmD;IACnD,sEAAiD,CAAA;IACjD,4DAAuC,CAAA;IACvC,gEAA2C,CAAA;IAE3C,uBAAuB;IACvB,0EAA0E;IAC1E,4EAA4E;IAC5E,kFAAkF;IAClF,8EAAyD,CAAA;IACzD,kFAA6D,CAAA;IAC7D,0FAAqE,CAAA;IACrE,sFAAiE,CAAA;IACjE,0FAAqE,CAAA;IACrE,0FAAqE,CAAA;IACrE,sFAAiE,CAAA;IACjE,kFAA6D,CAAA;IAC7D,sFAAiE,CAAA;IACjE,sFAAiE,CAAA;IACjE,2EAA2E;IAC3E,uEAAuE;IACvE,gFAA2D,CAAA;IAC3D,yFAAyF;IACzF,8EAAyD,CAAA;IACzD,yFAAyF;IACzF,kFAA6D,CAAA;IAE7D,gFAAgF;IAChF,gFAAgF;IAChF,kFAAkF;IAClF,kFAAkF;IAClF,8EAA8E;IAC9E,kFAAkF;IAClF,8DAAyC,CAAA;IACzC,0DAAqC,CAAA;IACrC,8DAAyC,CAAA;IACzC,8DAAyC,CAAA;IAEzC,oEAA+C,CAAA;IAC/C,gEAA2C,CAAA;IAC3C,oEAA+C,CAAA;IAC/C,oEAA+C,CAAA;IAE/C,wEAAmD,CAAA;IACnD,oEAA+C,CAAA;IAC/C,wEAAmD,CAAA;IACnD,wEAAmD,CAAA;IAEnD,sFAAiE,CAAA;IACjE,kFAA6D,CAAA;IAC7D,sFAAiE,CAAA;IACjE,sFAAiE,CAAA;IAEjE,0EAAqD,CAAA;IACrD,sEAAiD,CAAA;IACjD,0EAAqD,CAAA;IACrD,0EAAqD,CAAA;IAErD,0DAAqC,CAAA;IAErC,sDAAiC,CAAA;IACjC,kDAA6B,CAAA;IAC7B,4DAAuC,CAAA;IAEvC,kDAA6B,CAAA;IAC7B,8CAAyB,CAAA;IACzB,oDAA+B,CAAA;IAE/B,sDAAiC,CAAA;IACjC,kDAA6B,CAAA;IAE7B,sDAAiC,CAAA;IACjC,kDAA6B,CAAA;IAC7B,sDAAiC,CAAA;IACjC,0DAAqC,CAAA;IACrC,8DAAyC,CAAA;IACzC,sDAAiC,CAAA;IAEjC,8DAAyC,CAAA;IACzC,sDAAiC,CAAA;IACjC,kDAA6B,CAAA;IAE7B,8FAAyE,CAAA;IACzE,kFAA6D,CAAA;IAC7D,0GAAqF,CAAA;IACrF,sFAAiE,CAAA;IAEjE,4FAAuE,CAAA;IACvE,gFAA2D,CAAA;IAC3D,wGAAmF,CAAA;IACnF,oFAA+D,CAAA;IAE/D,8DAAyC,CAAA;IAEzC,4DAAuC,CAAA;IACvC,wDAAmC,CAAA;IACnC,wEAAmD,CAAA;IACnD,kEAA6C,CAAA;IAE7C,oEAA+C,CAAA;IAC/C,wEAAmD,CAAA;IACnD,8EAAyD,CAAA;IAEzD,wEAAmD,CAAA;IACnD,wFAAwF;IACxF,sEAAiD,CAAA;IAEjD,8DAAyC,CAAA;IACzC,gEAA2C,CAAA;IAC3C,kEAA6C,CAAA;IAE7C,iFAAiF;IACjF,2EAA2E;IAC3E,2EAA2E;IAC3E,kEAA6C,CAAA;IAC7C,8DAAyC,CAAA;IACzC,kEAA6C,CAAA;IAC7C,oEAA+C,CAAA;IAC/C,oEAA+C,CAAA;IAC/C,kEAA6C,CAAA;IAC7C,8DAAyC,CAAA;IACzC,kEAA6C,CAAA;IAC7C,4EAAuD,CAAA;IACvD,gFAAgF;IAChF,gFAAgF;IAChF,wEAAmD,CAAA;IAEnD,uBAAuB;IACvB,+EAA+E;IAC/E,mFAAmF;IACnF,4DAA4D;IAC5D,sFAAiE,CAAA;IACjE,kFAA6D,CAAA;IAC7D,sFAAiE,CAAA;IACjE,sFAAiE,CAAA;IACjE,kFAA6D,CAAA;IAC7D,4EAAuD,CAAA;IACvD,8EAAyD,CAAA;IACzD,8FAAyE,CAAA;IACzE,kGAA6E,CAAA;IAC7E,gFAA2D,CAAA;IAC3D,gFAAgF;IAChF,sFAAsF;IACtF,kFAA6D,CAAA;IAE7D,gFAAgF;IAChF,0EAA0E;IAC1E,gDAAgD;IAChD,0DAAqC,CAAA;IACrC,4DAAuC,CAAA;IACvC,8EAAyD,CAAA;IACzD,2EAA2E;IAC3E,oEAA+C,CAAA;IAC/C,iFAAiF;IACjF,4EAA4E;IAC5E,mEAAmE;IACnE,oDAA+B,CAAA;IAC/B,sDAAiC,CAAA;IACjC,wDAAmC,CAAA;IAEnC,4DAA4D;IAC5D,8DAAyC,CAAA;IACzC,wGAAwG;IACxG,4DAAuC,CAAA;IACvC,wGAAwG;IACxG,gEAA2C,CAAA;AAC/C,CAAC,EAnSW,iBAAiB,iCAAjB,iBAAiB,QAmS5B"}

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

@@ -9,6 +9,7 @@ export * from './interfaces/chat-conversation-with-participants';
 export * from './interfaces/chat-message';
 export * from './interfaces/chat-participant';
 export * from './interfaces/chat-presence-info';
+export * from './interfaces/chat-analytics';
 // constants
 export * from './constants/chat-ws-events';
 export * from './constants/chat-room-names';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/chat/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AAEnD,aAAa;AACb,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kDAAkD,CAAC;AACjE,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAEhD,YAAY;AACZ,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/chat/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AAEnD,aAAa;AACb,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kDAAkD,CAAC;AACjE,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAE5C,YAAY;AACZ,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * Chat analytics (the admin's Chat Analytics): how the conversations on Clarion went over
+ * a period - incident chats, Follow Me chats and direct chats - how much was written and
+ * by whom, and above all how quickly a member who wrote was answered.
+ *
+ * One read, computed by clarion-chat from one consistent snapshot, with who each person
+ * is from clarion-authentication. Counts, rates and durations only: never a message, a
+ * member's name or a trip's label. The only people named are STAFF - the control room,
+ * responders and administrators - as agents are on the support analytics.
+ *
+ * DURATIONS ARE IN SECONDS, like every analytics contract.
+ *
+ * How it is counted:
+ *  - A conversation belongs to the organization, control centre and country of the
+ *    person who STARTED it: the member who raised the SOS, the traveller on a Follow Me
+ *    trip, the administrator who opened a direct chat. clarion-chat keeps no organization
+ *    of its own. Everything written in a conversation is its organization's, whoever
+ *    wrote it - a guardian, or a responder from another organization.
+ *  - What a conversation is for (`ChatAnalyticsContext`): INCIDENT is an incident's chat,
+ *    including a Follow Me chat that an SOS adopted; FOLLOW_ME a trip's; DIRECT one person
+ *    to another; GROUP any other group.
+ *  - Who writes (`ChatAnalyticsSenderKind`), from the roles a person holds NOW: anybody
+ *    with a control-centre role is the CONTROL_ROOM, then RESPONDER, then ADMINISTRATOR
+ *    (organization roles, Super-Admin) - together, STAFF. Everybody else is a MEMBER: the
+ *    people the service is for, their guardians included. UNKNOWN is an account that no
+ *    longer exists. Whoever started an incident's or a Follow Me chat from the app is its
+ *    MEMBER there, whatever else they hold - staff raise SOSes too.
+ *  - A member's TURN starts with a member's message that opens a conversation or follows
+ *    a staff message. It is ANSWERED by the first staff message after it, and the wait is
+ *    the time between. Turns started in the period, answered whenever.
+ *  - System messages are counted on their own and never take part in a turn.
+ */
+export {};
+//# sourceMappingURL=chat-analytics.js.map

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

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

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

@@ -51,6 +51,9 @@ export var PermissionActions;
     PermissionActions["READ_INCIDENT"] = "read:incident";
     PermissionActions["UPDATE_INCIDENT"] = "update:incident";
     PermissionActions["DELETE_INCIDENT"] = "delete:incident";
+    // Chat Analytics: how the chats went and how quickly members were answered - totals
+    // only. Held by exactly the roles that read the user analytics.
+    PermissionActions["READ_CHAT_ANALYTICS"] = "read:chat-analytics";
     PermissionActions["CREATE_INCIDENT_CATEGORY_TYPE"] = "create:incident-category-type";
     PermissionActions["READ_INCIDENT_CATEGORY_TYPE"] = "read:incident-category-type";
     PermissionActions["UPDATE_INCIDENT_CATEGORY_TYPE"] = "update:incident-category-type";

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/modules/chat/index.d.ts

@@ -7,5 +7,6 @@ export * from './interfaces/chat-conversation-with-participants';
 export * from './interfaces/chat-message';
 export * from './interfaces/chat-participant';
 export * from './interfaces/chat-presence-info';
+export * from './interfaces/chat-analytics';
 export * from './constants/chat-ws-events';
 export * from './constants/chat-room-names';

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

@@ -0,0 +1,275 @@
+/**
+ * Chat analytics (the admin's Chat Analytics): how the conversations on Clarion went over
+ * a period - incident chats, Follow Me chats and direct chats - how much was written and
+ * by whom, and above all how quickly a member who wrote was answered.
+ *
+ * One read, computed by clarion-chat from one consistent snapshot, with who each person
+ * is from clarion-authentication. Counts, rates and durations only: never a message, a
+ * member's name or a trip's label. The only people named are STAFF - the control room,
+ * responders and administrators - as agents are on the support analytics.
+ *
+ * DURATIONS ARE IN SECONDS, like every analytics contract.
+ *
+ * How it is counted:
+ *  - A conversation belongs to the organization, control centre and country of the
+ *    person who STARTED it: the member who raised the SOS, the traveller on a Follow Me
+ *    trip, the administrator who opened a direct chat. clarion-chat keeps no organization
+ *    of its own. Everything written in a conversation is its organization's, whoever
+ *    wrote it - a guardian, or a responder from another organization.
+ *  - What a conversation is for (`ChatAnalyticsContext`): INCIDENT is an incident's chat,
+ *    including a Follow Me chat that an SOS adopted; FOLLOW_ME a trip's; DIRECT one person
+ *    to another; GROUP any other group.
+ *  - Who writes (`ChatAnalyticsSenderKind`), from the roles a person holds NOW: anybody
+ *    with a control-centre role is the CONTROL_ROOM, then RESPONDER, then ADMINISTRATOR
+ *    (organization roles, Super-Admin) - together, STAFF. Everybody else is a MEMBER: the
+ *    people the service is for, their guardians included. UNKNOWN is an account that no
+ *    longer exists. Whoever started an incident's or a Follow Me chat from the app is its
+ *    MEMBER there, whatever else they hold - staff raise SOSes too.
+ *  - A member's TURN starts with a member's message that opens a conversation or follows
+ *    a staff message. It is ANSWERED by the first staff message after it, and the wait is
+ *    the time between. Turns started in the period, answered whenever.
+ *  - System messages are counted on their own and never take part in a turn.
+ */
+/** How the period is cut into points for the charts. Chosen by the service from the length of the period. */
+export type ChatAnalyticsBucket = 'hour' | 'day' | 'week' | 'month';
+/** What a conversation is for. */
+export type ChatAnalyticsContext = 'INCIDENT' | 'FOLLOW_ME' | 'DIRECT' | 'GROUP';
+/** Who wrote a message: the three kinds of staff, a member, or an account that no longer exists. */
+export type ChatAnalyticsSenderKind = 'CONTROL_ROOM' | 'RESPONDER' | 'ADMINISTRATOR' | 'MEMBER' | 'UNKNOWN';
+export interface ChatAnalyticsRange {
+    /** Inclusive, ISO 8601. The first conversation when the period asked for was "forever". */
+    from: string;
+    /** Exclusive, ISO 8601. */
+    to: string;
+    bucket: ChatAnalyticsBucket;
+    /** IANA time zone the buckets and the hour-of-week grid are cut in. */
+    timeZone: string;
+}
+/** A count by a key (a context, a kind, a band), largest first unless the section says otherwise. */
+export interface ChatAnalyticsCount<K extends string = string> {
+    key: K;
+    count: number;
+}
+/** Median and 90th percentile of one duration, in seconds; null when nothing was measured. */
+export interface ChatAnalyticsDuration {
+    median: number | null;
+    p90: number | null;
+    /** How many were measured. */
+    count: number;
+}
+/** One kind of conversation and how it went in the period. */
+export interface ChatAnalyticsContextRow {
+    context: ChatAnalyticsContext;
+    /** Started in the period. */
+    started: number;
+    /** Of those, written in at least once (whenever). */
+    used: number;
+    /** Written in during the period, whenever started. */
+    active: number;
+    /** Messages written in the period, not counting system messages. */
+    messages: number;
+    memberMessages: number;
+    staffMessages: number;
+    /** Members' turns started in the period, and of those answered. */
+    turns: number;
+    answered: number;
+    /** answered / turns, as a percentage. */
+    replyRate: number | null;
+    medianSecondsToReply: number | null;
+}
+/** The conversations: what was started, what was used, and who was in them. */
+export interface ChatAnalyticsConversations {
+    /** Started in the period. */
+    started: number;
+    /** Of those, written in at least once (whenever) - and as a percentage. */
+    used: number;
+    usedRate: number | null;
+    /** Of those, a member AND staff both wrote in - a conversation rather than a notice. */
+    twoWay: number;
+    /** Written in during the period, whenever started. */
+    active: number;
+    /** People seated in the conversations started in the period, each counted once. */
+    people: number;
+    /** People per conversation started in the period. */
+    averageParticipants: number | null;
+    /**
+     * In the period, in any conversation in scope: people added AFTER it started (a
+     * responder assigned, a guardian added - not the people it started with), and seats
+     * given up (removed, or left).
+     */
+    joined: number;
+    left: number;
+    /** Start to the first message - conversations started in the period that were used. */
+    toFirstMessage: ChatAnalyticsDuration;
+    /** Start to the first staff message - conversations started in the period that staff wrote in. */
+    toFirstStaffMessage: ChatAnalyticsDuration;
+    /** INCIDENT, FOLLOW_ME, DIRECT, GROUP - in that order, zeros included. */
+    byContext: ChatAnalyticsContextRow[];
+    /** Conversations started in the period by how many people are in them now: 1, 2, 3, 4, 5, 6+ - in that order. */
+    bySize: ChatAnalyticsCount[];
+    /** Conversations started in the period, by the country of whoever started them. */
+    byCountry: ChatAnalyticsCount[];
+}
+/** The messages written in the period. */
+export interface ChatAnalyticsMessages {
+    /** Written by people (system messages are `system`). */
+    sent: number;
+    fromMembers: number;
+    fromStaff: number;
+    /** By accounts that no longer exist. */
+    fromUnknown: number;
+    system: number;
+    /** Removed in the period, whenever written. */
+    removed: number;
+    /** Different people who wrote. */
+    senders: number;
+    memberSenders: number;
+    staffSenders: number;
+    /** sent / active conversations. */
+    perActiveConversation: number | null;
+    /** CONTROL_ROOM, RESPONDER, ADMINISTRATOR, MEMBER, UNKNOWN - in that order, zeros included. */
+    bySenderKind: ChatAnalyticsCount<ChatAnalyticsSenderKind>[];
+    /** Characters, never the words. */
+    medianLength: number | null;
+    /** SHORT (under 20 characters), MEDIUM (20-79), LONG (80-279), VERY_LONG (280+) - in that order. */
+    byLength: ChatAnalyticsCount[];
+}
+/** How quickly members were answered. */
+export interface ChatAnalyticsReplies {
+    /** Members' turns started in the period. */
+    turns: number;
+    answered: number;
+    /** Never answered - the last word in that conversation is still the member's. */
+    unanswered: number;
+    /** answered / turns, as a percentage. */
+    replyRate: number | null;
+    /** The member's message to the first staff message after it - turns answered. */
+    toReply: ChatAnalyticsDuration;
+    /** Answered within a minute, 5 minutes, 15 minutes, an hour, later: UNDER_1M, 1-5M, 5-15M, 15-60M, OVER_1H - in that order. */
+    byWait: ChatAnalyticsCount[];
+    /** Answered within 5 minutes, as a percentage of turns. */
+    withinFiveMinutes: number | null;
+}
+/** One member of staff who wrote in the period. Staff are named; members never are. */
+export interface ChatAnalyticsStaffRow {
+    userId: number;
+    name: string | null;
+    kind: ChatAnalyticsSenderKind;
+    /** Messages they wrote in the period. */
+    messages: number;
+    /** Conversations they wrote in, in the period. */
+    conversations: number;
+    /** Members' turns started in the period that they were first to answer. */
+    replies: number;
+    medianSecondsToReply: number | null;
+}
+/** One conversation, for a table - never its messages, its members or its label. */
+export interface ChatAnalyticsConversationRow {
+    id: string;
+    context: ChatAnalyticsContext;
+    /** The incident it belongs to, for an incident's chat. */
+    incidentId: number | null;
+    organizationId: number | null;
+    startedAt: string;
+    /** People in it now. */
+    participants: number;
+    /** Written in the period. */
+    messages: number;
+    memberMessages: number;
+    staffMessages: number;
+    /** Its latest message, whenever. */
+    lastMessageAt: string | null;
+    /** Its members' turns started in the period, answered. */
+    medianSecondsToReply: number | null;
+    /** The last word is a member's, and nobody from staff has answered it. */
+    awaitingReply: boolean;
+    /** When that unanswered member's turn began; null when nothing is waiting. */
+    waitingSince: string | null;
+}
+/** One point on the charts: a bucket of the period. */
+export interface ChatAnalyticsPoint {
+    /** Local wall-clock start of the bucket, in `range.timeZone` (no offset). */
+    bucket: string;
+    /** Conversations started in the bucket, and of those incident chats. */
+    started: number;
+    incidentChats: number;
+    memberMessages: number;
+    staffMessages: number;
+    /** Conversations written in during the bucket. */
+    active: number;
+    /** Members' turns started in the bucket, and of those answered. */
+    turns: number;
+    answered: number;
+    medianSecondsToReply: number | null;
+}
+/** One hour of the week. Weekday 1 is Monday. */
+export interface ChatAnalyticsHeatCell {
+    weekday: number;
+    hour: number;
+    /** When members write. */
+    memberMessages: number;
+    /** When staff write. */
+    staffMessages: number;
+}
+/** The previous period of the same length, for the change on each headline figure. */
+export interface ChatAnalyticsPrevious {
+    from: string;
+    to: string;
+    started: number;
+    used: number;
+    active: number;
+    sent: number;
+    memberMessages: number;
+    staffMessages: number;
+    senders: number;
+    turns: number;
+    answered: number;
+    replyRate: number | null;
+    medianSecondsToReply: number | null;
+}
+/** A Super-Admin's view of every organization: one row each, busiest first. */
+export interface ChatAnalyticsOrganizationRow {
+    organizationId: number;
+    started: number;
+    active: number;
+    sent: number;
+    memberMessages: number;
+    staffMessages: number;
+    turns: number;
+    replyRate: number | null;
+    medianSecondsToReply: number | null;
+}
+export interface ChatAnalytics {
+    /** Whose figures: one organization (and one control centre in it), or null for every organization. */
+    organizationId: number | null;
+    controlCentreId: number | null;
+    /** The one country the figures are narrowed to, or null for every country. */
+    countryCode: string | null;
+    range: ChatAnalyticsRange;
+    generatedAt: string;
+    previous: ChatAnalyticsPrevious | null;
+    /** Countries with conversations in scope, whatever country is chosen - for narrowing to one. */
+    countryOptions: ChatAnalyticsCount[];
+    conversations: ChatAnalyticsConversations;
+    messages: ChatAnalyticsMessages;
+    replies: ChatAnalyticsReplies;
+    /** Staff who wrote in the period, busiest first - at most 25. */
+    staff: ChatAnalyticsStaffRow[];
+    /** The 15 conversations most written in during the period. */
+    busiest: ChatAnalyticsConversationRow[];
+    /** Conversations written in during the period whose member is still waiting for an answer, latest first - at most 25. */
+    waiting: ChatAnalyticsConversationRow[];
+    timeline: ChatAnalyticsPoint[];
+    /** All 168 hours of the week, Monday first, zeros included. */
+    heatmap: ChatAnalyticsHeatCell[];
+    /** A Super-Admin looking at every organization only. */
+    byOrganization?: ChatAnalyticsOrganizationRow[];
+}
+/** What a dashboard asks: the period, one country - and, for a Super-Admin, whose figures. */
+export interface ChatAnalyticsQuery {
+    from?: string;
+    to?: string;
+    timeZone?: string;
+    organizationId?: number;
+    countryCode?: string;
+}

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

@@ -32,6 +32,7 @@ export declare enum PermissionActions {
     READ_INCIDENT = "read:incident",
     UPDATE_INCIDENT = "update:incident",
     DELETE_INCIDENT = "delete:incident",
+    READ_CHAT_ANALYTICS = "read:chat-analytics",
     CREATE_INCIDENT_CATEGORY_TYPE = "create:incident-category-type",
     READ_INCIDENT_CATEGORY_TYPE = "read:incident-category-type",
     UPDATE_INCIDENT_CATEGORY_TYPE = "update:incident-category-type",

package/package.json

@@ -1,45 +1,45 @@
-{
-  "name": "clarion-shared-types",
-  "version": "1.0.113",
-  "main": "dist/cjs/index.js",
-  "module": "dist/esm/index.js",
-  "types": "dist/types/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/types/index.d.ts",
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js"
-    },
-    "./dist/modules/*": {
-      "types": "./dist/types/modules/*.d.ts",
-      "import": "./dist/esm/modules/*.js",
-      "require": "./dist/cjs/modules/*.js"
-    }
-  },
-  "files": [
-    "dist/**/*"
-  ],
-  "scripts": {
-    "clean": "rimraf dist dist-test",
-    "build:cjs": "tsc -p tsconfig.cjs.json",
-    "build:esm": "tsc -p tsconfig.esm.json",
-    "build:types": "tsc -p tsconfig.types.json",
-    "build": "npm run clean && npm run build:types && npm run build:cjs && npm run build:esm",
-    "prepublishOnly": "npm run build",
-    "pretest": "rimraf dist-test",
-    "test": "tsc -p tsconfig.spec.json && node --test \"dist-test/**/*.spec.js\""
-  },
-  "keywords": [],
-  "author": "vince_lawino",
-  "license": "ISC",
-  "description": "",
-  "publishConfig": {
-    "access": "public"
-  },
-  "devDependencies": {
-    "@types/geojson": "^7946.0.16",
-    "@types/node": "^20.11.2",
-    "rimraf": "^5.0.5",
-    "typescript": "^5.7.3"
-  }
-}
+{
+  "name": "clarion-shared-types",
+  "version": "1.0.114",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./dist/modules/*": {
+      "types": "./dist/types/modules/*.d.ts",
+      "import": "./dist/esm/modules/*.js",
+      "require": "./dist/cjs/modules/*.js"
+    }
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "clean": "rimraf dist dist-test",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "build": "npm run clean && npm run build:types && npm run build:cjs && npm run build:esm",
+    "prepublishOnly": "npm run build",
+    "pretest": "rimraf dist-test",
+    "test": "tsc -p tsconfig.spec.json && node --test \"dist-test/**/*.spec.js\""
+  },
+  "keywords": [],
+  "author": "vince_lawino",
+  "license": "ISC",
+  "description": "",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/geojson": "^7946.0.16",
+    "@types/node": "^20.11.2",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.7.3"
+  }
+}