phantomllm 0.1.0 → 0.3.0

package/README.md

@@ -32,6 +32,7 @@ await mock.stop();
   - [Streaming](#streaming)
   - [Embeddings](#embeddings)
   - [Error Simulation](#error-simulation)
+  - [API Key Validation](#api-key-validation)
   - [Stub Matching](#stub-matching)
 - [Integration Examples](#integration-examples)
   - [OpenAI Node.js SDK](#openai-nodejs-sdk)
@@ -56,7 +57,7 @@ await mock.stop();
 - **Works with any client** — OpenAI SDK, Vercel AI SDK, LangChain, opencode, Python, curl — anything that speaks the OpenAI API protocol.
 - **Streaming support** — SSE chunked responses work exactly like the real OpenAI API.
 - **Fast** — ~1s container cold start, sub-millisecond response latency, 4,000+ req/s throughput.
-- **Simple API** — fluent `given/when` pattern: `mock.given.chatCompletion.forModel('gpt-4').willReturn('Hello')`.
+- **Simple API** — fluent `given`/`require` pattern: `mock.given.chatCompletion.forModel('gpt-4').willReturn('Hello')`.
 
 ## Prerequisites
 
@@ -151,8 +152,9 @@ const mock = new MockLLM({
 | `await mock.stop()` | `void` | Stop and remove the container. Idempotent. |
 | `mock.baseUrl` | `string` | Server URL without `/v1`, e.g. `http://localhost:55123`. |
 | `mock.apiBaseUrl` | `string` | Server URL with `/v1`, e.g. `http://localhost:55123/v1`. Pass this to SDK clients. |
-| `mock.given` | `GivenStubs` | Entry point for the fluent stubbing API. |
-| `await mock.clear()` | `void` | Remove all registered stubs. Call between tests. |
+| `mock.given` | `GivenStubs` | Entry point for stubbing responses. |
+| `mock.expect` | `ExpectConditions` | Entry point for configuring server behavior (API key validation, etc.). |
+| `await mock.clear()` | `void` | Remove all stubs and reset server config (including API key). Call between tests. |
 
 `MockLLM` implements `Symbol.asyncDispose` for automatic cleanup:
 
@@ -262,6 +264,53 @@ Error responses follow the OpenAI error format:
 }
 ```
 
+### API Key Validation
+
+Test that your code sends the correct API key by requiring authentication on the mock server.
+
+```typescript
+mock.expect.apiKey('sk-test-key-123');
+
+// Requests without a key or with the wrong key get 401
+// { error: { message: "...", type: "authentication_error", code: "invalid_api_key" } }
+
+// Only requests with the correct key succeed
+const openai = new OpenAI({
+  baseURL: mock.apiBaseUrl,
+  apiKey: 'sk-test-key-123', // must match exactly
+});
+```
+
+`mock.expect` configures server constraints at runtime — no container restart needed. API key validation applies to all `/v1/*` endpoints (chat completions, embeddings, models). Admin endpoints (`/_admin/*`) are always accessible.
+
+Calling `mock.clear()` resets the API key requirement along with all stubs.
+
+| Method | Description |
+|---|---|
+| `mock.expect.apiKey(key)` | Require `Authorization: Bearer <key>` on all `/v1/*` requests. Single call, no chaining needed. |
+
+**Testing auth error handling:**
+
+```typescript
+it('handles invalid API key', async () => {
+  mock.expect.apiKey('correct-key');
+  mock.given.chatCompletion.willReturn('Hello');
+
+  // Client configured with wrong key
+  const badClient = new OpenAI({
+    baseURL: mock.apiBaseUrl,
+    apiKey: 'wrong-key',
+  });
+
+  await expect(
+    badClient.chat.completions.create({
+      model: 'gpt-4o',
+      messages: [{ role: 'user', content: 'Hi' }],
+    }),
+  ).rejects.toThrow();
+});
+```
+
 ### Stub Matching
 
 When multiple stubs are registered, the most specific match wins:

package/dist/index.cjs

@@ -19,10 +19,10 @@ var ContainerManager = class {
   }
   container = null;
   async start() {
-    const container = new testcontainers.GenericContainer(this.config.image).withExposedPorts(this.config.containerPort).withWaitStrategy(
+    const builder = new testcontainers.GenericContainer(this.config.image).withExposedPorts(this.config.containerPort).withWaitStrategy(
       testcontainers.Wait.forHttp("/_admin/health", this.config.containerPort).forStatusCode(200)
     ).withStartupTimeout(this.config.startupTimeout).withLabels({ "com.phantomllm": "true" });
-    this.container = await container.start();
+    this.container = await builder.start();
     return {
       host: this.container.getHost(),
       port: this.container.getMappedPort(this.config.containerPort)
@@ -83,13 +83,24 @@ var AdminClient = class {
     this.baseUrl = baseUrl;
   }
   pendingStubs = [];
+  pendingConfigs = [];
   enqueueStub(stub) {
     this.pendingStubs.push(stub);
   }
+  enqueueConfig(config) {
+    this.pendingConfigs.push(config);
+  }
   async flush() {
-    if (this.pendingStubs.length === 0) return;
-    const stubs = this.pendingStubs.splice(0);
-    await this.post("/_admin/stubs/batch", { stubs });
+    if (this.pendingConfigs.length > 0) {
+      const configs = this.pendingConfigs.splice(0);
+      for (const config of configs) {
+        await this.post("/_admin/config", config);
+      }
+    }
+    if (this.pendingStubs.length > 0) {
+      const stubs = this.pendingStubs.splice(0);
+      await this.post("/_admin/stubs/batch", { stubs });
+    }
   }
   async clearStubs() {
     await this.flush();
@@ -242,6 +253,16 @@ var GivenStubs = class {
   }
 };
 
+// src/stubs/expect.ts
+var ExpectConditions = class {
+  constructor(adminClient) {
+    this.adminClient = adminClient;
+  }
+  apiKey(key) {
+    this.adminClient.enqueueConfig({ apiKey: key });
+  }
+};
+
 // src/errors/lifecycle.errors.ts
 var ContainerNotStartedError = class extends MockLLMError {
   code = "CONTAINER_NOT_STARTED";
@@ -260,6 +281,7 @@ var MockLLM = class {
   containerManager;
   adminClient = null;
   _given = null;
+  _expect = null;
   _baseUrl = null;
   constructor(options) {
     const config = resolveContainerConfig(options);
@@ -277,6 +299,7 @@ var MockLLM = class {
     this._baseUrl = `http://${host}:${port}`;
     this.adminClient = new AdminClient(this._baseUrl);
     this._given = new GivenStubs(this.adminClient);
+    this._expect = new ExpectConditions(this.adminClient);
     this.state = "running";
   }
   async stop() {
@@ -288,6 +311,7 @@ var MockLLM = class {
       this.state = "stopped";
       this.adminClient = null;
       this._given = null;
+      this._expect = null;
       this._baseUrl = null;
     }
   }
@@ -302,6 +326,10 @@ var MockLLM = class {
     this.assertRunning();
     return this._given;
   }
+  get expect() {
+    this.assertRunning();
+    return this._expect;
+  }
   async clear() {
     this.assertRunning();
     await this.adminClient.clearStubs();

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/driver/container.config.ts","../src/driver/container.manager.ts","../src/errors/base.ts","../src/errors/admin.errors.ts","../src/driver/admin.client.ts","../src/stubs/chat.builder.ts","../src/stubs/embedding.builder.ts","../src/stubs/models.builder.ts","../src/stubs/given.ts","../src/errors/lifecycle.errors.ts","../src/driver/mock-llm.ts","../src/errors/stub.errors.ts"],"names":["GenericContainer","Wait"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { MockLLMOptions, ContainerConfig } from \"../types/config.js\";\n\nconst DEFAULT_IMAGE = \"phantomllm-server:latest\";\nconst DEFAULT_PORT = 8080;\n\nexport function resolveContainerConfig(options?: MockLLMOptions): ContainerConfig {\n  return {\n    image: options?.image ?? process.env[\"PHANTOMLLM_IMAGE\"] ?? DEFAULT_IMAGE,\n    containerPort: options?.containerPort ?? DEFAULT_PORT,\n    reuse: options?.reuse ?? true,\n    startupTimeout: options?.startupTimeout ?? 30_000,\n  };\n}\n","import { GenericContainer, Wait } from \"testcontainers\";\nimport type { StartedTestContainer } from \"testcontainers\";\nimport type { ContainerConfig } from \"../types/config.js\";\n\nexport class ContainerManager {\n  private container: StartedTestContainer | null = null;\n\n  constructor(private readonly config: ContainerConfig) {}\n\n  async start(): Promise<{ host: string; port: number }> {\n    const container = new GenericContainer(this.config.image)\n      .withExposedPorts(this.config.containerPort)\n      .withWaitStrategy(\n        Wait.forHttp(\"/_admin/health\", this.config.containerPort)\n          .forStatusCode(200),\n      )\n      .withStartupTimeout(this.config.startupTimeout)\n      .withLabels({ \"com.phantomllm\": \"true\" });\n\n    this.container = await container.start();\n\n    return {\n      host: this.container.getHost(),\n      port: this.container.getMappedPort(this.config.containerPort),\n    };\n  }\n\n  async stop(): Promise<void> {\n    if (this.container) {\n      await this.container.stop();\n      this.container = null;\n    }\n  }\n}\n","export abstract class MockLLMError extends Error {\n  abstract readonly code: string;\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = this.constructor.name;\n  }\n}\n","import { MockLLMError } from './base.js';\n\nexport class AdminAPIError extends MockLLMError {\n  readonly code = 'ADMIN_API_ERROR' as const;\n  constructor(\n    public readonly statusCode: number,\n    public readonly responseBody: string,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Admin API returned HTTP ${statusCode}: ${responseBody}`,\n      options,\n    );\n  }\n}\n\nexport class AdminConnectionRefusedError extends MockLLMError {\n  readonly code = 'ADMIN_CONNECTION_REFUSED' as const;\n  constructor(options?: { cause?: unknown }) {\n    super(\n      'Cannot connect to MockLLM admin API. The container may have crashed.',\n      options,\n    );\n  }\n}\n\nexport class AdminTimeoutError extends MockLLMError {\n  readonly code = 'ADMIN_TIMEOUT' as const;\n  constructor(\n    public readonly timeoutMs: number,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Admin API did not respond within ${timeoutMs}ms.`,\n      options,\n    );\n  }\n}\n","import {\n  AdminConnectionRefusedError,\n  AdminTimeoutError,\n  AdminAPIError,\n} from \"../errors/admin.errors.js\";\nimport type {\n  AdminStubDefinition,\n  AdminHealthPayload,\n  AdminRecordedRequestPayload,\n} from \"./admin.client.types.js\";\n\nconst REQUEST_TIMEOUT_MS = 5_000;\n\nexport class AdminClient {\n  private pendingStubs: AdminStubDefinition[] = [];\n\n  constructor(private readonly baseUrl: string) {}\n\n  enqueueStub(stub: AdminStubDefinition): void {\n    this.pendingStubs.push(stub);\n  }\n\n  async flush(): Promise<void> {\n    if (this.pendingStubs.length === 0) return;\n    const stubs = this.pendingStubs.splice(0);\n    await this.post(\"/_admin/stubs/batch\", { stubs });\n  }\n\n  async clearStubs(): Promise<void> {\n    await this.flush();\n    await this.delete(\"/_admin/stubs\");\n  }\n\n  async getHealth(): Promise<AdminHealthPayload> {\n    return this.get<AdminHealthPayload>(\"/_admin/health\");\n  }\n\n  async getRequests(): Promise<AdminRecordedRequestPayload[\"requests\"]> {\n    await this.flush();\n    const data = await this.get<AdminRecordedRequestPayload>(\"/_admin/requests\");\n    return data.requests;\n  }\n\n  private async get<T>(path: string): Promise<T> {\n    const response = await this.fetch(path, { method: \"GET\" });\n    return (await response.json()) as T;\n  }\n\n  private async post<T>(path: string, body: unknown): Promise<T> {\n    const response = await this.fetch(path, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    });\n    return (await response.json()) as T;\n  }\n\n  private async delete(path: string): Promise<void> {\n    await this.fetch(path, { method: \"DELETE\" });\n  }\n\n  private async fetch(path: string, init: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    let response: Response;\n\n    try {\n      response = await fetch(url, {\n        ...init,\n        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),\n      });\n    } catch (error: unknown) {\n      if (error instanceof TypeError) {\n        const cause = error.cause as { code?: string } | undefined;\n        if (cause?.code === \"ECONNREFUSED\") {\n          throw new AdminConnectionRefusedError({ cause: error });\n        }\n      }\n      if (error instanceof DOMException && error.name === \"TimeoutError\") {\n        throw new AdminTimeoutError(REQUEST_TIMEOUT_MS, { cause: error });\n      }\n      throw error;\n    }\n\n    if (!response.ok) {\n      const body = await response.text();\n      throw new AdminAPIError(response.status, body);\n    }\n\n    return response;\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\nimport type { AdminStubMatcher } from \"../driver/admin.client.types.js\";\n\nexport class ChatCompletionStubBuilder {\n  private readonly matcher: AdminStubMatcher = { endpoint: \"chat\" };\n\n  constructor(private readonly adminClient: AdminClient) {}\n\n  forModel(model: string): this {\n    this.matcher.model = model;\n    return this;\n  }\n\n  withMessageContaining(substring: string): this {\n    this.matcher.content = substring;\n    return this;\n  }\n\n  willReturn(content: string): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: { type: \"chat\", body: content },\n    });\n  }\n\n  willStream(chunks: string[]): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: { type: \"streaming-chat\", chunks },\n    });\n  }\n\n  willError(statusCode: number, message: string): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: {\n        type: \"error\",\n        status: statusCode,\n        error: { message, type: \"api_error\", code: null },\n      },\n    });\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\nimport type { AdminStubMatcher } from \"../driver/admin.client.types.js\";\n\nexport class EmbeddingStubBuilder {\n  private readonly matcher: AdminStubMatcher = { endpoint: \"embeddings\" };\n\n  constructor(private readonly adminClient: AdminClient) {}\n\n  forModel(model: string): this {\n    this.matcher.model = model;\n    return this;\n  }\n\n  willReturn(vector: number[] | number[][]): void {\n    const vectors = Array.isArray(vector[0])\n      ? (vector as number[][])\n      : [vector as number[]];\n\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: { type: \"embedding\", vectors },\n    });\n  }\n\n  willError(statusCode: number, message: string): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: {\n        type: \"error\",\n        status: statusCode,\n        error: { message, type: \"api_error\", code: null },\n      },\n    });\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\n\nexport class ModelsStubBuilder {\n  constructor(private readonly adminClient: AdminClient) {}\n\n  willReturn(models: Array<{ id: string; ownedBy?: string }>): void {\n    this.adminClient.enqueueStub({\n      matcher: {},\n      response: { type: \"models\", models },\n    });\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\nimport { ChatCompletionStubBuilder } from \"./chat.builder.js\";\nimport { EmbeddingStubBuilder } from \"./embedding.builder.js\";\nimport { ModelsStubBuilder } from \"./models.builder.js\";\n\nexport class GivenStubs {\n  constructor(private readonly adminClient: AdminClient) {}\n\n  get chatCompletion(): ChatCompletionStubBuilder {\n    return new ChatCompletionStubBuilder(this.adminClient);\n  }\n\n  get embedding(): EmbeddingStubBuilder {\n    return new EmbeddingStubBuilder(this.adminClient);\n  }\n\n  get models(): ModelsStubBuilder {\n    return new ModelsStubBuilder(this.adminClient);\n  }\n}\n","import { MockLLMError } from './base.js';\n\nexport class ContainerNotStartedError extends MockLLMError {\n  readonly code = 'CONTAINER_NOT_STARTED' as const;\n  constructor(options?: { cause?: unknown }) {\n    super(\n      'MockLLM container is not running. Call `await mock.start()` before configuring stubs.',\n      options,\n    );\n  }\n}\n\nexport class ContainerAlreadyStartedError extends MockLLMError {\n  readonly code = 'CONTAINER_ALREADY_STARTED' as const;\n  constructor(options?: { cause?: unknown }) {\n    super(\n      'MockLLM container is already running. Call `await mock.stop()` first if you need to restart.',\n      options,\n    );\n  }\n}\n","import type { MockLLMOptions } from \"../types/config.js\";\nimport { resolveContainerConfig } from \"./container.config.js\";\nimport { ContainerManager } from \"./container.manager.js\";\nimport { AdminClient } from \"./admin.client.js\";\nimport { GivenStubs } from \"../stubs/given.js\";\nimport { ContainerNotStartedError } from \"../errors/lifecycle.errors.js\";\n\ntype MockLLMState = \"idle\" | \"starting\" | \"running\" | \"stopping\" | \"stopped\";\n\nexport class MockLLM {\n  private state: MockLLMState = \"idle\";\n  private startPromise: Promise<void> | null = null;\n  private containerManager: ContainerManager;\n  private adminClient: AdminClient | null = null;\n  private _given: GivenStubs | null = null;\n  private _baseUrl: string | null = null;\n\n  constructor(options?: MockLLMOptions) {\n    const config = resolveContainerConfig(options);\n    this.containerManager = new ContainerManager(config);\n  }\n\n  async start(): Promise<void> {\n    if (this.state === \"running\") return;\n    if (this.state === \"starting\" && this.startPromise) return this.startPromise;\n\n    this.state = \"starting\";\n    this.startPromise = this.doStart();\n    return this.startPromise;\n  }\n\n  private async doStart(): Promise<void> {\n    const { host, port } = await this.containerManager.start();\n    this._baseUrl = `http://${host}:${port}`;\n    this.adminClient = new AdminClient(this._baseUrl);\n    this._given = new GivenStubs(this.adminClient);\n    this.state = \"running\";\n  }\n\n  async stop(): Promise<void> {\n    if (this.state === \"stopped\" || this.state === \"idle\") return;\n    this.state = \"stopping\";\n    try {\n      await this.containerManager.stop();\n    } finally {\n      this.state = \"stopped\";\n      this.adminClient = null;\n      this._given = null;\n      this._baseUrl = null;\n    }\n  }\n\n  get baseUrl(): string {\n    this.assertRunning();\n    return this._baseUrl!;\n  }\n\n  get apiBaseUrl(): string {\n    return `${this.baseUrl}/v1`;\n  }\n\n  get given(): GivenStubs {\n    this.assertRunning();\n    return this._given!;\n  }\n\n  async clear(): Promise<void> {\n    this.assertRunning();\n    await this.adminClient!.clearStubs();\n  }\n\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.stop();\n  }\n\n  private assertRunning(): void {\n    if (this.state !== \"running\") {\n      throw new ContainerNotStartedError();\n    }\n  }\n}\n","import { MockLLMError } from './base.js';\n\nexport class StubConfigurationError extends MockLLMError {\n  readonly code = 'STUB_CONFIGURATION_INVALID' as const;\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n  }\n}\n"]}
+{"version":3,"sources":["../src/driver/container.config.ts","../src/driver/container.manager.ts","../src/errors/base.ts","../src/errors/admin.errors.ts","../src/driver/admin.client.ts","../src/stubs/chat.builder.ts","../src/stubs/embedding.builder.ts","../src/stubs/models.builder.ts","../src/stubs/given.ts","../src/stubs/expect.ts","../src/errors/lifecycle.errors.ts","../src/driver/mock-llm.ts","../src/errors/stub.errors.ts"],"names":["GenericContainer","Wait"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { MockLLMOptions, ContainerConfig } from \"../types/config.js\";\n\nconst DEFAULT_IMAGE = \"phantomllm-server:latest\";\nconst DEFAULT_PORT = 8080;\n\nexport function resolveContainerConfig(options?: MockLLMOptions): ContainerConfig {\n  return {\n    image: options?.image ?? process.env[\"PHANTOMLLM_IMAGE\"] ?? DEFAULT_IMAGE,\n    containerPort: options?.containerPort ?? DEFAULT_PORT,\n    reuse: options?.reuse ?? true,\n    startupTimeout: options?.startupTimeout ?? 30_000,\n  };\n}\n","import { GenericContainer, Wait } from \"testcontainers\";\nimport type { StartedTestContainer } from \"testcontainers\";\nimport type { ContainerConfig } from \"../types/config.js\";\n\nexport class ContainerManager {\n  private container: StartedTestContainer | null = null;\n\n  constructor(private readonly config: ContainerConfig) {}\n\n  async start(): Promise<{ host: string; port: number }> {\n    const builder = new GenericContainer(this.config.image)\n      .withExposedPorts(this.config.containerPort)\n      .withWaitStrategy(\n        Wait.forHttp(\"/_admin/health\", this.config.containerPort)\n          .forStatusCode(200),\n      )\n      .withStartupTimeout(this.config.startupTimeout)\n      .withLabels({ \"com.phantomllm\": \"true\" });\n\n    this.container = await builder.start();\n\n    return {\n      host: this.container.getHost(),\n      port: this.container.getMappedPort(this.config.containerPort),\n    };\n  }\n\n  async stop(): Promise<void> {\n    if (this.container) {\n      await this.container.stop();\n      this.container = null;\n    }\n  }\n}\n","export abstract class MockLLMError extends Error {\n  abstract readonly code: string;\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = this.constructor.name;\n  }\n}\n","import { MockLLMError } from './base.js';\n\nexport class AdminAPIError extends MockLLMError {\n  readonly code = 'ADMIN_API_ERROR' as const;\n  constructor(\n    public readonly statusCode: number,\n    public readonly responseBody: string,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Admin API returned HTTP ${statusCode}: ${responseBody}`,\n      options,\n    );\n  }\n}\n\nexport class AdminConnectionRefusedError extends MockLLMError {\n  readonly code = 'ADMIN_CONNECTION_REFUSED' as const;\n  constructor(options?: { cause?: unknown }) {\n    super(\n      'Cannot connect to MockLLM admin API. The container may have crashed.',\n      options,\n    );\n  }\n}\n\nexport class AdminTimeoutError extends MockLLMError {\n  readonly code = 'ADMIN_TIMEOUT' as const;\n  constructor(\n    public readonly timeoutMs: number,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Admin API did not respond within ${timeoutMs}ms.`,\n      options,\n    );\n  }\n}\n","import {\n  AdminConnectionRefusedError,\n  AdminTimeoutError,\n  AdminAPIError,\n} from \"../errors/admin.errors.js\";\nimport type {\n  AdminStubDefinition,\n  AdminHealthPayload,\n  AdminRecordedRequestPayload,\n} from \"./admin.client.types.js\";\n\nconst REQUEST_TIMEOUT_MS = 5_000;\n\nexport class AdminClient {\n  private pendingStubs: AdminStubDefinition[] = [];\n  private pendingConfigs: Array<{ apiKey: string }> = [];\n\n  constructor(private readonly baseUrl: string) {}\n\n  enqueueStub(stub: AdminStubDefinition): void {\n    this.pendingStubs.push(stub);\n  }\n\n  enqueueConfig(config: { apiKey: string }): void {\n    this.pendingConfigs.push(config);\n  }\n\n  async flush(): Promise<void> {\n    if (this.pendingConfigs.length > 0) {\n      const configs = this.pendingConfigs.splice(0);\n      for (const config of configs) {\n        await this.post(\"/_admin/config\", config);\n      }\n    }\n\n    if (this.pendingStubs.length > 0) {\n      const stubs = this.pendingStubs.splice(0);\n      await this.post(\"/_admin/stubs/batch\", { stubs });\n    }\n  }\n\n  async clearStubs(): Promise<void> {\n    await this.flush();\n    await this.delete(\"/_admin/stubs\");\n  }\n\n  async getHealth(): Promise<AdminHealthPayload> {\n    return this.get<AdminHealthPayload>(\"/_admin/health\");\n  }\n\n  async getRequests(): Promise<AdminRecordedRequestPayload[\"requests\"]> {\n    await this.flush();\n    const data = await this.get<AdminRecordedRequestPayload>(\"/_admin/requests\");\n    return data.requests;\n  }\n\n  private async get<T>(path: string): Promise<T> {\n    const response = await this.fetch(path, { method: \"GET\" });\n    return (await response.json()) as T;\n  }\n\n  private async post<T>(path: string, body: unknown): Promise<T> {\n    const response = await this.fetch(path, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    });\n    return (await response.json()) as T;\n  }\n\n  private async delete(path: string): Promise<void> {\n    await this.fetch(path, { method: \"DELETE\" });\n  }\n\n  private async fetch(path: string, init: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    let response: Response;\n\n    try {\n      response = await fetch(url, {\n        ...init,\n        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),\n      });\n    } catch (error: unknown) {\n      if (error instanceof TypeError) {\n        const cause = error.cause as { code?: string } | undefined;\n        if (cause?.code === \"ECONNREFUSED\") {\n          throw new AdminConnectionRefusedError({ cause: error });\n        }\n      }\n      if (error instanceof DOMException && error.name === \"TimeoutError\") {\n        throw new AdminTimeoutError(REQUEST_TIMEOUT_MS, { cause: error });\n      }\n      throw error;\n    }\n\n    if (!response.ok) {\n      const body = await response.text();\n      throw new AdminAPIError(response.status, body);\n    }\n\n    return response;\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\nimport type { AdminStubMatcher } from \"../driver/admin.client.types.js\";\n\nexport class ChatCompletionStubBuilder {\n  private readonly matcher: AdminStubMatcher = { endpoint: \"chat\" };\n\n  constructor(private readonly adminClient: AdminClient) {}\n\n  forModel(model: string): this {\n    this.matcher.model = model;\n    return this;\n  }\n\n  withMessageContaining(substring: string): this {\n    this.matcher.content = substring;\n    return this;\n  }\n\n  willReturn(content: string): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: { type: \"chat\", body: content },\n    });\n  }\n\n  willStream(chunks: string[]): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: { type: \"streaming-chat\", chunks },\n    });\n  }\n\n  willError(statusCode: number, message: string): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: {\n        type: \"error\",\n        status: statusCode,\n        error: { message, type: \"api_error\", code: null },\n      },\n    });\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\nimport type { AdminStubMatcher } from \"../driver/admin.client.types.js\";\n\nexport class EmbeddingStubBuilder {\n  private readonly matcher: AdminStubMatcher = { endpoint: \"embeddings\" };\n\n  constructor(private readonly adminClient: AdminClient) {}\n\n  forModel(model: string): this {\n    this.matcher.model = model;\n    return this;\n  }\n\n  willReturn(vector: number[] | number[][]): void {\n    const vectors = Array.isArray(vector[0])\n      ? (vector as number[][])\n      : [vector as number[]];\n\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: { type: \"embedding\", vectors },\n    });\n  }\n\n  willError(statusCode: number, message: string): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: {\n        type: \"error\",\n        status: statusCode,\n        error: { message, type: \"api_error\", code: null },\n      },\n    });\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\n\nexport class ModelsStubBuilder {\n  constructor(private readonly adminClient: AdminClient) {}\n\n  willReturn(models: Array<{ id: string; ownedBy?: string }>): void {\n    this.adminClient.enqueueStub({\n      matcher: {},\n      response: { type: \"models\", models },\n    });\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\nimport { ChatCompletionStubBuilder } from \"./chat.builder.js\";\nimport { EmbeddingStubBuilder } from \"./embedding.builder.js\";\nimport { ModelsStubBuilder } from \"./models.builder.js\";\n\nexport class GivenStubs {\n  constructor(private readonly adminClient: AdminClient) {}\n\n  get chatCompletion(): ChatCompletionStubBuilder {\n    return new ChatCompletionStubBuilder(this.adminClient);\n  }\n\n  get embedding(): EmbeddingStubBuilder {\n    return new EmbeddingStubBuilder(this.adminClient);\n  }\n\n  get models(): ModelsStubBuilder {\n    return new ModelsStubBuilder(this.adminClient);\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\n\nexport class ExpectConditions {\n  constructor(private readonly adminClient: AdminClient) {}\n\n  apiKey(key: string): void {\n    this.adminClient.enqueueConfig({ apiKey: key });\n  }\n}\n","import { MockLLMError } from './base.js';\n\nexport class ContainerNotStartedError extends MockLLMError {\n  readonly code = 'CONTAINER_NOT_STARTED' as const;\n  constructor(options?: { cause?: unknown }) {\n    super(\n      'MockLLM container is not running. Call `await mock.start()` before configuring stubs.',\n      options,\n    );\n  }\n}\n\nexport class ContainerAlreadyStartedError extends MockLLMError {\n  readonly code = 'CONTAINER_ALREADY_STARTED' as const;\n  constructor(options?: { cause?: unknown }) {\n    super(\n      'MockLLM container is already running. Call `await mock.stop()` first if you need to restart.',\n      options,\n    );\n  }\n}\n","import type { MockLLMOptions } from \"../types/config.js\";\nimport { resolveContainerConfig } from \"./container.config.js\";\nimport { ContainerManager } from \"./container.manager.js\";\nimport { AdminClient } from \"./admin.client.js\";\nimport { GivenStubs } from \"../stubs/given.js\";\nimport { ExpectConditions } from \"../stubs/expect.js\";\nimport { ContainerNotStartedError } from \"../errors/lifecycle.errors.js\";\n\ntype MockLLMState = \"idle\" | \"starting\" | \"running\" | \"stopping\" | \"stopped\";\n\nexport class MockLLM {\n  private state: MockLLMState = \"idle\";\n  private startPromise: Promise<void> | null = null;\n  private containerManager: ContainerManager;\n  private adminClient: AdminClient | null = null;\n  private _given: GivenStubs | null = null;\n  private _expect: ExpectConditions | null = null;\n  private _baseUrl: string | null = null;\n\n  constructor(options?: MockLLMOptions) {\n    const config = resolveContainerConfig(options);\n    this.containerManager = new ContainerManager(config);\n  }\n\n  async start(): Promise<void> {\n    if (this.state === \"running\") return;\n    if (this.state === \"starting\" && this.startPromise) return this.startPromise;\n\n    this.state = \"starting\";\n    this.startPromise = this.doStart();\n    return this.startPromise;\n  }\n\n  private async doStart(): Promise<void> {\n    const { host, port } = await this.containerManager.start();\n    this._baseUrl = `http://${host}:${port}`;\n    this.adminClient = new AdminClient(this._baseUrl);\n    this._given = new GivenStubs(this.adminClient);\n    this._expect = new ExpectConditions(this.adminClient);\n    this.state = \"running\";\n  }\n\n  async stop(): Promise<void> {\n    if (this.state === \"stopped\" || this.state === \"idle\") return;\n    this.state = \"stopping\";\n    try {\n      await this.containerManager.stop();\n    } finally {\n      this.state = \"stopped\";\n      this.adminClient = null;\n      this._given = null;\n      this._expect = null;\n      this._baseUrl = null;\n    }\n  }\n\n  get baseUrl(): string {\n    this.assertRunning();\n    return this._baseUrl!;\n  }\n\n  get apiBaseUrl(): string {\n    return `${this.baseUrl}/v1`;\n  }\n\n  get given(): GivenStubs {\n    this.assertRunning();\n    return this._given!;\n  }\n\n  get expect(): ExpectConditions {\n    this.assertRunning();\n    return this._expect!;\n  }\n\n  async clear(): Promise<void> {\n    this.assertRunning();\n    await this.adminClient!.clearStubs();\n  }\n\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.stop();\n  }\n\n  private assertRunning(): void {\n    if (this.state !== \"running\") {\n      throw new ContainerNotStartedError();\n    }\n  }\n}\n","import { MockLLMError } from './base.js';\n\nexport class StubConfigurationError extends MockLLMError {\n  readonly code = 'STUB_CONFIGURATION_INVALID' as const;\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n  }\n}\n"]}

package/dist/index.d.cts

@@ -64,8 +64,12 @@ interface AdminRecordedRequestPayload {
 declare class AdminClient {
     private readonly baseUrl;
     private pendingStubs;
+    private pendingConfigs;
     constructor(baseUrl: string);
     enqueueStub(stub: AdminStubDefinition): void;
+    enqueueConfig(config: {
+        apiKey: string;
+    }): void;
     flush(): Promise<void>;
     clearStubs(): Promise<void>;
     getHealth(): Promise<AdminHealthPayload>;
@@ -113,12 +117,19 @@ declare class GivenStubs {
     get models(): ModelsStubBuilder;
 }
 
+declare class ExpectConditions {
+    private readonly adminClient;
+    constructor(adminClient: AdminClient);
+    apiKey(key: string): void;
+}
+
 declare class MockLLM {
     private state;
     private startPromise;
     private containerManager;
     private adminClient;
     private _given;
+    private _expect;
     private _baseUrl;
     constructor(options?: MockLLMOptions);
     start(): Promise<void>;
@@ -127,6 +138,7 @@ declare class MockLLM {
     get baseUrl(): string;
     get apiBaseUrl(): string;
     get given(): GivenStubs;
+    get expect(): ExpectConditions;
     clear(): Promise<void>;
     [Symbol.asyncDispose](): Promise<void>;
     private assertRunning;

package/dist/index.d.ts

@@ -64,8 +64,12 @@ interface AdminRecordedRequestPayload {
 declare class AdminClient {
     private readonly baseUrl;
     private pendingStubs;
+    private pendingConfigs;
     constructor(baseUrl: string);
     enqueueStub(stub: AdminStubDefinition): void;
+    enqueueConfig(config: {
+        apiKey: string;
+    }): void;
     flush(): Promise<void>;
     clearStubs(): Promise<void>;
     getHealth(): Promise<AdminHealthPayload>;
@@ -113,12 +117,19 @@ declare class GivenStubs {
     get models(): ModelsStubBuilder;
 }
 
+declare class ExpectConditions {
+    private readonly adminClient;
+    constructor(adminClient: AdminClient);
+    apiKey(key: string): void;
+}
+
 declare class MockLLM {
     private state;
     private startPromise;
     private containerManager;
     private adminClient;
     private _given;
+    private _expect;
     private _baseUrl;
     constructor(options?: MockLLMOptions);
     start(): Promise<void>;
@@ -127,6 +138,7 @@ declare class MockLLM {
     get baseUrl(): string;
     get apiBaseUrl(): string;
     get given(): GivenStubs;
+    get expect(): ExpectConditions;
     clear(): Promise<void>;
     [Symbol.asyncDispose](): Promise<void>;
     private assertRunning;

package/dist/index.js

@@ -17,10 +17,10 @@ var ContainerManager = class {
   }
   container = null;
   async start() {
-    const container = new GenericContainer(this.config.image).withExposedPorts(this.config.containerPort).withWaitStrategy(
+    const builder = new GenericContainer(this.config.image).withExposedPorts(this.config.containerPort).withWaitStrategy(
       Wait.forHttp("/_admin/health", this.config.containerPort).forStatusCode(200)
     ).withStartupTimeout(this.config.startupTimeout).withLabels({ "com.phantomllm": "true" });
-    this.container = await container.start();
+    this.container = await builder.start();
     return {
       host: this.container.getHost(),
       port: this.container.getMappedPort(this.config.containerPort)
@@ -81,13 +81,24 @@ var AdminClient = class {
     this.baseUrl = baseUrl;
   }
   pendingStubs = [];
+  pendingConfigs = [];
   enqueueStub(stub) {
     this.pendingStubs.push(stub);
   }
+  enqueueConfig(config) {
+    this.pendingConfigs.push(config);
+  }
   async flush() {
-    if (this.pendingStubs.length === 0) return;
-    const stubs = this.pendingStubs.splice(0);
-    await this.post("/_admin/stubs/batch", { stubs });
+    if (this.pendingConfigs.length > 0) {
+      const configs = this.pendingConfigs.splice(0);
+      for (const config of configs) {
+        await this.post("/_admin/config", config);
+      }
+    }
+    if (this.pendingStubs.length > 0) {
+      const stubs = this.pendingStubs.splice(0);
+      await this.post("/_admin/stubs/batch", { stubs });
+    }
   }
   async clearStubs() {
     await this.flush();
@@ -240,6 +251,16 @@ var GivenStubs = class {
   }
 };
 
+// src/stubs/expect.ts
+var ExpectConditions = class {
+  constructor(adminClient) {
+    this.adminClient = adminClient;
+  }
+  apiKey(key) {
+    this.adminClient.enqueueConfig({ apiKey: key });
+  }
+};
+
 // src/errors/lifecycle.errors.ts
 var ContainerNotStartedError = class extends MockLLMError {
   code = "CONTAINER_NOT_STARTED";
@@ -258,6 +279,7 @@ var MockLLM = class {
   containerManager;
   adminClient = null;
   _given = null;
+  _expect = null;
   _baseUrl = null;
   constructor(options) {
     const config = resolveContainerConfig(options);
@@ -275,6 +297,7 @@ var MockLLM = class {
     this._baseUrl = `http://${host}:${port}`;
     this.adminClient = new AdminClient(this._baseUrl);
     this._given = new GivenStubs(this.adminClient);
+    this._expect = new ExpectConditions(this.adminClient);
     this.state = "running";
   }
   async stop() {
@@ -286,6 +309,7 @@ var MockLLM = class {
       this.state = "stopped";
       this.adminClient = null;
       this._given = null;
+      this._expect = null;
       this._baseUrl = null;
     }
   }
@@ -300,6 +324,10 @@ var MockLLM = class {
     this.assertRunning();
     return this._given;
   }
+  get expect() {
+    this.assertRunning();
+    return this._expect;
+  }
   async clear() {
     this.assertRunning();
     await this.adminClient.clearStubs();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/driver/container.config.ts","../src/driver/container.manager.ts","../src/errors/base.ts","../src/errors/admin.errors.ts","../src/driver/admin.client.ts","../src/stubs/chat.builder.ts","../src/stubs/embedding.builder.ts","../src/stubs/models.builder.ts","../src/stubs/given.ts","../src/errors/lifecycle.errors.ts","../src/driver/mock-llm.ts","../src/errors/stub.errors.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { MockLLMOptions, ContainerConfig } from \"../types/config.js\";\n\nconst DEFAULT_IMAGE = \"phantomllm-server:latest\";\nconst DEFAULT_PORT = 8080;\n\nexport function resolveContainerConfig(options?: MockLLMOptions): ContainerConfig {\n  return {\n    image: options?.image ?? process.env[\"PHANTOMLLM_IMAGE\"] ?? DEFAULT_IMAGE,\n    containerPort: options?.containerPort ?? DEFAULT_PORT,\n    reuse: options?.reuse ?? true,\n    startupTimeout: options?.startupTimeout ?? 30_000,\n  };\n}\n","import { GenericContainer, Wait } from \"testcontainers\";\nimport type { StartedTestContainer } from \"testcontainers\";\nimport type { ContainerConfig } from \"../types/config.js\";\n\nexport class ContainerManager {\n  private container: StartedTestContainer | null = null;\n\n  constructor(private readonly config: ContainerConfig) {}\n\n  async start(): Promise<{ host: string; port: number }> {\n    const container = new GenericContainer(this.config.image)\n      .withExposedPorts(this.config.containerPort)\n      .withWaitStrategy(\n        Wait.forHttp(\"/_admin/health\", this.config.containerPort)\n          .forStatusCode(200),\n      )\n      .withStartupTimeout(this.config.startupTimeout)\n      .withLabels({ \"com.phantomllm\": \"true\" });\n\n    this.container = await container.start();\n\n    return {\n      host: this.container.getHost(),\n      port: this.container.getMappedPort(this.config.containerPort),\n    };\n  }\n\n  async stop(): Promise<void> {\n    if (this.container) {\n      await this.container.stop();\n      this.container = null;\n    }\n  }\n}\n","export abstract class MockLLMError extends Error {\n  abstract readonly code: string;\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = this.constructor.name;\n  }\n}\n","import { MockLLMError } from './base.js';\n\nexport class AdminAPIError extends MockLLMError {\n  readonly code = 'ADMIN_API_ERROR' as const;\n  constructor(\n    public readonly statusCode: number,\n    public readonly responseBody: string,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Admin API returned HTTP ${statusCode}: ${responseBody}`,\n      options,\n    );\n  }\n}\n\nexport class AdminConnectionRefusedError extends MockLLMError {\n  readonly code = 'ADMIN_CONNECTION_REFUSED' as const;\n  constructor(options?: { cause?: unknown }) {\n    super(\n      'Cannot connect to MockLLM admin API. The container may have crashed.',\n      options,\n    );\n  }\n}\n\nexport class AdminTimeoutError extends MockLLMError {\n  readonly code = 'ADMIN_TIMEOUT' as const;\n  constructor(\n    public readonly timeoutMs: number,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Admin API did not respond within ${timeoutMs}ms.`,\n      options,\n    );\n  }\n}\n","import {\n  AdminConnectionRefusedError,\n  AdminTimeoutError,\n  AdminAPIError,\n} from \"../errors/admin.errors.js\";\nimport type {\n  AdminStubDefinition,\n  AdminHealthPayload,\n  AdminRecordedRequestPayload,\n} from \"./admin.client.types.js\";\n\nconst REQUEST_TIMEOUT_MS = 5_000;\n\nexport class AdminClient {\n  private pendingStubs: AdminStubDefinition[] = [];\n\n  constructor(private readonly baseUrl: string) {}\n\n  enqueueStub(stub: AdminStubDefinition): void {\n    this.pendingStubs.push(stub);\n  }\n\n  async flush(): Promise<void> {\n    if (this.pendingStubs.length === 0) return;\n    const stubs = this.pendingStubs.splice(0);\n    await this.post(\"/_admin/stubs/batch\", { stubs });\n  }\n\n  async clearStubs(): Promise<void> {\n    await this.flush();\n    await this.delete(\"/_admin/stubs\");\n  }\n\n  async getHealth(): Promise<AdminHealthPayload> {\n    return this.get<AdminHealthPayload>(\"/_admin/health\");\n  }\n\n  async getRequests(): Promise<AdminRecordedRequestPayload[\"requests\"]> {\n    await this.flush();\n    const data = await this.get<AdminRecordedRequestPayload>(\"/_admin/requests\");\n    return data.requests;\n  }\n\n  private async get<T>(path: string): Promise<T> {\n    const response = await this.fetch(path, { method: \"GET\" });\n    return (await response.json()) as T;\n  }\n\n  private async post<T>(path: string, body: unknown): Promise<T> {\n    const response = await this.fetch(path, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    });\n    return (await response.json()) as T;\n  }\n\n  private async delete(path: string): Promise<void> {\n    await this.fetch(path, { method: \"DELETE\" });\n  }\n\n  private async fetch(path: string, init: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    let response: Response;\n\n    try {\n      response = await fetch(url, {\n        ...init,\n        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),\n      });\n    } catch (error: unknown) {\n      if (error instanceof TypeError) {\n        const cause = error.cause as { code?: string } | undefined;\n        if (cause?.code === \"ECONNREFUSED\") {\n          throw new AdminConnectionRefusedError({ cause: error });\n        }\n      }\n      if (error instanceof DOMException && error.name === \"TimeoutError\") {\n        throw new AdminTimeoutError(REQUEST_TIMEOUT_MS, { cause: error });\n      }\n      throw error;\n    }\n\n    if (!response.ok) {\n      const body = await response.text();\n      throw new AdminAPIError(response.status, body);\n    }\n\n    return response;\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\nimport type { AdminStubMatcher } from \"../driver/admin.client.types.js\";\n\nexport class ChatCompletionStubBuilder {\n  private readonly matcher: AdminStubMatcher = { endpoint: \"chat\" };\n\n  constructor(private readonly adminClient: AdminClient) {}\n\n  forModel(model: string): this {\n    this.matcher.model = model;\n    return this;\n  }\n\n  withMessageContaining(substring: string): this {\n    this.matcher.content = substring;\n    return this;\n  }\n\n  willReturn(content: string): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: { type: \"chat\", body: content },\n    });\n  }\n\n  willStream(chunks: string[]): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: { type: \"streaming-chat\", chunks },\n    });\n  }\n\n  willError(statusCode: number, message: string): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: {\n        type: \"error\",\n        status: statusCode,\n        error: { message, type: \"api_error\", code: null },\n      },\n    });\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\nimport type { AdminStubMatcher } from \"../driver/admin.client.types.js\";\n\nexport class EmbeddingStubBuilder {\n  private readonly matcher: AdminStubMatcher = { endpoint: \"embeddings\" };\n\n  constructor(private readonly adminClient: AdminClient) {}\n\n  forModel(model: string): this {\n    this.matcher.model = model;\n    return this;\n  }\n\n  willReturn(vector: number[] | number[][]): void {\n    const vectors = Array.isArray(vector[0])\n      ? (vector as number[][])\n      : [vector as number[]];\n\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: { type: \"embedding\", vectors },\n    });\n  }\n\n  willError(statusCode: number, message: string): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: {\n        type: \"error\",\n        status: statusCode,\n        error: { message, type: \"api_error\", code: null },\n      },\n    });\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\n\nexport class ModelsStubBuilder {\n  constructor(private readonly adminClient: AdminClient) {}\n\n  willReturn(models: Array<{ id: string; ownedBy?: string }>): void {\n    this.adminClient.enqueueStub({\n      matcher: {},\n      response: { type: \"models\", models },\n    });\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\nimport { ChatCompletionStubBuilder } from \"./chat.builder.js\";\nimport { EmbeddingStubBuilder } from \"./embedding.builder.js\";\nimport { ModelsStubBuilder } from \"./models.builder.js\";\n\nexport class GivenStubs {\n  constructor(private readonly adminClient: AdminClient) {}\n\n  get chatCompletion(): ChatCompletionStubBuilder {\n    return new ChatCompletionStubBuilder(this.adminClient);\n  }\n\n  get embedding(): EmbeddingStubBuilder {\n    return new EmbeddingStubBuilder(this.adminClient);\n  }\n\n  get models(): ModelsStubBuilder {\n    return new ModelsStubBuilder(this.adminClient);\n  }\n}\n","import { MockLLMError } from './base.js';\n\nexport class ContainerNotStartedError extends MockLLMError {\n  readonly code = 'CONTAINER_NOT_STARTED' as const;\n  constructor(options?: { cause?: unknown }) {\n    super(\n      'MockLLM container is not running. Call `await mock.start()` before configuring stubs.',\n      options,\n    );\n  }\n}\n\nexport class ContainerAlreadyStartedError extends MockLLMError {\n  readonly code = 'CONTAINER_ALREADY_STARTED' as const;\n  constructor(options?: { cause?: unknown }) {\n    super(\n      'MockLLM container is already running. Call `await mock.stop()` first if you need to restart.',\n      options,\n    );\n  }\n}\n","import type { MockLLMOptions } from \"../types/config.js\";\nimport { resolveContainerConfig } from \"./container.config.js\";\nimport { ContainerManager } from \"./container.manager.js\";\nimport { AdminClient } from \"./admin.client.js\";\nimport { GivenStubs } from \"../stubs/given.js\";\nimport { ContainerNotStartedError } from \"../errors/lifecycle.errors.js\";\n\ntype MockLLMState = \"idle\" | \"starting\" | \"running\" | \"stopping\" | \"stopped\";\n\nexport class MockLLM {\n  private state: MockLLMState = \"idle\";\n  private startPromise: Promise<void> | null = null;\n  private containerManager: ContainerManager;\n  private adminClient: AdminClient | null = null;\n  private _given: GivenStubs | null = null;\n  private _baseUrl: string | null = null;\n\n  constructor(options?: MockLLMOptions) {\n    const config = resolveContainerConfig(options);\n    this.containerManager = new ContainerManager(config);\n  }\n\n  async start(): Promise<void> {\n    if (this.state === \"running\") return;\n    if (this.state === \"starting\" && this.startPromise) return this.startPromise;\n\n    this.state = \"starting\";\n    this.startPromise = this.doStart();\n    return this.startPromise;\n  }\n\n  private async doStart(): Promise<void> {\n    const { host, port } = await this.containerManager.start();\n    this._baseUrl = `http://${host}:${port}`;\n    this.adminClient = new AdminClient(this._baseUrl);\n    this._given = new GivenStubs(this.adminClient);\n    this.state = \"running\";\n  }\n\n  async stop(): Promise<void> {\n    if (this.state === \"stopped\" || this.state === \"idle\") return;\n    this.state = \"stopping\";\n    try {\n      await this.containerManager.stop();\n    } finally {\n      this.state = \"stopped\";\n      this.adminClient = null;\n      this._given = null;\n      this._baseUrl = null;\n    }\n  }\n\n  get baseUrl(): string {\n    this.assertRunning();\n    return this._baseUrl!;\n  }\n\n  get apiBaseUrl(): string {\n    return `${this.baseUrl}/v1`;\n  }\n\n  get given(): GivenStubs {\n    this.assertRunning();\n    return this._given!;\n  }\n\n  async clear(): Promise<void> {\n    this.assertRunning();\n    await this.adminClient!.clearStubs();\n  }\n\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.stop();\n  }\n\n  private assertRunning(): void {\n    if (this.state !== \"running\") {\n      throw new ContainerNotStartedError();\n    }\n  }\n}\n","import { MockLLMError } from './base.js';\n\nexport class StubConfigurationError extends MockLLMError {\n  readonly code = 'STUB_CONFIGURATION_INVALID' as const;\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n  }\n}\n"]}
+{"version":3,"sources":["../src/driver/container.config.ts","../src/driver/container.manager.ts","../src/errors/base.ts","../src/errors/admin.errors.ts","../src/driver/admin.client.ts","../src/stubs/chat.builder.ts","../src/stubs/embedding.builder.ts","../src/stubs/models.builder.ts","../src/stubs/given.ts","../src/stubs/expect.ts","../src/errors/lifecycle.errors.ts","../src/driver/mock-llm.ts","../src/errors/stub.errors.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { MockLLMOptions, ContainerConfig } from \"../types/config.js\";\n\nconst DEFAULT_IMAGE = \"phantomllm-server:latest\";\nconst DEFAULT_PORT = 8080;\n\nexport function resolveContainerConfig(options?: MockLLMOptions): ContainerConfig {\n  return {\n    image: options?.image ?? process.env[\"PHANTOMLLM_IMAGE\"] ?? DEFAULT_IMAGE,\n    containerPort: options?.containerPort ?? DEFAULT_PORT,\n    reuse: options?.reuse ?? true,\n    startupTimeout: options?.startupTimeout ?? 30_000,\n  };\n}\n","import { GenericContainer, Wait } from \"testcontainers\";\nimport type { StartedTestContainer } from \"testcontainers\";\nimport type { ContainerConfig } from \"../types/config.js\";\n\nexport class ContainerManager {\n  private container: StartedTestContainer | null = null;\n\n  constructor(private readonly config: ContainerConfig) {}\n\n  async start(): Promise<{ host: string; port: number }> {\n    const builder = new GenericContainer(this.config.image)\n      .withExposedPorts(this.config.containerPort)\n      .withWaitStrategy(\n        Wait.forHttp(\"/_admin/health\", this.config.containerPort)\n          .forStatusCode(200),\n      )\n      .withStartupTimeout(this.config.startupTimeout)\n      .withLabels({ \"com.phantomllm\": \"true\" });\n\n    this.container = await builder.start();\n\n    return {\n      host: this.container.getHost(),\n      port: this.container.getMappedPort(this.config.containerPort),\n    };\n  }\n\n  async stop(): Promise<void> {\n    if (this.container) {\n      await this.container.stop();\n      this.container = null;\n    }\n  }\n}\n","export abstract class MockLLMError extends Error {\n  abstract readonly code: string;\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = this.constructor.name;\n  }\n}\n","import { MockLLMError } from './base.js';\n\nexport class AdminAPIError extends MockLLMError {\n  readonly code = 'ADMIN_API_ERROR' as const;\n  constructor(\n    public readonly statusCode: number,\n    public readonly responseBody: string,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Admin API returned HTTP ${statusCode}: ${responseBody}`,\n      options,\n    );\n  }\n}\n\nexport class AdminConnectionRefusedError extends MockLLMError {\n  readonly code = 'ADMIN_CONNECTION_REFUSED' as const;\n  constructor(options?: { cause?: unknown }) {\n    super(\n      'Cannot connect to MockLLM admin API. The container may have crashed.',\n      options,\n    );\n  }\n}\n\nexport class AdminTimeoutError extends MockLLMError {\n  readonly code = 'ADMIN_TIMEOUT' as const;\n  constructor(\n    public readonly timeoutMs: number,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Admin API did not respond within ${timeoutMs}ms.`,\n      options,\n    );\n  }\n}\n","import {\n  AdminConnectionRefusedError,\n  AdminTimeoutError,\n  AdminAPIError,\n} from \"../errors/admin.errors.js\";\nimport type {\n  AdminStubDefinition,\n  AdminHealthPayload,\n  AdminRecordedRequestPayload,\n} from \"./admin.client.types.js\";\n\nconst REQUEST_TIMEOUT_MS = 5_000;\n\nexport class AdminClient {\n  private pendingStubs: AdminStubDefinition[] = [];\n  private pendingConfigs: Array<{ apiKey: string }> = [];\n\n  constructor(private readonly baseUrl: string) {}\n\n  enqueueStub(stub: AdminStubDefinition): void {\n    this.pendingStubs.push(stub);\n  }\n\n  enqueueConfig(config: { apiKey: string }): void {\n    this.pendingConfigs.push(config);\n  }\n\n  async flush(): Promise<void> {\n    if (this.pendingConfigs.length > 0) {\n      const configs = this.pendingConfigs.splice(0);\n      for (const config of configs) {\n        await this.post(\"/_admin/config\", config);\n      }\n    }\n\n    if (this.pendingStubs.length > 0) {\n      const stubs = this.pendingStubs.splice(0);\n      await this.post(\"/_admin/stubs/batch\", { stubs });\n    }\n  }\n\n  async clearStubs(): Promise<void> {\n    await this.flush();\n    await this.delete(\"/_admin/stubs\");\n  }\n\n  async getHealth(): Promise<AdminHealthPayload> {\n    return this.get<AdminHealthPayload>(\"/_admin/health\");\n  }\n\n  async getRequests(): Promise<AdminRecordedRequestPayload[\"requests\"]> {\n    await this.flush();\n    const data = await this.get<AdminRecordedRequestPayload>(\"/_admin/requests\");\n    return data.requests;\n  }\n\n  private async get<T>(path: string): Promise<T> {\n    const response = await this.fetch(path, { method: \"GET\" });\n    return (await response.json()) as T;\n  }\n\n  private async post<T>(path: string, body: unknown): Promise<T> {\n    const response = await this.fetch(path, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    });\n    return (await response.json()) as T;\n  }\n\n  private async delete(path: string): Promise<void> {\n    await this.fetch(path, { method: \"DELETE\" });\n  }\n\n  private async fetch(path: string, init: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    let response: Response;\n\n    try {\n      response = await fetch(url, {\n        ...init,\n        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),\n      });\n    } catch (error: unknown) {\n      if (error instanceof TypeError) {\n        const cause = error.cause as { code?: string } | undefined;\n        if (cause?.code === \"ECONNREFUSED\") {\n          throw new AdminConnectionRefusedError({ cause: error });\n        }\n      }\n      if (error instanceof DOMException && error.name === \"TimeoutError\") {\n        throw new AdminTimeoutError(REQUEST_TIMEOUT_MS, { cause: error });\n      }\n      throw error;\n    }\n\n    if (!response.ok) {\n      const body = await response.text();\n      throw new AdminAPIError(response.status, body);\n    }\n\n    return response;\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\nimport type { AdminStubMatcher } from \"../driver/admin.client.types.js\";\n\nexport class ChatCompletionStubBuilder {\n  private readonly matcher: AdminStubMatcher = { endpoint: \"chat\" };\n\n  constructor(private readonly adminClient: AdminClient) {}\n\n  forModel(model: string): this {\n    this.matcher.model = model;\n    return this;\n  }\n\n  withMessageContaining(substring: string): this {\n    this.matcher.content = substring;\n    return this;\n  }\n\n  willReturn(content: string): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: { type: \"chat\", body: content },\n    });\n  }\n\n  willStream(chunks: string[]): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: { type: \"streaming-chat\", chunks },\n    });\n  }\n\n  willError(statusCode: number, message: string): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: {\n        type: \"error\",\n        status: statusCode,\n        error: { message, type: \"api_error\", code: null },\n      },\n    });\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\nimport type { AdminStubMatcher } from \"../driver/admin.client.types.js\";\n\nexport class EmbeddingStubBuilder {\n  private readonly matcher: AdminStubMatcher = { endpoint: \"embeddings\" };\n\n  constructor(private readonly adminClient: AdminClient) {}\n\n  forModel(model: string): this {\n    this.matcher.model = model;\n    return this;\n  }\n\n  willReturn(vector: number[] | number[][]): void {\n    const vectors = Array.isArray(vector[0])\n      ? (vector as number[][])\n      : [vector as number[]];\n\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: { type: \"embedding\", vectors },\n    });\n  }\n\n  willError(statusCode: number, message: string): void {\n    this.adminClient.enqueueStub({\n      matcher: this.matcher,\n      response: {\n        type: \"error\",\n        status: statusCode,\n        error: { message, type: \"api_error\", code: null },\n      },\n    });\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\n\nexport class ModelsStubBuilder {\n  constructor(private readonly adminClient: AdminClient) {}\n\n  willReturn(models: Array<{ id: string; ownedBy?: string }>): void {\n    this.adminClient.enqueueStub({\n      matcher: {},\n      response: { type: \"models\", models },\n    });\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\nimport { ChatCompletionStubBuilder } from \"./chat.builder.js\";\nimport { EmbeddingStubBuilder } from \"./embedding.builder.js\";\nimport { ModelsStubBuilder } from \"./models.builder.js\";\n\nexport class GivenStubs {\n  constructor(private readonly adminClient: AdminClient) {}\n\n  get chatCompletion(): ChatCompletionStubBuilder {\n    return new ChatCompletionStubBuilder(this.adminClient);\n  }\n\n  get embedding(): EmbeddingStubBuilder {\n    return new EmbeddingStubBuilder(this.adminClient);\n  }\n\n  get models(): ModelsStubBuilder {\n    return new ModelsStubBuilder(this.adminClient);\n  }\n}\n","import type { AdminClient } from \"../driver/admin.client.js\";\n\nexport class ExpectConditions {\n  constructor(private readonly adminClient: AdminClient) {}\n\n  apiKey(key: string): void {\n    this.adminClient.enqueueConfig({ apiKey: key });\n  }\n}\n","import { MockLLMError } from './base.js';\n\nexport class ContainerNotStartedError extends MockLLMError {\n  readonly code = 'CONTAINER_NOT_STARTED' as const;\n  constructor(options?: { cause?: unknown }) {\n    super(\n      'MockLLM container is not running. Call `await mock.start()` before configuring stubs.',\n      options,\n    );\n  }\n}\n\nexport class ContainerAlreadyStartedError extends MockLLMError {\n  readonly code = 'CONTAINER_ALREADY_STARTED' as const;\n  constructor(options?: { cause?: unknown }) {\n    super(\n      'MockLLM container is already running. Call `await mock.stop()` first if you need to restart.',\n      options,\n    );\n  }\n}\n","import type { MockLLMOptions } from \"../types/config.js\";\nimport { resolveContainerConfig } from \"./container.config.js\";\nimport { ContainerManager } from \"./container.manager.js\";\nimport { AdminClient } from \"./admin.client.js\";\nimport { GivenStubs } from \"../stubs/given.js\";\nimport { ExpectConditions } from \"../stubs/expect.js\";\nimport { ContainerNotStartedError } from \"../errors/lifecycle.errors.js\";\n\ntype MockLLMState = \"idle\" | \"starting\" | \"running\" | \"stopping\" | \"stopped\";\n\nexport class MockLLM {\n  private state: MockLLMState = \"idle\";\n  private startPromise: Promise<void> | null = null;\n  private containerManager: ContainerManager;\n  private adminClient: AdminClient | null = null;\n  private _given: GivenStubs | null = null;\n  private _expect: ExpectConditions | null = null;\n  private _baseUrl: string | null = null;\n\n  constructor(options?: MockLLMOptions) {\n    const config = resolveContainerConfig(options);\n    this.containerManager = new ContainerManager(config);\n  }\n\n  async start(): Promise<void> {\n    if (this.state === \"running\") return;\n    if (this.state === \"starting\" && this.startPromise) return this.startPromise;\n\n    this.state = \"starting\";\n    this.startPromise = this.doStart();\n    return this.startPromise;\n  }\n\n  private async doStart(): Promise<void> {\n    const { host, port } = await this.containerManager.start();\n    this._baseUrl = `http://${host}:${port}`;\n    this.adminClient = new AdminClient(this._baseUrl);\n    this._given = new GivenStubs(this.adminClient);\n    this._expect = new ExpectConditions(this.adminClient);\n    this.state = \"running\";\n  }\n\n  async stop(): Promise<void> {\n    if (this.state === \"stopped\" || this.state === \"idle\") return;\n    this.state = \"stopping\";\n    try {\n      await this.containerManager.stop();\n    } finally {\n      this.state = \"stopped\";\n      this.adminClient = null;\n      this._given = null;\n      this._expect = null;\n      this._baseUrl = null;\n    }\n  }\n\n  get baseUrl(): string {\n    this.assertRunning();\n    return this._baseUrl!;\n  }\n\n  get apiBaseUrl(): string {\n    return `${this.baseUrl}/v1`;\n  }\n\n  get given(): GivenStubs {\n    this.assertRunning();\n    return this._given!;\n  }\n\n  get expect(): ExpectConditions {\n    this.assertRunning();\n    return this._expect!;\n  }\n\n  async clear(): Promise<void> {\n    this.assertRunning();\n    await this.adminClient!.clearStubs();\n  }\n\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.stop();\n  }\n\n  private assertRunning(): void {\n    if (this.state !== \"running\") {\n      throw new ContainerNotStartedError();\n    }\n  }\n}\n","import { MockLLMError } from './base.js';\n\nexport class StubConfigurationError extends MockLLMError {\n  readonly code = 'STUB_CONFIGURATION_INVALID' as const;\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phantomllm",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Dockerized mock server for OpenAI-compatible APIs. Test your LLM integrations with a real HTTP server.",
   "license": "MIT",
   "type": "module",
@@ -52,6 +52,10 @@
     "typescript": "^5.9.3",
     "vitest": "^4.1.0"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/galElmalah/phantomllm.git"
+  },
   "keywords": [
     "openai",
     "mock",