@vibe-validate/extractors 0.17.6 → 0.18.0

package/dist/test/helpers/extractor-test-helpers.js

@@ -0,0 +1,238 @@
+/**
+ * Shared test helpers for error extractor plugins
+ *
+ * Eliminates duplication across extractor tests by providing common assertion
+ * patterns for detection, extraction, metadata, and error object validation.
+ *
+ * @package @vibe-validate/extractors
+ */
+import { expect } from 'vitest';
+/**
+ * Verify plugin metadata matches expected values
+ *
+ * Reduces duplication in plugin metadata tests by consolidating common
+ * assertions for name, priority, hints, and tags.
+ *
+ * @param plugin - The extractor plugin to test
+ * @param expected - Expected metadata values
+ *
+ * @example
+ * ```typescript
+ * expectPluginMetadata(vitestPlugin, {
+ *   name: 'vitest',
+ *   priority: 85,
+ *   requiredHints: [],
+ *   anyOfHints: ['FAIL', 'test.ts', '❯'],
+ * });
+ * ```
+ */
+export function expectPluginMetadata(plugin, expected) {
+    expect(plugin.metadata.name).toBe(expected.name);
+    expect(plugin.priority).toBe(expected.priority);
+    if (expected.requiredHints !== undefined) {
+        if (expected.requiredHints.length === 0) {
+            expect(plugin.hints?.required ?? []).toEqual([]);
+        }
+        else {
+            for (const hint of expected.requiredHints) {
+                expect(plugin.hints?.required).toContain(hint);
+            }
+        }
+    }
+    if (expected.anyOfHints !== undefined) {
+        for (const hint of expected.anyOfHints) {
+            expect(plugin.hints?.anyOf).toContain(hint);
+        }
+    }
+    if (expected.tags !== undefined) {
+        for (const tag of expected.tags) {
+            expect(plugin.metadata.tags).toContain(tag);
+        }
+    }
+}
+/**
+ * Verify detection result matches expected confidence and patterns
+ *
+ * Reduces duplication in detect() tests by consolidating confidence checks,
+ * pattern verification, and reason validation.
+ *
+ * @param plugin - The extractor plugin
+ * @param output - Test output string to detect
+ * @param expected - Expected detection results
+ *
+ * @example
+ * ```typescript
+ * // Exact confidence
+ * expectDetection(vitestPlugin, sampleOutput, {
+ *   confidence: 90,
+ *   patterns: ['Vitest', 'test failure marker'],
+ *   reasonContains: 'Vitest'
+ * });
+ *
+ * // Confidence range
+ * expectDetection(vitestPlugin, sampleOutput, {
+ *   confidence: { min: 70, max: 95 },
+ *   reasonContains: 'Vitest'
+ * });
+ *
+ * // No detection
+ * expectDetection(vitestPlugin, 'random text', {
+ *   confidence: 0
+ * });
+ * ```
+ */
+export function expectDetection(plugin, output, expected) {
+    const result = plugin.detect(output);
+    // Check confidence (exact value or range)
+    if (typeof expected.confidence === 'number') {
+        expect(result.confidence).toBe(expected.confidence);
+    }
+    else {
+        if (expected.confidence.min !== undefined) {
+            expect(result.confidence).toBeGreaterThanOrEqual(expected.confidence.min);
+        }
+        if (expected.confidence.max !== undefined) {
+            expect(result.confidence).toBeLessThanOrEqual(expected.confidence.max);
+        }
+    }
+    // Check patterns
+    if (expected.patterns !== undefined) {
+        for (const pattern of expected.patterns) {
+            expect(result.patterns).toContain(pattern);
+        }
+    }
+    // Check reason
+    if (expected.reasonContains !== undefined) {
+        expect(result.reason).toContain(expected.reasonContains);
+    }
+}
+/**
+ * Verify extraction result structure matches expected values
+ *
+ * Reduces duplication in extract() tests by consolidating common assertions
+ * for error count, summary, guidance, and errorSummary.
+ *
+ * @param result - Extract result to verify
+ * @param expected - Expected result structure
+ *
+ * @example
+ * ```typescript
+ * const result = extract(output);
+ * expectExtractionResult(result, {
+ *   errorCount: 3,
+ *   summaryPattern: '3 test failure(s)',
+ *   guidanceContains: ['Fix each failing test'],
+ *   errorSummaryContains: ['Test 1/3']
+ * });
+ *
+ * // With regex
+ * expectExtractionResult(result, {
+ *   errorCount: 5,
+ *   summaryPattern: /5 (test|error)/,
+ * });
+ * ```
+ */
+export function expectExtractionResult(result, expected) {
+    expect(result.errors).toHaveLength(expected.errorCount);
+    expect(result.totalErrors).toBe(expected.errorCount);
+    if (expected.summaryPattern !== undefined) {
+        if (typeof expected.summaryPattern === 'string') {
+            expect(result.summary).toBe(expected.summaryPattern);
+        }
+        else {
+            expect(result.summary).toMatch(expected.summaryPattern);
+        }
+    }
+    if (expected.guidanceContains !== undefined) {
+        for (const text of expected.guidanceContains) {
+            expect(result.guidance).toContain(text);
+        }
+    }
+    if (expected.errorSummaryContains !== undefined) {
+        for (const text of expected.errorSummaryContains) {
+            expect(result.errorSummary).toContain(text);
+        }
+    }
+}
+/**
+ * Verify empty or no-match output behavior
+ *
+ * Reduces duplication in edge case tests by consolidating assertions for
+ * empty string and non-matching output scenarios.
+ *
+ * @param extractFn - Extract function to test
+ * @param expectedSummary - Expected summary for empty/no-match cases (string or regex)
+ *
+ * @example
+ * ```typescript
+ * expectEmptyExtraction(vitestPlugin.extract, '0 test failure(s)');
+ * expectEmptyExtraction(eslintPlugin.extract, '0 ESLint error(s), 0 warning(s)');
+ * expectEmptyExtraction(junitPlugin.extract, /0 test.*failed/);
+ * ```
+ */
+export function expectEmptyExtraction(extractFn, expectedSummary) {
+    const result = extractFn('');
+    expect(result.errors).toHaveLength(0);
+    expect(result.totalErrors).toBe(0);
+    if (typeof expectedSummary === 'string') {
+        expect(result.summary).toBe(expectedSummary);
+    }
+    else {
+        expect(result.summary).toMatch(expectedSummary);
+    }
+}
+/**
+ * Verify individual error object fields match expected values
+ *
+ * Reduces duplication in error validation tests by consolidating assertions
+ * for file, line, column, message, severity, and code fields.
+ *
+ * @param error - The error object to verify
+ * @param expected - Expected field values
+ *
+ * @example
+ * ```typescript
+ * // Basic fields
+ * expectErrorObject(result.errors[0], {
+ *   file: 'test/example.test.ts',
+ *   line: 57,
+ *   column: 30,
+ *   messageContains: 'expected 3000 to be 9999'
+ * });
+ *
+ * // Multiple message fragments
+ * expectErrorObject(result.errors[0], {
+ *   file: 'src/index.ts',
+ *   line: 42,
+ *   messageContains: ['Type error', 'not assignable'],
+ *   severity: 'error',
+ *   code: 'TS2322'
+ * });
+ * ```
+ */
+export function expectErrorObject(error, expected) {
+    if (expected.file !== undefined) {
+        expect(error.file).toBe(expected.file);
+    }
+    if (expected.line !== undefined) {
+        expect(error.line).toBe(expected.line);
+    }
+    if (expected.column !== undefined) {
+        expect(error.column).toBe(expected.column);
+    }
+    if (expected.messageContains !== undefined) {
+        const messages = Array.isArray(expected.messageContains)
+            ? expected.messageContains
+            : [expected.messageContains];
+        for (const msg of messages) {
+            expect(error.message).toContain(msg);
+        }
+    }
+    if (expected.severity !== undefined) {
+        expect(error.severity).toBe(expected.severity);
+    }
+    if (expected.code !== undefined) {
+        expect(error.code).toBe(expected.code);
+    }
+}
+//# sourceMappingURL=extractor-test-helpers.js.map

package/dist/test/helpers/extractor-test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor-test-helpers.js","sourceRoot":"","sources":["../../../src/test/helpers/extractor-test-helpers.ts"],"names":[],"mappings":"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"}

package/dist/test/helpers/max-errors-helper.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Shared test helper for MAX_ERRORS_IN_ARRAY truncation behavior
+ *
+ * Eliminates duplication across extractor tests that verify error array truncation.
+ *
+ * @package @vibe-validate/extractors
+ */
+import type { ErrorExtractorResult } from '../../types.js';
+/**
+ * Options for MAX_ERRORS_IN_ARRAY truncation assertion
+ */
+interface MaxErrorsOptions {
+    /** Expected totalErrors count (e.g., 15) */
+    totalCount: number;
+    /** Expected value for first error (file or message content) */
+    firstError: string;
+    /** Expected value for last kept error at index 9 (file or message content) */
+    lastTruncatedError: string;
+    /** Regex or string to match in summary (e.g., "15 test failure(s)") */
+    summaryPattern: string | RegExp;
+    /** Field to check ('file' or 'message'). Defaults to 'file' */
+    checkField?: 'file' | 'message';
+    /** For 'message' field, use contains check instead of exact match */
+    messageContains?: boolean;
+}
+/**
+ * Assert MAX_ERRORS_IN_ARRAY truncation behavior
+ *
+ * Verifies that extractors correctly:
+ * 1. Preserve full error count in totalErrors
+ * 2. Truncate errors array to MAX_ERRORS_IN_ARRAY
+ * 3. Return first N errors in order
+ * 4. Include full count in summary
+ *
+ * @param result - Extraction result to verify
+ * @param options - Assertion options
+ *
+ * @example
+ * ```typescript
+ * // Check file field (default)
+ * const result = extract(fifteenErrors);
+ * await expectMaxErrorsTruncation(result, {
+ *   totalCount: 15,
+ *   firstError: 'file1.ts',
+ *   lastTruncatedError: 'file10.ts',
+ *   summaryPattern: '15 test failure(s)'
+ * });
+ *
+ * // Check message field with contains
+ * await expectMaxErrorsTruncation(result, {
+ *   totalCount: 15,
+ *   firstError: 'test 1',
+ *   lastTruncatedError: 'test 10',
+ *   summaryPattern: /15 test/,
+ *   checkField: 'message',
+ *   messageContains: true
+ * });
+ * ```
+ */
+export declare function expectMaxErrorsTruncation(result: ErrorExtractorResult, options: MaxErrorsOptions): Promise<void>;
+export {};
+//# sourceMappingURL=max-errors-helper.d.ts.map

package/dist/test/helpers/max-errors-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"max-errors-helper.d.ts","sourceRoot":"","sources":["../../../src/test/helpers/max-errors-helper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;GAEG;AACH,UAAU,gBAAgB;IACxB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,qEAAqE;IACrE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/test/helpers/max-errors-helper.js

@@ -0,0 +1,75 @@
+/**
+ * Shared test helper for MAX_ERRORS_IN_ARRAY truncation behavior
+ *
+ * Eliminates duplication across extractor tests that verify error array truncation.
+ *
+ * @package @vibe-validate/extractors
+ */
+import { expect } from 'vitest';
+/**
+ * Assert MAX_ERRORS_IN_ARRAY truncation behavior
+ *
+ * Verifies that extractors correctly:
+ * 1. Preserve full error count in totalErrors
+ * 2. Truncate errors array to MAX_ERRORS_IN_ARRAY
+ * 3. Return first N errors in order
+ * 4. Include full count in summary
+ *
+ * @param result - Extraction result to verify
+ * @param options - Assertion options
+ *
+ * @example
+ * ```typescript
+ * // Check file field (default)
+ * const result = extract(fifteenErrors);
+ * await expectMaxErrorsTruncation(result, {
+ *   totalCount: 15,
+ *   firstError: 'file1.ts',
+ *   lastTruncatedError: 'file10.ts',
+ *   summaryPattern: '15 test failure(s)'
+ * });
+ *
+ * // Check message field with contains
+ * await expectMaxErrorsTruncation(result, {
+ *   totalCount: 15,
+ *   firstError: 'test 1',
+ *   lastTruncatedError: 'test 10',
+ *   summaryPattern: /15 test/,
+ *   checkField: 'message',
+ *   messageContains: true
+ * });
+ * ```
+ */
+export async function expectMaxErrorsTruncation(result, options) {
+    const { totalCount, firstError, lastTruncatedError, summaryPattern, checkField = 'file', messageContains = false } = options;
+    // Import MAX_ERRORS_IN_ARRAY to verify we're testing the right value
+    const { MAX_ERRORS_IN_ARRAY } = await import('../../result-schema.js');
+    // totalErrors should preserve full count
+    expect(result.totalErrors).toBe(totalCount);
+    // errors array should be truncated to MAX_ERRORS_IN_ARRAY
+    expect(result.errors).toHaveLength(MAX_ERRORS_IN_ARRAY);
+    expect(result.errors).toHaveLength(10); // Explicit check for documentation
+    // Verify we got the first N errors (in order)
+    if (checkField === 'file') {
+        expect(result.errors[0].file).toBe(firstError);
+        expect(result.errors[9].file).toBe(lastTruncatedError);
+    }
+    else if (messageContains) {
+        // Check message field with contains
+        expect(result.errors[0].message).toContain(firstError);
+        expect(result.errors[9].message).toContain(lastTruncatedError);
+    }
+    else {
+        // Check message field with exact match
+        expect(result.errors[0].message).toBe(firstError);
+        expect(result.errors[9].message).toBe(lastTruncatedError);
+    }
+    // Summary should show full count
+    if (typeof summaryPattern === 'string') {
+        expect(result.summary).toBe(summaryPattern);
+    }
+    else {
+        expect(result.summary).toMatch(summaryPattern);
+    }
+}
+//# sourceMappingURL=max-errors-helper.js.map

package/dist/test/helpers/max-errors-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"max-errors-helper.js","sourceRoot":"","sources":["../../../src/test/helpers/max-errors-helper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAsBhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAA4B,EAC5B,OAAyB;IAEzB,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,GAAG,MAAM,EAAE,eAAe,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAE7H,qEAAqE;IACrE,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAEvE,yCAAyC;IACzC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE5C,0DAA0D;IAC1D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IACxD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,mCAAmC;IAE3E,8CAA8C;IAC9C,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACzD,CAAC;SAAM,IAAI,eAAe,EAAE,CAAC;QAC3B,oCAAoC;QACpC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IACjE,CAAC;SAAM,CAAC;QACN,uCAAuC;QACvC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC5D,CAAC;IAED,iCAAiC;IACjC,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-validate/extractors",
-  "version": "0.17.6",
+  "version": "0.18.0",
   "description": "LLM-optimized error extractors for validation output",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,6 +9,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/test/helpers/extractor-test-helpers.d.ts",
+      "import": "./dist/test/helpers/extractor-test-helpers.js"
     }
   },
   "files": [
@@ -43,7 +47,7 @@
   "dependencies": {
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.25.0",
-    "@vibe-validate/config": "0.17.6"
+    "@vibe-validate/config": "0.18.0"
   },
   "engines": {
     "node": ">=20.0.0"