@company-semantics/contracts 0.67.0 → 0.67.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.67.0",
+  "version": "0.67.1",
   "private": false,
   "repository": {
     "type": "git",

package/src/impersonation-events.ts

@@ -0,0 +1,54 @@
+/**
+ * Impersonation SSE Event Types
+ *
+ * Real-time push events for impersonation session state changes.
+ * Replaces 30-second polling mechanism.
+ * Follows the same BaseEvent envelope pattern as chat SSE events.
+ */
+
+import type { BaseEvent } from './chat/types'
+import type { ImpersonationSession } from './impersonation'
+
+/**
+ * Sent as the first frame on SSE connection.
+ * Carries the current active session (or null if none).
+ * Eliminates need for a separate GET /session request.
+ */
+export interface ImpersonationSessionSnapshotEvent extends BaseEvent {
+  type: 'impersonation.session.snapshot'
+  data: {
+    session: ImpersonationSession | null
+  }
+}
+
+/** Emitted when a new impersonation session starts (enables multi-tab sync). */
+export interface ImpersonationSessionStartedEvent extends BaseEvent {
+  type: 'impersonation.session.started'
+  data: {
+    session: ImpersonationSession
+  }
+}
+
+/** Emitted when an admin manually ends an impersonation session. */
+export interface ImpersonationSessionEndedEvent extends BaseEvent {
+  type: 'impersonation.session.ended'
+  data: {
+    sessionId: string
+    endedAt: string
+  }
+}
+
+/** Emitted when enforceExpiry() auto-expires a session. */
+export interface ImpersonationSessionExpiredEvent extends BaseEvent {
+  type: 'impersonation.session.expired'
+  data: {
+    sessionId: string
+    expiredAt: string
+  }
+}
+
+export type ImpersonationSseEvent =
+  | ImpersonationSessionSnapshotEvent
+  | ImpersonationSessionStartedEvent
+  | ImpersonationSessionEndedEvent
+  | ImpersonationSessionExpiredEvent

package/src/index.ts

@@ -437,6 +437,16 @@ export type {
 
 export { RESTRICTED_IMPERSONATION_ACTIONS } from './impersonation'
 
+// Impersonation SSE event types (real-time push)
+// @see PRD-00176 for design rationale
+export type {
+  ImpersonationSessionSnapshotEvent,
+  ImpersonationSessionStartedEvent,
+  ImpersonationSessionEndedEvent,
+  ImpersonationSessionExpiredEvent,
+  ImpersonationSseEvent,
+} from './impersonation-events'
+
 // Usage tracking types (internal admin)
 // @see PRD-00166 for design rationale
 export type {