feat: configure testnet recordings

* feat: configure testnet recording and bun debugging

This enables debugging the recording process and captures real testnet
API responses for mock server playback.

Adds VS Code Bun debugger configuration for server

* fix: updated launch debug file with client arg.

Reran the har recordings

* fix: changed url for testnet only calling

* fix: remove problematic response headers during replay

- Strip transfer-encoding and content-encoding headers in beforeReplay hook to prevent conflicts with content-length and decompression errors
- Replace server tests with replay-focused tests
- Update unrecorded endpoint test to use non-existent account address
- Re-record HAR files with consistent API token format

* refactor: separate recording and replay into distinct CLI tools

- Split bin/server.ts (replay-only) and bin/record.ts (recording-only)
- Update startServer() to remove mode parameter, always replays
- Created tests for replay and recording
- Update tests to use new API signatures
- Add debug configurations for both tools

* refactor: added recordings back to server start

* refactor: record test to just test the record function

Removed the bin record file since recording happens on every server start

Author: lempira

resources/mock-server/.gitignore

@@ -32,3 +32,6 @@ report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
 
 # Finder (MacOS) folder config
 .DS_Store
+
+
+.tmp/

resources/mock-server/.vscode/launch.json

@@ -0,0 +1,35 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "bun",
+      "request": "launch",
+      "name": "Debug Replay Server",
+      "program": "${workspaceFolder}/bin/server.ts",
+      "args": ["algod"], // Change to: algod, indexer, or kmd
+      "cwd": "${workspaceFolder}",
+      "stopOnEntry": false,
+      "watchMode": false,
+      "env": {
+        "NODE_ENV": "development",
+        "LOG_LEVEL": "debug"
+      }
+    },
+    {
+      "type": "bun",
+      "request": "launch",
+      "name": "Debug Record",
+      "program": "${workspaceFolder}/bin/record.ts",
+      "args": ["algod", "record-new"], // Change client: algod, indexer, kmd | mode: record-new, record-overwrite
+      "cwd": "${workspaceFolder}",
+      "stopOnEntry": false,
+      "watchMode": false,
+      "env": {
+        "NODE_ENV": "development"
+      }
+    }
+  ]
+}

resources/mock-server/README.md

@@ -12,4 +12,10 @@ To run:
 bun run index.ts
 ```
 
+## Debugging
+
+To debug in VS Code/Cursor, install the [Bun extension](https://marketplace.visualstudio.com/items?itemName=oven.bun-vscode) (`oven.bun-vscode`), then press F5 to start the debugger.
+
+---
+
 This project was created using `bun init` in bun v1.2.15. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.

…test__/__snapshots__/server.test.ts.snap …test__/__snapshots__/replay.test.ts.snapresources/mock-server/__test__/__snapshots__/server.test.ts.snap renamed to resources/mock-server/__test__/__snapshots__/replay.test.ts.snap resources/mock-server/__test__/__snapshots__/server.test.ts.snap renamed to resources/mock-server/__test__/__snapshots__/replay.test.ts.snap

@@ -13,13 +13,13 @@ NodeStatusResponse {
   "catchpointVerifiedKvs": 0,
   "catchupTime": 0n,
   "lastCatchpoint": "",
-  "lastRound": 17n,
+  "lastRound": 57490072n,
   "lastVersion": "https://github.com/algorandfoundation/specs/tree/953304de35264fc3ef91bcd05c123242015eeaed",
   "nextVersion": "https://github.com/algorandfoundation/specs/tree/953304de35264fc3ef91bcd05c123242015eeaed",
-  "nextVersionRound": 18n,
+  "nextVersionRound": 57490073n,
   "nextVersionSupported": true,
   "stoppedAtUnsupportedRound": false,
-  "timeSinceLastRound": 152696395985404n,
+  "timeSinceLastRound": 998402345n,
   "upgradeDelay": undefined,
   "upgradeNextProtocolVoteBefore": undefined,
   "upgradeNoVotes": undefined,
@@ -42,8 +42,8 @@ HealthCheck {
   "dbAvailable": true,
   "errors": undefined,
   "isMigrating": false,
-  "message": "0",
-  "round": 0n,
+  "message": "57490591",
+  "round": 57490591n,
   "version": "3.9.0",
 }
 `;

resources/mock-server/__test__/record.test.ts

@@ -0,0 +1,51 @@
+import { describe, it, expect, afterEach } from "vitest";
+import { record } from "../src/index";
+import { Algodv2 } from "algosdk";
+import fs from "fs";
+import path from "path";
+
+const TEST_RECORDINGS_DIR = path.resolve(__dirname, "../recordings-test");
+
+describe("Recording Tests", () => {
+  afterEach(async () => {
+    // Clean up test recordings directory completely
+    if (fs.existsSync(TEST_RECORDINGS_DIR)) {
+      fs.rmSync(TEST_RECORDINGS_DIR, { recursive: true, force: true });
+    }
+  });
+
+  it("should record in record-new mode", async () => {
+    // Create test recordings directory
+    fs.mkdirSync(TEST_RECORDINGS_DIR, { recursive: true });
+
+    // Create recording with record-new using TestNet
+    await record(
+      "algod",
+      async () => {
+        const algod = new Algodv2(
+          "a".repeat(64),
+          "https://testnet-api.4160.nodely.dev",
+          443
+        );
+        await algod.status().do();
+      },
+      "record-new",
+      TEST_RECORDINGS_DIR
+    );
+
+    // Verify HAR file was created
+    const harFiles = fs.readdirSync(TEST_RECORDINGS_DIR, { recursive: true });
+    const harFileName = harFiles.find((f) =>
+      f.toString().endsWith("recording.har")
+    );
+    expect(harFileName).toBeDefined();
+
+    const harPath = path.join(TEST_RECORDINGS_DIR, harFileName!.toString());
+    expect(fs.existsSync(harPath)).toBe(true);
+
+    // Verify HAR file has entries
+    const content = fs.readFileSync(harPath, "utf-8");
+    const har = JSON.parse(content);
+    expect(har.log.entries.length).toBeGreaterThan(0);
+  });
+});

…rces/mock-server/__test__/server.test.ts …rces/mock-server/__test__/replay.test.tsresources/mock-server/__test__/server.test.ts renamed to resources/mock-server/__test__/replay.test.ts resources/mock-server/__test__/server.test.ts renamed to resources/mock-server/__test__/replay.test.ts

@@ -3,6 +3,7 @@ import { startServer, type ServerInstance } from "../src/server";
 import { Algodv2, Indexer, Kmd } from "algosdk";
 
 const PollyError = "PollyError";
+const NON_EXISTENT_ADDRESS = "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAY5HFKQ";
 
 describe("Algod Mock Server", () => {
   let algodServer: ServerInstance;
@@ -24,7 +25,7 @@ describe("Algod Mock Server", () => {
 
   it("should fail with unrecorded endpoint", async () => {
     try {
-      await algodClient.genesis().do();
+      await algodClient.accountInformation(NON_EXISTENT_ADDRESS).do();
     } catch (error: any) {
       expect(Buffer.from(error.response.body).toString()).toContain(PollyError);
       return;

resources/mock-server/bin/server.ts

@@ -1,7 +1,14 @@
 import type { Client } from "../src/index.ts";
 import { startServer } from "../src/server.ts";
 
-const client = process.argv[2];
-const server = await startServer(client as Client);
+const client = process.argv[2] as Client;
+const recordingsDir = process.argv[3];
 
-await server.listen;
+console.log(`Starting ${client} mock server in replay mode...`);
+if (recordingsDir) {
+  console.log(`Recordings directory: ${recordingsDir}`);
+}
+
+const server = await startServer(client, recordingsDir);
+
+console.log(`✓ Server listening on port ${server.port}`);

resources/mock-server/bun.lock

@@ -0,0 +1,18 @@
+{
+  "folders": [
+    {
+      "name": "mock-server",
+      "path": "."
+    }
+  ],
+  // Workspace-specific VS Code settings
+  "settings": {
+    // Path to the TypeScript language server to use for IntelliSense and type checking
+    // Points to the workspace's local typescript package instead of VS Code's built-in version
+    "typescript.tsdk": "node_modules/typescript/lib",
+
+    // When true, VS Code will prompt to use the workspace TypeScript version
+    // This ensures consistency between CLI builds and editor type checking
+    "typescript.enablePromptUseWorkspaceTsdk": true
+  }
+}