Upgrade to Effect rc.112, TypeScript 7, and Bun 1.4.1

.changeset/effect-rc112-toolchain.md

@@ -0,0 +1,7 @@
+---
+"effect-http-recorder": minor
+---
+
+Upgrade to Effect `4.0.0-rc.112`, require TypeScript 7 and Bun `1.4.1` or newer, and update the development toolchain to TypeScript `7.0.2`, `@effect/tsgo` `0.39.1`, and Vitest `4.1.11`.
+
+Adapt schema errors, JSON codecs, and WebSocket types to the updated dependencies while preserving the recorder API and cassette format. Remove the obsolete `skipLibCheck` workaround from consumer guidance and package verification.

.github/workflows/ci.yml

@@ -21,7 +21,7 @@ jobs:
 
       - uses: oven-sh/setup-bun@735343b667d3e6f658f44d0eca948eb6282f2b76 # v2.0.2
         with:
-          bun-version: 1.3.14
+          bun-version: 1.4.1
 
       - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
         with:

.github/workflows/release.yml

@@ -18,7 +18,7 @@ jobs:
 
       - uses: oven-sh/setup-bun@735343b667d3e6f658f44d0eca948eb6282f2b76 # v2.0.2
         with:
-          bun-version: 1.3.14
+          bun-version: 1.4.1
 
       - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
         with:

CONTRIBUTING.md

@@ -11,4 +11,4 @@ Use `bun run format` and `bun run lint:fix` for local fixes. Tests live under `t
 
 Add a Changeset with `bun run changeset` for user-facing changes. Review every cassette diff for credentials before committing it. Refresh a cassette by deleting only that cassette and rerunning its focused test.
 
-Effect beta upgrades must update runtime, peer, development, documentation, and clean-consumer versions together. Use static imports only; dynamic `import()` and inline import-type expressions are not accepted.
+Effect release candidate upgrades must update runtime, peer, development, documentation, and clean-consumer versions together. Use static imports only; dynamic `import()` and inline import-type expressions are not accepted.

README.md

@@ -4,26 +4,16 @@ Record real Effect HTTP and WebSocket traffic once, then replay it from determin
 
 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.
+> Public beta. The API depends on Effect 4 release candidates and may change with Effect's unstable transport modules.
 
 ## Install
 
 ```sh
-bun add effect@4.0.0-beta.83
-bun add -d effect-http-recorder@beta @effect/vitest@4.0.0-beta.83 vitest@^4
+bun add effect@4.0.0-rc.112
+bun add -d effect-http-recorder@beta @effect/vitest@4.0.0-rc.112 typescript@^7 vitest@^4.1
 ```
 
-The package supports Node.js 22+ and Bun. It is not intended for browsers, workers, or Deno.
-
-Effect `4.0.0-beta.83` currently contains unresolved symbols in its published declarations. Until those upstream declarations are fixed, TypeScript consumers need:
-
-```json
-{
-  "compilerOptions": {
-    "skipLibCheck": true
-  }
-}
-```
+The package requires TypeScript 7 (`typescript@^7`), supports Node.js 22+ and Bun 1.4.1+, and is not intended for browsers, workers, or Deno.
 
 ## Quick Start
 
@@ -248,7 +238,7 @@ Cassettes are readable JSON files intended to be committed with your tests. HTTP
 - Constructor-level WebSocket cassettes reproduce terminal close codes and reasons, but not selected subprotocols, handshake headers, transport timing, or transport failures. Lower-level `layerSocket` cassettes contain frames only.
 - Failed and interrupted live WebSocket connections 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.
+- The package currently requires the exact Effect release candidate listed above.
 - Cassette format version `1` has no migration tooling yet.
 
 ## License

package.json

@@ -21,14 +21,15 @@
   ],
   "engines": {
     "node": ">=22",
-    "bun": ">=1.3.14"
+    "bun": ">=1.4.1"
   },
   "publishConfig": {
     "access": "public",
     "tag": "beta",
     "provenance": true
   },
   "scripts": {
+    "prepare": "effect-tsgo patch --typescript",
     "changeset": "changeset",
     "format": "oxfmt .",
     "format:check": "oxfmt --check .",
@@ -38,7 +39,7 @@
     "test": "bun test --timeout 30000 --only-failures",
     "test:examples": "vitest run --config examples/vitest.config.ts",
     "record:examples": "rm -rf examples/recordings && bun run test:examples",
-    "typecheck": "tsgo --noEmit && tsgo -p test/tsconfig.json --noEmit",
+    "typecheck": "tsc --noEmit && tsc -p test/tsconfig.json --noEmit",
     "build": "bun ./script/build.ts",
     "verify:package": "bun ./script/verify-package.ts",
     "check": "bun run format:check && bun run lint && bun run check:imports && bun run typecheck && bun run test && bun run test:examples && bun run verify:package",
@@ -61,26 +62,29 @@
   ],
   "devDependencies": {
     "@changesets/cli": "2.31.0",
-    "@effect/platform-node": "4.0.0-beta.83",
-    "@effect/vitest": "4.0.0-beta.83",
+    "@effect/platform-node": "4.0.0-rc.112",
+    "@effect/tsgo": "0.39.1",
+    "@effect/vitest": "4.0.0-rc.112",
     "@tsconfig/node22": "22.0.2",
-    "@types/bun": "1.3.13",
+    "@types/bun": "latest",
     "@types/node": "24.12.2",
-    "@typescript/native-preview": "7.0.0-dev.20251207.1",
-    "effect": "4.0.0-beta.83",
-    "oxfmt": "0.56.0",
-    "oxlint": "1.60.0",
-    "typescript": "5.8.2",
-    "vitest": "4.0.16"
+    "oxfmt": "0.66.0",
+    "oxlint": "1.81.0",
+    "oxlint-tsgolint": "7.0.2001",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11"
   },
   "dependencies": {
-    "@effect/platform-node-shared": "4.0.0-beta.83"
+    "@effect/platform-bun": "4.0.0-rc.112",
+    "@effect/platform-node-shared": "4.0.0-rc.112",
+    "effect": "4.0.0-rc.112"
   },
   "peerDependencies": {
-    "effect": "4.0.0-beta.83"
+    "effect": "4.0.0-rc.112",
+    "typescript": "^7"
   },
-  "packageManager": "bun@1.3.14",
+  "packageManager": "bun@1.4.1",
   "overrides": {
-    "@effect/platform-node-shared": "4.0.0-beta.83"
+    "@effect/platform-node-shared": "4.0.0-rc.112"
   }
 }

script/verify-package.ts

@@ -107,8 +107,6 @@ if (JSON.stringify(namespace) !== JSON.stringify(["hasCassetteSync", "layer", "l
           moduleResolution: "NodeNext",
           strict: true,
           noEmit: true,
-          // Required by effect@4.0.0-beta.83: its declarations currently contain unresolved internal symbols.
-          skipLibCheck: true,
           lib: ["ES2022", "DOM", "ESNext.Disposable"],
         },
         include: ["consumer.ts"],

src/cassette/model.ts

@@ -1,20 +1,19 @@
 import { Schema } from "effect"
-import type { CassetteMetadata, JsonValue } from "../api.js"
+import type { JsonValue } from "../api.js"
 import { HttpInteractionSchema } from "../http/model.js"
 import { WebSocketInteractionSchema } from "../websocket/model.js"
 
 export type { CassetteMetadata, JsonValue } from "../api.js"
 
-const JsonValueSchema = Schema.suspend(
-  (): Schema.Codec<JsonValue> =>
-    Schema.Union([
-      Schema.Null,
-      Schema.Boolean,
-      Schema.Number,
-      Schema.String,
-      Schema.Array(JsonValueSchema),
-      Schema.Record(Schema.String, JsonValueSchema),
-    ]),
+const JsonValueSchema = Schema.suspend((): Schema.Codec<JsonValue> =>
+  Schema.Union([
+    Schema.Null,
+    Schema.Boolean,
+    Schema.Number,
+    Schema.String,
+    Schema.Array(JsonValueSchema),
+    Schema.Record(Schema.String, JsonValueSchema),
+  ]),
 )
 
 export const CassetteMetadataSchema = Schema.Record(Schema.String, JsonValueSchema)

src/cassette/store.ts

@@ -6,15 +6,15 @@ import { CassetteSchema, encodeCassette, type Cassette, type CassetteMetadata, t
 
 const DEFAULT_RECORDINGS_DIR = path.resolve(process.cwd(), "test", "fixtures", "recordings")
 
-export class CassetteNotFoundError extends Schema.TaggedErrorClass<CassetteNotFoundError>()("CassetteNotFoundError", {
+export class CassetteNotFoundError extends Schema.TaggedError<CassetteNotFoundError>()("CassetteNotFoundError", {
   cassetteName: Schema.String,
 }) {
   override get message() {
     return `Cassette "${this.cassetteName}" not found`
   }
 }
 
-export class InvalidCassetteError extends Schema.TaggedErrorClass<InvalidCassetteError>()("InvalidCassetteError", {
+export class InvalidCassetteError extends Schema.TaggedError<InvalidCassetteError>()("InvalidCassetteError", {
   cassetteName: Schema.String,
   description: Schema.String,
 }) {
@@ -23,7 +23,7 @@ export class InvalidCassetteError extends Schema.TaggedErrorClass<InvalidCassett
   }
 }
 
-export class UnsafeCassetteError extends Schema.TaggedErrorClass<UnsafeCassetteError>()("UnsafeCassetteError", {
+export class UnsafeCassetteError extends Schema.TaggedError<UnsafeCassetteError>()("UnsafeCassetteError", {
   cassetteName: Schema.String,
   findings: Schema.Array(SecretFindingSchema),
 }) {

src/http/model.ts

@@ -1,5 +1,4 @@
 import { Schema } from "effect"
-import type { RequestSnapshot } from "../api.js"
 
 export const RequestSnapshotSchema = Schema.Struct({
   method: Schema.String,

src/redaction/redactor.ts

@@ -31,7 +31,7 @@ const DEFAULT_REDACT_QUERY = [
   "x-amz-signature",
 ]
 
-const decodeJson = Schema.decodeUnknownOption(Schema.UnknownFromJsonString)
+const decodeJson = Schema.decodeUnknownOption(Schema.fromJsonString(Schema.Unknown))
 
 const redactionSet = (values: ReadonlyArray<string> | undefined, defaults: ReadonlyArray<string>) =>
   new Set([...defaults, ...(values ?? [])].map((value) => value.toLowerCase()))

src/replay/comparison.ts

@@ -2,7 +2,7 @@ import { Option, Schema } from "effect"
 import { REDACTED } from "../redaction/redactor.js"
 import { secretFindings } from "../redaction/secrets.js"
 
-export const decodeJson = Schema.decodeUnknownOption(Schema.UnknownFromJsonString)
+export const decodeJson = Schema.decodeUnknownOption(Schema.fromJsonString(Schema.Unknown))
 
 const isRecord = (value: unknown): value is Record<string, unknown> =>
   value !== null && typeof value === "object" && !Array.isArray(value)

src/websocket/recorder.ts

@@ -83,7 +83,7 @@ const webSocketFacade = (
     readonly protocol: () => string
     readonly extensions: () => string
     readonly bufferedAmount: () => number
-    readonly send: (data: string | ArrayBufferLike | Blob | ArrayBufferView) => void
+    readonly send: (data: BufferSource | Blob | string) => void
     readonly close: (code?: number, reason?: string) => void
   },
 ): globalThis.WebSocket => {
@@ -496,7 +496,7 @@ const makeRecordingWebSocketConstructor = (
     return new Proxy(native, {
       get: (target, property) => {
         if (property === "send")
-          return (data: string | ArrayBufferLike | Blob | ArrayBufferView) => {
+          return (data: BufferSource | Blob | string) => {
             target.send(data)
             appendEvent("client", data)
           }

test/http.test.ts

@@ -215,7 +215,7 @@ describe("HTTP", () => {
       const completed: string[] = []
       using server = Bun.serve({
         port: 0,
-        fetch: async (request) => {
+        fetch: async (request: Request) => {
           const name = new URL(request.url).pathname.slice(1)
           if (name === "first") {
             await first.promise

test/tsconfig.json

@@ -2,6 +2,7 @@
   "extends": "../tsconfig.json",
   "compilerOptions": {
     "rootDir": "..",
+    "types": ["bun", "node"],
     "noEmit": true,
     "declaration": false,
     "module": "preserve",

test/websocket.test.ts

@@ -26,7 +26,7 @@ class EchoWebSocket extends EventTarget {
     })
   }
 
-  send(data: string | ArrayBufferLike | Blob | ArrayBufferView) {
+  send(data: BufferSource | Blob | string) {
     queueMicrotask(() => this.dispatchEvent(new MessageEvent("message", { data })))
   }