@chen-rmag/core-infra 1.0.0

package/src/types.ts

@@ -0,0 +1,246 @@
+// Test-related types
+export interface TestStep {
+  id: string;
+  description: string; // Step description only, no associated script
+  status?: "running" | "success" | "error"; // Execution status
+  error?: string; // Error message if failed
+  isBreakpoint?: boolean; // Whether this step has a breakpoint (persisted to storage)
+  isAI?: boolean;
+  reusedTestIds?: string[]; // IDs of reusable test cases
+}
+
+// Table data types for data-driven testing
+export interface TableData {
+  testId: string;
+  columns: string[]; // Column names (field names)
+  rows: Record<string, string>[]; // Each row is a map of column name to value
+  createdAt: number;
+  updatedAt: number;
+}
+
+// Test case type enumeration
+export type TestCaseType = 'functional' | 'ui' | 'edge';
+
+// Test case priority enumeration
+export type TestCasePriority = 'high' | 'medium' | 'low';
+
+export interface TestParameter {
+  key: string;
+  value: string;
+  description: string;
+}
+export interface TestCase {
+  id: string;
+  name: string;
+  description: string;
+  url: string;
+  steps: TestStep[];
+  playwrightScript?: string; // Generated Playwright script for the entire test case
+  createdAt: number;
+  updatedAt: number;
+  status: 'draft' | 'ready' | 'completed';
+  path: string; // Directory path relative to tests folder, e.g., 'category1/subcategory' or empty for root
+  creator?: 'user' | 'ai'; // Creator of the test: 'user' for manually created, 'ai' for AI-generated
+  table?: TableData; // Associated table data rows for data-driven tests
+  type?: TestCaseType; // Type of test case: 'functional' | 'ui' | 'error'
+  reusable?: boolean; // Whether this test case can be reused as a step in other tests
+  dependencies?: string[]; // IDs of test cases that this test depends on
+  priority?: TestCasePriority; // Priority of the test case: 'high' | 'medium' | 'low'
+  parameters?: TestParameter[]; // Parameters of a reusable test case
+}
+
+// Supported language codes for localization and AI prompts
+export type LanguageCode = 'en-US' | 'zh-CN';
+
+// Directory structure types
+export interface DirectoryInfo {
+  id: string;
+  name: string; // Folder display name
+  description?: string;
+  createdAt: number;
+  updatedAt: number;
+}
+
+export interface TestDirectory {
+  path: string; // e.g., '', 'category1', 'category1/sub'
+  name: string; // Display name of current level
+  info?: DirectoryInfo; // Metadata from info.json if exists
+  children: TestDirectory[]; // Subdirectories
+  tests: TestCase[]; // Test cases at this level (leaf nodes only)
+}
+
+// Model Configuration types
+export type ModelProvider = 'openai' | 'anthropic' | 'mistral' | 'ollama' | 'openrouter';
+
+export interface ModelConfig {
+  id: string;
+  name: string;
+  provider: ModelProvider;
+  modelName: string;
+  apiKey?: string;
+  baseURL?: string;
+  temperature?: number;
+  maxTokens?: number;
+  timeout?: number;
+  isDefault?: boolean;
+  createdAt: number;
+  updatedAt: number;
+}
+
+// AI Agent types (combined with ModelConfig)
+
+export interface AutomationJob {
+  id: string;
+  name: string;
+  url: string;
+  status: 'idle' | 'exploring' | 'generating' | 'completed' | 'error';
+  progress: number; // 0-100
+  generatedTests: TestCase[];
+  insights: string[];
+  startedAt?: number;
+  completedAt?: number;
+  error?: string;
+  depth?: number; // exploration depth
+  maxTests?: number;
+}
+
+// Exploration Record types
+export interface ExplorationRecord {
+  id: string;
+  url: string;
+  status: 'pending' | 'running' | 'completed' | 'error';
+  progress: number; // 0-100
+  currentPhase: string;
+  generatedTests: number;
+  testIds: string[]; // IDs of generated tests
+  config: {
+    modelConfigId: string;
+    modelName: string;
+    maxSteps: number;
+    maxTests: number;
+    exploreDepth: number;
+    explorationScope?: string; // User-defined scope limitation
+    customData?: Array<{ key: string; value: string }>; // Custom test data
+    language?: LanguageCode; // Language code for AI prompts (e.g., 'en-US', 'zh-CN')
+  };
+  interactions: Array<{
+    round: number;
+    type: 'exploration' | 'analysis' | 'generation';
+    phase: string;
+    message: string;
+    timestamp: number;
+  }>;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  artifacts?: any; // ExplorationArtifacts from web-explorer/types.ts
+  startedAt: number;
+  completedAt?: number;
+  error?: string;
+}
+
+// Settings
+export interface MCPServer {
+  name: string;
+  endpoint: string;
+  capabilities: string[];
+  connected: boolean;
+  tools?: string[];
+}
+
+export interface BrowserCapabilities {
+  browsers: ('chromium' | 'firefox' | 'webkit')[];
+  headless: boolean;
+  viewport?: { width: number; height: number };
+  deviceScaleFactor?: number;
+  locale?: string;
+  timezone?: string;
+}
+export interface AppSettings {
+  theme: 'light' | 'dark';
+  aiModel: ModelConfig;
+  defaultBrowser: 'chromium' | 'firefox' | 'webkit';
+  headlessMode: boolean;
+  autoSave: boolean;
+  maxParallelTests: number;
+  screenshots: {
+    enabled: boolean;
+    captureOnError: boolean;
+    captureOnStep: boolean;
+  };
+  timeouts: {
+    navigation: number;
+    action: number;
+    assertion: number;
+  };
+  mcpSettings?: {
+    endpoint: string;
+    useStdio: boolean;
+  };
+}
+
+// Test result types
+export interface TestResult {
+  id: string;
+  testId: string;
+  status: 'passed' | 'failed' | 'skipped';
+  duration: number; // milliseconds
+  executedAt: number;
+  error?: string;
+  summary: {
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+  };
+}
+
+export interface ToolCallInfo {
+  toolCall?: ToolCall;
+  content: string;
+  status?: 'success' | 'error';
+  stepId?: string;
+}
+
+export type ToolCall = {
+  name: string;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  args: Record<string, any>;
+  id?: string;
+  content?: string;
+};
+
+// Project Management types
+export interface Project {
+  id: string;
+  name: string;
+  description: string;
+  createdAt: number;
+  updatedAt?: number;
+  isActive: boolean;
+}
+
+// Test Plan types
+export interface TestPlanItem {
+  type: 'test' | 'directory';
+  id: string; // testId or directory path
+  name: string;
+  path?: string; // for test cases
+  directoryPath?: string; // for directories
+}
+
+export interface TestPlan {
+  id: string;
+  name: string;
+  description: string;
+  projectId: string;
+  testIds: string[]; // List of all test IDs
+  createdAt: number;
+  updatedAt: number;
+  status: 'ready' | 'running' | 'completed' | 'failed' | 'partial' | 'stopped';
+  lastExecutedAt?: number;
+  maxConcurrency?: number;
+  browsers?: Array<'chromium' | 'firefox' | 'webkit'>;
+  scheduledAt?: number;
+  passedIds?: string[];
+  failedIds?: string[];
+  skippedIds?: string[];
+}

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}