@weckr/sdk 0.1.1 → 0.1.3

package/README.md

@@ -45,9 +45,41 @@ Sign up at [https://useweckr.com](https://useweckr.com).
 
 ## Supported providers
 
-- **OpenAI** — `gpt-4o`, `gpt-4o-mini`, `gpt-3.5-turbo`
-- **Anthropic** — `claude-opus-4`, `claude-sonnet-4`, `claude-haiku-4`
-- **Gemini** — `gemini-2.5-flash`, `gemini-2.5-pro`
+- **OpenAI** — `gpt-4o`, `gpt-4o-mini`, `gpt-4-turbo`, `gpt-4`, `gpt-3.5-turbo`, `o1-preview`, `o1-mini`
+- **Anthropic** — `claude-opus-4`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-3-5-sonnet`, `claude-3-5-haiku`, `claude-3-opus`
+- **Gemini** — `gemini-2.5-pro`, `gemini-2.5-flash`, `gemini-1.5-pro`, `gemini-1.5-flash`
+
+Dated variants (`gpt-4o-2024-08-06`, `claude-3-5-sonnet-latest`, …) resolve to the matching family by longest-prefix lookup. Unknown models log `costUsd = 0` and don't trigger caps.
+
+## Caps + downgrades
+
+Set per-plan spending caps in the dashboard. When a user crosses their cap:
+
+- `action: 'block'` → `wk.chat()` throws `WeckrCapError` (LLM call never made)
+- `action: 'downgrade'` → the SDK silently swaps the model for a cheaper one in the same provider (`gpt-4o` → `gpt-4o-mini`, `claude-opus-4` → `claude-sonnet-4`, etc.)
+
+Errors come in two flavors:
+
+```ts
+import { isWeckrCapError, isWeckrConfigError } from '@weckr/sdk';
+
+try {
+  await wk.chat(openai, opts);
+} catch (err) {
+  if (isWeckrCapError(err))   return showUpgradePrompt(err);
+  if (isWeckrConfigError(err)) return logBackendAlert(err); // typo'd api key, unknown plan
+  throw err; // real LLM error
+}
+```
+
+## Short-lived processes (Lambda, cron, CLI)
+
+`wk.chat()` returns as soon as the LLM call resolves; the log POST is fire-and-forget. In short-lived processes call `await wk.flush()` before exit to give the POSTs time to land:
+
+```ts
+await wk.chat(openai, opts);
+await wk.flush(); // default 5s timeout
+```
 
 ## What gets logged
 

package/dist/index.d.mts

@@ -1,6 +1,12 @@
-type Provider = 'openai' | 'anthropic' | 'gemini';
+/**
+ * 'unknown' is used when the SDK can't detect the provider via shape. We still
+ * log the row (so the dashboard sees something) but cost+downgrade lookup fall
+ * back to no-op behavior.
+ */
+type Provider = 'openai' | 'anthropic' | 'gemini' | 'unknown';
 interface WeckrConfig {
     apiKey: string;
+    /** Map of plan name -> monthly revenue per user. Required if you pass `plan` to chat(). */
     plans?: Record<string, number>;
     endpoint?: string;
     /** Optional override for the cap-check endpoint. Derived from `endpoint` by default. */
@@ -11,17 +17,33 @@ interface WeckrConfig {
      */
     disableCapCheck?: boolean;
     fetch?: typeof fetch;
+    /**
+     * Async errors (cap-check network failure, log POST failure) are reported here.
+     * If absent, errors are silently swallowed. CRITICAL ones (401/403 on a
+     * misconfigured api key) still throw WeckrConfigError synchronously.
+     */
     onError?: (err: unknown) => void;
+    /**
+     * Called when a cap-downgrade swaps the model. Useful for analytics.
+     * Defaults to a one-time console.warn per (userId, from, to).
+     */
+    onDowngrade?: (info: {
+        userId: string;
+        from: string;
+        to: string;
+    }) => void;
 }
 interface ChatOptions {
     model: string;
     messages: Array<{
         role: string;
-        content: string;
+        content: unknown;
     }>;
     userId?: string;
     feature?: string;
     plan?: string;
+    /** OpenAI streaming opt-in — set to true to get an AsyncIterable response. */
+    stream?: boolean;
     [key: string]: unknown;
 }
 interface NormalizedUsage {
@@ -39,6 +61,7 @@ interface LogPayload {
     latencyMs: number;
     planName: string | null;
     planRevenueUsd: number | null;
+    /** Kept for backward-compat with old servers; new servers ignore it. */
     marginUsd: number | null;
     timestamp: string;
 }
@@ -60,11 +83,20 @@ interface CapCheckResult {
 declare class Weckr {
     private readonly apiKey;
     private readonly plans;
-    private readonly log;
+    private readonly logger;
     private readonly checkCap;
     private readonly onError?;
+    private readonly onDowngrade;
+    private readonly downgradeSeen;
     constructor(config: WeckrConfig);
     chat<TClient, TResult = unknown>(client: TClient, options: ChatOptions): Promise<TResult>;
+    private tryLog;
+    /**
+     * Await all in-flight log POSTs. Call this before `process.exit()` /
+     * `Lambda return` / end of a short-lived CLI run, otherwise the daemon
+     * process is torn down before the POST hits the network.
+     */
+    flush(timeoutMs?: number): Promise<void>;
 }
 
 interface ModelPricing {
@@ -73,6 +105,15 @@ interface ModelPricing {
     outputPerMillion: number;
 }
 declare const PRICING: Record<string, ModelPricing>;
+/**
+ * Resolve pricing for a model name, allowing dated variants.
+ *
+ * Real-world IDs are date-pinned (`gpt-4o-2024-08-06`, `claude-opus-4-20250514`,
+ * `claude-3-5-sonnet-latest`). Strict equality would silently log cost=0 for
+ * those — which neuters every cap. So we longest-prefix-match against PRICING:
+ * `claude-3-5-sonnet-20241022` resolves to `claude-3-5-sonnet`, not the
+ * shorter `claude-3` family.
+ */
 declare function resolvePricing(model: string): ModelPricing | null;
 declare function calculateCost(model: string, inputTokens: number, outputTokens: number): {
     costUsd: number;
@@ -87,7 +128,7 @@ declare function calculateCost(model: string, inputTokens: number, outputTokens:
  * try {
  *   await wk.chat(openai, opts);
  * } catch (err) {
- *   if (err instanceof WeckrCapError) {
+ *   if (isWeckrCapError(err)) {
  *     // show the user a friendly upgrade prompt
  *   }
  * }
@@ -108,5 +149,19 @@ declare class WeckrCapError extends Error {
     });
 }
 declare function isWeckrCapError(e: unknown): e is WeckrCapError;
+/**
+ * Thrown when the SDK detects an UNRECOVERABLE config error — typo'd api key
+ * (401), revoked key (403), or plan-name passed to chat() that doesn't appear
+ * in the constructor's `plans` dict.
+ *
+ * These fail-CLOSED on purpose: silent fail-open would silently disable cap
+ * enforcement (security control) or silently poison dashboard data.
+ */
+declare class WeckrConfigError extends Error {
+    readonly name: "WeckrConfigError";
+    readonly code: 'invalid_api_key' | 'forbidden' | 'unknown_plan';
+    constructor(code: 'invalid_api_key' | 'forbidden' | 'unknown_plan', message: string);
+}
+declare function isWeckrConfigError(e: unknown): e is WeckrConfigError;
 
-export { type CapCheckResult, type ChatOptions, type LogPayload, type NormalizedUsage, PRICING, type Provider, type ProviderAdapter, Weckr, WeckrCapError, type WeckrConfig, calculateCost, isWeckrCapError, resolvePricing };
+export { type CapCheckResult, type ChatOptions, type LogPayload, type NormalizedUsage, PRICING, type Provider, type ProviderAdapter, Weckr, WeckrCapError, type WeckrConfig, WeckrConfigError, calculateCost, isWeckrCapError, isWeckrConfigError, resolvePricing };

package/dist/index.d.ts

@@ -1,6 +1,12 @@
-type Provider = 'openai' | 'anthropic' | 'gemini';
+/**
+ * 'unknown' is used when the SDK can't detect the provider via shape. We still
+ * log the row (so the dashboard sees something) but cost+downgrade lookup fall
+ * back to no-op behavior.
+ */
+type Provider = 'openai' | 'anthropic' | 'gemini' | 'unknown';
 interface WeckrConfig {
     apiKey: string;
+    /** Map of plan name -> monthly revenue per user. Required if you pass `plan` to chat(). */
     plans?: Record<string, number>;
     endpoint?: string;
     /** Optional override for the cap-check endpoint. Derived from `endpoint` by default. */
@@ -11,17 +17,33 @@ interface WeckrConfig {
      */
     disableCapCheck?: boolean;
     fetch?: typeof fetch;
+    /**
+     * Async errors (cap-check network failure, log POST failure) are reported here.
+     * If absent, errors are silently swallowed. CRITICAL ones (401/403 on a
+     * misconfigured api key) still throw WeckrConfigError synchronously.
+     */
     onError?: (err: unknown) => void;
+    /**
+     * Called when a cap-downgrade swaps the model. Useful for analytics.
+     * Defaults to a one-time console.warn per (userId, from, to).
+     */
+    onDowngrade?: (info: {
+        userId: string;
+        from: string;
+        to: string;
+    }) => void;
 }
 interface ChatOptions {
     model: string;
     messages: Array<{
         role: string;
-        content: string;
+        content: unknown;
     }>;
     userId?: string;
     feature?: string;
     plan?: string;
+    /** OpenAI streaming opt-in — set to true to get an AsyncIterable response. */
+    stream?: boolean;
     [key: string]: unknown;
 }
 interface NormalizedUsage {
@@ -39,6 +61,7 @@ interface LogPayload {
     latencyMs: number;
     planName: string | null;
     planRevenueUsd: number | null;
+    /** Kept for backward-compat with old servers; new servers ignore it. */
     marginUsd: number | null;
     timestamp: string;
 }
@@ -60,11 +83,20 @@ interface CapCheckResult {
 declare class Weckr {
     private readonly apiKey;
     private readonly plans;
-    private readonly log;
+    private readonly logger;
     private readonly checkCap;
     private readonly onError?;
+    private readonly onDowngrade;
+    private readonly downgradeSeen;
     constructor(config: WeckrConfig);
     chat<TClient, TResult = unknown>(client: TClient, options: ChatOptions): Promise<TResult>;
+    private tryLog;
+    /**
+     * Await all in-flight log POSTs. Call this before `process.exit()` /
+     * `Lambda return` / end of a short-lived CLI run, otherwise the daemon
+     * process is torn down before the POST hits the network.
+     */
+    flush(timeoutMs?: number): Promise<void>;
 }
 
 interface ModelPricing {
@@ -73,6 +105,15 @@ interface ModelPricing {
     outputPerMillion: number;
 }
 declare const PRICING: Record<string, ModelPricing>;
+/**
+ * Resolve pricing for a model name, allowing dated variants.
+ *
+ * Real-world IDs are date-pinned (`gpt-4o-2024-08-06`, `claude-opus-4-20250514`,
+ * `claude-3-5-sonnet-latest`). Strict equality would silently log cost=0 for
+ * those — which neuters every cap. So we longest-prefix-match against PRICING:
+ * `claude-3-5-sonnet-20241022` resolves to `claude-3-5-sonnet`, not the
+ * shorter `claude-3` family.
+ */
 declare function resolvePricing(model: string): ModelPricing | null;
 declare function calculateCost(model: string, inputTokens: number, outputTokens: number): {
     costUsd: number;
@@ -87,7 +128,7 @@ declare function calculateCost(model: string, inputTokens: number, outputTokens:
  * try {
  *   await wk.chat(openai, opts);
  * } catch (err) {
- *   if (err instanceof WeckrCapError) {
+ *   if (isWeckrCapError(err)) {
  *     // show the user a friendly upgrade prompt
  *   }
  * }
@@ -108,5 +149,19 @@ declare class WeckrCapError extends Error {
     });
 }
 declare function isWeckrCapError(e: unknown): e is WeckrCapError;
+/**
+ * Thrown when the SDK detects an UNRECOVERABLE config error — typo'd api key
+ * (401), revoked key (403), or plan-name passed to chat() that doesn't appear
+ * in the constructor's `plans` dict.
+ *
+ * These fail-CLOSED on purpose: silent fail-open would silently disable cap
+ * enforcement (security control) or silently poison dashboard data.
+ */
+declare class WeckrConfigError extends Error {
+    readonly name: "WeckrConfigError";
+    readonly code: 'invalid_api_key' | 'forbidden' | 'unknown_plan';
+    constructor(code: 'invalid_api_key' | 'forbidden' | 'unknown_plan', message: string);
+}
+declare function isWeckrConfigError(e: unknown): e is WeckrConfigError;
 
-export { type CapCheckResult, type ChatOptions, type LogPayload, type NormalizedUsage, PRICING, type Provider, type ProviderAdapter, Weckr, WeckrCapError, type WeckrConfig, calculateCost, isWeckrCapError, resolvePricing };
+export { type CapCheckResult, type ChatOptions, type LogPayload, type NormalizedUsage, PRICING, type Provider, type ProviderAdapter, Weckr, WeckrCapError, type WeckrConfig, WeckrConfigError, calculateCost, isWeckrCapError, isWeckrConfigError, resolvePricing };

package/dist/index.js

@@ -23,30 +23,47 @@ __export(index_exports, {
   PRICING: () => PRICING,
   Weckr: () => Weckr,
   WeckrCapError: () => WeckrCapError,
+  WeckrConfigError: () => WeckrConfigError,
   calculateCost: () => calculateCost,
   isWeckrCapError: () => isWeckrCapError,
+  isWeckrConfigError: () => isWeckrConfigError,
   resolvePricing: () => resolvePricing
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/pricing.ts
 var PRICING = {
+  // OpenAI
   "gpt-4o": { provider: "openai", inputPerMillion: 2.5, outputPerMillion: 10 },
   "gpt-4o-mini": { provider: "openai", inputPerMillion: 0.15, outputPerMillion: 0.6 },
+  "gpt-4-turbo": { provider: "openai", inputPerMillion: 10, outputPerMillion: 30 },
+  "gpt-4": { provider: "openai", inputPerMillion: 30, outputPerMillion: 60 },
   "gpt-3.5-turbo": { provider: "openai", inputPerMillion: 0.5, outputPerMillion: 1.5 },
+  "o1-preview": { provider: "openai", inputPerMillion: 15, outputPerMillion: 60 },
+  "o1-mini": { provider: "openai", inputPerMillion: 3, outputPerMillion: 12 },
+  // Anthropic
   "claude-opus-4": { provider: "anthropic", inputPerMillion: 15, outputPerMillion: 75 },
   "claude-sonnet-4": { provider: "anthropic", inputPerMillion: 3, outputPerMillion: 15 },
-  "claude-haiku-4": { provider: "anthropic", inputPerMillion: 0.8, outputPerMillion: 4 },
+  "claude-haiku-4-5": { provider: "anthropic", inputPerMillion: 0.8, outputPerMillion: 4 },
+  "claude-3-5-sonnet": { provider: "anthropic", inputPerMillion: 3, outputPerMillion: 15 },
+  "claude-3-5-haiku": { provider: "anthropic", inputPerMillion: 0.8, outputPerMillion: 4 },
+  "claude-3-opus": { provider: "anthropic", inputPerMillion: 15, outputPerMillion: 75 },
+  // Gemini
+  "gemini-2.5-pro": { provider: "gemini", inputPerMillion: 1.25, outputPerMillion: 10 },
   "gemini-2.5-flash": { provider: "gemini", inputPerMillion: 0.15, outputPerMillion: 0.6 },
-  "gemini-2.5-pro": { provider: "gemini", inputPerMillion: 1.25, outputPerMillion: 10 }
+  "gemini-1.5-pro": { provider: "gemini", inputPerMillion: 1.25, outputPerMillion: 5 },
+  "gemini-1.5-flash": { provider: "gemini", inputPerMillion: 0.075, outputPerMillion: 0.3 }
 };
 function resolvePricing(model) {
   if (PRICING[model]) return PRICING[model];
   const lower = model.toLowerCase();
-  for (const key of Object.keys(PRICING)) {
-    if (lower.startsWith(key.toLowerCase())) return PRICING[key];
+  let best = null;
+  for (const [key, pricing] of Object.entries(PRICING)) {
+    if (lower.startsWith(key.toLowerCase())) {
+      if (!best || key.length > best.key.length) best = { key, pricing };
+    }
   }
-  return null;
+  return best?.pricing ?? null;
 }
 function calculateCost(model, inputTokens, outputTokens) {
   const pricing = resolvePricing(model);
@@ -62,14 +79,28 @@ function round6(n) {
 var openaiAdapter = {
   name: "openai",
   matches(client) {
-    return isObject(client) && isObject(client.chat) && isObject(client.chat.completions) && typeof client.chat.completions.create === "function";
+    if (!isObject(client)) return false;
+    const chat = client.chat;
+    if (!isObject(chat)) return false;
+    const completions = chat.completions;
+    if (!isObject(completions)) return false;
+    return typeof completions.create === "function";
   },
   async call(client, options) {
+    if (options.stream === true) {
+      throw new Error(
+        "Weckr: stream:true is not supported by wk.chat() because token usage is not in stream responses by default. Either disable streaming, or call openai.chat.completions.create() directly outside wk.chat() (you lose cost tracking) and we will add proper streaming support in a future release."
+      );
+    }
     const { userId, feature, plan, ...rest } = options;
+    void userId;
+    void feature;
+    void plan;
     return client.chat.completions.create(rest);
   },
   extractUsage(result) {
-    const usage = result?.usage ?? {};
+    const r = result;
+    const usage = r?.usage ?? {};
     return {
       inputTokens: toInt(usage.prompt_tokens ?? usage.input_tokens),
       outputTokens: toInt(usage.completion_tokens ?? usage.output_tokens)
@@ -79,14 +110,21 @@ var openaiAdapter = {
 var anthropicAdapter = {
   name: "anthropic",
   matches(client) {
-    return isObject(client) && isObject(client.messages) && typeof client.messages.create === "function";
+    if (!isObject(client)) return false;
+    const messages = client.messages;
+    if (!isObject(messages)) return false;
+    return typeof messages.create === "function";
   },
   async call(client, options) {
     const { userId, feature, plan, ...rest } = options;
+    void userId;
+    void feature;
+    void plan;
     return client.messages.create(rest);
   },
   extractUsage(result) {
-    const usage = result?.usage ?? {};
+    const r = result;
+    const usage = r?.usage ?? {};
     return {
       inputTokens: toInt(usage.input_tokens),
       outputTokens: toInt(usage.output_tokens)
@@ -96,18 +134,25 @@ var anthropicAdapter = {
 var geminiAdapter = {
   name: "gemini",
   matches(client) {
-    return isObject(client) && isObject(client.models) && typeof client.models.generateContent === "function";
+    if (!isObject(client)) return false;
+    const models = client.models;
+    if (!isObject(models)) return false;
+    return typeof models.generateContent === "function";
   },
   async call(client, options) {
     const { userId, feature, plan, messages, ...rest } = options;
+    void userId;
+    void feature;
+    void plan;
     const contents = (messages ?? []).map((m) => ({
       role: m.role === "assistant" ? "model" : "user",
-      parts: [{ text: m.content }]
+      parts: [{ text: typeof m.content === "string" ? m.content : JSON.stringify(m.content) }]
     }));
     return client.models.generateContent({ ...rest, contents });
   },
   extractUsage(result) {
-    const meta = result?.usageMetadata ?? {};
+    const r = result;
+    const meta = r?.usageMetadata ?? {};
     return {
       inputTokens: toInt(meta.promptTokenCount),
       outputTokens: toInt(meta.candidatesTokenCount)
@@ -131,11 +176,15 @@ function toInt(v) {
 
 // src/logger.ts
 function createLogger(opts) {
-  const f = opts.fetch ?? globalThis.fetch;
-  if (typeof f !== "function") {
-    throw new Error("Weckr: global fetch is unavailable. Pass a fetch implementation via config.fetch.");
-  }
-  return function log(payload) {
+  const inflight = /* @__PURE__ */ new Set();
+  function log(payload) {
+    const f = opts.fetch ?? globalThis.fetch;
+    if (typeof f !== "function") {
+      opts.onError?.(
+        new Error("Weckr: global fetch is unavailable. Pass a fetch implementation via config.fetch.")
+      );
+      return;
+    }
     queueMicrotask(() => {
       let promise;
       try {
@@ -152,63 +201,38 @@ function createLogger(opts) {
         opts.onError?.(err);
         return;
       }
-      promise.then(async (res) => {
+      const tracked = promise.then(async (res) => {
         if (!res.ok) {
           const body = await res.text().catch(() => "");
           opts.onError?.(
-            new Error(`Weckr log failed: ${res.status} ${res.statusText} ${body}`.trim())
+            new Error(
+              `Weckr log failed: ${res.status} ${res.statusText} ${body}. ` + (res.status === 401 || res.status === 403 ? `Verify the api key at https://app.useweckr.com/dashboard/settings.` : "")
+            )
           );
         }
       }).catch((err) => {
         opts.onError?.(err);
+      }).finally(() => {
+        inflight.delete(tracked);
       });
+      inflight.add(tracked);
     });
-  };
-}
-
-// src/cap-cache.ts
-var TTL_MS = 6e4;
-function createCapChecker(opts) {
-  const f = opts.fetch ?? globalThis.fetch;
-  const cache = /* @__PURE__ */ new Map();
-  function key(userId, planName) {
-    return `${userId}\0${planName}`;
   }
-  return async function checkCap(userId, planName, model) {
-    const k = key(userId, planName);
-    const now = Date.now();
-    const hit = cache.get(k);
-    if (hit && hit.expiresAt > now) return hit.result;
-    if (typeof f !== "function") {
-      return { allowed: true };
-    }
-    try {
-      const url = new URL(opts.endpoint);
-      url.searchParams.set("userId", userId);
-      url.searchParams.set("planName", planName);
-      if (model) url.searchParams.set("model", model);
-      const res = await f(url.toString(), {
-        method: "GET",
-        headers: { "x-api-key": opts.apiKey }
-      });
-      if (!res.ok) {
-        opts.onError?.(
-          new Error(`Weckr cap check failed: ${res.status} ${res.statusText}`)
-        );
-        return { allowed: true };
-      }
-      const json = await res.json();
-      cache.set(k, { result: json, expiresAt: now + TTL_MS });
-      return json;
-    } catch (err) {
-      opts.onError?.(err);
-      return { allowed: true };
+  async function flush(timeoutMs = 5e3) {
+    if (inflight.size === 0) return;
+    const all = Promise.allSettled(Array.from(inflight));
+    if (timeoutMs <= 0) {
+      await all;
+      return;
     }
-  };
-}
-function deriveCheckEndpoint(logEndpoint) {
-  if (logEndpoint.endsWith("/log")) return logEndpoint.slice(0, -"/log".length) + "/check";
-  return logEndpoint.replace(/\/$/, "") + "/../check";
+    let timer;
+    const timeout = new Promise((resolve) => {
+      timer = setTimeout(() => resolve(), timeoutMs);
+    });
+    await Promise.race([all, timeout]);
+    if (timer) clearTimeout(timer);
+  }
+  return { log, flush };
 }
 
 // src/errors.ts
@@ -239,15 +263,94 @@ function capCheckToError(opts) {
     cap: opts.result.cap
   });
 }
+var WeckrConfigError = class extends Error {
+  name = "WeckrConfigError";
+  code;
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+};
+function isWeckrConfigError(e) {
+  return e instanceof Error && e.name === "WeckrConfigError";
+}
+
+// src/cap-cache.ts
+var TTL_MS = 6e4;
+function cacheKey(userId, planName, model) {
+  return JSON.stringify([userId, planName, model ?? null]);
+}
+function createCapChecker(opts) {
+  const f = opts.fetch ?? globalThis.fetch;
+  const cache = /* @__PURE__ */ new Map();
+  const inflight = /* @__PURE__ */ new Map();
+  return async function checkCap(userId, planName, model) {
+    const k = cacheKey(userId, planName, model);
+    const now = Date.now();
+    const hit = cache.get(k);
+    if (hit && hit.expiresAt > now) return hit.result;
+    const pending = inflight.get(k);
+    if (pending) return pending;
+    if (typeof f !== "function") {
+      return { allowed: true };
+    }
+    const fetchPromise = (async () => {
+      try {
+        const url = new URL(opts.endpoint);
+        url.searchParams.set("userId", userId);
+        url.searchParams.set("planName", planName);
+        if (model) url.searchParams.set("model", model);
+        const res = await f(url.toString(), {
+          method: "GET",
+          headers: { "x-api-key": opts.apiKey }
+        });
+        if (res.status === 401 || res.status === 403) {
+          const body = await res.text().catch(() => "");
+          throw new WeckrConfigError(
+            res.status === 401 ? "invalid_api_key" : "forbidden",
+            `Weckr: cap-check rejected with ${res.status}. Verify the api key is correct, not revoked, and active in the dashboard. Server said: ${body || "(no body)"}`
+          );
+        }
+        if (!res.ok) {
+          opts.onError?.(
+            new Error(`Weckr cap check failed: ${res.status} ${res.statusText}`)
+          );
+          return { allowed: true };
+        }
+        const json = await res.json();
+        cache.set(k, { result: json, expiresAt: Date.now() + TTL_MS });
+        return json;
+      } catch (err) {
+        if (err instanceof WeckrConfigError) throw err;
+        opts.onError?.(err);
+        return { allowed: true };
+      } finally {
+        inflight.delete(k);
+      }
+    })();
+    inflight.set(k, fetchPromise);
+    return fetchPromise;
+  };
+}
+function deriveCheckEndpoint(logEndpoint) {
+  if (logEndpoint.endsWith("/log")) return logEndpoint.slice(0, -"/log".length) + "/check";
+  throw new WeckrConfigError(
+    "invalid_api_key",
+    // closest reusable code; semantically a config bug
+    `Weckr: cannot derive checkEndpoint from endpoint "${logEndpoint}" \u2014 it does not end in "/log". Pass an explicit \`checkEndpoint\` in the Weckr config.`
+  );
+}
 
 // src/weckr.ts
-var DEFAULT_ENDPOINT = "https://useweckr.com/api/v1/log";
+var DEFAULT_ENDPOINT = "https://app.useweckr.com/api/v1/log";
 var Weckr = class {
   apiKey;
   plans;
-  log;
+  logger;
   checkCap;
   onError;
+  onDowngrade;
+  downgradeSeen = /* @__PURE__ */ new Set();
   constructor(config) {
     if (!config?.apiKey) {
       throw new Error("Weckr: apiKey is required.");
@@ -255,8 +358,9 @@ var Weckr = class {
     this.apiKey = config.apiKey;
     this.plans = config.plans ?? {};
     this.onError = config.onError;
+    this.onDowngrade = config.onDowngrade ?? defaultDowngradeWarn.bind(this);
     const logEndpoint = config.endpoint ?? DEFAULT_ENDPOINT;
-    this.log = createLogger({
+    this.logger = createLogger({
       apiKey: config.apiKey,
       endpoint: logEndpoint,
       fetch: config.fetch,
@@ -265,9 +369,10 @@ var Weckr = class {
     if (config.disableCapCheck) {
       this.checkCap = null;
     } else {
+      const checkEndpoint = config.checkEndpoint ?? deriveCheckEndpoint(logEndpoint);
       this.checkCap = createCapChecker({
         apiKey: config.apiKey,
-        endpoint: config.checkEndpoint ?? deriveCheckEndpoint(logEndpoint),
+        endpoint: checkEndpoint,
         fetch: config.fetch,
         onError: config.onError
       });
@@ -280,16 +385,22 @@ var Weckr = class {
         "Weckr: could not detect provider. Pass an OpenAI, Anthropic, or Gemini client instance."
       );
     }
+    if (options.plan != null && !Object.prototype.hasOwnProperty.call(this.plans, options.plan)) {
+      throw new WeckrConfigError(
+        "unknown_plan",
+        `Weckr: plan "${options.plan}" is not in the constructor's \`plans\` map. Add it as \`plans: { "${options.plan}": <monthly_usd> }\` when constructing Weckr.`
+      );
+    }
     let effectiveOptions = options;
     if (this.checkCap && options.userId && options.plan) {
       const check = await this.checkCap(options.userId, options.plan, options.model);
       if (!check.allowed) {
         if (check.action === "downgrade" && check.alternativeModel) {
-          if (typeof console !== "undefined" && console.warn) {
-            console.warn(
-              `Weckr: downgrading ${options.userId} from ${options.model} to ${check.alternativeModel} (cap reached).`
-            );
-          }
+          this.onDowngrade({
+            userId: options.userId,
+            from: options.model,
+            to: check.alternativeModel
+          });
           effectiveOptions = { ...options, model: check.alternativeModel };
         } else {
           throw capCheckToError({
@@ -301,19 +412,40 @@ var Weckr = class {
       }
     }
     const startedAt = nowMs();
-    const result = await adapter.call(client, effectiveOptions);
+    let result;
+    try {
+      result = await adapter.call(client, effectiveOptions);
+    } catch (err) {
+      const latencyMs2 = Math.round(nowMs() - startedAt);
+      this.tryLog(
+        adapter.name,
+        effectiveOptions,
+        { inputTokens: 0, outputTokens: 0 },
+        latencyMs2
+      );
+      throw err;
+    }
     const latencyMs = Math.round(nowMs() - startedAt);
+    let usage = { inputTokens: 0, outputTokens: 0 };
     try {
-      const usage = adapter.extractUsage(result);
-      const { costUsd } = calculateCost(effectiveOptions.model, usage.inputTokens, usage.outputTokens);
-      const planName = effectiveOptions.plan ?? null;
+      usage = adapter.extractUsage(result);
+    } catch (err) {
+      this.onError?.(err);
+    }
+    this.tryLog(adapter.name, effectiveOptions, usage, latencyMs);
+    return result;
+  }
+  tryLog(provider, options, usage, latencyMs) {
+    try {
+      const { costUsd } = calculateCost(options.model, usage.inputTokens, usage.outputTokens);
+      const planName = options.plan ?? null;
       const planRevenueUsd = planName != null && Object.prototype.hasOwnProperty.call(this.plans, planName) ? this.plans[planName] : null;
-      const marginUsd = planRevenueUsd != null ? round2(planRevenueUsd - costUsd) : null;
+      const marginUsd = planRevenueUsd != null ? planRevenueUsd - costUsd : null;
       const payload = {
-        userId: effectiveOptions.userId ?? null,
-        feature: effectiveOptions.feature ?? null,
-        model: effectiveOptions.model,
-        provider: adapter.name,
+        userId: options.userId ?? null,
+        feature: options.feature ?? null,
+        model: options.model,
+        provider,
         inputTokens: usage.inputTokens,
         outputTokens: usage.outputTokens,
         costUsd,
@@ -321,30 +453,48 @@ var Weckr = class {
         planName,
         planRevenueUsd,
         marginUsd,
+        // sent for backward-compat; server ignores
         timestamp: (/* @__PURE__ */ new Date()).toISOString()
       };
-      this.log(payload);
+      this.logger.log(payload);
     } catch (err) {
       this.onError?.(err);
     }
-    return result;
+  }
+  /**
+   * Await all in-flight log POSTs. Call this before `process.exit()` /
+   * `Lambda return` / end of a short-lived CLI run, otherwise the daemon
+   * process is torn down before the POST hits the network.
+   */
+  flush(timeoutMs) {
+    return this.logger.flush(timeoutMs);
   }
 };
+function defaultDowngradeWarn(info) {
+  const key = `${info.userId}:${info.from}>${info.to}`;
+  const seen = this.downgradeSeen;
+  if (seen.has(key)) return;
+  seen.add(key);
+  if (typeof console !== "undefined" && console.warn) {
+    console.warn(
+      `Weckr: downgrading ${info.userId} from ${info.from} to ${info.to} (cap reached). Subsequent downgrades for this user/model will be silent.`
+    );
+  }
+}
 function nowMs() {
   if (typeof performance !== "undefined" && typeof performance.now === "function") {
     return performance.now();
   }
   return Date.now();
 }
-function round2(n) {
-  return Math.round(n * 100) / 100;
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PRICING,
   Weckr,
   WeckrCapError,
+  WeckrConfigError,
   calculateCost,
   isWeckrCapError,
+  isWeckrConfigError,
   resolvePricing
 });

package/dist/index.mjs

@@ -1,21 +1,36 @@
 // src/pricing.ts
 var PRICING = {
+  // OpenAI
   "gpt-4o": { provider: "openai", inputPerMillion: 2.5, outputPerMillion: 10 },
   "gpt-4o-mini": { provider: "openai", inputPerMillion: 0.15, outputPerMillion: 0.6 },
+  "gpt-4-turbo": { provider: "openai", inputPerMillion: 10, outputPerMillion: 30 },
+  "gpt-4": { provider: "openai", inputPerMillion: 30, outputPerMillion: 60 },
   "gpt-3.5-turbo": { provider: "openai", inputPerMillion: 0.5, outputPerMillion: 1.5 },
+  "o1-preview": { provider: "openai", inputPerMillion: 15, outputPerMillion: 60 },
+  "o1-mini": { provider: "openai", inputPerMillion: 3, outputPerMillion: 12 },
+  // Anthropic
   "claude-opus-4": { provider: "anthropic", inputPerMillion: 15, outputPerMillion: 75 },
   "claude-sonnet-4": { provider: "anthropic", inputPerMillion: 3, outputPerMillion: 15 },
-  "claude-haiku-4": { provider: "anthropic", inputPerMillion: 0.8, outputPerMillion: 4 },
+  "claude-haiku-4-5": { provider: "anthropic", inputPerMillion: 0.8, outputPerMillion: 4 },
+  "claude-3-5-sonnet": { provider: "anthropic", inputPerMillion: 3, outputPerMillion: 15 },
+  "claude-3-5-haiku": { provider: "anthropic", inputPerMillion: 0.8, outputPerMillion: 4 },
+  "claude-3-opus": { provider: "anthropic", inputPerMillion: 15, outputPerMillion: 75 },
+  // Gemini
+  "gemini-2.5-pro": { provider: "gemini", inputPerMillion: 1.25, outputPerMillion: 10 },
   "gemini-2.5-flash": { provider: "gemini", inputPerMillion: 0.15, outputPerMillion: 0.6 },
-  "gemini-2.5-pro": { provider: "gemini", inputPerMillion: 1.25, outputPerMillion: 10 }
+  "gemini-1.5-pro": { provider: "gemini", inputPerMillion: 1.25, outputPerMillion: 5 },
+  "gemini-1.5-flash": { provider: "gemini", inputPerMillion: 0.075, outputPerMillion: 0.3 }
 };
 function resolvePricing(model) {
   if (PRICING[model]) return PRICING[model];
   const lower = model.toLowerCase();
-  for (const key of Object.keys(PRICING)) {
-    if (lower.startsWith(key.toLowerCase())) return PRICING[key];
+  let best = null;
+  for (const [key, pricing] of Object.entries(PRICING)) {
+    if (lower.startsWith(key.toLowerCase())) {
+      if (!best || key.length > best.key.length) best = { key, pricing };
+    }
   }
-  return null;
+  return best?.pricing ?? null;
 }
 function calculateCost(model, inputTokens, outputTokens) {
   const pricing = resolvePricing(model);
@@ -31,14 +46,28 @@ function round6(n) {
 var openaiAdapter = {
   name: "openai",
   matches(client) {
-    return isObject(client) && isObject(client.chat) && isObject(client.chat.completions) && typeof client.chat.completions.create === "function";
+    if (!isObject(client)) return false;
+    const chat = client.chat;
+    if (!isObject(chat)) return false;
+    const completions = chat.completions;
+    if (!isObject(completions)) return false;
+    return typeof completions.create === "function";
   },
   async call(client, options) {
+    if (options.stream === true) {
+      throw new Error(
+        "Weckr: stream:true is not supported by wk.chat() because token usage is not in stream responses by default. Either disable streaming, or call openai.chat.completions.create() directly outside wk.chat() (you lose cost tracking) and we will add proper streaming support in a future release."
+      );
+    }
     const { userId, feature, plan, ...rest } = options;
+    void userId;
+    void feature;
+    void plan;
     return client.chat.completions.create(rest);
   },
   extractUsage(result) {
-    const usage = result?.usage ?? {};
+    const r = result;
+    const usage = r?.usage ?? {};
     return {
       inputTokens: toInt(usage.prompt_tokens ?? usage.input_tokens),
       outputTokens: toInt(usage.completion_tokens ?? usage.output_tokens)
@@ -48,14 +77,21 @@ var openaiAdapter = {
 var anthropicAdapter = {
   name: "anthropic",
   matches(client) {
-    return isObject(client) && isObject(client.messages) && typeof client.messages.create === "function";
+    if (!isObject(client)) return false;
+    const messages = client.messages;
+    if (!isObject(messages)) return false;
+    return typeof messages.create === "function";
   },
   async call(client, options) {
     const { userId, feature, plan, ...rest } = options;
+    void userId;
+    void feature;
+    void plan;
     return client.messages.create(rest);
   },
   extractUsage(result) {
-    const usage = result?.usage ?? {};
+    const r = result;
+    const usage = r?.usage ?? {};
     return {
       inputTokens: toInt(usage.input_tokens),
       outputTokens: toInt(usage.output_tokens)
@@ -65,18 +101,25 @@ var anthropicAdapter = {
 var geminiAdapter = {
   name: "gemini",
   matches(client) {
-    return isObject(client) && isObject(client.models) && typeof client.models.generateContent === "function";
+    if (!isObject(client)) return false;
+    const models = client.models;
+    if (!isObject(models)) return false;
+    return typeof models.generateContent === "function";
   },
   async call(client, options) {
     const { userId, feature, plan, messages, ...rest } = options;
+    void userId;
+    void feature;
+    void plan;
     const contents = (messages ?? []).map((m) => ({
       role: m.role === "assistant" ? "model" : "user",
-      parts: [{ text: m.content }]
+      parts: [{ text: typeof m.content === "string" ? m.content : JSON.stringify(m.content) }]
     }));
     return client.models.generateContent({ ...rest, contents });
   },
   extractUsage(result) {
-    const meta = result?.usageMetadata ?? {};
+    const r = result;
+    const meta = r?.usageMetadata ?? {};
     return {
       inputTokens: toInt(meta.promptTokenCount),
       outputTokens: toInt(meta.candidatesTokenCount)
@@ -100,11 +143,15 @@ function toInt(v) {
 
 // src/logger.ts
 function createLogger(opts) {
-  const f = opts.fetch ?? globalThis.fetch;
-  if (typeof f !== "function") {
-    throw new Error("Weckr: global fetch is unavailable. Pass a fetch implementation via config.fetch.");
-  }
-  return function log(payload) {
+  const inflight = /* @__PURE__ */ new Set();
+  function log(payload) {
+    const f = opts.fetch ?? globalThis.fetch;
+    if (typeof f !== "function") {
+      opts.onError?.(
+        new Error("Weckr: global fetch is unavailable. Pass a fetch implementation via config.fetch.")
+      );
+      return;
+    }
     queueMicrotask(() => {
       let promise;
       try {
@@ -121,63 +168,38 @@ function createLogger(opts) {
         opts.onError?.(err);
         return;
       }
-      promise.then(async (res) => {
+      const tracked = promise.then(async (res) => {
         if (!res.ok) {
           const body = await res.text().catch(() => "");
           opts.onError?.(
-            new Error(`Weckr log failed: ${res.status} ${res.statusText} ${body}`.trim())
+            new Error(
+              `Weckr log failed: ${res.status} ${res.statusText} ${body}. ` + (res.status === 401 || res.status === 403 ? `Verify the api key at https://app.useweckr.com/dashboard/settings.` : "")
+            )
           );
         }
       }).catch((err) => {
         opts.onError?.(err);
+      }).finally(() => {
+        inflight.delete(tracked);
       });
+      inflight.add(tracked);
     });
-  };
-}
-
-// src/cap-cache.ts
-var TTL_MS = 6e4;
-function createCapChecker(opts) {
-  const f = opts.fetch ?? globalThis.fetch;
-  const cache = /* @__PURE__ */ new Map();
-  function key(userId, planName) {
-    return `${userId}\0${planName}`;
   }
-  return async function checkCap(userId, planName, model) {
-    const k = key(userId, planName);
-    const now = Date.now();
-    const hit = cache.get(k);
-    if (hit && hit.expiresAt > now) return hit.result;
-    if (typeof f !== "function") {
-      return { allowed: true };
-    }
-    try {
-      const url = new URL(opts.endpoint);
-      url.searchParams.set("userId", userId);
-      url.searchParams.set("planName", planName);
-      if (model) url.searchParams.set("model", model);
-      const res = await f(url.toString(), {
-        method: "GET",
-        headers: { "x-api-key": opts.apiKey }
-      });
-      if (!res.ok) {
-        opts.onError?.(
-          new Error(`Weckr cap check failed: ${res.status} ${res.statusText}`)
-        );
-        return { allowed: true };
-      }
-      const json = await res.json();
-      cache.set(k, { result: json, expiresAt: now + TTL_MS });
-      return json;
-    } catch (err) {
-      opts.onError?.(err);
-      return { allowed: true };
+  async function flush(timeoutMs = 5e3) {
+    if (inflight.size === 0) return;
+    const all = Promise.allSettled(Array.from(inflight));
+    if (timeoutMs <= 0) {
+      await all;
+      return;
     }
-  };
-}
-function deriveCheckEndpoint(logEndpoint) {
-  if (logEndpoint.endsWith("/log")) return logEndpoint.slice(0, -"/log".length) + "/check";
-  return logEndpoint.replace(/\/$/, "") + "/../check";
+    let timer;
+    const timeout = new Promise((resolve) => {
+      timer = setTimeout(() => resolve(), timeoutMs);
+    });
+    await Promise.race([all, timeout]);
+    if (timer) clearTimeout(timer);
+  }
+  return { log, flush };
 }
 
 // src/errors.ts
@@ -208,15 +230,94 @@ function capCheckToError(opts) {
     cap: opts.result.cap
   });
 }
+var WeckrConfigError = class extends Error {
+  name = "WeckrConfigError";
+  code;
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+};
+function isWeckrConfigError(e) {
+  return e instanceof Error && e.name === "WeckrConfigError";
+}
+
+// src/cap-cache.ts
+var TTL_MS = 6e4;
+function cacheKey(userId, planName, model) {
+  return JSON.stringify([userId, planName, model ?? null]);
+}
+function createCapChecker(opts) {
+  const f = opts.fetch ?? globalThis.fetch;
+  const cache = /* @__PURE__ */ new Map();
+  const inflight = /* @__PURE__ */ new Map();
+  return async function checkCap(userId, planName, model) {
+    const k = cacheKey(userId, planName, model);
+    const now = Date.now();
+    const hit = cache.get(k);
+    if (hit && hit.expiresAt > now) return hit.result;
+    const pending = inflight.get(k);
+    if (pending) return pending;
+    if (typeof f !== "function") {
+      return { allowed: true };
+    }
+    const fetchPromise = (async () => {
+      try {
+        const url = new URL(opts.endpoint);
+        url.searchParams.set("userId", userId);
+        url.searchParams.set("planName", planName);
+        if (model) url.searchParams.set("model", model);
+        const res = await f(url.toString(), {
+          method: "GET",
+          headers: { "x-api-key": opts.apiKey }
+        });
+        if (res.status === 401 || res.status === 403) {
+          const body = await res.text().catch(() => "");
+          throw new WeckrConfigError(
+            res.status === 401 ? "invalid_api_key" : "forbidden",
+            `Weckr: cap-check rejected with ${res.status}. Verify the api key is correct, not revoked, and active in the dashboard. Server said: ${body || "(no body)"}`
+          );
+        }
+        if (!res.ok) {
+          opts.onError?.(
+            new Error(`Weckr cap check failed: ${res.status} ${res.statusText}`)
+          );
+          return { allowed: true };
+        }
+        const json = await res.json();
+        cache.set(k, { result: json, expiresAt: Date.now() + TTL_MS });
+        return json;
+      } catch (err) {
+        if (err instanceof WeckrConfigError) throw err;
+        opts.onError?.(err);
+        return { allowed: true };
+      } finally {
+        inflight.delete(k);
+      }
+    })();
+    inflight.set(k, fetchPromise);
+    return fetchPromise;
+  };
+}
+function deriveCheckEndpoint(logEndpoint) {
+  if (logEndpoint.endsWith("/log")) return logEndpoint.slice(0, -"/log".length) + "/check";
+  throw new WeckrConfigError(
+    "invalid_api_key",
+    // closest reusable code; semantically a config bug
+    `Weckr: cannot derive checkEndpoint from endpoint "${logEndpoint}" \u2014 it does not end in "/log". Pass an explicit \`checkEndpoint\` in the Weckr config.`
+  );
+}
 
 // src/weckr.ts
-var DEFAULT_ENDPOINT = "https://useweckr.com/api/v1/log";
+var DEFAULT_ENDPOINT = "https://app.useweckr.com/api/v1/log";
 var Weckr = class {
   apiKey;
   plans;
-  log;
+  logger;
   checkCap;
   onError;
+  onDowngrade;
+  downgradeSeen = /* @__PURE__ */ new Set();
   constructor(config) {
     if (!config?.apiKey) {
       throw new Error("Weckr: apiKey is required.");
@@ -224,8 +325,9 @@ var Weckr = class {
     this.apiKey = config.apiKey;
     this.plans = config.plans ?? {};
     this.onError = config.onError;
+    this.onDowngrade = config.onDowngrade ?? defaultDowngradeWarn.bind(this);
     const logEndpoint = config.endpoint ?? DEFAULT_ENDPOINT;
-    this.log = createLogger({
+    this.logger = createLogger({
       apiKey: config.apiKey,
       endpoint: logEndpoint,
       fetch: config.fetch,
@@ -234,9 +336,10 @@ var Weckr = class {
     if (config.disableCapCheck) {
       this.checkCap = null;
     } else {
+      const checkEndpoint = config.checkEndpoint ?? deriveCheckEndpoint(logEndpoint);
       this.checkCap = createCapChecker({
         apiKey: config.apiKey,
-        endpoint: config.checkEndpoint ?? deriveCheckEndpoint(logEndpoint),
+        endpoint: checkEndpoint,
         fetch: config.fetch,
         onError: config.onError
       });
@@ -249,16 +352,22 @@ var Weckr = class {
         "Weckr: could not detect provider. Pass an OpenAI, Anthropic, or Gemini client instance."
       );
     }
+    if (options.plan != null && !Object.prototype.hasOwnProperty.call(this.plans, options.plan)) {
+      throw new WeckrConfigError(
+        "unknown_plan",
+        `Weckr: plan "${options.plan}" is not in the constructor's \`plans\` map. Add it as \`plans: { "${options.plan}": <monthly_usd> }\` when constructing Weckr.`
+      );
+    }
     let effectiveOptions = options;
     if (this.checkCap && options.userId && options.plan) {
       const check = await this.checkCap(options.userId, options.plan, options.model);
       if (!check.allowed) {
         if (check.action === "downgrade" && check.alternativeModel) {
-          if (typeof console !== "undefined" && console.warn) {
-            console.warn(
-              `Weckr: downgrading ${options.userId} from ${options.model} to ${check.alternativeModel} (cap reached).`
-            );
-          }
+          this.onDowngrade({
+            userId: options.userId,
+            from: options.model,
+            to: check.alternativeModel
+          });
           effectiveOptions = { ...options, model: check.alternativeModel };
         } else {
           throw capCheckToError({
@@ -270,19 +379,40 @@ var Weckr = class {
       }
     }
     const startedAt = nowMs();
-    const result = await adapter.call(client, effectiveOptions);
+    let result;
+    try {
+      result = await adapter.call(client, effectiveOptions);
+    } catch (err) {
+      const latencyMs2 = Math.round(nowMs() - startedAt);
+      this.tryLog(
+        adapter.name,
+        effectiveOptions,
+        { inputTokens: 0, outputTokens: 0 },
+        latencyMs2
+      );
+      throw err;
+    }
     const latencyMs = Math.round(nowMs() - startedAt);
+    let usage = { inputTokens: 0, outputTokens: 0 };
     try {
-      const usage = adapter.extractUsage(result);
-      const { costUsd } = calculateCost(effectiveOptions.model, usage.inputTokens, usage.outputTokens);
-      const planName = effectiveOptions.plan ?? null;
+      usage = adapter.extractUsage(result);
+    } catch (err) {
+      this.onError?.(err);
+    }
+    this.tryLog(adapter.name, effectiveOptions, usage, latencyMs);
+    return result;
+  }
+  tryLog(provider, options, usage, latencyMs) {
+    try {
+      const { costUsd } = calculateCost(options.model, usage.inputTokens, usage.outputTokens);
+      const planName = options.plan ?? null;
       const planRevenueUsd = planName != null && Object.prototype.hasOwnProperty.call(this.plans, planName) ? this.plans[planName] : null;
-      const marginUsd = planRevenueUsd != null ? round2(planRevenueUsd - costUsd) : null;
+      const marginUsd = planRevenueUsd != null ? planRevenueUsd - costUsd : null;
       const payload = {
-        userId: effectiveOptions.userId ?? null,
-        feature: effectiveOptions.feature ?? null,
-        model: effectiveOptions.model,
-        provider: adapter.name,
+        userId: options.userId ?? null,
+        feature: options.feature ?? null,
+        model: options.model,
+        provider,
         inputTokens: usage.inputTokens,
         outputTokens: usage.outputTokens,
         costUsd,
@@ -290,29 +420,47 @@ var Weckr = class {
         planName,
         planRevenueUsd,
         marginUsd,
+        // sent for backward-compat; server ignores
         timestamp: (/* @__PURE__ */ new Date()).toISOString()
       };
-      this.log(payload);
+      this.logger.log(payload);
     } catch (err) {
       this.onError?.(err);
     }
-    return result;
+  }
+  /**
+   * Await all in-flight log POSTs. Call this before `process.exit()` /
+   * `Lambda return` / end of a short-lived CLI run, otherwise the daemon
+   * process is torn down before the POST hits the network.
+   */
+  flush(timeoutMs) {
+    return this.logger.flush(timeoutMs);
   }
 };
+function defaultDowngradeWarn(info) {
+  const key = `${info.userId}:${info.from}>${info.to}`;
+  const seen = this.downgradeSeen;
+  if (seen.has(key)) return;
+  seen.add(key);
+  if (typeof console !== "undefined" && console.warn) {
+    console.warn(
+      `Weckr: downgrading ${info.userId} from ${info.from} to ${info.to} (cap reached). Subsequent downgrades for this user/model will be silent.`
+    );
+  }
+}
 function nowMs() {
   if (typeof performance !== "undefined" && typeof performance.now === "function") {
     return performance.now();
   }
   return Date.now();
 }
-function round2(n) {
-  return Math.round(n * 100) / 100;
-}
 export {
   PRICING,
   Weckr,
   WeckrCapError,
+  WeckrConfigError,
   calculateCost,
   isWeckrCapError,
+  isWeckrConfigError,
   resolvePricing
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weckr/sdk",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "AI cost and margin intelligence for SaaS founders",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -43,25 +43,24 @@
     "url": "https://github.com/Ghiles3232/weckr"
   },
   "peerDependencies": {
-    "openai": ">=4.0.0"
+    "openai": ">=4.0.0",
+    "@anthropic-ai/sdk": ">=0.20.0",
+    "@google/genai": ">=0.4.0"
   },
   "peerDependenciesMeta": {
-    "openai": {
-      "optional": true
-    },
-    "@anthropic-ai/sdk": {
-      "optional": true
-    },
-    "@google/generative-ai": {
-      "optional": true
-    }
+    "openai": { "optional": true },
+    "@anthropic-ai/sdk": { "optional": true },
+    "@google/genai": { "optional": true }
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
     "openai": "^4.77.0",
-    "tsup": "^8.3.5",
+    "tsup": "^8.5.1",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
+    "vitest": "^4.1.8"
+  },
+  "overrides": {
+    "esbuild": "0.28.1"
   }
 }