phantomllm 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,230 @@
+interface MockLLMOptions {
+    image?: string;
+    containerPort?: number;
+    reuse?: boolean;
+    startupTimeout?: number;
+}
+
+interface AdminStubMatcher {
+    model?: string;
+    content?: string;
+    input?: string;
+    endpoint?: 'chat' | 'embeddings';
+}
+interface AdminChatResponseConfig {
+    type: 'chat';
+    body: string;
+    finishReason?: string;
+}
+interface AdminStreamingChatResponseConfig {
+    type: 'streaming-chat';
+    chunks: string[];
+    finishReason?: string;
+}
+interface AdminEmbeddingResponseConfig {
+    type: 'embedding';
+    vectors: number[][];
+}
+interface AdminErrorResponseConfig {
+    type: 'error';
+    status: number;
+    error: {
+        message: string;
+        type: string;
+        code: string | null;
+    };
+}
+interface AdminModelsResponseConfig {
+    type: 'models';
+    models: Array<{
+        id: string;
+        ownedBy?: string;
+    }>;
+}
+type AdminStubResponseConfig = AdminChatResponseConfig | AdminStreamingChatResponseConfig | AdminEmbeddingResponseConfig | AdminErrorResponseConfig | AdminModelsResponseConfig;
+interface AdminStubDefinition {
+    matcher: AdminStubMatcher;
+    response: AdminStubResponseConfig;
+    delay?: number;
+}
+interface AdminHealthPayload {
+    status: string;
+    stubCount: number;
+    uptime: number;
+}
+interface AdminRecordedRequestPayload {
+    requests: Array<{
+        timestamp: number;
+        method: string;
+        path: string;
+        body: unknown;
+    }>;
+}
+
+declare class AdminClient {
+    private readonly baseUrl;
+    private pendingStubs;
+    constructor(baseUrl: string);
+    enqueueStub(stub: AdminStubDefinition): void;
+    flush(): Promise<void>;
+    clearStubs(): Promise<void>;
+    getHealth(): Promise<AdminHealthPayload>;
+    getRequests(): Promise<AdminRecordedRequestPayload["requests"]>;
+    private get;
+    private post;
+    private delete;
+    private fetch;
+}
+
+declare class ChatCompletionStubBuilder {
+    private readonly adminClient;
+    private readonly matcher;
+    constructor(adminClient: AdminClient);
+    forModel(model: string): this;
+    withMessageContaining(substring: string): this;
+    willReturn(content: string): void;
+    willStream(chunks: string[]): void;
+    willError(statusCode: number, message: string): void;
+}
+
+declare class EmbeddingStubBuilder {
+    private readonly adminClient;
+    private readonly matcher;
+    constructor(adminClient: AdminClient);
+    forModel(model: string): this;
+    willReturn(vector: number[] | number[][]): void;
+    willError(statusCode: number, message: string): void;
+}
+
+declare class ModelsStubBuilder {
+    private readonly adminClient;
+    constructor(adminClient: AdminClient);
+    willReturn(models: Array<{
+        id: string;
+        ownedBy?: string;
+    }>): void;
+}
+
+declare class GivenStubs {
+    private readonly adminClient;
+    constructor(adminClient: AdminClient);
+    get chatCompletion(): ChatCompletionStubBuilder;
+    get embedding(): EmbeddingStubBuilder;
+    get models(): ModelsStubBuilder;
+}
+
+declare class MockLLM {
+    private state;
+    private startPromise;
+    private containerManager;
+    private adminClient;
+    private _given;
+    private _baseUrl;
+    constructor(options?: MockLLMOptions);
+    start(): Promise<void>;
+    private doStart;
+    stop(): Promise<void>;
+    get baseUrl(): string;
+    get apiBaseUrl(): string;
+    get given(): GivenStubs;
+    clear(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    private assertRunning;
+}
+
+declare abstract class MockLLMError extends Error {
+    abstract readonly code: string;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+
+declare class ContainerNotStartedError extends MockLLMError {
+    readonly code: "CONTAINER_NOT_STARTED";
+    constructor(options?: {
+        cause?: unknown;
+    });
+}
+
+declare class StubConfigurationError extends MockLLMError {
+    readonly code: "STUB_CONFIGURATION_INVALID";
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+
+interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string | null;
+}
+interface ChatCompletionRequest {
+    model: string;
+    messages: ChatMessage[];
+    stream?: boolean;
+    temperature?: number;
+    max_tokens?: number;
+    stream_options?: {
+        include_usage?: boolean;
+    };
+}
+interface ChatCompletionChoice {
+    index: number;
+    message: ChatMessage;
+    finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
+    logprobs: null;
+}
+interface UsageInfo {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+interface ChatCompletionResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    system_fingerprint: string;
+    choices: ChatCompletionChoice[];
+    usage: UsageInfo;
+}
+interface ChatCompletionChunkDelta {
+    role?: 'assistant';
+    content?: string;
+}
+interface ChatCompletionChunkChoice {
+    index: number;
+    delta: ChatCompletionChunkDelta;
+    finish_reason: 'stop' | null;
+    logprobs: null;
+}
+interface ChatCompletionChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    system_fingerprint: string;
+    choices: ChatCompletionChunkChoice[];
+    usage?: UsageInfo | null;
+}
+interface EmbeddingRequest {
+    model: string;
+    input: string | string[];
+    encoding_format?: 'float' | 'base64';
+    dimensions?: number;
+}
+interface EmbeddingData {
+    object: 'embedding';
+    index: number;
+    embedding: number[];
+}
+interface EmbeddingResponse {
+    object: 'list';
+    data: EmbeddingData[];
+    model: string;
+    usage: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
+
+export { type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, ContainerNotStartedError, type EmbeddingRequest, type EmbeddingResponse, MockLLM, MockLLMError, type MockLLMOptions, StubConfigurationError };

package/dist/index.js

@@ -0,0 +1,327 @@
+import { GenericContainer, Wait } from 'testcontainers';
+
+// src/driver/container.config.ts
+var DEFAULT_IMAGE = "phantomllm-server:latest";
+var DEFAULT_PORT = 8080;
+function resolveContainerConfig(options) {
+  return {
+    image: options?.image ?? process.env["PHANTOMLLM_IMAGE"] ?? DEFAULT_IMAGE,
+    containerPort: options?.containerPort ?? DEFAULT_PORT,
+    reuse: options?.reuse ?? true,
+    startupTimeout: options?.startupTimeout ?? 3e4
+  };
+}
+var ContainerManager = class {
+  constructor(config) {
+    this.config = config;
+  }
+  container = null;
+  async start() {
+    const container = 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();
+    return {
+      host: this.container.getHost(),
+      port: this.container.getMappedPort(this.config.containerPort)
+    };
+  }
+  async stop() {
+    if (this.container) {
+      await this.container.stop();
+      this.container = null;
+    }
+  }
+};
+
+// src/errors/base.ts
+var MockLLMError = class extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = this.constructor.name;
+  }
+};
+
+// src/errors/admin.errors.ts
+var AdminAPIError = class extends MockLLMError {
+  constructor(statusCode, responseBody, options) {
+    super(
+      `Admin API returned HTTP ${statusCode}: ${responseBody}`,
+      options
+    );
+    this.statusCode = statusCode;
+    this.responseBody = responseBody;
+  }
+  code = "ADMIN_API_ERROR";
+};
+var AdminConnectionRefusedError = class extends MockLLMError {
+  code = "ADMIN_CONNECTION_REFUSED";
+  constructor(options) {
+    super(
+      "Cannot connect to MockLLM admin API. The container may have crashed.",
+      options
+    );
+  }
+};
+var AdminTimeoutError = class extends MockLLMError {
+  constructor(timeoutMs, options) {
+    super(
+      `Admin API did not respond within ${timeoutMs}ms.`,
+      options
+    );
+    this.timeoutMs = timeoutMs;
+  }
+  code = "ADMIN_TIMEOUT";
+};
+
+// src/driver/admin.client.ts
+var REQUEST_TIMEOUT_MS = 5e3;
+var AdminClient = class {
+  constructor(baseUrl) {
+    this.baseUrl = baseUrl;
+  }
+  pendingStubs = [];
+  enqueueStub(stub) {
+    this.pendingStubs.push(stub);
+  }
+  async flush() {
+    if (this.pendingStubs.length === 0) return;
+    const stubs = this.pendingStubs.splice(0);
+    await this.post("/_admin/stubs/batch", { stubs });
+  }
+  async clearStubs() {
+    await this.flush();
+    await this.delete("/_admin/stubs");
+  }
+  async getHealth() {
+    return this.get("/_admin/health");
+  }
+  async getRequests() {
+    await this.flush();
+    const data = await this.get("/_admin/requests");
+    return data.requests;
+  }
+  async get(path) {
+    const response = await this.fetch(path, { method: "GET" });
+    return await response.json();
+  }
+  async post(path, body) {
+    const response = await this.fetch(path, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    return await response.json();
+  }
+  async delete(path) {
+    await this.fetch(path, { method: "DELETE" });
+  }
+  async fetch(path, init) {
+    const url = `${this.baseUrl}${path}`;
+    let response;
+    try {
+      response = await fetch(url, {
+        ...init,
+        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+      });
+    } catch (error) {
+      if (error instanceof TypeError) {
+        const cause = error.cause;
+        if (cause?.code === "ECONNREFUSED") {
+          throw new AdminConnectionRefusedError({ cause: error });
+        }
+      }
+      if (error instanceof DOMException && error.name === "TimeoutError") {
+        throw new AdminTimeoutError(REQUEST_TIMEOUT_MS, { cause: error });
+      }
+      throw error;
+    }
+    if (!response.ok) {
+      const body = await response.text();
+      throw new AdminAPIError(response.status, body);
+    }
+    return response;
+  }
+};
+
+// src/stubs/chat.builder.ts
+var ChatCompletionStubBuilder = class {
+  constructor(adminClient) {
+    this.adminClient = adminClient;
+  }
+  matcher = { endpoint: "chat" };
+  forModel(model) {
+    this.matcher.model = model;
+    return this;
+  }
+  withMessageContaining(substring) {
+    this.matcher.content = substring;
+    return this;
+  }
+  willReturn(content) {
+    this.adminClient.enqueueStub({
+      matcher: this.matcher,
+      response: { type: "chat", body: content }
+    });
+  }
+  willStream(chunks) {
+    this.adminClient.enqueueStub({
+      matcher: this.matcher,
+      response: { type: "streaming-chat", chunks }
+    });
+  }
+  willError(statusCode, message) {
+    this.adminClient.enqueueStub({
+      matcher: this.matcher,
+      response: {
+        type: "error",
+        status: statusCode,
+        error: { message, type: "api_error", code: null }
+      }
+    });
+  }
+};
+
+// src/stubs/embedding.builder.ts
+var EmbeddingStubBuilder = class {
+  constructor(adminClient) {
+    this.adminClient = adminClient;
+  }
+  matcher = { endpoint: "embeddings" };
+  forModel(model) {
+    this.matcher.model = model;
+    return this;
+  }
+  willReturn(vector) {
+    const vectors = Array.isArray(vector[0]) ? vector : [vector];
+    this.adminClient.enqueueStub({
+      matcher: this.matcher,
+      response: { type: "embedding", vectors }
+    });
+  }
+  willError(statusCode, message) {
+    this.adminClient.enqueueStub({
+      matcher: this.matcher,
+      response: {
+        type: "error",
+        status: statusCode,
+        error: { message, type: "api_error", code: null }
+      }
+    });
+  }
+};
+
+// src/stubs/models.builder.ts
+var ModelsStubBuilder = class {
+  constructor(adminClient) {
+    this.adminClient = adminClient;
+  }
+  willReturn(models) {
+    this.adminClient.enqueueStub({
+      matcher: {},
+      response: { type: "models", models }
+    });
+  }
+};
+
+// src/stubs/given.ts
+var GivenStubs = class {
+  constructor(adminClient) {
+    this.adminClient = adminClient;
+  }
+  get chatCompletion() {
+    return new ChatCompletionStubBuilder(this.adminClient);
+  }
+  get embedding() {
+    return new EmbeddingStubBuilder(this.adminClient);
+  }
+  get models() {
+    return new ModelsStubBuilder(this.adminClient);
+  }
+};
+
+// src/errors/lifecycle.errors.ts
+var ContainerNotStartedError = class extends MockLLMError {
+  code = "CONTAINER_NOT_STARTED";
+  constructor(options) {
+    super(
+      "MockLLM container is not running. Call `await mock.start()` before configuring stubs.",
+      options
+    );
+  }
+};
+
+// src/driver/mock-llm.ts
+var MockLLM = class {
+  state = "idle";
+  startPromise = null;
+  containerManager;
+  adminClient = null;
+  _given = null;
+  _baseUrl = null;
+  constructor(options) {
+    const config = resolveContainerConfig(options);
+    this.containerManager = new ContainerManager(config);
+  }
+  async start() {
+    if (this.state === "running") return;
+    if (this.state === "starting" && this.startPromise) return this.startPromise;
+    this.state = "starting";
+    this.startPromise = this.doStart();
+    return this.startPromise;
+  }
+  async doStart() {
+    const { host, port } = await this.containerManager.start();
+    this._baseUrl = `http://${host}:${port}`;
+    this.adminClient = new AdminClient(this._baseUrl);
+    this._given = new GivenStubs(this.adminClient);
+    this.state = "running";
+  }
+  async stop() {
+    if (this.state === "stopped" || this.state === "idle") return;
+    this.state = "stopping";
+    try {
+      await this.containerManager.stop();
+    } finally {
+      this.state = "stopped";
+      this.adminClient = null;
+      this._given = null;
+      this._baseUrl = null;
+    }
+  }
+  get baseUrl() {
+    this.assertRunning();
+    return this._baseUrl;
+  }
+  get apiBaseUrl() {
+    return `${this.baseUrl}/v1`;
+  }
+  get given() {
+    this.assertRunning();
+    return this._given;
+  }
+  async clear() {
+    this.assertRunning();
+    await this.adminClient.clearStubs();
+  }
+  async [Symbol.asyncDispose]() {
+    await this.stop();
+  }
+  assertRunning() {
+    if (this.state !== "running") {
+      throw new ContainerNotStartedError();
+    }
+  }
+};
+
+// src/errors/stub.errors.ts
+var StubConfigurationError = class extends MockLLMError {
+  code = "STUB_CONFIGURATION_INVALID";
+  constructor(message, options) {
+    super(message, options);
+  }
+};
+
+export { ContainerNotStartedError, MockLLM, MockLLMError, StubConfigurationError };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "phantomllm",
+  "version": "0.1.0",
+  "description": "Dockerized mock server for OpenAI-compatible APIs. Test your LLM integrations with a real HTTP server.",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:server": "tsc --project tsconfig.server.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:unit": "vitest run --project unit",
+    "test:integration": "vitest run --project integration",
+    "test:sdk": "vitest run --project sdk",
+    "test:bench": "vitest run --project bench",
+    "docker:build": "npm run build:server && docker build -t phantomllm-server:latest .",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "testcontainers": "^11.13.0"
+  },
+  "devDependencies": {
+    "@ai-sdk/openai": "^3.0.47",
+    "@types/node": "^22.15.0",
+    "ai": "^6.0.134",
+    "fastify": "^5.8.2",
+    "fastify-plugin": "^5.1.0",
+    "openai": "^6.32.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  },
+  "keywords": [
+    "openai",
+    "mock",
+    "testing",
+    "testcontainers",
+    "docker",
+    "llm",
+    "ai-sdk"
+  ]
+}