llm-mock-server 1.0.5 → 1.0.7

package/dist/sse-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse-writer.d.ts","sourceRoot":"","sources":["../src/sse-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAa/C,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,SAAS,QAAQ,EAAE,EAC3B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAef"}
+{"version":3,"file":"sse-writer.d.ts","sourceRoot":"","sources":["../src/sse-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAarD,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,SAAS,QAAQ,EAAE,EAC3B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/types/reply.d.ts

@@ -1,13 +1,28 @@
 import type { MockRequest } from "./request.js";
 /** A reply is either a plain string (turns into `{ text: "..." }`) or a full reply object. */
 export type Reply = string | ReplyObject;
-/** A structured reply. Text, reasoning, tool calls, usage, and errors are all optional. */
+/**
+ * A structured reply. Text, reasoning, tool calls, usage, and errors are all optional.
+ *
+ * @example
+ * ```ts
+ * server.when("hello").reply({ text: "Hi!", reasoning: "Simple greeting." });
+ * server.when("weather").reply({
+ *   tools: [{ name: "get_weather", args: { city: "London" } }],
+ * });
+ * ```
+ */
 export interface ReplyObject {
+    /** Text content to send back. */
     readonly text?: string | undefined;
     /** Extended thinking or chain-of-thought. Works with Anthropic and Responses formats. */
     readonly reasoning?: string | undefined;
+    /** Tool calls the model wants to make. */
     readonly tools?: readonly ToolCall[] | undefined;
-    /** Falls back to `{ input: 10, output: 5 }` if omitted. */
+    /**
+     * Token counts to report.
+     * @defaultValue `{ input: 10, output: 5 }`
+     */
     readonly usage?: {
         readonly input: number;
         readonly output: number;
@@ -17,27 +32,55 @@ export interface ReplyObject {
 }
 /** An HTTP error response. The server returns this status code with a format-appropriate body. */
 export interface ErrorReply {
+    /** HTTP status code, e.g. `429` or `500`. */
     readonly status: number;
+    /** Error message in the response body. */
     readonly message: string;
-    /** Each format has its own default if omitted. */
+    /**
+     * Error type string in the response body.
+     * @defaultValue Format-specific (e.g. `"server_error"` for OpenAI, `"api_error"` for Anthropic).
+     */
     readonly type?: string | undefined;
 }
+/** A tool call in the mock response. */
 export interface ToolCall {
-    /** Auto-generated if omitted. */
+    /** Explicit ID for the call. Auto-generated if omitted. */
     readonly id?: string | undefined;
+    /** Tool function name. */
     readonly name: string;
+    /** Arguments to pass to the tool. */
     readonly args: Readonly<Record<string, unknown>>;
 }
-/** A reply value or a function that produces one. Async functions are supported. */
+/**
+ * A reply value or a function that produces one. Async functions are supported.
+ *
+ * @example
+ * ```ts
+ * server.when("echo").reply((req) => `You said: ${req.lastMessage}`);
+ * server.when("slow").reply(async (req) => {
+ *   return { text: "Done thinking." };
+ * });
+ * ```
+ */
 export type Resolver = Reply | ((req: MockRequest) => Reply | Promise<Reply>);
 /** Per-rule streaming options. Merged with server-level defaults, with per-rule values winning. */
 export interface ReplyOptions {
-    /** Milliseconds between SSE chunks. */
+    /** Milliseconds to wait between SSE chunks. */
     readonly latency?: number | undefined;
-    /** Characters per SSE chunk for more realistic streaming. */
+    /** Split text into chunks of this many characters for more realistic streaming. */
     readonly chunkSize?: number | undefined;
 }
-/** A single entry in a reply sequence. Can be a plain reply or a reply with per-step options. */
+/**
+ * A single entry in a reply sequence. Can be a plain reply or a reply with per-step options.
+ *
+ * @example
+ * ```ts
+ * server.when("step").replySequence([
+ *   "Starting.",
+ *   { reply: "Done.", options: { latency: 100 } },
+ * ]);
+ * ```
+ */
 export type SequenceEntry = Reply | {
     readonly reply: Reply;
     readonly options?: ReplyOptions;

package/dist/types/reply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reply.d.ts","sourceRoot":"","sources":["../../src/types/reply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,8FAA8F;AAC9F,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,WAAW,CAAC;AAEzC,2FAA2F;AAC3F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,yFAAyF;IACzF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,CAAC;IACjD,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACjF,oFAAoF;IACpF,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACzC;AAED,kGAAkG;AAClG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED,oFAAoF;AACpF,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,WAAW,KAAK,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAE9E,mGAAmG;AACnG,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,iGAAiG;AACjG,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC"}
+{"version":3,"file":"reply.d.ts","sourceRoot":"","sources":["../../src/types/reply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,8FAA8F;AAC9F,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,WAAW,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,yFAAyF;IACzF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EACX;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACnD,SAAS,CAAC;IACd,oFAAoF;IACpF,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACzC;AAED,kGAAkG;AAClG,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,WAAW,KAAK,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAE9E,mGAAmG;AACnG,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GACrB,KAAK,GACL;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC"}

package/dist/types/request.d.ts

@@ -1,39 +1,54 @@
 /** The LLM API wire format that was detected for a request. */
 export type FormatName = "openai" | "anthropic" | "responses";
-/** A normalised view of an incoming request, regardless of the original wire format. */
+/**
+ * A normalised view of an incoming request, regardless of the original wire format.
+ * This is what rule matchers and resolvers receive.
+ */
 export interface MockRequest {
+    /** Which API format route the request came in on. */
     readonly format: FormatName;
+    /** The model string from the request, e.g. `"gpt-5.4"` or `"claude-sonnet-4-6"`. */
     readonly model: string;
+    /**
+     * Whether the client asked for SSE streaming (from the `stream` field).
+     * @defaultValue `true`
+     */
     readonly streaming: boolean;
     /** Full conversation, normalised from whatever format came in. */
     readonly messages: readonly Message[];
     /** The last user message's text. This is what most matchers check. */
     readonly lastMessage: string;
-    /** Empty string if there wasn't one. */
+    /** System prompt text, or empty string if there wasn't one. */
     readonly systemMessage: string;
+    /** Tool definitions from the request, if any were sent. */
     readonly tools?: readonly ToolDef[] | undefined;
-    /** Pulled out from `tools` for quick lookups. */
+    /** Tool names pulled out from `tools` for quick lookups via `whenTool()`. */
     readonly toolNames: readonly string[];
-    /** Set when the last message was a tool result. */
+    /** Set when the last message was a tool result. Used by `whenToolResult()`. */
     readonly lastToolCallId: string | undefined;
     /** The raw request body, for anything we don't extract. */
     readonly raw: unknown;
+    /** HTTP headers from the incoming request. */
     readonly headers: Readonly<Record<string, string | undefined>>;
-    /** e.g. `/v1/chat/completions` */
+    /** The URL path that was hit, e.g. `/v1/chat/completions`. */
     readonly path: string;
 }
 /** A single conversation message, normalised across all supported formats. */
 export interface Message {
+    /** The role of the message sender. */
     readonly role: "system" | "user" | "assistant" | "tool";
+    /** The text content of the message. */
     readonly content: string;
     /** Links the result back to its tool call. Only set on `"tool"` messages. */
     readonly toolCallId?: string | undefined;
 }
 /** A tool definition from the request's `tools` array, normalised across formats. */
 export interface ToolDef {
+    /** The tool function name. */
     readonly name: string;
+    /** A description of what the tool does. */
     readonly description?: string | undefined;
-    /** JSON Schema, passed through as-is. */
+    /** JSON Schema for the tool's parameters, passed through as-is. */
     readonly parameters?: unknown;
 }
 //# sourceMappingURL=request.d.ts.map

package/dist/types/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/types/request.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAE9D,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,wCAAwC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IAChD,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,mDAAmD;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC/D,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,8EAA8E;AAC9E,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,qFAAqF;AACrF,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,yCAAyC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/types/request.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IAChD,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC/D,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,8EAA8E;AAC9E,MAAM,WAAW,OAAO;IACtB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACxD,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,qFAAqF;AACrF,MAAM,WAAW,OAAO;IACtB,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B"}

package/dist/types/rule.d.ts

@@ -7,44 +7,102 @@ import type { Resolver, ReplyOptions, Reply, SequenceEntry } from "./reply.js";
  * A `RegExp` gets tested against the last user message.
  * A `MatchObject` checks multiple fields at once with AND logic.
  * A function receives the normalised request and returns a boolean.
+ *
+ * @example
+ * ```ts
+ * server.when("hello").reply("Hi!");
+ * server.when(/explain (\w+)/i).reply("Here's an explanation.");
+ * server.when({ model: /claude/, format: "anthropic" }).reply("Bonjour!");
+ * server.when((req) => req.messages.length > 5).reply("Long conversation!");
+ * ```
  */
 export type Match = string | RegExp | MatchObject | ((req: MockRequest) => boolean);
-/** A structured matcher. Every field you set must match for the rule to fire. */
+/**
+ * A structured matcher. Every field you set must match for the rule to fire.
+ *
+ * @example
+ * ```ts
+ * server.when({
+ *   model: /gpt/,
+ *   format: "openai",
+ *   system: /translator/i,
+ *   predicate: (req) => req.messages.length > 2,
+ * }).reply("Translated output.");
+ * ```
+ */
 export interface MatchObject {
+    /** Substring or regex against the last user message. */
     readonly message?: string | RegExp;
+    /** Substring or regex against the model name. */
     readonly model?: string | RegExp;
+    /** Substring or regex against the system prompt. */
     readonly system?: string | RegExp;
+    /** Only match requests from this API format. */
     readonly format?: FormatName;
     /** Match when the request includes a tool definition with this name. */
     readonly toolName?: string;
     /** Match when the last tool-result message has this `tool_call_id`. */
     readonly toolCallId?: string;
-    /** Extra check that runs after all other fields pass. */
+    /** Extra predicate that runs after all other fields pass. */
     readonly predicate?: (req: MockRequest) => boolean;
 }
-/** Returned by `when()`. Call `.reply()` or `.replySequence()` on it to complete the rule. */
+/**
+ * Returned by `when()`. Call `.reply()` or `.replySequence()` on it to complete the rule.
+ *
+ * @example
+ * ```ts
+ * server.when("hello").reply("Hi!");
+ * server.when("step").replySequence(["First.", "Second.", "Done."]);
+ * ```
+ */
 export interface PendingRule {
+    /** Set the response for this rule. Accepts a static value, object, or resolver function. */
     reply(response: Resolver, options?: ReplyOptions): RuleHandle;
-    /** Each match advances through the array. The last entry repeats once exhausted. */
+    /** Set a sequence of replies. Each match advances through the array. */
     replySequence(entries: readonly SequenceEntry[]): RuleHandle;
 }
-/** A handle to a registered rule. All methods return `this` for chaining. */
+/**
+ * A handle to a registered rule. All methods return `this` for chaining.
+ *
+ * @example
+ * ```ts
+ * server.when("hello").reply("Hi!").times(3);
+ * server.when("urgent").reply("On it!").first();
+ * ```
+ */
 export interface RuleHandle {
+    /** Auto-expire the rule after `n` matches. */
     times(n: number): RuleHandle;
+    /** Move this rule to the front of the list so it matches first. */
     first(): RuleHandle;
 }
 /**
  * The shape of a handler file's default export.
  * You can export a single handler or an array of them.
+ *
+ * @example
+ * ```ts
+ * import type { Handler } from "llm-mock-server";
+ * export default {
+ *   match: (req) => req.lastMessage.includes("echo"),
+ *   respond: (req) => `Echo: ${req.lastMessage}`,
+ * } satisfies Handler;
+ * ```
  */
 export interface Handler {
+    /** Return `true` if this handler should respond to the request. */
     match: (req: MockRequest) => boolean;
+    /** Produce the reply for a matched request. Can be async. */
     respond: (req: MockRequest) => Reply | Promise<Reply>;
 }
-/** A summary of a registered rule, for inspection. */
+/** A summary of a registered rule, for inspection via `server.rules`. */
 export interface RuleSummary {
+    /** Human-readable description of what the rule matches. */
     readonly description: string;
-    /** `Infinity` means unlimited. */
+    /**
+     * How many matches are left.
+     * @defaultValue `Infinity` (unlimited)
+     */
     readonly remaining: number;
 }
 export interface Rule {

package/dist/types/rule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../src/types/rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,MAAM,KAAK,GACb,MAAM,GACN,MAAM,GACN,WAAW,GACX,CAAC,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC;AAEpC,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC;CACpD;AAED,8FAA8F;AAC9F,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IAC9D,oFAAoF;IACpF,aAAa,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,UAAU,CAAC;CAC9D;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,KAAK,IAAI,UAAU,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC;IACrC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACvD;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC;IAC9C,OAAO,EAAE,QAAQ,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../src/types/rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,KAAK,GACb,MAAM,GACN,MAAM,GACN,WAAW,GACX,CAAC,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC;AAEpC;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC;CACpD;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,4FAA4F;IAC5F,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IAC9D,wEAAwE;IACxE,aAAa,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,UAAU,CAAC;CAC9D;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,mEAAmE;IACnE,KAAK,IAAI,UAAU,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,OAAO;IACtB,mEAAmE;IACnE,KAAK,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC;IACrC,6DAA6D;IAC7D,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACvD;AAED,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC;IAC9C,OAAO,EAAE,QAAQ,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export type { FormatName, MockRequest, Message, ToolDef } from "./types/request.js";
-export type { Reply, ReplyObject, ErrorReply, ToolCall, Resolver, ReplyOptions, SequenceEntry } from "./types/reply.js";
-export type { Match, MatchObject, PendingRule, RuleHandle, RuleSummary, Handler, Rule } from "./types/rule.js";
+export type { FormatName, MockRequest, Message, ToolDef, } from "./types/request.js";
+export type { Reply, ReplyObject, ErrorReply, ToolCall, Resolver, ReplyOptions, SequenceEntry, } from "./types/reply.js";
+export type { Match, MatchObject, PendingRule, RuleHandle, RuleSummary, Handler, Rule, } from "./types/rule.js";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpF,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACxH,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,WAAW,EACX,OAAO,EACP,OAAO,GACR,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,KAAK,EACL,WAAW,EACX,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,KAAK,EACL,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,OAAO,EACP,IAAI,GACL,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-mock-server",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "A standalone mock LLM server for deterministic testing: OpenAI, Anthropic, and Responses API formats",
   "type": "module",
   "engines": {
@@ -15,6 +15,15 @@
     },
     "./package.json": "./package.json"
   },
+  "imports": {
+    "#/*": {
+      "llm-mock-server-dev": "./src/*",
+      "default": "./dist/*"
+    }
+  },
+  "files": [
+    "dist"
+  ],
   "bin": {
     "llm-mock-server": "./dist/cli/cli.js"
   },
@@ -28,7 +37,7 @@
     "check": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json && npm run fmt:check && npm run lint && npm test",
     "docs": "typedoc",
     "docs:check": "typedoc --emit none",
-    "dev": "tsx src/cli/cli.ts",
+    "dev": "tsx -C llm-mock-server-dev src/cli/cli.ts",
     "start": "node dist/cli/cli.js"
   },
   "keywords": [
@@ -43,21 +52,21 @@
   "license": "MIT",
   "dependencies": {
     "commander": "14.0.3",
-    "fastify": "5.8.2",
+    "fastify": "5.8.4",
     "json5": "2.2.3",
-    "llm-schemas": "1.0.1",
+    "llm-schemas": "1.0.3",
     "picocolors": "1.1.1",
     "zod": "4.3.6"
   },
   "devDependencies": {
-    "@types/node": "25.5.0",
-    "@vitest/coverage-v8": "4.1.0",
-    "oxfmt": "0.40.0",
-    "oxlint": "1.55.0",
+    "@types/node": "25.5.2",
+    "@vitest/coverage-v8": "4.1.4",
+    "oxfmt": "0.44.0",
+    "oxlint": "1.59.0",
     "tsx": "4.21.0",
-    "typedoc": "0.28.17",
+    "typedoc": "0.28.18",
     "typedoc-theme-oxide": "0.2.5",
-    "typescript": "5.9.3",
-    "vitest": "4.1.0"
+    "typescript": "6.0.2",
+    "vitest": "4.1.4"
   }
 }