brakit 0.7.4 → 0.7.5

package/dist/api.d.ts

@@ -101,6 +101,54 @@ type TelemetryEvent = {
     data: Omit<TracedQuery, "id">;
 };
 
+interface SessionMetric {
+    sessionId: string;
+    startedAt: number;
+    avgDurationMs: number;
+    p95DurationMs: number;
+    requestCount: number;
+    errorCount: number;
+    avgQueryCount: number;
+    avgQueryTimeMs: number;
+    avgFetchTimeMs: number;
+}
+interface EndpointMetrics {
+    endpoint: string;
+    sessions: SessionMetric[];
+    dataPoints?: LiveRequestPoint[];
+}
+interface MetricsData {
+    version: 1;
+    endpoints: EndpointMetrics[];
+}
+interface LiveRequestPoint {
+    timestamp: number;
+    durationMs: number;
+    statusCode: number;
+    queryCount: number;
+    queryTimeMs: number;
+    fetchTimeMs: number;
+}
+interface LiveEndpointSummary {
+    p95Ms: number;
+    errorRate: number;
+    avgQueryCount: number;
+    totalRequests: number;
+    avgQueryTimeMs: number;
+    avgFetchTimeMs: number;
+    avgAppTimeMs: number;
+}
+interface LiveEndpointData {
+    endpoint: string;
+    requests: LiveRequestPoint[];
+    summary: LiveEndpointSummary;
+}
+interface RequestMetrics {
+    queryCount: number;
+    queryTimeMs: number;
+    fetchTimeMs: number;
+}
+
 type SecuritySeverity = "critical" | "warning" | "info";
 interface SecurityFinding {
     severity: SecuritySeverity;
@@ -140,7 +188,7 @@ declare class SecurityScanner {
 declare function createDefaultScanner(): SecurityScanner;
 
 type InsightSeverity = "critical" | "warning" | "info";
-type InsightType = "n1" | "cross-endpoint" | "redundant-query" | "error" | "error-hotspot" | "duplicate" | "slow" | "query-heavy" | "select-star" | "high-rows" | "large-response" | "response-overfetch" | "security";
+type InsightType = "n1" | "cross-endpoint" | "redundant-query" | "error" | "error-hotspot" | "duplicate" | "slow" | "query-heavy" | "select-star" | "high-rows" | "large-response" | "response-overfetch" | "security" | "regression";
 interface Insight {
     severity: InsightSeverity;
     type: InsightType;
@@ -155,8 +203,44 @@ interface InsightContext {
     queries: readonly TracedQuery[];
     errors: readonly TracedError[];
     flows: readonly RequestFlow[];
+    fetches: readonly TracedFetch[];
+    previousMetrics?: readonly EndpointMetrics[];
     securityFindings?: readonly SecurityFinding[];
 }
+interface EndpointGroup {
+    total: number;
+    errors: number;
+    totalDuration: number;
+    queryCount: number;
+    totalSize: number;
+    totalQueryTimeMs: number;
+    totalFetchTimeMs: number;
+    queryShapeDurations: Map<string, {
+        totalMs: number;
+        count: number;
+        label: string;
+    }>;
+}
+interface PreparedInsightContext extends InsightContext {
+    nonStatic: readonly TracedRequest[];
+    queriesByReq: ReadonlyMap<string, TracedQuery[]>;
+    fetchesByReq: ReadonlyMap<string, TracedFetch[]>;
+    reqById: ReadonlyMap<string, TracedRequest>;
+    endpointGroups: ReadonlyMap<string, EndpointGroup>;
+}
+
+interface InsightRule {
+    id: InsightType;
+    check(ctx: PreparedInsightContext): Insight[];
+}
+
+declare class InsightRunner {
+    private rules;
+    register(rule: InsightRule): void;
+    run(ctx: InsightContext): Insight[];
+}
+
+declare function createDefaultInsightRunner(): InsightRunner;
 declare function computeInsights(ctx: InsightContext): Insight[];
 
 declare function detectProject(rootDir: string): Promise<DetectedProject>;
@@ -170,8 +254,37 @@ declare class AdapterRegistry {
     getActive(): readonly BrakitAdapter[];
 }
 
+interface MetricsPersistence {
+    load(): MetricsData;
+    save(data: MetricsData): void;
+    saveSync(data: MetricsData): void;
+    remove(): void;
+}
+
+declare class MetricsStore {
+    private persistence;
+    private data;
+    private endpointIndex;
+    private sessionId;
+    private sessionStart;
+    private flushTimer;
+    private accumulators;
+    private pendingPoints;
+    constructor(persistence: MetricsPersistence);
+    start(): void;
+    stop(): void;
+    recordRequest(req: TracedRequest, metrics: RequestMetrics): void;
+    getAll(): readonly EndpointMetrics[];
+    getEndpoint(endpoint: string): EndpointMetrics | undefined;
+    getLiveEndpoints(): LiveEndpointData[];
+    reset(): void;
+    flush(sync?: boolean): void;
+    private getOrCreateEndpoint;
+}
+
 type AnalysisListener = (insights: Insight[], findings: SecurityFinding[]) => void;
 declare class AnalysisEngine {
+    private metricsStore;
     private debounceMs;
     private scanner;
     private cachedInsights;
@@ -182,7 +295,7 @@ declare class AnalysisEngine {
     private boundQueryListener;
     private boundErrorListener;
     private boundLogListener;
-    constructor(debounceMs?: number);
+    constructor(metricsStore: MetricsStore, debounceMs?: number);
     start(): void;
     stop(): void;
     onUpdate(fn: AnalysisListener): void;
@@ -195,4 +308,4 @@ declare class AnalysisEngine {
 
 declare const VERSION: string;
 
-export { AdapterRegistry, AnalysisEngine, type BrakitAdapter, type BrakitConfig, type DetectedProject, type FlatHeaders, type Framework, type HttpMethod, type Insight, type InsightContext, type NormalizedOp, type RequestCategory, type RequestListener, type SecurityContext, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type TracedRequest, VERSION, computeInsights, createDefaultScanner, detectProject };
+export { AdapterRegistry, AnalysisEngine, type BrakitAdapter, type BrakitConfig, type DetectedProject, type FlatHeaders, type Framework, type HttpMethod, type Insight, type InsightContext, type InsightRule, InsightRunner, type NormalizedOp, type RequestCategory, type RequestListener, type SecurityContext, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type TracedRequest, VERSION, computeInsights, createDefaultInsightRunner, createDefaultScanner, detectProject };