@resultdev/sdk 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @resultdev/sdk
 
+## 0.3.2
+
+- AI calls made through the SDK now report returned token usage to the
+  matching Result app. Operations can show per-app AI usage even while the
+  upstream partnership AI counters remain unavailable.
+- Caller AbortSignal listeners are now detached once a response body is
+  fully consumed, instead of accumulating on long-lived signals across
+  requests.
+
+## 0.3.1
+
+- A missing `baseUrl` now throws `MISSING_BASE_URL` at client construction
+  instead of silently falling back to a localhost dev URL. The fallback made
+  deployed sites whose `NEXT_PUBLIC_BACKEND_URL` was undefined in the
+  browser bundle (for example when the env var is read through an imported
+  `process` module, which defeats build-time inlining) call `localhost` from
+  production pages, which surfaced as Chrome's "access other apps and
+  services on this device" permission prompt. The error's fix hint names the
+  env var and the inlining rule.
+
 ## 0.3.0
 
 Reliability release: every fix here comes from live verification against a

package/dist/{client-CJv_awPt.d.cts → client-D5IGLPW4.d.ts}

@@ -1,4 +1,4 @@
-import { e as AuthSession, U as UserSchema, a as ResultConfig, G as AuthRefreshResponse, C as ChatCompletionRequest, B as ToolCall, H as Annotation, I as ImageGenerationRequest, j as EmbeddingsRequest, J as EmbeddingObject, h as CreateUserRequest, K as CreateUserResponse, o as ResultError, g as CreateSessionRequest, L as CreateSessionResponse, l as OAuthProvidersSchema, M as RefreshSessionResponse, N as GetProfileResponse, Q as SendVerificationEmailRequest, V as VerifyEmailRequest, W as VerifyEmailResponse, X as SendResetPasswordEmailRequest, Y as ExchangeResetPasswordTokenRequest, Z as ExchangeResetPasswordTokenResponse, _ as ResetPasswordResponse, $ as GetPublicAuthConfigResponse, S as SendRawEmailRequest, q as SendEmailResponse, v as SubscribeResponse, r as SocketMessage, P as PresenceMember, u as StorageFileSchema, a0 as ListObjectsResponseSchema, i as DeleteObjectsResponse, A as Analytics, w as Support } from './types-DSVtGaIA.cjs';
+import { e as AuthSession, U as UserSchema, a as ResultConfig, G as AuthRefreshResponse, C as ChatCompletionRequest, B as ToolCall, H as Annotation, I as ImageGenerationRequest, j as EmbeddingsRequest, J as EmbeddingObject, h as CreateUserRequest, K as CreateUserResponse, o as ResultError, g as CreateSessionRequest, L as CreateSessionResponse, l as OAuthProvidersSchema, M as RefreshSessionResponse, N as GetProfileResponse, Q as SendVerificationEmailRequest, V as VerifyEmailRequest, W as VerifyEmailResponse, X as SendResetPasswordEmailRequest, Y as ExchangeResetPasswordTokenRequest, Z as ExchangeResetPasswordTokenResponse, _ as ResetPasswordResponse, $ as GetPublicAuthConfigResponse, S as SendRawEmailRequest, q as SendEmailResponse, v as SubscribeResponse, r as SocketMessage, P as PresenceMember, u as StorageFileSchema, a0 as ListObjectsResponseSchema, i as DeleteObjectsResponse, A as Analytics, w as Support } from './types-BTdjI7Yj.js';
 import * as _supabase_postgrest_js from '@supabase/postgrest-js';
 import { PostgrestClient } from '@supabase/postgrest-js';
 
@@ -200,6 +200,8 @@ declare class HttpClient {
     setRefreshToken(token: string | null): void;
     /** Returns the current default headers including the authorization header if set. */
     getHeaders(): Record<string, string>;
+    /** Returns the publishable project key used to identify SDK usage reports. */
+    getAnonKey(): string | undefined;
     refreshAccessToken(): Promise<AuthRefreshResponse>;
     /** Returns a token safe to use for a new connection handshake. */
     getValidAccessToken(leewaySeconds?: number): Promise<string | null>;
@@ -996,7 +998,7 @@ type AccessTokenChangeEvent = typeof AuthChangeEvent.SIGNED_IN | typeof AuthChan
  * import { ResultClient } from '@resultdev/sdk';
  *
  * const client = new ResultClient({
- *   baseUrl: 'http://localhost:7130'
+ *   baseUrl: process.env.NEXT_PUBLIC_BACKEND_URL!
  * });
  *
  * // Authentication
@@ -1027,7 +1029,7 @@ type AccessTokenChangeEvent = typeof AuthChangeEvent.SIGNED_IN | typeof AuthChan
  *
  * // Enable debug logging
  * const debugClient = new ResultClient({
- *   baseUrl: 'http://localhost:7130',
+ *   baseUrl: process.env.NEXT_PUBLIC_BACKEND_URL!,
  *   debug: true
  * });
  * ```

package/dist/{client-DrsZ1qIm.d.ts → client-N6MW9IE1.d.cts}

@@ -1,4 +1,4 @@
-import { e as AuthSession, U as UserSchema, a as ResultConfig, G as AuthRefreshResponse, C as ChatCompletionRequest, B as ToolCall, H as Annotation, I as ImageGenerationRequest, j as EmbeddingsRequest, J as EmbeddingObject, h as CreateUserRequest, K as CreateUserResponse, o as ResultError, g as CreateSessionRequest, L as CreateSessionResponse, l as OAuthProvidersSchema, M as RefreshSessionResponse, N as GetProfileResponse, Q as SendVerificationEmailRequest, V as VerifyEmailRequest, W as VerifyEmailResponse, X as SendResetPasswordEmailRequest, Y as ExchangeResetPasswordTokenRequest, Z as ExchangeResetPasswordTokenResponse, _ as ResetPasswordResponse, $ as GetPublicAuthConfigResponse, S as SendRawEmailRequest, q as SendEmailResponse, v as SubscribeResponse, r as SocketMessage, P as PresenceMember, u as StorageFileSchema, a0 as ListObjectsResponseSchema, i as DeleteObjectsResponse, A as Analytics, w as Support } from './types-DSVtGaIA.js';
+import { e as AuthSession, U as UserSchema, a as ResultConfig, G as AuthRefreshResponse, C as ChatCompletionRequest, B as ToolCall, H as Annotation, I as ImageGenerationRequest, j as EmbeddingsRequest, J as EmbeddingObject, h as CreateUserRequest, K as CreateUserResponse, o as ResultError, g as CreateSessionRequest, L as CreateSessionResponse, l as OAuthProvidersSchema, M as RefreshSessionResponse, N as GetProfileResponse, Q as SendVerificationEmailRequest, V as VerifyEmailRequest, W as VerifyEmailResponse, X as SendResetPasswordEmailRequest, Y as ExchangeResetPasswordTokenRequest, Z as ExchangeResetPasswordTokenResponse, _ as ResetPasswordResponse, $ as GetPublicAuthConfigResponse, S as SendRawEmailRequest, q as SendEmailResponse, v as SubscribeResponse, r as SocketMessage, P as PresenceMember, u as StorageFileSchema, a0 as ListObjectsResponseSchema, i as DeleteObjectsResponse, A as Analytics, w as Support } from './types-BTdjI7Yj.cjs';
 import * as _supabase_postgrest_js from '@supabase/postgrest-js';
 import { PostgrestClient } from '@supabase/postgrest-js';
 
@@ -200,6 +200,8 @@ declare class HttpClient {
     setRefreshToken(token: string | null): void;
     /** Returns the current default headers including the authorization header if set. */
     getHeaders(): Record<string, string>;
+    /** Returns the publishable project key used to identify SDK usage reports. */
+    getAnonKey(): string | undefined;
     refreshAccessToken(): Promise<AuthRefreshResponse>;
     /** Returns a token safe to use for a new connection handshake. */
     getValidAccessToken(leewaySeconds?: number): Promise<string | null>;
@@ -996,7 +998,7 @@ type AccessTokenChangeEvent = typeof AuthChangeEvent.SIGNED_IN | typeof AuthChan
  * import { ResultClient } from '@resultdev/sdk';
  *
  * const client = new ResultClient({
- *   baseUrl: 'http://localhost:7130'
+ *   baseUrl: process.env.NEXT_PUBLIC_BACKEND_URL!
  * });
  *
  * // Authentication
@@ -1027,7 +1029,7 @@ type AccessTokenChangeEvent = typeof AuthChangeEvent.SIGNED_IN | typeof AuthChan
  *
  * // Enable debug logging
  * const debugClient = new ResultClient({
- *   baseUrl: 'http://localhost:7130',
+ *   baseUrl: process.env.NEXT_PUBLIC_BACKEND_URL!,
  *   debug: true
  * });
  * ```

package/dist/index.cjs

@@ -503,7 +503,15 @@ var HttpClient = class {
    */
   constructor(config, tokenManager, logger) {
     this.config = config;
-    this.baseUrl = config.baseUrl || "http://localhost:7130";
+    if (!config.baseUrl) {
+      throw new ResultError(
+        "createClient needs a baseUrl, but it was undefined at runtime.",
+        0,
+        "MISSING_BASE_URL",
+        "Pass the NEXT_PUBLIC_BACKEND_URL value from .env.local. In browser code, write process.env.NEXT_PUBLIC_BACKEND_URL as a literal expression (never through an imported process module) so the bundler inlines it, and set it as a deployments build variable before deploying."
+      );
+    }
+    this.baseUrl = config.baseUrl;
     this.fetch = config.fetch || (globalThis.fetch ? globalThis.fetch.bind(globalThis) : void 0);
     this.anonKey = config.anonKey;
     this.defaultHeaders = {
@@ -594,6 +602,7 @@ var HttpClient = class {
       }
       let controller;
       let timer;
+      let removeCallerAbortListener;
       if (this.timeout > 0 || callerSignal) {
         controller = new AbortController();
         if (this.timeout > 0) {
@@ -607,16 +616,11 @@ var HttpClient = class {
             callerSignal.addEventListener("abort", onCallerAbort, {
               once: true
             });
-            controller.signal.addEventListener(
-              "abort",
-              () => {
-                callerSignal.removeEventListener("abort", onCallerAbort);
-              },
-              { once: true }
-            );
+            removeCallerAbortListener = () => callerSignal.removeEventListener("abort", onCallerAbort);
           }
         }
       }
+      let detachOnExit = true;
       try {
         const response = await this.fetch(url, {
           method,
@@ -637,14 +641,9 @@ var HttpClient = class {
           );
           continue;
         }
-        if (timer !== void 0) {
-          clearTimeout(timer);
-        }
-        return response;
+        detachOnExit = false;
+        return { response, releaseCallerSignal: removeCallerAbortListener };
       } catch (err) {
-        if (timer !== void 0) {
-          clearTimeout(timer);
-        }
         if (err?.name === "AbortError") {
           if (controller?.signal.aborted && this.timeout > 0 && !callerSignal?.aborted) {
             throw new ResultError(
@@ -664,6 +663,13 @@ var HttpClient = class {
           0,
           "NETWORK_ERROR"
         );
+      } finally {
+        if (timer !== void 0) {
+          clearTimeout(timer);
+        }
+        if (detachOnExit) {
+          removeCallerAbortListener?.();
+        }
       }
     }
     throw lastError || new ResultError(
@@ -726,7 +732,7 @@ var HttpClient = class {
       });
     }
     this.logger.logRequest(method, url, requestHeaders, processedBody);
-    const response = await this.fetchWithRetry({
+    const { response, releaseCallerSignal } = await this.fetchWithRetry({
       method,
       url,
       headers: requestHeaders,
@@ -749,6 +755,8 @@ var HttpClient = class {
         );
       }
       throw err;
+    } finally {
+      releaseCallerSignal?.();
     }
     this.logger.logResponse(
       method,
@@ -850,7 +858,7 @@ var HttpClient = class {
     const callerSignal = initSignal ?? request?.signal;
     const maxAttempts = IDEMPOTENT_METHODS.has(method.toUpperCase()) ? this.retryCount : 0;
     this.logger.logRequest(method, url, requestHeaders, body);
-    const response = await this.fetchWithRetry({
+    const { response } = await this.fetchWithRetry({
       method,
       url,
       headers: requestHeaders,
@@ -951,6 +959,10 @@ var HttpClient = class {
     }
     return headers;
   }
+  /** Returns the publishable project key used to identify SDK usage reports. */
+  getAnonKey() {
+    return this.anonKey;
+  }
   async refreshAccessToken() {
     if (this.isRefreshing) {
       return this.refreshPromise;
@@ -1020,6 +1032,47 @@ var HttpClient = class {
   }
 };
 
+// src/modules/ai-usage.ts
+var USAGE_ENDPOINT = "https://beta.result.dev/api/usage/ai";
+async function reportAiUsage(http, requestId, model, kind, tokens) {
+  const anonKey = http.getAnonKey();
+  if (!anonKey || !Number.isSafeInteger(tokens) || tokens <= 0) {
+    return;
+  }
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 2e3);
+  try {
+    const request = {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({
+        requestId,
+        backendUrl: http.baseUrl,
+        anonKey,
+        model,
+        kind,
+        tokens
+      }),
+      keepalive: true,
+      signal: controller.signal
+    };
+    for (let attempt = 0; attempt < 2; attempt++) {
+      try {
+        const response = await http.fetch(USAGE_ENDPOINT, request);
+        if (response.status < 500) return;
+      } catch {
+        if (controller.signal.aborted) return;
+      }
+    }
+  } catch {
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+function aiUsageRequestId() {
+  return globalThis.crypto?.randomUUID?.() ?? null;
+}
+
 // src/modules/ai.ts
 var SUPPORTED_AUDIO_FORMATS = [
   "wav",
@@ -1107,6 +1160,7 @@ var ChatCompletions = class {
   }
   http;
   async create(params) {
+    const usageRequestId = aiUsageRequestId();
     const contentSummary = summarizeContent(params.messages ?? []);
     assertSupportedContent(params.model, contentSummary);
     const backendParams = {
@@ -1151,7 +1205,7 @@ var ChatCompletions = class {
           contentSummary
         );
       }
-      return this.parseSSEStream(response2, params.model);
+      return this.parseSSEStream(response2, params.model, usageRequestId);
     }
     let response;
     try {
@@ -1160,6 +1214,16 @@ var ChatCompletions = class {
       throw enrichUpstreamError(error, contentSummary);
     }
     const content = response.text || "";
+    const totalTokens = response.metadata?.usage?.totalTokens || 0;
+    if (usageRequestId) {
+      await reportAiUsage(
+        this.http,
+        usageRequestId,
+        params.model,
+        "chat",
+        totalTokens
+      );
+    }
     return {
       id: `chatcmpl-${Date.now()}`,
       object: "chat.completion",
@@ -1186,14 +1250,14 @@ var ChatCompletions = class {
       usage: {
         prompt_tokens: response.metadata?.usage?.promptTokens || 0,
         completion_tokens: response.metadata?.usage?.completionTokens || 0,
-        total_tokens: response.metadata?.usage?.totalTokens || 0
+        total_tokens: totalTokens
       }
     };
   }
   /**
    * Parse SSE stream into async iterable of OpenAI-like chunks
    */
-  async *parseSSEStream(response, model) {
+  async *parseSSEStream(response, model, usageRequestId) {
     const reader = response.body?.getReader();
     if (!reader) {
       throw new ResultError(
@@ -1271,6 +1335,15 @@ var ChatCompletions = class {
                   };
                 }
                 if (data.tokenUsage) {
+                  if (usageRequestId) {
+                    await reportAiUsage(
+                      this.http,
+                      usageRequestId,
+                      model,
+                      "chat",
+                      data.tokenUsage.totalTokens || 0
+                    );
+                  }
                   yield {
                     id: `chatcmpl-${Date.now()}`,
                     object: "chat.completion.chunk",
@@ -1342,17 +1415,28 @@ var Embeddings = class {
    * ```
    */
   async create(params) {
+    const usageRequestId = aiUsageRequestId();
     const response = await this.http.post(
       "/api/ai/embeddings",
       params
     );
+    const totalTokens = response.metadata?.usage?.totalTokens || 0;
+    if (usageRequestId) {
+      await reportAiUsage(
+        this.http,
+        usageRequestId,
+        params.model,
+        "embeddings",
+        totalTokens
+      );
+    }
     return {
       object: response.object,
       data: response.data,
       model: response.metadata?.model,
       usage: response.metadata?.usage ? {
         prompt_tokens: response.metadata.usage.promptTokens || 0,
-        total_tokens: response.metadata.usage.totalTokens || 0
+        total_tokens: totalTokens
       } : {
         prompt_tokens: 0,
         total_tokens: 0
@@ -1390,6 +1474,7 @@ var Images = class {
    * ```
    */
   async generate(params) {
+    const usageRequestId = aiUsageRequestId();
     const response = await this.http.post(
       "/api/ai/image/generation",
       params
@@ -1403,6 +1488,16 @@ var Images = class {
     } else if (response.text) {
       data = [{ content: response.text }];
     }
+    const totalTokens = response.metadata?.usage?.totalTokens || 0;
+    if (usageRequestId) {
+      await reportAiUsage(
+        this.http,
+        usageRequestId,
+        params.model,
+        "image",
+        totalTokens
+      );
+    }
     return {
       created: Math.floor(Date.now() / 1e3),
       data,

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { R as ResultClient } from './client-CJv_awPt.cjs';
-export { A as AI, a as AccessTokenChangeEvent, b as Auth, c as AuthChangeEvent, d as AuthStateChangeCallback, C as ChatCompletion, e as ChatCompletionChoice, f as ChatCompletionChunk, g as ChatCompletionUsage, h as ConnectionState, D as Database, E as Emails, i as EmbeddingsResult, j as EventCallback, F as FunctionInvokeOptions, k as Functions, H as HttpClient, I as ImageGenerationResult, L as Logger, l as Realtime, S as Storage, m as StorageBucket, n as StorageResponse } from './client-CJv_awPt.cjs';
-import { R as ResultAdminConfig, a as ResultConfig } from './types-DSVtGaIA.cjs';
-export { A as Analytics, b as AnalyticsOptions, c as ApiError, d as AuthErrorResponse, e as AuthSession, C as ChatCompletionRequest, f as ChatMessageSchema, g as CreateSessionRequest, h as CreateUserRequest, D as DeleteObjectResult, i as DeleteObjectsResponse, E as ERROR_CODES, j as EmbeddingsRequest, k as ErrorCode, I as ImageGenerationRequest, O as OAUTH_PROVIDERS, l as OAuthProvidersSchema, P as PresenceMember, m as ProfileSchema, n as RealtimeErrorPayload, o as ResultError, p as ResultErrorCode, S as SendEmailOptions, q as SendEmailResponse, r as SocketMessage, s as StartThreadOptions, t as StartedThread, u as StorageFileSchema, v as SubscribeResponse, w as Support, x as SupportMessage, y as SupportOptions, z as SupportThread, T as Tool, B as ToolCall, F as ToolChoice, U as UserSchema } from './types-DSVtGaIA.cjs';
+import { R as ResultClient } from './client-N6MW9IE1.cjs';
+export { A as AI, a as AccessTokenChangeEvent, b as Auth, c as AuthChangeEvent, d as AuthStateChangeCallback, C as ChatCompletion, e as ChatCompletionChoice, f as ChatCompletionChunk, g as ChatCompletionUsage, h as ConnectionState, D as Database, E as Emails, i as EmbeddingsResult, j as EventCallback, F as FunctionInvokeOptions, k as Functions, H as HttpClient, I as ImageGenerationResult, L as Logger, l as Realtime, S as Storage, m as StorageBucket, n as StorageResponse } from './client-N6MW9IE1.cjs';
+import { R as ResultAdminConfig, a as ResultConfig } from './types-BTdjI7Yj.cjs';
+export { A as Analytics, b as AnalyticsOptions, c as ApiError, d as AuthErrorResponse, e as AuthSession, C as ChatCompletionRequest, f as ChatMessageSchema, g as CreateSessionRequest, h as CreateUserRequest, D as DeleteObjectResult, i as DeleteObjectsResponse, E as ERROR_CODES, j as EmbeddingsRequest, k as ErrorCode, I as ImageGenerationRequest, O as OAUTH_PROVIDERS, l as OAuthProvidersSchema, P as PresenceMember, m as ProfileSchema, n as RealtimeErrorPayload, o as ResultError, p as ResultErrorCode, S as SendEmailOptions, q as SendEmailResponse, r as SocketMessage, s as StartThreadOptions, t as StartedThread, u as StorageFileSchema, v as SubscribeResponse, w as Support, x as SupportMessage, y as SupportOptions, z as SupportThread, T as Tool, B as ToolCall, F as ToolChoice, U as UserSchema } from './types-BTdjI7Yj.cjs';
 import '@supabase/postgrest-js';
 
 /**

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { R as ResultClient } from './client-DrsZ1qIm.js';
-export { A as AI, a as AccessTokenChangeEvent, b as Auth, c as AuthChangeEvent, d as AuthStateChangeCallback, C as ChatCompletion, e as ChatCompletionChoice, f as ChatCompletionChunk, g as ChatCompletionUsage, h as ConnectionState, D as Database, E as Emails, i as EmbeddingsResult, j as EventCallback, F as FunctionInvokeOptions, k as Functions, H as HttpClient, I as ImageGenerationResult, L as Logger, l as Realtime, S as Storage, m as StorageBucket, n as StorageResponse } from './client-DrsZ1qIm.js';
-import { R as ResultAdminConfig, a as ResultConfig } from './types-DSVtGaIA.js';
-export { A as Analytics, b as AnalyticsOptions, c as ApiError, d as AuthErrorResponse, e as AuthSession, C as ChatCompletionRequest, f as ChatMessageSchema, g as CreateSessionRequest, h as CreateUserRequest, D as DeleteObjectResult, i as DeleteObjectsResponse, E as ERROR_CODES, j as EmbeddingsRequest, k as ErrorCode, I as ImageGenerationRequest, O as OAUTH_PROVIDERS, l as OAuthProvidersSchema, P as PresenceMember, m as ProfileSchema, n as RealtimeErrorPayload, o as ResultError, p as ResultErrorCode, S as SendEmailOptions, q as SendEmailResponse, r as SocketMessage, s as StartThreadOptions, t as StartedThread, u as StorageFileSchema, v as SubscribeResponse, w as Support, x as SupportMessage, y as SupportOptions, z as SupportThread, T as Tool, B as ToolCall, F as ToolChoice, U as UserSchema } from './types-DSVtGaIA.js';
+import { R as ResultClient } from './client-D5IGLPW4.js';
+export { A as AI, a as AccessTokenChangeEvent, b as Auth, c as AuthChangeEvent, d as AuthStateChangeCallback, C as ChatCompletion, e as ChatCompletionChoice, f as ChatCompletionChunk, g as ChatCompletionUsage, h as ConnectionState, D as Database, E as Emails, i as EmbeddingsResult, j as EventCallback, F as FunctionInvokeOptions, k as Functions, H as HttpClient, I as ImageGenerationResult, L as Logger, l as Realtime, S as Storage, m as StorageBucket, n as StorageResponse } from './client-D5IGLPW4.js';
+import { R as ResultAdminConfig, a as ResultConfig } from './types-BTdjI7Yj.js';
+export { A as Analytics, b as AnalyticsOptions, c as ApiError, d as AuthErrorResponse, e as AuthSession, C as ChatCompletionRequest, f as ChatMessageSchema, g as CreateSessionRequest, h as CreateUserRequest, D as DeleteObjectResult, i as DeleteObjectsResponse, E as ERROR_CODES, j as EmbeddingsRequest, k as ErrorCode, I as ImageGenerationRequest, O as OAUTH_PROVIDERS, l as OAuthProvidersSchema, P as PresenceMember, m as ProfileSchema, n as RealtimeErrorPayload, o as ResultError, p as ResultErrorCode, S as SendEmailOptions, q as SendEmailResponse, r as SocketMessage, s as StartThreadOptions, t as StartedThread, u as StorageFileSchema, v as SubscribeResponse, w as Support, x as SupportMessage, y as SupportOptions, z as SupportThread, T as Tool, B as ToolCall, F as ToolChoice, U as UserSchema } from './types-BTdjI7Yj.js';
 import '@supabase/postgrest-js';
 
 /**

package/dist/index.js

@@ -448,7 +448,15 @@ var HttpClient = class {
    */
   constructor(config, tokenManager, logger) {
     this.config = config;
-    this.baseUrl = config.baseUrl || "http://localhost:7130";
+    if (!config.baseUrl) {
+      throw new ResultError(
+        "createClient needs a baseUrl, but it was undefined at runtime.",
+        0,
+        "MISSING_BASE_URL",
+        "Pass the NEXT_PUBLIC_BACKEND_URL value from .env.local. In browser code, write process.env.NEXT_PUBLIC_BACKEND_URL as a literal expression (never through an imported process module) so the bundler inlines it, and set it as a deployments build variable before deploying."
+      );
+    }
+    this.baseUrl = config.baseUrl;
     this.fetch = config.fetch || (globalThis.fetch ? globalThis.fetch.bind(globalThis) : void 0);
     this.anonKey = config.anonKey;
     this.defaultHeaders = {
@@ -539,6 +547,7 @@ var HttpClient = class {
       }
       let controller;
       let timer;
+      let removeCallerAbortListener;
       if (this.timeout > 0 || callerSignal) {
         controller = new AbortController();
         if (this.timeout > 0) {
@@ -552,16 +561,11 @@ var HttpClient = class {
             callerSignal.addEventListener("abort", onCallerAbort, {
               once: true
             });
-            controller.signal.addEventListener(
-              "abort",
-              () => {
-                callerSignal.removeEventListener("abort", onCallerAbort);
-              },
-              { once: true }
-            );
+            removeCallerAbortListener = () => callerSignal.removeEventListener("abort", onCallerAbort);
           }
         }
       }
+      let detachOnExit = true;
       try {
         const response = await this.fetch(url, {
           method,
@@ -582,14 +586,9 @@ var HttpClient = class {
           );
           continue;
         }
-        if (timer !== void 0) {
-          clearTimeout(timer);
-        }
-        return response;
+        detachOnExit = false;
+        return { response, releaseCallerSignal: removeCallerAbortListener };
       } catch (err) {
-        if (timer !== void 0) {
-          clearTimeout(timer);
-        }
         if (err?.name === "AbortError") {
           if (controller?.signal.aborted && this.timeout > 0 && !callerSignal?.aborted) {
             throw new ResultError(
@@ -609,6 +608,13 @@ var HttpClient = class {
           0,
           "NETWORK_ERROR"
         );
+      } finally {
+        if (timer !== void 0) {
+          clearTimeout(timer);
+        }
+        if (detachOnExit) {
+          removeCallerAbortListener?.();
+        }
       }
     }
     throw lastError || new ResultError(
@@ -671,7 +677,7 @@ var HttpClient = class {
       });
     }
     this.logger.logRequest(method, url, requestHeaders, processedBody);
-    const response = await this.fetchWithRetry({
+    const { response, releaseCallerSignal } = await this.fetchWithRetry({
       method,
       url,
       headers: requestHeaders,
@@ -694,6 +700,8 @@ var HttpClient = class {
         );
       }
       throw err;
+    } finally {
+      releaseCallerSignal?.();
     }
     this.logger.logResponse(
       method,
@@ -795,7 +803,7 @@ var HttpClient = class {
     const callerSignal = initSignal ?? request?.signal;
     const maxAttempts = IDEMPOTENT_METHODS.has(method.toUpperCase()) ? this.retryCount : 0;
     this.logger.logRequest(method, url, requestHeaders, body);
-    const response = await this.fetchWithRetry({
+    const { response } = await this.fetchWithRetry({
       method,
       url,
       headers: requestHeaders,
@@ -896,6 +904,10 @@ var HttpClient = class {
     }
     return headers;
   }
+  /** Returns the publishable project key used to identify SDK usage reports. */
+  getAnonKey() {
+    return this.anonKey;
+  }
   async refreshAccessToken() {
     if (this.isRefreshing) {
       return this.refreshPromise;
@@ -965,6 +977,47 @@ var HttpClient = class {
   }
 };
 
+// src/modules/ai-usage.ts
+var USAGE_ENDPOINT = "https://beta.result.dev/api/usage/ai";
+async function reportAiUsage(http, requestId, model, kind, tokens) {
+  const anonKey = http.getAnonKey();
+  if (!anonKey || !Number.isSafeInteger(tokens) || tokens <= 0) {
+    return;
+  }
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 2e3);
+  try {
+    const request = {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({
+        requestId,
+        backendUrl: http.baseUrl,
+        anonKey,
+        model,
+        kind,
+        tokens
+      }),
+      keepalive: true,
+      signal: controller.signal
+    };
+    for (let attempt = 0; attempt < 2; attempt++) {
+      try {
+        const response = await http.fetch(USAGE_ENDPOINT, request);
+        if (response.status < 500) return;
+      } catch {
+        if (controller.signal.aborted) return;
+      }
+    }
+  } catch {
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+function aiUsageRequestId() {
+  return globalThis.crypto?.randomUUID?.() ?? null;
+}
+
 // src/modules/ai.ts
 var SUPPORTED_AUDIO_FORMATS = [
   "wav",
@@ -1052,6 +1105,7 @@ var ChatCompletions = class {
   }
   http;
   async create(params) {
+    const usageRequestId = aiUsageRequestId();
     const contentSummary = summarizeContent(params.messages ?? []);
     assertSupportedContent(params.model, contentSummary);
     const backendParams = {
@@ -1096,7 +1150,7 @@ var ChatCompletions = class {
           contentSummary
         );
       }
-      return this.parseSSEStream(response2, params.model);
+      return this.parseSSEStream(response2, params.model, usageRequestId);
     }
     let response;
     try {
@@ -1105,6 +1159,16 @@ var ChatCompletions = class {
       throw enrichUpstreamError(error, contentSummary);
     }
     const content = response.text || "";
+    const totalTokens = response.metadata?.usage?.totalTokens || 0;
+    if (usageRequestId) {
+      await reportAiUsage(
+        this.http,
+        usageRequestId,
+        params.model,
+        "chat",
+        totalTokens
+      );
+    }
     return {
       id: `chatcmpl-${Date.now()}`,
       object: "chat.completion",
@@ -1131,14 +1195,14 @@ var ChatCompletions = class {
       usage: {
         prompt_tokens: response.metadata?.usage?.promptTokens || 0,
         completion_tokens: response.metadata?.usage?.completionTokens || 0,
-        total_tokens: response.metadata?.usage?.totalTokens || 0
+        total_tokens: totalTokens
       }
     };
   }
   /**
    * Parse SSE stream into async iterable of OpenAI-like chunks
    */
-  async *parseSSEStream(response, model) {
+  async *parseSSEStream(response, model, usageRequestId) {
     const reader = response.body?.getReader();
     if (!reader) {
       throw new ResultError(
@@ -1216,6 +1280,15 @@ var ChatCompletions = class {
                   };
                 }
                 if (data.tokenUsage) {
+                  if (usageRequestId) {
+                    await reportAiUsage(
+                      this.http,
+                      usageRequestId,
+                      model,
+                      "chat",
+                      data.tokenUsage.totalTokens || 0
+                    );
+                  }
                   yield {
                     id: `chatcmpl-${Date.now()}`,
                     object: "chat.completion.chunk",
@@ -1287,17 +1360,28 @@ var Embeddings = class {
    * ```
    */
   async create(params) {
+    const usageRequestId = aiUsageRequestId();
     const response = await this.http.post(
       "/api/ai/embeddings",
       params
     );
+    const totalTokens = response.metadata?.usage?.totalTokens || 0;
+    if (usageRequestId) {
+      await reportAiUsage(
+        this.http,
+        usageRequestId,
+        params.model,
+        "embeddings",
+        totalTokens
+      );
+    }
     return {
       object: response.object,
       data: response.data,
       model: response.metadata?.model,
       usage: response.metadata?.usage ? {
         prompt_tokens: response.metadata.usage.promptTokens || 0,
-        total_tokens: response.metadata.usage.totalTokens || 0
+        total_tokens: totalTokens
       } : {
         prompt_tokens: 0,
         total_tokens: 0
@@ -1335,6 +1419,7 @@ var Images = class {
    * ```
    */
   async generate(params) {
+    const usageRequestId = aiUsageRequestId();
     const response = await this.http.post(
       "/api/ai/image/generation",
       params
@@ -1348,6 +1433,16 @@ var Images = class {
     } else if (response.text) {
       data = [{ content: response.text }];
     }
+    const totalTokens = response.metadata?.usage?.totalTokens || 0;
+    if (usageRequestId) {
+      await reportAiUsage(
+        this.http,
+        usageRequestId,
+        params.model,
+        "image",
+        totalTokens
+      );
+    }
     return {
       created: Math.floor(Date.now() / 1e3),
       data,