@zyraxon-ai/http-recorder 19.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 zyraxon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,217 @@
+# @ZYRAXON-ai/http-recorder
+
+Record real Effect HTTP and WebSocket traffic once, then replay it from deterministic JSON cassettes.
+
+Use it for provider integrations, retries, polling, multi-step flows, and any test where hand-written HTTP mocks hide too much of the real request shape.
+
+> Public beta. The API depends on Effect 4 beta and may change with Effect's unstable transport modules.
+
+## Install
+
+```sh
+bun add effect@4.0.0-beta.74
+bun add -d @ZYRAXON-ai/http-recorder@beta @effect/vitest vitest
+```
+
+The package supports Node.js 22+ and Bun. It is not intended for browsers, workers, or Deno.
+
+Effect `4.0.0-beta.74` has a known declaration error (`SchemaErrorTypeId` is missing). Until that upstream declaration is fixed, TypeScript consumers need:
+
+```json
+{
+  "compilerOptions": {
+    "skipLibCheck": true
+  }
+}
+```
+
+## Quick Start
+
+```ts
+import { assert, describe, it } from "@effect/vitest"
+import { Effect, Schema } from "effect"
+import { HttpClient, HttpClientRequest } from "effect/unstable/http"
+import { HttpRecorder } from "@ZYRAXON-ai/http-recorder"
+
+const User = Schema.Struct({
+  id: Schema.Number,
+  name: Schema.String,
+})
+
+const getUser = Effect.gen(function* () {
+  const http = yield* HttpClient.HttpClient
+  const response = yield* http.execute(HttpClientRequest.get("https://jsonplaceholder.typicode.com/users/1"))
+  return yield* Schema.decodeUnknownEffect(User)(yield* response.json)
+})
+
+describe("getUser", () => {
+  it.effect("loads a user", () =>
+    Effect.gen(function* () {
+      const user = yield* getUser
+
+      assert.strictEqual(user.id, 1)
+      assert.strictEqual(user.name, "Leanne Graham")
+    }).pipe(Effect.provide(HttpRecorder.http("users/get-one"))),
+  )
+})
+```
+
+Run the test with Vitest. The first local run calls the real API and records:
+
+```sh
+bunx vitest run users.test.ts
+```
+
+```text
+test/fixtures/recordings/users/get-one.json
+```
+
+Later runs replay that cassette without contacting the upstream server. When `CI=true`, missing cassettes fail instead of recording.
+
+```mermaid
+flowchart TD
+  Run[Run test] --> Recorded{Cassette recorded?}
+  Recorded -->|Yes| Replay[Replay cassette]
+  Recorded -->|No, local| Record[Call service and record cassette]
+  Recorded -->|No, CI| Fail[Fail: cassette missing]
+```
+
+Application code does not need to know whether a response is live or replayed.
+
+## API
+
+```ts
+HttpRecorder.http(name, options?)
+HttpRecorder.socket(name, options?)
+```
+
+That is the complete public API. `http` provides a fetch-backed recorded `HttpClient`. `socket` decorates a standard Effect `Socket.Socket` supplied beneath it.
+
+## WebSockets
+
+WebSocket cassettes preserve one ordered transcript of client and server text or binary frames. Replay follows that chronology: server frames are released until the next recorded client frame, then replay waits for the application to send the matching frame before continuing.
+
+```ts
+import { assert, it } from "@effect/vitest"
+import { NodeSocket } from "@effect/platform-node"
+import { Effect, Layer } from "effect"
+import { Socket } from "effect/unstable/socket"
+import { HttpRecorder } from "@ZYRAXON-ai/http-recorder"
+
+const echo = Effect.gen(function* () {
+  const socket = yield* Socket.Socket
+  const write = yield* socket.writer
+
+  yield* socket.runString(
+    (message) =>
+      Effect.gen(function* () {
+        assert.strictEqual(message, "hello")
+        yield* write(new Socket.CloseEvent(1000))
+      }),
+    { onOpen: write("hello") },
+  )
+})
+
+const recordedSocket = HttpRecorder.socket("echo/hello").pipe(
+  Layer.provide(
+    NodeSocket.layerWebSocket("wss://ws.postman-echo.com/raw", {
+      closeCodeIsError: (code) => code !== 1000,
+    }),
+  ),
+)
+
+it.effect("exchanges WebSocket frames", () => echo.pipe(Effect.provide(recordedSocket)))
+```
+
+The application owns the WebSocket URL and protocols through normal Effect layer wiring. The recorder wraps that socket without duplicating its URL in recorder configuration. Provide separate socket layers for separate endpoints or concurrent connections.
+
+Text frames use the same JSON-field and body redaction as HTTP bodies. Binary frames are stored losslessly as base64. Client and server frame kinds must match during replay.
+
+## Refresh A Cassette
+
+Delete exactly the recordings you want to replace, then rerun their tests:
+
+```sh
+rm test/fixtures/recordings/users/get-one.json
+bun run test users.test.ts
+```
+
+There is intentionally no public overwrite mode. Deletion makes the set of recordings being refreshed visible and reviewable.
+
+## Redaction
+
+Secure defaults remove most headers and redact common credentials in headers, URLs, and JSON bodies. Extend those defaults at layer construction:
+
+```ts
+HttpRecorder.http("anthropic/messages", {
+  redact: {
+    headers: ["x-project-token"],
+    allowRequestHeaders: ["anthropic-version"],
+    queryParameters: ["session-id"],
+    jsonFields: ["user_id"],
+    url: (url) => url.replace(/\/accounts\/[^/]+/, "/accounts/{account}"),
+    body: (body) => body.replaceAll(/usr_[a-z0-9]+/g, "usr_redacted"),
+  },
+})
+```
+
+| Option                 | Purpose                                                              |
+| ---------------------- | -------------------------------------------------------------------- |
+| `headers`              | Add sensitive header names. They are retained as `[REDACTED]`.       |
+| `allowRequestHeaders`  | Preserve additional non-sensitive request headers for matching.      |
+| `allowResponseHeaders` | Preserve additional non-sensitive response headers for replay.       |
+| `queryParameters`      | Add sensitive URL query parameter names.                             |
+| `jsonFields`           | Recursively redact matching JSON keys in requests and responses.     |
+| `url`                  | Stabilize a URL after built-in redaction.                            |
+| `body`                 | Stabilize request and response bodies after built-in JSON redaction. |
+
+Before writing, the recorder scans the complete cassette for common credential formats and values from credential-like environment variables. Unsafe cassettes fail without replacing an existing recording.
+
+Redaction is defense in depth, not a substitute for review. Inspect cassette diffs before committing them.
+
+## Matching And Ordering
+
+A cassette contains an ordered sequence of interactions. The first runtime request is checked against the first recorded request, the second against the second, and so on.
+
+This strict ordering correctly models repeated identical requests whose responses change, including retries, polling, and cache tests. JSON object keys are canonicalized before matching.
+
+Concurrent requests are recorded in request-start order even when their responses complete out of order.
+
+Supply a custom equivalence rule when a request contains intentionally volatile data:
+
+```ts
+HttpRecorder.http("events/create", {
+  match: (incoming, recorded) =>
+    incoming.method === recorded.method && new URL(incoming.url).pathname === new URL(recorded.url).pathname,
+})
+```
+
+## Configuration
+
+```ts
+interface RecorderOptions {
+  readonly directory?: string
+  readonly metadata?: Record<string, unknown>
+  readonly redact?: RedactOptions
+  readonly match?: RequestMatcher
+}
+```
+
+`directory` defaults to `<cwd>/test/fixtures/recordings`.
+
+## Cassettes
+
+Cassettes are readable JSON files intended to be committed with your tests. HTTP interactions are stored in request order. WebSocket cassettes preserve the observed order of client and server frames. Text stays readable; binary bodies and frames are stored losslessly as base64.
+
+## Current Limits
+
+- Responses are buffered while recording and replaying, so this beta is not suitable for tests that assert streaming timing, cancellation, or backpressure.
+- WebSocket replay preserves frame chronology and content, not real network timing or backpressure.
+- WebSocket V1 cassettes do not reproduce terminal close codes, close reasons, or transport failures. Failed and interrupted live runs are not recorded.
+- WebSocket transcripts are retained in memory until the connection finishes; avoid using this beta for unbounded sessions.
+- The package currently requires the exact Effect beta listed above.
+- Cassette format version `1` has no migration tooling yet.
+
+## License
+
+MIT

package/dist/cassette.d.ts

@@ -0,0 +1,36 @@
+import { Context, Effect, FileSystem, Layer, Schema } from "effect";
+import { type CassetteMetadata, type Interaction } from "./schema.js";
+declare const CassetteNotFoundError_base: Schema.Class<CassetteNotFoundError, Schema.TaggedStruct<"CassetteNotFoundError", {
+    readonly cassetteName: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class CassetteNotFoundError extends CassetteNotFoundError_base {
+    get message(): string;
+}
+declare const UnsafeCassetteError_base: Schema.Class<UnsafeCassetteError, Schema.TaggedStruct<"UnsafeCassetteError", {
+    readonly cassetteName: Schema.String;
+    readonly findings: Schema.$Array<Schema.Struct<{
+        readonly path: Schema.String;
+        readonly reason: Schema.String;
+    }>>;
+}>, import("effect/Cause").YieldableError>;
+export declare class UnsafeCassetteError extends UnsafeCassetteError_base {
+    get message(): string;
+}
+export interface Interface {
+    readonly read: (name: string) => Effect.Effect<ReadonlyArray<Interaction>, CassetteNotFoundError>;
+    readonly append: (name: string, interaction: Interaction, metadata?: CassetteMetadata) => Effect.Effect<void, UnsafeCassetteError>;
+    readonly exists: (name: string) => Effect.Effect<boolean>;
+    readonly list: () => Effect.Effect<ReadonlyArray<string>>;
+}
+declare const Service_base: Context.ServiceClass<Service, "@zyraxon-ai/http-recorder/Cassette", Interface>;
+export declare class Service extends Service_base {
+}
+export declare const hasCassetteSync: (name: string, options?: {
+    readonly directory?: string;
+}) => boolean;
+export declare const fileSystem: (options?: {
+    readonly directory?: string;
+}) => Layer.Layer<Service, never, FileSystem.FileSystem>;
+export declare const memory: (initial?: Record<string, ReadonlyArray<Interaction>>) => Layer.Layer<Service>;
+export {};
+//# sourceMappingURL=cassette.d.ts.map

package/dist/cassette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cassette.d.ts","sourceRoot":"","sources":["../src/cassette.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAa,MAAM,QAAQ,CAAA;AAI9E,OAAO,EAAiD,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;;;;AAIpH,qBAAa,qBAAsB,SAAQ,0BAEzC;IACA,IAAa,OAAO,WAEnB;CACF;;;;;;;;AAED,qBAAa,mBAAoB,SAAQ,wBAGvC;IACA,IAAa,OAAO,WAInB;CACF;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC,CAAA;IACjG,QAAQ,CAAC,MAAM,EAAE,CACf,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,EACxB,QAAQ,CAAC,EAAE,gBAAgB,KACxB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAA;IAC7C,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;CAC1D;;AAED,qBAAa,OAAQ,SAAQ,YAA2E;CAAG;AAa3G,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,UAAS;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,YACX,CAAA;AAmBhF,eAAO,MAAM,UAAU,GACrB,UAAS;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,KAC5C,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAuEjD,CAAA;AAEH,eAAO,MAAM,MAAM,GAAI,UAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAM,KAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAgCjG,CAAA"}

package/dist/cassette.js

@@ -0,0 +1,105 @@
+import { Context, Effect, FileSystem, Layer, Schema, Semaphore } from "effect";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { secretFindings, SecretFindingSchema } from "./redaction.js";
+import { CassetteSchema, encodeCassette } from "./schema.js";
+const DEFAULT_RECORDINGS_DIR = path.resolve(process.cwd(), "test", "fixtures", "recordings");
+export class CassetteNotFoundError extends Schema.TaggedErrorClass()("CassetteNotFoundError", {
+    cassetteName: Schema.String,
+}) {
+    get message() {
+        return `Cassette "${this.cassetteName}" not found`;
+    }
+}
+export class UnsafeCassetteError extends Schema.TaggedErrorClass()("UnsafeCassetteError", {
+    cassetteName: Schema.String,
+    findings: Schema.Array(SecretFindingSchema),
+}) {
+    get message() {
+        return `Refusing to write cassette "${this.cassetteName}" because it contains possible secrets: ${this.findings
+            .map((finding) => `${finding.path} (${finding.reason})`)
+            .join(", ")}`;
+    }
+}
+export class Service extends Context.Service()("@zyraxon-ai/http-recorder/Cassette") {
+}
+const cassettePath = (directory, name) => {
+    if (!name || path.isAbsolute(name) || path.win32.isAbsolute(name) || name.split(/[\\/]/).includes(".."))
+        throw new Error(`Invalid cassette name "${name}"`);
+    const root = path.resolve(directory);
+    const target = path.resolve(root, `${name}.json`);
+    const relative = path.relative(root, target);
+    if (!relative || relative.startsWith("..") || path.isAbsolute(relative))
+        throw new Error(`Invalid cassette name "${name}"`);
+    return target;
+};
+export const hasCassetteSync = (name, options = {}) => fs.existsSync(cassettePath(options.directory ?? DEFAULT_RECORDINGS_DIR, name));
+const buildCassette = (name, interactions, metadata) => ({
+    version: 1,
+    metadata: { name, recordedAt: new Date().toISOString(), ...metadata },
+    interactions,
+});
+const formatCassette = (cassette) => `${JSON.stringify(encodeCassette(cassette), null, 2)}\n`;
+const parseCassette = Schema.decodeUnknownSync(Schema.fromJsonString(CassetteSchema));
+const failIfUnsafe = (name, findings) => findings.length === 0 ? Effect.void : Effect.fail(new UnsafeCassetteError({ cassetteName: name, findings }));
+export const fileSystem = (options = {}) => Layer.effect(Service, Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const directory = options.directory ?? DEFAULT_RECORDINGS_DIR;
+    const recorded = new Map();
+    const appendLock = yield* Semaphore.make(1);
+    const pathFor = (name) => cassettePath(directory, name);
+    const walk = (current) => Effect.gen(function* () {
+        const entries = yield* fs.readDirectory(current).pipe(Effect.catch(() => Effect.succeed([])));
+        const nested = yield* Effect.forEach(entries, (entry) => {
+            const full = path.join(current, entry);
+            return fs.stat(full).pipe(Effect.flatMap((stat) => (stat.type === "Directory" ? walk(full) : Effect.succeed([full]))), Effect.catch(() => Effect.succeed([])));
+        });
+        return nested.flat();
+    });
+    return Service.of({
+        read: (name) => fs.readFileString(pathFor(name)).pipe(Effect.map((raw) => parseCassette(raw).interactions), Effect.catch(() => Effect.fail(new CassetteNotFoundError({ cassetteName: name })))),
+        append: (name, interaction, metadata) => appendLock.withPermit(Effect.gen(function* () {
+            const entry = recorded.get(name) ?? { interactions: [], findings: [] };
+            const interactions = [...entry.interactions, interaction];
+            const interactionFindings = [...entry.findings, ...secretFindings(interaction)];
+            const cassette = buildCassette(name, interactions, metadata);
+            const findings = [...interactionFindings, ...secretFindings(cassette.metadata ?? {})];
+            yield* failIfUnsafe(name, findings);
+            const target = pathFor(name);
+            yield* fs.makeDirectory(path.dirname(target), { recursive: true }).pipe(Effect.orDie);
+            const temporary = `${target}.${crypto.randomUUID()}.tmp`;
+            yield* fs.writeFileString(temporary, formatCassette(cassette)).pipe(Effect.flatMap(() => fs.rename(temporary, target)), Effect.ensuring(fs.remove(temporary, { force: true }).pipe(Effect.catch(() => Effect.void))), Effect.orDie);
+            recorded.set(name, { interactions, findings: interactionFindings });
+        })),
+        exists: (name) => fs.access(pathFor(name)).pipe(Effect.as(true), Effect.catch(() => Effect.succeed(false))),
+        list: () => walk(directory).pipe(Effect.map((files) => files
+            .filter((file) => file.endsWith(".json"))
+            .map((file) => path
+            .relative(directory, file)
+            .replace(/\\/g, "/")
+            .replace(/\.json$/, ""))
+            .toSorted((a, b) => a.localeCompare(b)))),
+    });
+}));
+export const memory = (initial = {}) => Layer.sync(Service, () => {
+    const stored = new Map(Object.entries(initial).map(([name, interactions]) => [name, [...interactions]]));
+    const accumulatedFindings = new Map();
+    const appendLock = Semaphore.makeUnsafe(1);
+    return Service.of({
+        read: (name) => stored.has(name)
+            ? Effect.succeed(stored.get(name) ?? [])
+            : Effect.fail(new CassetteNotFoundError({ cassetteName: name })),
+        append: (name, interaction, metadata) => appendLock.withPermit(Effect.suspend(() => {
+            const interactions = [...(stored.get(name) ?? []), interaction];
+            const findings = [...(accumulatedFindings.get(name) ?? []), ...secretFindings(interaction)];
+            const allFindings = metadata ? [...findings, ...secretFindings({ name, ...metadata })] : findings;
+            return failIfUnsafe(name, allFindings).pipe(Effect.tap(() => Effect.sync(() => {
+                stored.set(name, interactions);
+                accumulatedFindings.set(name, findings);
+            })));
+        })),
+        exists: (name) => Effect.sync(() => stored.has(name)),
+        list: () => Effect.sync(() => Array.from(stored.keys()).toSorted()),
+    });
+});
+//# 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/effect.d.ts

@@ -0,0 +1,11 @@
+import * as Layer from "effect/Layer";
+import type * as HttpClient from "effect/unstable/http/HttpClient";
+import type { RecorderOptions } from "./types.js";
+/**
+ * Provides a fetch-backed `HttpClient` with cassette recording and replay.
+ *
+ * Locally, a missing cassette is recorded from the real service. Existing
+ * cassettes are replayed, and `CI=true` makes a missing cassette fail.
+ */
+export declare const http: (name: string, options?: RecorderOptions) => Layer.Layer<HttpClient.HttpClient>;
+//# sourceMappingURL=effect.d.ts.map

package/dist/effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../src/effect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,KAAK,UAAU,MAAM,iCAAiC,CAAA;AAIlE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,EAAE,UAAS,eAAoB,KAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CASjG,CAAA"}

package/dist/effect.js

@@ -0,0 +1,18 @@
+import { NodeFileSystem } from "@effect/platform-node";
+import * as Layer from "effect/Layer";
+import { FetchHttpClient } from "effect/unstable/http";
+import * as CassetteService from "./cassette.js";
+import { recordingLayer } from "./internal-effect.js";
+import { make } from "./redactor.js";
+/**
+ * Provides a fetch-backed `HttpClient` with cassette recording and replay.
+ *
+ * Locally, a missing cassette is recorded from the real service. Existing
+ * cassettes are replayed, and `CI=true` makes a missing cassette fail.
+ */
+export const http = (name, options = {}) => recordingLayer(name, {
+    metadata: options.metadata,
+    redactor: make(options.redact),
+    match: options.match,
+}).pipe(Layer.provide(CassetteService.fileSystem({ directory: options.directory })), Layer.provide(FetchHttpClient.layer), Layer.provide(NodeFileSystem.layer));
+//# sourceMappingURL=effect.js.map

package/dist/effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.js","sourceRoot":"","sources":["../src/effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtD,OAAO,KAAK,eAAe,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAGpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,UAA2B,EAAE,EAAsC,EAAE,CACtG,cAAc,CAAC,IAAI,EAAE;IACnB,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;CACrB,CAAC,CAAC,IAAI,CACL,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,EAC3E,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,EACpC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CACpC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/** HTTP and WebSocket cassette recording. */
+export declare const HttpRecorder: {
+    readonly http: (name: string, options?: import("./types.js").RecorderOptions) => import("effect/Layer").Layer<import("effect/unstable/http/HttpClient").HttpClient>;
+    readonly socket: (name: string, options?: import("./types.js").RecorderOptions) => import("effect/Layer").Layer<import("effect/unstable/socket/Socket").Socket, never, import("effect/unstable/socket/Socket").Socket>;
+};
+export declare namespace HttpRecorder {
+    /** Additional JSON metadata stored with a cassette. */
+    type CassetteMetadata = import("./types.js").CassetteMetadata;
+    /** Recorder configuration. */
+    type RecorderOptions = import("./types.js").RecorderOptions;
+    /** Additive redaction and header-preservation policy. */
+    type RedactOptions = import("./types.js").RedactOptions;
+    /** Returns whether an incoming HTTP request matches a recorded request. */
+    type RequestMatcher = import("./types.js").RequestMatcher;
+    /** The normalized HTTP request representation used for matching. */
+    type RequestSnapshot = import("./types.js").RequestSnapshot;
+}
+//# 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":"AAGA,6CAA6C;AAC7C,eAAO,MAAM,YAAY;;;CAA4B,CAAA;AAErD,yBAAiB,YAAY,CAAC;IAC5B,uDAAuD;IACvD,KAAY,gBAAgB,GAAG,OAAO,YAAY,EAAE,gBAAgB,CAAA;IACpE,8BAA8B;IAC9B,KAAY,eAAe,GAAG,OAAO,YAAY,EAAE,eAAe,CAAA;IAClE,yDAAyD;IACzD,KAAY,aAAa,GAAG,OAAO,YAAY,EAAE,aAAa,CAAA;IAC9D,2EAA2E;IAC3E,KAAY,cAAc,GAAG,OAAO,YAAY,EAAE,cAAc,CAAA;IAChE,oEAAoE;IACpE,KAAY,eAAe,GAAG,OAAO,YAAY,EAAE,eAAe,CAAA;CACnE"}

package/dist/index.js

@@ -0,0 +1,5 @@
+import { http } from "./effect.js";
+import { socket } from "./socket.js";
+/** HTTP and WebSocket cassette recording. */
+export const HttpRecorder = { http, socket };
+//# 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,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,IAAI,EAAE,MAAM,EAAW,CAAA"}

package/dist/internal-effect.d.ts

@@ -0,0 +1,19 @@
+import { Layer } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/unstable/http";
+import * as CassetteService from "./cassette.js";
+import { defaultMatcher } from "./matching.js";
+import { type Redactor } from "./redactor.js";
+import type { CassetteMetadata, RequestMatcher } from "./types.js";
+export { defaultMatcher };
+export type RecordReplayMode = "auto" | "record" | "replay" | "passthrough";
+export interface RecordReplayOptions {
+    readonly mode?: RecordReplayMode;
+    readonly directory?: string;
+    readonly metadata?: CassetteMetadata;
+    readonly redactor?: Redactor;
+    readonly match?: RequestMatcher;
+}
+export declare const redactedErrorRequest: (request: HttpClientRequest.HttpClientRequest) => HttpClientRequest.HttpClientRequest;
+export declare const recordingLayer: (name: string, options?: Omit<RecordReplayOptions, "directory">) => Layer.Layer<HttpClient.HttpClient, never, HttpClient.HttpClient | CassetteService.Service>;
+export declare const cassetteLayer: (name: string, options?: RecordReplayOptions) => Layer.Layer<HttpClient.HttpClient>;
+//# sourceMappingURL=internal-effect.d.ts.map

package/dist/internal-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-effect.d.ts","sourceRoot":"","sources":["../src/internal-effect.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,EAAe,MAAM,QAAQ,CAAA;AAC7D,OAAO,EAIL,UAAU,EAEV,iBAAiB,EAGlB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,eAAe,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,cAAc,EAAoB,MAAM,eAAe,CAAA;AAEhE,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGnD,OAAO,KAAK,EAAE,gBAAgB,EAAmB,cAAc,EAAoB,MAAM,YAAY,CAAA;AAErG,OAAO,EAAE,cAAc,EAAE,CAAA;AAEzB,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAA;AAE3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAA;CAChC;AA+CD,eAAO,MAAM,oBAAoB,GAAI,SAAS,iBAAiB,CAAC,iBAAiB,wCAQ9E,CAAA;AAOH,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,UAAS,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAM,KACnD,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,GAAG,eAAe,CAAC,OAAO,CAsFzF,CAAA;AAEH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,UAAS,mBAAwB,KAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAK9G,CAAA"}

package/dist/internal-effect.js

@@ -0,0 +1,105 @@
+import { NodeFileSystem } from "@effect/platform-node";
+import { Deferred, Effect, Layer, Option, Ref } from "effect";
+import { FetchHttpClient, Headers, HttpBody, HttpClient, HttpClientError, HttpClientRequest, HttpClientResponse, UrlParams, } from "effect/unstable/http";
+import * as CassetteService from "./cassette.js";
+import { defaultMatcher, selectSequential } from "./matching.js";
+import { makeReplayState, resolveAutoMode } from "./recorder.js";
+import { make } from "./redactor.js";
+import { redactUrl } from "./redaction.js";
+import { httpInteractions } from "./schema.js";
+export { defaultMatcher };
+const TEXT_CONTENT_TYPES = new Set([
+    "application/graphql",
+    "application/javascript",
+    "application/json",
+    "application/sql",
+    "application/x-www-form-urlencoded",
+    "application/xml",
+    "application/yaml",
+    "image/svg+xml",
+]);
+const isTextContentType = (contentType) => {
+    const mediaType = contentType?.split(";", 1)[0]?.trim().toLowerCase();
+    if (!mediaType)
+        return false;
+    return (mediaType.startsWith("text/") ||
+        mediaType.endsWith("+json") ||
+        mediaType.endsWith("+xml") ||
+        TEXT_CONTENT_TYPES.has(mediaType));
+};
+const captureResponseBody = (response, contentType) => response.arrayBuffer.pipe(Effect.map((bytes) => isTextContentType(contentType)
+    ? { body: new TextDecoder().decode(bytes) }
+    : { body: Buffer.from(bytes).toString("base64"), bodyEncoding: "base64" }));
+const decodeResponseBody = (snapshot) => snapshot.bodyEncoding === "base64" ? Buffer.from(snapshot.body, "base64") : snapshot.body;
+const responseFromSnapshot = (request, snapshot) => HttpClientResponse.fromWeb(request, new Response(request.method === "HEAD" || snapshot.status === 204 || snapshot.status === 205 || snapshot.status === 304
+    ? null
+    : decodeResponseBody(snapshot), snapshot));
+export const redactedErrorRequest = (request) => HttpClientRequest.makeWith(request.method, redactUrl(request.url), UrlParams.empty, Option.none(), Headers.empty, HttpBody.empty);
+const transportError = (request, description) => new HttpClientError.HttpClientError({
+    reason: new HttpClientError.TransportError({ request: redactedErrorRequest(request), description }),
+});
+export const recordingLayer = (name, options = {}) => Layer.effect(HttpClient.HttpClient, Effect.gen(function* () {
+    const upstream = yield* HttpClient.HttpClient;
+    const cassetteService = yield* CassetteService.Service;
+    const redactor = options.redactor ?? make();
+    const match = options.match ?? defaultMatcher;
+    const requested = options.mode ?? "auto";
+    const mode = requested === "auto" ? yield* resolveAutoMode(cassetteService, name) : requested;
+    const snapshotRequest = (request) => Effect.gen(function* () {
+        const web = yield* HttpClientRequest.toWeb(request).pipe(Effect.orDie);
+        return redactor.request({
+            method: web.method,
+            url: web.url,
+            headers: Object.fromEntries(web.headers.entries()),
+            body: yield* Effect.promise(() => web.text()),
+        });
+    });
+    if (mode === "passthrough")
+        return upstream;
+    if (mode === "record") {
+        const initial = yield* Deferred.make();
+        yield* Deferred.succeed(initial, undefined);
+        const tail = yield* Ref.make(initial);
+        return HttpClient.make((request) => Effect.gen(function* () {
+            const completed = yield* Deferred.make();
+            const previous = yield* Ref.modify(tail, (current) => [current, completed]);
+            return yield* Effect.gen(function* () {
+                const incoming = yield* snapshotRequest(request);
+                const response = yield* upstream.execute(request);
+                const captured = yield* captureResponseBody(response, response.headers["content-type"]);
+                const responseSnapshot = {
+                    status: response.status,
+                    headers: response.headers,
+                    ...captured,
+                };
+                const interaction = {
+                    transport: "http",
+                    request: incoming,
+                    response: redactor.response(responseSnapshot),
+                };
+                yield* Deferred.await(previous);
+                yield* cassetteService
+                    .append(name, interaction, options.metadata)
+                    .pipe(Effect.catchTag("UnsafeCassetteError", (error) => Effect.fail(transportError(request, error.message))));
+                return responseFromSnapshot(request, responseSnapshot);
+            }).pipe(Effect.ensuring(Deferred.succeed(completed, undefined)));
+        }));
+    }
+    const replay = yield* makeReplayState(cassetteService, name, httpInteractions);
+    return HttpClient.make((request) => Effect.gen(function* () {
+        const incoming = yield* snapshotRequest(request);
+        const claimed = yield* replay
+            .claim((interaction, index, interactions) => {
+            const result = selectSequential(interactions, incoming, match, index);
+            if (result.interaction)
+                return Effect.void;
+            return Effect.fail(transportError(request, `Fixture "${name}" does not match the current request: ${result.detail}.`));
+        })
+            .pipe(Effect.mapError((error) => error._tag === "CassetteNotFoundError"
+            ? transportError(request, `Fixture "${name}" not found. Run locally to record it (CI=true forces replay).`)
+            : error));
+        return responseFromSnapshot(request, claimed.interaction.response);
+    }));
+}));
+export const cassetteLayer = (name, options = {}) => recordingLayer(name, options).pipe(Layer.provide(CassetteService.fileSystem({ directory: options.directory })), Layer.provide(FetchHttpClient.layer), Layer.provide(NodeFileSystem.layer));
+//# sourceMappingURL=internal-effect.js.map

package/dist/internal-effect.js.map

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

package/dist/internal.d.ts

@@ -0,0 +1,9 @@
+export { CassetteNotFoundError, hasCassetteSync, UnsafeCassetteError } from "./cassette.js";
+export { cassetteLayer, recordingLayer, type RecordReplayMode, type RecordReplayOptions } from "./internal-effect.js";
+export { redactHeaders, redactUrl, secretFindings, type SecretFinding } from "./redaction.js";
+export { socketLayer } from "./socket.js";
+export { makeWebSocketExecutor, type WebSocketConnection, type WebSocketExecutor, type WebSocketRecordReplayOptions, type WebSocketRequest, } from "./websocket.js";
+export * as Cassette from "./cassette.js";
+export * as Redactor from "./redactor.js";
+export * as HttpRecorderInternal from "./internal.js";
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAC3F,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AACrH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EACL,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC,OAAO,KAAK,oBAAoB,MAAM,eAAe,CAAA"}