@capybara-devtools/core 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lhphuc99
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# @capybara-devtools/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Client runtime and built-in plugins (console, network, storage) shared by the [Capybara](https://github.com/lhphuc99/capybara#readme) SDKs.
+
+To use Capybara in an app, install [`@capybara-devtools/web`](https://www.npmjs.com/package/@capybara-devtools/web) or [`@capybara-devtools/react-native`](https://www.npmjs.com/package/@capybara-devtools/react-native) instead.

package/dist/client.d.ts

@@ -0,0 +1,50 @@
+import { type EventKind, type EventPayloads, type LogLevel, type SerializedValue, type SessionInfo } from '@capybara-devtools/protocol';
+import { type SerializeOptions } from './serialize.js';
+import { type SocketFactory } from './transport.js';
+type ConsoleMethod = (...args: unknown[]) => void;
+export interface PluginContext {
+    emit<K extends EventKind>(kind: K, payload: EventPayloads[K]): void;
+    serialize(value: unknown): SerializedValue;
+    /** Console methods saved before any plugin patched them. SDK diagnostics written here are not captured. */
+    console: {
+        log: ConsoleMethod;
+        warn: ConsoleMethod;
+        error: ConsoleMethod;
+    };
+}
+export interface Plugin {
+    name: string;
+    /** Install hooks. The returned function must undo them. */
+    setup?(ctx: PluginContext): void | (() => void);
+    /** Handlers for commands sent from the UI, keyed by method name. */
+    commands?: Record<string, (params: any) => unknown>;
+}
+export interface ClientOptions {
+    /** e.g. `ws://192.168.1.5:7357/client` */
+    url: string;
+    session: Omit<SessionInfo, 'id' | 'startedAt'>;
+    plugins?: Plugin[];
+    /** Events kept for replay after a reconnect. Default 2000. */
+    maxBufferEvents?: number;
+    /** Approximate size cap of the replay buffer in characters. Default 8 MiB. */
+    maxBufferBytes?: number;
+    /** Milliseconds to batch events before sending. Default 50. */
+    flushInterval?: number;
+    serializeOptions?: SerializeOptions;
+    socketFactory?: SocketFactory;
+}
+export interface CapybaraClient {
+    readonly session: SessionInfo;
+    /** True once the server has acknowledged this session. */
+    readonly connected: boolean;
+    /** Log without going through `console`, e.g. from a custom logger. */
+    log(level: LogLevel, ...args: unknown[]): void;
+    /** Restores patched globals and closes the connection. */
+    stop(): void;
+}
+/** Where the active client lives on `globalThis`. The Metro bridge checks it to leave apps with the SDK alone. */
+export declare const CLIENT_GLOBAL = "__CAPYBARA_CLIENT__";
+export declare function getActiveClient(): CapybaraClient | undefined;
+export declare function createClient(options: ClientOptions): CapybaraClient;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,eAAe,EAEpB,KAAK,WAAW,EACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAmC,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGrF,KAAK,aAAa,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACpE,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAAC;IAC3C,2GAA2G;IAC3G,OAAO,EAAE;QAAE,GAAG,EAAE,aAAa,CAAC;QAAC,IAAI,EAAE,aAAa,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC;CAC5E;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,CAAC,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAChD,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,sEAAsE;IACtE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/C,0DAA0D;IAC1D,IAAI,IAAI,IAAI,CAAC;CACd;AAED,kHAAkH;AAClH,eAAO,MAAM,aAAa,wBAAwB,CAAC;AASnD,wBAAgB,eAAe,IAAI,cAAc,GAAG,SAAS,CAE5D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAyKnE"}

package/dist/client.js

@@ -0,0 +1,185 @@
+import { PROTOCOL_VERSION, } from '@capybara-devtools/protocol';
+import { serialize } from './serialize.js';
+import { Connection, nativeSocketFactory } from './transport.js';
+import { errorMessage, randomId } from './utils.js';
+/** Where the active client lives on `globalThis`. The Metro bridge checks it to leave apps with the SDK alone. */
+export const CLIENT_GLOBAL = '__CAPYBARA_CLIENT__';
+const MAX_BATCH_EVENTS = 200;
+const MAX_BATCH_CHARS = 512 * 1024;
+export function getActiveClient() {
+    return globalThis[CLIENT_GLOBAL];
+}
+export function createClient(options) {
+    // Two clients would patch console and network twice.
+    getActiveClient()?.stop();
+    const session = { ...options.session, id: randomId(), startedAt: Date.now() };
+    const maxEvents = options.maxBufferEvents ?? 2_000;
+    const maxChars = options.maxBufferBytes ?? 8 * 1024 * 1024;
+    const flushInterval = options.flushInterval ?? 50;
+    const plugins = options.plugins ?? [];
+    const originalConsole = {
+        log: console.log.bind(console),
+        warn: console.warn.bind(console),
+        error: console.error.bind(console),
+    };
+    // Events are stringified once when recorded, so replaying them after a reconnect costs nothing extra.
+    const buffer = [];
+    let bufferChars = 0;
+    let seq = 0;
+    let sentSeq = 0;
+    let ready = false;
+    let stopped = false;
+    let flushTimer = null;
+    const serializeValue = (value) => serialize(value, options.serializeOptions);
+    const send = (message) => connection.send(JSON.stringify(message));
+    const emit = (kind, payload) => {
+        if (stopped)
+            return;
+        let json;
+        try {
+            json = JSON.stringify({ seq: seq + 1, ts: Date.now(), kind, payload });
+        }
+        catch {
+            return;
+        }
+        seq++;
+        buffer.push({ seq, json });
+        bufferChars += json.length;
+        while (buffer.length > 1 && (buffer.length > maxEvents || bufferChars > maxChars)) {
+            bufferChars -= buffer.shift().json.length;
+        }
+        scheduleFlush();
+    };
+    const scheduleFlush = () => {
+        if (!ready || flushTimer !== null)
+            return;
+        flushTimer = setTimeout(flush, flushInterval);
+    };
+    const indexAfter = (afterSeq) => {
+        let i = buffer.length;
+        while (i > 0 && buffer[i - 1].seq > afterSeq)
+            i--;
+        return i;
+    };
+    const flush = () => {
+        flushTimer = null;
+        if (!ready)
+            return;
+        let i = indexAfter(sentSeq);
+        while (i < buffer.length) {
+            const parts = [];
+            let chars = 0;
+            while (i < buffer.length && parts.length < MAX_BATCH_EVENTS && (parts.length === 0 || chars < MAX_BATCH_CHARS)) {
+                const item = buffer[i];
+                parts.push(item.json);
+                chars += item.json.length;
+                i++;
+            }
+            // Leave sentSeq alone on failure; the events go out again after the next welcome.
+            if (!connection.send(`{"t":"events","events":[${parts.join(',')}]}`))
+                return;
+            sentSeq = buffer[i - 1].seq;
+        }
+    };
+    const handleCommand = async (id, pluginName, method, params) => {
+        const handler = plugins.find((p) => p.name === pluginName)?.commands?.[method];
+        let reply;
+        if (!handler) {
+            reply = { t: 'result', id, ok: false, error: `Unknown command ${pluginName}.${method}` };
+        }
+        else {
+            try {
+                reply = { t: 'result', id, ok: true, result: await handler(params) };
+            }
+            catch (error) {
+                reply = { t: 'result', id, ok: false, error: errorMessage(error) };
+            }
+        }
+        try {
+            send(reply);
+        }
+        catch (error) {
+            send({ t: 'result', id, ok: false, error: `Result could not be serialized: ${errorMessage(error)}` });
+        }
+    };
+    // Created before plugins run, so WebSocket capture never wraps the SDK's own connection.
+    const connection = new Connection(options.url, options.socketFactory ?? nativeSocketFactory(), {
+        onOpen: () => {
+            send({ t: 'hello', protocol: PROTOCOL_VERSION, session });
+        },
+        onMessage: (data) => {
+            let message;
+            try {
+                message = JSON.parse(data);
+            }
+            catch {
+                return;
+            }
+            switch (message.t) {
+                case 'welcome':
+                    sentSeq = message.lastSeq;
+                    ready = true;
+                    flush();
+                    break;
+                case 'command':
+                    void handleCommand(message.id, message.plugin, message.method, message.params);
+                    break;
+                case 'reject':
+                    originalConsole.warn(`[capybara] Server rejected this app: ${message.reason}`);
+                    connection.stop();
+                    break;
+            }
+        },
+        onClose: () => {
+            ready = false;
+            if (flushTimer !== null) {
+                clearTimeout(flushTimer);
+                flushTimer = null;
+            }
+        },
+    });
+    const ctx = { emit, serialize: serializeValue, console: originalConsole };
+    const teardowns = [];
+    for (const plugin of plugins) {
+        try {
+            const teardown = plugin.setup?.(ctx);
+            if (typeof teardown === 'function')
+                teardowns.push(teardown);
+        }
+        catch (error) {
+            originalConsole.warn(`[capybara] Plugin "${plugin.name}" failed to start:`, error);
+        }
+    }
+    const client = {
+        session,
+        get connected() {
+            return ready;
+        },
+        log(level, ...args) {
+            emit('log', { level, source: 'api', args: args.map(serializeValue) });
+        },
+        stop() {
+            if (stopped)
+                return;
+            stopped = true;
+            ready = false;
+            if (flushTimer !== null)
+                clearTimeout(flushTimer);
+            for (const teardown of teardowns.reverse()) {
+                try {
+                    teardown();
+                }
+                catch {
+                    // keep tearing down the rest
+                }
+            }
+            connection.stop();
+            if (getActiveClient() === client)
+                delete globalThis[CLIENT_GLOBAL];
+        },
+    };
+    globalThis[CLIENT_GLOBAL] = client;
+    connection.start();
+    return client;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { CLIENT_GLOBAL, createClient, getActiveClient } from './client.js';
+export type { ClientOptions, CapybaraClient, Plugin, PluginContext } from './client.js';
+export { serialize } from './serialize.js';
+export type { SerializeOptions } from './serialize.js';
+export type { SocketFactory, SocketLike } from './transport.js';
+export { consolePlugin, type ConsolePluginOptions } from './plugins/console.js';
+export { networkPlugin } from './plugins/network.js';
+export type { NetworkPluginOptions } from './plugins/network.js';
+export { hookWebSockets } from './plugins/websocket.js';
+export type { WebSocketEventKind, WebSocketHookOptions } from './plugins/websocket.js';
+export { storagePlugin } from './plugins/storage.js';
+export type { StorageAdapter } from './plugins/storage.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { CLIENT_GLOBAL, createClient, getActiveClient } from './client.js';
+export { serialize } from './serialize.js';
+export { consolePlugin } from './plugins/console.js';
+export { networkPlugin } from './plugins/network.js';
+export { hookWebSockets } from './plugins/websocket.js';
+export { storagePlugin } from './plugins/storage.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE3E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,aAAa,EAA6B,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/plugins/console.d.ts

@@ -0,0 +1,7 @@
+import type { Plugin } from '../client.js';
+export interface ConsolePluginOptions {
+    /** Calls whose first argument is a string matching one of these are not recorded; they still print. */
+    ignore?: RegExp[];
+}
+export declare function consolePlugin(options?: ConsolePluginOptions): Plugin;
+//# sourceMappingURL=console.d.ts.map

package/dist/plugins/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/plugins/console.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,MAAM,WAAW,oBAAoB;IACnC,uGAAuG;IACvG,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAmCxE"}

package/dist/plugins/console.js

@@ -0,0 +1,40 @@
+const LEVELS = ['debug', 'log', 'info', 'warn', 'error'];
+export function consolePlugin(options = {}) {
+    const ignore = options.ignore ?? [];
+    const ignored = (args) => typeof args[0] === 'string' && ignore.some((pattern) => pattern.test(args[0]));
+    return {
+        name: 'console',
+        setup(ctx) {
+            const target = console;
+            const originals = new Map();
+            // A getter or toJSON hit during serialization may log; recording that would recurse.
+            let capturing = false;
+            for (const level of LEVELS) {
+                const original = target[level];
+                if (typeof original !== 'function')
+                    continue;
+                originals.set(level, original);
+                target[level] = function (...args) {
+                    if (!capturing && !ignored(args)) {
+                        capturing = true;
+                        try {
+                            ctx.emit('log', { level, source: 'console', args: args.map((arg) => ctx.serialize(arg)) });
+                        }
+                        catch {
+                            // logging must keep working even if capture fails
+                        }
+                        finally {
+                            capturing = false;
+                        }
+                    }
+                    return original.apply(this, args);
+                };
+            }
+            return () => {
+                for (const [level, original] of originals)
+                    target[level] = original;
+            };
+        },
+    };
+}
+//# sourceMappingURL=console.js.map

package/dist/plugins/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../src/plugins/console.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,GAAe,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAOrE,MAAM,UAAU,aAAa,CAAC,UAAgC,EAAE;IAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,CAAC,IAAe,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAW,CAAC,CAAC,CAAC;IAC9H,OAAO;QACL,IAAI,EAAE,SAAS;QACf,KAAK,CAAC,GAAG;YACP,MAAM,MAAM,GAAG,OAAoE,CAAC;YACpF,MAAM,SAAS,GAAG,IAAI,GAAG,EAA0C,CAAC;YACpE,qFAAqF;YACrF,IAAI,SAAS,GAAG,KAAK,CAAC;YAEtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC/B,IAAI,OAAO,QAAQ,KAAK,UAAU;oBAAE,SAAS;gBAC7C,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;gBAC/B,MAAM,CAAC,KAAK,CAAC,GAAG,UAAyB,GAAG,IAAe;oBACzD,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;wBACjC,SAAS,GAAG,IAAI,CAAC;wBACjB,IAAI,CAAC;4BACH,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;wBAC7F,CAAC;wBAAC,MAAM,CAAC;4BACP,kDAAkD;wBACpD,CAAC;gCAAS,CAAC;4BACT,SAAS,GAAG,KAAK,CAAC;wBACpB,CAAC;oBACH,CAAC;oBACD,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACpC,CAAC,CAAC;YACJ,CAAC;YAED,OAAO,GAAG,EAAE;gBACV,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,SAAS;oBAAE,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;YACtE,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/network.d.ts

@@ -0,0 +1,18 @@
+import type { Plugin } from '../client.js';
+export interface NetworkPluginOptions {
+    /** Patch `fetch`. Turn off where fetch is built on XHR (whatwg-fetch), or each request is recorded twice. */
+    fetch?: boolean;
+    xhr?: boolean;
+    /** Record WebSocket connections and their messages. Default true. */
+    websocket?: boolean;
+    /** Requests and WebSockets whose URL contains one of these strings or matches one of these patterns are not recorded. */
+    ignoreUrls?: Array<string | RegExp>;
+    /** Request and response bodies are cut after this many characters. Default 128 KiB. */
+    maxBodySize?: number;
+    /** WebSocket messages are cut after this many characters. Default 16 KiB. */
+    maxMessageSize?: number;
+    /** Header names (case-insensitive) whose values are replaced with "[redacted]". */
+    redactHeaders?: string[];
+}
+export declare function networkPlugin(options?: NetworkPluginOptions): Plugin;
+//# sourceMappingURL=network.d.ts.map

package/dist/plugins/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/plugins/network.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,cAAc,CAAC;AAO1D,MAAM,WAAW,oBAAoB;IACnC,6GAA6G;IAC7G,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yHAAyH;IACzH,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACpC,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAiBD,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAwBxE"}