@od-oneapp/analytics 2026.1.1301

package/src/shared/emitters/ai/events/content-generation.ts

@@ -0,0 +1,347 @@
+/**
+ * @fileoverview Content Generation Events
+ * Content Generation Events
+ *
+ * All types of AI-generated content: code, images, summaries, translations, etc.
+ * These track what the AI creates, not what users do with it.
+ */
+
+import { createAITracker } from '../track-ai';
+import {
+  AI_EVENTS,
+  type CodeGenerationProperties,
+  type ContentGenerationProperties,
+  type ImageGenerationProperties,
+  type SummaryProperties,
+} from '../types';
+
+/**
+ * Track code generation
+ *
+ * @example
+ * ```typescript
+ * ai.CODE_GENERATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   language: 'typescript',
+ *   code_length: 450,
+ *   code_type: 'function',
+ *   has_explanation: true,
+ *   has_tests: false,
+ * });
+ * ```
+ */
+export const CODE_GENERATED = createAITracker<CodeGenerationProperties>(properties => ({
+  name: AI_EVENTS.CODE_GENERATED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: ['task_type'],
+}));
+
+/**
+ * Track code explanation
+ *
+ * @example
+ * ```typescript
+ * ai.CODE_EXPLAINED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   language: 'python',
+ *   code_length: 200,
+ *   explanation_length: 500,
+ *   explanation_type: 'detailed',
+ * });
+ * ```
+ */
+export const CODE_EXPLAINED = createAITracker<CodeGenerationProperties>(properties => ({
+  name: AI_EVENTS.CODE_EXPLAINED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: ['task_type'],
+}));
+
+/**
+ * Track code debugging assistance
+ *
+ * @example
+ * ```typescript
+ * ai.CODE_DEBUGGED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   language: 'javascript',
+ *   code_length: 300,
+ *   issues_found: 3,
+ *   fixes_suggested: 3,
+ * });
+ * ```
+ */
+export const CODE_DEBUGGED = createAITracker<CodeGenerationProperties>(properties => ({
+  name: AI_EVENTS.CODE_DEBUGGED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: ['task_type'],
+}));
+
+/**
+ * Track code refactoring suggestions
+ *
+ * @example
+ * ```typescript
+ * ai.CODE_REFACTORED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   language: 'typescript',
+ *   code_length: 500,
+ *   refactor_type: 'extract-function',
+ *   improvements_suggested: 5,
+ * });
+ * ```
+ */
+export const CODE_REFACTORED = createAITracker<CodeGenerationProperties>(properties => ({
+  name: AI_EVENTS.CODE_REFACTORED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: ['task_type'],
+}));
+
+/**
+ * Track code translation between languages
+ *
+ * @example
+ * ```typescript
+ * ai.CODE_TRANSLATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   language: 'typescript',
+ *   code_length: 350,
+ *   source_language: 'python',
+ *   target_language: 'typescript',
+ * });
+ * ```
+ */
+export const CODE_TRANSLATED = createAITracker<CodeGenerationProperties>(properties => ({
+  name: AI_EVENTS.CODE_TRANSLATED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: ['task_type'],
+}));
+
+/**
+ * Track image generation
+ *
+ * @example
+ * ```typescript
+ * ai.IMAGE_GENERATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'dall-e-3',
+ *   image_type: 'generated',
+ *   prompt_length: 80,
+ *   image_format: 'png',
+ *   image_size: '1024x1024',
+ *   generation_time_ms: 5000,
+ * });
+ * ```
+ */
+export const IMAGE_GENERATED = createAITracker<ImageGenerationProperties>(properties => ({
+  name: AI_EVENTS.IMAGE_GENERATED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track image editing
+ *
+ * @example
+ * ```typescript
+ * ai.IMAGE_EDITED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'dall-e-3',
+ *   image_type: 'edited',
+ *   edit_type: 'inpaint',
+ *   prompt_length: 50,
+ *   image_format: 'png',
+ * });
+ * ```
+ */
+export const IMAGE_EDITED = createAITracker<ImageGenerationProperties>(properties => ({
+  name: AI_EVENTS.IMAGE_EDITED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track general text generation
+ *
+ * @example
+ * ```typescript
+ * ai.TEXT_GENERATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   content_type: 'article',
+ *   content_length: 1500,
+ *   content_format: 'markdown',
+ * });
+ * ```
+ */
+export const TEXT_GENERATED = createAITracker<ContentGenerationProperties>(properties => ({
+  name: AI_EVENTS.TEXT_GENERATED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track summary generation
+ *
+ * @example
+ * ```typescript
+ * ai.SUMMARY_GENERATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   source_type: 'document',
+ *   source_length: 5000,
+ *   summary_length: 300,
+ *   summary_type: 'bullet-points',
+ *   compression_ratio: 16.7,
+ * });
+ * ```
+ */
+export const SUMMARY_GENERATED = createAITracker<SummaryProperties>(properties => ({
+  name: AI_EVENTS.SUMMARY_GENERATED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: ['input_length', 'output_length', 'summary_type'],
+}));
+
+/**
+ * Track text translation
+ *
+ * @example
+ * ```typescript
+ * ai.TRANSLATION_GENERATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   content_type: 'translation',
+ *   content_length: 450,
+ *   source_language: 'english',
+ *   target_language: 'spanish',
+ * });
+ * ```
+ */
+export const TRANSLATION_GENERATED = createAITracker<ContentGenerationProperties>(properties => ({
+  name: AI_EVENTS.TRANSLATION_GENERATED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track text completion
+ *
+ * @example
+ * ```typescript
+ * ai.COMPLETION_GENERATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   content_type: 'completion',
+ *   content_length: 200,
+ *   completion_type: 'sentence',
+ * });
+ * ```
+ */
+export const COMPLETION_GENERATED = createAITracker<ContentGenerationProperties>(properties => ({
+  name: AI_EVENTS.COMPLETION_GENERATED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track content rewrite
+ *
+ * @example
+ * ```typescript
+ * ai.REWRITE_GENERATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   content_type: 'rewrite',
+ *   content_length: 350,
+ *   original_length: 300,
+ *   rewrite_style: 'formal',
+ * });
+ * ```
+ */
+export const REWRITE_GENERATED = createAITracker<ContentGenerationProperties>(properties => ({
+  name: AI_EVENTS.REWRITE_GENERATED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track email draft assistance
+ *
+ * @example
+ * ```typescript
+ * ai.EMAIL_DRAFTED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   content_type: 'email',
+ *   content_length: 400,
+ *   email_type: 'professional',
+ *   has_subject: true,
+ * });
+ * ```
+ */
+export const EMAIL_DRAFTED = createAITracker<ContentGenerationProperties>(properties => ({
+  name: AI_EVENTS.EMAIL_DRAFTED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track document creation
+ *
+ * @example
+ * ```typescript
+ * ai.DOCUMENT_CREATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   content_type: 'document',
+ *   content_length: 2500,
+ *   content_format: 'markdown',
+ *   document_type: 'report',
+ * });
+ * ```
+ */
+export const DOCUMENT_CREATED = createAITracker<ContentGenerationProperties>(properties => ({
+  name: AI_EVENTS.DOCUMENT_CREATED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track outline creation
+ *
+ * @example
+ * ```typescript
+ * ai.OUTLINE_CREATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   content_type: 'outline',
+ *   content_length: 600,
+ *   section_count: 8,
+ *   outline_depth: 3,
+ * });
+ * ```
+ */
+export const OUTLINE_CREATED = createAITracker<ContentGenerationProperties>(properties => ({
+  name: AI_EVENTS.OUTLINE_CREATED,
+  category: 'content-generation',
+  properties,
+  requiredProperties: [],
+}));

package/src/shared/emitters/ai/events/conversation.ts

@@ -0,0 +1,332 @@
+/**
+ * @fileoverview Conversation & Messaging Events
+ * Conversation & Messaging Events
+ *
+ * Core conversation lifecycle and message management for ChatGPT-style products.
+ * Includes conversation start/end, messaging, regeneration, branching, and streaming.
+ */
+
+import { createAITracker } from '../track-ai';
+import {
+  AI_EVENTS,
+  type BranchProperties,
+  type ConversationProperties,
+  type MessageProperties,
+  type RegenerationProperties,
+  type StopGenerationProperties,
+  type StreamingSDKProperties,
+} from '../types';
+
+/**
+ * Track conversation start
+ *
+ * @example
+ * ```typescript
+ * ai.CONVERSATION_STARTED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   conversation_type: 'chat',
+ * });
+ * ```
+ */
+export const CONVERSATION_STARTED = createAITracker<ConversationProperties>(properties => ({
+  name: AI_EVENTS.CONVERSATION_STARTED,
+  category: 'conversation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track conversation resume
+ *
+ * @example
+ * ```typescript
+ * ai.CONVERSATION_RESUMED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   last_active_timestamp: '2024-01-15T10:30:00Z',
+ *   message_count: 15,
+ * });
+ * ```
+ */
+export const CONVERSATION_RESUMED = createAITracker<ConversationProperties>(properties => ({
+  name: AI_EVENTS.CONVERSATION_RESUMED,
+  category: 'conversation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track conversation end
+ *
+ * @example
+ * ```typescript
+ * ai.CONVERSATION_ENDED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   end_reason: 'user-ended',
+ *   duration_ms: 180000,
+ *   message_count: 25,
+ * });
+ * ```
+ */
+export const CONVERSATION_ENDED = createAITracker<ConversationProperties>(properties => ({
+  name: AI_EVENTS.CONVERSATION_ENDED,
+  category: 'conversation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track user message sent
+ *
+ * @example
+ * ```typescript
+ * ai.MESSAGE_SENT({
+ *   conversation_id: 'conv_123',
+ *   message_id: 'msg_456',
+ *   model_id: 'gpt-4',
+ *   message_role: 'user',
+ *   message_length: 50,
+ * });
+ * ```
+ */
+export const MESSAGE_SENT = createAITracker<MessageProperties>(properties => ({
+  name: AI_EVENTS.MESSAGE_SENT,
+  category: 'conversation',
+  properties,
+  requiredProperties: ['message_role'],
+}));
+
+/**
+ * Track AI message received
+ *
+ * @example
+ * ```typescript
+ * ai.MESSAGE_RECEIVED({
+ *   conversation_id: 'conv_123',
+ *   message_id: 'msg_457',
+ *   model_id: 'claude-3-5-sonnet',
+ *   message_role: 'assistant',
+ *   message_length: 250,
+ *   response_time_ms: 850,
+ *   finish_reason: 'stop',
+ *   input_tokens: 450,
+ *   output_tokens: 320,
+ * });
+ * ```
+ */
+export const MESSAGE_RECEIVED = createAITracker<MessageProperties>(properties => ({
+  name: AI_EVENTS.MESSAGE_RECEIVED,
+  category: 'conversation',
+  properties,
+  requiredProperties: ['message_role'],
+}));
+
+/**
+ * Track message regeneration
+ *
+ * @example
+ * ```typescript
+ * ai.MESSAGE_REGENERATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   original_message_id: 'msg_457',
+ *   attempt_number: 2,
+ *   reason: 'user-requested',
+ *   temperature_adjusted: true,
+ * });
+ * ```
+ */
+export const MESSAGE_REGENERATED = createAITracker<RegenerationProperties>(properties => ({
+  name: AI_EVENTS.MESSAGE_REGENERATED,
+  category: 'conversation',
+  properties,
+  requiredProperties: ['original_message_id'],
+}));
+
+/**
+ * Track message edit
+ *
+ * @example
+ * ```typescript
+ * ai.MESSAGE_EDITED({
+ *   conversation_id: 'conv_123',
+ *   message_id: 'msg_456',
+ *   model_id: 'claude-3-5-sonnet',
+ *   edit_type: 'user-edit',
+ *   original_length: 50,
+ *   new_length: 75,
+ * });
+ * ```
+ */
+export const MESSAGE_EDITED = createAITracker<MessageProperties>(properties => ({
+  name: AI_EVENTS.MESSAGE_EDITED,
+  category: 'conversation',
+  properties,
+  requiredProperties: ['message_role'],
+}));
+
+/**
+ * Track message deletion
+ *
+ * @example
+ * ```typescript
+ * ai.MESSAGE_DELETED({
+ *   conversation_id: 'conv_123',
+ *   message_id: 'msg_458',
+ *   model_id: 'gpt-4',
+ *   message_role: 'assistant',
+ *   deleted_by: 'user',
+ * });
+ * ```
+ */
+export const MESSAGE_DELETED = createAITracker<MessageProperties>(properties => ({
+  name: AI_EVENTS.MESSAGE_DELETED,
+  category: 'conversation',
+  properties,
+  requiredProperties: ['message_role'],
+}));
+
+/**
+ * Track conversation branch creation
+ *
+ * @example
+ * ```typescript
+ * ai.BRANCH_CREATED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'gpt-4',
+ *   branch_point_message_id: 'msg_457',
+ *   original_conversation_id: 'conv_123',
+ *   new_conversation_id: 'conv_124',
+ *   reason: 'explore-alternative',
+ * });
+ * ```
+ */
+export const BRANCH_CREATED = createAITracker<BranchProperties>(properties => ({
+  name: AI_EVENTS.BRANCH_CREATED,
+  category: 'conversation',
+  properties,
+  requiredProperties: [
+    'branch_point_message_id',
+    'new_conversation_id',
+    'original_conversation_id',
+  ],
+}));
+
+/**
+ * Track conversation branch merge
+ *
+ * @example
+ * ```typescript
+ * ai.BRANCH_MERGED({
+ *   conversation_id: 'conv_123',
+ *   model_id: 'claude-3-5-sonnet',
+ *   branch_point_message_id: 'msg_457',
+ *   original_conversation_id: 'conv_123',
+ *   new_conversation_id: 'conv_124',
+ *   merge_strategy: 'keep-both',
+ * });
+ * ```
+ */
+export const BRANCH_MERGED = createAITracker<BranchProperties>(properties => ({
+  name: AI_EVENTS.BRANCH_MERGED,
+  category: 'conversation',
+  properties,
+  requiredProperties: [
+    'branch_point_message_id',
+    'new_conversation_id',
+    'original_conversation_id',
+  ],
+}));
+
+/**
+ * Track stop generation (user interrupts response)
+ *
+ * @example
+ * ```typescript
+ * ai.STOP_GENERATION({
+ *   conversation_id: 'conv_123',
+ *   message_id: 'msg_458',
+ *   model_id: 'gpt-4',
+ *   partial_length: 120,
+ *   stop_reason: 'user-interrupted',
+ *   tokens_used_at_stop: 150,
+ * });
+ * ```
+ */
+export const STOP_GENERATION = createAITracker<StopGenerationProperties>(properties => ({
+  name: AI_EVENTS.STOP_GENERATION,
+  category: 'conversation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track streaming start
+ *
+ * @example
+ * ```typescript
+ * ai.STREAMING_STARTED({
+ *   conversation_id: 'conv_123',
+ *   message_id: 'msg_459',
+ *   model_id: 'claude-3-5-sonnet',
+ *   stream_type: 'text',
+ * });
+ * ```
+ */
+export const STREAMING_STARTED = createAITracker<StreamingSDKProperties>(properties => ({
+  name: AI_EVENTS.STREAMING_STARTED,
+  category: 'conversation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track streaming chunk received (sample, not every chunk)
+ *
+ * @example
+ * ```typescript
+ * // Sample every 10th chunk
+ * if (chunkCount % 10 === 0) {
+ *   ai.STREAMING_CHUNK_RECEIVED({
+ *     conversation_id: 'conv_123',
+ *     message_id: 'msg_459',
+ *     model_id: 'gpt-4',
+ *     stream_type: 'text',
+ *     chunk_index: chunkCount,
+ *     chunk_size_bytes: 256,
+ *   });
+ * }
+ * ```
+ */
+export const STREAMING_CHUNK_RECEIVED = createAITracker<StreamingSDKProperties>(properties => ({
+  name: AI_EVENTS.STREAMING_CHUNK_RECEIVED,
+  category: 'conversation',
+  properties,
+  requiredProperties: [],
+}));
+
+/**
+ * Track streaming completion
+ *
+ * @example
+ * ```typescript
+ * ai.STREAMING_COMPLETED({
+ *   conversation_id: 'conv_123',
+ *   message_id: 'msg_459',
+ *   model_id: 'claude-3-5-sonnet',
+ *   stream_type: 'text',
+ *   chunk_count: 45,
+ *   total_bytes: 11520,
+ *   stream_duration_ms: 3200,
+ *   chunks_per_second: 14.06,
+ * });
+ * ```
+ */
+export const STREAMING_COMPLETED = createAITracker<StreamingSDKProperties>(properties => ({
+  name: AI_EVENTS.STREAMING_COMPLETED,
+  category: 'conversation',
+  properties,
+  requiredProperties: [],
+}));