@avasapp/agent-bridge 0.5.0 → 0.6.1

package/dist/network/index.d.cts

@@ -1,14 +1,24 @@
-import { T as Tools } from '../types-BmpykP1P.cjs';
+import { T as Tools } from '../types-qlwdcGjt.cjs';
 
-/** Which requests a mock answers. A bare string is a URL substring. */
+/**
+ * Which requests a mock answers. A bare string is a URL substring. In the
+ * object form every key given must match, and at least one of `url`, `path`,
+ * `body` or `graphql` is needed.
+ */
 type MockMatch = string | {
     /** A substring of the URL, a RegExp, or `{ regex }` from JSON. */
-    url: string | RegExp | {
+    url?: string | RegExp | {
         regex: string;
         flags?: string;
     };
+    /** The whole path of the URL on any host, query ignored: "/orders/:id" (one segment) or "/files/*" (the rest). "/orders" does not match "/orders/5/items". */
+    path?: string;
     /** Any method when left out. */
     method?: string;
+    /** A JSON request body must contain this: objects match key by key, arrays match in length and position, other values are equal. */
+    body?: Record<string, unknown> | unknown[];
+    /** The GraphQL operationName, from the JSON body or the `?operationName=` query. */
+    graphql?: string;
 };
 type MockResponse = {
     /** Defaults to 200. */
@@ -59,6 +69,9 @@ type LogEntry = {
     pending?: boolean;
     requestBody?: string;
     responseBody?: string;
+    /** From net.entry only; names are lower case. Credential values are cut unless `{ full: true }`. */
+    requestHeaders?: Record<string, string>;
+    responseHeaders?: Record<string, 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;
@@ -128,6 +141,8 @@ declare function strictNetwork(options?: StrictOptions): () => void;
 type NetworkToolsOptions = {
     /** Extra URLs never to log or mock: substrings or RegExps. */
     skip?: Array<string | RegExp>;
+    /** How many requests `net.log` keeps. Default 100. */
+    logSize?: number;
 };
 /** Read the request log and mock responses: `net.*`. */
 declare function networkTools(options?: NetworkToolsOptions): Tools;

package/dist/noop/async-storage.cjs

@@ -0,0 +1,26 @@
+"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/async-storage.ts
+var async_storage_exports = {};
+__export(async_storage_exports, {
+  asyncStorageTools: () => asyncStorageTools
+});
+module.exports = __toCommonJS(async_storage_exports);
+var asyncStorageTools = () => ({});

package/dist/noop/device.cjs

@@ -0,0 +1,26 @@
+"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/device.ts
+var device_exports = {};
+__export(device_exports, {
+  deviceTools: () => deviceTools
+});
+module.exports = __toCommonJS(device_exports);
+var deviceTools = () => ({});

package/dist/noop/jotai.cjs

@@ -0,0 +1,26 @@
+"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/jotai.ts
+var jotai_exports = {};
+__export(jotai_exports, {
+  jotaiTools: () => jotaiTools
+});
+module.exports = __toCommonJS(jotai_exports);
+var jotaiTools = () => ({});

package/dist/noop/react-navigation.cjs

@@ -0,0 +1,26 @@
+"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-navigation.ts
+var react_navigation_exports = {};
+__export(react_navigation_exports, {
+  navTools: () => navTools
+});
+module.exports = __toCommonJS(react_navigation_exports);
+var navTools = () => ({});

package/dist/noop/realtime.cjs

@@ -23,7 +23,8 @@ __export(realtime_exports, {
   createRealtimeTap: () => createRealtimeTap,
   fakeableConnection: () => fakeableConnection,
   realtimeAdapter: () => realtimeAdapter,
-  tapListeners: () => tapListeners
+  tapListeners: () => tapListeners,
+  tapOutgoing: () => tapOutgoing
 });
 module.exports = __toCommonJS(realtime_exports);
 var createRealtimeTap = () => ({
@@ -32,9 +33,13 @@ var createRealtimeTap = () => ({
     unsubscribe: () => {
     }
   }),
+  sent: () => {
+  },
   tools: {}
 });
 var tapListeners = () => {
 };
+var tapOutgoing = () => {
+};
 var fakeableConnection = () => void 0;
 var realtimeAdapter = () => () => ({});

package/dist/noop/redux.cjs

@@ -0,0 +1,28 @@
+"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/redux.ts
+var redux_exports = {};
+__export(redux_exports, {
+  bridgeReducer: () => bridgeReducer,
+  reduxTools: () => reduxTools
+});
+module.exports = __toCommonJS(redux_exports);
+var reduxTools = () => ({});
+var bridgeReducer = (reducer) => reducer;

package/dist/noop/secure-store.cjs

@@ -0,0 +1,26 @@
+"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/secure-store.ts
+var secure_store_exports = {};
+__export(secure_store_exports, {
+  secureStoreTools: () => secureStoreTools
+});
+module.exports = __toCommonJS(secure_store_exports);
+var secureStoreTools = () => ({});

package/dist/realtime/index.cjs

@@ -23,7 +23,8 @@ __export(realtime_exports, {
   createRealtimeTap: () => createRealtimeTap,
   fakeableConnection: () => fakeableConnection,
   realtimeAdapter: () => realtimeAdapter,
-  tapListeners: () => tapListeners
+  tapListeners: () => tapListeners,
+  tapOutgoing: () => tapOutgoing
 });
 module.exports = __toCommonJS(realtime_exports);
 
@@ -75,6 +76,21 @@ function tapListeners(tap, target, options) {
     };
   }
 }
+function tapOutgoing(tap, target, options) {
+  const methods = target;
+  for (const name of list(options.methods)) {
+    const send = methods[name];
+    if (typeof send !== "function") continue;
+    methods[name] = function(...args) {
+      try {
+        const channel = options.skip?.(this) ? void 0 : options.channel(args);
+        if (channel !== void 0) tap.sent(channel, options.describe(args));
+      } catch {
+      }
+      return send.apply(this, args);
+    };
+  }
+}
 function fakeableConnection(target, options) {
   const methods = target;
   const events = methods?.[options.events];
@@ -119,6 +135,46 @@ function realtimeAdapter(install) {
   };
 }
 
+// src/network/headers.ts
+var SECRET = /auth|cookie|token|secret|session|password|passwd|signature|api-?key|credential|jwt/i;
+
+// src/realtime/snapshot.ts
+var MAX_STRING = 2e3;
+var MAX_ITEMS = 50;
+var MAX_DEPTH = 5;
+var isPlain = (v) => {
+  const proto = Object.getPrototypeOf(v);
+  return proto === Object.prototype || proto === null;
+};
+function snapshot(value, depth = 0) {
+  if (typeof value === "string")
+    return value.length > MAX_STRING ? `${value.slice(0, MAX_STRING)}\u2026 (+${value.length - MAX_STRING} chars)` : value;
+  if (typeof value === "function") return "[function]";
+  if (!value || typeof value !== "object") return value;
+  if (ArrayBuffer.isView(value) || value instanceof ArrayBuffer)
+    return `[${value.constructor.name} ${value.byteLength} bytes]`;
+  if (depth >= MAX_DEPTH) return "[\u2026]";
+  if (Array.isArray(value)) {
+    const items = value.slice(0, MAX_ITEMS).map((v) => snapshot(v, depth + 1));
+    if (value.length > MAX_ITEMS) items.push(`\u2026 (+${value.length - MAX_ITEMS} items)`);
+    return items;
+  }
+  if (value instanceof Date) return value.toISOString();
+  if (!isPlain(value)) return `[${value.constructor?.name ?? "object"}]`;
+  const out = {};
+  for (const key of Object.keys(value).slice(0, MAX_ITEMS))
+    out[key] = snapshot(value[key], depth + 1);
+  return out;
+}
+function redact(value, depth = 0) {
+  if (!value || typeof value !== "object" || depth >= MAX_DEPTH + 1) return value;
+  if (Array.isArray(value)) return value.map((v) => redact(v, depth + 1));
+  const out = {};
+  for (const [key, v] of Object.entries(value))
+    out[key] = SECRET.test(key) ? "[redacted]" : redact(v, depth + 1);
+  return out;
+}
+
 // src/realtime/tap.ts
 var LOG_SIZE = 50;
 var ALL = "*";
@@ -162,6 +218,17 @@ function createRealtimeTap(options = {}) {
     }
     if (!dropped) entry.deliver(message, ...rest);
   }
+  const sent = (channel, summary) => {
+    log.push({
+      at: (/* @__PURE__ */ new Date()).toISOString(),
+      channel,
+      ...summary,
+      ..."data" in summary && { data: snapshot(summary.data) },
+      injected: false,
+      sent: true
+    });
+    if (log.length > LOG_SIZE) log.splice(0, log.length - LOG_SIZE);
+  };
   const wrap = (channel, listener, wrapOptions = {}) => {
     const entry = {
       deliver: listener,
@@ -211,11 +278,11 @@ function createRealtimeTap(options = {}) {
       }))
     },
     [`${ns}.log`]: {
-      description: `Recent messages, real and injected, newest first (last ${LOG_SIZE}). Filter: { channel?, event?, limit? }; clear: true empties the log after reading.`,
+      description: `Recent messages, real, injected, and ones the app sent (sent: true) (socket.emit, Ably publish), newest first (last ${LOG_SIZE}). Filter: { channel?, event?, limit?, full? }; clear: true empties the log after reading. Sent messages are copied and cut, and keys like token, password or authorization show [redacted] unless full: true.`,
       run: (filter = {}) => {
         const entries = log.filter(
           (e) => (!filter.channel || e.channel === filter.channel) && (!filter.event || e.event === filter.event)
-        ).reverse().slice(0, filter.limit ?? 20);
+        ).reverse().slice(0, filter.limit ?? 20).map((e) => e.sent && !filter.full && "data" in e ? { ...e, data: redact(e.data) } : e);
         if (filter.clear) log.length = 0;
         return entries;
       }
@@ -276,5 +343,5 @@ function createRealtimeTap(options = {}) {
         return { state: faked ?? connection.state(), real: connection.state(), faked: faked !== null };
       }
     };
-  return { wrap, tools };
+  return { wrap, sent, tools };
 }

package/dist/realtime/index.d.cts

@@ -1,4 +1,4 @@
-import { T as Tools } from '../types-BmpykP1P.cjs';
+import { T as Tools } from '../types-qlwdcGjt.cjs';
 
 /** How a message shows up in `realtime.log`. */
 type MessageSummary = {
@@ -58,6 +58,8 @@ type RealtimeTap<M> = {
         listener: (message: M, ...rest: unknown[]) => void;
         unsubscribe: () => void;
     };
+    /** Logs a message the app sent, so an agent can check "did the app send X". */
+    sent: (channel: string, summary: MessageSummary) => void;
     /** `realtime.*`, or `<namespace>.*`. */
     tools: Tools;
 };
@@ -67,6 +69,8 @@ type RealtimeLogEntry = MessageSummary & {
     injected: boolean;
     /** Why the app didn't get it. */
     dropped?: 'muted' | 'connection';
+    /** True for a message the app sent (`socket.emit`, an Ably `publish`), not one it received. */
+    sent?: true;
 };
 /**
  * Lets the agent see, fake and drop realtime messages, whatever library
@@ -98,6 +102,21 @@ type TapListenersOptions<M> = {
  * Removing works in every usual form: all, by key, by listener, or both.
  */
 declare function tapListeners<M>(tap: RealtimeTap<M>, target: object, options: TapListenersOptions<M>): void;
+type TapOutgoingOptions = {
+    /** Methods that send, e.g. "emit" or "publish". */
+    methods: string | string[];
+    /** The channel a call is for, from its arguments. Return undefined to leave the call unlogged. */
+    channel: (args: unknown[]) => string | undefined;
+    /** What to log for the call. */
+    describe: (args: unknown[]) => MessageSummary;
+    /** True for a call that repeats one already logged, e.g. socket.io re-sending from its retry queue. */
+    skip?: (target: object) => boolean;
+};
+/**
+ * Logs what the app sends through `target`'s methods in `realtime.log`
+ * (`sent: true`). The call itself always goes through untouched.
+ */
+declare function tapOutgoing(tap: Pick<RealtimeTap<never>, 'sent'>, target: object, options: TapOutgoingOptions): void;
 type FakeableConnectionOptions = {
     /** The property holding the state, e.g. "state" or "connected". */
     property: string;
@@ -137,4 +156,4 @@ declare function fakeableConnection(target: object | undefined, options: Fakeabl
  */
 declare function realtimeAdapter<C extends object, O extends object>(install: (client: C, options: O) => Pick<RealtimeTap<unknown>, 'tools'>): (client: C, options?: O) => Tools;
 
-export { type FakeableConnectionOptions, type MessageSummary, type RealtimeConnection, type RealtimeLogEntry, type RealtimeTap, type RealtimeTapOptions, type TapListenersOptions, type WrapOptions, createRealtimeTap, fakeableConnection, realtimeAdapter, tapListeners };
+export { type FakeableConnectionOptions, type MessageSummary, type RealtimeConnection, type RealtimeLogEntry, type RealtimeTap, type RealtimeTapOptions, type TapListenersOptions, type TapOutgoingOptions, type WrapOptions, createRealtimeTap, fakeableConnection, realtimeAdapter, tapListeners, tapOutgoing };