@opencode-trace/plugin 0.0.3

package/README.md

@@ -0,0 +1,124 @@
+# @opencode-trace/plugin
+
+OpenCode plugin for automatically tracing AI API interactions.
+
+[![npm version](https://img.shields.io/npm/v/@opencode-trace/plugin)](https://www.npmjs.com/package/@opencode-trace/plugin)
+
+## Installation
+
+Install OpenCode plugin:
+
+```bash
+opencode plugin @opencode-trace/plugin
+```
+
+Or add in OpenCode configuration file (`opencode.json`):
+
+```json
+{
+  "plugin": ["@opencode-trace/plugin"]
+}
+```
+
+## Usage
+
+After installation, the plugin automatically intercepts all HTTP requests from OpenCode and records them to `~/.opencode-trace/`.
+
+No manual operation required, every interaction with AI is automatically traced.
+
+### Tracing Content
+
+- Complete request (URL, Headers, Body)
+- Complete response (Status, Headers, Body)
+- SSE stream data (incremental tokens)
+- Token usage statistics (input/output)
+- Latency metrics (first token latency TTFT, token interval TPOT)
+- Error information (failed requests)
+
+### Supported APIs
+
+- OpenAI Chat Completions API
+- OpenAI Responses API (new format)
+- Anthropic Messages API
+
+### Trace Control
+
+Control tracing via CLI or Viewer:
+
+```bash
+# CLI
+opencode-trace enable              # Enable global tracing
+opencode-trace disable             # Disable global tracing
+opencode-trace status              # View status
+
+# Or use Viewer web interface
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `OPENCODE_TRACE_DIR` | Custom trace directory (default `~/.opencode-trace`) |
+| `OPENCODE_TRACE_REDACT` | Whether to redact sensitive information (default `true`) |
+
+### Redaction Rules
+
+The plugin automatically redacts the following sensitive information:
+
+- HTTP Headers: `authorization`, `api-key`, `x-api-key`, etc.
+- Stack traces: user paths, IP addresses, ports
+
+Can disable redaction via `OPENCODE_TRACE_REDACT=false`.
+
+## Data Storage
+
+Trace data storage structure:
+
+```
+~/.opencode-trace/
+├── <session-id>/          # Session directory
+│   ├── 1.json             # 1st request record
+│   ├── 1.sse              # SSE stream data
+│   ├── 2.json             # 2nd request record
+│   ├── metadata.json      # Session metadata
+├── state.db               # SQLite state database
+```
+
+## Tools
+
+The plugin provides the following OpenCode tools:
+
+| Tool | Description |
+|------|-------------|
+| `trace_enable` | Enable tracing |
+| `trace_disable` | Disable tracing |
+| `trace_status` | View tracing status |
+
+Can be called directly in conversation:
+
+```
+User: Please enable tracing
+AI: [calls trace_enable tool] Tracing enabled
+```
+
+## Troubleshooting
+
+### Tracing Not Working
+
+1. Confirm plugin installed: check `opencode.json` configuration
+2. Confirm tracing enabled: run `opencode-trace status`
+3. Check directory permissions: ensure `~/.opencode-trace` is writable
+
+### SQLite Corrupted
+
+Run repair command:
+
+```bash
+opencode-trace sync --repair
+```
+
+## License
+
+MIT

package/dist/integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=integration.test.d.ts.map

package/dist/integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.d.ts","sourceRoot":"","sources":["../src/integration.test.ts"],"names":[],"mappings":""}

package/dist/integration.test.js

@@ -0,0 +1,76 @@
+import { describe, test, expect, beforeEach, afterEach } from "vitest";
+import { TracePlugin } from "./plugin-instance.js";
+import { mkdtempSync, rmSync, readdirSync, readFileSync, existsSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+async function waitForFiles(dir, count, timeoutMs = 5000) {
+    const startTime = Date.now();
+    while (true) {
+        if (existsSync(dir)) {
+            const files = readdirSync(dir).filter(f => f.endsWith(".json"));
+            if (files.length >= count) {
+                let allValid = true;
+                for (const file of files) {
+                    try {
+                        const content = readFileSync(join(dir, file), "utf-8");
+                        if (!content || content.length === 0) {
+                            allValid = false;
+                            break;
+                        }
+                        JSON.parse(content);
+                    }
+                    catch {
+                        allValid = false;
+                        break;
+                    }
+                }
+                if (allValid)
+                    return;
+            }
+        }
+        if (Date.now() - startTime > timeoutMs) {
+            throw new Error(`Timeout waiting for ${count} valid files in ${dir} after ${timeoutMs}ms`);
+        }
+        await new Promise(r => setTimeout(r, 10));
+    }
+}
+describe("Integration: TracePlugin full flow", () => {
+    let tempDir;
+    let plugin;
+    beforeEach(async () => {
+        tempDir = mkdtempSync(join(tmpdir(), "integration-test-"));
+        plugin = new TracePlugin(tempDir);
+    });
+    afterEach(() => {
+        plugin.uninstallInterceptor();
+        rmSync(tempDir, { recursive: true, force: true });
+    });
+    test("multiple concurrent requests are recorded in order", async () => {
+        const originalFetch = globalThis.fetch;
+        globalThis.fetch = async (input) => {
+            const req = new Request(input);
+            await new Promise(resolve => setTimeout(resolve, 50));
+            return new Response(JSON.stringify({ url: req.url }), { status: 200 });
+        };
+        plugin.installInterceptor();
+        await plugin.initStateManager();
+        const sessionId = "concurrent-test";
+        plugin["stateManager"].startSession(sessionId);
+        const requests = Array.from({ length: 5 }, (_, i) => plugin.tracedFetch(`https://example.com/${i}`, {
+            method: "GET",
+            headers: { "x-opencode-session": sessionId }
+        }));
+        const responses = await Promise.all(requests);
+        expect(responses.every(r => r.status === 200)).toBe(true);
+        const sessionDir = join(tempDir, sessionId);
+        await waitForFiles(sessionDir, 5);
+        const files = readdirSync(sessionDir).filter(f => f.endsWith(".json")).sort();
+        expect(files.length).toBe(5);
+        for (let i = 0; i < 5; i++) {
+            const content = JSON.parse(readFileSync(join(sessionDir, files[i]), "utf-8"));
+            expect(content.id).toBe(i + 1);
+        }
+        globalThis.fetch = originalFetch;
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/integration.test.js.map

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

package/dist/plugin-instance.d.ts

@@ -0,0 +1,29 @@
+import { StateManager } from "@opencode-trace/core/state";
+export declare class TracePlugin {
+    private origFetch;
+    private ids;
+    private writeQueue;
+    private stateQueue;
+    private stateManager;
+    private interceptorInstalled;
+    private traceDir;
+    constructor(traceDir: string);
+    tracedFetch(input: Parameters<typeof globalThis.fetch>[0], init?: Parameters<typeof globalThis.fetch>[1]): Promise<Response>;
+    private getSessionId;
+    private shouldRecord;
+    private parseBody;
+    private headersToObject;
+    private classifyPurpose;
+    private parseRequest;
+    private captureRequestMeta;
+    private wrapStreamResponse;
+    private recordResponse;
+    private sanitizeStackTrace;
+    private createTraceRecord;
+    getInterceptor(): typeof fetch;
+    installInterceptor(): void;
+    uninstallInterceptor(): void;
+    initStateManager(): Promise<void>;
+    getStateManager(): StateManager | null;
+}
+//# sourceMappingURL=plugin-instance.d.ts.map

package/dist/plugin-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-instance.d.ts","sourceRoot":"","sources":["../src/plugin-instance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAQ1D,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,GAAG,CAAkC;IAC7C,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,oBAAoB,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAOtB,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;IA+BlI,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,YAAY;YAQN,kBAAkB;IAqChC,OAAO,CAAC,kBAAkB;YAyBZ,cAAc;IAiC5B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,iBAAiB;IAuBzB,cAAc,IAAI,OAAO,KAAK;IAI9B,kBAAkB,IAAI,IAAI;IAO1B,oBAAoB,IAAI,IAAI;IAMtB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOvC,eAAe,IAAI,YAAY,GAAG,IAAI;CAGvC"}

package/dist/plugin-instance.js

@@ -0,0 +1,219 @@
+import { AsyncWriteQueue } from "./write-queue.js";
+import { AsyncStateQueue } from "./state-queue.js";
+import { StateManager } from "@opencode-trace/core/state";
+import { redactHeaders } from "./redact.js";
+import { sanitizePath } from "@opencode-trace/core";
+import { homedir } from "node:os";
+import { logger } from "@opencode-trace/core";
+export class TracePlugin {
+    origFetch;
+    ids = new Map();
+    writeQueue;
+    stateQueue;
+    stateManager = null;
+    interceptorInstalled = false;
+    traceDir;
+    constructor(traceDir) {
+        this.traceDir = traceDir;
+        this.origFetch = globalThis.fetch; // Will be updated in installInterceptor
+        this.writeQueue = new AsyncWriteQueue(traceDir);
+        this.stateQueue = new AsyncStateQueue();
+    }
+    async tracedFetch(input, init) {
+        const req = this.parseRequest(input, init);
+        if (!req)
+            return this.origFetch(input, init);
+        const meta = await this.captureRequestMeta(req);
+        if (!meta)
+            return this.origFetch(req);
+        let res;
+        try {
+            res = await this.origFetch(req);
+        }
+        catch (err) {
+            const error = err instanceof Error
+                ? { message: err.message, stack: this.sanitizeStackTrace(err.stack) }
+                : { message: String(err) };
+            const record = this.createTraceRecord(meta.seq, meta.purpose, meta.requestAt, meta.traceReq, null, error, { requestSentAt: meta.requestSentAt });
+            this.writeQueue.enqueue(meta.session, meta.seq, record);
+            this.stateQueue.enqueue(meta.session, meta.seq, record);
+            throw err;
+        }
+        let latencyMeta;
+        if (meta.isStream && res.body) {
+            res = this.wrapStreamResponse(res, meta.requestSentAt);
+            latencyMeta = res.__latencyMeta;
+        }
+        void this.recordResponse(meta.session, meta.seq, meta.purpose, meta.requestAt, meta.traceReq, res, latencyMeta);
+        return res;
+    }
+    getSessionId(req) {
+        return req.headers.get("x-opencode-session") ?? req.headers.get("x-session-affinity") ?? req.headers.get("session_id") ?? undefined;
+    }
+    shouldRecord(sessionId) {
+        if (!this.stateManager)
+            return true;
+        this.stateManager.reload();
+        return this.stateManager.isTraceEnabled(sessionId);
+    }
+    parseBody(text) {
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text || null;
+        }
+    }
+    headersToObject(headers) {
+        const obj = {};
+        headers.forEach((value, key) => { obj[key] = value; });
+        return obj;
+    }
+    classifyPurpose(raw) {
+        if (typeof raw === "object" && raw !== null && !Array.isArray(raw) && Array.isArray(raw.tools) && raw.tools.length > 0)
+            return "";
+        return "[meta]";
+    }
+    parseRequest(input, init) {
+        try {
+            return new Request(input, init);
+        }
+        catch {
+            return null;
+        }
+    }
+    async captureRequestMeta(req) {
+        const session = this.getSessionId(req);
+        if (session === undefined)
+            return null;
+        if (!this.shouldRecord(session))
+            return null;
+        const seq = (this.ids.get(session) ?? 0) + 1;
+        this.ids.set(session, seq);
+        const requestSentAt = performance.now();
+        const requestAt = new Date().toISOString();
+        const reqBodyText = await req.clone().text().catch((err) => {
+            logger.error("Failed to clone request body", { url: req.url, error: String(err) });
+            return "";
+        });
+        const reqBody = this.parseBody(reqBodyText);
+        let isStream = false;
+        try {
+            isStream = JSON.parse(reqBodyText ?? "{}")?.stream === true;
+        }
+        catch {
+            isStream = false;
+        }
+        const purpose = this.classifyPurpose(reqBody);
+        const traceReq = {
+            method: req.method,
+            url: req.url,
+            headers: redactHeaders(this.headersToObject(req.headers)),
+            body: reqBody,
+        };
+        return { session, seq, requestSentAt, requestAt, reqBody, isStream, purpose, traceReq };
+    }
+    wrapStreamResponse(res, requestSentAt) {
+        const latencyMeta = { requestSentAt, firstTokenAt: null, lastTokenAt: null };
+        const transform = new TransformStream({
+            transform(chunk, controller) {
+                if (latencyMeta.firstTokenAt === null) {
+                    latencyMeta.firstTokenAt = performance.now();
+                }
+                controller.enqueue(chunk);
+            },
+            flush() {
+                latencyMeta.lastTokenAt = performance.now();
+            },
+        });
+        const wrappedBody = res.body.pipeThrough(transform);
+        const wrappedRes = new Response(wrappedBody, {
+            status: res.status,
+            statusText: res.statusText,
+            headers: res.headers,
+        });
+        wrappedRes.__latencyMeta = latencyMeta;
+        return wrappedRes;
+    }
+    async recordResponse(session, seq, purpose, requestAt, traceReq, res, latencyMeta) {
+        try {
+            const resBodyText = await res.clone().text();
+            const resBody = this.parseBody(resBodyText);
+            const traceRes = {
+                status: res.status,
+                statusText: res.statusText,
+                headers: redactHeaders(this.headersToObject(res.headers)),
+                body: resBody,
+            };
+            const normalizedLatency = latencyMeta ? {
+                requestSentAt: latencyMeta.requestSentAt,
+                firstTokenAt: latencyMeta.firstTokenAt ?? undefined,
+                lastTokenAt: latencyMeta.lastTokenAt ?? undefined,
+            } : undefined;
+            const record = this.createTraceRecord(seq, purpose, requestAt, traceReq, traceRes, null, normalizedLatency);
+            this.writeQueue.enqueue(session, seq, record);
+            this.stateQueue.enqueue(session, seq, record);
+        }
+        catch (err) {
+            const error = err instanceof Error
+                ? { message: err.message, stack: this.sanitizeStackTrace(err.stack) }
+                : { message: String(err) };
+            const normalizedLatency = latencyMeta ? {
+                requestSentAt: latencyMeta.requestSentAt,
+                firstTokenAt: latencyMeta.firstTokenAt ?? undefined,
+                lastTokenAt: latencyMeta.lastTokenAt ?? undefined,
+            } : undefined;
+            const record = this.createTraceRecord(seq, purpose, requestAt, traceReq, null, error, normalizedLatency);
+            this.writeQueue.enqueue(session, seq, record);
+            this.stateQueue.enqueue(session, seq, record);
+        }
+    }
+    sanitizeStackTrace(stack) {
+        if (!stack)
+            return undefined;
+        const userHome = homedir();
+        return sanitizePath(stack, userHome)
+            .replace(/\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b/g, '[IP]')
+            .replace(/:\d{4,5}(?=[\/\\\s]|$)/g, ':[PORT]');
+    }
+    createTraceRecord(seq, purpose, requestAt, traceReq, traceRes, error, latency) {
+        return {
+            id: seq,
+            purpose,
+            requestAt,
+            responseAt: new Date().toISOString(),
+            request: traceReq,
+            response: traceRes,
+            error,
+            requestSentAt: latency?.requestSentAt,
+            firstTokenAt: latency?.firstTokenAt ?? undefined,
+            lastTokenAt: latency?.lastTokenAt ?? undefined,
+        };
+    }
+    getInterceptor() {
+        return this.tracedFetch.bind(this);
+    }
+    installInterceptor() {
+        if (this.interceptorInstalled)
+            return;
+        this.origFetch = globalThis.fetch; // Capture current fetch at installation time
+        globalThis.fetch = this.getInterceptor();
+        this.interceptorInstalled = true;
+    }
+    uninstallInterceptor() {
+        if (!this.interceptorInstalled)
+            return;
+        globalThis.fetch = this.origFetch;
+        this.interceptorInstalled = false;
+    }
+    async initStateManager() {
+        this.stateManager = new StateManager(this.traceDir);
+        await this.stateManager.init();
+        this.stateManager.sync();
+        this.stateQueue.setStateManager(this.stateManager);
+    }
+    getStateManager() {
+        return this.stateManager;
+    }
+}
+//# sourceMappingURL=plugin-instance.js.map

package/dist/plugin-instance.js.map

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

package/dist/plugin-instance.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin-instance.test.d.ts.map

package/dist/plugin-instance.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-instance.test.d.ts","sourceRoot":"","sources":["../src/plugin-instance.test.ts"],"names":[],"mappings":""}

package/dist/plugin-instance.test.js

@@ -0,0 +1,135 @@
+import { describe, test, expect, beforeEach, afterEach } from "vitest";
+import { TracePlugin } from "./plugin-instance.js";
+import { mkdtempSync, rmSync, readFileSync, existsSync } from "node:fs";
+import { tmpdir, homedir } from "node:os";
+import { join } from "node:path";
+async function waitForFile(filePath, timeoutMs = 5000) {
+    const startTime = Date.now();
+    while (true) {
+        if (existsSync(filePath)) {
+            try {
+                const content = readFileSync(filePath, "utf-8");
+                if (content && content.length > 0) {
+                    JSON.parse(content);
+                    return;
+                }
+            }
+            catch {
+            }
+        }
+        if (Date.now() - startTime > timeoutMs) {
+            throw new Error(`Timeout waiting for valid file ${filePath} after ${timeoutMs}ms`);
+        }
+        await new Promise(r => setTimeout(r, 10));
+    }
+}
+describe("TracePlugin", () => {
+    let tempDir;
+    let plugin;
+    beforeEach(() => {
+        tempDir = mkdtempSync(join(tmpdir(), "plugin-test-"));
+        plugin = new TracePlugin(tempDir);
+    });
+    afterEach(() => {
+        plugin.uninstallInterceptor();
+        rmSync(tempDir, { recursive: true, force: true });
+    });
+    test("constructor initializes write and state queues", () => {
+        expect(plugin).toBeDefined();
+        expect(plugin["writeQueue"]).toBeDefined();
+        expect(plugin["stateQueue"]).toBeDefined();
+    });
+    test("installInterceptor installs traced fetch", () => {
+        const originalFetch = globalThis.fetch;
+        plugin.installInterceptor();
+        expect(globalThis.fetch).not.toBe(originalFetch);
+    });
+    test("uninstallInterceptor restores original fetch", () => {
+        const originalFetch = globalThis.fetch;
+        plugin.installInterceptor();
+        plugin.uninstallInterceptor();
+        expect(globalThis.fetch).toBe(originalFetch);
+    });
+    test("installInterceptor is idempotent (can be called twice)", () => {
+        const originalFetch = globalThis.fetch;
+        plugin.installInterceptor();
+        const firstInterceptor = globalThis.fetch;
+        plugin.installInterceptor(); // Should not change
+        expect(globalThis.fetch).toBe(firstInterceptor);
+        plugin.uninstallInterceptor();
+        expect(globalThis.fetch).toBe(originalFetch);
+    });
+    test("uninstallInterceptor is safe when not installed", () => {
+        const originalFetch = globalThis.fetch;
+        plugin.uninstallInterceptor(); // Should not throw or change
+        expect(globalThis.fetch).toBe(originalFetch);
+    });
+    test("can reinstall after uninstall", () => {
+        const originalFetch = globalThis.fetch;
+        plugin.installInterceptor();
+        plugin.uninstallInterceptor();
+        plugin.installInterceptor(); // Should work again
+        expect(globalThis.fetch).not.toBe(originalFetch);
+        plugin.uninstallInterceptor();
+        expect(globalThis.fetch).toBe(originalFetch);
+    });
+    test("tracedFetch writes records via writeQueue", async () => {
+        // Mock fetch BEFORE installing interceptor so origFetch captures the mock
+        const mockFetch = async () => {
+            return new Response(JSON.stringify({ result: "ok" }), {
+                status: 200,
+                headers: { "content-type": "application/json" }
+            });
+        };
+        globalThis.fetch = mockFetch;
+        plugin.installInterceptor();
+        const sessionId = "test-session";
+        const request = new Request("https://example.com", {
+            method: "POST",
+            headers: {
+                "x-opencode-session": sessionId,
+                "content-type": "application/json"
+            },
+            body: JSON.stringify({ test: true })
+        });
+        const response = await plugin.tracedFetch(request);
+        const filePath = join(tempDir, sessionId, "1.json");
+        await waitForFile(filePath, 5000);
+        expect(existsSync(filePath)).toBe(true);
+        const content = JSON.parse(readFileSync(filePath, "utf-8"));
+        expect(content.request.method).toBe("POST");
+        expect(content.response.status).toBe(200);
+    });
+    test("sanitizeStackTrace removes sensitive information", () => {
+        const sanitizeStackTrace = plugin["sanitizeStackTrace"];
+        const userHome = homedir();
+        const stack = `Error at ${userHome}/sensitive/path/file.ts:10:5
+Connection to 192.168.1.100:8080 failed
+Server running on 127.0.0.1:3000`;
+        const sanitized = sanitizeStackTrace(stack);
+        expect(sanitized).toContain('[HOME]');
+        expect(sanitized).toContain('[IP]');
+        expect(sanitized).toContain(':[PORT]');
+        expect(sanitized).not.toContain(userHome);
+        expect(sanitized).not.toContain('192.168.1.100');
+        expect(sanitized).not.toContain('127.0.0.1');
+        expect(sanitized).not.toContain(':8080');
+        expect(sanitized).not.toContain(':3000');
+    });
+    test("sanitizeStackTrace redacts ports in Windows paths", () => {
+        const sanitizeStackTrace = plugin["sanitizeStackTrace"];
+        const userHome = homedir();
+        const windowsStack = `Error at ${userHome}\\project\\file.ts:10:5
+Connection to 10.0.0.1:8080 failed
+Listening on 0.0.0.0:3000`;
+        const sanitized = sanitizeStackTrace(windowsStack);
+        expect(sanitized).toContain('[HOME]');
+        expect(sanitized).toContain('[IP]');
+        expect(sanitized).toContain(':[PORT]');
+        expect(sanitized).not.toContain('10.0.0.1');
+        expect(sanitized).not.toContain('0.0.0.0');
+        expect(sanitized).not.toContain(':8080');
+        expect(sanitized).not.toContain(':3000');
+    });
+});
+//# sourceMappingURL=plugin-instance.test.js.map

package/dist/plugin-instance.test.js.map

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

package/dist/redact.d.ts

@@ -0,0 +1,2 @@
+export declare function redactHeaders(headers: Record<string, string>): Record<string, string>;
+//# sourceMappingURL=redact.d.ts.map

package/dist/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAmBA,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBxB"}