@fairfox/polly 0.69.0 → 0.70.0

package/dist/src/shared/lib/mesh-network-adapter.d.ts

@@ -139,9 +139,5 @@ export declare class MeshNetworkAdapter extends NetworkAdapter {
      * and target ids and the crypto blob in the `data` field.
      */
     private wrap;
-    /**
-     * Try to unwrap an incoming crypto-wrapped message. Returns the original
-     * Message on success, undefined on verification or decryption failure.
-     */
     private tryUnwrap;
 }

package/dist/tools/test/src/e2e-mesh/console-allowlist.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fairfox/polly/test/e2e-mesh — canonical console-noise allowlist.
+ *
+ * Mesh runs emit a small number of benign console lines (Repo lifecycle,
+ * Automerge warmup, occasional sync diagnostics). E2e scripts watch the
+ * Puppeteer console stream and fail on anything unexpected; without an
+ * allowlist every run trips on the same benign noise.
+ *
+ * The allowlist is owned by polly because polly knows which lines its
+ * own code produces. Consumers extend it with their app-specific noise.
+ * Entries are tested as substrings against the rendered console message.
+ */
+/** Match a console line that contains the given substring. */
+export interface ConsolePattern {
+    /** Optional console level filter — "log" | "info" | "warn" | "error".
+     *  Undefined matches any level. */
+    level?: "log" | "info" | "warn" | "error";
+    /** Substring or RegExp the rendered console line must satisfy. */
+    match: string | RegExp;
+    /** Short reason — surfaces in failure messages when the allowlist
+     *  evolves and an entry should be removed. */
+    reason: string;
+}
+export declare const MESH_CONSOLE_ALLOWLIST: ReadonlyArray<ConsolePattern>;
+/**
+ * Return true when the console line matches any allowlist entry.
+ */
+export declare function isAllowedConsoleLine(line: {
+    level: string;
+    text: string;
+}, allowlist?: ReadonlyArray<ConsolePattern>): boolean;

package/dist/tools/test/src/e2e-mesh/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fairfox/polly/test/e2e-mesh — end-to-end test kit for the mesh.
+ *
+ * Centralises the patterns every consumer's e2e scripts reinvent today:
+ * pairing-ceremony driving, convergence polling, console-noise filtering,
+ * screenshot-on-failure, and an embedded signalling relay. Fairfox and
+ * lingua import from this subpath rather than reimplementing.
+ *
+ * The kit is opinionated about the shape of the consumer it drives —
+ * pairing UI exposes stable `data-e2e-*` attributes, the bootstrap path
+ * goes through `createMeshClient`, the document state is observable via
+ * a polled DOM predicate. Consumers that follow the conventions get the
+ * full kit for free; those that diverge supply their own driver per
+ * primitive.
+ *
+ * Diagnostic obligation runs by default through {@link startDiagnosticRecorder}:
+ * unexpected silent drops on the diagnostic stream fail the script. A
+ * scenario that legitimately exercises a drop branch (e.g. revocation)
+ * passes the expected kinds to `assertNoSilentDrops({ allow: [...] })`.
+ */
+export { type ConsolePattern, isAllowedConsoleLine, MESH_CONSOLE_ALLOWLIST, } from "./console-allowlist";
+export { knownPeersFor, type PrebakedKeyringPair, type PrebakedKeyringSet, type PrebakedPeer, prebakeKeyringPair, prebakeKeyringSet, } from "./keys";
+export { type CapturedConsoleLine, type LaunchedPeer, type LaunchPeerOptions, launchPeer, } from "./launch-peer";
+export { type DiagnosticRecorder, MeshAssertionError, type MeshAssertionFailure, startDiagnosticRecorder, } from "./mesh-assertions";
+export { type ServeConsumerOptions, type ServeConsumerResult, serveConsumer, } from "./serve-consumer";
+export { type ConvergencePredicate, type PeerSnapshot, type WaitForConvergenceOptions, waitForConvergence, waitForMeshConnected, } from "./wait-for-convergence";
+export { type WithRelayOptions, type WithRelayResult, withRelay } from "./with-relay";