@runtimescope/collector 0.7.0 → 0.7.2

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { SecureContextOptions } from 'node:tls';
 
-type EventType = 'network' | 'console' | 'session' | 'state' | 'render' | 'dom_snapshot' | 'performance' | 'database' | 'custom' | 'recon_metadata' | 'recon_design_tokens' | 'recon_fonts' | 'recon_layout_tree' | 'recon_accessibility' | 'recon_computed_styles' | 'recon_element_snapshot' | 'recon_asset_inventory';
+type EventType = 'network' | 'console' | 'session' | 'state' | 'render' | 'dom_snapshot' | 'performance' | 'database' | 'custom' | 'navigation' | 'recon_metadata' | 'recon_design_tokens' | 'recon_fonts' | 'recon_layout_tree' | 'recon_accessibility' | 'recon_computed_styles' | 'recon_element_snapshot' | 'recon_asset_inventory';
 interface BaseEvent {
     eventId: string;
     sessionId: string;
@@ -129,6 +129,12 @@ interface DatabaseEvent extends BaseEvent {
     error?: string;
     params?: string;
 }
+interface NavigationEvent extends BaseEvent {
+    eventType: 'navigation';
+    from: string;
+    to: string;
+    trigger: 'pushState' | 'replaceState' | 'popstate' | 'hashchange' | 'initial';
+}
 interface CustomEvent extends BaseEvent {
     eventType: 'custom';
     name: string;
@@ -460,7 +466,7 @@ interface ReconFilter {
     url?: string;
 }
 type ReconEventType = 'recon_metadata' | 'recon_design_tokens' | 'recon_fonts' | 'recon_layout_tree' | 'recon_accessibility' | 'recon_computed_styles' | 'recon_element_snapshot' | 'recon_asset_inventory';
-type RuntimeEvent = NetworkEvent | ConsoleEvent | SessionEvent | StateEvent | RenderEvent | DomSnapshotEvent | PerformanceEvent | DatabaseEvent | CustomEvent | ReconMetadataEvent | ReconDesignTokensEvent | ReconFontsEvent | ReconLayoutTreeEvent | ReconAccessibilityEvent | ReconComputedStylesEvent | ReconElementSnapshotEvent | ReconAssetInventoryEvent;
+type RuntimeEvent = NetworkEvent | ConsoleEvent | SessionEvent | StateEvent | RenderEvent | DomSnapshotEvent | PerformanceEvent | DatabaseEvent | NavigationEvent | CustomEvent | ReconMetadataEvent | ReconDesignTokensEvent | ReconFontsEvent | ReconLayoutTreeEvent | ReconAccessibilityEvent | ReconComputedStylesEvent | ReconElementSnapshotEvent | ReconAssetInventoryEvent;
 interface NetworkFilter {
     sinceSeconds?: number;
     urlPattern?: string;
@@ -857,16 +863,22 @@ declare class SqliteStore {
     private writeBuffer;
     private flushTimer;
     private readonly batchSize;
+    private readonly dbPath;
+    private static readonly MAX_SNAPSHOTS_PER_SESSION;
     private insertEventStmt;
     private insertSessionStmt;
     private updateSessionDisconnectedStmt;
     constructor(options: SqliteStoreOptions);
+    private openDatabase;
+    private prepareStatements;
     private createSchema;
     addEvent(event: RuntimeEvent, project: string): void;
     flush(): void;
     saveSession(info: SessionInfoExtended): void;
     updateSessionDisconnected(sessionId: string, disconnectedAt: number): void;
     saveSessionMetrics(sessionId: string, project: string, metrics: unknown, label?: string): void;
+    /** Remove oldest snapshots for a session beyond the retention limit */
+    private pruneSnapshots;
     getEvents(filter: HistoricalFilter): RuntimeEvent[];
     getEventCount(filter: HistoricalFilter): number;
     getSessions(project: string, limit?: number): SessionInfoExtended[];
@@ -1127,6 +1139,7 @@ declare class CollectorServer {
     private connectCallbacks;
     private disconnectCallbacks;
     private pruneTimer;
+    private heartbeatTimer;
     private tlsConfig;
     constructor(options?: CollectorServerOptions);
     getStore(): EventStore;
@@ -1142,6 +1155,10 @@ declare class CollectorServer {
     private tryStart;
     private handleStartError;
     private ensureSqliteStore;
+    /** Catch runtime errors on the WSS so an unhandled error doesn't crash the process */
+    private setupPersistentErrorHandler;
+    /** Ping all connected clients every 15s — terminate those that don't respond */
+    private startHeartbeat;
     private setupConnectionHandler;
     private handleMessage;
     /** Find the WebSocket for a given sessionId */
@@ -1189,10 +1206,16 @@ declare class RingBuffer<T> {
  */
 declare function detectIssues(events: RuntimeEvent[]): DetectedIssue[];
 
+declare function isSqliteAvailable(): boolean;
+
 declare class ApiDiscoveryEngine {
     private endpoints;
     private store;
+    private lastRebuildEventCount;
+    private isDirty;
     constructor(store: EventStore);
+    /** Mark the cache dirty so the next read triggers a rebuild */
+    markDirty(): void;
     rebuild(): void;
     private ingestEvent;
     private refineEndpoints;
@@ -1344,6 +1367,7 @@ interface PmProject {
     path?: string;
     claudeProjectKey?: string;
     runtimescopeProject?: string;
+    runtimeApps?: string[];
     phase: ProjectPhase;
     managementAuthorized: boolean;
     probableToComplete: boolean;
@@ -1674,12 +1698,17 @@ declare class HttpServer {
     private sdkBundlePath;
     private activePort;
     private startedAt;
+    private connectedSessionsGetter;
     constructor(store: EventStore, processMonitor?: ProcessMonitor, options?: {
         authManager?: AuthManager;
         allowedOrigins?: string[];
         rateLimiter?: SessionRateLimiter;
         pmStore?: PmStore;
         discovery?: ProjectDiscovery;
+        getConnectedSessions?: () => {
+            sessionId: string;
+            projectName: string;
+        }[];
     });
     private registerRoutes;
     /**
@@ -1723,4 +1752,4 @@ declare function calculateCostMicrodollars(model: string, inputTokens: number, o
  */
 declare function parseSessionJsonl(jsonlPath: string, sessionId: string, projectId: string): Promise<ParseResult>;
 
-export { type ApiChangeRecord, type ApiContract, type ApiContractField, ApiDiscoveryEngine, type ApiEndpoint, type ApiEndpointHealth, type ApiKeyEntry, type AuthConfig, type AuthInfo, AuthManager, BUILT_IN_RULES, type BackgroundSpriteSheet, type BaseEvent, type BuildMeta, type BuildStatus, type CSSArchitecture, type CSSCustomProperty, type CapexClassification, type CapexSummary, CollectorServer, type CollectorServerOptions, type ColorToken, type CommandResponse, type ComputedStyleEntry, ConnectionManager, type ConsoleEvent, type ConsoleFilter, type ConsoleLevel, type CustomEvent, type CustomEventFilter, DataBrowser, type DatabaseConnectionConfig, type DatabaseEvent, type DatabaseFilter, type DatabaseOperation, type DatabaseSchema, type DatabaseSource, type DeployLog, type DetectedBuildTool, type DetectedFramework, type DetectedHosting, type DetectedIssue, type DetectedMetaFramework, type DetectedUILibrary, type DevProcess, type DevProcessType, type DomSnapshotEvent, type ElementSnapshotNode, type EventBatchPayload, EventStore, type EventType, type FontFaceInfo, type FontUsage, type FormFieldInfo, type GitCommit, type GitFileChange, type GitFileStatus, type GitStatus, type GlobalConfig, type GraphQLOperation, type HandshakePayload, type HeadingInfo, type HistoricalFilter, HttpServer, type HttpServerOptions, type IconFontInfo, type ImageAsset, type IndexSuggestion, InfraConnector, type InfraOverview, type InfrastructureConfig, type InlineSVGAsset, type InteractiveElementInfo, type IssueSeverity, type LandmarkInfo, type LayoutNode, type ManagedConnection, type MaskSpriteSheet, type MemoryFile, type MetricDelta, type NetworkEvent, type NetworkFilter, type NormalizedQueryStats, type PerformanceEvent, type PerformanceFilter, type PerformanceMetricName, type PmCapexEntry, type PmNote, type PmProject, type PmSession, PmStore, type PmTask, type PortUsage, ProcessMonitor, type ProjectConfig, ProjectDiscovery, ProjectManager, type ProjectPhase, type ProjectStatus, type RateLimitConfig, type ReadOptions, type ReadResult, type ReconAccessibilityEvent, type ReconAssetInventoryEvent, type ReconComputedStylesEvent, type ReconDesignTokensEvent, type ReconElementSnapshotEvent, type ReconEventType, type ReconFilter, type ReconFontsEvent, type ReconLayoutTreeEvent, type ReconMetadataEvent, type RedactionRule, Redactor, type RedactorConfig, type RenderComponentProfile, type RenderEvent, type RenderFilter, RingBuffer, type RulesFiles, type RuntimeEvent, type RuntimeLog, type SVGSpriteSymbol, type SchemaColumn, type SchemaForeignKey, type SchemaIndex, SchemaIntrospector, type SchemaTable, type ServerCommand, type ServerMetricName, type ServiceInfo, type SessionDiffResult, type SessionEvent, type SessionInfo, type SessionInfoExtended, SessionManager, type SessionMetrics, SessionRateLimiter, type SessionSnapshot, type SessionStats, type SpacingValue, type SpriteFrame, SqliteStore, type SqliteStoreOptions, type StateEvent, type StateFilter, type TaskPriority, type TaskSource, type TaskStatus, type TechStackDetection, type TimelineFilter, type TlsConfig, type ToolResponse, type TypographyToken, type WSMessage, type WebVitalRating, type WorkType, type WriteOptions, type WriteResult, aggregateQueryStats, calculateActiveMinutes, calculateCostMicrodollars, compareSessions, detectIssues, detectN1Queries, detectOverfetching, detectSlowQueries, generateApiKey, loadTlsOptions, parseSessionJsonl, resolveTlsConfig, suggestIndexes };
+export { type ApiChangeRecord, type ApiContract, type ApiContractField, ApiDiscoveryEngine, type ApiEndpoint, type ApiEndpointHealth, type ApiKeyEntry, type AuthConfig, type AuthInfo, AuthManager, BUILT_IN_RULES, type BackgroundSpriteSheet, type BaseEvent, type BuildMeta, type BuildStatus, type CSSArchitecture, type CSSCustomProperty, type CapexClassification, type CapexSummary, CollectorServer, type CollectorServerOptions, type ColorToken, type CommandResponse, type ComputedStyleEntry, ConnectionManager, type ConsoleEvent, type ConsoleFilter, type ConsoleLevel, type CustomEvent, type CustomEventFilter, DataBrowser, type DatabaseConnectionConfig, type DatabaseEvent, type DatabaseFilter, type DatabaseOperation, type DatabaseSchema, type DatabaseSource, type DeployLog, type DetectedBuildTool, type DetectedFramework, type DetectedHosting, type DetectedIssue, type DetectedMetaFramework, type DetectedUILibrary, type DevProcess, type DevProcessType, type DomSnapshotEvent, type ElementSnapshotNode, type EventBatchPayload, EventStore, type EventType, type FontFaceInfo, type FontUsage, type FormFieldInfo, type GitCommit, type GitFileChange, type GitFileStatus, type GitStatus, type GlobalConfig, type GraphQLOperation, type HandshakePayload, type HeadingInfo, type HistoricalFilter, HttpServer, type HttpServerOptions, type IconFontInfo, type ImageAsset, type IndexSuggestion, InfraConnector, type InfraOverview, type InfrastructureConfig, type InlineSVGAsset, type InteractiveElementInfo, type IssueSeverity, type LandmarkInfo, type LayoutNode, type ManagedConnection, type MaskSpriteSheet, type MemoryFile, type MetricDelta, type NavigationEvent, type NetworkEvent, type NetworkFilter, type NormalizedQueryStats, type PerformanceEvent, type PerformanceFilter, type PerformanceMetricName, type PmCapexEntry, type PmNote, type PmProject, type PmSession, PmStore, type PmTask, type PortUsage, ProcessMonitor, type ProjectConfig, ProjectDiscovery, ProjectManager, type ProjectPhase, type ProjectStatus, type RateLimitConfig, type ReadOptions, type ReadResult, type ReconAccessibilityEvent, type ReconAssetInventoryEvent, type ReconComputedStylesEvent, type ReconDesignTokensEvent, type ReconElementSnapshotEvent, type ReconEventType, type ReconFilter, type ReconFontsEvent, type ReconLayoutTreeEvent, type ReconMetadataEvent, type RedactionRule, Redactor, type RedactorConfig, type RenderComponentProfile, type RenderEvent, type RenderFilter, RingBuffer, type RulesFiles, type RuntimeEvent, type RuntimeLog, type SVGSpriteSymbol, type SchemaColumn, type SchemaForeignKey, type SchemaIndex, SchemaIntrospector, type SchemaTable, type ServerCommand, type ServerMetricName, type ServiceInfo, type SessionDiffResult, type SessionEvent, type SessionInfo, type SessionInfoExtended, SessionManager, type SessionMetrics, SessionRateLimiter, type SessionSnapshot, type SessionStats, type SpacingValue, type SpriteFrame, SqliteStore, type SqliteStoreOptions, type StateEvent, type StateFilter, type TaskPriority, type TaskSource, type TaskStatus, type TechStackDetection, type TimelineFilter, type TlsConfig, type ToolResponse, type TypographyToken, type WSMessage, type WebVitalRating, type WorkType, type WriteOptions, type WriteResult, aggregateQueryStats, calculateActiveMinutes, calculateCostMicrodollars, compareSessions, detectIssues, detectN1Queries, detectOverfetching, detectSlowQueries, generateApiKey, isSqliteAvailable, loadTlsOptions, parseSessionJsonl, resolveTlsConfig, suggestIndexes };

package/dist/index.js

@@ -16,10 +16,11 @@ import {
   calculateActiveMinutes,
   calculateCostMicrodollars,
   generateApiKey,
+  isSqliteAvailable,
   loadTlsOptions,
   parseSessionJsonl,
   resolveTlsConfig
-} from "./chunk-6JZXAFPC.js";
+} from "./chunk-TUFSIGGJ.js";
 
 // src/issue-detector.ts
 function detectIssues(events) {
@@ -476,15 +477,26 @@ function endpointKey(method, normalizedPath, baseUrl) {
 var ApiDiscoveryEngine = class {
   endpoints = /* @__PURE__ */ new Map();
   store;
+  lastRebuildEventCount = 0;
+  isDirty = true;
   constructor(store) {
     this.store = store;
   }
+  /** Mark the cache dirty so the next read triggers a rebuild */
+  markDirty() {
+    this.isDirty = true;
+  }
   rebuild() {
-    this.endpoints.clear();
     const events = this.store.getNetworkRequests();
+    if (!this.isDirty && events.length === this.lastRebuildEventCount) {
+      return;
+    }
+    this.endpoints.clear();
     for (const event of events) {
       this.ingestEvent(event);
     }
+    this.lastRebuildEventCount = events.length;
+    this.isDirty = false;
   }
   ingestEvent(event) {
     const { baseUrl, normalizedPath } = normalizeUrl(event.url);
@@ -2091,6 +2103,7 @@ export {
   detectOverfetching,
   detectSlowQueries,
   generateApiKey,
+  isSqliteAvailable,
   loadTlsOptions,
   parseSessionJsonl,
   resolveTlsConfig,