@seanhogg/builderforce-sdk 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sean Hogg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,98 @@
+# @seanhogg/builderforce-sdk
+
+Typed SDK for Builderforce LLM gateway APIs.
+
+## Install
+
+```bash
+npm install @seanhogg/builderforce-sdk
+```
+
+## Quick start
+
+```ts
+import { BuilderforceClient } from '@seanhogg/builderforce-sdk';
+
+const client = new BuilderforceClient({
+  apiKey: process.env.BUILDERFORCE_API_KEY!,
+  // Optional:
+  // baseUrl: 'https://api.builderforce.ai',
+  // timeoutMs: 60_000,
+});
+```
+
+## Non-streaming chat
+
+```ts
+const res = await client.chat.completions.create({
+  useCase: 'ide.chat',
+  stream: false,
+  messages: [{ role: 'user', content: 'Summarize this PRD.' }],
+});
+
+console.log(res.choices?.[0]?.message?.content);
+```
+
+## Streaming chat
+
+```ts
+const stream = await client.chat.completions.create({
+  useCase: 'coach.chat',
+  stream: true,
+  messages: [{ role: 'user', content: 'Give me a weekly plan.' }],
+});
+
+for await (const chunk of stream) {
+  const delta = chunk.choices?.[0]?.delta?.content ?? '';
+  process.stdout.write(delta);
+}
+```
+
+Or collect all streaming text:
+
+```ts
+const text = await stream.toText();
+```
+
+## Models and usage
+
+```ts
+const models = await client.models.list();
+const usage = await client.usage.get({ days: 30 });
+```
+
+## Errors
+
+SDK requests throw `BuilderforceApiError` on non-2xx responses:
+
+```ts
+import { BuilderforceApiError } from '@seanhogg/builderforce-sdk';
+
+try {
+  await client.models.list();
+} catch (error) {
+  if (error instanceof BuilderforceApiError) {
+    console.error(error.status, error.code, error.requestId, error.message);
+  }
+}
+```
+
+## Auth conventions
+
+The SDK sends `Authorization: Bearer <apiKey>` automatically. The gateway accepts three credential types:
+
+| Prefix | Issued by | Best for |
+|---|---|---|
+| `bfk_*` | `POST /api/tenants/:tenantId/api-keys` (owner-only) | Tenant apps (server-to-server). Long-lived, tenant-scoped, revocable. |
+| `clk_*` | `POST /api/claws` (CoderClaw registration) | Self-hosted CoderClaw instances; carries optional per-claw daily token cap. |
+| Tenant JWT | `POST /api/auth/web/login` → `POST /api/auth/tenant-token` | Browser-side calls from a logged-in user. Short-lived. |
+
+Workforce model routing is server-side: pass `model: 'builderforce/workforce-<agentId>'` when needed.
+
+## Use-case safety
+
+`AIUseCase` is exported for compile-time checks:
+
+```ts
+import type { AIUseCase } from '@seanhogg/builderforce-sdk';
+```

package/dist/index.cjs

@@ -0,0 +1,303 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AI_USE_CASES: () => AI_USE_CASES,
+  BuilderforceApiError: () => BuilderforceApiError,
+  BuilderforceClient: () => BuilderforceClient,
+  ChatCompletionStream: () => ChatCompletionStream,
+  isAIUseCase: () => isAIUseCase
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/infrastructure/sse.ts
+async function* parseSseJson(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+    const lines = buffer.split("\n");
+    buffer = lines.pop() ?? "";
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed.startsWith("data: ")) continue;
+      const data = trimmed.slice(6).trim();
+      if (data === "[DONE]") return;
+      try {
+        yield JSON.parse(data);
+      } catch {
+      }
+    }
+  }
+}
+
+// src/application/ChatCompletionsApi.ts
+var ChatCompletionStream = class {
+  stream;
+  constructor(stream) {
+    this.stream = stream;
+  }
+  [Symbol.asyncIterator]() {
+    return parseSseJson(this.stream);
+  }
+  async toText() {
+    let full = "";
+    for await (const chunk of this) {
+      const delta = chunk.choices?.[0]?.delta?.content;
+      if (typeof delta === "string") {
+        full += delta;
+      }
+    }
+    return full;
+  }
+};
+var ChatCompletionsApi = class {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  async create(params) {
+    if (params.stream) {
+      const response = await this.http.postRaw("/llm/v1/chat/completions", params);
+      if (!response.body) {
+        throw new Error("Streaming response body is missing");
+      }
+      return new ChatCompletionStream(response.body);
+    }
+    return this.http.postJson("/llm/v1/chat/completions", params);
+  }
+};
+
+// src/application/ModelsApi.ts
+var ModelsApi = class {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  list() {
+    return this.http.getJson("/llm/v1/models");
+  }
+};
+
+// src/application/UsageApi.ts
+var UsageApi = class {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  get(params = {}) {
+    const query = typeof params.days === "number" ? `?days=${encodeURIComponent(String(params.days))}` : "";
+    return this.http.getJson(`/llm/v1/usage${query}`);
+  }
+};
+
+// src/infrastructure/httpClient.ts
+var BuilderforceApiError = class extends Error {
+  status;
+  code;
+  details;
+  requestId;
+  constructor(message, status, code, details, requestId) {
+    super(message);
+    this.name = "BuilderforceApiError";
+    this.status = status;
+    this.code = code;
+    this.details = details;
+    this.requestId = requestId;
+  }
+};
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  fetchFn;
+  timeoutMs;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl.replace(/\/$/, "");
+    this.fetchFn = options.fetchFn ?? fetch;
+    this.timeoutMs = options.timeoutMs ?? 6e4;
+  }
+  async getJson(path) {
+    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {
+      method: "GET",
+      headers: this.authHeaders()
+    });
+    return this.parseJsonResponse(res);
+  }
+  async postJson(path, body) {
+    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers: {
+        ...this.authHeaders(),
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    return this.parseJsonResponse(res);
+  }
+  async postRaw(path, body) {
+    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers: {
+        ...this.authHeaders(),
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      throw await this.toApiError(res);
+    }
+    return res;
+  }
+  authHeaders() {
+    return {
+      Authorization: `Bearer ${this.apiKey}`
+    };
+  }
+  async fetchWithTimeout(input, init) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      return await this.fetchFn(input, { ...init, signal: controller.signal });
+    } catch (error) {
+      if (controller.signal.aborted) {
+        throw new BuilderforceApiError(`Request timed out after ${this.timeoutMs}ms`, 408, "timeout");
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  async parseJsonResponse(res) {
+    if (!res.ok) {
+      throw await this.toApiError(res);
+    }
+    return res.json();
+  }
+  async toApiError(res) {
+    const fallback = `Request failed (${res.status})`;
+    const requestId = res.headers.get("x-request-id") ?? void 0;
+    try {
+      const payload = await res.json();
+      return new BuilderforceApiError(payload.error ?? fallback, res.status, payload.code, payload.details, requestId);
+    } catch {
+      const text = await res.text().catch(() => "");
+      return new BuilderforceApiError(text || fallback, res.status, void 0, void 0, requestId);
+    }
+  }
+};
+
+// src/BuilderforceClient.ts
+var BuilderforceClient = class {
+  chat;
+  models;
+  usage;
+  constructor(options) {
+    const apiKey = options.apiKey?.trim();
+    if (!apiKey) {
+      throw new BuilderforceApiError(
+        "BuilderforceClient requires a non-empty apiKey",
+        400,
+        "missing_api_key"
+      );
+    }
+    const http = new HttpClient({
+      apiKey,
+      baseUrl: options.baseUrl ?? "https://api.builderforce.ai",
+      fetchFn: options.fetch,
+      timeoutMs: options.timeoutMs
+    });
+    this.chat = {
+      completions: new ChatCompletionsApi(http)
+    };
+    this.models = new ModelsApi(http);
+    this.usage = new UsageApi(http);
+  }
+};
+
+// src/domain/aiUseCases.ts
+var AI_USE_CASES = [
+  "ide.chat",
+  "ide.code_complete",
+  "training.dataset_generate",
+  "training.dataset_evaluate",
+  "agent.inference",
+  "coder.code",
+  "coder.review",
+  "coder.test",
+  "coder.debug",
+  "coder.refactor",
+  "coder.document",
+  "coder.architect",
+  "coach.chat",
+  "coach.insight",
+  "coach.classify",
+  "studio.compose",
+  "studio.script",
+  "studio.brief",
+  "pitch_deck.generate",
+  "investor.update",
+  "ask.general",
+  "tool.classify_email",
+  "tool.categorize_expense",
+  "tool.contract_analyze",
+  "tool.competitor_scan",
+  "tool.feature_score",
+  "tool.market_research",
+  "tool.health_score",
+  "tool.journey_insight",
+  "vision.describe",
+  "ocr.extract",
+  "embed.text",
+  "match",
+  "match_tailor",
+  "match_insights",
+  "resume_roast",
+  "skill_extract",
+  "job_parser",
+  "autofill",
+  "article_writer",
+  "studio_script",
+  "studio_edit_script",
+  "studio_misc",
+  "linkedin_post",
+  "interview_questions",
+  "interview_analyze",
+  "chat",
+  "career",
+  "discovery",
+  "dashboard_summary"
+];
+function isAIUseCase(value) {
+  return AI_USE_CASES.includes(value);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AI_USE_CASES,
+  BuilderforceApiError,
+  BuilderforceClient,
+  ChatCompletionStream,
+  isAIUseCase
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/infrastructure/sse.ts","../src/application/ChatCompletionsApi.ts","../src/application/ModelsApi.ts","../src/application/UsageApi.ts","../src/infrastructure/httpClient.ts","../src/BuilderforceClient.ts","../src/domain/aiUseCases.ts"],"sourcesContent":["export { BuilderforceClient, type BuilderforceClientOptions } from './BuilderforceClient';\r\n\r\nexport {\r\n  AI_USE_CASES,\r\n  isAIUseCase,\r\n  type AIUseCase,\r\n} from './domain/aiUseCases';\r\n\r\nexport type {\r\n  ChatRole,\r\n  ChatMessage,\r\n  ChatCompletionCreateParams,\r\n  ChatCompletionChunk,\r\n  ChatCompletionResponse,\r\n  ModelsListResponse,\r\n  UsageByModel,\r\n  UsageByDay,\r\n  UsageByUser,\r\n  UsageResponse,\r\n  UsageGetParams,\r\n} from './domain/types';\r\n\r\nexport { ChatCompletionStream } from './application/ChatCompletionsApi';\r\nexport { BuilderforceApiError } from './infrastructure/httpClient';\r\n","export async function* parseSseJson<T>(\r\n  stream: ReadableStream<Uint8Array>,\r\n): AsyncGenerator<T, void, unknown> {\r\n  const reader = stream.getReader();\r\n  const decoder = new TextDecoder();\r\n  let buffer = '';\r\n\r\n  while (true) {\r\n    const { done, value } = await reader.read();\r\n    if (done) break;\r\n\r\n    buffer += decoder.decode(value, { stream: true });\r\n    const lines = buffer.split('\\n');\r\n    buffer = lines.pop() ?? '';\r\n\r\n    for (const line of lines) {\r\n      const trimmed = line.trim();\r\n      if (!trimmed.startsWith('data: ')) continue;\r\n\r\n      const data = trimmed.slice(6).trim();\r\n      if (data === '[DONE]') return;\r\n\r\n      try {\r\n        yield JSON.parse(data) as T;\r\n      } catch {\r\n        // Skip malformed chunks instead of breaking the stream.\r\n      }\r\n    }\r\n  }\r\n}\r\n","import type { ChatCompletionChunk, ChatCompletionCreateParams, ChatCompletionResponse } from '../domain/types';\r\nimport { HttpClient } from '../infrastructure/httpClient';\r\nimport { parseSseJson } from '../infrastructure/sse';\r\n\r\nexport class ChatCompletionStream implements AsyncIterable<ChatCompletionChunk> {\r\n  private readonly stream: ReadableStream<Uint8Array>;\r\n\r\n  constructor(stream: ReadableStream<Uint8Array>) {\r\n    this.stream = stream;\r\n  }\r\n\r\n  [Symbol.asyncIterator](): AsyncIterator<ChatCompletionChunk, void, unknown> {\r\n    return parseSseJson<ChatCompletionChunk>(this.stream);\r\n  }\r\n\r\n  async toText(): Promise<string> {\r\n    let full = '';\r\n    for await (const chunk of this) {\r\n      const delta = chunk.choices?.[0]?.delta?.content;\r\n      if (typeof delta === 'string') {\r\n        full += delta;\r\n      }\r\n    }\r\n    return full;\r\n  }\r\n}\r\n\r\nexport class ChatCompletionsApi {\r\n  private readonly http: HttpClient;\r\n\r\n  constructor(http: HttpClient) {\r\n    this.http = http;\r\n  }\r\n\r\n  async create(params: ChatCompletionCreateParams & { stream: true }): Promise<ChatCompletionStream>;\r\n  async create(params: ChatCompletionCreateParams & { stream?: false | undefined }): Promise<ChatCompletionResponse>;\r\n  async create(\r\n    params: ChatCompletionCreateParams,\r\n  ): Promise<ChatCompletionResponse | ChatCompletionStream> {\r\n    if (params.stream) {\r\n      const response = await this.http.postRaw('/llm/v1/chat/completions', params);\r\n      if (!response.body) {\r\n        throw new Error('Streaming response body is missing');\r\n      }\r\n      return new ChatCompletionStream(response.body);\r\n    }\r\n\r\n    return this.http.postJson<ChatCompletionResponse>('/llm/v1/chat/completions', params);\r\n  }\r\n}\r\n","import type { ModelsListResponse } from '../domain/types';\r\nimport { HttpClient } from '../infrastructure/httpClient';\r\n\r\nexport class ModelsApi {\r\n  private readonly http: HttpClient;\r\n\r\n  constructor(http: HttpClient) {\r\n    this.http = http;\r\n  }\r\n\r\n  list(): Promise<ModelsListResponse> {\r\n    return this.http.getJson<ModelsListResponse>('/llm/v1/models');\r\n  }\r\n}\r\n","import type { UsageGetParams, UsageResponse } from '../domain/types';\r\nimport { HttpClient } from '../infrastructure/httpClient';\r\n\r\nexport class UsageApi {\r\n  private readonly http: HttpClient;\r\n\r\n  constructor(http: HttpClient) {\r\n    this.http = http;\r\n  }\r\n\r\n  get(params: UsageGetParams = {}): Promise<UsageResponse> {\r\n    const query = typeof params.days === 'number' ? `?days=${encodeURIComponent(String(params.days))}` : '';\r\n    return this.http.getJson<UsageResponse>(`/llm/v1/usage${query}`);\r\n  }\r\n}\r\n","export class BuilderforceApiError extends Error {\r\n  public readonly status: number;\r\n  public readonly code?: string;\r\n  public readonly details?: unknown;\r\n  public readonly requestId?: string;\r\n\r\n  constructor(message: string, status: number, code?: string, details?: unknown, requestId?: string) {\r\n    super(message);\r\n    this.name = 'BuilderforceApiError';\r\n    this.status = status;\r\n    this.code = code;\r\n    this.details = details;\r\n    this.requestId = requestId;\r\n  }\r\n}\r\n\r\nexport interface HttpClientOptions {\r\n  apiKey: string;\r\n  baseUrl: string;\r\n  fetchFn?: typeof fetch;\r\n  timeoutMs?: number;\r\n}\r\n\r\nexport class HttpClient {\r\n  private readonly apiKey: string;\r\n  private readonly baseUrl: string;\r\n  private readonly fetchFn: typeof fetch;\r\n  private readonly timeoutMs: number;\r\n\r\n  constructor(options: HttpClientOptions) {\r\n    this.apiKey = options.apiKey;\r\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '');\r\n    this.fetchFn = options.fetchFn ?? fetch;\r\n    this.timeoutMs = options.timeoutMs ?? 60_000;\r\n  }\r\n\r\n  async getJson<T>(path: string): Promise<T> {\r\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\r\n      method: 'GET',\r\n      headers: this.authHeaders(),\r\n    });\r\n    return this.parseJsonResponse<T>(res);\r\n  }\r\n\r\n  async postJson<T>(path: string, body: unknown): Promise<T> {\r\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\r\n      method: 'POST',\r\n      headers: {\r\n        ...this.authHeaders(),\r\n        'Content-Type': 'application/json',\r\n      },\r\n      body: JSON.stringify(body),\r\n    });\r\n    return this.parseJsonResponse<T>(res);\r\n  }\r\n\r\n  async postRaw(path: string, body: unknown): Promise<Response> {\r\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\r\n      method: 'POST',\r\n      headers: {\r\n        ...this.authHeaders(),\r\n        'Content-Type': 'application/json',\r\n      },\r\n      body: JSON.stringify(body),\r\n    });\r\n    if (!res.ok) {\r\n      throw await this.toApiError(res);\r\n    }\r\n    return res;\r\n  }\r\n\r\n  private authHeaders(): Record<string, string> {\r\n    return {\r\n      Authorization: `Bearer ${this.apiKey}`,\r\n    };\r\n  }\r\n\r\n  private async fetchWithTimeout(input: RequestInfo | URL, init: RequestInit): Promise<Response> {\r\n    const controller = new AbortController();\r\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\r\n    try {\r\n      return await this.fetchFn(input, { ...init, signal: controller.signal });\r\n    } catch (error) {\r\n      if (controller.signal.aborted) {\r\n        throw new BuilderforceApiError(`Request timed out after ${this.timeoutMs}ms`, 408, 'timeout');\r\n      }\r\n      throw error;\r\n    } finally {\r\n      clearTimeout(timeout);\r\n    }\r\n  }\r\n\r\n  private async parseJsonResponse<T>(res: Response): Promise<T> {\r\n    if (!res.ok) {\r\n      throw await this.toApiError(res);\r\n    }\r\n    return res.json() as Promise<T>;\r\n  }\r\n\r\n  private async toApiError(res: Response): Promise<BuilderforceApiError> {\r\n    const fallback = `Request failed (${res.status})`;\r\n    const requestId = res.headers.get('x-request-id') ?? undefined;\r\n    try {\r\n      const payload = await res.json() as { error?: string; code?: string; details?: unknown };\r\n      return new BuilderforceApiError(payload.error ?? fallback, res.status, payload.code, payload.details, requestId);\r\n    } catch {\r\n      const text = await res.text().catch(() => '');\r\n      return new BuilderforceApiError(text || fallback, res.status, undefined, undefined, requestId);\r\n    }\r\n  }\r\n}\r\n","import { ChatCompletionsApi } from './application/ChatCompletionsApi';\r\nimport { ModelsApi } from './application/ModelsApi';\r\nimport { UsageApi } from './application/UsageApi';\r\nimport { BuilderforceApiError, HttpClient } from './infrastructure/httpClient';\r\n\r\nexport interface BuilderforceClientOptions {\r\n  apiKey: string;\r\n  baseUrl?: string;\r\n  fetch?: typeof fetch;\r\n  timeoutMs?: number;\r\n}\r\n\r\nexport class BuilderforceClient {\r\n  public readonly chat: {\r\n    completions: ChatCompletionsApi;\r\n  };\r\n  public readonly models: ModelsApi;\r\n  public readonly usage: UsageApi;\r\n\r\n  constructor(options: BuilderforceClientOptions) {\r\n    const apiKey = options.apiKey?.trim();\r\n    if (!apiKey) {\r\n      throw new BuilderforceApiError(\r\n        'BuilderforceClient requires a non-empty apiKey',\r\n        400,\r\n        'missing_api_key',\r\n      );\r\n    }\r\n\r\n    const http = new HttpClient({\r\n      apiKey,\r\n      baseUrl: options.baseUrl ?? 'https://api.builderforce.ai',\r\n      fetchFn: options.fetch,\r\n      timeoutMs: options.timeoutMs,\r\n    });\r\n\r\n    this.chat = {\r\n      completions: new ChatCompletionsApi(http),\r\n    };\r\n    this.models = new ModelsApi(http);\r\n    this.usage = new UsageApi(http);\r\n  }\r\n}\r\n","// Keep this list aligned with api/src/application/llm/aiUseCases.ts.\r\nexport const AI_USE_CASES = [\r\n  'ide.chat',\r\n  'ide.code_complete',\r\n  'training.dataset_generate',\r\n  'training.dataset_evaluate',\r\n  'agent.inference',\r\n  'coder.code',\r\n  'coder.review',\r\n  'coder.test',\r\n  'coder.debug',\r\n  'coder.refactor',\r\n  'coder.document',\r\n  'coder.architect',\r\n  'coach.chat',\r\n  'coach.insight',\r\n  'coach.classify',\r\n  'studio.compose',\r\n  'studio.script',\r\n  'studio.brief',\r\n  'pitch_deck.generate',\r\n  'investor.update',\r\n  'ask.general',\r\n  'tool.classify_email',\r\n  'tool.categorize_expense',\r\n  'tool.contract_analyze',\r\n  'tool.competitor_scan',\r\n  'tool.feature_score',\r\n  'tool.market_research',\r\n  'tool.health_score',\r\n  'tool.journey_insight',\r\n  'vision.describe',\r\n  'ocr.extract',\r\n  'embed.text',\r\n  'match',\r\n  'match_tailor',\r\n  'match_insights',\r\n  'resume_roast',\r\n  'skill_extract',\r\n  'job_parser',\r\n  'autofill',\r\n  'article_writer',\r\n  'studio_script',\r\n  'studio_edit_script',\r\n  'studio_misc',\r\n  'linkedin_post',\r\n  'interview_questions',\r\n  'interview_analyze',\r\n  'chat',\r\n  'career',\r\n  'discovery',\r\n  'dashboard_summary',\r\n] as const;\r\n\r\nexport type AIUseCase = (typeof AI_USE_CASES)[number];\r\n\r\nexport function isAIUseCase(value: string): value is AIUseCase {\r\n  return (AI_USE_CASES as readonly string[]).includes(value);\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,200 @@
+declare const AI_USE_CASES: readonly ["ide.chat", "ide.code_complete", "training.dataset_generate", "training.dataset_evaluate", "agent.inference", "coder.code", "coder.review", "coder.test", "coder.debug", "coder.refactor", "coder.document", "coder.architect", "coach.chat", "coach.insight", "coach.classify", "studio.compose", "studio.script", "studio.brief", "pitch_deck.generate", "investor.update", "ask.general", "tool.classify_email", "tool.categorize_expense", "tool.contract_analyze", "tool.competitor_scan", "tool.feature_score", "tool.market_research", "tool.health_score", "tool.journey_insight", "vision.describe", "ocr.extract", "embed.text", "match", "match_tailor", "match_insights", "resume_roast", "skill_extract", "job_parser", "autofill", "article_writer", "studio_script", "studio_edit_script", "studio_misc", "linkedin_post", "interview_questions", "interview_analyze", "chat", "career", "discovery", "dashboard_summary"];
+type AIUseCase = (typeof AI_USE_CASES)[number];
+declare function isAIUseCase(value: string): value is AIUseCase;
+
+type ChatRole = 'system' | 'user' | 'assistant' | 'tool';
+interface ChatMessage {
+    role: ChatRole;
+    content: string;
+    name?: string;
+}
+interface ChatCompletionCreateParams {
+    model?: string;
+    messages: ChatMessage[];
+    stream?: boolean;
+    useCase?: AIUseCase;
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    [key: string]: unknown;
+}
+interface ChatCompletionChunk {
+    id?: string;
+    object?: string;
+    created?: number;
+    model?: string;
+    choices?: Array<{
+        index?: number;
+        delta?: {
+            role?: ChatRole;
+            content?: string;
+        };
+        finish_reason?: string | null;
+    }>;
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+}
+interface ChatCompletionResponse {
+    id?: string;
+    object?: string;
+    created?: number;
+    model?: string;
+    choices?: Array<{
+        index?: number;
+        message?: {
+            role?: ChatRole;
+            content?: string;
+        };
+        finish_reason?: string | null;
+    }>;
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+    _builderforce?: {
+        resolvedModel?: string;
+        retries?: number;
+        pool?: number;
+        product?: string;
+        effectivePlan?: string;
+    };
+    [key: string]: unknown;
+}
+interface ModelsListResponse {
+    configured?: boolean;
+    object?: 'list';
+    product?: string;
+    effectivePlan?: string;
+    data?: Array<{
+        model: string;
+        vendor: string;
+        preferred: boolean;
+        available: boolean;
+        cooldownUntil?: number;
+    }>;
+    models?: string[];
+    [key: string]: unknown;
+}
+interface UsageByModel {
+    llmProduct: string;
+    model: string;
+    requests: number;
+    prompt_tokens: string | number;
+    completion_tokens: string | number;
+    total_tokens: string | number;
+    retries: number;
+}
+interface UsageByDay {
+    day: string;
+    requests: number;
+    total_tokens: string | number;
+}
+interface UsageByUser {
+    user_id: string;
+    requests: number;
+    total_tokens: string | number;
+}
+interface UsageResponse {
+    days: number;
+    tenantId: number;
+    plan: string;
+    effectivePlan: string;
+    billingStatus: string;
+    totals: {
+        requests: number;
+        totalTokens: number;
+        promptTokens: number;
+        completionTokens: number;
+    };
+    mine: {
+        userId: string | null;
+        requests: number;
+        totalTokens: number;
+        promptTokens: number;
+        completionTokens: number;
+    };
+    byModel: UsageByModel[];
+    byDay: UsageByDay[];
+    byUser: UsageByUser[];
+}
+interface UsageGetParams {
+    days?: number;
+}
+
+declare class BuilderforceApiError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    readonly requestId?: string;
+    constructor(message: string, status: number, code?: string, details?: unknown, requestId?: string);
+}
+interface HttpClientOptions {
+    apiKey: string;
+    baseUrl: string;
+    fetchFn?: typeof fetch;
+    timeoutMs?: number;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchFn;
+    private readonly timeoutMs;
+    constructor(options: HttpClientOptions);
+    getJson<T>(path: string): Promise<T>;
+    postJson<T>(path: string, body: unknown): Promise<T>;
+    postRaw(path: string, body: unknown): Promise<Response>;
+    private authHeaders;
+    private fetchWithTimeout;
+    private parseJsonResponse;
+    private toApiError;
+}
+
+declare class ChatCompletionStream implements AsyncIterable<ChatCompletionChunk> {
+    private readonly stream;
+    constructor(stream: ReadableStream<Uint8Array>);
+    [Symbol.asyncIterator](): AsyncIterator<ChatCompletionChunk, void, unknown>;
+    toText(): Promise<string>;
+}
+declare class ChatCompletionsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(params: ChatCompletionCreateParams & {
+        stream: true;
+    }): Promise<ChatCompletionStream>;
+    create(params: ChatCompletionCreateParams & {
+        stream?: false | undefined;
+    }): Promise<ChatCompletionResponse>;
+}
+
+declare class ModelsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(): Promise<ModelsListResponse>;
+}
+
+declare class UsageApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    get(params?: UsageGetParams): Promise<UsageResponse>;
+}
+
+interface BuilderforceClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+}
+declare class BuilderforceClient {
+    readonly chat: {
+        completions: ChatCompletionsApi;
+    };
+    readonly models: ModelsApi;
+    readonly usage: UsageApi;
+    constructor(options: BuilderforceClientOptions);
+}
+
+export { type AIUseCase, AI_USE_CASES, BuilderforceApiError, BuilderforceClient, type BuilderforceClientOptions, type ChatCompletionChunk, type ChatCompletionCreateParams, type ChatCompletionResponse, ChatCompletionStream, type ChatMessage, type ChatRole, type ModelsListResponse, type UsageByDay, type UsageByModel, type UsageByUser, type UsageGetParams, type UsageResponse, isAIUseCase };

package/dist/index.d.ts

@@ -0,0 +1,200 @@
+declare const AI_USE_CASES: readonly ["ide.chat", "ide.code_complete", "training.dataset_generate", "training.dataset_evaluate", "agent.inference", "coder.code", "coder.review", "coder.test", "coder.debug", "coder.refactor", "coder.document", "coder.architect", "coach.chat", "coach.insight", "coach.classify", "studio.compose", "studio.script", "studio.brief", "pitch_deck.generate", "investor.update", "ask.general", "tool.classify_email", "tool.categorize_expense", "tool.contract_analyze", "tool.competitor_scan", "tool.feature_score", "tool.market_research", "tool.health_score", "tool.journey_insight", "vision.describe", "ocr.extract", "embed.text", "match", "match_tailor", "match_insights", "resume_roast", "skill_extract", "job_parser", "autofill", "article_writer", "studio_script", "studio_edit_script", "studio_misc", "linkedin_post", "interview_questions", "interview_analyze", "chat", "career", "discovery", "dashboard_summary"];
+type AIUseCase = (typeof AI_USE_CASES)[number];
+declare function isAIUseCase(value: string): value is AIUseCase;
+
+type ChatRole = 'system' | 'user' | 'assistant' | 'tool';
+interface ChatMessage {
+    role: ChatRole;
+    content: string;
+    name?: string;
+}
+interface ChatCompletionCreateParams {
+    model?: string;
+    messages: ChatMessage[];
+    stream?: boolean;
+    useCase?: AIUseCase;
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    [key: string]: unknown;
+}
+interface ChatCompletionChunk {
+    id?: string;
+    object?: string;
+    created?: number;
+    model?: string;
+    choices?: Array<{
+        index?: number;
+        delta?: {
+            role?: ChatRole;
+            content?: string;
+        };
+        finish_reason?: string | null;
+    }>;
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+}
+interface ChatCompletionResponse {
+    id?: string;
+    object?: string;
+    created?: number;
+    model?: string;
+    choices?: Array<{
+        index?: number;
+        message?: {
+            role?: ChatRole;
+            content?: string;
+        };
+        finish_reason?: string | null;
+    }>;
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+    _builderforce?: {
+        resolvedModel?: string;
+        retries?: number;
+        pool?: number;
+        product?: string;
+        effectivePlan?: string;
+    };
+    [key: string]: unknown;
+}
+interface ModelsListResponse {
+    configured?: boolean;
+    object?: 'list';
+    product?: string;
+    effectivePlan?: string;
+    data?: Array<{
+        model: string;
+        vendor: string;
+        preferred: boolean;
+        available: boolean;
+        cooldownUntil?: number;
+    }>;
+    models?: string[];
+    [key: string]: unknown;
+}
+interface UsageByModel {
+    llmProduct: string;
+    model: string;
+    requests: number;
+    prompt_tokens: string | number;
+    completion_tokens: string | number;
+    total_tokens: string | number;
+    retries: number;
+}
+interface UsageByDay {
+    day: string;
+    requests: number;
+    total_tokens: string | number;
+}
+interface UsageByUser {
+    user_id: string;
+    requests: number;
+    total_tokens: string | number;
+}
+interface UsageResponse {
+    days: number;
+    tenantId: number;
+    plan: string;
+    effectivePlan: string;
+    billingStatus: string;
+    totals: {
+        requests: number;
+        totalTokens: number;
+        promptTokens: number;
+        completionTokens: number;
+    };
+    mine: {
+        userId: string | null;
+        requests: number;
+        totalTokens: number;
+        promptTokens: number;
+        completionTokens: number;
+    };
+    byModel: UsageByModel[];
+    byDay: UsageByDay[];
+    byUser: UsageByUser[];
+}
+interface UsageGetParams {
+    days?: number;
+}
+
+declare class BuilderforceApiError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    readonly requestId?: string;
+    constructor(message: string, status: number, code?: string, details?: unknown, requestId?: string);
+}
+interface HttpClientOptions {
+    apiKey: string;
+    baseUrl: string;
+    fetchFn?: typeof fetch;
+    timeoutMs?: number;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchFn;
+    private readonly timeoutMs;
+    constructor(options: HttpClientOptions);
+    getJson<T>(path: string): Promise<T>;
+    postJson<T>(path: string, body: unknown): Promise<T>;
+    postRaw(path: string, body: unknown): Promise<Response>;
+    private authHeaders;
+    private fetchWithTimeout;
+    private parseJsonResponse;
+    private toApiError;
+}
+
+declare class ChatCompletionStream implements AsyncIterable<ChatCompletionChunk> {
+    private readonly stream;
+    constructor(stream: ReadableStream<Uint8Array>);
+    [Symbol.asyncIterator](): AsyncIterator<ChatCompletionChunk, void, unknown>;
+    toText(): Promise<string>;
+}
+declare class ChatCompletionsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(params: ChatCompletionCreateParams & {
+        stream: true;
+    }): Promise<ChatCompletionStream>;
+    create(params: ChatCompletionCreateParams & {
+        stream?: false | undefined;
+    }): Promise<ChatCompletionResponse>;
+}
+
+declare class ModelsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(): Promise<ModelsListResponse>;
+}
+
+declare class UsageApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    get(params?: UsageGetParams): Promise<UsageResponse>;
+}
+
+interface BuilderforceClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+}
+declare class BuilderforceClient {
+    readonly chat: {
+        completions: ChatCompletionsApi;
+    };
+    readonly models: ModelsApi;
+    readonly usage: UsageApi;
+    constructor(options: BuilderforceClientOptions);
+}
+
+export { type AIUseCase, AI_USE_CASES, BuilderforceApiError, BuilderforceClient, type BuilderforceClientOptions, type ChatCompletionChunk, type ChatCompletionCreateParams, type ChatCompletionResponse, ChatCompletionStream, type ChatMessage, type ChatRole, type ModelsListResponse, type UsageByDay, type UsageByModel, type UsageByUser, type UsageGetParams, type UsageResponse, isAIUseCase };

package/dist/index.mjs

@@ -0,0 +1,272 @@
+// src/infrastructure/sse.ts
+async function* parseSseJson(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+    const lines = buffer.split("\n");
+    buffer = lines.pop() ?? "";
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed.startsWith("data: ")) continue;
+      const data = trimmed.slice(6).trim();
+      if (data === "[DONE]") return;
+      try {
+        yield JSON.parse(data);
+      } catch {
+      }
+    }
+  }
+}
+
+// src/application/ChatCompletionsApi.ts
+var ChatCompletionStream = class {
+  stream;
+  constructor(stream) {
+    this.stream = stream;
+  }
+  [Symbol.asyncIterator]() {
+    return parseSseJson(this.stream);
+  }
+  async toText() {
+    let full = "";
+    for await (const chunk of this) {
+      const delta = chunk.choices?.[0]?.delta?.content;
+      if (typeof delta === "string") {
+        full += delta;
+      }
+    }
+    return full;
+  }
+};
+var ChatCompletionsApi = class {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  async create(params) {
+    if (params.stream) {
+      const response = await this.http.postRaw("/llm/v1/chat/completions", params);
+      if (!response.body) {
+        throw new Error("Streaming response body is missing");
+      }
+      return new ChatCompletionStream(response.body);
+    }
+    return this.http.postJson("/llm/v1/chat/completions", params);
+  }
+};
+
+// src/application/ModelsApi.ts
+var ModelsApi = class {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  list() {
+    return this.http.getJson("/llm/v1/models");
+  }
+};
+
+// src/application/UsageApi.ts
+var UsageApi = class {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  get(params = {}) {
+    const query = typeof params.days === "number" ? `?days=${encodeURIComponent(String(params.days))}` : "";
+    return this.http.getJson(`/llm/v1/usage${query}`);
+  }
+};
+
+// src/infrastructure/httpClient.ts
+var BuilderforceApiError = class extends Error {
+  status;
+  code;
+  details;
+  requestId;
+  constructor(message, status, code, details, requestId) {
+    super(message);
+    this.name = "BuilderforceApiError";
+    this.status = status;
+    this.code = code;
+    this.details = details;
+    this.requestId = requestId;
+  }
+};
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  fetchFn;
+  timeoutMs;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl.replace(/\/$/, "");
+    this.fetchFn = options.fetchFn ?? fetch;
+    this.timeoutMs = options.timeoutMs ?? 6e4;
+  }
+  async getJson(path) {
+    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {
+      method: "GET",
+      headers: this.authHeaders()
+    });
+    return this.parseJsonResponse(res);
+  }
+  async postJson(path, body) {
+    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers: {
+        ...this.authHeaders(),
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    return this.parseJsonResponse(res);
+  }
+  async postRaw(path, body) {
+    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers: {
+        ...this.authHeaders(),
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      throw await this.toApiError(res);
+    }
+    return res;
+  }
+  authHeaders() {
+    return {
+      Authorization: `Bearer ${this.apiKey}`
+    };
+  }
+  async fetchWithTimeout(input, init) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      return await this.fetchFn(input, { ...init, signal: controller.signal });
+    } catch (error) {
+      if (controller.signal.aborted) {
+        throw new BuilderforceApiError(`Request timed out after ${this.timeoutMs}ms`, 408, "timeout");
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  async parseJsonResponse(res) {
+    if (!res.ok) {
+      throw await this.toApiError(res);
+    }
+    return res.json();
+  }
+  async toApiError(res) {
+    const fallback = `Request failed (${res.status})`;
+    const requestId = res.headers.get("x-request-id") ?? void 0;
+    try {
+      const payload = await res.json();
+      return new BuilderforceApiError(payload.error ?? fallback, res.status, payload.code, payload.details, requestId);
+    } catch {
+      const text = await res.text().catch(() => "");
+      return new BuilderforceApiError(text || fallback, res.status, void 0, void 0, requestId);
+    }
+  }
+};
+
+// src/BuilderforceClient.ts
+var BuilderforceClient = class {
+  chat;
+  models;
+  usage;
+  constructor(options) {
+    const apiKey = options.apiKey?.trim();
+    if (!apiKey) {
+      throw new BuilderforceApiError(
+        "BuilderforceClient requires a non-empty apiKey",
+        400,
+        "missing_api_key"
+      );
+    }
+    const http = new HttpClient({
+      apiKey,
+      baseUrl: options.baseUrl ?? "https://api.builderforce.ai",
+      fetchFn: options.fetch,
+      timeoutMs: options.timeoutMs
+    });
+    this.chat = {
+      completions: new ChatCompletionsApi(http)
+    };
+    this.models = new ModelsApi(http);
+    this.usage = new UsageApi(http);
+  }
+};
+
+// src/domain/aiUseCases.ts
+var AI_USE_CASES = [
+  "ide.chat",
+  "ide.code_complete",
+  "training.dataset_generate",
+  "training.dataset_evaluate",
+  "agent.inference",
+  "coder.code",
+  "coder.review",
+  "coder.test",
+  "coder.debug",
+  "coder.refactor",
+  "coder.document",
+  "coder.architect",
+  "coach.chat",
+  "coach.insight",
+  "coach.classify",
+  "studio.compose",
+  "studio.script",
+  "studio.brief",
+  "pitch_deck.generate",
+  "investor.update",
+  "ask.general",
+  "tool.classify_email",
+  "tool.categorize_expense",
+  "tool.contract_analyze",
+  "tool.competitor_scan",
+  "tool.feature_score",
+  "tool.market_research",
+  "tool.health_score",
+  "tool.journey_insight",
+  "vision.describe",
+  "ocr.extract",
+  "embed.text",
+  "match",
+  "match_tailor",
+  "match_insights",
+  "resume_roast",
+  "skill_extract",
+  "job_parser",
+  "autofill",
+  "article_writer",
+  "studio_script",
+  "studio_edit_script",
+  "studio_misc",
+  "linkedin_post",
+  "interview_questions",
+  "interview_analyze",
+  "chat",
+  "career",
+  "discovery",
+  "dashboard_summary"
+];
+function isAIUseCase(value) {
+  return AI_USE_CASES.includes(value);
+}
+export {
+  AI_USE_CASES,
+  BuilderforceApiError,
+  BuilderforceClient,
+  ChatCompletionStream,
+  isAIUseCase
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/infrastructure/sse.ts","../src/application/ChatCompletionsApi.ts","../src/application/ModelsApi.ts","../src/application/UsageApi.ts","../src/infrastructure/httpClient.ts","../src/BuilderforceClient.ts","../src/domain/aiUseCases.ts"],"sourcesContent":["export async function* parseSseJson<T>(\r\n  stream: ReadableStream<Uint8Array>,\r\n): AsyncGenerator<T, void, unknown> {\r\n  const reader = stream.getReader();\r\n  const decoder = new TextDecoder();\r\n  let buffer = '';\r\n\r\n  while (true) {\r\n    const { done, value } = await reader.read();\r\n    if (done) break;\r\n\r\n    buffer += decoder.decode(value, { stream: true });\r\n    const lines = buffer.split('\\n');\r\n    buffer = lines.pop() ?? '';\r\n\r\n    for (const line of lines) {\r\n      const trimmed = line.trim();\r\n      if (!trimmed.startsWith('data: ')) continue;\r\n\r\n      const data = trimmed.slice(6).trim();\r\n      if (data === '[DONE]') return;\r\n\r\n      try {\r\n        yield JSON.parse(data) as T;\r\n      } catch {\r\n        // Skip malformed chunks instead of breaking the stream.\r\n      }\r\n    }\r\n  }\r\n}\r\n","import type { ChatCompletionChunk, ChatCompletionCreateParams, ChatCompletionResponse } from '../domain/types';\r\nimport { HttpClient } from '../infrastructure/httpClient';\r\nimport { parseSseJson } from '../infrastructure/sse';\r\n\r\nexport class ChatCompletionStream implements AsyncIterable<ChatCompletionChunk> {\r\n  private readonly stream: ReadableStream<Uint8Array>;\r\n\r\n  constructor(stream: ReadableStream<Uint8Array>) {\r\n    this.stream = stream;\r\n  }\r\n\r\n  [Symbol.asyncIterator](): AsyncIterator<ChatCompletionChunk, void, unknown> {\r\n    return parseSseJson<ChatCompletionChunk>(this.stream);\r\n  }\r\n\r\n  async toText(): Promise<string> {\r\n    let full = '';\r\n    for await (const chunk of this) {\r\n      const delta = chunk.choices?.[0]?.delta?.content;\r\n      if (typeof delta === 'string') {\r\n        full += delta;\r\n      }\r\n    }\r\n    return full;\r\n  }\r\n}\r\n\r\nexport class ChatCompletionsApi {\r\n  private readonly http: HttpClient;\r\n\r\n  constructor(http: HttpClient) {\r\n    this.http = http;\r\n  }\r\n\r\n  async create(params: ChatCompletionCreateParams & { stream: true }): Promise<ChatCompletionStream>;\r\n  async create(params: ChatCompletionCreateParams & { stream?: false | undefined }): Promise<ChatCompletionResponse>;\r\n  async create(\r\n    params: ChatCompletionCreateParams,\r\n  ): Promise<ChatCompletionResponse | ChatCompletionStream> {\r\n    if (params.stream) {\r\n      const response = await this.http.postRaw('/llm/v1/chat/completions', params);\r\n      if (!response.body) {\r\n        throw new Error('Streaming response body is missing');\r\n      }\r\n      return new ChatCompletionStream(response.body);\r\n    }\r\n\r\n    return this.http.postJson<ChatCompletionResponse>('/llm/v1/chat/completions', params);\r\n  }\r\n}\r\n","import type { ModelsListResponse } from '../domain/types';\r\nimport { HttpClient } from '../infrastructure/httpClient';\r\n\r\nexport class ModelsApi {\r\n  private readonly http: HttpClient;\r\n\r\n  constructor(http: HttpClient) {\r\n    this.http = http;\r\n  }\r\n\r\n  list(): Promise<ModelsListResponse> {\r\n    return this.http.getJson<ModelsListResponse>('/llm/v1/models');\r\n  }\r\n}\r\n","import type { UsageGetParams, UsageResponse } from '../domain/types';\r\nimport { HttpClient } from '../infrastructure/httpClient';\r\n\r\nexport class UsageApi {\r\n  private readonly http: HttpClient;\r\n\r\n  constructor(http: HttpClient) {\r\n    this.http = http;\r\n  }\r\n\r\n  get(params: UsageGetParams = {}): Promise<UsageResponse> {\r\n    const query = typeof params.days === 'number' ? `?days=${encodeURIComponent(String(params.days))}` : '';\r\n    return this.http.getJson<UsageResponse>(`/llm/v1/usage${query}`);\r\n  }\r\n}\r\n","export class BuilderforceApiError extends Error {\r\n  public readonly status: number;\r\n  public readonly code?: string;\r\n  public readonly details?: unknown;\r\n  public readonly requestId?: string;\r\n\r\n  constructor(message: string, status: number, code?: string, details?: unknown, requestId?: string) {\r\n    super(message);\r\n    this.name = 'BuilderforceApiError';\r\n    this.status = status;\r\n    this.code = code;\r\n    this.details = details;\r\n    this.requestId = requestId;\r\n  }\r\n}\r\n\r\nexport interface HttpClientOptions {\r\n  apiKey: string;\r\n  baseUrl: string;\r\n  fetchFn?: typeof fetch;\r\n  timeoutMs?: number;\r\n}\r\n\r\nexport class HttpClient {\r\n  private readonly apiKey: string;\r\n  private readonly baseUrl: string;\r\n  private readonly fetchFn: typeof fetch;\r\n  private readonly timeoutMs: number;\r\n\r\n  constructor(options: HttpClientOptions) {\r\n    this.apiKey = options.apiKey;\r\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '');\r\n    this.fetchFn = options.fetchFn ?? fetch;\r\n    this.timeoutMs = options.timeoutMs ?? 60_000;\r\n  }\r\n\r\n  async getJson<T>(path: string): Promise<T> {\r\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\r\n      method: 'GET',\r\n      headers: this.authHeaders(),\r\n    });\r\n    return this.parseJsonResponse<T>(res);\r\n  }\r\n\r\n  async postJson<T>(path: string, body: unknown): Promise<T> {\r\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\r\n      method: 'POST',\r\n      headers: {\r\n        ...this.authHeaders(),\r\n        'Content-Type': 'application/json',\r\n      },\r\n      body: JSON.stringify(body),\r\n    });\r\n    return this.parseJsonResponse<T>(res);\r\n  }\r\n\r\n  async postRaw(path: string, body: unknown): Promise<Response> {\r\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\r\n      method: 'POST',\r\n      headers: {\r\n        ...this.authHeaders(),\r\n        'Content-Type': 'application/json',\r\n      },\r\n      body: JSON.stringify(body),\r\n    });\r\n    if (!res.ok) {\r\n      throw await this.toApiError(res);\r\n    }\r\n    return res;\r\n  }\r\n\r\n  private authHeaders(): Record<string, string> {\r\n    return {\r\n      Authorization: `Bearer ${this.apiKey}`,\r\n    };\r\n  }\r\n\r\n  private async fetchWithTimeout(input: RequestInfo | URL, init: RequestInit): Promise<Response> {\r\n    const controller = new AbortController();\r\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\r\n    try {\r\n      return await this.fetchFn(input, { ...init, signal: controller.signal });\r\n    } catch (error) {\r\n      if (controller.signal.aborted) {\r\n        throw new BuilderforceApiError(`Request timed out after ${this.timeoutMs}ms`, 408, 'timeout');\r\n      }\r\n      throw error;\r\n    } finally {\r\n      clearTimeout(timeout);\r\n    }\r\n  }\r\n\r\n  private async parseJsonResponse<T>(res: Response): Promise<T> {\r\n    if (!res.ok) {\r\n      throw await this.toApiError(res);\r\n    }\r\n    return res.json() as Promise<T>;\r\n  }\r\n\r\n  private async toApiError(res: Response): Promise<BuilderforceApiError> {\r\n    const fallback = `Request failed (${res.status})`;\r\n    const requestId = res.headers.get('x-request-id') ?? undefined;\r\n    try {\r\n      const payload = await res.json() as { error?: string; code?: string; details?: unknown };\r\n      return new BuilderforceApiError(payload.error ?? fallback, res.status, payload.code, payload.details, requestId);\r\n    } catch {\r\n      const text = await res.text().catch(() => '');\r\n      return new BuilderforceApiError(text || fallback, res.status, undefined, undefined, requestId);\r\n    }\r\n  }\r\n}\r\n","import { ChatCompletionsApi } from './application/ChatCompletionsApi';\r\nimport { ModelsApi } from './application/ModelsApi';\r\nimport { UsageApi } from './application/UsageApi';\r\nimport { BuilderforceApiError, HttpClient } from './infrastructure/httpClient';\r\n\r\nexport interface BuilderforceClientOptions {\r\n  apiKey: string;\r\n  baseUrl?: string;\r\n  fetch?: typeof fetch;\r\n  timeoutMs?: number;\r\n}\r\n\r\nexport class BuilderforceClient {\r\n  public readonly chat: {\r\n    completions: ChatCompletionsApi;\r\n  };\r\n  public readonly models: ModelsApi;\r\n  public readonly usage: UsageApi;\r\n\r\n  constructor(options: BuilderforceClientOptions) {\r\n    const apiKey = options.apiKey?.trim();\r\n    if (!apiKey) {\r\n      throw new BuilderforceApiError(\r\n        'BuilderforceClient requires a non-empty apiKey',\r\n        400,\r\n        'missing_api_key',\r\n      );\r\n    }\r\n\r\n    const http = new HttpClient({\r\n      apiKey,\r\n      baseUrl: options.baseUrl ?? 'https://api.builderforce.ai',\r\n      fetchFn: options.fetch,\r\n      timeoutMs: options.timeoutMs,\r\n    });\r\n\r\n    this.chat = {\r\n      completions: new ChatCompletionsApi(http),\r\n    };\r\n    this.models = new ModelsApi(http);\r\n    this.usage = new UsageApi(http);\r\n  }\r\n}\r\n","// Keep this list aligned with api/src/application/llm/aiUseCases.ts.\r\nexport const AI_USE_CASES = [\r\n  'ide.chat',\r\n  'ide.code_complete',\r\n  'training.dataset_generate',\r\n  'training.dataset_evaluate',\r\n  'agent.inference',\r\n  'coder.code',\r\n  'coder.review',\r\n  'coder.test',\r\n  'coder.debug',\r\n  'coder.refactor',\r\n  'coder.document',\r\n  'coder.architect',\r\n  'coach.chat',\r\n  'coach.insight',\r\n  'coach.classify',\r\n  'studio.compose',\r\n  'studio.script',\r\n  'studio.brief',\r\n  'pitch_deck.generate',\r\n  'investor.update',\r\n  'ask.general',\r\n  'tool.classify_email',\r\n  'tool.categorize_expense',\r\n  'tool.contract_analyze',\r\n  'tool.competitor_scan',\r\n  'tool.feature_score',\r\n  'tool.market_research',\r\n  'tool.health_score',\r\n  'tool.journey_insight',\r\n  'vision.describe',\r\n  'ocr.extract',\r\n  'embed.text',\r\n  'match',\r\n  'match_tailor',\r\n  'match_insights',\r\n  'resume_roast',\r\n  'skill_extract',\r\n  'job_parser',\r\n  'autofill',\r\n  'article_writer',\r\n  'studio_script',\r\n  'studio_edit_script',\r\n  'studio_misc',\r\n  'linkedin_post',\r\n  'interview_questions',\r\n  'interview_analyze',\r\n  'chat',\r\n  'career',\r\n  'discovery',\r\n  'dashboard_summary',\r\n] as const;\r\n\r\nexport type AIUseCase = (typeof AI_USE_CASES)[number];\r\n\r\nexport function isAIUseCase(value: string): value is AIUseCase {\r\n  return (AI_USE_CASES as readonly string[]).includes(value);\r\n}\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@seanhogg/builderforce-sdk",
+  "version": "0.2.0",
+  "description": "Typed SDK for the Builderforce.ai LLM gateway — chat completions, models, and usage analytics over an OpenAI-compatible surface.",
+  "license": "MIT",
+  "author": "Sean Hogg",
+  "homepage": "https://github.com/SeanHogg/Builderforce.ai/tree/main/sdk#readme",
+  "bugs": {
+    "url": "https://github.com/SeanHogg/Builderforce.ai/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SeanHogg/Builderforce.ai.git",
+    "directory": "sdk"
+  },
+  "keywords": [
+    "builderforce",
+    "llm",
+    "openai-compatible",
+    "ai-gateway",
+    "chat-completions",
+    "openrouter",
+    "cerebras",
+    "ollama",
+    "sdk",
+    "typescript"
+  ],
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "check:usecases": "node scripts/check-usecases-sync.mjs",
+    "build": "tsup --config tsup.config.ts",
+    "type-check": "tsc --noEmit",
+    "test": "npm run check:usecases && vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^24.7.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.3"
+  }
+}