@taodigital/agents 0.0.0-stage → 1.2.0

package/dist/test-import-agent.d.ts

@@ -0,0 +1,148 @@
+export interface ParsedTestCase {
+    ref?: string;
+    traceTo?: string;
+    caseRefs?: Array<Record<string, unknown>>;
+    title: string;
+    kind: string;
+    priority: string;
+    preconditions?: string;
+    steps: Array<{
+        stepId?: string;
+        action: string;
+        data?: string;
+        expected: string;
+        actualResult?: string;
+        comment?: string;
+        screenshotUrl?: string;
+    }>;
+    expectedResult: string;
+    actualResult?: string;
+    comment?: string;
+    screenshotUrl?: string;
+    status?: string;
+    gherkin?: string;
+    tags?: string[];
+    section?: string;
+    testDataInline?: Record<string, unknown>;
+}
+/**
+ * Maps QIP test-case fields → zero-based column indices in a spreadsheet.
+ * Any field may be undefined (= "not used").
+ */
+export interface ColumnMapping {
+    title?: number;
+    ref?: number;
+    steps?: number;
+    expected?: number;
+    priority?: number;
+    kind?: number;
+    preconditions?: number;
+    data?: number;
+    tags?: number;
+    section?: number;
+    caseStart?: number;
+    actualResult?: number;
+    comment?: number;
+    stepId?: number;
+    screenshotUrl?: number;
+    status?: number;
+}
+export declare function parseTestCases(content: string, format: string, tenantId: string, mapping?: ColumnMapping, scenarioContext?: string[], filePath?: string, sourcePlatform?: string): Promise<{
+    cases: ParsedTestCase[];
+    errors: string[];
+}>;
+/** Stable 8-char hex key for a header set (order-independent). */
+export declare function headerSignature(headers: string[]): string;
+export interface InferMappingResult {
+    mapping: ColumnMapping;
+    source: 'ai' | 'saved' | 'heuristic';
+    signature: string;
+    headers: string[];
+    sampleRows: string[][];
+}
+/**
+ * Load or infer a column mapping for the given headers.
+ * Order: saved → AI inference → heuristic synonym fallback.
+ */
+export declare function inferColumnMapping(headers: string[], sampleRows: string[][], tenantId: string): Promise<InferMappingResult>;
+export declare function saveColumnMapping(tenantId: string, signature: string, mapping: ColumnMapping): Promise<void>;
+export declare function loadColumnMapping(tenantId: string, signature: string): Promise<ColumnMapping | null>;
+/**
+ * Coerce an untrusted (LLM- or client-supplied) object into a valid ParsedTestCase.
+ * Returns null when the object cannot represent a test case.
+ */
+export declare function sanitizeParsedCase(tc: any): ParsedTestCase | null;
+/**
+ * Extract headers and up to `maxSamples` data rows from the first sheet
+ * of a markdown-table artifact. Used by the /infer-mapping route.
+ */
+export declare function extractTabularHeaders(content: string, maxSamples?: number): {
+    headers: string[];
+    sampleRows: string[][];
+};
+/** Stable cache key from a scenario context string — strips count hint, normalises. */
+export declare function scenarioContextKey(ctx: string): string;
+/**
+ * Cache-aware scenario test case generator.
+ * Returns cached cases for previously generated scenarios and only calls LLM for new ones.
+ * `existingCaseCache` is the `scenarioCases` map from `cachedScenarios` in DB.
+ * Returns merged cases + `updatedCache` to persist back.
+ */
+export declare function parseTestCasesWithCache(content: string, tenantId: string, scenarioContext: string[], existingCaseCache: Record<string, ParsedTestCase[]>): Promise<{
+    cases: ParsedTestCase[];
+    errors: string[];
+    updatedCache: Record<string, ParsedTestCase[]>;
+}>;
+/**
+ * Standard JSON.parse, falling back to repairJsonStringLiterals() on failure
+ * (Passes 1+2 of tryParseJsonCases's 3-pass chain below). Exported so other
+ * routes that parse the same real-world-messy FZE JSON exports — e.g.
+ * packages/api/src/routes/functionize.ts, which previously did a bare
+ * JSON.parse with no fallback and would throw on the exact literal-newline/
+ * unescaped-quote files this repairs — don't need their own copy of this
+ * logic. Pass 3 (extractFzeRawPairs + parseFunctionizeCases) is intentionally
+ * NOT included here: it returns ParsedTestCase[], a different shape than
+ * functionize.ts's own per-key step decoder expects, so wiring it in would
+ * need a larger rewrite of that route's data flow — left as a follow-up.
+ * See docs/101-GAPS-FUNCTIONIZE-MIGRATION-PIPELINE.md §3.1.
+ */
+export declare function parseJsonWithRepair(raw: string): any;
+/**
+ * Line-based raw pair extractor — last-resort fallback for files with unescaped
+ * interior double-quotes inside code/conditional values (e.g. `"qa"` inside a
+ * string). Parses the FZE structure directly without relying on JSON.parse.
+ * Returns one Record<string,string> per JSON object found in the input.
+ */
+export declare function extractFzeRawPairs(content: string): Record<string, string>[];
+/**
+ * Detect Functionize / FZE recording format — a JSON array of flat key→value
+ * maps representing a recorded browser session. Matches on the most distinctive
+ * key patterns present across all known FZE file variants.
+ */
+export declare function isFunctionizeFormat(arr: any[]): boolean;
+export interface ScenarioSummary {
+    id: string;
+    title: string;
+    description: string;
+    sourceSection?: string;
+    requirementId?: string;
+    category?: string;
+    sourceExcerpt?: string;
+    suggestedTestCount: number;
+}
+export declare function extractGroundedScenarioCandidates(content: string): ScenarioSummary[];
+export declare function extractScenarios(content: string, tenantId: string): Promise<{
+    scenarios: ScenarioSummary[];
+    errors: string[];
+}>;
+/**
+ * Parse a Selenium Python script and extract a map of action descriptions → Playwright locators.
+ * Used to annotate FZE test case steps with real locators from matched Selenium recordings.
+ */
+export declare function buildSeleniumHints(pyContent: string): Map<string, string>;
+/**
+ * Annotate parsed test case steps with Playwright locators from Selenium hints.
+ * Matches steps by normalized action text against the hint map.
+ * Adds locatorHint comment to matched steps.
+ */
+export declare function annotateWithSeleniumHints(cases: ParsedTestCase[], hints: Map<string, string>): ParsedTestCase[];