@fairfox/polly 0.23.0 → 0.24.0

package/dist/src/shared/lib/blob-store-impl.d.ts

@@ -0,0 +1,33 @@
+/**
+ * blob-store-impl — peer-to-peer blob store backed by WebRTC data channels.
+ *
+ * The store piggybacks on an existing MeshWebRTCAdapter. Blob messages ride
+ * on the same data channel as Automerge sync traffic, distinguished by a
+ * "blob-" prefix on the message type field.
+ *
+ * Lifecycle:
+ * - put:  hash-verify → cache plaintext locally → announce blob-have
+ * - get:  check cache → if miss, send blob-request(s) → receive chunks
+ *         → decrypt each chunk as it arrives → reassemble plaintext
+ *         → hash-verify → cache
+ *
+ * Encryption model: chunk-then-encrypt. The sender chunks the plaintext
+ * into 64 KiB pieces, encrypts each chunk independently under the configured
+ * key (with a fresh random nonce per chunk), and sends the sealed envelope.
+ * The receiver decrypts each chunk on arrival. Peak sender memory is ~1
+ * chunk of ciphertext at a time rather than the entire ciphertext blob.
+ *
+ * Per-op keys: callers can override the store's default encryption key per
+ * put/get via BlobTransferOptions.key. This supports per-document keys
+ * without requiring the store to track document ownership.
+ *
+ * Multi-source fetch: the get() flow requests from a single peer initially,
+ * but the re-request timer rotates through peers that have announced
+ * availability of the blob, so a transfer that stalls on one peer recovers
+ * against another.
+ */
+import type { BlobStore, BlobStoreOptions } from "./blob-store";
+import type { MeshWebRTCAdapter } from "./mesh-webrtc-adapter";
+/** Create a blob store that transfers blobs peer-to-peer over a
+ *  MeshWebRTCAdapter's data channels. */
+export declare function createBlobStore(adapter: MeshWebRTCAdapter, options?: BlobStoreOptions): BlobStore;

package/dist/src/shared/lib/blob-store.d.ts

@@ -0,0 +1,87 @@
+/**
+ * blob-store — types and interfaces for Polly's content-addressed blob storage.
+ *
+ * This file contains only type definitions and interfaces. It has no runtime
+ * imports from tweetnacl or other crypto libraries, so peer-only consumers
+ * tree-shake cleanly when importing from @fairfox/polly/mesh.
+ */
+import type { BlobRef } from "./blob-ref";
+export type BlobProgressPhase = "encrypting" | "uploading" | "downloading" | "decrypting";
+export interface BlobProgressEvent {
+    /** Bytes processed so far in the current phase. */
+    loaded: number;
+    /** Total bytes expected. Undefined when unknown (e.g. start of download). */
+    total: number | undefined;
+    /** Current operation phase. */
+    phase: BlobProgressPhase;
+}
+export type BlobProgressCallback = (event: BlobProgressEvent) => void;
+export interface BlobTransferOptions {
+    onProgress?: BlobProgressCallback;
+    signal?: AbortSignal;
+    /** Override the store's default encryption key for this operation.
+     *  Useful for per-document keys: pass the document's key here so the
+     *  blob is encrypted under that key rather than the store default.
+     *  Ignored if the store has no encryption configured. */
+    key?: Uint8Array;
+}
+/** Storage backend for blob bytes. Implementations must store Uint8Array
+ *  values keyed by SHA-256 hex hash without serialisation loss. */
+export interface BlobCache {
+    get(hash: string): Promise<Uint8Array | undefined>;
+    put(hash: string, bytes: Uint8Array): Promise<void>;
+    has(hash: string): Promise<boolean>;
+    delete(hash: string): Promise<void>;
+    dispose(): void;
+    /** Mark a hash as pinned — it will not be evicted until unpinned.
+     *  Applications typically pin blobs referenced by documents they
+     *  currently hold locally. */
+    pin(hash: string): Promise<void>;
+    /** Remove the pinned mark. The blob becomes eligible for eviction. */
+    unpin(hash: string): Promise<void>;
+    /** Total bytes stored in the cache. */
+    size(): Promise<number>;
+    /** Evict unpinned entries in LRU order until total size ≤ maxBytes.
+     *  Returns the number of bytes freed. */
+    evict(maxBytes: number): Promise<number>;
+}
+export interface BlobStore {
+    /** Store bytes locally and announce availability to connected peers.
+     *  Verifies that the hash of `bytes` matches `ref.hash` before storing. */
+    put(ref: BlobRef, bytes: Uint8Array, options?: BlobTransferOptions): Promise<void>;
+    /** Retrieve bytes by hash. Checks local cache first; if not cached,
+     *  requests from connected peers. Returns undefined if unavailable. */
+    get(hash: string, options?: BlobTransferOptions): Promise<Uint8Array | undefined>;
+    /** Return an object URL for rendering (e.g. <img src>). Cached per hash;
+     *  repeated calls with the same hash return the same URL. Returns
+     *  undefined if the blob is not in the local cache. All URLs are revoked
+     *  on dispose(). */
+    url(hash: string): Promise<string | undefined>;
+    /** Pin a blob so it won't be evicted. Applications should pin blobs
+     *  referenced by documents they currently hold. */
+    pin(hash: string): Promise<void>;
+    /** Unpin a blob. Removing a document that references a blob is a
+     *  natural place to unpin. */
+    unpin(hash: string): Promise<void>;
+    /** Total bytes stored in the local cache. */
+    size(): Promise<number>;
+    /** Evict unpinned entries in LRU order until total size ≤ maxBytes.
+     *  Returns bytes freed. */
+    evict(maxBytes: number): Promise<number>;
+    /** Revoke all outstanding object URLs and release resources. */
+    dispose(): void;
+}
+export interface BlobStoreOptions {
+    /** Maximum blob size in bytes. Defaults to 100 MiB. */
+    maxBlobSize?: number;
+    /** Default encryption config. When configured, blobs are encrypted
+     *  with this key unless overridden per-op via BlobTransferOptions.key.
+     *  Omit for plaintext transfer (DTLS only). */
+    encrypt?: {
+        key: Uint8Array;
+    };
+    /** Custom cache implementation. Defaults to MemoryBlobCache (suitable
+     *  for tests and Node). Browser consumers should pass an
+     *  IndexedDBBlobCache instance. */
+    cache?: BlobCache;
+}

package/dist/src/shared/lib/blob-transfer.d.ts

@@ -0,0 +1,58 @@
+/**
+ * blob-transfer — chunking, reassembly, and wire format for peer-to-peer
+ * blob transfer over WebRTC data channels.
+ *
+ * Blobs are split into fixed-size chunks (64 KiB) and sent as individual
+ * data channel messages. The wire format reuses the same length-prefixed
+ * header + binary payload layout that MeshWebRTCAdapter uses for Automerge
+ * sync messages. Blob messages are distinguished by a `type` field in the
+ * JSON header that starts with "blob-".
+ *
+ * Three message types:
+ * - blob-chunk:   a single chunk of a blob transfer
+ * - blob-request: ask a peer to send chunks for a specific hash
+ * - blob-have:    announce local availability of a blob
+ */
+/** Default chunk size in bytes: 64 KiB. Stays well within WebRTC SCTP
+ *  message size limits (~256 KiB in most browsers). */
+export declare const BLOB_CHUNK_SIZE = 65536;
+/** High-water mark for RTCDataChannel.bufferedAmount. The sender pauses
+ *  when the buffer exceeds this threshold. */
+export declare const BLOB_BUFFER_HIGH_WATER: number;
+export interface BlobChunkHeader {
+    type: "blob-chunk";
+    hash: string;
+    index: number;
+    total: number;
+}
+export interface BlobRequestHeader {
+    type: "blob-request";
+    hash: string;
+    /** Chunk indices needed. Omit to request all chunks. */
+    missing?: number[];
+}
+export interface BlobHaveHeader {
+    type: "blob-have";
+    hash: string;
+}
+export type BlobMessageHeader = BlobChunkHeader | BlobRequestHeader | BlobHaveHeader;
+/** Split bytes into fixed-size chunks. The last chunk may be smaller. */
+export declare function chunkBlob(bytes: Uint8Array, chunkSize?: number): Uint8Array[];
+/** Reassemble chunks into a single Uint8Array. Throws if any chunk index
+ *  in [0, total) is missing from the map. */
+export declare function reassembleChunks(chunks: Map<number, Uint8Array>, total: number): Uint8Array;
+/** Return the indices of chunks missing from a partial chunk map. */
+export declare function missingChunkIndices(chunks: Map<number, Uint8Array>, total: number): number[];
+/** Serialise a blob message into the shared wire format:
+ *  [4-byte BE header length][JSON header bytes][binary payload].
+ *  Returns an ArrayBuffer-backed Uint8Array usable by RTCDataChannel.send. */
+export declare function serialiseBlobMessage(header: BlobMessageHeader, data?: Uint8Array): Uint8Array<ArrayBuffer>;
+/** Peek at the header of a wire-format message without full
+ *  deserialisation. Returns the parsed header and the data slice,
+ *  or undefined if the bytes are too short or malformed. */
+export declare function parseBlobMessage(bytes: Uint8Array): {
+    header: BlobMessageHeader;
+    data: Uint8Array;
+} | undefined;
+/** Check whether a wire-format message header type starts with "blob-". */
+export declare function isBlobMessageType(bytes: Uint8Array): boolean;

package/dist/src/shared/lib/crdt-specialised.d.ts

@@ -33,7 +33,7 @@
  * and the {@link MigratableState} interface. Variants differ only in the
  * `extractValue` and `applyWrite` hooks they pass.
  */
-import { Counter, type DocHandle } from "@automerge/automerge-repo";
+import { Counter, type DocHandle } from "@automerge/automerge-repo/slim";
 import type { Access } from "./access";
 import { type MigratableState } from "./migrate-primitive";
 import { type PrimitiveKind } from "./primitive-registry";

package/dist/src/shared/lib/crdt-state.d.ts

@@ -22,7 +22,7 @@
  * counters, and lists (which require type-specific operation capture to
  * preserve concurrent-edit semantics) land in Phase 1's crdt-specialised.ts.
  */
-import type { DocHandle } from "@automerge/automerge-repo";
+import type { DocHandle } from "@automerge/automerge-repo/slim";
 import type { Access } from "./access";
 import { type MigratableState } from "./migrate-primitive";
 import { type PrimitiveKind } from "./primitive-registry";

package/dist/src/shared/lib/keyring-storage.d.ts

@@ -0,0 +1,57 @@
+/**
+ * keyring-storage — persistence abstraction for {@link MeshKeyring}.
+ *
+ * The keyring itself is a plain structural object of `Map`s, `Set`s, and a
+ * signing keypair; it is deliberately not coupled to any persistence layer.
+ * This module defines a storage interface that applications implement once
+ * for their runtime (IndexedDB, the filesystem, a keychain, a secret
+ * manager, whatever) and wire into {@link createMeshClient} via its
+ * `keyring.storage` option.
+ *
+ * A canonical JSON-with-base64 serialisation is provided by
+ * {@link serialiseKeyring} and {@link deserialiseKeyring}. It is inspectable
+ * by humans, survives manual edits, and round-trips every field of the
+ * keyring. Storage implementations that write plain strings (files,
+ * localStorage, `kv` stores) can lean on these helpers; storage
+ * implementations that persist structured data (IndexedDB, a keychain API)
+ * can serialise differently if they prefer.
+ */
+import type { MeshKeyring } from "./mesh-network-adapter";
+/**
+ * A load/save pair for a single {@link MeshKeyring}. Implementations are
+ * free to choose where and how the keyring is stored; the factory only
+ * cares that `load()` returns the previously-saved keyring or `null`, and
+ * that `save(keyring)` durably persists it.
+ */
+export interface KeyringStorage {
+    /** Load the previously-saved keyring, or return `null` if none exists.
+     * Implementations may throw for truly exceptional conditions (disk
+     * errors, permission failures); a missing keyring is not exceptional. */
+    load(): Promise<MeshKeyring | null>;
+    /** Durably persist the keyring. Implementations should atomically replace
+     * any existing stored value; partial writes must not leave the store in
+     * an inconsistent state. */
+    save(keyring: MeshKeyring): Promise<void>;
+}
+/**
+ * In-memory storage. Useful for tests, ephemeral tools, and the first-run
+ * bootstrap path where the keyring only lives for the duration of the
+ * process. Calling `save` holds the keyring in a closed-over variable;
+ * `load` returns it on subsequent calls within the same process.
+ */
+export declare function memoryKeyringStorage(): KeyringStorage;
+/**
+ * Encode a {@link MeshKeyring} to a canonical JSON string. Every
+ * `Uint8Array` field (identity keys, public keys, document keys) is
+ * base64-encoded; `Map`s and `Set`s become plain objects and arrays. The
+ * output is pretty-printed so a human operator can eyeball or hand-edit
+ * the file on disk.
+ */
+export declare function serialiseKeyring(keyring: MeshKeyring): string;
+/**
+ * Decode a keyring from the format produced by {@link serialiseKeyring}.
+ * Throws with a descriptive message when the input is malformed, so
+ * corrupt storage surfaces as an actionable error rather than a silent
+ * downgrade.
+ */
+export declare function deserialiseKeyring(text: string): MeshKeyring;

package/dist/src/shared/lib/mesh-client.d.ts

@@ -0,0 +1,91 @@
+/**
+ * mesh-client — first-class factory for constructing a Polly mesh client.
+ *
+ * The mesh transport stack has five pieces that have to be wired together:
+ * a {@link MeshSignalingClient} talking to the relay server, a
+ * {@link MeshWebRTCAdapter} that owns the per-peer RTCPeerConnections, a
+ * {@link MeshNetworkAdapter} that signs and encrypts every message on the
+ * way through, an Automerge `Repo` that drives sync, and a `MeshKeyring`
+ * that holds the crypto material. Prior to this module, every consuming
+ * application had to assemble the five pieces by hand — and in Node or
+ * Bun had to monkey-patch `globalThis.WebSocket` / `globalThis.RTCPeerConnection`
+ * because the lower-level primitives reached for those globals.
+ *
+ * `createMeshClient` takes options, hands back a `MeshClient`, and also
+ * calls `configureMeshState(client.repo)` so `$meshState` works without
+ * a second setup step. The WebSocket and RTCPeerConnection implementations
+ * are injectable; defaults read from `globalThis` for browser ergonomics.
+ * The companion `@fairfox/polly/mesh/node` subpath provides a CLI bootstrap
+ * helper that wires werift (or `@roamhq/wrtc` if the consumer prefers) and
+ * a file-backed keyring store.
+ */
+import { Repo, type StorageAdapterInterface } from "@automerge/automerge-repo/slim";
+import type { KeyringStorage } from "./keyring-storage";
+import { type MeshKeyring, MeshNetworkAdapter } from "./mesh-network-adapter";
+import { MeshSignalingClient, type MeshSignalingClientOptions } from "./mesh-signaling-client";
+import { MeshWebRTCAdapter, type MeshWebRTCAdapterOptions } from "./mesh-webrtc-adapter";
+/** Options for {@link createMeshClient}. */
+export interface CreateMeshClientOptions {
+    /** Signalling-server configuration. `peerId` must be the same identity
+     * this client's keyring was paired with on other peers. */
+    signaling: {
+        url: string;
+        peerId: string;
+        /** Optional WebSocket ctor override (e.g. `ws` on old Node). Defaults
+         * to `globalThis.WebSocket`. */
+        WebSocket?: MeshSignalingClientOptions["WebSocket"];
+        /** Forwarded error callback for diagnostic UI. */
+        onError?: MeshSignalingClientOptions["onError"];
+    };
+    /** WebRTC configuration. On browsers the defaults are fine; in Node or
+     * Bun pass the `RTCPeerConnection` ctor from `werift` or `@roamhq/wrtc`. */
+    rtc?: {
+        RTCPeerConnection?: MeshWebRTCAdapterOptions["RTCPeerConnection"];
+        iceServers?: RTCIceServer[];
+        dataChannelLabel?: string;
+    };
+    /** The local peer's keyring — either a fully-constructed instance, or a
+     * persistence adapter to load one from. When a storage adapter is given
+     * and `storage.load()` resolves to `null`, the factory throws with a
+     * message pointing at the bootstrap helper in `@fairfox/polly/mesh/node`;
+     * we deliberately do not generate an identity silently. */
+    keyring: MeshKeyring | {
+        storage: KeyringStorage;
+    };
+    /** Optional Automerge-Repo storage adapter. Applications that want
+     * durable local state pass an IndexedDB adapter in browsers or a
+     * filesystem adapter in Node; omitting it keeps the Repo in-memory. */
+    repoStorage?: StorageAdapterInterface;
+    /** When `false`, signs but does not encrypt. Defaults to `true` — the
+     * full $meshState posture where the server is off the data path. */
+    encryptionEnabled?: boolean;
+}
+/** Handle returned by {@link createMeshClient}. */
+export interface MeshClient {
+    /** The Automerge Repo. `$meshState` has already been configured against
+     * this repo, so primitives just work — but the repo is exposed in case
+     * the application needs it directly (server-side cron, bulk exports,
+     * migration tools). */
+    repo: Repo;
+    /** The configured keyring. Exposed so the application can inspect or
+     * mutate it (add authorised peers, apply revocations) and then
+     * re-persist via its storage. */
+    keyring: MeshKeyring;
+    /** The signalling client. Exposed for applications that need to hook
+     * lifecycle events or send custom signalling payloads. */
+    signaling: MeshSignalingClient;
+    /** The WebRTC network adapter. Exposed for advanced use (blob store
+     * wiring, peer-connection introspection). */
+    networkAdapter: MeshNetworkAdapter;
+    /** The underlying WebRTC adapter wrapped by {@link networkAdapter}. */
+    webrtcAdapter: MeshWebRTCAdapter;
+    /** Close the signalling WebSocket, tear down every RTCPeerConnection,
+     * and shut the Repo cleanly. Idempotent. */
+    close(): Promise<void>;
+}
+/**
+ * Construct a fully-wired mesh client. Resolves once the signalling
+ * connection is open and the Repo is ready to mutate documents; WebRTC
+ * peer connections negotiate asynchronously in the background.
+ */
+export declare function createMeshClient(options: CreateMeshClientOptions): Promise<MeshClient>;

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

@@ -39,7 +39,7 @@
  * threading the document context through the network subsystem (which
  * needs upstream support). A follow-up will address this.
  */
-import { type Message, NetworkAdapter, type PeerId, type PeerMetadata } from "@automerge/automerge-repo";
+import { type Message, NetworkAdapter, type PeerId, type PeerMetadata } from "@automerge/automerge-repo/slim";
 import { type SigningKeyPair } from "./signing";
 /** The well-known document id used for the Phase 2 first-cut single-key
  * encryption mode. See the file-level comment for the per-document key

package/dist/src/shared/lib/mesh-signaling-client.d.ts

@@ -41,6 +41,11 @@ export interface MeshSignalingClientOptions {
     /** Optional callback for the open and close lifecycle events. */
     onOpen?: () => void;
     onClose?: () => void;
+    /** WebSocket constructor. Defaults to `globalThis.WebSocket`. Inject a
+     * different implementation (e.g. `ws` package's `WebSocket`) when running
+     * in an environment without a native WebSocket global, or to use a custom
+     * subclass for tests or instrumentation. */
+    WebSocket?: typeof WebSocket;
 }
 /**
  * Thin wrapper around a WebSocket connection to a Polly signalling server.
@@ -61,6 +66,7 @@ export declare class MeshSignalingClient {
     private readonly onClose?;
     private socket;
     private joined;
+    private readonly WebSocketCtor;
     constructor(options: MeshSignalingClientOptions);
     /**
      * Open the WebSocket and send the join message. Resolves once the

package/dist/src/shared/lib/mesh-state.d.ts

@@ -32,7 +32,7 @@
  * RTCDataChannel; for tests and for the early Phase 2 cut, an in-memory
  * loopback adapter pair satisfies the same contract.
  */
-import type { Repo } from "@automerge/automerge-repo";
+import type { Repo } from "@automerge/automerge-repo/slim";
 import type { Access } from "./access";
 import { type SpecialisedPrimitive } from "./crdt-specialised";
 import { type CrdtPrimitive } from "./crdt-state";

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

@@ -44,7 +44,7 @@
  * - Disconnect tears down every peer connection and closes the
  *   signalling client.
  */
-import { type Message, NetworkAdapter, type PeerId, type PeerMetadata } from "@automerge/automerge-repo";
+import { type Message, NetworkAdapter, type PeerId, type PeerMetadata } from "@automerge/automerge-repo/slim";
 import type { MeshSignalingClient } from "./mesh-signaling-client";
 /** Standard STUN servers for NAT traversal. In production, callers who
  * need TURN fallback for peers behind symmetric NATs should replace this
@@ -72,6 +72,11 @@ export interface MeshWebRTCAdapterOptions {
      * that share a signalling server between multiple meshes may want
      * distinct labels per mesh. */
     dataChannelLabel?: string;
+    /** RTCPeerConnection constructor. Defaults to
+     * `globalThis.RTCPeerConnection`. Inject a different implementation
+     * (e.g. `werift` or `@roamhq/wrtc`) when running outside a browser, or
+     * to use a custom subclass for tests or instrumentation. */
+    RTCPeerConnection?: typeof RTCPeerConnection;
 }
 /**
  * Automerge-Repo NetworkAdapter backed by real WebRTC data channels.
@@ -83,9 +88,14 @@ export declare class MeshWebRTCAdapter extends NetworkAdapter {
     readonly iceServers: RTCIceServer[];
     readonly dataChannelLabel: string;
     readonly knownPeerIds: string[];
+    private readonly RTCPeerConnectionCtor;
     private readonly slots;
     private ready;
     private readyResolver;
+    /** Callback for incoming blob messages. Set by the blob store.
+     *  Called with the sender's peer ID, the raw header object, and the
+     *  binary payload (chunk data). */
+    onBlobMessage?: (peerId: string, header: Record<string, unknown>, data: Uint8Array) => void;
     constructor(options: MeshWebRTCAdapterOptions);
     isReady(): boolean;
     whenReady(): Promise<void>;
@@ -120,6 +130,15 @@ export declare class MeshWebRTCAdapter extends NetworkAdapter {
     private wireConnection;
     private wireDataChannel;
     private dispatchMessage;
+    /** Peer IDs with an open data channel, suitable for blob requests. */
+    get connectedPeerIds(): string[];
+    /** Send a pre-serialised blob message to a specific peer. Returns false
+     *  if the peer is not connected or the send buffer is above the high-water
+     *  mark (caller should retry after a delay). */
+    sendBlobMessage(peerId: string, bytes: Uint8Array<ArrayBuffer>): boolean;
+    /** Send bytes on a data channel if the buffer is below the high-water
+     *  mark. Returns true if sent, false if backpressure applies. */
+    private trySendOnChannel;
     /** Pack an Automerge Message into binary for transmission over the
      * data channel. The format mirrors MeshNetworkAdapter's internal
      * serialisation: a length-prefixed JSON header followed by the raw

package/dist/src/shared/lib/peer-relay-adapter.d.ts

@@ -25,7 +25,7 @@
  * // connectionState is a Signal<"connecting" | "connected" | "disconnected">
  * ```
  */
-import { Repo } from "@automerge/automerge-repo";
+import { Repo } from "@automerge/automerge-repo/slim";
 import { WebSocketClientAdapter } from "@automerge/automerge-repo-network-websocket";
 import { type Signal } from "@preact/signals";
 import { type MeshKeyring } from "./mesh-network-adapter";

package/dist/src/shared/lib/peer-repo-server.d.ts

@@ -34,7 +34,7 @@
  * await server.close();
  * ```
  */
-import { Repo } from "@automerge/automerge-repo";
+import { Repo } from "@automerge/automerge-repo/slim";
 import { WebSocketServerAdapter } from "@automerge/automerge-repo-network-websocket";
 import { NodeFSStorageAdapter } from "@automerge/automerge-repo-storage-nodefs";
 import * as ws from "ws";

package/dist/src/shared/lib/peer-state.d.ts

@@ -33,7 +33,7 @@
  * via the same configuration path; Phase 2's mesh adapter does the same for
  * $meshState.
  */
-import type { Repo } from "@automerge/automerge-repo";
+import type { Repo } from "@automerge/automerge-repo/slim";
 import type { Access } from "./access";
 import { type SpecialisedPrimitive } from "./crdt-specialised";
 import { type CrdtPrimitive } from "./crdt-state";

package/dist/src/shared/lib/wasm-init.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Eagerly initialise Automerge's WebAssembly runtime by pointing the library
+ * at the raw `.wasm` file shipped in `@automerge/automerge`.
+ *
+ * The `import.meta.url` pattern below is recognised by every modern bundler
+ * (Bun, Vite, webpack 5+, esbuild) as an asset reference: the `.wasm` gets
+ * copied into the consumer's output alongside the JavaScript, and the URL is
+ * rewritten to point at the copied file. `initializeWasm` then fetches and
+ * instantiates it at runtime. That keeps the WebAssembly out of the JavaScript
+ * bundle entirely — no megabyte-scale base64 string inlined per subpath — and
+ * lets the browser parse the JS and stream-compile the `.wasm` in parallel.
+ *
+ * The top-level `await` makes this module async so any consumer that
+ * transitively imports it inherits the "wait for WASM" behaviour through the
+ * import graph, without needing an explicit init call.
+ */
+export {};

package/dist/tools/quality/src/cli.js

@@ -134,8 +134,15 @@ function findViolations(relative, content) {
   const results = [];
   const lines = content.split(`
 `);
+  let insideTemplate = false;
   for (let i = 0;i < lines.length; i++) {
     const line = lines[i] ?? "";
+    const backticks = (line.match(/`/g) ?? []).length;
+    const startedInTemplate = insideTemplate;
+    if (backticks % 2 === 1)
+      insideTemplate = !insideTemplate;
+    if (startedInTemplate && backticks === 0 && !line.includes("${"))
+      continue;
     if (!isLineClean(line)) {
       results.push({
         file: relative,
@@ -203,4 +210,4 @@ var result = await checkNoAsCasting({
 result.print();
 process.exit(result.violations.length > 0 ? 1 : 0);
 
-//# debugId=E6501402C1BD2E6764756E2164756E21
+//# debugId=D4F70D746137C24364756E2164756E21

package/dist/tools/quality/src/cli.js.map

@@ -2,10 +2,10 @@
   "version": 3,
   "sources": ["../tools/quality/src/no-as-casting.ts", "../tools/quality/src/cli.ts"],
   "sourcesContent": [
-    "/**\n * No-as-casting conformance check.\n *\n * Bans all TypeScript type assertions (`as Type`) except the allowed\n * patterns: `as const` (literal narrowing), `as unknown as` (explicit\n * escape hatch), import/export renames, and `as` inside strings or\n * comments. Violations include pattern-specific fix advice.\n *\n * This module exports the check logic as a library so consuming\n * applications can import it from `@fairfox/polly/quality` and run it\n * programmatically. Polly's own `scripts/check-no-as-casting.ts` is a\n * thin CLI wrapper around these exports.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { Glob } from \"bun\";\n\nexport interface Violation {\n  file: string;\n  line: number;\n  content: string;\n  advice?: string;\n}\n\nexport interface CheckResult {\n  violations: Violation[];\n  print: () => void;\n}\n\nexport interface CheckOptions {\n  rootDir: string;\n  exclude?: string[];\n  excludePackages?: string[];\n  excludeFiles?: string[];\n  filePatterns?: string;\n}\n\n/**\n * Check whether a line contains a forbidden `as` type assertion.\n * Returns true if the line is clean (no violation), false if it violates.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Source-text scanning with many skip rules is inherently branchy.\nexport function isLineClean(line: string): boolean {\n  if (!line.includes(\" as \")) return true;\n\n  const trimmed = line.trim();\n\n  // Full-line comments\n  if (trimmed.startsWith(\"//\") || trimmed.startsWith(\"*\") || trimmed.startsWith(\"/*\")) {\n    return true;\n  }\n\n  // as const (literal narrowing)\n  if (line.match(/\\bas const\\b/)) {\n    const withoutAsConst = line.replace(/\\bas const\\b/g, \"\");\n    if (!withoutAsConst.includes(\" as \")) return true;\n  }\n\n  // as unknown as (explicit escape hatch)\n  if (line.includes(\" as unknown as \") || line.trimEnd().endsWith(\"as unknown as\")) {\n    const withoutEscapeHatch = line.replace(/\\bas unknown as\\b/g, \"\");\n    if (!withoutEscapeHatch.includes(\" as \")) return true;\n  }\n\n  // Import/export renames\n  if (\n    line.match(/\\b(import|export)\\s+.*\\s+as\\s+\\w+/) ||\n    line.match(/\\b(import|export)\\s+\\*\\s+as\\s+\\w+/) ||\n    line.match(/\\b(import|export)\\s+type\\s+.*\\s+as\\s+\\w+/) ||\n    line.match(/^\\s*\\w+\\s+as\\s+\\w+,?\\s*$/) ||\n    line.match(/^\\s*type\\s+\\w+\\s+as\\s+\\w+,?\\s*$/)\n  ) {\n    return true;\n  }\n\n  // Property declarations: as= or as: or as,\n  if (line.match(/\\bas\\s*[=:,]/)) return true;\n\n  // String literal detection: count quotes before each ` as ` occurrence.\n  // If any quote type has an odd count, the ` as ` is inside a string.\n  if (everyAsInsideString(line)) return true;\n\n  // JSX text: ` as ` between > and < with no code syntax around it\n  if (isJsxText(trimmed)) return true;\n\n  // Plain text heuristic: indented line with no code syntax characters\n  // before ` as ` — catches multiline JSX text and template literal bodies.\n  if (isPlainText(trimmed)) return true;\n\n  // Inline comment: ` as ` appears only after //\n  const commentIdx = line.indexOf(\"//\");\n  if (commentIdx >= 0 && line.indexOf(\" as \", commentIdx) >= 0) {\n    const beforeComment = line.substring(0, commentIdx);\n    if (!beforeComment.includes(\" as \")) return true;\n  }\n\n  // SQL alias: `) as column_name`\n  if (line.match(/\"\\)\\s+as\\s+\\w+\"/)) return true;\n\n  if (line.includes(\" satisfies \")) return true;\n\n  return false;\n}\n\n/**\n * Returns true when every ` as ` occurrence in the line falls inside a\n * string literal (single-quoted, double-quoted, or backtick).\n */\nfunction everyAsInsideString(line: string): boolean {\n  let searchFrom = 0;\n  while (true) {\n    const idx = line.indexOf(\" as \", searchFrom);\n    if (idx < 0) return true; // no more ` as ` to check\n    const before = line.substring(0, idx);\n    const singleQuotes = (before.match(/'/g) ?? []).length;\n    const doubleQuotes = (before.match(/\"/g) ?? []).length;\n    const backticks = (before.match(/`/g) ?? []).length;\n    if (singleQuotes % 2 === 0 && doubleQuotes % 2 === 0 && backticks % 2 === 0) {\n      return false; // this ` as ` is outside any string\n    }\n    searchFrom = idx + 4;\n  }\n}\n\n/**\n * Detects JSX text content — ` as ` appearing between > and < with no\n * code-like syntax around it (no braces, semicolons, equals signs).\n */\nfunction isJsxText(trimmed: string): boolean {\n  // Classic JSX text: starts after > or is plain text ending before <\n  if (trimmed.match(/^[^{};=()]*\\bas\\b[^{};=()]*$/)) {\n    // No code syntax at all — could be JSX text or template literal body.\n    // Reject if it looks like a type assertion (word ` as ` TypeName pattern\n    // where TypeName starts with uppercase, or is a known TS type).\n    if (\n      !trimmed.match(/\\bas\\s+[A-Z]\\w*/) &&\n      !trimmed.match(/\\bas\\s+(string|number|boolean|any|unknown|never)\\b/)\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Heuristic for plain text in template literals or JSX: the line has no\n * code-like characters before ` as ` — no `=`, `{`, `}`, `:`, `;`, `(`.\n */\nfunction isPlainText(trimmed: string): boolean {\n  const idx = trimmed.indexOf(\" as \");\n  if (idx < 0) return false;\n  const before = trimmed.substring(0, idx);\n  // If nothing before ` as ` looks like code, it's probably prose.\n  return (\n    !before.match(/[={}:;(]/) &&\n    !before.match(/\\b(const|let|var|type|interface|function|return|await)\\b/)\n  );\n}\n\n/**\n * Suggest a concrete fix for a specific violation pattern.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Pattern-matching advice is a linear chain of if-returns.\nexport function suggestFix(line: string): string | undefined {\n  if (line.includes(\"JSON.parse\")) {\n    return \"Use a validation function or type guard to parse and validate the result.\";\n  }\n  if (\n    line.includes(\"as HTMLInputElement\") ||\n    line.includes(\"as HTMLTextAreaElement\") ||\n    line.includes(\"as HTMLButtonElement\")\n  ) {\n    return \"Use instanceof: if (el instanceof HTMLInputElement) { el.value ... }\";\n  }\n  if (line.includes(\"as HTMLElement\") || line.includes(\"as Element\")) {\n    return \"Use instanceof: if (el instanceof HTMLElement) { ... }\";\n  }\n  if (line.includes(\".doc()\") && line.includes(\"as \")) {\n    return \"Type the DocHandle generic: repo.find<MyType>(id) returns DocHandle<MyType>.\";\n  }\n  if (\n    line.includes(\"Record<string, unknown>\") &&\n    (line.includes(\"window\") || line.includes(\"globalThis\"))\n  ) {\n    return \"Extract a type guard: function getGlobalProp(name: string): unknown { ... }\";\n  }\n  if (line.includes(\"Record<string, unknown>\")) {\n    return \"Use a type guard function that narrows the unknown value to the target shape.\";\n  }\n  if (line.includes(\"as PeerId\") || line.includes(\"as DocumentId\")) {\n    return \"Use the library's branded-type constructor if available, or centralise the cast in a factory.\";\n  }\n  if (line.includes(\"as string\") || line.includes(\"as number\") || line.includes(\"as boolean\")) {\n    return \"Narrow with typeof: if (typeof x === 'string') { ... }\";\n  }\n  if (line.includes(\"as any\")) {\n    return \"Replace 'any' with 'unknown' and add a type guard or validation at the boundary.\";\n  }\n  return undefined;\n}\n\nfunction isFileExcluded(\n  relative: string,\n  excludeDirs: Set<string>,\n  excludePackages: Set<string>,\n  excludeFiles: Set<string>\n): boolean {\n  const segments = relative.split(\"/\");\n  if (segments.some((s) => excludeDirs.has(s))) return true;\n  if (excludePackages.size > 0 && segments.some((s) => excludePackages.has(s))) return true;\n  const basename = segments[segments.length - 1] ?? \"\";\n  return excludeFiles.has(basename) || excludeFiles.has(relative);\n}\n\nfunction findViolations(relative: string, content: string): Violation[] {\n  const results: Violation[] = [];\n  const lines = content.split(\"\\n\");\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i] ?? \"\";\n    if (!isLineClean(line)) {\n      results.push({\n        file: relative,\n        line: i + 1,\n        content: line.trim(),\n        advice: suggestFix(line.trim()),\n      });\n    }\n  }\n  return results;\n}\n\nfunction printViolations(violations: Violation[]): void {\n  if (violations.length === 0) {\n    console.log(\"[no-as-casting] ✅ No violations found.\");\n    return;\n  }\n  console.log(`[no-as-casting] ❌ ${violations.length} violation(s) found:\\n`);\n  for (const v of violations) {\n    console.log(`  ${v.file}:${v.line}`);\n    console.log(`    ${v.content}`);\n    if (v.advice) console.log(`    💡 ${v.advice}`);\n    console.log();\n  }\n  console.log(\"[no-as-casting] Use type guards, validation, or fix the types at the source.\");\n  console.log('[no-as-casting] Only \"as const\" and \"as unknown as\" are allowed.');\n}\n\n/**\n * Run the no-as-casting check against a directory. Returns a result\n * object with the violations and a print function for CLI output.\n */\nexport async function checkNoAsCasting(options: CheckOptions): Promise<CheckResult> {\n  const rootDir = options.rootDir;\n  const excludeDirs = new Set(options.exclude ?? [\"node_modules\", \"dist\", \".git\", \".bun\"]);\n  const excludePackages = new Set(options.excludePackages ?? []);\n  const excludeFiles = new Set(options.excludeFiles ?? []);\n  const pattern = options.filePatterns ?? \"**/*.{ts,tsx}\";\n  const glob = new Glob(pattern);\n  const violations: Violation[] = [];\n\n  for await (const file of glob.scan({ cwd: rootDir, absolute: true })) {\n    const relative = file.replace(`${rootDir}/`, \"\");\n    if (isFileExcluded(relative, excludeDirs, excludePackages, excludeFiles)) continue;\n    const content = readFileSync(file, \"utf-8\");\n    violations.push(...findViolations(relative, content));\n  }\n\n  return { violations, print: () => printViolations(violations) };\n}\n",
+    "/**\n * No-as-casting conformance check.\n *\n * Bans all TypeScript type assertions (`as Type`) except the allowed\n * patterns: `as const` (literal narrowing), `as unknown as` (explicit\n * escape hatch), import/export renames, and `as` inside strings or\n * comments. Violations include pattern-specific fix advice.\n *\n * This module exports the check logic as a library so consuming\n * applications can import it from `@fairfox/polly/quality` and run it\n * programmatically. Polly's own `scripts/check-no-as-casting.ts` is a\n * thin CLI wrapper around these exports.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { Glob } from \"bun\";\n\nexport interface Violation {\n  file: string;\n  line: number;\n  content: string;\n  advice?: string;\n}\n\nexport interface CheckResult {\n  violations: Violation[];\n  print: () => void;\n}\n\nexport interface CheckOptions {\n  rootDir: string;\n  exclude?: string[];\n  excludePackages?: string[];\n  excludeFiles?: string[];\n  filePatterns?: string;\n}\n\n/**\n * Check whether a line contains a forbidden `as` type assertion.\n * Returns true if the line is clean (no violation), false if it violates.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Source-text scanning with many skip rules is inherently branchy.\nexport function isLineClean(line: string): boolean {\n  if (!line.includes(\" as \")) return true;\n\n  const trimmed = line.trim();\n\n  // Full-line comments\n  if (trimmed.startsWith(\"//\") || trimmed.startsWith(\"*\") || trimmed.startsWith(\"/*\")) {\n    return true;\n  }\n\n  // as const (literal narrowing)\n  if (line.match(/\\bas const\\b/)) {\n    const withoutAsConst = line.replace(/\\bas const\\b/g, \"\");\n    if (!withoutAsConst.includes(\" as \")) return true;\n  }\n\n  // as unknown as (explicit escape hatch)\n  if (line.includes(\" as unknown as \") || line.trimEnd().endsWith(\"as unknown as\")) {\n    const withoutEscapeHatch = line.replace(/\\bas unknown as\\b/g, \"\");\n    if (!withoutEscapeHatch.includes(\" as \")) return true;\n  }\n\n  // Import/export renames\n  if (\n    line.match(/\\b(import|export)\\s+.*\\s+as\\s+\\w+/) ||\n    line.match(/\\b(import|export)\\s+\\*\\s+as\\s+\\w+/) ||\n    line.match(/\\b(import|export)\\s+type\\s+.*\\s+as\\s+\\w+/) ||\n    line.match(/^\\s*\\w+\\s+as\\s+\\w+,?\\s*$/) ||\n    line.match(/^\\s*type\\s+\\w+\\s+as\\s+\\w+,?\\s*$/)\n  ) {\n    return true;\n  }\n\n  // Property declarations: as= or as: or as,\n  if (line.match(/\\bas\\s*[=:,]/)) return true;\n\n  // String literal detection: count quotes before each ` as ` occurrence.\n  // If any quote type has an odd count, the ` as ` is inside a string.\n  if (everyAsInsideString(line)) return true;\n\n  // JSX text: ` as ` between > and < with no code syntax around it\n  if (isJsxText(trimmed)) return true;\n\n  // Plain text heuristic: indented line with no code syntax characters\n  // before ` as ` — catches multiline JSX text and template literal bodies.\n  if (isPlainText(trimmed)) return true;\n\n  // Inline comment: ` as ` appears only after //\n  const commentIdx = line.indexOf(\"//\");\n  if (commentIdx >= 0 && line.indexOf(\" as \", commentIdx) >= 0) {\n    const beforeComment = line.substring(0, commentIdx);\n    if (!beforeComment.includes(\" as \")) return true;\n  }\n\n  // SQL alias: `) as column_name`\n  if (line.match(/\"\\)\\s+as\\s+\\w+\"/)) return true;\n\n  if (line.includes(\" satisfies \")) return true;\n\n  return false;\n}\n\n/**\n * Returns true when every ` as ` occurrence in the line falls inside a\n * string literal (single-quoted, double-quoted, or backtick).\n */\nfunction everyAsInsideString(line: string): boolean {\n  let searchFrom = 0;\n  while (true) {\n    const idx = line.indexOf(\" as \", searchFrom);\n    if (idx < 0) return true; // no more ` as ` to check\n    const before = line.substring(0, idx);\n    const singleQuotes = (before.match(/'/g) ?? []).length;\n    const doubleQuotes = (before.match(/\"/g) ?? []).length;\n    const backticks = (before.match(/`/g) ?? []).length;\n    if (singleQuotes % 2 === 0 && doubleQuotes % 2 === 0 && backticks % 2 === 0) {\n      return false; // this ` as ` is outside any string\n    }\n    searchFrom = idx + 4;\n  }\n}\n\n/**\n * Detects JSX text content — ` as ` appearing between > and < with no\n * code-like syntax around it (no braces, semicolons, equals signs).\n */\nfunction isJsxText(trimmed: string): boolean {\n  // Classic JSX text: starts after > or is plain text ending before <\n  if (trimmed.match(/^[^{};=()]*\\bas\\b[^{};=()]*$/)) {\n    // No code syntax at all — could be JSX text or template literal body.\n    // Reject if it looks like a type assertion (word ` as ` TypeName pattern\n    // where TypeName starts with uppercase, or is a known TS type).\n    if (\n      !trimmed.match(/\\bas\\s+[A-Z]\\w*/) &&\n      !trimmed.match(/\\bas\\s+(string|number|boolean|any|unknown|never)\\b/)\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Heuristic for plain text in template literals or JSX: the line has no\n * code-like characters before ` as ` — no `=`, `{`, `}`, `:`, `;`, `(`.\n */\nfunction isPlainText(trimmed: string): boolean {\n  const idx = trimmed.indexOf(\" as \");\n  if (idx < 0) return false;\n  const before = trimmed.substring(0, idx);\n  // If nothing before ` as ` looks like code, it's probably prose.\n  return (\n    !before.match(/[={}:;(]/) &&\n    !before.match(/\\b(const|let|var|type|interface|function|return|await)\\b/)\n  );\n}\n\n/**\n * Suggest a concrete fix for a specific violation pattern.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Pattern-matching advice is a linear chain of if-returns.\nexport function suggestFix(line: string): string | undefined {\n  if (line.includes(\"JSON.parse\")) {\n    return \"Use a validation function or type guard to parse and validate the result.\";\n  }\n  if (\n    line.includes(\"as HTMLInputElement\") ||\n    line.includes(\"as HTMLTextAreaElement\") ||\n    line.includes(\"as HTMLButtonElement\")\n  ) {\n    return \"Use instanceof: if (el instanceof HTMLInputElement) { el.value ... }\";\n  }\n  if (line.includes(\"as HTMLElement\") || line.includes(\"as Element\")) {\n    return \"Use instanceof: if (el instanceof HTMLElement) { ... }\";\n  }\n  if (line.includes(\".doc()\") && line.includes(\"as \")) {\n    return \"Type the DocHandle generic: repo.find<MyType>(id) returns DocHandle<MyType>.\";\n  }\n  if (\n    line.includes(\"Record<string, unknown>\") &&\n    (line.includes(\"window\") || line.includes(\"globalThis\"))\n  ) {\n    return \"Extract a type guard: function getGlobalProp(name: string): unknown { ... }\";\n  }\n  if (line.includes(\"Record<string, unknown>\")) {\n    return \"Use a type guard function that narrows the unknown value to the target shape.\";\n  }\n  if (line.includes(\"as PeerId\") || line.includes(\"as DocumentId\")) {\n    return \"Use the library's branded-type constructor if available, or centralise the cast in a factory.\";\n  }\n  if (line.includes(\"as string\") || line.includes(\"as number\") || line.includes(\"as boolean\")) {\n    return \"Narrow with typeof: if (typeof x === 'string') { ... }\";\n  }\n  if (line.includes(\"as any\")) {\n    return \"Replace 'any' with 'unknown' and add a type guard or validation at the boundary.\";\n  }\n  return undefined;\n}\n\nfunction isFileExcluded(\n  relative: string,\n  excludeDirs: Set<string>,\n  excludePackages: Set<string>,\n  excludeFiles: Set<string>\n): boolean {\n  const segments = relative.split(\"/\");\n  if (segments.some((s) => excludeDirs.has(s))) return true;\n  if (excludePackages.size > 0 && segments.some((s) => excludePackages.has(s))) return true;\n  const basename = segments[segments.length - 1] ?? \"\";\n  return excludeFiles.has(basename) || excludeFiles.has(relative);\n}\n\nfunction findViolations(relative: string, content: string): Violation[] {\n  const results: Violation[] = [];\n  const lines = content.split(\"\\n\");\n  let insideTemplate = false;\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i] ?? \"\";\n    const backticks = (line.match(/`/g) ?? []).length;\n    const startedInTemplate = insideTemplate;\n    if (backticks % 2 === 1) insideTemplate = !insideTemplate;\n\n    // Line is entirely inside a multi-line template literal and has no\n    // interpolation — treat as string content (e.g. SQL column aliases).\n    if (startedInTemplate && backticks === 0 && !line.includes(\"${\")) continue;\n\n    if (!isLineClean(line)) {\n      results.push({\n        file: relative,\n        line: i + 1,\n        content: line.trim(),\n        advice: suggestFix(line.trim()),\n      });\n    }\n  }\n  return results;\n}\n\nfunction printViolations(violations: Violation[]): void {\n  if (violations.length === 0) {\n    console.log(\"[no-as-casting] ✅ No violations found.\");\n    return;\n  }\n  console.log(`[no-as-casting] ❌ ${violations.length} violation(s) found:\\n`);\n  for (const v of violations) {\n    console.log(`  ${v.file}:${v.line}`);\n    console.log(`    ${v.content}`);\n    if (v.advice) console.log(`    💡 ${v.advice}`);\n    console.log();\n  }\n  console.log(\"[no-as-casting] Use type guards, validation, or fix the types at the source.\");\n  console.log('[no-as-casting] Only \"as const\" and \"as unknown as\" are allowed.');\n}\n\n/**\n * Run the no-as-casting check against a directory. Returns a result\n * object with the violations and a print function for CLI output.\n */\nexport async function checkNoAsCasting(options: CheckOptions): Promise<CheckResult> {\n  const rootDir = options.rootDir;\n  const excludeDirs = new Set(options.exclude ?? [\"node_modules\", \"dist\", \".git\", \".bun\"]);\n  const excludePackages = new Set(options.excludePackages ?? []);\n  const excludeFiles = new Set(options.excludeFiles ?? []);\n  const pattern = options.filePatterns ?? \"**/*.{ts,tsx}\";\n  const glob = new Glob(pattern);\n  const violations: Violation[] = [];\n\n  for await (const file of glob.scan({ cwd: rootDir, absolute: true })) {\n    const relative = file.replace(`${rootDir}/`, \"\");\n    if (isFileExcluded(relative, excludeDirs, excludePackages, excludeFiles)) continue;\n    const content = readFileSync(file, \"utf-8\");\n    violations.push(...findViolations(relative, content));\n  }\n\n  return { violations, print: () => printViolations(violations) };\n}\n",
     "#!/usr/bin/env bun\n\n/**\n * CLI entry point for Polly quality checks.\n *\n *   polly quality [--root <dir>] [--exclude <dirs>] [--pattern <glob>]\n *                 [--exclude-packages <names>] [--exclude-files <names>]\n *\n * Runs all conformance checks (currently: no-as-casting) against the\n * target directory and exits non-zero when violations are found.\n */\n\nimport { checkNoAsCasting } from \"./no-as-casting\";\n\nconst args = process.argv.slice(2);\n\nfunction getFlag(name: string): string | undefined {\n  const idx = args.indexOf(`--${name}`);\n  return idx >= 0 ? args[idx + 1] : undefined;\n}\n\nconst rootDir = getFlag(\"root\") ?? process.cwd();\nconst exclude = getFlag(\"exclude\")?.split(\",\") ?? [\"node_modules\", \"dist\", \".git\", \".bun\"];\nconst excludePackages = getFlag(\"exclude-packages\")?.split(\",\");\nconst excludeFiles = getFlag(\"exclude-files\")?.split(\",\");\nconst filePatterns = getFlag(\"pattern\");\n\nconst result = await checkNoAsCasting({\n  rootDir,\n  exclude,\n  ...(excludePackages ? { excludePackages } : {}),\n  ...(excludeFiles ? { excludeFiles } : {}),\n  ...(filePatterns ? { filePatterns } : {}),\n});\n\nresult.print();\nprocess.exit(result.violations.length > 0 ? 1 : 0);\n"
   ],
-  "mappings": "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",
-  "debugId": "E6501402C1BD2E6764756E2164756E21",
+  "mappings": "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",
+  "debugId": "D4F70D746137C24364756E2164756E21",
   "names": []
 }

package/dist/tools/quality/src/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fairfox/polly/quality — conformance checks for Polly applications.
+ *
+ * Exports the same quality rules that Polly enforces on itself, so
+ * consuming applications can adopt the same standards. The flagship
+ * check is `isLineClean` which detects forbidden `as` type assertions;
+ * applications wire it into their own CI or pre-commit hook via the
+ * companion `checkNoAsCasting` runner.
+ *
+ * @example
+ * ```typescript
+ * import { checkNoAsCasting } from "@fairfox/polly/quality";
+ *
+ * const result = await checkNoAsCasting({
+ *   rootDir: process.cwd(),
+ *   exclude: ["node_modules", "dist"],
+ * });
+ *
+ * if (result.violations.length > 0) {
+ *   result.print();
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export { type CheckResult, checkNoAsCasting, isLineClean, suggestFix, type Violation, } from "./no-as-casting";