@buoy-gg/network 1.7.2

package/lib/typescript/network/utils/networkListener.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Network listener using Reactotron-style event pattern
+ * Simple and reliable network interception for React Native
+ */
+export interface NetworkingEvent {
+    type: "request" | "response" | "error";
+    timestamp: Date;
+    duration?: number;
+    request: {
+        id: string;
+        url: string;
+        method: string;
+        headers?: Record<string, string>;
+        data?: unknown;
+        params?: Record<string, string>;
+        client?: "fetch" | "axios" | "graphql" | "grpc-web";
+    };
+    response?: {
+        status: number;
+        statusText?: string;
+        headers?: Record<string, string>;
+        body?: unknown;
+        size?: number;
+    };
+    error?: {
+        message: string;
+        stack?: string;
+    };
+}
+export type NetworkingEventListener = (event: NetworkingEvent) => void;
+/**
+ * Network traffic interceptor for React Native applications
+ *
+ * This class intercepts both fetch and XMLHttpRequest operations to provide
+ * comprehensive network monitoring capabilities. It uses method swizzling to
+ * wrap native networking APIs while preserving their original functionality.
+ *
+ * @example
+ * ```typescript
+ * // Start monitoring network traffic
+ * startNetworkListener();
+ *
+ * // Add a listener for network events
+ * const unsubscribe = addNetworkListener((event) => {
+ *   if (event.type === 'response') {
+ *     console.log(`${event.request.method} ${event.request.url}: ${event.response?.status}`);
+ *   }
+ * });
+ *
+ * // Stop monitoring and cleanup
+ * unsubscribe();
+ * stopNetworkListener();
+ * ```
+ *
+ * @performance Uses lazy singleton pattern to minimize memory footprint
+ * @performance Includes URL filtering to ignore development traffic
+ */
+declare class NetworkListener {
+    private listeners;
+    private isListening;
+    private requestCounter;
+    private ignoredUrls;
+    private originalFetch;
+    private originalXHROpen;
+    private originalXHRSend;
+    private originalXHRSetRequestHeader;
+    constructor();
+    /**
+     * Check if URL should be ignored from network monitoring
+     *
+     * Filters out development-related URLs like Metro bundler, debugger proxy,
+     * and symbolication requests to reduce noise in the network logs.
+     *
+     * @param url - The URL to check
+     * @returns True if the URL should be ignored
+     */
+    private shouldIgnoreUrl;
+    private emit;
+    /**
+     * Parse URL to extract query parameters and clean URL
+     *
+     * @param url - The URL to parse
+     * @returns Object containing cleaned URL and parsed query parameters
+     *
+     * @performance Uses manual parsing instead of URL constructor for better performance
+     */
+    private parseUrl;
+    /**
+     * Process response body with size limits to prevent memory issues
+     * @param response - The Response object to process
+     * @param maxSize - Maximum body size in bytes (default: 1MB)
+     * @returns Object containing body, size, and truncation status
+     */
+    private processResponseBody;
+    /**
+     * Format bytes into human-readable format
+     * @param bytes - Number of bytes
+     * @returns Formatted string (e.g., "1.5 MB")
+     */
+    private formatBytes;
+    private getResponseSize;
+    /**
+     * Handle XMLHttpRequest response processing
+     * This method processes the response and emits appropriate events
+     */
+    private handleXHRResponse;
+    /**
+     * Start intercepting network operations by swizzling fetch and XMLHttpRequest
+     *
+     * This method replaces the global fetch function and XMLHttpRequest methods
+     * with instrumented versions that emit events while preserving original functionality.
+     *
+     * @throws Will log warnings if already listening
+     *
+     * @performance Uses method swizzling for minimal runtime overhead
+     * @performance Includes request deduplication through ignored URL patterns
+     */
+    startListening(): void;
+    /**
+     * Stop listening and restore original networking methods
+     *
+     * This method restores the original fetch and XMLHttpRequest implementations,
+     * effectively disabling network monitoring.
+     */
+    stopListening(): void;
+    /**
+     * Add a listener for network events
+     *
+     * @param listener - Callback function to handle network events
+     * @returns Unsubscribe function to remove the listener
+     */
+    addListener(listener: NetworkingEventListener): () => void;
+    removeAllListeners(): void;
+    get isActive(): boolean;
+    get listenerCount(): number;
+}
+/**
+ * Access function for the singleton NetworkListener instance
+ *
+ * @returns Function that returns the NetworkListener instance
+ */
+export declare const networkListener: () => NetworkListener;
+/**
+ * Start network traffic monitoring
+ *
+ * @example
+ * ```typescript
+ * startNetworkListener();
+ * console.log('Network monitoring started');
+ * ```
+ */
+export declare const startNetworkListener: () => void;
+/**
+ * Stop network traffic monitoring
+ */
+export declare const stopNetworkListener: () => void;
+/**
+ * Add a listener for network events
+ *
+ * @param listener - Callback function to handle network events
+ * @returns Unsubscribe function to remove the listener
+ *
+ * @example
+ * ```typescript
+ * const unsubscribe = addNetworkListener((event) => {
+ *   console.log(`Network ${event.type}:`, event.request.url);
+ * });
+ *
+ * // Later...
+ * unsubscribe();
+ * ```
+ */
+export declare const addNetworkListener: (listener: NetworkingEventListener) => () => void;
+/**
+ * Remove all registered network event listeners
+ */
+export declare const removeAllNetworkListeners: () => void;
+/**
+ * Check if network monitoring is currently active
+ *
+ * @returns True if currently intercepting network traffic
+ */
+export declare const isNetworkListening: () => boolean;
+/**
+ * Get the number of registered network event listeners
+ *
+ * @returns Number of active listeners
+ */
+export declare const getNetworkListenerCount: () => number;
+export {};
+//# sourceMappingURL=networkListener.d.ts.map

package/lib/typescript/network/utils/networkListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkListener.d.ts","sourceRoot":"","sources":["../../../../src/network/utils/networkListener.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IACvC,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;KACrD,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,cAAM,eAAe;IACnB,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAQ;IAG9B,OAAO,CAAC,WAAW,CASjB;IAGF,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,2BAA2B,CAAmD;;IAWtF;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,IAAI;IAUZ;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IA0BhB;;;;;OAKG;YACW,mBAAmB;IA2DjC;;;;OAIG;IACH,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,eAAe;IAavB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA6MzB;;;;;;;;;;OAUG;IACH,cAAc;IAkTd;;;;;OAKG;IACH,aAAa;IAkBb;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,uBAAuB;IAa7C,kBAAkB;IAKlB,IAAI,QAAQ,YAEX;IAGD,IAAI,aAAa,WAEhB;CACF;AAsBD;;;;GAIG;AACH,eAAO,MAAM,eAAe,uBAAqB,CAAC;AAElD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,YAA8C,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,mBAAmB,YAA6C,CAAC;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,uBAAuB,eACxB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,yBAAyB,YACK,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,eAAsC,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,cAA2C,CAAC"}

package/lib/typescript/preset.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Pre-configured network monitoring tool for FloatingDevTools
+ *
+ * This preset provides a zero-config way to add network request monitoring to your dev tools.
+ * Just import and add it to your apps array!
+ *
+ * @example
+ * ```tsx
+ * import { networkToolPreset } from '@buoy-gg/network';
+ *
+ * const installedApps = [
+ *   networkToolPreset, // That's it!
+ *   // ...other tools
+ * ];
+ * ```
+ */
+import { NetworkModal } from "./network/components/NetworkModal";
+/**
+ * Pre-configured network monitoring tool for FloatingDevTools.
+ * Includes:
+ * - Live network request monitoring
+ * - Request/response inspection
+ * - Filter by status, method, URL
+ * - Timing information
+ */
+export declare const networkToolPreset: {
+    id: string;
+    name: string;
+    description: string;
+    slot: "both";
+    icon: ({ size }: {
+        size: number;
+    }) => import("react").JSX.Element;
+    component: typeof NetworkModal;
+    props: {
+        enableSharedModalDimensions: boolean;
+    };
+};
+/**
+ * Create a custom network monitoring tool configuration.
+ * Use this if you want to override default settings.
+ *
+ * @example
+ * ```tsx
+ * import { createNetworkTool } from '@buoy-gg/network';
+ *
+ * const myNetworkTool = createNetworkTool({
+ *   name: "REQUESTS",
+ *   iconColor: "#9945FF", // Purple color
+ *   enableSharedModalDimensions: true,
+ * });
+ * ```
+ */
+export declare function createNetworkTool(options?: {
+    /** Tool name (default: "NET") */
+    name?: string;
+    /** Tool description */
+    description?: string;
+    /** Custom tool ID (default: "network") */
+    id?: string;
+    /** Enable shared modal dimensions */
+    enableSharedModalDimensions?: boolean;
+}): {
+    id: string;
+    name: string;
+    description: string;
+    slot: "both";
+    icon: ({ size }: {
+        size: number;
+    }) => import("react").JSX.Element;
+    component: typeof NetworkModal;
+    props: {
+        enableSharedModalDimensions: boolean;
+    };
+};
+//# sourceMappingURL=preset.d.ts.map

package/lib/typescript/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/preset.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;;;;qBAKX;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;;;;;CAKlC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAC1C,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;;;;;qBAMoB;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;;;;;EASpC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@buoy-gg/network",
+  "version": "1.7.2",
+  "description": "network package",
+  "main": "lib/commonjs/index.js",
+  "module": "lib/module/index.js",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index.tsx",
+  "source": "src/index.tsx",
+  "files": [
+    "lib"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "bob build",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bob build",
+    "clean": "rimraf lib",
+    "test": "pnpm run typecheck",
+    "test:interceptor": "node test-network-interceptor.js",
+    "test:comprehensive": "node test-comprehensive.js"
+  },
+  "dependencies": {
+    "@buoy-gg/react-query": "workspace:*",
+    "@buoy-gg/shared-ui": "workspace:*"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.0",
+    "@types/react-native": "^0.73.0",
+    "node-fetch": "^2.7.0",
+    "typescript": "~5.8.3"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "commonjs",
+        {
+          "sourceMaps": false
+        }
+      ],
+      [
+        "module",
+        {
+          "sourceMaps": false
+        }
+      ],
+      "typescript"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LovesWorking/react-native-buoy.git",
+    "directory": "packages/network"
+  },
+  "bugs": {
+    "url": "https://github.com/LovesWorking/react-native-buoy/issues"
+  },
+  "homepage": "https://github.com/LovesWorking/react-native-buoy/tree/main/packages/network#readme",
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  }
+}