arc-1 1.0.2 → 1.1.0

package/dist/adt/aunit.d.ts

@@ -0,0 +1,143 @@
+/** ABAP Unit result semantics and the public async/JUnit API. */
+import type { AdtHttpClient, AdtRequestOptions } from './http.js';
+import { type SafetyConfig } from './safety.js';
+import type { CoverageSummary } from './types.js';
+export type AunitOutcome = 'passed' | 'failed' | 'no_tests' | 'incomplete';
+export type AunitTestStatus = 'passed' | 'failed' | 'error' | 'skipped';
+export type AunitAlertScope = 'run' | 'program' | 'class' | 'method';
+export interface AunitStackEntry {
+    uri?: string;
+    type?: string;
+    name?: string;
+    description?: string;
+}
+export interface AunitAlert {
+    scope: AunitAlertScope;
+    program?: string;
+    testClass?: string;
+    testMethod?: string;
+    kind: string;
+    severity: string;
+    title: string;
+    details: string[];
+    message: string;
+    stack: AunitStackEntry[];
+}
+export interface AunitTestCase {
+    program: string;
+    testClass: string;
+    testMethod: string;
+    status: AunitTestStatus;
+    durationMs?: number;
+    riskLevel?: string;
+    durationCategory?: string;
+    alerts: AunitAlert[];
+}
+export interface AunitSummary {
+    tests: number;
+    passed: number;
+    failures: number;
+    errors: number;
+    skipped: number;
+    warnings: number;
+}
+export interface AunitRunResult {
+    outcome: AunitOutcome;
+    summary: AunitSummary;
+    selection: {
+        maxRisk: 'harmless';
+        durations: Array<'short' | 'medium' | 'long'>;
+    };
+    tests: AunitTestCase[];
+    alerts: AunitAlert[];
+    coverage?: CoverageSummary;
+    coverageEvidence?: 'available' | 'unavailable' | 'not_requested';
+    coverageUnavailableReason?: 'measurement_not_reported' | 'request_failed' | 'no_valid_metrics';
+    sourceSelectionEvidence?: AunitSourceSelectionEvidence;
+}
+export type AunitDeclaredRiskLevel = 'harmless' | 'dangerous' | 'critical';
+export interface AunitSourceTestClass {
+    program?: string;
+    testClass: string;
+    riskLevel: AunitDeclaredRiskLevel;
+    explicitRiskLevel: boolean;
+}
+export interface AunitSourceSelectionEvidence {
+    status: 'verified' | 'unavailable';
+    declaredTestClasses: AunitSourceTestClass[];
+    omittedTestClasses: AunitSourceTestClass[];
+    omittedNonHarmlessTestClasses: AunitSourceTestClass[];
+    reason?: string;
+}
+export interface AunitSourceAuditOptions {
+    complete?: boolean;
+    incompleteReason?: string;
+}
+export interface AunitProgramSource {
+    program: string;
+    source: string;
+}
+export interface NativeJunitSummary {
+    tests: number;
+    failures: number;
+    errors: number;
+    skipped: number;
+    outcome: AunitOutcome;
+}
+export interface PublicAunitResult {
+    protocol: 'public-api';
+    runPath: string;
+    resultPath: string;
+    status: string;
+    junit: string;
+    summary: NativeJunitSummary;
+    elapsedMs: number;
+    polls: number;
+}
+export declare class AunitIncompleteError extends Error {
+    readonly evidence: {
+        elapsedMs: number;
+        polls: number;
+        status: string;
+    };
+    constructor(message: string, evidence: {
+        elapsedMs: number;
+        polls: number;
+        status: string;
+    }, options?: ErrorOptions);
+}
+interface PublicAunitOptions {
+    timeoutMs?: number;
+    deadline?: number;
+    signal?: AbortSignal;
+    includeSubpackages?: boolean;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}
+export declare const DEFAULT_PUBLIC_AUNIT_TIMEOUT_MS = 300000;
+/** Find executable, non-deferred ABAP Unit class definitions without matching comments/literals. */
+export declare function findSourceDeclaredAunitClasses(source: string): AunitSourceTestClass[];
+/** Static INCLUDE names used to expand program source before auditing test declarations. */
+export declare function findStaticAbapIncludes(source: string): string[];
+/**
+ * Reconcile SAP's harmless-only result with test classes declared in one inspected source tree.
+ * SAP 7.58 can omit a dangerous/critical class from both result formats without an alert; source
+ * evidence closes that false-green while ordinary and deferred helper classes remain ignored.
+ */
+export declare function reconcileAunitSourceDeclarations(result: AunitRunResult, source: string, options?: AunitSourceAuditOptions): AunitRunResult;
+/** Reconcile a multi-program package run without conflating common local names such as LTCL_TEST. */
+export declare function reconcileAunitProgramSources(result: AunitRunResult, sources: AunitProgramSource[], options?: AunitSourceAuditOptions): AunitRunResult;
+/** Parse legacy `/abapunit/testruns` XML without turning non-method alerts into fake tests. */
+export declare function parseAunitRunResult(xml: string): AunitRunResult;
+export declare function withAunitCoverage(result: AunitRunResult, coverage: CoverageSummary | undefined, unavailableReason?: AunitRunResult['coverageUnavailableReason']): AunitRunResult;
+/** Generate JUnit from the corrected legacy model. Non-method alerts stay in system-err. */
+export declare function aunitResultToJunit(result: AunitRunResult, suiteName?: string): string;
+export declare function aunitIncompleteToJunit(message: string, suiteName?: string): string;
+export declare function parseNativeJunitSummary(xml: string): NativeJunitSummary;
+/** Preserve SAP-native suites and append one red reconciliation testcase with truthful root counters. */
+export declare function appendAunitJunitDiagnostic(junit: string, summary: NativeJunitSummary, outcome: 'failed' | 'incomplete', message: string): string;
+export declare function probePublicAunit(http: AdtHttpClient, safety: SafetyConfig, options?: AdtRequestOptions): Promise<boolean>;
+/** Run harmless-only AUnit through the public async endpoint and return SAP-native JUnit. */
+export declare function runPublicAunit(http: AdtHttpClient, safety: SafetyConfig, type: string, name: string, options?: PublicAunitOptions): Promise<PublicAunitResult>;
+export {};
+//# sourceMappingURL=aunit.d.ts.map

package/dist/adt/aunit.d.ts.map

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