clarion-shared-types 1.0.91 → 1.0.92

package/dist/types/modules/support/interfaces/support-reports.dto.d.ts

@@ -144,3 +144,37 @@ export interface SupportRealtimePayloadDto {
     /** Server time the record last changed, so a client can discard a stale update. */
     updatedAt?: string;
 }
+/**
+ * One agent's row in the team performance report.
+ *
+ * Distinct from `SupportAgentDashboardMetricsDto`, which is one agent looking
+ * at their own live queue. This is a supervisor looking at settled work over a
+ * window, so it is a leaderboard rather than a snapshot.
+ *
+ * `satisfactionAverage` is null, not zero, when nobody rated the agent's work.
+ * A table that sorted an unrated agent to the bottom alongside a badly rated
+ * one would be actively misleading, and this table is read when deciding who
+ * needs coaching.
+ */
+export interface SupportAgentPerformanceRowDto {
+    agentUserId: number;
+    agentName?: string | null;
+    ticketsHandled: number;
+    ticketsResolved: number;
+    ticketsClosed: number;
+    ticketsOpen: number;
+    averageFirstResponseMinutes?: number | null;
+    averageResolutionMinutes?: number | null;
+    firstResponseComplianceRate: number;
+    resolutionComplianceRate: number;
+    slaBreachCount: number;
+    reopenedCount: number;
+    satisfactionAverage?: number | null;
+    satisfactionCount: number;
+}
+/** The team performance report. */
+export interface SupportAgentPerformanceReportDto {
+    from: string;
+    to: string;
+    agents: SupportAgentPerformanceRowDto[];
+}

package/dist/types/modules/support/interfaces/support-ticket.dto.d.ts

@@ -273,3 +273,17 @@ export interface SupportTicketQueryParams {
     from?: string;
     to?: string;
 }
+/**
+ * Rate the support received on a ticket.
+ *
+ * Sent to `POST /support/tickets/:id/rating`. Stored as SUPPORT_RATING customer
+ * feedback linked back to the ticket rather than as a field on the ticket, so
+ * the score stays inside Clarion and is never mirrored to a helpdesk with the
+ * conversation.
+ */
+export interface RateSupportTicketPayload {
+    /** Stars, 1 to 5. */
+    rating: number;
+    /** Optional. A star on its own is a complete answer. */
+    comment?: string;
+}

package/package.json

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