@griffin-app/griffin-executor 0.1.0

package/src/events/types.ts

@@ -0,0 +1,136 @@
+/**
+ * Event types for test monitor execution.
+ *
+ * All events are JSON-serializable for compatibility with various event buses.
+ * Events include stable identifiers (executionId, eventId) and monotonic sequence
+ * numbers for deduplication and ordering.
+ */
+
+/** Base event envelope with correlation and ordering metadata */
+export interface BaseEvent {
+  location?: string;
+  /** Unique identifier for this specific event */
+  event_id: string;
+  /** Monotonic sequence number within this execution (0-indexed) */
+  seq: number;
+  /** Unix timestamp in milliseconds */
+  timestamp: number;
+  /** ID of the test monitor being executed */
+  monitor_id: string;
+  /** Unique identifier for this execution run */
+  execution_id: string;
+
+  /** ID of the organization that the monitor belongs to */
+  organization_id: string;
+}
+
+/** Monitor-level events */
+export interface MonitorStartEvent extends BaseEvent {
+  type: "MONITOR_START";
+  monitor_name: string;
+  monitor_version: string;
+  node_count: number;
+  edge_count: number;
+}
+
+export interface MonitorEndEvent extends BaseEvent {
+  type: "MONITOR_END";
+  success: boolean;
+  total_duration_ms: number;
+  node_result_count: number;
+  error_count: number;
+  errors: string[];
+}
+
+/** Node-level events (domain-enriched from ts-edge events) */
+export interface NodeStartEvent extends BaseEvent {
+  type: "NODE_START";
+  node_id: string;
+  node_type: "ASSERTION" | "HTTP_REQUEST" | "WAIT";
+}
+
+export interface NodeEndEvent extends BaseEvent {
+  type: "NODE_END";
+  node_id: string;
+  node_type: "ASSERTION" | "HTTP_REQUEST" | "WAIT";
+  success: boolean;
+  duration_ms: number;
+  error?: string;
+}
+
+/** HTTP-specific events (for endpoint nodes) */
+export interface HttpRequestEvent extends BaseEvent {
+  type: "HTTP_REQUEST";
+  node_id: string;
+  attempt: number;
+  method: string;
+  url: string;
+  headers?: Record<string, string>;
+  has_body: boolean;
+}
+
+export interface HttpResponseEvent extends BaseEvent {
+  type: "HTTP_RESPONSE";
+  node_id: string;
+  attempt: number;
+  status: number;
+  status_text: string;
+  duration_ms: number;
+  has_body: boolean;
+}
+
+export interface HttpRetryEvent extends BaseEvent {
+  type: "HTTP_RETRY";
+  node_id: string;
+  attempt: number;
+  max_attempts: number;
+  reason: string;
+  next_retry_delay_ms?: number;
+}
+
+/** Assertion events */
+export interface AssertionResultEvent extends BaseEvent {
+  type: "ASSERTION_RESULT";
+  node_id: string;
+  assertion_index: number;
+  passed: boolean;
+  message: string;
+}
+
+/** Wait events */
+export interface WaitStartEvent extends BaseEvent {
+  type: "WAIT_START";
+  node_id: string;
+  duration_ms: number;
+}
+
+/** Streaming/progress events from nodes */
+export interface NodeStreamEvent extends BaseEvent {
+  type: "NODE_STREAM";
+  node_id: string;
+  chunk: string;
+}
+
+/** System/executor-level errors (not node failures) */
+export interface ErrorEvent extends BaseEvent {
+  type: "ERROR";
+  error_name: string;
+  message: string;
+  context?: string;
+  /** Only included in local/development mode */
+  stack?: string;
+}
+
+/** Union type of all execution events */
+export type ExecutionEvent =
+  | MonitorStartEvent
+  | MonitorEndEvent
+  | NodeStartEvent
+  | NodeEndEvent
+  | HttpRequestEvent
+  | HttpResponseEvent
+  | HttpRetryEvent
+  | AssertionResultEvent
+  | WaitStartEvent
+  | NodeStreamEvent
+  | ErrorEvent;