procsi 0.2.6

package/dist/daemon/procsi-client.js

@@ -0,0 +1,25 @@
+/**
+ * Create an in-process ProcsiClient that wraps RequestRepository directly.
+ * Used by interceptors running inside the daemon process.
+ */
+export function createProcsiClient(storage) {
+    return {
+        countRequests: async (filter) => storage.countRequests({ filter }),
+        listRequests: async (options) => storage.listRequestsSummary({
+            filter: options?.filter,
+            limit: options?.limit,
+            offset: options?.offset,
+        }),
+        getRequest: async (id) => storage.getRequest(id) ?? null,
+        searchBodies: async (options) => storage.searchBodies({
+            query: options.query,
+            filter: options.filter,
+            limit: options.limit,
+        }),
+        queryJsonBodies: async (options) => storage.queryJsonBodies({
+            jsonPath: options.jsonPath,
+            filter: options.filter,
+        }),
+    };
+}
+//# sourceMappingURL=procsi-client.js.map

package/dist/daemon/procsi-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procsi-client.js","sourceRoot":"","sources":["../../src/daemon/procsi-client.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA0B;IAC3D,OAAO;QACL,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QAClE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAC9B,OAAO,CAAC,mBAAmB,CAAC;YAC1B,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CAAC;QACJ,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,IAAI;QACxD,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAC9B,OAAO,CAAC,YAAY,CAAC;YACnB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC;QACJ,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CACjC,OAAO,CAAC,eAAe,CAAC;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC;KACL,CAAC;AACJ,CAAC"}

package/dist/daemon/proxy.d.ts

@@ -0,0 +1,34 @@
+import type { Headers } from "mockttp";
+import type { RequestRepository } from "./storage.js";
+import type { InterceptorRunner } from "./interceptor-runner.js";
+import { type LogLevel } from "../shared/logger.js";
+/** Default maximum body size to capture (10MB) */
+export declare const DEFAULT_MAX_BODY_SIZE: number;
+export interface ProxyOptions {
+    port?: number;
+    caKeyPath: string;
+    caCertPath: string;
+    storage: RequestRepository;
+    sessionId: string;
+    label?: string;
+    projectRoot?: string;
+    logLevel?: LogLevel;
+    /** Maximum body size to capture in bytes. Bodies larger than this are not stored but still proxied. */
+    maxBodySize?: number;
+    /** Interceptor runner for mock/modify/observe interceptors */
+    interceptorRunner?: InterceptorRunner;
+}
+export interface ProxyServer {
+    port: number;
+    url: string;
+    stop: () => Promise<void>;
+}
+/**
+ * Create and start a MITM proxy server that captures all HTTP/HTTPS traffic.
+ */
+export declare function createProxy(options: ProxyOptions): Promise<ProxyServer>;
+/**
+ * Flatten mockttp headers (which may have array values) to simple string values.
+ */
+export declare function flattenHeaders(headers: Headers): Record<string, string>;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/daemon/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/daemon/proxy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmC,OAAO,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAelE,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,QAAmB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,uGAAuG;IACvG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAuP7E;AAkBD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYvE"}

package/dist/daemon/proxy.js

@@ -0,0 +1,213 @@
+import * as mockttp from "mockttp";
+import { createLogger } from "../shared/logger.js";
+/** Default maximum body size to capture (10MB) */
+export const DEFAULT_MAX_BODY_SIZE = 10 * 1024 * 1024;
+/**
+ * Create and start a MITM proxy server that captures all HTTP/HTTPS traffic.
+ */
+export async function createProxy(options) {
+    const { storage, sessionId, label, projectRoot, logLevel, interceptorRunner } = options;
+    // Create logger if projectRoot is provided
+    const logger = projectRoot ? createLogger("proxy", projectRoot, logLevel) : undefined;
+    // Map to track request info for response correlation
+    const requestInfo = new Map();
+    const maxBodySize = options.maxBodySize ?? DEFAULT_MAX_BODY_SIZE;
+    const server = mockttp.getLocal({
+        https: {
+            keyPath: options.caKeyPath,
+            certPath: options.caCertPath,
+        },
+        // Record traffic for potential debugging
+        recordTraffic: false,
+        // Limit body capture to prevent memory bloat from large files
+        maxBodySize,
+    });
+    await server.start(options.port);
+    // Set up passthrough rule that captures all traffic
+    // Clean up requestInfo entries for requests that are aborted before completion
+    await server.on("abort", (req) => {
+        const info = requestInfo.get(req.id);
+        if (info && interceptorRunner) {
+            interceptorRunner.cleanup(info.ourId);
+        }
+        requestInfo.delete(req.id);
+    });
+    await server.forAnyRequest().thenPassThrough({
+        // Ignore certificate errors when connecting to upstream servers
+        ignoreHostHttpsErrors: true,
+        beforeRequest: async (request) => {
+            const timestamp = Date.now();
+            // Parse URL to extract host and path
+            const url = new URL(request.url);
+            // Convert headers to simple object
+            const headers = flattenHeaders(request.headers);
+            // Detect if body was truncated due to maxBodySize
+            // Body is truncated if we got an empty buffer but Content-Length indicates data
+            const contentLength = parseInt(headers["content-length"] ?? "0", 10);
+            const requestBodyTruncated = request.body.buffer.length === 0 && contentLength > 0;
+            // Decode compressed request body (gzip, br, deflate) for storage.
+            // The actual request to the upstream server is unmodified.
+            const decodedBody = request.body.buffer.length > 0
+                ? ((await request.body.getDecodedBuffer()) ?? request.body.buffer)
+                : undefined;
+            // Strip content-encoding from stored headers since we store the decoded body
+            const storedHeaders = { ...headers };
+            delete storedHeaders["content-encoding"];
+            logger?.trace("Request received", {
+                method: request.method,
+                url: request.url,
+                headers: storedHeaders,
+                bodyTruncated: requestBodyTruncated,
+            });
+            // Save request to storage and track the ID
+            const ourId = storage.saveRequest({
+                sessionId,
+                label,
+                timestamp,
+                method: request.method,
+                url: request.url,
+                host: url.host,
+                path: url.pathname + url.search,
+                requestHeaders: storedHeaders,
+                requestBody: decodedBody,
+                requestBodyTruncated,
+            });
+            // Store mapping from mockttp ID to our ID and timestamp
+            requestInfo.set(request.id, { ourId, timestamp, requestBodyTruncated });
+            // Run interceptor if available
+            if (interceptorRunner) {
+                const interceptorRequest = {
+                    method: request.method,
+                    url: request.url,
+                    host: url.host,
+                    path: url.pathname + url.search,
+                    headers: { ...storedHeaders },
+                    body: decodedBody,
+                };
+                const result = await interceptorRunner.handleRequest(ourId, interceptorRequest);
+                if (result?.mockResponse && result.interception) {
+                    // Mock — interceptor returned a response without calling forward()
+                    storage.updateRequestInterception(ourId, result.interception.name, result.interception.type);
+                    const mockBody = typeof result.mockResponse.body === "string"
+                        ? Buffer.from(result.mockResponse.body)
+                        : result.mockResponse.body;
+                    storage.updateRequestResponse(ourId, {
+                        status: result.mockResponse.status,
+                        headers: result.mockResponse.headers ?? {},
+                        body: mockBody,
+                        durationMs: Date.now() - timestamp,
+                        responseBodyTruncated: false,
+                    });
+                    return {
+                        response: buildMockttpResponse(result.mockResponse),
+                    };
+                }
+                if (result?.interception) {
+                    // forward() was called — record interception metadata, let proxy continue
+                    storage.updateRequestInterception(ourId, result.interception.name, result.interception.type);
+                }
+            }
+            // Return undefined to pass through without modification
+            return undefined;
+        },
+        beforeResponse: async (response, request) => {
+            const info = requestInfo.get(request.id);
+            requestInfo.delete(request.id);
+            if (!info) {
+                // Request wasn't tracked (shouldn't happen, but handle gracefully)
+                return undefined;
+            }
+            const durationMs = Date.now() - info.timestamp;
+            // Convert headers to simple object
+            const headers = flattenHeaders(response.headers);
+            // Detect if body was truncated due to maxBodySize
+            const contentLength = parseInt(headers["content-length"] ?? "0", 10);
+            const responseBodyTruncated = response.body.buffer.length === 0 && contentLength > 0;
+            // Decode compressed body (gzip, br, deflate) for storage.
+            // The actual response to the client is unmodified.
+            const decodedBody = response.body.buffer.length > 0
+                ? ((await response.body.getDecodedBuffer()) ?? response.body.buffer)
+                : undefined;
+            // Strip content-encoding from stored headers since we store the decoded body
+            const storedHeaders = { ...headers };
+            delete storedHeaders["content-encoding"];
+            logger?.trace("Response sent", {
+                status: response.statusCode,
+                durationMs,
+                url: request.url,
+                bodyTruncated: responseBodyTruncated,
+            });
+            // Run interceptor response handler if available
+            if (interceptorRunner) {
+                const upstreamResponse = {
+                    status: response.statusCode,
+                    headers: { ...storedHeaders },
+                    body: decodedBody,
+                };
+                const interceptResult = await interceptorRunner.handleResponse(info.ourId, upstreamResponse);
+                if (interceptResult?.responseOverride && interceptResult.interception) {
+                    // Handler modified the response after forward()
+                    storage.updateRequestInterception(info.ourId, interceptResult.interception.name, interceptResult.interception.type);
+                    const overrideBody = typeof interceptResult.responseOverride.body === "string"
+                        ? Buffer.from(interceptResult.responseOverride.body)
+                        : interceptResult.responseOverride.body;
+                    storage.updateRequestResponse(info.ourId, {
+                        status: interceptResult.responseOverride.status,
+                        headers: interceptResult.responseOverride.headers ?? storedHeaders,
+                        body: overrideBody,
+                        durationMs,
+                        responseBodyTruncated: false,
+                    });
+                    return buildMockttpResponse(interceptResult.responseOverride);
+                }
+                if (interceptResult?.interception) {
+                    // Observe mode — record interception metadata but don't modify response
+                    storage.updateRequestInterception(info.ourId, interceptResult.interception.name, interceptResult.interception.type);
+                }
+            }
+            // Update request with response data using our ID
+            storage.updateRequestResponse(info.ourId, {
+                status: response.statusCode,
+                headers: storedHeaders,
+                body: decodedBody,
+                durationMs,
+                responseBodyTruncated,
+            });
+            // Return undefined to pass through without modification
+            return undefined;
+        },
+    });
+    return {
+        port: server.port,
+        url: server.url,
+        stop: async () => {
+            await server.stop();
+        },
+    };
+}
+/**
+ * Convert an InterceptorResponse into the shape mockttp expects for mock/modified responses.
+ */
+function buildMockttpResponse(response) {
+    return {
+        statusCode: response.status,
+        headers: response.headers,
+        body: response.body,
+    };
+}
+/**
+ * Flatten mockttp headers (which may have array values) to simple string values.
+ */
+export function flattenHeaders(headers) {
+    const result = {};
+    for (const [key, value] of Object.entries(headers)) {
+        if (Array.isArray(value)) {
+            result[key] = value.join(", ");
+        }
+        else if (value !== undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=proxy.js.map

package/dist/daemon/proxy.js.map

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

package/dist/daemon/storage.d.ts

@@ -0,0 +1,130 @@
+import type { CapturedRequest, CapturedRequestSummary, InterceptionType, JsonQueryResult, RequestFilter, Session } from "../shared/types.js";
+import { type LogLevel } from "../shared/logger.js";
+export interface RepositoryOptions {
+    maxStoredRequests?: number;
+}
+export declare class RequestRepository {
+    private db;
+    private logger;
+    private maxStoredRequests;
+    private insertsSinceLastEvictionCheck;
+    constructor(dbPath: string, projectRoot?: string, logLevel?: LogLevel, options?: RepositoryOptions);
+    /**
+     * Apply pending database migrations using SQLite's user_version pragma for tracking.
+     */
+    private applyMigrations;
+    /**
+     * Register a new session.
+     */
+    registerSession(label?: string, pid?: number): Session;
+    /**
+     * Ensure a session exists with a specific ID.
+     * If the session already exists, returns it unchanged.
+     * If not, creates a new session with the given ID.
+     */
+    ensureSession(id: string, label?: string, pid?: number): Session;
+    /**
+     * Get a session by ID.
+     */
+    getSession(id: string): Session | undefined;
+    /**
+     * List all sessions.
+     */
+    listSessions(): Session[];
+    /**
+     * Save a captured request. Returns the generated ID.
+     */
+    saveRequest(request: Omit<CapturedRequest, "id">): string;
+    /**
+     * Update a request with response data.
+     */
+    updateRequestResponse(id: string, response: {
+        status: number;
+        headers: Record<string, string>;
+        body?: Buffer;
+        durationMs: number;
+        responseBodyTruncated?: boolean;
+    }): void;
+    /**
+     * Update a request with interceptor metadata.
+     */
+    updateRequestInterception(id: string, interceptedBy: string, interceptionType: InterceptionType): void;
+    /**
+     * Get a request by ID.
+     */
+    getRequest(id: string): CapturedRequest | undefined;
+    /**
+     * List requests, optionally filtered by session or label.
+     */
+    listRequests(options?: {
+        sessionId?: string;
+        label?: string;
+        limit?: number;
+        offset?: number;
+        filter?: RequestFilter;
+    }): CapturedRequest[];
+    /**
+     * List request summaries (excludes body/header data for performance).
+     * Use this for list views where full request data isn't needed.
+     */
+    listRequestsSummary(options?: {
+        sessionId?: string;
+        label?: string;
+        limit?: number;
+        offset?: number;
+        filter?: RequestFilter;
+    }): CapturedRequestSummary[];
+    /**
+     * Count requests, optionally filtered by session or label.
+     */
+    countRequests(options?: {
+        sessionId?: string;
+        label?: string;
+        filter?: RequestFilter;
+    }): number;
+    /**
+     * Search through request/response body content for a text pattern.
+     * Only searches text-based bodies (not binary).
+     */
+    searchBodies(options: {
+        query: string;
+        limit?: number;
+        offset?: number;
+        filter?: RequestFilter;
+    }): CapturedRequestSummary[];
+    /**
+     * Query JSON bodies using SQLite's json_extract.
+     * Only queries rows with JSON content types.
+     */
+    queryJsonBodies(options: {
+        jsonPath: string;
+        value?: string;
+        target?: "request" | "response" | "both";
+        limit?: number;
+        offset?: number;
+        filter?: RequestFilter;
+    }): JsonQueryResult[];
+    /**
+     * Delete all requests (useful for cleanup).
+     */
+    clearRequests(): void;
+    /**
+     * Reclaim disk space by checkpointing the WAL and vacuuming.
+     * Intended for use during shutdown — not suitable for the hot path.
+     */
+    compactDatabase(): void;
+    /**
+     * Close the database connection.
+     */
+    close(): void;
+    /**
+     * Check whether the request count exceeds the cap and evict oldest rows.
+     * Only runs the actual COUNT query every EVICTION_CHECK_INTERVAL inserts
+     * to keep the hot path cheap.
+     */
+    private evictIfNeeded;
+    private rowToSummary;
+    private safeParseHeaders;
+    private rowToRequest;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/daemon/storage.d.ts.map

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