@optiqio/qbrix 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Optiq (Mustafa Samed Eskin)
+
+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,189 @@
+<p align="center">
+  <strong>qbrix</strong> — JavaScript/TypeScript SDK for the <a href="https://qbrix.io">Qbrix</a> platform.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@optiqio/qbrix"><img src="https://img.shields.io/npm/v/@optiqio/qbrix.svg?logo=npm&color=cb3837" alt="npm version"></a>
+  <img src="https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/eskinmi/323280689f4d0bb8c6a3e10b31e63c8d/raw/qbrix-js-coverage.json" alt="Coverage">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D18-339933?logo=node.js&logoColor=white" alt="Node >=18">
+  <img src="https://img.shields.io/badge/types-included-3178C6?logo=typescript&logoColor=white" alt="TypeScript types included">
+</p>
+
+---
+
+A tiny, isomorphic SDK for multi-armed-bandit **selection** and **feedback** — `select` an arm, render it, report a `reward`. Works in the browser, Node 18+, Deno, Bun, and edge runtimes, with **zero runtime dependencies**.
+
+## Install
+
+```bash
+npm install @optiqio/qbrix
+```
+
+## Quickstart
+
+```ts
+import { QbrixClient } from "@optiqio/qbrix";
+
+const qbrix = new QbrixClient({ apiKey: process.env.QBRIX_API_KEY });
+
+// 1. select an arm for this user/context
+const { arm, requestId } = await qbrix.select("homepage-cta", { id: "user-42" });
+
+// 2. render the chosen arm
+console.log(`showing: ${arm.name}`);
+
+// 3. report the outcome — pass back the requestId from select
+await qbrix.feedback(requestId, 1.0); // e.g. 1 = converted, 0 = no action
+```
+
+`select` returns the chosen `arm`, a `requestId`, and `isDefault`. The `requestId` is the handle that ties a later `feedback` call back to the decision — hold onto it.
+
+## Use it server-side
+
+> [!IMPORTANT]
+> Your API key (`optiq_…`) is a **secret**. The SDK sends it as an `X-API-Key` header, so anywhere the client runs, the key goes too. **Bundling it into browser code exposes it to every visitor.** Run `qbrix` on a server (route handler, edge function, backend) and keep the key in an environment variable. Have the browser call _your_ endpoint, not Qbrix directly.
+
+The recommended pattern is a thin server-side handler — the key never reaches the client:
+
+```ts
+// edge / route handler — runs on the server
+import { QbrixClient } from "@optiqio/qbrix";
+
+const qbrix = new QbrixClient({ apiKey: process.env.QBRIX_API_KEY });
+
+export default async function handler(req: Request): Promise<Response> {
+  const { userId } = await req.json();
+  const { arm, requestId } = await qbrix.select("homepage-cta", { id: userId });
+  return Response.json({ arm, requestId });
+}
+```
+
+See [`examples/edge-route.ts`](examples/edge-route.ts) and [`examples/node-quickstart.ts`](examples/node-quickstart.ts) for runnable versions.
+
+**Browser usage** is supported for trusted or low-stakes contexts (internal tools, prototypes), but it is a deliberate trade-off: a key shipped to the browser is public. Prefer a server-side proxy for anything user-facing.
+
+## API
+
+### `new QbrixClient(options?)`
+
+| Option | Type | Default | Env fallback |
+| --- | --- | --- | --- |
+| `apiKey` | `string` | — | `QBRIX_API_KEY` |
+| `baseUrl` | `string` | `http://localhost:8080` | `QBRIX_BASE_URL` |
+| `timeout` | `number` (ms) | `30000` | — |
+| `maxRetries` | `number` | `2` | — |
+| `retryOn` | `number[]` | `[429, 502, 503, 504]` | — |
+| `fetch` | `typeof fetch` | runtime global | — |
+| `headers` | `Record<string, string>` | `{}` | — |
+| `logger` | `QbrixLogger` | console (when a level is active) | — |
+| `logLevel` | `LogLevel` | `"off"` | `QBRIX_LOG`, `QBRIX_DEBUG` |
+
+Resolution order per option: explicit argument → environment variable → default.
+
+### `select(experimentId, context)`
+
+```ts
+select(experimentId: string, context: Context): Promise<SelectResult>
+```
+
+```ts
+interface Context {
+  id: string;                          // required — a stable user/session identifier
+  vector?: number[];                   // optional feature vector
+  metadata?: Record<string, unknown>;  // optional arbitrary attributes
+}
+
+interface SelectResult {
+  arm: { id: string; name: string; index: number };
+  requestId: string;   // pass this back into feedback()
+  isDefault: boolean;  // true when the platform returned the fallback arm
+}
+```
+
+### `feedback(requestId, reward)`
+
+```ts
+feedback(requestId: string, reward: number): Promise<void>
+```
+
+Reports the outcome for a prior `select`. `requestId` is the value returned by that `select`; `reward` is the observed signal (e.g. `1` for a conversion, `0` for none — any numeric reward your experiment defines).
+
+### Errors
+
+Every failure throws a typed error from the `QbrixError` hierarchy — catch the ones you care about with `instanceof`.
+
+```ts
+import {
+  QbrixAPIError,
+  RateLimitedError,
+  AuthenticationError,
+  QbrixTimeoutError,
+} from "@optiqio/qbrix";
+
+try {
+  const { arm, requestId } = await qbrix.select("homepage-cta", { id: "user-42" });
+} catch (err) {
+  if (err instanceof RateLimitedError) {
+    console.warn(`rate limited; retry after ${err.retryAfter}s`);
+  } else if (err instanceof AuthenticationError) {
+    throw new Error("check your QBRIX_API_KEY");
+  } else if (err instanceof QbrixTimeoutError) {
+    // request exceeded `timeout`
+  } else if (err instanceof QbrixAPIError) {
+    console.error(`qbrix ${err.status} ${err.code}: ${err.detail}`);
+  }
+  throw err;
+}
+```
+
+- **`QbrixError`** — base class for everything thrown by the SDK.
+- **`QbrixAPIError`** — the proxy returned a non-2xx response. Carries `status`, `detail`, a machine-readable `code`, and optional `context`. Status-specific subclasses: `BadRequestError` (400), `AuthenticationError` (401), `ForbiddenError` (403), `NotFoundError` (404), `ConflictError` (409), `RateLimitedError` (429, adds `retryAfter`), `InternalServerError` (500), `BadGatewayError` (502), `ServiceUnavailableError` (503), `GatewayTimeoutError` (504).
+- **`QbrixConnectionError`** — the request never completed (network failure).
+- **`QbrixTimeoutError`** — the request exceeded `timeout`.
+
+### Logging
+
+The SDK is **silent by default**. Turn on logging by setting `logLevel` (`"debug" | "info" | "warn" | "error" | "off"`), injecting a `logger`, or via the `QBRIX_LOG` / `QBRIX_DEBUG` environment variables — handy for debugging a running deployment without a code change.
+
+```ts
+// route to the console at a chosen verbosity
+new QbrixClient({ apiKey, logLevel: "debug" });
+
+// or plug in your own sink (pino, winston, …) — receives only request metadata
+new QbrixClient({
+  apiKey,
+  logger: {
+    debug: (msg, ctx) => log.debug(ctx, msg),
+    info: (msg, ctx) => log.info(ctx, msg),
+    warn: (msg, ctx) => log.warn(ctx, msg),
+    error: (msg, ctx) => log.error(ctx, msg),
+  },
+});
+```
+
+```bash
+QBRIX_LOG=warn node app.js   # or QBRIX_DEBUG=1 for full debug output
+```
+
+The transport logs each request attempt and success at `debug`, retries at `warn`, and failures (give-up, timeout, connection) at `error`. Log context is limited to method, path, status, and attempt counts — it **never** includes your API key, headers, or request/response bodies.
+
+## Runtime support
+
+Runs unmodified on **Node 18+, Deno, Bun, edge runtimes, and the browser** — built on universal primitives (`fetch`, `AbortController`) with zero runtime dependencies. Ships dual ESM + CJS with bundled type declarations.
+
+Full documentation: [qbrix.io/docs](https://qbrix.io/docs).
+
+## Development
+
+```bash
+npm install
+npm run build      # dual ESM + CJS + .d.ts via tsup
+npm run test       # vitest
+npm run typecheck  # tsc --noEmit
+npm run lint       # biome
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,342 @@
+'use strict';
+
+// src/logger.ts
+var RANK = {
+  debug: 10,
+  info: 20,
+  warn: 30,
+  error: 40,
+  off: 100
+};
+function shouldLog(configured, event) {
+  return RANK[event] >= RANK[configured];
+}
+var consoleLogger = {
+  debug: (message, context) => context ? console.debug(message, context) : console.debug(message),
+  info: (message, context) => context ? console.info(message, context) : console.info(message),
+  warn: (message, context) => context ? console.warn(message, context) : console.warn(message),
+  error: (message, context) => context ? console.error(message, context) : console.error(message)
+};
+
+// src/config.ts
+var LOG_LEVELS = ["debug", "info", "warn", "error", "off"];
+function resolveLogLevel(option, hasLogger) {
+  if (option) return option;
+  const env = readEnv("QBRIX_LOG");
+  if (env && LOG_LEVELS.includes(env)) return env;
+  if (readEnv("QBRIX_DEBUG")) return "debug";
+  return hasLogger ? "debug" : "off";
+}
+var DEFAULTS = {
+  baseUrl: "http://localhost:8080",
+  timeout: 3e4,
+  maxRetries: 2,
+  retryOn: [429, 502, 503, 504]
+};
+function readEnv(name) {
+  try {
+    const env = globalThis.process?.env;
+    return env?.[name];
+  } catch {
+    return void 0;
+  }
+}
+function resolveConfig(options = {}) {
+  const logLevel = resolveLogLevel(options.logLevel, options.logger !== void 0);
+  const config = {
+    apiKey: options.apiKey ?? readEnv("QBRIX_API_KEY"),
+    baseUrl: options.baseUrl ?? readEnv("QBRIX_BASE_URL") ?? DEFAULTS.baseUrl,
+    timeout: options.timeout ?? DEFAULTS.timeout,
+    maxRetries: options.maxRetries ?? DEFAULTS.maxRetries,
+    retryOn: options.retryOn ?? [...DEFAULTS.retryOn],
+    fetch: options.fetch,
+    headers: options.headers ?? {},
+    logger: options.logger ?? (logLevel === "off" ? void 0 : consoleLogger),
+    logLevel
+  };
+  if (config.timeout <= 0) {
+    throw new Error(`qbrix: timeout must be > 0, got ${config.timeout}`);
+  }
+  if (config.maxRetries < 0) {
+    throw new Error(`qbrix: maxRetries must be >= 0, got ${config.maxRetries}`);
+  }
+  return config;
+}
+
+// src/errors.ts
+var QbrixError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = new.target.name;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var QbrixAPIError = class extends QbrixError {
+  status;
+  detail;
+  code;
+  context;
+  constructor(status, detail, options) {
+    super(`[${status}] ${detail}`);
+    this.status = status;
+    this.detail = detail;
+    this.code = options?.code;
+    this.context = options?.context;
+  }
+};
+var BadRequestError = class extends QbrixAPIError {
+};
+var AuthenticationError = class extends QbrixAPIError {
+};
+var ForbiddenError = class extends QbrixAPIError {
+};
+var NotFoundError = class extends QbrixAPIError {
+};
+var ConflictError = class extends QbrixAPIError {
+};
+var RateLimitedError = class extends QbrixAPIError {
+  retryAfter;
+  constructor(status, detail, options) {
+    super(status, detail, options);
+    this.retryAfter = options?.retryAfter;
+  }
+};
+var InternalServerError = class extends QbrixAPIError {
+};
+var BadGatewayError = class extends QbrixAPIError {
+};
+var ServiceUnavailableError = class extends QbrixAPIError {
+};
+var GatewayTimeoutError = class extends QbrixAPIError {
+};
+var QbrixConnectionError = class extends QbrixError {
+};
+var QbrixTimeoutError = class extends QbrixError {
+};
+var STATUS_TO_ERROR = {
+  400: BadRequestError,
+  401: AuthenticationError,
+  403: ForbiddenError,
+  404: NotFoundError,
+  409: ConflictError,
+  429: RateLimitedError,
+  500: InternalServerError,
+  502: BadGatewayError,
+  503: ServiceUnavailableError,
+  504: GatewayTimeoutError
+};
+
+// src/mapper.ts
+function toSelectRequest(params) {
+  const { id, vector, metadata } = params.context;
+  return {
+    experiment_id: params.experimentId,
+    context: {
+      id,
+      ...vector !== void 0 && { vector },
+      ...metadata !== void 0 && { metadata }
+    }
+  };
+}
+function fromSelectResponse(wire) {
+  return {
+    arm: { id: wire.arm.id, name: wire.arm.name, index: wire.arm.index },
+    requestId: wire.request_id,
+    isDefault: wire.is_default
+  };
+}
+function toFeedbackRequest(params) {
+  return {
+    request_id: params.requestId,
+    reward: params.reward
+  };
+}
+
+// src/transport.ts
+var RETRY_BASE_DELAY_MS = 500;
+var RETRY_MAX_DELAY_MS = 8e3;
+function emit(config, level, message, context) {
+  if (config.logger && shouldLog(config.logLevel, level)) {
+    config.logger[level](message, context);
+  }
+}
+async function request(config, method, path, options = {}) {
+  const fetchImpl = config.fetch ?? globalThis.fetch;
+  const url = joinUrl(config.baseUrl, path);
+  const headers = buildHeaders(config);
+  const body = options.body === void 0 ? void 0 : JSON.stringify(options.body);
+  for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+    emit(config, "debug", "request attempt", {
+      method,
+      path,
+      attempt: attempt + 1,
+      attempts: config.maxRetries + 1
+    });
+    const timeoutSignal = AbortSignal.timeout(config.timeout);
+    const signal = combineSignals(options.signal, timeoutSignal);
+    let response;
+    try {
+      response = await fetchImpl(url, { method, headers, body, signal });
+    } catch (err) {
+      if (options.signal?.aborted) throw options.signal.reason ?? err;
+      if (timeoutSignal.aborted) {
+        emit(config, "error", "request timed out", { method, path });
+        throw new QbrixTimeoutError(`qbrix: request timed out after ${config.timeout}ms`);
+      }
+      emit(config, "error", "request connection error", { method, path });
+      throw new QbrixConnectionError(err instanceof Error ? err.message : String(err));
+    }
+    if (response.ok) {
+      emit(config, "debug", "request succeeded", { method, path, status: response.status });
+      if (response.status === 204) return void 0;
+      const text = await response.text();
+      return text ? JSON.parse(text) : void 0;
+    }
+    const error = await makeApiError(response);
+    if (!config.retryOn.includes(response.status) || attempt === config.maxRetries) {
+      emit(config, "error", "request failed", { method, path, status: response.status });
+      throw error;
+    }
+    const delay = retryDelay(attempt, error);
+    emit(config, "warn", "request retrying", {
+      method,
+      path,
+      status: response.status,
+      attempt: attempt + 1,
+      delayMs: Math.round(delay)
+    });
+    await sleep(delay, options.signal);
+  }
+  throw new QbrixError("qbrix: request failed");
+}
+function joinUrl(baseUrl, path) {
+  const base = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+  const suffix = path.startsWith("/") ? path : `/${path}`;
+  return `${base}${suffix}`;
+}
+function combineSignals(caller, timeout) {
+  if (!caller) return timeout;
+  const anyFn = AbortSignal.any;
+  if (typeof anyFn === "function") return anyFn([caller, timeout]);
+  const controller = new AbortController();
+  const forward = (source) => () => controller.abort(source.reason);
+  if (caller.aborted) controller.abort(caller.reason);
+  else if (timeout.aborted) controller.abort(timeout.reason);
+  else {
+    caller.addEventListener("abort", forward(caller), { once: true });
+    timeout.addEventListener("abort", forward(timeout), { once: true });
+  }
+  return controller.signal;
+}
+async function makeApiError(response) {
+  const raw = await response.text();
+  let detail = raw || response.statusText;
+  let code;
+  let context;
+  if (raw) {
+    try {
+      const parsed = JSON.parse(raw);
+      if (typeof parsed.detail === "string") detail = parsed.detail;
+      if (typeof parsed.code === "string") code = parsed.code;
+      if (parsed.context && typeof parsed.context === "object") {
+        context = parsed.context;
+      }
+    } catch {
+    }
+  }
+  const status = response.status;
+  if (status === 429) {
+    const header = response.headers.get("Retry-After");
+    const seconds = header ? Number.parseFloat(header) : Number.NaN;
+    return new RateLimitedError(status, detail, {
+      code,
+      context,
+      retryAfter: Number.isFinite(seconds) ? seconds : void 0
+    });
+  }
+  const ErrorClass = STATUS_TO_ERROR[status] ?? QbrixAPIError;
+  return new ErrorClass(status, detail, { code, context });
+}
+function retryDelay(attempt, error) {
+  if (error instanceof RateLimitedError && error.retryAfter !== void 0) {
+    return Math.min(error.retryAfter * 1e3, RETRY_MAX_DELAY_MS);
+  }
+  const base = Math.min(RETRY_BASE_DELAY_MS * 2 ** attempt, RETRY_MAX_DELAY_MS);
+  return base + Math.random() * base * 0.1;
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(signal.reason);
+      return;
+    }
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    function onAbort() {
+      clearTimeout(timer);
+      reject(signal?.reason);
+    }
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+
+// src/version.ts
+var VERSION = "0.0.0";
+
+// src/client.ts
+function buildHeaders(config) {
+  const headers = {
+    Accept: "application/json",
+    "Content-Type": "application/json"
+  };
+  if (config.apiKey) {
+    headers["X-API-Key"] = config.apiKey;
+  }
+  if (typeof document === "undefined") {
+    headers["User-Agent"] = `qbrix-js/${VERSION}`;
+  }
+  return { ...headers, ...config.headers };
+}
+var QbrixClient = class {
+  config;
+  constructor(options = {}) {
+    this.config = resolveConfig(options);
+  }
+  async select(experimentId, context) {
+    const body = toSelectRequest({ experimentId, context });
+    const wire = await request(
+      this.config,
+      "POST",
+      "/api/v1/agent/select",
+      { body }
+    );
+    if (wire === void 0) {
+      throw new QbrixError("qbrix: select returned no response body");
+    }
+    return fromSelectResponse(wire);
+  }
+  async feedback(requestId, reward) {
+    const body = toFeedbackRequest({ requestId, reward });
+    await request(this.config, "POST", "/api/v1/agent/feedback", { body });
+  }
+};
+
+exports.AuthenticationError = AuthenticationError;
+exports.BadGatewayError = BadGatewayError;
+exports.BadRequestError = BadRequestError;
+exports.ConflictError = ConflictError;
+exports.ForbiddenError = ForbiddenError;
+exports.GatewayTimeoutError = GatewayTimeoutError;
+exports.InternalServerError = InternalServerError;
+exports.NotFoundError = NotFoundError;
+exports.QbrixAPIError = QbrixAPIError;
+exports.QbrixClient = QbrixClient;
+exports.QbrixConnectionError = QbrixConnectionError;
+exports.QbrixError = QbrixError;
+exports.QbrixTimeoutError = QbrixTimeoutError;
+exports.RateLimitedError = RateLimitedError;
+exports.ServiceUnavailableError = ServiceUnavailableError;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logger.ts","../src/config.ts","../src/errors.ts","../src/mapper.ts","../src/transport.ts","../src/version.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["// pluggable, leveled logging. the sdk is silent by default (logLevel \"off\") and\n// only emits when a level is configured (via the logLevel option, the QBRIX_LOG\n// / QBRIX_DEBUG env vars, or by injecting a logger). the sdk passes only\n// non-sensitive context (method, path, status, attempt counts) — never the api\n// key, headers, or request/response bodies.\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"off\";\n\nexport interface QbrixLogger {\n  debug(message: string, context?: Record<string, unknown>): void;\n  info(message: string, context?: Record<string, unknown>): void;\n  warn(message: string, context?: Record<string, unknown>): void;\n  error(message: string, context?: Record<string, unknown>): void;\n}\n\nconst RANK: Record<LogLevel, number> = {\n  debug: 10,\n  info: 20,\n  warn: 30,\n  error: 40,\n  off: 100,\n};\n\n// emit an event at `event` level only when it meets the configured threshold.\nexport function shouldLog(configured: LogLevel, event: Exclude<LogLevel, \"off\">): boolean {\n  return RANK[event] >= RANK[configured];\n}\n\n// built-in sink for the env / logLevel opt-in; routes each level to console.\nexport const consoleLogger: QbrixLogger = {\n  debug: (message, context) => (context ? console.debug(message, context) : console.debug(message)),\n  info: (message, context) => (context ? console.info(message, context) : console.info(message)),\n  warn: (message, context) => (context ? console.warn(message, context) : console.warn(message)),\n  error: (message, context) => (context ? console.error(message, context) : console.error(message)),\n};\n","import type { QbrixClientOptions } from \"./client\";\nimport { type LogLevel, type QbrixLogger, consoleLogger } from \"./logger\";\n\nexport interface ResolvedConfig {\n  apiKey: string | undefined;\n  baseUrl: string;\n  timeout: number;\n  maxRetries: number;\n  retryOn: number[];\n  fetch: typeof fetch | undefined;\n  headers: Record<string, string>;\n  logger: QbrixLogger | undefined;\n  logLevel: LogLevel;\n}\n\nconst LOG_LEVELS: readonly LogLevel[] = [\"debug\", \"info\", \"warn\", \"error\", \"off\"];\n\n// precedence: explicit option → QBRIX_LOG → QBRIX_DEBUG (sugar for \"debug\") →\n// \"debug\" when a logger is injected (opt-in by passing one) → \"off\" (silent).\nfunction resolveLogLevel(option: LogLevel | undefined, hasLogger: boolean): LogLevel {\n  if (option) return option;\n  const env = readEnv(\"QBRIX_LOG\");\n  if (env && (LOG_LEVELS as readonly string[]).includes(env)) return env as LogLevel;\n  if (readEnv(\"QBRIX_DEBUG\")) return \"debug\";\n  return hasLogger ? \"debug\" : \"off\";\n}\n\n// todo: check the defaults / might want to add the hosted url here / update the timeout to be low latency etc.\nconst DEFAULTS = {\n  baseUrl: \"http://localhost:8080\",\n  timeout: 30_000,\n  maxRetries: 2,\n  retryOn: [429, 502, 503, 504] as number[],\n};\n\n// guarded globalThis access keeps the browser bundle clean and avoids needing `@types/node`.\n// the try/catch matters for deno, where reading `process.env` throws without `--allow-env` —\n// the sdk treats env as unset rather than crashing.\nfunction readEnv(name: string): string | undefined {\n  try {\n    const env = (globalThis as { process?: { env?: Record<string, string | undefined> } }).process\n      ?.env;\n    return env?.[name];\n  } catch {\n    return undefined;\n  }\n}\n\n// precedence per option: explicit arg → env var → default\nexport function resolveConfig(options: QbrixClientOptions = {}): ResolvedConfig {\n  const logLevel = resolveLogLevel(options.logLevel, options.logger !== undefined);\n  const config: ResolvedConfig = {\n    apiKey: options.apiKey ?? readEnv(\"QBRIX_API_KEY\"),\n    baseUrl: options.baseUrl ?? readEnv(\"QBRIX_BASE_URL\") ?? DEFAULTS.baseUrl,\n    timeout: options.timeout ?? DEFAULTS.timeout,\n    maxRetries: options.maxRetries ?? DEFAULTS.maxRetries,\n    retryOn: options.retryOn ?? [...DEFAULTS.retryOn],\n    fetch: options.fetch,\n    headers: options.headers ?? {},\n    logger: options.logger ?? (logLevel === \"off\" ? undefined : consoleLogger),\n    logLevel,\n  };\n\n  if (config.timeout <= 0) {\n    throw new Error(`qbrix: timeout must be > 0, got ${config.timeout}`);\n  }\n  if (config.maxRetries < 0) {\n    throw new Error(`qbrix: maxRetries must be >= 0, got ${config.maxRetries}`);\n  }\n\n  return config;\n}\n","import type { ErrorCode } from \"./types\";\n\nexport class QbrixError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = new.target.name;\n    // keep instanceof working when consumers downlevel below es2015\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n// `string & {}` keeps autocomplete of the known codes while tolerating codes a\n// newer backend may send before the sdk's generated union catches up.\ninterface ApiErrorOptions {\n  code?: ErrorCode | (string & {});\n  context?: Record<string, unknown>;\n}\n\nexport class QbrixAPIError extends QbrixError {\n  readonly status: number;\n  readonly detail: string;\n  readonly code: ErrorCode | (string & {}) | undefined;\n  readonly context: Record<string, unknown> | undefined;\n\n  constructor(status: number, detail: string, options?: ApiErrorOptions) {\n    super(`[${status}] ${detail}`);\n    this.status = status;\n    this.detail = detail;\n    this.code = options?.code;\n    this.context = options?.context;\n  }\n}\n\nexport class BadRequestError extends QbrixAPIError {}\nexport class AuthenticationError extends QbrixAPIError {}\nexport class ForbiddenError extends QbrixAPIError {}\nexport class NotFoundError extends QbrixAPIError {}\nexport class ConflictError extends QbrixAPIError {}\n\ninterface RateLimitedErrorOptions extends ApiErrorOptions {\n  retryAfter?: number;\n}\n\nexport class RateLimitedError extends QbrixAPIError {\n  readonly retryAfter: number | undefined;\n\n  constructor(status: number, detail: string, options?: RateLimitedErrorOptions) {\n    super(status, detail, options);\n    this.retryAfter = options?.retryAfter;\n  }\n}\n\nexport class InternalServerError extends QbrixAPIError {}\nexport class BadGatewayError extends QbrixAPIError {}\nexport class ServiceUnavailableError extends QbrixAPIError {}\nexport class GatewayTimeoutError extends QbrixAPIError {}\n\nexport class QbrixConnectionError extends QbrixError {}\nexport class QbrixTimeoutError extends QbrixError {}\n\ntype ApiErrorConstructor = new (\n  status: number,\n  detail: string,\n  options?: ApiErrorOptions,\n) => QbrixAPIError;\n\nexport const STATUS_TO_ERROR: Record<number, ApiErrorConstructor> = {\n  400: BadRequestError,\n  401: AuthenticationError,\n  403: ForbiddenError,\n  404: NotFoundError,\n  409: ConflictError,\n  429: RateLimitedError,\n  500: InternalServerError,\n  502: BadGatewayError,\n  503: ServiceUnavailableError,\n  504: GatewayTimeoutError,\n};\n","import type { components } from \"./generated\";\nimport type { FeedbackParams, SelectParams, SelectResult } from \"./types\";\n\ntype WireSelectRequest = components[\"schemas\"][\"AgentSelectRequest\"];\ntype WireSelectResponse = components[\"schemas\"][\"AgentSelectResponse\"];\ntype WireFeedbackRequest = components[\"schemas\"][\"AgentFeedbackRequest\"];\n\nexport function toSelectRequest(params: SelectParams): WireSelectRequest {\n  const { id, vector, metadata } = params.context;\n  return {\n    experiment_id: params.experimentId,\n    context: {\n      id,\n      ...(vector !== undefined && { vector }),\n      ...(metadata !== undefined && { metadata }),\n    },\n  };\n}\n\nexport function fromSelectResponse(wire: WireSelectResponse): SelectResult {\n  return {\n    arm: { id: wire.arm.id, name: wire.arm.name, index: wire.arm.index },\n    requestId: wire.request_id,\n    isDefault: wire.is_default,\n  };\n}\n\nexport function toFeedbackRequest(params: FeedbackParams): WireFeedbackRequest {\n  return {\n    request_id: params.requestId,\n    reward: params.reward,\n  };\n}\n","import { buildHeaders } from \"./client\";\nimport type { ResolvedConfig } from \"./config\";\nimport {\n  QbrixAPIError,\n  QbrixConnectionError,\n  QbrixError,\n  QbrixTimeoutError,\n  RateLimitedError,\n  STATUS_TO_ERROR,\n} from \"./errors\";\nimport type { components } from \"./generated\";\nimport { type LogLevel, shouldLog } from \"./logger\";\n\nexport interface RequestOptions {\n  body?: unknown;\n  signal?: AbortSignal;\n}\n\nconst RETRY_BASE_DELAY_MS = 500;\nconst RETRY_MAX_DELAY_MS = 8_000;\n\nfunction emit(\n  config: ResolvedConfig,\n  level: Exclude<LogLevel, \"off\">,\n  message: string,\n  context: Record<string, unknown>,\n): void {\n  if (config.logger && shouldLog(config.logLevel, level)) {\n    config.logger[level](message, context);\n  }\n}\n\nexport async function request<T>(\n  config: ResolvedConfig,\n  method: string,\n  path: string,\n  options: RequestOptions = {},\n): Promise<T | undefined> {\n  const fetchImpl = config.fetch ?? globalThis.fetch;\n  const url = joinUrl(config.baseUrl, path);\n  const headers = buildHeaders(config);\n  const body = options.body === undefined ? undefined : JSON.stringify(options.body);\n\n  for (let attempt = 0; attempt <= config.maxRetries; attempt++) {\n    emit(config, \"debug\", \"request attempt\", {\n      method,\n      path,\n      attempt: attempt + 1,\n      attempts: config.maxRetries + 1,\n    });\n    const timeoutSignal = AbortSignal.timeout(config.timeout);\n    const signal = combineSignals(options.signal, timeoutSignal);\n\n    let response: Response;\n    try {\n      response = await fetchImpl(url, { method, headers, body, signal });\n    } catch (err) {\n      // caller-initiated abort takes precedence and propagates unchanged\n      if (options.signal?.aborted) throw options.signal.reason ?? err;\n      if (timeoutSignal.aborted) {\n        emit(config, \"error\", \"request timed out\", { method, path });\n        throw new QbrixTimeoutError(`qbrix: request timed out after ${config.timeout}ms`);\n      }\n      emit(config, \"error\", \"request connection error\", { method, path });\n      throw new QbrixConnectionError(err instanceof Error ? err.message : String(err));\n    }\n\n    if (response.ok) {\n      emit(config, \"debug\", \"request succeeded\", { method, path, status: response.status });\n      if (response.status === 204) return undefined;\n      const text = await response.text();\n      return text ? (JSON.parse(text) as T) : undefined;\n    }\n\n    const error = await makeApiError(response);\n    if (!config.retryOn.includes(response.status) || attempt === config.maxRetries) {\n      emit(config, \"error\", \"request failed\", { method, path, status: response.status });\n      throw error;\n    }\n    const delay = retryDelay(attempt, error);\n    emit(config, \"warn\", \"request retrying\", {\n      method,\n      path,\n      status: response.status,\n      attempt: attempt + 1,\n      delayMs: Math.round(delay),\n    });\n    await sleep(delay, options.signal);\n  }\n\n  // unreachable: the final attempt always returns or throws\n  throw new QbrixError(\"qbrix: request failed\");\n}\n\nfunction joinUrl(baseUrl: string, path: string): string {\n  const base = baseUrl.endsWith(\"/\") ? baseUrl.slice(0, -1) : baseUrl;\n  const suffix = path.startsWith(\"/\") ? path : `/${path}`;\n  return `${base}${suffix}`;\n}\n\nfunction combineSignals(caller: AbortSignal | undefined, timeout: AbortSignal): AbortSignal {\n  if (!caller) return timeout;\n  const anyFn = (AbortSignal as unknown as { any?: (signals: AbortSignal[]) => AbortSignal }).any;\n  if (typeof anyFn === \"function\") return anyFn([caller, timeout]);\n\n  // manual fallback for runtimes without AbortSignal.any\n  const controller = new AbortController();\n  const forward = (source: AbortSignal) => () => controller.abort(source.reason);\n  if (caller.aborted) controller.abort(caller.reason);\n  else if (timeout.aborted) controller.abort(timeout.reason);\n  else {\n    caller.addEventListener(\"abort\", forward(caller), { once: true });\n    timeout.addEventListener(\"abort\", forward(timeout), { once: true });\n  }\n  return controller.signal;\n}\n\ntype WireError = components[\"schemas\"][\"ErrorResponse\"];\n\nasync function makeApiError(response: Response): Promise<QbrixAPIError> {\n  // read the body once; fetch streams can't be re-read after JSON.parse fails\n  const raw = await response.text();\n  let detail = raw || response.statusText;\n  let code: WireError[\"code\"] | undefined;\n  let context: Record<string, unknown> | undefined;\n  if (raw) {\n    try {\n      const parsed = JSON.parse(raw) as Partial<WireError>;\n      if (typeof parsed.detail === \"string\") detail = parsed.detail;\n      if (typeof parsed.code === \"string\") code = parsed.code;\n      if (parsed.context && typeof parsed.context === \"object\") {\n        context = parsed.context as Record<string, unknown>;\n      }\n    } catch {\n      // non-json body — keep the raw text as detail\n    }\n  }\n\n  const status = response.status;\n  if (status === 429) {\n    const header = response.headers.get(\"Retry-After\");\n    const seconds = header ? Number.parseFloat(header) : Number.NaN;\n    return new RateLimitedError(status, detail, {\n      code,\n      context,\n      retryAfter: Number.isFinite(seconds) ? seconds : undefined,\n    });\n  }\n\n  const ErrorClass = STATUS_TO_ERROR[status] ?? QbrixAPIError;\n  return new ErrorClass(status, detail, { code, context });\n}\n\nfunction retryDelay(attempt: number, error: QbrixAPIError): number {\n  if (error instanceof RateLimitedError && error.retryAfter !== undefined) {\n    return Math.min(error.retryAfter * 1000, RETRY_MAX_DELAY_MS);\n  }\n  const base = Math.min(RETRY_BASE_DELAY_MS * 2 ** attempt, RETRY_MAX_DELAY_MS);\n  return base + Math.random() * base * 0.1;\n}\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(signal.reason);\n      return;\n    }\n    const timer = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    function onAbort() {\n      clearTimeout(timer);\n      reject(signal?.reason);\n    }\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n","// kept in sync with package.json by release tooling (OPT-41).\nexport const VERSION = \"0.0.0\";\n","import type { ResolvedConfig } from \"./config\";\nimport { resolveConfig } from \"./config\";\nimport { QbrixError } from \"./errors\";\nimport type { components } from \"./generated\";\nimport type { LogLevel, QbrixLogger } from \"./logger\";\nimport { fromSelectResponse, toFeedbackRequest, toSelectRequest } from \"./mapper\";\nimport { request } from \"./transport\";\nimport type { Context, SelectResult } from \"./types\";\nimport { VERSION } from \"./version\";\n\nexport interface QbrixClientOptions {\n  /** qbrix api key (prefix `optiq_`). falls back to `QBRIX_API_KEY`. */\n  apiKey?: string;\n  /** base url of the qbrix proxy. falls back to `QBRIX_BASE_URL`. */\n  baseUrl?: string;\n  /** request timeout in milliseconds. */\n  timeout?: number;\n  /** max retry attempts on retryable status codes. */\n  maxRetries?: number;\n  /** status codes to retry. */\n  retryOn?: number[];\n  /** custom fetch implementation, injectable for tests and custom runtimes. */\n  fetch?: typeof fetch;\n  /** extra headers merged into every request; user headers override the defaults. */\n  headers?: Record<string, string>;\n  /** optional log sink; never receives secrets. defaults to a console sink when a level is active. */\n  logger?: QbrixLogger;\n  /** logging verbosity. defaults to \"off\" (silent); also read from QBRIX_LOG / QBRIX_DEBUG. */\n  logLevel?: LogLevel;\n}\n\nexport function buildHeaders(config: ResolvedConfig): Record<string, string> {\n  const headers: Record<string, string> = {\n    Accept: \"application/json\",\n    \"Content-Type\": \"application/json\",\n  };\n  if (config.apiKey) {\n    headers[\"X-API-Key\"] = config.apiKey;\n  }\n  // browsers forbid setting User-Agent and drop or error on the attempt\n  if (typeof document === \"undefined\") {\n    headers[\"User-Agent\"] = `qbrix-js/${VERSION}`;\n  }\n  return { ...headers, ...config.headers };\n}\n\nexport class QbrixClient {\n  readonly config: ResolvedConfig;\n\n  constructor(options: QbrixClientOptions = {}) {\n    this.config = resolveConfig(options);\n  }\n\n  async select(experimentId: string, context: Context): Promise<SelectResult> {\n    const body = toSelectRequest({ experimentId, context });\n    const wire = await request<components[\"schemas\"][\"AgentSelectResponse\"]>(\n      this.config,\n      \"POST\",\n      \"/api/v1/agent/select\",\n      { body },\n    );\n    if (wire === undefined) {\n      throw new QbrixError(\"qbrix: select returned no response body\");\n    }\n    return fromSelectResponse(wire);\n  }\n\n  async feedback(requestId: string, reward: number): Promise<void> {\n    const body = toFeedbackRequest({ requestId, reward });\n    await request(this.config, \"POST\", \"/api/v1/agent/feedback\", { body });\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,117 @@
+type LogLevel = "debug" | "info" | "warn" | "error" | "off";
+interface QbrixLogger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+
+interface ResolvedConfig {
+    apiKey: string | undefined;
+    baseUrl: string;
+    timeout: number;
+    maxRetries: number;
+    retryOn: number[];
+    fetch: typeof fetch | undefined;
+    headers: Record<string, string>;
+    logger: QbrixLogger | undefined;
+    logLevel: LogLevel;
+}
+
+type ErrorCode = "INTERNAL_ERROR" | "BAD_REQUEST" | "FEEDBACK_FAILED" | "INVALID_POLICY_PARAMS" | "UNAUTHORIZED" | "INVALID_TOKEN" | "INVALID_API_KEY" | "FORBIDDEN" | "INSUFFICIENT_SCOPES" | "PLAN_TIER_REQUIRED" | "LEARNER_EXPERIMENT_DELETE_FORBIDDEN" | "NOT_FOUND" | "POOL_NOT_FOUND" | "EXPERIMENT_NOT_FOUND" | "USER_NOT_FOUND" | "GATE_NOT_FOUND" | "CONFLICT" | "USER_ALREADY_EXISTS" | "API_KEY_LIMIT_REACHED" | "EXPERIMENT_LIMIT_REACHED" | "POOL_HAS_EXPERIMENTS" | "RATE_LIMITED" | "POOL_CREATION_FAILED" | "EXPERIMENT_CREATION_FAILED" | "SELECTION_FAILED" | "SERVICE_UNAVAILABLE";
+interface Context {
+    id: string;
+    vector?: number[];
+    metadata?: Record<string, unknown>;
+}
+interface Arm {
+    id: string;
+    name: string;
+    index: number;
+}
+interface SelectParams {
+    experimentId: string;
+    context: Context;
+}
+interface SelectResult {
+    arm: Arm;
+    requestId: string;
+    isDefault: boolean;
+}
+interface FeedbackParams {
+    requestId: string;
+    reward: number;
+}
+
+interface QbrixClientOptions {
+    /** qbrix api key (prefix `optiq_`). falls back to `QBRIX_API_KEY`. */
+    apiKey?: string;
+    /** base url of the qbrix proxy. falls back to `QBRIX_BASE_URL`. */
+    baseUrl?: string;
+    /** request timeout in milliseconds. */
+    timeout?: number;
+    /** max retry attempts on retryable status codes. */
+    maxRetries?: number;
+    /** status codes to retry. */
+    retryOn?: number[];
+    /** custom fetch implementation, injectable for tests and custom runtimes. */
+    fetch?: typeof fetch;
+    /** extra headers merged into every request; user headers override the defaults. */
+    headers?: Record<string, string>;
+    /** optional log sink; never receives secrets. defaults to a console sink when a level is active. */
+    logger?: QbrixLogger;
+    /** logging verbosity. defaults to "off" (silent); also read from QBRIX_LOG / QBRIX_DEBUG. */
+    logLevel?: LogLevel;
+}
+declare class QbrixClient {
+    readonly config: ResolvedConfig;
+    constructor(options?: QbrixClientOptions);
+    select(experimentId: string, context: Context): Promise<SelectResult>;
+    feedback(requestId: string, reward: number): Promise<void>;
+}
+
+declare class QbrixError extends Error {
+    constructor(message: string);
+}
+interface ApiErrorOptions {
+    code?: ErrorCode | (string & {});
+    context?: Record<string, unknown>;
+}
+declare class QbrixAPIError extends QbrixError {
+    readonly status: number;
+    readonly detail: string;
+    readonly code: ErrorCode | (string & {}) | undefined;
+    readonly context: Record<string, unknown> | undefined;
+    constructor(status: number, detail: string, options?: ApiErrorOptions);
+}
+declare class BadRequestError extends QbrixAPIError {
+}
+declare class AuthenticationError extends QbrixAPIError {
+}
+declare class ForbiddenError extends QbrixAPIError {
+}
+declare class NotFoundError extends QbrixAPIError {
+}
+declare class ConflictError extends QbrixAPIError {
+}
+interface RateLimitedErrorOptions extends ApiErrorOptions {
+    retryAfter?: number;
+}
+declare class RateLimitedError extends QbrixAPIError {
+    readonly retryAfter: number | undefined;
+    constructor(status: number, detail: string, options?: RateLimitedErrorOptions);
+}
+declare class InternalServerError extends QbrixAPIError {
+}
+declare class BadGatewayError extends QbrixAPIError {
+}
+declare class ServiceUnavailableError extends QbrixAPIError {
+}
+declare class GatewayTimeoutError extends QbrixAPIError {
+}
+declare class QbrixConnectionError extends QbrixError {
+}
+declare class QbrixTimeoutError extends QbrixError {
+}
+
+export { type Arm, AuthenticationError, BadGatewayError, BadRequestError, ConflictError, type Context, type ErrorCode, type FeedbackParams, ForbiddenError, GatewayTimeoutError, InternalServerError, type LogLevel, NotFoundError, QbrixAPIError, QbrixClient, type QbrixClientOptions, QbrixConnectionError, QbrixError, type QbrixLogger, QbrixTimeoutError, RateLimitedError, type SelectParams, type SelectResult, ServiceUnavailableError };

package/dist/index.d.ts

@@ -0,0 +1,117 @@
+type LogLevel = "debug" | "info" | "warn" | "error" | "off";
+interface QbrixLogger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+
+interface ResolvedConfig {
+    apiKey: string | undefined;
+    baseUrl: string;
+    timeout: number;
+    maxRetries: number;
+    retryOn: number[];
+    fetch: typeof fetch | undefined;
+    headers: Record<string, string>;
+    logger: QbrixLogger | undefined;
+    logLevel: LogLevel;
+}
+
+type ErrorCode = "INTERNAL_ERROR" | "BAD_REQUEST" | "FEEDBACK_FAILED" | "INVALID_POLICY_PARAMS" | "UNAUTHORIZED" | "INVALID_TOKEN" | "INVALID_API_KEY" | "FORBIDDEN" | "INSUFFICIENT_SCOPES" | "PLAN_TIER_REQUIRED" | "LEARNER_EXPERIMENT_DELETE_FORBIDDEN" | "NOT_FOUND" | "POOL_NOT_FOUND" | "EXPERIMENT_NOT_FOUND" | "USER_NOT_FOUND" | "GATE_NOT_FOUND" | "CONFLICT" | "USER_ALREADY_EXISTS" | "API_KEY_LIMIT_REACHED" | "EXPERIMENT_LIMIT_REACHED" | "POOL_HAS_EXPERIMENTS" | "RATE_LIMITED" | "POOL_CREATION_FAILED" | "EXPERIMENT_CREATION_FAILED" | "SELECTION_FAILED" | "SERVICE_UNAVAILABLE";
+interface Context {
+    id: string;
+    vector?: number[];
+    metadata?: Record<string, unknown>;
+}
+interface Arm {
+    id: string;
+    name: string;
+    index: number;
+}
+interface SelectParams {
+    experimentId: string;
+    context: Context;
+}
+interface SelectResult {
+    arm: Arm;
+    requestId: string;
+    isDefault: boolean;
+}
+interface FeedbackParams {
+    requestId: string;
+    reward: number;
+}
+
+interface QbrixClientOptions {
+    /** qbrix api key (prefix `optiq_`). falls back to `QBRIX_API_KEY`. */
+    apiKey?: string;
+    /** base url of the qbrix proxy. falls back to `QBRIX_BASE_URL`. */
+    baseUrl?: string;
+    /** request timeout in milliseconds. */
+    timeout?: number;
+    /** max retry attempts on retryable status codes. */
+    maxRetries?: number;
+    /** status codes to retry. */
+    retryOn?: number[];
+    /** custom fetch implementation, injectable for tests and custom runtimes. */
+    fetch?: typeof fetch;
+    /** extra headers merged into every request; user headers override the defaults. */
+    headers?: Record<string, string>;
+    /** optional log sink; never receives secrets. defaults to a console sink when a level is active. */
+    logger?: QbrixLogger;
+    /** logging verbosity. defaults to "off" (silent); also read from QBRIX_LOG / QBRIX_DEBUG. */
+    logLevel?: LogLevel;
+}
+declare class QbrixClient {
+    readonly config: ResolvedConfig;
+    constructor(options?: QbrixClientOptions);
+    select(experimentId: string, context: Context): Promise<SelectResult>;
+    feedback(requestId: string, reward: number): Promise<void>;
+}
+
+declare class QbrixError extends Error {
+    constructor(message: string);
+}
+interface ApiErrorOptions {
+    code?: ErrorCode | (string & {});
+    context?: Record<string, unknown>;
+}
+declare class QbrixAPIError extends QbrixError {
+    readonly status: number;
+    readonly detail: string;
+    readonly code: ErrorCode | (string & {}) | undefined;
+    readonly context: Record<string, unknown> | undefined;
+    constructor(status: number, detail: string, options?: ApiErrorOptions);
+}
+declare class BadRequestError extends QbrixAPIError {
+}
+declare class AuthenticationError extends QbrixAPIError {
+}
+declare class ForbiddenError extends QbrixAPIError {
+}
+declare class NotFoundError extends QbrixAPIError {
+}
+declare class ConflictError extends QbrixAPIError {
+}
+interface RateLimitedErrorOptions extends ApiErrorOptions {
+    retryAfter?: number;
+}
+declare class RateLimitedError extends QbrixAPIError {
+    readonly retryAfter: number | undefined;
+    constructor(status: number, detail: string, options?: RateLimitedErrorOptions);
+}
+declare class InternalServerError extends QbrixAPIError {
+}
+declare class BadGatewayError extends QbrixAPIError {
+}
+declare class ServiceUnavailableError extends QbrixAPIError {
+}
+declare class GatewayTimeoutError extends QbrixAPIError {
+}
+declare class QbrixConnectionError extends QbrixError {
+}
+declare class QbrixTimeoutError extends QbrixError {
+}
+
+export { type Arm, AuthenticationError, BadGatewayError, BadRequestError, ConflictError, type Context, type ErrorCode, type FeedbackParams, ForbiddenError, GatewayTimeoutError, InternalServerError, type LogLevel, NotFoundError, QbrixAPIError, QbrixClient, type QbrixClientOptions, QbrixConnectionError, QbrixError, type QbrixLogger, QbrixTimeoutError, RateLimitedError, type SelectParams, type SelectResult, ServiceUnavailableError };

package/dist/index.js

@@ -0,0 +1,326 @@
+// src/logger.ts
+var RANK = {
+  debug: 10,
+  info: 20,
+  warn: 30,
+  error: 40,
+  off: 100
+};
+function shouldLog(configured, event) {
+  return RANK[event] >= RANK[configured];
+}
+var consoleLogger = {
+  debug: (message, context) => context ? console.debug(message, context) : console.debug(message),
+  info: (message, context) => context ? console.info(message, context) : console.info(message),
+  warn: (message, context) => context ? console.warn(message, context) : console.warn(message),
+  error: (message, context) => context ? console.error(message, context) : console.error(message)
+};
+
+// src/config.ts
+var LOG_LEVELS = ["debug", "info", "warn", "error", "off"];
+function resolveLogLevel(option, hasLogger) {
+  if (option) return option;
+  const env = readEnv("QBRIX_LOG");
+  if (env && LOG_LEVELS.includes(env)) return env;
+  if (readEnv("QBRIX_DEBUG")) return "debug";
+  return hasLogger ? "debug" : "off";
+}
+var DEFAULTS = {
+  baseUrl: "http://localhost:8080",
+  timeout: 3e4,
+  maxRetries: 2,
+  retryOn: [429, 502, 503, 504]
+};
+function readEnv(name) {
+  try {
+    const env = globalThis.process?.env;
+    return env?.[name];
+  } catch {
+    return void 0;
+  }
+}
+function resolveConfig(options = {}) {
+  const logLevel = resolveLogLevel(options.logLevel, options.logger !== void 0);
+  const config = {
+    apiKey: options.apiKey ?? readEnv("QBRIX_API_KEY"),
+    baseUrl: options.baseUrl ?? readEnv("QBRIX_BASE_URL") ?? DEFAULTS.baseUrl,
+    timeout: options.timeout ?? DEFAULTS.timeout,
+    maxRetries: options.maxRetries ?? DEFAULTS.maxRetries,
+    retryOn: options.retryOn ?? [...DEFAULTS.retryOn],
+    fetch: options.fetch,
+    headers: options.headers ?? {},
+    logger: options.logger ?? (logLevel === "off" ? void 0 : consoleLogger),
+    logLevel
+  };
+  if (config.timeout <= 0) {
+    throw new Error(`qbrix: timeout must be > 0, got ${config.timeout}`);
+  }
+  if (config.maxRetries < 0) {
+    throw new Error(`qbrix: maxRetries must be >= 0, got ${config.maxRetries}`);
+  }
+  return config;
+}
+
+// src/errors.ts
+var QbrixError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = new.target.name;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var QbrixAPIError = class extends QbrixError {
+  status;
+  detail;
+  code;
+  context;
+  constructor(status, detail, options) {
+    super(`[${status}] ${detail}`);
+    this.status = status;
+    this.detail = detail;
+    this.code = options?.code;
+    this.context = options?.context;
+  }
+};
+var BadRequestError = class extends QbrixAPIError {
+};
+var AuthenticationError = class extends QbrixAPIError {
+};
+var ForbiddenError = class extends QbrixAPIError {
+};
+var NotFoundError = class extends QbrixAPIError {
+};
+var ConflictError = class extends QbrixAPIError {
+};
+var RateLimitedError = class extends QbrixAPIError {
+  retryAfter;
+  constructor(status, detail, options) {
+    super(status, detail, options);
+    this.retryAfter = options?.retryAfter;
+  }
+};
+var InternalServerError = class extends QbrixAPIError {
+};
+var BadGatewayError = class extends QbrixAPIError {
+};
+var ServiceUnavailableError = class extends QbrixAPIError {
+};
+var GatewayTimeoutError = class extends QbrixAPIError {
+};
+var QbrixConnectionError = class extends QbrixError {
+};
+var QbrixTimeoutError = class extends QbrixError {
+};
+var STATUS_TO_ERROR = {
+  400: BadRequestError,
+  401: AuthenticationError,
+  403: ForbiddenError,
+  404: NotFoundError,
+  409: ConflictError,
+  429: RateLimitedError,
+  500: InternalServerError,
+  502: BadGatewayError,
+  503: ServiceUnavailableError,
+  504: GatewayTimeoutError
+};
+
+// src/mapper.ts
+function toSelectRequest(params) {
+  const { id, vector, metadata } = params.context;
+  return {
+    experiment_id: params.experimentId,
+    context: {
+      id,
+      ...vector !== void 0 && { vector },
+      ...metadata !== void 0 && { metadata }
+    }
+  };
+}
+function fromSelectResponse(wire) {
+  return {
+    arm: { id: wire.arm.id, name: wire.arm.name, index: wire.arm.index },
+    requestId: wire.request_id,
+    isDefault: wire.is_default
+  };
+}
+function toFeedbackRequest(params) {
+  return {
+    request_id: params.requestId,
+    reward: params.reward
+  };
+}
+
+// src/transport.ts
+var RETRY_BASE_DELAY_MS = 500;
+var RETRY_MAX_DELAY_MS = 8e3;
+function emit(config, level, message, context) {
+  if (config.logger && shouldLog(config.logLevel, level)) {
+    config.logger[level](message, context);
+  }
+}
+async function request(config, method, path, options = {}) {
+  const fetchImpl = config.fetch ?? globalThis.fetch;
+  const url = joinUrl(config.baseUrl, path);
+  const headers = buildHeaders(config);
+  const body = options.body === void 0 ? void 0 : JSON.stringify(options.body);
+  for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+    emit(config, "debug", "request attempt", {
+      method,
+      path,
+      attempt: attempt + 1,
+      attempts: config.maxRetries + 1
+    });
+    const timeoutSignal = AbortSignal.timeout(config.timeout);
+    const signal = combineSignals(options.signal, timeoutSignal);
+    let response;
+    try {
+      response = await fetchImpl(url, { method, headers, body, signal });
+    } catch (err) {
+      if (options.signal?.aborted) throw options.signal.reason ?? err;
+      if (timeoutSignal.aborted) {
+        emit(config, "error", "request timed out", { method, path });
+        throw new QbrixTimeoutError(`qbrix: request timed out after ${config.timeout}ms`);
+      }
+      emit(config, "error", "request connection error", { method, path });
+      throw new QbrixConnectionError(err instanceof Error ? err.message : String(err));
+    }
+    if (response.ok) {
+      emit(config, "debug", "request succeeded", { method, path, status: response.status });
+      if (response.status === 204) return void 0;
+      const text = await response.text();
+      return text ? JSON.parse(text) : void 0;
+    }
+    const error = await makeApiError(response);
+    if (!config.retryOn.includes(response.status) || attempt === config.maxRetries) {
+      emit(config, "error", "request failed", { method, path, status: response.status });
+      throw error;
+    }
+    const delay = retryDelay(attempt, error);
+    emit(config, "warn", "request retrying", {
+      method,
+      path,
+      status: response.status,
+      attempt: attempt + 1,
+      delayMs: Math.round(delay)
+    });
+    await sleep(delay, options.signal);
+  }
+  throw new QbrixError("qbrix: request failed");
+}
+function joinUrl(baseUrl, path) {
+  const base = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+  const suffix = path.startsWith("/") ? path : `/${path}`;
+  return `${base}${suffix}`;
+}
+function combineSignals(caller, timeout) {
+  if (!caller) return timeout;
+  const anyFn = AbortSignal.any;
+  if (typeof anyFn === "function") return anyFn([caller, timeout]);
+  const controller = new AbortController();
+  const forward = (source) => () => controller.abort(source.reason);
+  if (caller.aborted) controller.abort(caller.reason);
+  else if (timeout.aborted) controller.abort(timeout.reason);
+  else {
+    caller.addEventListener("abort", forward(caller), { once: true });
+    timeout.addEventListener("abort", forward(timeout), { once: true });
+  }
+  return controller.signal;
+}
+async function makeApiError(response) {
+  const raw = await response.text();
+  let detail = raw || response.statusText;
+  let code;
+  let context;
+  if (raw) {
+    try {
+      const parsed = JSON.parse(raw);
+      if (typeof parsed.detail === "string") detail = parsed.detail;
+      if (typeof parsed.code === "string") code = parsed.code;
+      if (parsed.context && typeof parsed.context === "object") {
+        context = parsed.context;
+      }
+    } catch {
+    }
+  }
+  const status = response.status;
+  if (status === 429) {
+    const header = response.headers.get("Retry-After");
+    const seconds = header ? Number.parseFloat(header) : Number.NaN;
+    return new RateLimitedError(status, detail, {
+      code,
+      context,
+      retryAfter: Number.isFinite(seconds) ? seconds : void 0
+    });
+  }
+  const ErrorClass = STATUS_TO_ERROR[status] ?? QbrixAPIError;
+  return new ErrorClass(status, detail, { code, context });
+}
+function retryDelay(attempt, error) {
+  if (error instanceof RateLimitedError && error.retryAfter !== void 0) {
+    return Math.min(error.retryAfter * 1e3, RETRY_MAX_DELAY_MS);
+  }
+  const base = Math.min(RETRY_BASE_DELAY_MS * 2 ** attempt, RETRY_MAX_DELAY_MS);
+  return base + Math.random() * base * 0.1;
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(signal.reason);
+      return;
+    }
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    function onAbort() {
+      clearTimeout(timer);
+      reject(signal?.reason);
+    }
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+
+// src/version.ts
+var VERSION = "0.0.0";
+
+// src/client.ts
+function buildHeaders(config) {
+  const headers = {
+    Accept: "application/json",
+    "Content-Type": "application/json"
+  };
+  if (config.apiKey) {
+    headers["X-API-Key"] = config.apiKey;
+  }
+  if (typeof document === "undefined") {
+    headers["User-Agent"] = `qbrix-js/${VERSION}`;
+  }
+  return { ...headers, ...config.headers };
+}
+var QbrixClient = class {
+  config;
+  constructor(options = {}) {
+    this.config = resolveConfig(options);
+  }
+  async select(experimentId, context) {
+    const body = toSelectRequest({ experimentId, context });
+    const wire = await request(
+      this.config,
+      "POST",
+      "/api/v1/agent/select",
+      { body }
+    );
+    if (wire === void 0) {
+      throw new QbrixError("qbrix: select returned no response body");
+    }
+    return fromSelectResponse(wire);
+  }
+  async feedback(requestId, reward) {
+    const body = toFeedbackRequest({ requestId, reward });
+    await request(this.config, "POST", "/api/v1/agent/feedback", { body });
+  }
+};
+
+export { AuthenticationError, BadGatewayError, BadRequestError, ConflictError, ForbiddenError, GatewayTimeoutError, InternalServerError, NotFoundError, QbrixAPIError, QbrixClient, QbrixConnectionError, QbrixError, QbrixTimeoutError, RateLimitedError, ServiceUnavailableError };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logger.ts","../src/config.ts","../src/errors.ts","../src/mapper.ts","../src/transport.ts","../src/version.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// pluggable, leveled logging. the sdk is silent by default (logLevel \"off\") and\n// only emits when a level is configured (via the logLevel option, the QBRIX_LOG\n// / QBRIX_DEBUG env vars, or by injecting a logger). the sdk passes only\n// non-sensitive context (method, path, status, attempt counts) — never the api\n// key, headers, or request/response bodies.\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"off\";\n\nexport interface QbrixLogger {\n  debug(message: string, context?: Record<string, unknown>): void;\n  info(message: string, context?: Record<string, unknown>): void;\n  warn(message: string, context?: Record<string, unknown>): void;\n  error(message: string, context?: Record<string, unknown>): void;\n}\n\nconst RANK: Record<LogLevel, number> = {\n  debug: 10,\n  info: 20,\n  warn: 30,\n  error: 40,\n  off: 100,\n};\n\n// emit an event at `event` level only when it meets the configured threshold.\nexport function shouldLog(configured: LogLevel, event: Exclude<LogLevel, \"off\">): boolean {\n  return RANK[event] >= RANK[configured];\n}\n\n// built-in sink for the env / logLevel opt-in; routes each level to console.\nexport const consoleLogger: QbrixLogger = {\n  debug: (message, context) => (context ? console.debug(message, context) : console.debug(message)),\n  info: (message, context) => (context ? console.info(message, context) : console.info(message)),\n  warn: (message, context) => (context ? console.warn(message, context) : console.warn(message)),\n  error: (message, context) => (context ? console.error(message, context) : console.error(message)),\n};\n","import type { QbrixClientOptions } from \"./client\";\nimport { type LogLevel, type QbrixLogger, consoleLogger } from \"./logger\";\n\nexport interface ResolvedConfig {\n  apiKey: string | undefined;\n  baseUrl: string;\n  timeout: number;\n  maxRetries: number;\n  retryOn: number[];\n  fetch: typeof fetch | undefined;\n  headers: Record<string, string>;\n  logger: QbrixLogger | undefined;\n  logLevel: LogLevel;\n}\n\nconst LOG_LEVELS: readonly LogLevel[] = [\"debug\", \"info\", \"warn\", \"error\", \"off\"];\n\n// precedence: explicit option → QBRIX_LOG → QBRIX_DEBUG (sugar for \"debug\") →\n// \"debug\" when a logger is injected (opt-in by passing one) → \"off\" (silent).\nfunction resolveLogLevel(option: LogLevel | undefined, hasLogger: boolean): LogLevel {\n  if (option) return option;\n  const env = readEnv(\"QBRIX_LOG\");\n  if (env && (LOG_LEVELS as readonly string[]).includes(env)) return env as LogLevel;\n  if (readEnv(\"QBRIX_DEBUG\")) return \"debug\";\n  return hasLogger ? \"debug\" : \"off\";\n}\n\n// todo: check the defaults / might want to add the hosted url here / update the timeout to be low latency etc.\nconst DEFAULTS = {\n  baseUrl: \"http://localhost:8080\",\n  timeout: 30_000,\n  maxRetries: 2,\n  retryOn: [429, 502, 503, 504] as number[],\n};\n\n// guarded globalThis access keeps the browser bundle clean and avoids needing `@types/node`.\n// the try/catch matters for deno, where reading `process.env` throws without `--allow-env` —\n// the sdk treats env as unset rather than crashing.\nfunction readEnv(name: string): string | undefined {\n  try {\n    const env = (globalThis as { process?: { env?: Record<string, string | undefined> } }).process\n      ?.env;\n    return env?.[name];\n  } catch {\n    return undefined;\n  }\n}\n\n// precedence per option: explicit arg → env var → default\nexport function resolveConfig(options: QbrixClientOptions = {}): ResolvedConfig {\n  const logLevel = resolveLogLevel(options.logLevel, options.logger !== undefined);\n  const config: ResolvedConfig = {\n    apiKey: options.apiKey ?? readEnv(\"QBRIX_API_KEY\"),\n    baseUrl: options.baseUrl ?? readEnv(\"QBRIX_BASE_URL\") ?? DEFAULTS.baseUrl,\n    timeout: options.timeout ?? DEFAULTS.timeout,\n    maxRetries: options.maxRetries ?? DEFAULTS.maxRetries,\n    retryOn: options.retryOn ?? [...DEFAULTS.retryOn],\n    fetch: options.fetch,\n    headers: options.headers ?? {},\n    logger: options.logger ?? (logLevel === \"off\" ? undefined : consoleLogger),\n    logLevel,\n  };\n\n  if (config.timeout <= 0) {\n    throw new Error(`qbrix: timeout must be > 0, got ${config.timeout}`);\n  }\n  if (config.maxRetries < 0) {\n    throw new Error(`qbrix: maxRetries must be >= 0, got ${config.maxRetries}`);\n  }\n\n  return config;\n}\n","import type { ErrorCode } from \"./types\";\n\nexport class QbrixError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = new.target.name;\n    // keep instanceof working when consumers downlevel below es2015\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n// `string & {}` keeps autocomplete of the known codes while tolerating codes a\n// newer backend may send before the sdk's generated union catches up.\ninterface ApiErrorOptions {\n  code?: ErrorCode | (string & {});\n  context?: Record<string, unknown>;\n}\n\nexport class QbrixAPIError extends QbrixError {\n  readonly status: number;\n  readonly detail: string;\n  readonly code: ErrorCode | (string & {}) | undefined;\n  readonly context: Record<string, unknown> | undefined;\n\n  constructor(status: number, detail: string, options?: ApiErrorOptions) {\n    super(`[${status}] ${detail}`);\n    this.status = status;\n    this.detail = detail;\n    this.code = options?.code;\n    this.context = options?.context;\n  }\n}\n\nexport class BadRequestError extends QbrixAPIError {}\nexport class AuthenticationError extends QbrixAPIError {}\nexport class ForbiddenError extends QbrixAPIError {}\nexport class NotFoundError extends QbrixAPIError {}\nexport class ConflictError extends QbrixAPIError {}\n\ninterface RateLimitedErrorOptions extends ApiErrorOptions {\n  retryAfter?: number;\n}\n\nexport class RateLimitedError extends QbrixAPIError {\n  readonly retryAfter: number | undefined;\n\n  constructor(status: number, detail: string, options?: RateLimitedErrorOptions) {\n    super(status, detail, options);\n    this.retryAfter = options?.retryAfter;\n  }\n}\n\nexport class InternalServerError extends QbrixAPIError {}\nexport class BadGatewayError extends QbrixAPIError {}\nexport class ServiceUnavailableError extends QbrixAPIError {}\nexport class GatewayTimeoutError extends QbrixAPIError {}\n\nexport class QbrixConnectionError extends QbrixError {}\nexport class QbrixTimeoutError extends QbrixError {}\n\ntype ApiErrorConstructor = new (\n  status: number,\n  detail: string,\n  options?: ApiErrorOptions,\n) => QbrixAPIError;\n\nexport const STATUS_TO_ERROR: Record<number, ApiErrorConstructor> = {\n  400: BadRequestError,\n  401: AuthenticationError,\n  403: ForbiddenError,\n  404: NotFoundError,\n  409: ConflictError,\n  429: RateLimitedError,\n  500: InternalServerError,\n  502: BadGatewayError,\n  503: ServiceUnavailableError,\n  504: GatewayTimeoutError,\n};\n","import type { components } from \"./generated\";\nimport type { FeedbackParams, SelectParams, SelectResult } from \"./types\";\n\ntype WireSelectRequest = components[\"schemas\"][\"AgentSelectRequest\"];\ntype WireSelectResponse = components[\"schemas\"][\"AgentSelectResponse\"];\ntype WireFeedbackRequest = components[\"schemas\"][\"AgentFeedbackRequest\"];\n\nexport function toSelectRequest(params: SelectParams): WireSelectRequest {\n  const { id, vector, metadata } = params.context;\n  return {\n    experiment_id: params.experimentId,\n    context: {\n      id,\n      ...(vector !== undefined && { vector }),\n      ...(metadata !== undefined && { metadata }),\n    },\n  };\n}\n\nexport function fromSelectResponse(wire: WireSelectResponse): SelectResult {\n  return {\n    arm: { id: wire.arm.id, name: wire.arm.name, index: wire.arm.index },\n    requestId: wire.request_id,\n    isDefault: wire.is_default,\n  };\n}\n\nexport function toFeedbackRequest(params: FeedbackParams): WireFeedbackRequest {\n  return {\n    request_id: params.requestId,\n    reward: params.reward,\n  };\n}\n","import { buildHeaders } from \"./client\";\nimport type { ResolvedConfig } from \"./config\";\nimport {\n  QbrixAPIError,\n  QbrixConnectionError,\n  QbrixError,\n  QbrixTimeoutError,\n  RateLimitedError,\n  STATUS_TO_ERROR,\n} from \"./errors\";\nimport type { components } from \"./generated\";\nimport { type LogLevel, shouldLog } from \"./logger\";\n\nexport interface RequestOptions {\n  body?: unknown;\n  signal?: AbortSignal;\n}\n\nconst RETRY_BASE_DELAY_MS = 500;\nconst RETRY_MAX_DELAY_MS = 8_000;\n\nfunction emit(\n  config: ResolvedConfig,\n  level: Exclude<LogLevel, \"off\">,\n  message: string,\n  context: Record<string, unknown>,\n): void {\n  if (config.logger && shouldLog(config.logLevel, level)) {\n    config.logger[level](message, context);\n  }\n}\n\nexport async function request<T>(\n  config: ResolvedConfig,\n  method: string,\n  path: string,\n  options: RequestOptions = {},\n): Promise<T | undefined> {\n  const fetchImpl = config.fetch ?? globalThis.fetch;\n  const url = joinUrl(config.baseUrl, path);\n  const headers = buildHeaders(config);\n  const body = options.body === undefined ? undefined : JSON.stringify(options.body);\n\n  for (let attempt = 0; attempt <= config.maxRetries; attempt++) {\n    emit(config, \"debug\", \"request attempt\", {\n      method,\n      path,\n      attempt: attempt + 1,\n      attempts: config.maxRetries + 1,\n    });\n    const timeoutSignal = AbortSignal.timeout(config.timeout);\n    const signal = combineSignals(options.signal, timeoutSignal);\n\n    let response: Response;\n    try {\n      response = await fetchImpl(url, { method, headers, body, signal });\n    } catch (err) {\n      // caller-initiated abort takes precedence and propagates unchanged\n      if (options.signal?.aborted) throw options.signal.reason ?? err;\n      if (timeoutSignal.aborted) {\n        emit(config, \"error\", \"request timed out\", { method, path });\n        throw new QbrixTimeoutError(`qbrix: request timed out after ${config.timeout}ms`);\n      }\n      emit(config, \"error\", \"request connection error\", { method, path });\n      throw new QbrixConnectionError(err instanceof Error ? err.message : String(err));\n    }\n\n    if (response.ok) {\n      emit(config, \"debug\", \"request succeeded\", { method, path, status: response.status });\n      if (response.status === 204) return undefined;\n      const text = await response.text();\n      return text ? (JSON.parse(text) as T) : undefined;\n    }\n\n    const error = await makeApiError(response);\n    if (!config.retryOn.includes(response.status) || attempt === config.maxRetries) {\n      emit(config, \"error\", \"request failed\", { method, path, status: response.status });\n      throw error;\n    }\n    const delay = retryDelay(attempt, error);\n    emit(config, \"warn\", \"request retrying\", {\n      method,\n      path,\n      status: response.status,\n      attempt: attempt + 1,\n      delayMs: Math.round(delay),\n    });\n    await sleep(delay, options.signal);\n  }\n\n  // unreachable: the final attempt always returns or throws\n  throw new QbrixError(\"qbrix: request failed\");\n}\n\nfunction joinUrl(baseUrl: string, path: string): string {\n  const base = baseUrl.endsWith(\"/\") ? baseUrl.slice(0, -1) : baseUrl;\n  const suffix = path.startsWith(\"/\") ? path : `/${path}`;\n  return `${base}${suffix}`;\n}\n\nfunction combineSignals(caller: AbortSignal | undefined, timeout: AbortSignal): AbortSignal {\n  if (!caller) return timeout;\n  const anyFn = (AbortSignal as unknown as { any?: (signals: AbortSignal[]) => AbortSignal }).any;\n  if (typeof anyFn === \"function\") return anyFn([caller, timeout]);\n\n  // manual fallback for runtimes without AbortSignal.any\n  const controller = new AbortController();\n  const forward = (source: AbortSignal) => () => controller.abort(source.reason);\n  if (caller.aborted) controller.abort(caller.reason);\n  else if (timeout.aborted) controller.abort(timeout.reason);\n  else {\n    caller.addEventListener(\"abort\", forward(caller), { once: true });\n    timeout.addEventListener(\"abort\", forward(timeout), { once: true });\n  }\n  return controller.signal;\n}\n\ntype WireError = components[\"schemas\"][\"ErrorResponse\"];\n\nasync function makeApiError(response: Response): Promise<QbrixAPIError> {\n  // read the body once; fetch streams can't be re-read after JSON.parse fails\n  const raw = await response.text();\n  let detail = raw || response.statusText;\n  let code: WireError[\"code\"] | undefined;\n  let context: Record<string, unknown> | undefined;\n  if (raw) {\n    try {\n      const parsed = JSON.parse(raw) as Partial<WireError>;\n      if (typeof parsed.detail === \"string\") detail = parsed.detail;\n      if (typeof parsed.code === \"string\") code = parsed.code;\n      if (parsed.context && typeof parsed.context === \"object\") {\n        context = parsed.context as Record<string, unknown>;\n      }\n    } catch {\n      // non-json body — keep the raw text as detail\n    }\n  }\n\n  const status = response.status;\n  if (status === 429) {\n    const header = response.headers.get(\"Retry-After\");\n    const seconds = header ? Number.parseFloat(header) : Number.NaN;\n    return new RateLimitedError(status, detail, {\n      code,\n      context,\n      retryAfter: Number.isFinite(seconds) ? seconds : undefined,\n    });\n  }\n\n  const ErrorClass = STATUS_TO_ERROR[status] ?? QbrixAPIError;\n  return new ErrorClass(status, detail, { code, context });\n}\n\nfunction retryDelay(attempt: number, error: QbrixAPIError): number {\n  if (error instanceof RateLimitedError && error.retryAfter !== undefined) {\n    return Math.min(error.retryAfter * 1000, RETRY_MAX_DELAY_MS);\n  }\n  const base = Math.min(RETRY_BASE_DELAY_MS * 2 ** attempt, RETRY_MAX_DELAY_MS);\n  return base + Math.random() * base * 0.1;\n}\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(signal.reason);\n      return;\n    }\n    const timer = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    function onAbort() {\n      clearTimeout(timer);\n      reject(signal?.reason);\n    }\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n","// kept in sync with package.json by release tooling (OPT-41).\nexport const VERSION = \"0.0.0\";\n","import type { ResolvedConfig } from \"./config\";\nimport { resolveConfig } from \"./config\";\nimport { QbrixError } from \"./errors\";\nimport type { components } from \"./generated\";\nimport type { LogLevel, QbrixLogger } from \"./logger\";\nimport { fromSelectResponse, toFeedbackRequest, toSelectRequest } from \"./mapper\";\nimport { request } from \"./transport\";\nimport type { Context, SelectResult } from \"./types\";\nimport { VERSION } from \"./version\";\n\nexport interface QbrixClientOptions {\n  /** qbrix api key (prefix `optiq_`). falls back to `QBRIX_API_KEY`. */\n  apiKey?: string;\n  /** base url of the qbrix proxy. falls back to `QBRIX_BASE_URL`. */\n  baseUrl?: string;\n  /** request timeout in milliseconds. */\n  timeout?: number;\n  /** max retry attempts on retryable status codes. */\n  maxRetries?: number;\n  /** status codes to retry. */\n  retryOn?: number[];\n  /** custom fetch implementation, injectable for tests and custom runtimes. */\n  fetch?: typeof fetch;\n  /** extra headers merged into every request; user headers override the defaults. */\n  headers?: Record<string, string>;\n  /** optional log sink; never receives secrets. defaults to a console sink when a level is active. */\n  logger?: QbrixLogger;\n  /** logging verbosity. defaults to \"off\" (silent); also read from QBRIX_LOG / QBRIX_DEBUG. */\n  logLevel?: LogLevel;\n}\n\nexport function buildHeaders(config: ResolvedConfig): Record<string, string> {\n  const headers: Record<string, string> = {\n    Accept: \"application/json\",\n    \"Content-Type\": \"application/json\",\n  };\n  if (config.apiKey) {\n    headers[\"X-API-Key\"] = config.apiKey;\n  }\n  // browsers forbid setting User-Agent and drop or error on the attempt\n  if (typeof document === \"undefined\") {\n    headers[\"User-Agent\"] = `qbrix-js/${VERSION}`;\n  }\n  return { ...headers, ...config.headers };\n}\n\nexport class QbrixClient {\n  readonly config: ResolvedConfig;\n\n  constructor(options: QbrixClientOptions = {}) {\n    this.config = resolveConfig(options);\n  }\n\n  async select(experimentId: string, context: Context): Promise<SelectResult> {\n    const body = toSelectRequest({ experimentId, context });\n    const wire = await request<components[\"schemas\"][\"AgentSelectResponse\"]>(\n      this.config,\n      \"POST\",\n      \"/api/v1/agent/select\",\n      { body },\n    );\n    if (wire === undefined) {\n      throw new QbrixError(\"qbrix: select returned no response body\");\n    }\n    return fromSelectResponse(wire);\n  }\n\n  async feedback(requestId: string, reward: number): Promise<void> {\n    const body = toFeedbackRequest({ requestId, reward });\n    await request(this.config, \"POST\", \"/api/v1/agent/feedback\", { body });\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@optiqio/qbrix",
+  "version": "0.1.0",
+  "description": "JavaScript/TypeScript SDK for the Qbrix multi-armed bandit platform — select and feedback in ~10 lines.",
+  "keywords": ["bandit", "mab", "experimentation", "optimization", "ab-testing", "qbrix"],
+  "license": "MIT",
+  "author": "Optiq <hello@qbrix.io>",
+  "homepage": "https://qbrix.io",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/optiq-io/qbrix-js.git"
+  },
+  "bugs": {
+    "url": "https://github.com/optiq-io/qbrix-js/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": ["dist"],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "spec:pull": "node scripts/pull-spec.mjs",
+    "generate": "openapi-typescript spec/proxysvc.openapi.json -o src/generated.ts",
+    "smoke": "node smoke/round-trip.mjs",
+    "smoke:bundle": "node scripts/check-browser-bundle.mjs",
+    "check:exports": "node scripts/check-package-exports.mjs",
+    "prepublishOnly": "npm run build",
+    "version": "changeset version && npm install --package-lock-only --ignore-scripts && biome format --write package.json",
+    "release": "changeset publish"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@changesets/cli": "^2.27.11",
+    "@vitest/coverage-v8": "^2.1.8",
+    "esbuild": "^0.27.7",
+    "openapi-typescript": "^7.13.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}