@deeeed/metamask-harness 0.23.1 → 0.25.0

package/library/actions/shared/analytics/read_events.mjs

@@ -0,0 +1,22 @@
+import { runAdapter } from './_adapter.mjs';
+import { readCollected } from './collector.mjs';
+
+runAdapter(async (input) => {
+  const since = input.node?.since === undefined ? 0 : Number(input.node.since);
+  if (input.node?.since === '' || !Number.isFinite(since) || since < 0) {
+    throw new Error(`metamask.analytics.read_events since must be a non-negative number, got ${JSON.stringify(input.node?.since)}.`);
+  }
+  const event = input.node?.event ?? null;
+  if (event !== null && (typeof event !== 'string' || event.length === 0)) {
+    throw new Error('metamask.analytics.read_events event must be a non-empty string when provided.');
+  }
+  const events = await readCollected(input, { since, event });
+  return {
+    action: input.action,
+    since,
+    count: events.length,
+    events,
+    // Names alone are usually what a human wants to eyeball in the artifact.
+    names: events.map((entry) => entry.event).filter(Boolean),
+  };
+});

package/library/actions/shared/analytics/start_capture.mjs

@@ -0,0 +1,24 @@
+import { runAdapter } from './_adapter.mjs';
+import { startCollector } from './collector.mjs';
+
+// Returns a cursor so later reads can be bracketed to this flow. Without it,
+// repeated event names (`Perp Screen Viewed`) cross-match between flows.
+runAdapter(async (input) => {
+  const {
+    port,
+    pid,
+    eventsFile,
+    reused,
+    androidDevice,
+  } = await startCollector(input);
+  return {
+    action: input.action,
+    cursor: Date.now(),
+    port,
+    pid,
+    eventsFile,
+    reused,
+    androidDevice,
+    note: `Client must be built with its Segment host pointed at http://localhost:${port} (extension SEGMENT_HOST, mobile SEGMENT_PROXY_URL) and a non-empty write key.`,
+  };
+});