react-native-tapline 1.3.0 → 1.4.0

package/dist/network.d.ts

@@ -1,7 +1,8 @@
 /**
  * Network tracking: counts requests in flight (so an agent can wait for loading to finish)
- * and reports failed ones. React Native's fetch is built on XMLHttpRequest, so patching
- * XMLHttpRequest.prototype covers both. Nothing here may ever throw into the app.
+ * and reports failed ones. React Native's fetch is built on XMLHttpRequest, but Expo SDK 58's
+ * expo/fetch is native, so both XMLHttpRequest.prototype and the global fetch are wrapped (a
+ * request is counted once). Nothing here may ever throw into the app.
  */
 export interface NetworkFailure {
     method: string;
@@ -17,8 +18,25 @@ export interface NetworkOptions {
     };
     ignore?: (url: string) => boolean;
 }
+/** What Tapline can make the app's requests behave like (`network` app command). */
+export type NetworkMode = 'offline' | '3g' | 'lossy' | 'normal';
+export declare const NETWORK_MODES: readonly NetworkMode[];
 /** scheme://host[:port]/path, query replaced by "?…", no fragment or credentials. */
 export declare function redactUrl(raw: string): string;
+/**
+ * Wraps the app's global fetch, once per function: a fetch replaced after Tapline started (Expo installs its own
+ * lazily) is wrapped when this runs next. Called on install, on each condition change and whenever requests are
+ * counted. Never throws into the app.
+ */
+export declare function ensureFetchWrapped(given?: Record<string, unknown>): void;
+/** The mode the app's requests are in now. */
+export declare function networkCondition(): NetworkMode;
+/** Puts the app's requests into a mode; `normal` restores them. Requests already sent are not touched. */
+export declare function setNetworkCondition(mode: NetworkMode): void;
+/** Back to normal; safe to call any time (host gone, Tapline stopped). */
+export declare function resetNetworkCondition(): void;
+/** A seeded random source for `lossy` (tests); `null` goes back to Math.random. */
+export declare function seedNetworkRandom(seed: number | null): void;
 export declare function installNetworkTracking(options?: NetworkOptions): void;
 export declare function uninstallNetworkTracking(): void;
 /** Requests that have been sent and not yet finished (dev-server traffic excluded). */