clarion-shared-types 1.0.91 → 1.0.93

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/dist/types/modules/tracking/interfaces/tracking-position.dto.d.ts

@@ -60,6 +60,12 @@ export interface TrackingBoundingBox {
     west: number;
 }
 export interface TrackingCurrentPositionQuery {
+    /**
+     * Tenant to read. REQUIRED for a Super-Admin, who has no tenant of their own
+     * (the service answers 403 without it); ignored for everyone else, whose scope
+     * always comes from their own access context and cannot be widened from here.
+     */
+    organizationId?: number;
     controlCentreId?: number;
     status?: TrackingUnitOnlineStatus;
     north?: number;

package/dist/types/modules/tracking/interfaces/tracking-socket-events.d.ts

@@ -15,7 +15,12 @@ export interface TrackingPositionSocketEvent {
     longitude: number;
     accuracyMetres?: number;
     speedKph?: number;
-    /** Degrees clockwise from north, [0,360). Omitted/undefined ⇒ do not rotate. */
+    /**
+     * Heading in degrees clockwise from north, [0,360). Resolved by the server:
+     * the provider's course while moving, else the direction actually travelled,
+     * else the last known heading. Omitted ONLY when it is genuinely unknown —
+     * keep whatever heading is already shown; do not reset the unit to north.
+     */
     courseDegrees?: number;
     moving?: boolean;
     ignitionOn?: boolean;

package/package.json

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