@capybara-devtools/react-native 0.0.0-stage → 0.2.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,23 @@
-# Temporary Holding Version
+# @capybara-devtools/react-native
 
-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.
+React Native SDK for [Capybara](https://github.com/lhphuc99/capybara#readme): sends your app's logs, network requests (including WebSockets) and storage to the Capybara UI on your computer, and lets you edit AsyncStorage and MMKV values from it.
+
+On React Native 0.85 or later, Capybara reads logs, network and storage through Metro without this package. Add it to edit storage, to see storage changes as they happen, or on older React Native versions.
+
+```bash
+npm install @capybara-devtools/react-native
+```
+
+Import it before the rest of your app:
+
+```ts
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { asyncStorage, init, mmkvStorage } from '@capybara-devtools/react-native';
+import { storage } from './storage'; // your react-native-mmkv instance
+
+if (__DEV__) init({ appName: 'My app', storage: [asyncStorage(AsyncStorage), mmkvStorage(storage)] });
+```
+
+Then run `npx capybara-devtools` (or open the desktop app) on the computer running Metro. The SDK finds it from the bundle URL, so simulators and phones on the same Wi-Fi connect without configuration.
+
+Documentation: [github.com/lhphuc99/capybara](https://github.com/lhphuc99/capybara#optional-react-native-sdk-storage-editing)

package/dist/errors.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from '@capybara-devtools/core';
+/** Records uncaught JS exceptions, then hands them to the previous handler (LogBox, crash reporters). */
+export declare function errorUtilsPlugin(): Plugin;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAStD,yGAAyG;AACzG,wBAAgB,gBAAgB,IAAI,MAAM,CAuBzC"}

package/dist/errors.js

@@ -0,0 +1,30 @@
+/** Records uncaught JS exceptions, then hands them to the previous handler (LogBox, crash reporters). */
+export function errorUtilsPlugin() {
+    return {
+        name: 'errors',
+        setup(ctx) {
+            const errorUtils = globalThis.ErrorUtils;
+            if (!errorUtils?.getGlobalHandler || !errorUtils.setGlobalHandler)
+                return;
+            const previous = errorUtils.getGlobalHandler();
+            const handler = (error, isFatal) => {
+                try {
+                    const args = [ctx.serialize(error)];
+                    if (isFatal)
+                        args.push(ctx.serialize('(fatal)'));
+                    ctx.emit('log', { level: 'error', source: 'uncaught', args });
+                }
+                catch {
+                    // the original handler must still run
+                }
+                previous?.(error, isFatal);
+            };
+            errorUtils.setGlobalHandler(handler);
+            return () => {
+                if (errorUtils.getGlobalHandler() === handler && previous)
+                    errorUtils.setGlobalHandler(previous);
+            };
+        },
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AASA,yGAAyG;AACzG,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,KAAK,CAAC,GAAG;YACP,MAAM,UAAU,GAAI,UAA8C,CAAC,UAAU,CAAC;YAC9E,IAAI,CAAC,UAAU,EAAE,gBAAgB,IAAI,CAAC,UAAU,CAAC,gBAAgB;gBAAE,OAAO;YAC1E,MAAM,QAAQ,GAAG,UAAU,CAAC,gBAAgB,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;gBAChD,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;oBACpC,IAAI,OAAO;wBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;oBACjD,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChE,CAAC;gBAAC,MAAM,CAAC;oBACP,sCAAsC;gBACxC,CAAC;gBACD,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC7B,CAAC,CAAC;YACF,UAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACrC,OAAO,GAAG,EAAE;gBACV,IAAI,UAAU,CAAC,gBAAgB,EAAE,KAAK,OAAO,IAAI,QAAQ;oBAAE,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YACnG,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/host.d.ts

@@ -0,0 +1,11 @@
+/** Host of a URL (IPv6 keeps its brackets), or undefined for host-less URLs such as file:// bundles. */
+export declare function hostFromUrl(url: string): string | undefined;
+/** Explicit port of a URL, or undefined when it has none. */
+export declare function portFromUrl(url: string): string | undefined;
+/**
+ * Sockets of dev tools: Metro's own (HMR, inspector) on the bundle's port, React DevTools (8097) and
+ * Reactotron (9090). React Native opens some of them with an http:// URL, so both schemes match.
+ */
+export declare function devToolSockets(metroPort: string | undefined): RegExp[];
+export declare function formatHost(host: string): string;
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE3D;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAMtE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/host.js

@@ -0,0 +1,23 @@
+/** Host of a URL (IPv6 keeps its brackets), or undefined for host-less URLs such as file:// bundles. */
+export function hostFromUrl(url) {
+    return /^[a-z][a-z\d+.-]*:\/\/(?:[^@/?#]*@)?(\[[^\]]+\]|[^:/?#]+)/i.exec(url)?.[1];
+}
+/** Explicit port of a URL, or undefined when it has none. */
+export function portFromUrl(url) {
+    return /^[a-z][a-z\d+.-]*:\/\/(?:[^@/?#]*@)?(?:\[[^\]]+\]|[^:/?#]+):(\d+)/i.exec(url)?.[1];
+}
+/**
+ * Sockets of dev tools: Metro's own (HMR, inspector) on the bundle's port, React DevTools (8097) and
+ * Reactotron (9090). React Native opens some of them with an http:// URL, so both schemes match.
+ */
+export function devToolSockets(metroPort) {
+    const patterns = [/^(?:wss?|https?):\/\/[^/]+:(?:8097|9090)(?:\/|$)/];
+    if (metroPort) {
+        patterns.push(new RegExp(`^(?:wss?|https?)://[^/]+:${metroPort}/(?:hot|message|events|inspector|debugger-proxy)(?:[/?]|$)`));
+    }
+    return patterns;
+}
+export function formatHost(host) {
+    return host.includes(':') && !host.startsWith('[') ? `[${host}]` : host;
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,4DAA4D,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACrF,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,oEAAoE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAA6B;IAC1D,MAAM,QAAQ,GAAG,CAAC,kDAAkD,CAAC,CAAC;IACtE,IAAI,SAAS,EAAE,CAAC;QACd,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,4BAA4B,SAAS,4DAA4D,CAAC,CAAC,CAAC;IAC/H,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { type CapybaraClient, type NetworkPluginOptions, type Plugin, type StorageAdapter } from '@capybara-devtools/core';
+export declare const SDK_VERSION = "0.2.0";
+export interface InitOptions {
+    /** Shown in the session picker. */
+    appName?: string;
+    /** Machine running `capybara`. Defaults to the host serving the JS bundle (Metro). */
+    host?: string;
+    port?: number;
+    /** Pass false to skip setup, e.g. `enabled: __DEV__`. */
+    enabled?: boolean;
+    /** Capture console output and uncaught errors. Default true. */
+    logs?: boolean;
+    network?: boolean | NetworkPluginOptions;
+    /** e.g. `[asyncStorage(AsyncStorage), mmkvStorage(storage)]` */
+    storage?: StorageAdapter[];
+    plugins?: Plugin[];
+}
+export declare function init(options?: InitOptions): CapybaraClient | undefined;
+export { getActiveClient } from '@capybara-devtools/core';
+export type { CapybaraClient, NetworkPluginOptions, Plugin, StorageAdapter } from '@capybara-devtools/core';
+export { asyncStorage, mmkvStorage } from './storage.js';
+export type { AdapterOptions, AsyncStorageLike, MMKVLike } from './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,EAML,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAMjC,eAAO,MAAM,WAAW,UAAU,CAAC;AAKnC,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;IACzC,gEAAgE;IAChE,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,cAAc,GAAG,SAAS,CAkC1E;AAgED,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,100 @@
+import { consolePlugin, createClient, getActiveClient, networkPlugin, storagePlugin, } from '@capybara-devtools/core';
+import { CLIENT_PATH, DEFAULT_PORT } from '@capybara-devtools/protocol';
+import { NativeModules, Platform } from 'react-native';
+import { errorUtilsPlugin } from './errors.js';
+import { devToolSockets, formatHost, hostFromUrl, portFromUrl } from './host.js';
+export const SDK_VERSION = '0.2.0';
+/** Requests React Native sends to Metro on its own (LogBox symbolication, "open in editor"). */
+const DEV_SERVER_NOISE = [/\/symbolicate(\?|$)/, /\/open-stack-frame(\?|$)/];
+export function init(options = {}) {
+    if (options.enabled === false)
+        return undefined;
+    // Fast Refresh can re-run the entry file; patching again would record everything twice.
+    const existing = getActiveClient();
+    if (existing)
+        return existing;
+    const plugins = [];
+    if (options.logs !== false)
+        plugins.push(consolePlugin(), errorUtilsPlugin());
+    if (options.network !== false) {
+        const network = typeof options.network === 'object' ? options.network : {};
+        plugins.push(networkPlugin({
+            fetch: !fetchRunsOnXhr(),
+            xhr: true,
+            ...network,
+            ignoreUrls: [...DEV_SERVER_NOISE, ...devToolSockets(portFromUrl(bundleUrl() ?? '')), ...(network.ignoreUrls ?? [])],
+        }));
+    }
+    // Registered even when empty so the UI can explain how to add adapters.
+    plugins.push(storagePlugin(options.storage ?? []));
+    plugins.push(...(options.plugins ?? []));
+    return createClient({
+        url: `ws://${formatHost(options.host ?? defaultHost())}:${options.port ?? DEFAULT_PORT}${CLIENT_PATH}`,
+        session: {
+            appName: options.appName ?? `React Native (${Platform.OS})`,
+            platform: platformName(),
+            sdk: { name: '@capybara-devtools/react-native', version: SDK_VERSION },
+            device: deviceInfo(),
+            runtime: runtimeName(),
+        },
+        plugins,
+    });
+}
+/**
+ * Bare React Native ships whatwg-fetch, which runs on XHR, so patching fetch as well would record
+ * every request twice. Expo (SDK 52+) swaps in a native fetch that never touches XHR.
+ */
+function fetchRunsOnXhr() {
+    return globalThis.fetch?.polyfill === true;
+}
+function bundleUrl() {
+    try {
+        const sourceCode = NativeModules.SourceCode;
+        const scriptURL = sourceCode?.getConstants?.().scriptURL ?? sourceCode?.scriptURL;
+        return typeof scriptURL === 'string' ? scriptURL : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function defaultHost() {
+    const url = bundleUrl();
+    const host = url ? hostFromUrl(url) : undefined;
+    if (host)
+        return host;
+    // Bundles loaded from disk have no host; these addresses reach the dev machine from simulators and emulators.
+    return Platform.OS === 'android' ? '10.0.2.2' : 'localhost';
+}
+function platformName() {
+    const os = Platform.OS;
+    return os === 'ios' || os === 'android' || os === 'windows' || os === 'macos' || os === 'web' ? os : 'unknown';
+}
+function platformConstants() {
+    return (Platform.constants ?? {});
+}
+function deviceInfo() {
+    const c = platformConstants();
+    if (Platform.OS === 'android') {
+        const model = [c.Manufacturer, c.Model].filter(Boolean).join(' ');
+        return {
+            model: model || undefined,
+            osVersion: `Android ${String(c.Release ?? Platform.Version)}`,
+            isEmulator: /generic|emulator|sdk_gphone/i.test(String(c.Fingerprint ?? '')),
+        };
+    }
+    if (Platform.OS === 'ios') {
+        return {
+            model: c.interfaceIdiom === 'pad' ? 'iPad' : 'iPhone',
+            osVersion: `${String(c.systemName ?? 'iOS')} ${String(c.osVersion ?? Platform.Version)}`,
+        };
+    }
+    return { osVersion: `${Platform.OS} ${String(Platform.Version)}` };
+}
+function runtimeName() {
+    const engine = globalThis.HermesInternal ? 'Hermes' : 'JSC';
+    const version = platformConstants().reactNativeVersion;
+    return version ? `${engine} · RN ${version.major}.${version.minor}.${version.patch}` : engine;
+}
+export { getActiveClient } from '@capybara-devtools/core';
+export { asyncStorage, mmkvStorage } from './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":"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"}

package/dist/storage.d.ts

@@ -0,0 +1,33 @@
+import type { StorageAdapter } from '@capybara-devtools/core';
+/** Matches the default export of @react-native-async-storage/async-storage. */
+export interface AsyncStorageLike {
+    getAllKeys(): Promise<readonly string[]>;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    multiGet?(keys: readonly string[]): Promise<ReadonlyArray<readonly [string, string | null]>>;
+    clear?(): Promise<void>;
+}
+/** Matches an instance from react-native-mmkv (v2 to v4). */
+export interface MMKVLike {
+    getAllKeys(): string[];
+    getString(key: string): string | undefined;
+    getNumber?(key: string): number | undefined;
+    getBoolean?(key: string): boolean | undefined;
+    set(key: string, value: string | number | boolean): void;
+    /** v2/v3 */
+    delete?(key: string): void;
+    /** v4 */
+    remove?(key: string): unknown;
+    clearAll?(): void;
+    addOnValueChangedListener?(listener: (key: string) => void): {
+        remove(): void;
+    };
+}
+export interface AdapterOptions {
+    id?: string;
+    label?: string;
+}
+export declare function asyncStorage(storage: AsyncStorageLike, options?: AdapterOptions): StorageAdapter;
+export declare function mmkvStorage(mmkv: MMKVLike, options?: AdapterOptions): StorageAdapter;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,UAAU,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,QAAQ,CAAC,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7F,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,6DAA6D;AAC7D,MAAM,WAAW,QAAQ;IACvB,UAAU,IAAI,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,SAAS,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5C,UAAU,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC9C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACzD,YAAY;IACZ,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS;IACT,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,QAAQ,CAAC,IAAI,IAAI,CAAC;IAClB,yBAAyB,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG;QAAE,MAAM,IAAI,IAAI,CAAA;KAAE,CAAC;CACjF;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,GAAE,cAAmB,GAAG,cAAc,CAwBpG;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,cAAmB,GAAG,cAAc,CAoBxF"}

package/dist/storage.js

@@ -0,0 +1,116 @@
+export function asyncStorage(storage, options = {}) {
+    const multiGet = storage.multiGet?.bind(storage);
+    const clear = storage.clear?.bind(storage);
+    return {
+        id: options.id ?? 'async-storage',
+        label: options.label ?? 'AsyncStorage',
+        keys: () => storage.getAllKeys(),
+        get: (key) => storage.getItem(key),
+        getMany: multiGet ? (keys) => multiGet(keys) : undefined,
+        set: (key, value) => storage.setItem(key, value),
+        remove: (key) => storage.removeItem(key),
+        clear: clear ? () => clear() : undefined,
+        // AsyncStorage has no change events, so wrap the module's write methods.
+        watch: (onChange) => wrapMethods(storage, {
+            setItem: (key) => onChange('set', key),
+            removeItem: (key) => onChange('remove', key),
+            mergeItem: (key) => onChange('merge', key),
+            clear: () => onChange('clear'),
+            multiSet: () => onChange('set'),
+            multiRemove: () => onChange('remove'),
+            multiMerge: () => onChange('merge'),
+        }),
+    };
+}
+export function mmkvStorage(mmkv, options = {}) {
+    return {
+        id: options.id ?? 'mmkv',
+        label: options.label ?? 'MMKV',
+        note: 'MMKV keeps no value types, so they are inferred: false and an empty string are stored alike and show as false, and binary values may not display. Edits are saved as strings.',
+        keys: () => mmkv.getAllKeys(),
+        get: (key) => readMmkv(mmkv, key),
+        set: (key, value) => mmkv.set(key, value),
+        remove: (key) => {
+            if (mmkv.remove)
+                mmkv.remove(key);
+            else
+                mmkv.delete?.(key);
+        },
+        clear: mmkv.clearAll ? () => mmkv.clearAll() : undefined,
+        watch: mmkv.addOnValueChangedListener
+            ? (onChange) => {
+                const listener = mmkv.addOnValueChangedListener((key) => onChange('unknown', key));
+                return () => listener.remove();
+            }
+            : undefined,
+    };
+}
+function readMmkv(mmkv, key) {
+    const text = mmkv.getString(key);
+    // On the web, MMKV keeps the text it was given; trying getNumber would turn '007' into 7.
+    if (isWeb())
+        return text ?? null;
+    // Native MMKV keeps no types and every getter decodes the same bytes, so 42 reads as '' through
+    // getString. A string takes a length byte plus its UTF-8 bytes, while getNumber needs at least 8
+    // bytes, so a decoded string shorter than 7 bytes is real only if getNumber fails.
+    if (text !== undefined && utf8Size(text) >= 7)
+        return text;
+    const number = mmkv.getNumber?.(key);
+    if (number !== undefined && !Number.isNaN(number))
+        return String(number);
+    if (text)
+        return text;
+    // `false` and '' are the same single zero byte.
+    const bool = mmkv.getBoolean?.(key);
+    return bool === undefined ? (text ?? null) : String(bool);
+}
+/** Some React Native libraries polyfill `document`, but React Native always reports its navigator.product. */
+function isWeb() {
+    const scope = globalThis;
+    return scope.document !== undefined && scope.navigator?.product !== 'ReactNative';
+}
+/** TextEncoder may be missing or lazily installed in React Native runtimes. */
+function utf8Size(value) {
+    let size = 0;
+    for (let i = 0; i < value.length; i++) {
+        const code = value.charCodeAt(i);
+        if (code < 0x80)
+            size++;
+        else if (code < 0x800)
+            size += 2;
+        else if (code >= 0xd800 && code <= 0xdbff && value.charCodeAt(i + 1) >= 0xdc00 && value.charCodeAt(i + 1) <= 0xdfff) {
+            size += 4;
+            i++;
+        }
+        else
+            size += 3;
+    }
+    return size;
+}
+/** Runs `hooks[name](firstArg)` after the wrapped method's promise resolves. Returns an undo function. */
+function wrapMethods(target, hooks) {
+    const originals = [];
+    for (const [name, hook] of Object.entries(hooks)) {
+        const original = target[name];
+        if (typeof original !== 'function')
+            continue;
+        const wrapped = function (...args) {
+            const result = original.apply(this, args);
+            const key = typeof args[0] === 'string' ? args[0] : undefined;
+            Promise.resolve(result).then(() => hook(key), () => { });
+            return result;
+        };
+        try {
+            target[name] = wrapped;
+            originals.push([name, original]);
+        }
+        catch {
+            // frozen module object: change events are unavailable, everything else still works
+        }
+    }
+    return () => {
+        for (const [name, original] of originals)
+            target[name] = original;
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@capybara-devtools/react-native",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "React Native SDK for Capybara: logs, network and storage for React Native and Expo apps",
+  "keywords": [
+    "capybara",
+    "react-native",
+    "expo",
+    "devtools",
+    "debugger",
+    "logs",
+    "network",
+    "asyncstorage",
+    "mmkv"
+  ],
+  "homepage": "https://github.com/lhphuc99/capybara#readme",
+  "bugs": "https://github.com/lhphuc99/capybara/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lhphuc99/capybara.git",
+    "directory": "packages/react-native"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@capybara-devtools/core": "0.2.0",
+    "@capybara-devtools/protocol": "0.2.0"
+  },
+  "peerDependencies": {
+    "react-native": ">=0.76"
+  },
+  "devDependencies": {
+    "react-native": "0.86.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/errors.ts

@@ -0,0 +1,34 @@
+import type { Plugin } from '@capybara-devtools/core';
+
+type GlobalHandler = (error: unknown, isFatal?: boolean) => void;
+
+interface ErrorUtilsLike {
+  getGlobalHandler(): GlobalHandler | undefined;
+  setGlobalHandler(handler: GlobalHandler): void;
+}
+
+/** Records uncaught JS exceptions, then hands them to the previous handler (LogBox, crash reporters). */
+export function errorUtilsPlugin(): Plugin {
+  return {
+    name: 'errors',
+    setup(ctx) {
+      const errorUtils = (globalThis as { ErrorUtils?: ErrorUtilsLike }).ErrorUtils;
+      if (!errorUtils?.getGlobalHandler || !errorUtils.setGlobalHandler) return;
+      const previous = errorUtils.getGlobalHandler();
+      const handler: GlobalHandler = (error, isFatal) => {
+        try {
+          const args = [ctx.serialize(error)];
+          if (isFatal) args.push(ctx.serialize('(fatal)'));
+          ctx.emit('log', { level: 'error', source: 'uncaught', args });
+        } catch {
+          // the original handler must still run
+        }
+        previous?.(error, isFatal);
+      };
+      errorUtils.setGlobalHandler(handler);
+      return () => {
+        if (errorUtils.getGlobalHandler() === handler && previous) errorUtils.setGlobalHandler(previous);
+      };
+    },
+  };
+}

package/src/host.ts

@@ -0,0 +1,25 @@
+/** Host of a URL (IPv6 keeps its brackets), or undefined for host-less URLs such as file:// bundles. */
+export function hostFromUrl(url: string): string | undefined {
+  return /^[a-z][a-z\d+.-]*:\/\/(?:[^@/?#]*@)?(\[[^\]]+\]|[^:/?#]+)/i.exec(url)?.[1];
+}
+
+/** Explicit port of a URL, or undefined when it has none. */
+export function portFromUrl(url: string): string | undefined {
+  return /^[a-z][a-z\d+.-]*:\/\/(?:[^@/?#]*@)?(?:\[[^\]]+\]|[^:/?#]+):(\d+)/i.exec(url)?.[1];
+}
+
+/**
+ * Sockets of dev tools: Metro's own (HMR, inspector) on the bundle's port, React DevTools (8097) and
+ * Reactotron (9090). React Native opens some of them with an http:// URL, so both schemes match.
+ */
+export function devToolSockets(metroPort: string | undefined): RegExp[] {
+  const patterns = [/^(?:wss?|https?):\/\/[^/]+:(?:8097|9090)(?:\/|$)/];
+  if (metroPort) {
+    patterns.push(new RegExp(`^(?:wss?|https?)://[^/]+:${metroPort}/(?:hot|message|events|inspector|debugger-proxy)(?:[/?]|$)`));
+  }
+  return patterns;
+}
+
+export function formatHost(host: string): string {
+  return host.includes(':') && !host.startsWith('[') ? `[${host}]` : host;
+}

package/src/index.ts

@@ -0,0 +1,139 @@
+import {
+  consolePlugin,
+  createClient,
+  getActiveClient,
+  networkPlugin,
+  storagePlugin,
+  type CapybaraClient,
+  type NetworkPluginOptions,
+  type Plugin,
+  type StorageAdapter,
+} from '@capybara-devtools/core';
+import { CLIENT_PATH, DEFAULT_PORT, type DeviceInfo, type Platform as CapybaraPlatform } from '@capybara-devtools/protocol';
+import { NativeModules, Platform } from 'react-native';
+import { errorUtilsPlugin } from './errors.js';
+import { devToolSockets, formatHost, hostFromUrl, portFromUrl } from './host.js';
+
+export const SDK_VERSION = '0.2.0';
+
+/** Requests React Native sends to Metro on its own (LogBox symbolication, "open in editor"). */
+const DEV_SERVER_NOISE = [/\/symbolicate(\?|$)/, /\/open-stack-frame(\?|$)/];
+
+export interface InitOptions {
+  /** Shown in the session picker. */
+  appName?: string;
+  /** Machine running `capybara`. Defaults to the host serving the JS bundle (Metro). */
+  host?: string;
+  port?: number;
+  /** Pass false to skip setup, e.g. `enabled: __DEV__`. */
+  enabled?: boolean;
+  /** Capture console output and uncaught errors. Default true. */
+  logs?: boolean;
+  network?: boolean | NetworkPluginOptions;
+  /** e.g. `[asyncStorage(AsyncStorage), mmkvStorage(storage)]` */
+  storage?: StorageAdapter[];
+  plugins?: Plugin[];
+}
+
+export function init(options: InitOptions = {}): CapybaraClient | undefined {
+  if (options.enabled === false) return undefined;
+  // Fast Refresh can re-run the entry file; patching again would record everything twice.
+  const existing = getActiveClient();
+  if (existing) return existing;
+
+  const plugins: Plugin[] = [];
+  if (options.logs !== false) plugins.push(consolePlugin(), errorUtilsPlugin());
+  if (options.network !== false) {
+    const network = typeof options.network === 'object' ? options.network : {};
+    plugins.push(
+      networkPlugin({
+        fetch: !fetchRunsOnXhr(),
+        xhr: true,
+        ...network,
+        ignoreUrls: [...DEV_SERVER_NOISE, ...devToolSockets(portFromUrl(bundleUrl() ?? '')), ...(network.ignoreUrls ?? [])],
+      }),
+    );
+  }
+  // Registered even when empty so the UI can explain how to add adapters.
+  plugins.push(storagePlugin(options.storage ?? []));
+  plugins.push(...(options.plugins ?? []));
+
+  return createClient({
+    url: `ws://${formatHost(options.host ?? defaultHost())}:${options.port ?? DEFAULT_PORT}${CLIENT_PATH}`,
+    session: {
+      appName: options.appName ?? `React Native (${Platform.OS})`,
+      platform: platformName(),
+      sdk: { name: '@capybara-devtools/react-native', version: SDK_VERSION },
+      device: deviceInfo(),
+      runtime: runtimeName(),
+    },
+    plugins,
+  });
+}
+
+/**
+ * Bare React Native ships whatwg-fetch, which runs on XHR, so patching fetch as well would record
+ * every request twice. Expo (SDK 52+) swaps in a native fetch that never touches XHR.
+ */
+function fetchRunsOnXhr(): boolean {
+  return (globalThis as { fetch?: { polyfill?: boolean } }).fetch?.polyfill === true;
+}
+
+function bundleUrl(): string | undefined {
+  try {
+    const sourceCode = NativeModules.SourceCode as
+      | { scriptURL?: string; getConstants?: () => { scriptURL?: string } }
+      | undefined;
+    const scriptURL = sourceCode?.getConstants?.().scriptURL ?? sourceCode?.scriptURL;
+    return typeof scriptURL === 'string' ? scriptURL : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+function defaultHost(): string {
+  const url = bundleUrl();
+  const host = url ? hostFromUrl(url) : undefined;
+  if (host) return host;
+  // Bundles loaded from disk have no host; these addresses reach the dev machine from simulators and emulators.
+  return Platform.OS === 'android' ? '10.0.2.2' : 'localhost';
+}
+
+function platformName(): CapybaraPlatform {
+  const os: string = Platform.OS;
+  return os === 'ios' || os === 'android' || os === 'windows' || os === 'macos' || os === 'web' ? os : 'unknown';
+}
+
+function platformConstants(): Record<string, unknown> {
+  return ((Platform as unknown as { constants?: Record<string, unknown> }).constants ?? {}) as Record<string, unknown>;
+}
+
+function deviceInfo(): DeviceInfo {
+  const c = platformConstants();
+  if (Platform.OS === 'android') {
+    const model = [c.Manufacturer, c.Model].filter(Boolean).join(' ');
+    return {
+      model: model || undefined,
+      osVersion: `Android ${String(c.Release ?? Platform.Version)}`,
+      isEmulator: /generic|emulator|sdk_gphone/i.test(String(c.Fingerprint ?? '')),
+    };
+  }
+  if (Platform.OS === 'ios') {
+    return {
+      model: c.interfaceIdiom === 'pad' ? 'iPad' : 'iPhone',
+      osVersion: `${String(c.systemName ?? 'iOS')} ${String(c.osVersion ?? Platform.Version)}`,
+    };
+  }
+  return { osVersion: `${Platform.OS} ${String(Platform.Version)}` };
+}
+
+function runtimeName(): string {
+  const engine = (globalThis as { HermesInternal?: unknown }).HermesInternal ? 'Hermes' : 'JSC';
+  const version = platformConstants().reactNativeVersion as { major: number; minor: number; patch: number } | undefined;
+  return version ? `${engine} · RN ${version.major}.${version.minor}.${version.patch}` : engine;
+}
+
+export { getActiveClient } from '@capybara-devtools/core';
+export type { CapybaraClient, NetworkPluginOptions, Plugin, StorageAdapter } from '@capybara-devtools/core';
+export { asyncStorage, mmkvStorage } from './storage.js';
+export type { AdapterOptions, AsyncStorageLike, MMKVLike } from './storage.js';

package/src/storage.ts

@@ -0,0 +1,143 @@
+import type { StorageAdapter } from '@capybara-devtools/core';
+
+/** Matches the default export of @react-native-async-storage/async-storage. */
+export interface AsyncStorageLike {
+  getAllKeys(): Promise<readonly string[]>;
+  getItem(key: string): Promise<string | null>;
+  setItem(key: string, value: string): Promise<void>;
+  removeItem(key: string): Promise<void>;
+  multiGet?(keys: readonly string[]): Promise<ReadonlyArray<readonly [string, string | null]>>;
+  clear?(): Promise<void>;
+}
+
+/** Matches an instance from react-native-mmkv (v2 to v4). */
+export interface MMKVLike {
+  getAllKeys(): string[];
+  getString(key: string): string | undefined;
+  getNumber?(key: string): number | undefined;
+  getBoolean?(key: string): boolean | undefined;
+  set(key: string, value: string | number | boolean): void;
+  /** v2/v3 */
+  delete?(key: string): void;
+  /** v4 */
+  remove?(key: string): unknown;
+  clearAll?(): void;
+  addOnValueChangedListener?(listener: (key: string) => void): { remove(): void };
+}
+
+export interface AdapterOptions {
+  id?: string;
+  label?: string;
+}
+
+export function asyncStorage(storage: AsyncStorageLike, options: AdapterOptions = {}): StorageAdapter {
+  const multiGet = storage.multiGet?.bind(storage);
+  const clear = storage.clear?.bind(storage);
+  return {
+    id: options.id ?? 'async-storage',
+    label: options.label ?? 'AsyncStorage',
+    keys: () => storage.getAllKeys(),
+    get: (key) => storage.getItem(key),
+    getMany: multiGet ? (keys) => multiGet(keys) : undefined,
+    set: (key, value) => storage.setItem(key, value),
+    remove: (key) => storage.removeItem(key),
+    clear: clear ? () => clear() : undefined,
+    // AsyncStorage has no change events, so wrap the module's write methods.
+    watch: (onChange) =>
+      wrapMethods(storage as unknown as Record<string, unknown>, {
+        setItem: (key) => onChange('set', key),
+        removeItem: (key) => onChange('remove', key),
+        mergeItem: (key) => onChange('merge', key),
+        clear: () => onChange('clear'),
+        multiSet: () => onChange('set'),
+        multiRemove: () => onChange('remove'),
+        multiMerge: () => onChange('merge'),
+      }),
+  };
+}
+
+export function mmkvStorage(mmkv: MMKVLike, options: AdapterOptions = {}): StorageAdapter {
+  return {
+    id: options.id ?? 'mmkv',
+    label: options.label ?? 'MMKV',
+    note: 'MMKV keeps no value types, so they are inferred: false and an empty string are stored alike and show as false, and binary values may not display. Edits are saved as strings.',
+    keys: () => mmkv.getAllKeys(),
+    get: (key) => readMmkv(mmkv, key),
+    set: (key, value) => mmkv.set(key, value),
+    remove: (key) => {
+      if (mmkv.remove) mmkv.remove(key);
+      else mmkv.delete?.(key);
+    },
+    clear: mmkv.clearAll ? () => mmkv.clearAll!() : undefined,
+    watch: mmkv.addOnValueChangedListener
+      ? (onChange) => {
+          const listener = mmkv.addOnValueChangedListener!((key) => onChange('unknown', key));
+          return () => listener.remove();
+        }
+      : undefined,
+  };
+}
+
+function readMmkv(mmkv: MMKVLike, key: string): string | null {
+  const text = mmkv.getString(key);
+  // On the web, MMKV keeps the text it was given; trying getNumber would turn '007' into 7.
+  if (isWeb()) return text ?? null;
+  // Native MMKV keeps no types and every getter decodes the same bytes, so 42 reads as '' through
+  // getString. A string takes a length byte plus its UTF-8 bytes, while getNumber needs at least 8
+  // bytes, so a decoded string shorter than 7 bytes is real only if getNumber fails.
+  if (text !== undefined && utf8Size(text) >= 7) return text;
+  const number = mmkv.getNumber?.(key);
+  if (number !== undefined && !Number.isNaN(number)) return String(number);
+  if (text) return text;
+  // `false` and '' are the same single zero byte.
+  const bool = mmkv.getBoolean?.(key);
+  return bool === undefined ? (text ?? null) : String(bool);
+}
+
+/** Some React Native libraries polyfill `document`, but React Native always reports its navigator.product. */
+function isWeb(): boolean {
+  const scope = globalThis as { document?: unknown; navigator?: { product?: string } };
+  return scope.document !== undefined && scope.navigator?.product !== 'ReactNative';
+}
+
+/** TextEncoder may be missing or lazily installed in React Native runtimes. */
+function utf8Size(value: string): number {
+  let size = 0;
+  for (let i = 0; i < value.length; i++) {
+    const code = value.charCodeAt(i);
+    if (code < 0x80) size++;
+    else if (code < 0x800) size += 2;
+    else if (code >= 0xd800 && code <= 0xdbff && value.charCodeAt(i + 1) >= 0xdc00 && value.charCodeAt(i + 1) <= 0xdfff) {
+      size += 4;
+      i++;
+    } else size += 3;
+  }
+  return size;
+}
+
+/** Runs `hooks[name](firstArg)` after the wrapped method's promise resolves. Returns an undo function. */
+function wrapMethods(target: Record<string, unknown>, hooks: Record<string, (key?: string) => void>): () => void {
+  const originals: Array<[string, unknown]> = [];
+  for (const [name, hook] of Object.entries(hooks)) {
+    const original = target[name];
+    if (typeof original !== 'function') continue;
+    const wrapped = function (this: unknown, ...args: unknown[]) {
+      const result = (original as (...a: unknown[]) => unknown).apply(this, args);
+      const key = typeof args[0] === 'string' ? args[0] : undefined;
+      Promise.resolve(result).then(
+        () => hook(key),
+        () => {},
+      );
+      return result;
+    };
+    try {
+      target[name] = wrapped;
+      originals.push([name, original]);
+    } catch {
+      // frozen module object: change events are unavailable, everything else still works
+    }
+  }
+  return () => {
+    for (const [name, original] of originals) target[name] = original;
+  };
+}