jevkit-vitest 0.1.0

package/README.md

@@ -0,0 +1,84 @@
+# jevkit-vitest
+
+Record and replay TypeSafe Jev requests in vitest.
+
+A model call in a test is slow, costs money, needs a key in CI, and can change
+its answer under you when the alias moves. The fix is the one VCR established for
+HTTP: record real responses once, replay them forever, re-record on purpose.
+
+> Unofficial and unaffiliated with TypeSafe.
+
+```bash
+npm install -D jevkit-vitest
+```
+
+## Use
+
+```ts
+import { expect, it } from "vitest";
+import { cassetteFor } from "jevkit-vitest";
+
+it("routes billing questions", async () => {
+  const cassette = cassetteFor("routes billing questions", { systemOne });
+  const response = await cassette.systemOne(
+    "I was charged twice for the same order",
+    { team: { type: "choice", instructions: "Which team should handle this",
+              criteria: { billing: "Payment issues", technical: "Bugs",
+                          unknown: "None apply" } } },
+  );
+  expect(response.answers.team.choice).toBe("billing");
+});
+```
+
+Record the first time, then never again:
+
+```bash
+JEV_RECORD=1 vitest       # record anything missing
+vitest                    # replay only; a miss is a failure
+JEV_RERECORD=1 vitest     # replace every recording
+```
+
+To record you need a live client. Pass its `systemOne` when building the
+cassette:
+
+```ts
+import { TypeSafeClient } from "@typesafe-ai/sdk";
+
+const client = new TypeSafeClient();
+const systemOne = (state, questions, options) =>
+  client.systemOne({ state, questions, ...options });
+```
+
+Replay-only runs need no client and no API key, which is the point: CI stays
+green without a secret.
+
+## Assertions that explain themselves
+
+```ts
+import { assertAnswer, assertConfident } from "jevkit-vitest";
+
+assertAnswer(response.answers.team, "billing", { minProbability: 0.6 });
+assertConfident(response.answers.urgency, 0.8);
+```
+
+On failure these print the whole distribution, because a 0.51/0.49 split and a
+0.99/0.01 split are different bugs and `toBe` cannot tell them apart.
+
+`assert_confident` uses the API's confidence for Choice and Score. A Noul carries
+none, so its distance from 0.5 is used and the message says which it used.
+
+## Cassettes are golden sets
+
+A cassette is a `.jevl` file, the same format `jevkit-drift`, `jevkit-bench` and
+`jevkit-calibrate` read. So the recordings your tests already make are a golden
+set you can replay against the next model version:
+
+```bash
+npx jevkit-drift test/cassettes/routes_billing_questions.jevl candidate.jevl
+```
+
+That is the whole reason the format was defined before any of these packages.
+
+## License
+
+MIT

package/dist/assertions.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Assertions over jev answers, with failure messages that say enough.
+ *
+ * A bare `expect(answer.choice).toBe("billing")` tells you nothing about how
+ * close the call was. These assertions print the distribution on failure,
+ * because a 0.51/0.49 split and a 0.99/0.01 split are different bugs.
+ */
+export declare function describeAnswer(qid: string, raw: unknown): string;
+export interface AssertAnswerOptions {
+    questionId?: string;
+    minConfidence?: number;
+    minProbability?: number;
+}
+/** Assert an answer selected `expected`, optionally with enough certainty. */
+export declare function assertAnswer(raw: unknown, expected: unknown, options?: AssertAnswerOptions): void;
+/**
+ * Assert an answer is decisive, without caring which way it went.
+ *
+ * Uses the API's confidence for Choice and Score. A Noul has none, so its
+ * distance from 0.5 is used and the message says so.
+ */
+export declare function assertConfident(raw: unknown, minimum: number, questionId?: string): void;
+//# sourceMappingURL=assertions.d.ts.map

package/dist/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAUhE;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAC1B,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE,mBAAwB,GAChC,IAAI,CAqCN;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,SAAW,GAAG,IAAI,CAW1F"}

package/dist/assertions.js

@@ -0,0 +1,65 @@
+/**
+ * Assertions over jev answers, with failure messages that say enough.
+ *
+ * A bare `expect(answer.choice).toBe("billing")` tells you nothing about how
+ * close the call was. These assertions print the distribution on failure,
+ * because a 0.51/0.49 split and a 0.99/0.01 split are different bugs.
+ */
+import { parseAnswer } from "jevkit-core";
+export function describeAnswer(qid, raw) {
+    const answer = parseAnswer(qid, raw);
+    const probs = Object.entries(answer.probabilities)
+        .sort((a, b) => b[1] - a[1])
+        .map(([k, v]) => `${k}=${v.toFixed(3)}`)
+        .join(", ");
+    const parts = [`predicted=${JSON.stringify(answer.predicted())}`];
+    if (answer.confidence !== null)
+        parts.push(`confidence=${answer.confidence.toFixed(3)}`);
+    if (answer.score !== null)
+        parts.push(`score=${answer.score.toFixed(3)}`);
+    return `${qid}: ${parts.join(", ")}\n    probabilities: ${probs}`;
+}
+/** Assert an answer selected `expected`, optionally with enough certainty. */
+export function assertAnswer(raw, expected, options = {}) {
+    const qid = options.questionId ?? "answer";
+    const answer = parseAnswer(qid, raw);
+    if (!answer.isCorrect(expected)) {
+        throw new Error(`expected ${JSON.stringify(expected)} but got ${JSON.stringify(answer.predicted())}\n  ` +
+            describeAnswer(qid, raw));
+    }
+    if (options.minProbability !== undefined) {
+        const actual = answer.probabilityOf(expected);
+        if (actual < options.minProbability) {
+            throw new Error(`${JSON.stringify(expected)} was selected but carried only ${actual.toFixed(3)} ` +
+                `probability, below the required ${options.minProbability.toFixed(3)}\n  ` +
+                describeAnswer(qid, raw));
+        }
+    }
+    if (options.minConfidence !== undefined) {
+        if (answer.confidence === null) {
+            throw new Error(`minConfidence was given but a ${answer.type} answer carries no confidence. ` +
+                `Use minProbability instead.`);
+        }
+        if (answer.confidence < options.minConfidence) {
+            throw new Error(`${JSON.stringify(expected)} was selected but confidence was ` +
+                `${answer.confidence.toFixed(3)}, below the required ` +
+                `${options.minConfidence.toFixed(3)}\n  ` + describeAnswer(qid, raw));
+        }
+    }
+}
+/**
+ * Assert an answer is decisive, without caring which way it went.
+ *
+ * Uses the API's confidence for Choice and Score. A Noul has none, so its
+ * distance from 0.5 is used and the message says so.
+ */
+export function assertConfident(raw, minimum, questionId = "answer") {
+    const answer = parseAnswer(questionId, raw);
+    const value = answer.decisiveness;
+    if (value < minimum) {
+        const quantity = answer.type === "noul" ? "decisiveness (|noul - 0.5| * 2)" : "confidence";
+        throw new Error(`${quantity} was ${value.toFixed(3)}, below the required ${minimum.toFixed(3)}\n  ` +
+            describeAnswer(questionId, raw));
+    }
+}
+//# sourceMappingURL=assertions.js.map

package/dist/assertions.js.map

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

package/dist/cassette.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Record and replay jev requests so tests do not hit the API.
+ *
+ * A model call in a test is slow, costs money, needs a key in CI, and can
+ * change its answer under you when the alias moves. The fix is the one VCR
+ * established for HTTP: record real responses once, replay them forever,
+ * re-record on purpose.
+ *
+ * A cassette is a `.jevl` file, the same format `drift`, `bench` and
+ * `calibrate` read, so a recording made by your test suite is also a golden set
+ * you can replay against the next model version.
+ */
+import { Record as JevlRecord } from "jevkit-core";
+export type Mode = "replay" | "record" | "auto" | "passthrough";
+/** A request was not on the cassette and the mode forbids recording. */
+export declare class CassetteMiss extends Error {
+    constructor(message: string);
+}
+export type SystemOneCallable = (state: unknown, questions: Record<string, unknown>, options?: Record<string, unknown>) => Promise<unknown> | unknown;
+/** What a cassette hands back in place of a live API response. */
+export declare class ReplayedResponse {
+    readonly model: string;
+    readonly answers: Record<string, Record<string, unknown>>;
+    readonly usage: Record<string, unknown> | null;
+    readonly id: string;
+    constructor(record: JevlRecord);
+}
+export interface CassetteOptions {
+    systemOne?: SystemOneCallable;
+    mode?: Mode;
+    model?: string;
+}
+/**
+ * A recorded set of jev requests, replayed by request digest.
+ *
+ * `mode` controls what happens on a miss:
+ *
+ * - `replay`      throw `CassetteMiss`. The right default for CI.
+ * - `auto`        replay a hit, call through and append on a miss.
+ * - `record`      always call through and append, ignoring existing entries.
+ * - `passthrough` never touch the cassette.
+ */
+export declare class Cassette {
+    readonly path: string;
+    readonly mode: Mode;
+    readonly model: string;
+    readonly played: string[];
+    readonly recorded: string[];
+    private readonly systemOneImpl;
+    private entries;
+    constructor(path: string, options?: CassetteOptions);
+    /**
+     * Index the file by *requested*-model digest.
+     *
+     * A record stores the model that actually answered, which is what the format
+     * requires: `jev-latest` is an alias and the response says `jev-1.13.0`. But
+     * a test asks for the alias, so indexing on the answering model would miss
+     * every lookup. The requested model is kept in `meta` at record time and used
+     * to rebuild the index here.
+     *
+     * Later entries win, so re-recording appends rather than requiring a rewrite.
+     */
+    private load;
+    get size(): number;
+    /**
+     * Entries on the cassette that no test asked for.
+     *
+     * Usually means a test was deleted or a question reworded, leaving a stale
+     * recording that will quietly rot.
+     */
+    get unplayed(): string[];
+    contains(state: unknown, questions: Record<string, unknown>, model?: string): boolean;
+    /**
+     * Drop-in for a client's `systemOne`.
+     *
+     * Always returns a promise, so a cassette can stand in for an async client
+     * without the caller knowing whether the answer came from disk or the wire.
+     */
+    systemOne(state: unknown, questions: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
+    private callThrough;
+}
+//# 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;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,MAAM,IAAI,UAAU,EAAuC,MAAM,aAAa,CAAC;AAExF,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,aAAa,CAAC;AAIhE,wEAAwE;AACxE,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAyBhC,kEAAkE;AAClE,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBAER,MAAM,EAAE,UAAU;CAM/B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,qBAAa,QAAQ;IASP,QAAQ,CAAC,IAAI,EAAE,MAAM;IARjC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAM;IAEjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAC9D,OAAO,CAAC,OAAO,CAA0B;gBAEpB,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;IAWhE;;;;;;;;;;OAUG;IACH,OAAO,CAAC,IAAI;IASZ,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACH,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAIrF;;;;;OAKG;IACG,SAAS,CACb,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,OAAO,CAAC,OAAO,CAAC;YA6CL,WAAW;CAa1B"}

package/dist/cassette.js

@@ -0,0 +1,170 @@
+/**
+ * Record and replay jev requests so tests do not hit the API.
+ *
+ * A model call in a test is slow, costs money, needs a key in CI, and can
+ * change its answer under you when the alias moves. The fix is the one VCR
+ * established for HTTP: record real responses once, replay them forever,
+ * re-record on purpose.
+ *
+ * A cassette is a `.jevl` file, the same format `drift`, `bench` and
+ * `calibrate` read, so a recording made by your test suite is also a golden set
+ * you can replay against the next model version.
+ */
+import { existsSync } from "node:fs";
+import { Record as JevlRecord, appendRecord, readRecords, recordId } from "jevkit-core";
+const MODES = ["replay", "record", "auto", "passthrough"];
+/** A request was not on the cassette and the mode forbids recording. */
+export class CassetteMiss extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CassetteMiss";
+    }
+}
+function plain(value) {
+    if (value === null || value === undefined || typeof value !== "object")
+        return value;
+    if (Array.isArray(value))
+        return value;
+    return { ...value };
+}
+function responseToParts(response) {
+    const obj = (response ?? {});
+    const answers = (obj["answers"] ?? {});
+    const out = {};
+    for (const [qid, a] of Object.entries(answers))
+        out[qid] = plain(a);
+    const usage = obj["usage"];
+    return {
+        model: String(obj["model"] ?? ""),
+        answers: out,
+        usage: usage === undefined || usage === null ? null : plain(usage),
+    };
+}
+/** What a cassette hands back in place of a live API response. */
+export class ReplayedResponse {
+    model;
+    answers;
+    usage;
+    id;
+    constructor(record) {
+        this.model = record.model;
+        this.answers = record.answers;
+        this.usage = record.usage;
+        this.id = record.id;
+    }
+}
+/**
+ * A recorded set of jev requests, replayed by request digest.
+ *
+ * `mode` controls what happens on a miss:
+ *
+ * - `replay`      throw `CassetteMiss`. The right default for CI.
+ * - `auto`        replay a hit, call through and append on a miss.
+ * - `record`      always call through and append, ignoring existing entries.
+ * - `passthrough` never touch the cassette.
+ */
+export class Cassette {
+    path;
+    mode;
+    model;
+    played = [];
+    recorded = [];
+    systemOneImpl;
+    entries;
+    constructor(path, options = {}) {
+        this.path = path;
+        this.mode = options.mode ?? "replay";
+        if (!MODES.includes(this.mode)) {
+            throw new RangeError(`mode must be one of ${MODES.join(", ")}, got "${this.mode}"`);
+        }
+        this.model = options.model ?? "jev-latest";
+        this.systemOneImpl = options.systemOne;
+        this.entries =
+            existsSync(this.path) && this.mode !== "record" ? this.load() : new Map();
+    }
+    /**
+     * Index the file by *requested*-model digest.
+     *
+     * A record stores the model that actually answered, which is what the format
+     * requires: `jev-latest` is an alias and the response says `jev-1.13.0`. But
+     * a test asks for the alias, so indexing on the answering model would miss
+     * every lookup. The requested model is kept in `meta` at record time and used
+     * to rebuild the index here.
+     *
+     * Later entries win, so re-recording appends rather than requiring a rewrite.
+     */
+    load() {
+        const entries = new Map();
+        for (const record of readRecords(this.path)) {
+            const requested = String(record.meta["requested_model"] ?? record.model);
+            entries.set(recordId(requested, record.state, record.questions), record);
+        }
+        return entries;
+    }
+    get size() {
+        return this.entries.size;
+    }
+    /**
+     * Entries on the cassette that no test asked for.
+     *
+     * Usually means a test was deleted or a question reworded, leaving a stale
+     * recording that will quietly rot.
+     */
+    get unplayed() {
+        return [...this.entries.keys()].filter((k) => !this.played.includes(k)).sort();
+    }
+    contains(state, questions, model) {
+        return this.entries.has(recordId(model ?? this.model, state, questions));
+    }
+    /**
+     * Drop-in for a client's `systemOne`.
+     *
+     * Always returns a promise, so a cassette can stand in for an async client
+     * without the caller knowing whether the answer came from disk or the wire.
+     */
+    async systemOne(state, questions, options = {}) {
+        const { model: requested, ...rest } = options;
+        const model = String(requested ?? this.model);
+        if (this.mode === "passthrough") {
+            return this.callThrough(state, questions, { ...rest, model });
+        }
+        const key = recordId(model, state, questions);
+        if (this.mode !== "record") {
+            const hit = this.entries.get(key);
+            if (hit) {
+                this.played.push(key);
+                return new ReplayedResponse(hit);
+            }
+        }
+        if (this.mode === "replay") {
+            throw new CassetteMiss(`no recording for this request on ${this.path}.\n` +
+                `  digest: ${key}\n` +
+                `  Re-run with mode "auto" (or JEV_RECORD=1) to record it, and commit the ` +
+                `updated cassette.`);
+        }
+        const response = await this.callThrough(state, questions, { ...rest, model });
+        const { model: actualModel, answers, usage } = responseToParts(response);
+        const record = new JevlRecord({
+            model: actualModel || model,
+            state,
+            questions,
+            answers,
+            usage,
+            meta: { requested_model: model },
+        });
+        appendRecord(this.path, record);
+        this.entries.set(key, record);
+        this.recorded.push(key);
+        // The live response is returned rather than the record: recording must not
+        // change what the code under test sees.
+        return response;
+    }
+    async callThrough(state, questions, options) {
+        if (!this.systemOneImpl) {
+            throw new CassetteMiss(`cassette ${this.path} is in mode "${this.mode}" and needs to call the API, but ` +
+                `no client was supplied. Pass systemOne when constructing it.`);
+        }
+        return this.systemOneImpl(state, questions, options);
+    }
+}
+//# 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/fixture.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Test-runner glue.
+ *
+ * vitest has no fixture-injection system like pytest's, so this is a helper
+ * rather than a plugin: call `cassetteFor` in a test and you get the same
+ * per-test file naming and the same environment-driven mode switching.
+ */
+import { Cassette, type Mode, type SystemOneCallable } from "./cassette.js";
+/**
+ * Mode from the environment, so CI and local runs differ without code changes.
+ *
+ * `JEV_RERECORD=1` replaces every recording, `JEV_RECORD=1` records only what
+ * is missing, and the default replays and fails on a miss.
+ */
+export declare function modeFromEnv(env?: NodeJS.ProcessEnv): Mode;
+export interface CassetteForOptions {
+    dir?: string;
+    systemOne?: SystemOneCallable;
+    model?: string;
+    mode?: Mode;
+}
+/**
+ * A cassette named after the test.
+ *
+ * ```ts
+ * const cassette = cassetteFor("routes billing questions", { systemOne });
+ * ```
+ *
+ * The name is slugified so one test's recordings never collide with another's.
+ */
+export declare function cassetteFor(name: string, options?: CassetteForOptions): Cassette;
+//# sourceMappingURL=fixture.d.ts.map

package/dist/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5E;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAItE;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,QAAQ,CAUpF"}

package/dist/fixture.js

@@ -0,0 +1,44 @@
+/**
+ * Test-runner glue.
+ *
+ * vitest has no fixture-injection system like pytest's, so this is a helper
+ * rather than a plugin: call `cassetteFor` in a test and you get the same
+ * per-test file naming and the same environment-driven mode switching.
+ */
+import { mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { Cassette } from "./cassette.js";
+/**
+ * Mode from the environment, so CI and local runs differ without code changes.
+ *
+ * `JEV_RERECORD=1` replaces every recording, `JEV_RECORD=1` records only what
+ * is missing, and the default replays and fails on a miss.
+ */
+export function modeFromEnv(env = process.env) {
+    if (env["JEV_RERECORD"])
+        return "record";
+    if (env["JEV_RECORD"])
+        return "auto";
+    return "replay";
+}
+/**
+ * A cassette named after the test.
+ *
+ * ```ts
+ * const cassette = cassetteFor("routes billing questions", { systemOne });
+ * ```
+ *
+ * The name is slugified so one test's recordings never collide with another's.
+ */
+export function cassetteFor(name, options = {}) {
+    const dir = options.dir ?? join(process.cwd(), "test", "cassettes");
+    const safe = [...name].map((c) => (/[A-Za-z0-9\-_.]/.test(c) ? c : "_")).join("");
+    const path = join(dir, `${safe}.jevl`);
+    mkdirSync(dirname(path), { recursive: true });
+    return new Cassette(path, {
+        systemOne: options.systemOne,
+        model: options.model,
+        mode: options.mode ?? modeFromEnv(),
+    });
+}
+//# sourceMappingURL=fixture.js.map

package/dist/fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAqC,MAAM,eAAe,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC9D,IAAI,GAAG,CAAC,cAAc,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzC,IAAI,GAAG,CAAC,YAAY,CAAC;QAAE,OAAO,MAAM,CAAC;IACrC,OAAO,QAAQ,CAAC;AAClB,CAAC;AASD;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,UAA8B,EAAE;IACxE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IACvC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE;KACpC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Record and replay TypeSafe Jev requests in vitest.
+ *
+ * Cassettes are `.jevl` files, the same format the drift, bench and calibrate
+ * packages read, so a recording made by your tests doubles as a golden set.
+ */
+export { Cassette, CassetteMiss, ReplayedResponse, type CassetteOptions, type Mode, type SystemOneCallable, } from "./cassette.js";
+export { assertAnswer, assertConfident, describeAnswer, type AssertAnswerOptions, } from "./assertions.js";
+export { cassetteFor, modeFromEnv, type CassetteForOptions } from "./fixture.js";
+export declare const VERSION = "0.1.0";
+//# 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;;;;;GAKG;AAEH,OAAO,EACL,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,IAAI,EACzE,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,KAAK,mBAAmB,GACxE,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEjF,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * Record and replay TypeSafe Jev requests in vitest.
+ *
+ * Cassettes are `.jevl` files, the same format the drift, bench and calibrate
+ * packages read, so a recording made by your tests doubles as a golden set.
+ */
+export { Cassette, CassetteMiss, ReplayedResponse, } from "./cassette.js";
+export { assertAnswer, assertConfident, describeAnswer, } from "./assertions.js";
+export { cassetteFor, modeFromEnv } from "./fixture.js";
+export const VERSION = "0.1.0";
+//# 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;;;;;GAKG;AAEH,OAAO,EACL,QAAQ,EAAE,YAAY,EAAE,gBAAgB,GAEzC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,EAAE,eAAe,EAAE,cAAc,GAC9C,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,WAAW,EAA2B,MAAM,cAAc,CAAC;AAEjF,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "jevkit-vitest",
+  "version": "0.1.0",
+  "description": "Record and replay TypeSafe Jev requests in vitest. Cassettes are .jevl files, so a test recording doubles as a drift golden set.",
+  "keywords": [
+    "jev",
+    "typesafe",
+    "system-one",
+    "vitest",
+    "testing",
+    "cassette",
+    "vcr"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pjdurden/jevkit-js.git"
+  },
+  "dependencies": {
+    "jevkit-core": "^0.2.0"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
+}