Testing and mocking

zespan.init({
  apiKey: process.env.ZESPAN_API_KEY ?? "zsp_test",
  sampleRate: 0, // drop all events
  environment: "test",
});

# .env.test — no ZESPAN_API_KEY
OPENAI_API_KEY=sk-...

if (process.env.ZESPAN_API_KEY) {
  zespan.init({ apiKey: process.env.ZESPAN_API_KEY });
}

// vitest
import { vi, describe, it, expect } from "vitest";

vi.mock("@zespan/sdk", () => ({
  zespan: {
    init: vi.fn(),
    wrapOpenAI: (client: unknown) => client, // return client unchanged
    wrapAnthropic: (client: unknown) => client,
  },
  withAgent: vi.fn(async (_opts, fn) =>
    fn({ traceTool: async (_name: string, _args: unknown, run: () => unknown) => run() }),
  ),
  // The real startSpan returns { span, run } — span.end() is async.
  startSpan: vi.fn(() => ({
    span: { setEvalScore: vi.fn(), recordDocuments: vi.fn(), end: vi.fn(async () => {}) },
    run: <T,>(fn: () => T) => fn(),
  })),
}));

describe("my agent", () => {
  it("calls the model once", async () => {
    // your test — Zespan SDK is a no-op
  });
});

zespan.init({
  apiKey: "zsp_test_dummy",
  endpoint: "http://localhost:4318", // local mock or equivalent
  environment: "test",
  sampleRate: 1.0,
});

afterEach(async () => {
  await zespan.getClient().flush();
});

# .github/workflows/test.yml
env:
  ZESPAN_API_KEY: ${{ secrets.ZESPAN_API_KEY }}
  ZESPAN_SAMPLE_RATE: "0"
  ZESPAN_ENVIRONMENT: "ci"