cassetter 0.11.0

package/dist/cassette.js

@@ -0,0 +1,377 @@
+/**
+ * Record/replay orchestration over the native cassette core.
+ *
+ * The cassette format, request matching, security filtering, and body
+ * processing all live in Rust (`cassetter-core`). This file is the thin,
+ * idiomatic layer on top - the same role `src/cassetter/cassette.py` plays for
+ * the Python binding.
+ */
+import { existsSync, rmSync, statSync } from "node:fs";
+import { native, processBody, scrubInteraction, scrubGrpcInteraction, scrubWsInteraction } from "./binding.js";
+import { DISCARDING_MODES, RecordMode, parseDuration } from "./recording.js";
+import { NONE_BODY, bodyToBuffer } from "./types.js";
+// --- Errors ---
+/** Raised when a cassette file is required but absent. */
+export class CassetteNotFoundError extends Error {
+    /** Configure a cassette. Nothing is read until `load()`. */
+    constructor(message) {
+        super(message);
+        this.name = "CassetteNotFoundError";
+    }
+}
+/** Raised when a cassette exists but cannot be parsed. */
+export class CassetteLoadError extends Error {
+    /** Configure a cassette. Nothing is read until `load()`. */
+    constructor(message) {
+        super(message);
+        this.name = "CassetteLoadError";
+    }
+}
+/** Raised when a cassette is older than `maxAge` and `onExpiry` is `fail`. */
+export class CassetteExpiredError extends Error {
+    /** Configure a cassette. Nothing is read until `load()`. */
+    constructor(message) {
+        super(message);
+        this.name = "CassetteExpiredError";
+    }
+}
+/** Raised when no recorded interaction matches, and none may be recorded. */
+export class NoMatchError extends Error {
+    /** Configure a cassette. Nothing is read until `load()`. */
+    constructor(message) {
+        super(message);
+        this.name = "NoMatchError";
+    }
+}
+export class Cassette {
+    _path;
+    _recordMode;
+    _matchConfig;
+    _securityConfig;
+    _maxAge;
+    _onExpiry;
+    _ignoreLocalhost;
+    _inner = null;
+    _dirty = false;
+    /** Order interactions were recorded in, to break ties in the output order. */
+    _recordOrders = [];
+    /** Next position `reserveRecordOrder` will hand out. */
+    _nextRecordOrder = 0;
+    /** `once` replays without recording when the cassette already existed. */
+    _onceReplayOnly = false;
+    /** Mode of the cassette `rewrite` deleted, to put back on its replacement. */
+    _rewrittenFileMode = null;
+    /** Configure a cassette. Nothing is read until `load()`. */
+    constructor(path, options = {}) {
+        this._path = path;
+        this._recordMode = options.recordMode ?? RecordMode.ONCE;
+        this._matchConfig = options.matchConfig ?? {};
+        this._securityConfig = options.securityConfig ?? {};
+        this._maxAge = options.maxAge ? parseDuration(options.maxAge) : null;
+        this._onExpiry = options.onExpiry ?? "warn";
+        this._ignoreLocalhost = options.ignoreLocalhost ?? false;
+    }
+    /** Where this cassette is read from and written to. */
+    get path() {
+        return this._path;
+    }
+    /** The record mode in force. */
+    get recordMode() {
+        return this._recordMode;
+    }
+    /** Whether localhost traffic bypasses the cassette entirely. */
+    get ignoreLocalhost() {
+        return this._ignoreLocalhost;
+    }
+    /** The recorded HTTP interactions, empty before `load()`. */
+    get interactions() {
+        return this._inner ? this._inner.interactions : [];
+    }
+    /** The recorded gRPC interactions, empty before `load()`. */
+    get grpcInteractions() {
+        return this._inner ? this._inner.grpcInteractions : [];
+    }
+    /** The recorded WebSocket interactions, empty before `load()`. */
+    get wsInteractions() {
+        return this._inner ? this._inner.wsInteractions : [];
+    }
+    /** Whether this mode may replay an existing interaction. */
+    get canReplay() {
+        return !DISCARDING_MODES.includes(this._recordMode);
+    }
+    /** Whether an unmatched request may go to the network and be recorded. */
+    get canRecord() {
+        if (this._recordMode === RecordMode.ALL ||
+            this._recordMode === RecordMode.NEW_EPISODES ||
+            this._recordMode === RecordMode.REWRITE) {
+            return true;
+        }
+        // `once` records only when the cassette didn't exist: with an existing
+        // cassette an unmatched request must raise instead of silently hitting the
+        // network and appending.
+        return this._recordMode === RecordMode.ONCE && !this._onceReplayOnly;
+    }
+    /** Load from disk, or start an empty cassette based on the record mode. */
+    load() {
+        let exists = existsSync(this._path);
+        // `rewrite` drops the file before recording, so a run that captures
+        // nothing leaves no stale cassette behind. The writer copies the mode off
+        // the file it replaces, so with nothing there it has to be handed over -
+        // otherwise a 0600 cassette comes back at the process umask.
+        if (this._recordMode === RecordMode.REWRITE && exists) {
+            try {
+                this._rewrittenFileMode = statSync(this._path).mode & 0o7777;
+            }
+            catch {
+                this._rewrittenFileMode = null;
+            }
+            rmSync(this._path, { force: true });
+            exists = false;
+        }
+        const discarding = DISCARDING_MODES.includes(this._recordMode);
+        if (discarding || !exists) {
+            this._inner = new native.Cassette();
+            this._recordOrders = [];
+            this._nextRecordOrder = 0;
+            // Loading again onto the same object must not inherit the last load's
+            // replay-only state: with no file there, `once` may record afresh.
+            this._onceReplayOnly = false;
+            if (discarding) {
+                this._dirty = true;
+            }
+            return;
+        }
+        try {
+            this._inner = native.Cassette.load(this._path);
+        }
+        catch (e) {
+            throw new CassetteLoadError(`could not parse cassette ${this._path}: ${e.message}`);
+        }
+        this._onceReplayOnly = true;
+        this._recordOrders = this._inner.interactions.map((_, i) => i);
+        this._nextRecordOrder = this._recordOrders.length;
+        this._checkExpiry();
+    }
+    /**
+     * Write to disk if modified.
+     *
+     * An empty cassette is written only when a file already exists, so a
+     * re-record that captured nothing truncates the stale file instead of
+     * leaving it behind. Interactions go out in a canonical order rather than
+     * the order their responses arrived in, so a concurrent suite produces the
+     * same file every run.
+     */
+    save() {
+        if (!this._inner || !this._dirty)
+            return;
+        if (this._inner.length === 0 && !existsSync(this._path))
+            return;
+        this._inner.save(this._path, this._inner.outputOrder(this._matchConfig, this._recordOrders), this._rewrittenFileMode ?? undefined);
+        this._dirty = false;
+        this._rewrittenFileMode = null;
+    }
+    /** Serialize to YAML without touching the filesystem. */
+    toYaml() {
+        return this._inner ? this._inner.toYaml() : "";
+    }
+    /** Serialize to TOML without touching the filesystem. */
+    toToml() {
+        return this._inner ? this._inner.toToml() : "";
+    }
+    // --- HTTP ---
+    /**
+     * Claim this interaction's position before its request is issued.
+     *
+     * Interceptors record once the response is back, so under concurrency the
+     * cassette would otherwise be written in whatever order responses arrived
+     * in - different on every run.
+     */
+    reserveRecordOrder() {
+        return this._nextRecordOrder++;
+    }
+    play(method, uri, headers, body) {
+        if (!this._inner) {
+            throw new NoMatchError("cassette not loaded");
+        }
+        if (!this.canReplay) {
+            throw new NoMatchError(`replay disabled in ${this._recordMode} mode`);
+        }
+        const processed = processBody(body ?? Buffer.alloc(0), getHeader(headers, "content-type"), getHeader(headers, "content-encoding"));
+        // Interactions are scrubbed at write time, so the live request has to be
+        // scrubbed with the same config before matching: a URI recorded as
+        // api_key=[FILTERED] would otherwise never match the real query string,
+        // and a scrubbed body field would never match the real one.
+        const probe = scrubInteraction({
+            request: { method, uri, headers, body: processed },
+            response: { status: 0, headers: {}, body: NONE_BODY },
+            recordedAt: "",
+        }, this._securityConfig).request;
+        const hit = this._inner.takeMatch(probe, this._matchConfig);
+        if (hit === null) {
+            throw new NoMatchError(`no matching interaction for ${method} ${uri}`);
+        }
+        return hit.interaction.response;
+    }
+    record(method, uri, requestHeaders, requestBody, status, responseHeaders, responseBody, order) {
+        const reqBody = processBody(requestBody ?? Buffer.alloc(0), getHeader(requestHeaders, "content-type"), getHeader(requestHeaders, "content-encoding"));
+        const respBody = processBody(responseBody ?? Buffer.alloc(0), getHeader(responseHeaders, "content-type"), getHeader(responseHeaders, "content-encoding"));
+        // The body is stored decompressed, so content-encoding must not survive.
+        const cleanRespHeaders = {};
+        for (const [k, v] of Object.entries(responseHeaders)) {
+            if (k.toLowerCase() !== "content-encoding") {
+                cleanRespHeaders[k] = v;
+            }
+        }
+        const interaction = retagContentLength(scrubInteraction({
+            request: { method, uri, headers: requestHeaders, body: reqBody },
+            response: { status, headers: cleanRespHeaders, body: respBody },
+            recordedAt: new Date().toISOString(),
+        }, this._securityConfig));
+        this._ensureInner().addInteraction(interaction);
+        this._recordOrders.push(order ?? this.reserveRecordOrder());
+        this._dirty = true;
+        return interaction.response;
+    }
+    // --- gRPC ---
+    /** Replay a gRPC response for `method`, or throw `NoMatchError`. */
+    playGrpc(method) {
+        if (!this._inner) {
+            throw new NoMatchError("cassette not loaded");
+        }
+        const hit = this._inner.takeGrpcMatch(method);
+        if (hit === null) {
+            throw new NoMatchError(`no matching gRPC interaction for ${method}`);
+        }
+        return hit.interaction.response;
+    }
+    recordGrpc(method, metadata, requestBody, responseBody, options = {}) {
+        const interaction = scrubGrpcInteraction({
+            request: { method, metadata, body: requestBody },
+            response: {
+                statusCode: options.statusCode ?? 0,
+                statusMessage: options.statusMessage ?? "OK",
+                metadata: options.responseMetadata ?? {},
+                body: responseBody,
+            },
+            recordedAt: new Date().toISOString(),
+            jsonDebug: options.jsonDebug,
+        }, this._securityConfig);
+        this._ensureInner().addGrpcInteraction(interaction);
+        this._dirty = true;
+        return interaction.response;
+    }
+    // --- WebSocket ---
+    /** Replay a WebSocket interaction for `uri`, or throw `NoMatchError`. */
+    playWs(uri) {
+        if (!this._inner) {
+            throw new NoMatchError("cassette not loaded");
+        }
+        const probe = scrubWsInteraction({ uri, headers: {}, frames: [], recordedAt: "" }, this._securityConfig);
+        const hit = this._inner.takeWsMatch(probe.uri);
+        if (hit === null) {
+            throw new NoMatchError(`no matching WebSocket interaction for ${uri}`);
+        }
+        return hit.interaction;
+    }
+    /** Record a WebSocket connection and its frames, scrubbed. */
+    recordWs(uri, headers, frames) {
+        const interaction = scrubWsInteraction({ uri, headers, frames, recordedAt: new Date().toISOString() }, this._securityConfig);
+        this._ensureInner().addWsInteraction(interaction);
+        this._dirty = true;
+    }
+    // --- Internals ---
+    /** The native cassette, created on first use if `load()` never ran. */
+    _ensureInner() {
+        this._inner ??= new native.Cassette();
+        return this._inner;
+    }
+    /** Apply `onExpiry` when the newest recording predates `maxAge`. */
+    _checkExpiry() {
+        if (this._maxAge === null || !this._inner)
+            return;
+        const newest = this._newestRecordedAt();
+        if (newest === null)
+            return;
+        if (newest.getTime() >= Date.now() - this._maxAge)
+            return;
+        const ageDays = Math.floor((Date.now() - newest.getTime()) / (24 * 60 * 60 * 1000));
+        const msg = `cassette '${this._path}' is ${ageDays} days old (maxAge=${this._maxAge}ms)`;
+        if (this._onExpiry === "fail") {
+            throw new CassetteExpiredError(msg);
+        }
+        if (this._onExpiry === "rerecord") {
+            this._inner = new native.Cassette();
+            this._recordOrders = [];
+            this._onceReplayOnly = false;
+            this._dirty = true;
+            return;
+        }
+        process.emitWarning(msg, "CassetteExpiredWarning");
+    }
+    /** The most recent `recordedAt` across every protocol, if any. */
+    _newestRecordedAt() {
+        if (!this._inner)
+            return null;
+        const stamps = [
+            ...this._inner.interactions.map((i) => i.recordedAt),
+            ...this._inner.grpcInteractions.map((i) => i.recordedAt),
+            ...this._inner.wsInteractions.map((i) => i.recordedAt),
+        ].filter(Boolean);
+        if (stamps.length === 0)
+            return null;
+        return stamps.reduce((newest, ts) => {
+            const d = new Date(ts);
+            if (Number.isNaN(d.getTime()))
+                return newest;
+            return newest === null || d > newest ? d : newest;
+        }, null);
+    }
+}
+/**
+ * Restate a response's `content-length` for the body as recorded.
+ *
+ * Decompressing a response and scrubbing a secret out of a body both change
+ * its length, and a client that checks the header against what it reads fails
+ * on replay when the two disagree.
+ *
+ * Only the response, and only when it carries a body. A request's header is
+ * compared against the incoming one by the `headers` matcher, so rewriting it
+ * would stop an identical request from replaying; and on a HEAD or 304 the
+ * header describes a representation that was never sent, so there is no body
+ * to measure it against.
+ */
+function retagContentLength(interaction) {
+    const served = bodyToBuffer(interaction.response.body);
+    if (served.length === 0)
+        return interaction;
+    const length = String(served.length);
+    let changed = false;
+    const headers = {};
+    for (const [key, values] of Object.entries(interaction.response.headers)) {
+        if (key.toLowerCase() === "content-length") {
+            if (values.length !== 1 || values[0] !== length)
+                changed = true;
+            headers[key] = [length];
+        }
+        else {
+            headers[key] = values;
+        }
+    }
+    if (!changed)
+        return interaction;
+    return {
+        ...interaction,
+        response: { ...interaction.response, headers },
+    };
+}
+/** Case-insensitive header lookup returning the first value. */
+export function getHeader(headers, name) {
+    const target = name.toLowerCase();
+    for (const [key, values] of Object.entries(headers)) {
+        if (key.toLowerCase() === target && values.length > 0) {
+            return values[0];
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=cassette.js.map

package/dist/cassette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cassette.js","sourceRoot":"","sources":["../src/cassette.ts"],"names":[],"mappings":"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"}

package/dist/context.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `useCassette` - the main entry point for recording/replaying HTTP traffic.
+ *
+ * @example
+ * ```ts
+ * await useCassette("tests/cassettes/users.yaml", async () => {
+ *   const res = await fetch("https://api.example.com/users");
+ * });
+ * ```
+ */
+import { Cassette } from "./cassette.js";
+import type { CassetteConfig } from "./types.js";
+export type UseCassetteOptions = CassetteConfig;
+/**
+ * Record or replay every `fetch` made inside `fn`.
+ *
+ * Interceptors are installed before the callback and removed after it, even
+ * if it throws; the cassette is written on the way out.
+ */
+export declare function useCassette(path: string, fn: (cassette: Cassette) => Promise<void> | void): Promise<Cassette>;
+export declare function useCassette(path: string, options: UseCassetteOptions, fn: (cassette: Cassette) => Promise<void> | void): Promise<Cassette>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAMhD;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAC/C,OAAO,CAAC,QAAQ,CAAC,CAAC;AACrB,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,EAC3B,EAAE,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAC/C,OAAO,CAAC,QAAQ,CAAC,CAAC"}

package/dist/context.js

@@ -0,0 +1,70 @@
+/**
+ * `useCassette` - the main entry point for recording/replaying HTTP traffic.
+ *
+ * @example
+ * ```ts
+ * await useCassette("tests/cassettes/users.yaml", async () => {
+ *   const res = await fetch("https://api.example.com/users");
+ * });
+ * ```
+ */
+import { Cassette } from "./cassette.js";
+import { FetchInterceptor } from "./intercept/fetch.js";
+import { RecordMode, parseRecordMode } from "./recording.js";
+const INTERCEPTORS = {
+    fetch: () => new FetchInterceptor(),
+};
+export async function useCassette(path, optionsOrFn, maybeFn) {
+    const options = typeof optionsOrFn === "function" ? {} : optionsOrFn;
+    const fn = typeof optionsOrFn === "function" ? optionsOrFn : maybeFn;
+    if (!fn) {
+        throw new TypeError("useCassette requires a callback");
+    }
+    const cassette = new Cassette(path, {
+        recordMode: options.recordMode
+            ? parseRecordMode(options.recordMode)
+            : RecordMode.ONCE,
+        matchConfig: {
+            matchOn: options.matchOn,
+            ignoreJsonPaths: options.ignoreJsonPaths,
+        },
+        securityConfig: {
+            filterHeaders: options.filterHeaders,
+            filterQueryParameters: options.filterQueryParameters,
+            bodyScrubPatterns: options.bodyScrubPatterns,
+            replacement: options.replacement,
+        },
+        maxAge: options.maxAge,
+        onExpiry: options.onExpiry,
+        ignoreLocalhost: options.ignoreLocalhost,
+    });
+    cassette.load();
+    const interceptors = resolveInterceptors(options.intercept);
+    for (const interceptor of interceptors) {
+        interceptor.install(cassette);
+    }
+    try {
+        await fn(cassette);
+    }
+    finally {
+        for (const interceptor of [...interceptors].reverse()) {
+            interceptor.uninstall();
+        }
+        cassette.save();
+    }
+    return cassette;
+}
+/** Instantiate the named interceptors, or the default set. */
+function resolveInterceptors(names) {
+    if (!names || names.length === 0) {
+        return [new FetchInterceptor()];
+    }
+    return names.map((name) => {
+        const factory = INTERCEPTORS[name];
+        if (!factory) {
+            throw new Error(`unknown interceptor: '${name}' (available: ${Object.keys(INTERCEPTORS).join(", ")})`);
+        }
+        return factory();
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAK7D,MAAM,YAAY,GAAsC;IACtD,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,gBAAgB,EAAE;CACpC,CAAC;AAiBF,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,WAEkD,EAClD,OAAsD;IAEtD,MAAM,OAAO,GACX,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IACvD,MAAM,EAAE,GAAG,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;IAErE,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE;QAClC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC5B,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC;YACrC,CAAC,CAAC,UAAU,CAAC,IAAI;QACnB,WAAW,EAAE;YACX,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,eAAe,EAAE,OAAO,CAAC,eAAe;SACzC;QACD,cAAc,EAAE;YACd,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;YACpD,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;YAC5C,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC;QACD,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,eAAe,EAAE,OAAO,CAAC,eAAe;KACzC,CAAC,CAAC;IAEH,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEhB,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5D,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC;YAAS,CAAC;QACT,KAAK,MAAM,WAAW,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YACtD,WAAW,CAAC,SAAS,EAAE,CAAC;QAC1B,CAAC;QACD,QAAQ,CAAC,IAAI,EAAE,CAAC;IAClB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8DAA8D;AAC9D,SAAS,mBAAmB,CAAC,KAAgB;IAC3C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,iBAAiB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACtF,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * cassetter - HTTP cassette recorder for Node.js tests. Safe by default.
+ *
+ * Cassette format, request matching, security filtering, and body processing
+ * are implemented in Rust (`cassetter-core`) and shared with the Python
+ * binding, so cassettes are interchangeable between the two.
+ *
+ * @example
+ * ```ts
+ * import { useCassette } from "cassetter";
+ *
+ * await useCassette("tests/cassettes/users.yaml", async () => {
+ *   const res = await fetch("https://api.example.com/users");
+ *   console.log(res.status);
+ * });
+ * ```
+ */
+export { useCassette } from "./context.js";
+export type { UseCassetteOptions } from "./context.js";
+export { Cassette, CassetteExpiredError, CassetteLoadError, CassetteNotFoundError, NoMatchError, getHeader, } from "./cassette.js";
+export type { CassetteOptions } from "./cassette.js";
+export { DISCARDING_MODES, RecordMode, parseDuration, parseRecordMode, } from "./recording.js";
+export { NONE_BODY, binaryBody, binaryBodyBytes, bodyToBuffer, } from "./types.js";
+export type { Body, BodyType, CassetteConfig, GrpcInteraction, GrpcRequest, GrpcResponse, HeaderMap, HttpInteraction, HttpRequest, HttpResponse, MatchConfig, Matcher, SecurityConfig, WsFrame, WsInteraction, } from "./types.js";
+export { FetchInterceptor } from "./intercept/fetch.js";
+export { isLocalhost } from "./intercept/base.js";
+export type { Interceptor } from "./intercept/base.js";
+export { processBody, scrubGrpcInteraction, scrubInteraction, scrubWsInteraction, defaultBodyScrubPatterns, defaultFilterHeaders, defaultFilterQueryParameters, defaultMatchOn, defaultReplacement, formatVersion, knownMatchers, } from "./binding.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,SAAS,GACV,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,SAAS,EACT,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,EACZ,SAAS,EACT,eAAe,EACf,WAAW,EACX,YAAY,EACZ,WAAW,EACX,OAAO,EACP,cAAc,EACd,OAAO,EACP,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * cassetter - HTTP cassette recorder for Node.js tests. Safe by default.
+ *
+ * Cassette format, request matching, security filtering, and body processing
+ * are implemented in Rust (`cassetter-core`) and shared with the Python
+ * binding, so cassettes are interchangeable between the two.
+ *
+ * @example
+ * ```ts
+ * import { useCassette } from "cassetter";
+ *
+ * await useCassette("tests/cassettes/users.yaml", async () => {
+ *   const res = await fetch("https://api.example.com/users");
+ *   console.log(res.status);
+ * });
+ * ```
+ */
+export { useCassette } from "./context.js";
+export { Cassette, CassetteExpiredError, CassetteLoadError, CassetteNotFoundError, NoMatchError, getHeader, } from "./cassette.js";
+export { DISCARDING_MODES, RecordMode, parseDuration, parseRecordMode, } from "./recording.js";
+export { NONE_BODY, binaryBody, binaryBodyBytes, bodyToBuffer, } from "./types.js";
+export { FetchInterceptor } from "./intercept/fetch.js";
+export { isLocalhost } from "./intercept/base.js";
+// Primitives from the shared Rust core.
+export { processBody, scrubGrpcInteraction, scrubInteraction, scrubWsInteraction, defaultBodyScrubPatterns, defaultFilterHeaders, defaultFilterQueryParameters, defaultMatchOn, defaultReplacement, formatVersion, knownMatchers, } from "./binding.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,SAAS,GACV,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,SAAS,EACT,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC;AAmBpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,wCAAwC;AACxC,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/intercept/base.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Base interceptor protocol and shared utilities.
+ */
+import type { Cassette } from "../cassette.js";
+export interface Interceptor {
+    install(cassette: Cassette): void;
+    uninstall(): void;
+}
+/** Whether a URI points at the local machine. */
+export declare function isLocalhost(uri: string): boolean;
+//# sourceMappingURL=base.d.ts.map

package/dist/intercept/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/intercept/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAClC,SAAS,IAAI,IAAI,CAAC;CACnB;AASD,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOhD"}

package/dist/intercept/base.js

@@ -0,0 +1,20 @@
+/**
+ * Base interceptor protocol and shared utilities.
+ */
+const LOCALHOST_HOSTS = new Set([
+    "localhost",
+    "127.0.0.1",
+    "[::1]",
+    "::1",
+]);
+/** Whether a URI points at the local machine. */
+export function isLocalhost(uri) {
+    try {
+        const url = new URL(uri);
+        return LOCALHOST_HOSTS.has(url.hostname);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/intercept/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/intercept/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,WAAW;IACX,WAAW;IACX,OAAO;IACP,KAAK;CACN,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,OAAO,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/intercept/fetch.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Intercepts the global `fetch` to record and replay HTTP traffic.
+ */
+import { type Cassette } from "../cassette.js";
+import { type Interceptor } from "./base.js";
+export declare class FetchInterceptor implements Interceptor {
+    private _patched;
+    /** Replace the global `fetch` with one backed by `cassette`. */
+    install(cassette: Cassette): void;
+    /** Put the previous active `fetch` back if this interceptor owns the global. */
+    uninstall(): void;
+}
+//# sourceMappingURL=fetch.d.ts.map

package/dist/intercept/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/intercept/fetch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAmB1D,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,QAAQ,CAAwC;IAExD,gEAAgE;IAChE,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IA8DjC,gFAAgF;IAChF,SAAS,IAAI,IAAI;CAYlB"}