@avasapp/agent-bridge 0.2.0 → 0.4.0

package/dist/network/index.d.cts

@@ -1,4 +1,4 @@
-import { T as Tools } from '../types-C6DUUHnB.cjs';
+import { T as Tools } from '../types-BmpykP1P.cjs';
 
 /** Which requests a mock answers. A bare string is a URL substring. */
 type MockMatch = string | {
@@ -38,6 +38,8 @@ type MockOptions = {
     times?: number;
     /** Wait before answering. */
     delayMs?: number;
+    /** Higher is tried first among mocks from the same source (agent mocks still come before the app's). Default 0; ties go to the newest. Negative makes a fallback. */
+    priority?: number;
     /** Registering again with the same id replaces the mock (handy with Fast Refresh). */
     id?: string;
 };
@@ -50,13 +52,44 @@ type LogEntry = {
     id: number;
     method: string;
     url: string;
+    /** When the request started, epoch ms (the app's clock). */
+    startedAt: number;
     status?: number;
     ms: number;
     pending?: boolean;
     requestBody?: string;
     responseBody?: string;
+    /** From net.entry: a body shown is only a preview because the whole one was too large or is gone. */
+    truncated?: boolean;
     error?: string;
     mocked?: boolean;
+    /** Failed by strict mode: no mock answered it. */
+    blocked?: boolean;
+};
+type StrictOptions = {
+    /** URLs strict mode lets through to the network: substrings or RegExps. */
+    allow?: Array<string | RegExp>;
+    /** Status of the error response. Default 501. */
+    status?: number;
+    /** Fail like a network failure instead of answering with a status. */
+    offline?: boolean;
+};
+
+/** What a `mockApi` handler sees: the request, plus its path params and query. */
+type ApiRequest = MockRequest & {
+    /** `:name` segments of the route, and `*` as "*". */
+    params: Record<string, string>;
+    query: Record<string, string>;
+};
+type ApiHandler = (request: ApiRequest) => MockResponse | undefined | Promise<MockResponse | undefined>;
+/** "METHOD /path" (or "/path" for any method) → a response or a handler. */
+type ApiRoutes = Record<string, MockResponse | ApiHandler>;
+type MockApiOptions = Omit<MockOptions, 'id'> & {
+    /**
+     * Registering again with the same id replaces these routes (handy with
+     * Fast Refresh). Each route's mock id is `<id> <METHOD /path>`.
+     */
+    id?: string;
 };
 
 /**
@@ -67,7 +100,8 @@ type LogEntry = {
 declare function installNetwork(): void;
 /**
  * Answers matching requests from the app's own code, e.g. a fake backend.
- * Agent mocks (from `net.mock`) take precedence; `net.restore` keeps these.
+ * Agent mocks (from `net.mock`) are tried first, whatever their priority;
+ * `net.restore` keeps these.
  */
 declare function mock(match: MockMatch, response: MockResponse | MockHandler, options?: MockOptions): {
     id: string;
@@ -75,6 +109,22 @@ declare function mock(match: MockMatch, response: MockResponse | MockHandler, op
 };
 /** Registers several app mocks. Returns a function that removes them. */
 declare function mockRequests(routes: MockRoute[]): () => void;
+/**
+ * Answers many endpoints under one base URL, e.g. a scenario's fixtures:
+ * `mockApi(API, { 'GET /me': { json: user }, 'GET /plants/:id': ({ params }) => ... })`.
+ * `:name` matches a path segment and `*` the rest; the query string is ignored.
+ * Pass '' as the base URL to match the path on any host. Returns a function
+ * that removes the routes.
+ */
+declare function mockApi(baseUrl: string, routes: ApiRoutes, options?: MockApiOptions): () => void;
+/**
+ * Strict mode: a fetch or XMLHttpRequest that no mock answers fails with an
+ * error response (501 by default, or like offline with `offline: true`) and
+ * a console error naming it, instead of
+ * reaching a server. Only JS requests: native networking (images, native
+ * SDKs, WebSockets) isn't covered. Returns a function that turns it off.
+ */
+declare function strictNetwork(options?: StrictOptions): () => void;
 type NetworkToolsOptions = {
     /** Extra URLs never to log or mock: substrings or RegExps. */
     skip?: Array<string | RegExp>;
@@ -82,4 +132,4 @@ type NetworkToolsOptions = {
 /** Read the request log and mock responses: `net.*`. */
 declare function networkTools(options?: NetworkToolsOptions): Tools;
 
-export { type LogEntry, type MockHandler, type MockMatch, type MockOptions, type MockRequest, type MockResponse, type MockRoute, type NetworkToolsOptions, installNetwork, mock, mockRequests, networkTools };
+export { type ApiHandler, type ApiRequest, type ApiRoutes, type LogEntry, type MockApiOptions, type MockHandler, type MockMatch, type MockOptions, type MockRequest, type MockResponse, type MockRoute, type NetworkToolsOptions, type StrictOptions, installNetwork, mock, mockApi, mockRequests, networkTools, strictNetwork };

package/dist/noop/index.cjs

@@ -21,6 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var noop_exports = {};
 __export(noop_exports, {
   cdpTransport: () => cdpTransport,
+  createGate: () => createGate,
+  onRestore: () => onRestore,
   settle: () => settle,
   startAgentBridge: () => startAgentBridge,
   useAgentBridge: () => useAgentBridge
@@ -34,3 +36,13 @@ var useAgentBridge = () => {
 };
 var cdpTransport = inert;
 var settle = () => Promise.resolve({ commits: 0, ms: 0 });
+var onRestore = () => {
+};
+var createGate = (name) => ({
+  name,
+  closed: false,
+  close: () => () => {
+  },
+  subscribe: () => () => {
+  }
+});

package/dist/noop/network.cjs

@@ -22,8 +22,10 @@ var network_exports = {};
 __export(network_exports, {
   installNetwork: () => installNetwork,
   mock: () => mock,
+  mockApi: () => mockApi,
   mockRequests: () => mockRequests,
-  networkTools: () => networkTools
+  networkTools: () => networkTools,
+  strictNetwork: () => strictNetwork
 });
 module.exports = __toCommonJS(network_exports);
 var installNetwork = () => {
@@ -32,3 +34,7 @@ var mock = () => ({ id: "", remove: () => false });
 var mockRequests = () => () => {
 };
 var networkTools = () => ({});
+var mockApi = () => () => {
+};
+var strictNetwork = () => () => {
+};

package/dist/noop/react-native-webview.cjs

@@ -0,0 +1,31 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/noop/react-native-webview.ts
+var react_native_webview_exports = {};
+__export(react_native_webview_exports, {
+  useWebViewTools: () => useWebViewTools,
+  webviewTools: () => webviewTools
+});
+module.exports = __toCommonJS(react_native_webview_exports);
+var useWebViewTools = () => ({
+  props: {},
+  wrap: (onMessage) => onMessage
+});
+var webviewTools = () => ({});

package/dist/realtime/index.cjs

@@ -221,7 +221,7 @@ function createRealtimeTap(options = {}) {
       }
     },
     [`${ns}.emit`]: {
-      description: "Deliver a fake message to every listener on a channel: [channel, message]. Runs the app's own handlers. Returns { id, delivered }.",
+      description: "Deliver a fake message to every listener on a channel: [channel, message]. Runs the app's own handlers. Returns { id, delivered }." + (options.emitUsage ? ` ${options.emitUsage}` : ""),
       run: (channel, ...values) => {
         const entries = channels.get(channel);
         if (!entries?.size)
@@ -257,6 +257,7 @@ function createRealtimeTap(options = {}) {
       run: (channel) => setMute(channel, null)
     },
     [`${ns}.restore`]: {
+      pending: () => mutes.size > 0 || faked !== null,
       description: "Undo the agent: unmute every channel and go back to the real connection state.",
       run: () => {
         const unmuted = [...mutes.keys()];

package/dist/realtime/index.d.cts

@@ -1,4 +1,4 @@
-import { T as Tools } from '../types-C6DUUHnB.cjs';
+import { T as Tools } from '../types-BmpykP1P.cjs';
 
 /** How a message shows up in `realtime.log`. */
 type MessageSummary = {
@@ -34,6 +34,8 @@ type RealtimeTapOptions<M> = {
         channel: string;
         id: string;
     }) => M;
+    /** What to pass to `realtime.emit` for this library, appended to its description. */
+    emitUsage?: string;
     /** Extra fields for `realtime.channels`, e.g. the library's channel state. */
     channelInfo?: (channel: string) => Record<string, unknown>;
     /** Adds `realtime.connection`, to fake connection states. */