@resultdev/sdk 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @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

package/dist/{client--Xjaaw1l.d.ts → 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-BmU3deRO.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.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>;

package/dist/{client-BrOD2EO5.d.cts → 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-BmU3deRO.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.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>;

package/dist/index.cjs

@@ -602,6 +602,7 @@ var HttpClient = class {
       }
       let controller;
       let timer;
+      let removeCallerAbortListener;
       if (this.timeout > 0 || callerSignal) {
         controller = new AbortController();
         if (this.timeout > 0) {
@@ -615,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,
@@ -645,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(
@@ -672,6 +663,13 @@ var HttpClient = class {
           0,
           "NETWORK_ERROR"
         );
+      } finally {
+        if (timer !== void 0) {
+          clearTimeout(timer);
+        }
+        if (detachOnExit) {
+          removeCallerAbortListener?.();
+        }
       }
     }
     throw lastError || new ResultError(
@@ -734,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,
@@ -757,6 +755,8 @@ var HttpClient = class {
         );
       }
       throw err;
+    } finally {
+      releaseCallerSignal?.();
     }
     this.logger.logResponse(
       method,
@@ -858,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,
@@ -959,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;
@@ -1028,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",
@@ -1115,6 +1160,7 @@ var ChatCompletions = class {
   }
   http;
   async create(params) {
+    const usageRequestId = aiUsageRequestId();
     const contentSummary = summarizeContent(params.messages ?? []);
     assertSupportedContent(params.model, contentSummary);
     const backendParams = {
@@ -1159,7 +1205,7 @@ var ChatCompletions = class {
           contentSummary
         );
       }
-      return this.parseSSEStream(response2, params.model);
+      return this.parseSSEStream(response2, params.model, usageRequestId);
     }
     let response;
     try {
@@ -1168,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",
@@ -1194,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(
@@ -1279,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",
@@ -1350,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
@@ -1398,6 +1474,7 @@ var Images = class {
    * ```
    */
   async generate(params) {
+    const usageRequestId = aiUsageRequestId();
     const response = await this.http.post(
       "/api/ai/image/generation",
       params
@@ -1411,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-BrOD2EO5.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-BrOD2EO5.cjs';
-import { R as ResultAdminConfig, a as ResultConfig } from './types-BmU3deRO.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-BmU3deRO.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--Xjaaw1l.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--Xjaaw1l.js';
-import { R as ResultAdminConfig, a as ResultConfig } from './types-BmU3deRO.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-BmU3deRO.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

@@ -547,6 +547,7 @@ var HttpClient = class {
       }
       let controller;
       let timer;
+      let removeCallerAbortListener;
       if (this.timeout > 0 || callerSignal) {
         controller = new AbortController();
         if (this.timeout > 0) {
@@ -560,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,
@@ -590,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(
@@ -617,6 +608,13 @@ var HttpClient = class {
           0,
           "NETWORK_ERROR"
         );
+      } finally {
+        if (timer !== void 0) {
+          clearTimeout(timer);
+        }
+        if (detachOnExit) {
+          removeCallerAbortListener?.();
+        }
       }
     }
     throw lastError || new ResultError(
@@ -679,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,
@@ -702,6 +700,8 @@ var HttpClient = class {
         );
       }
       throw err;
+    } finally {
+      releaseCallerSignal?.();
     }
     this.logger.logResponse(
       method,
@@ -803,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,
@@ -904,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;
@@ -973,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",
@@ -1060,6 +1105,7 @@ var ChatCompletions = class {
   }
   http;
   async create(params) {
+    const usageRequestId = aiUsageRequestId();
     const contentSummary = summarizeContent(params.messages ?? []);
     assertSupportedContent(params.model, contentSummary);
     const backendParams = {
@@ -1104,7 +1150,7 @@ var ChatCompletions = class {
           contentSummary
         );
       }
-      return this.parseSSEStream(response2, params.model);
+      return this.parseSSEStream(response2, params.model, usageRequestId);
     }
     let response;
     try {
@@ -1113,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",
@@ -1139,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(
@@ -1224,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",
@@ -1295,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
@@ -1343,6 +1419,7 @@ var Images = class {
    * ```
    */
   async generate(params) {
+    const usageRequestId = aiUsageRequestId();
     const response = await this.http.post(
       "/api/ai/image/generation",
       params
@@ -1356,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,

package/dist/{middleware-Uh09_lFn.d.ts → middleware-8UNqItQG.d.ts}

@@ -1,4 +1,4 @@
-import { a as ResultConfig, o as ResultError } from './types-BmU3deRO.js';
+import { a as ResultConfig, o as ResultError } from './types-BTdjI7Yj.js';
 
 declare const DEFAULT_ACCESS_TOKEN_COOKIE = "result_access_token";
 declare const DEFAULT_REFRESH_TOKEN_COOKIE = "result_refresh_token";

package/dist/{middleware-VCWoai4o.d.cts → middleware-CGn44ocX.d.cts}

@@ -1,4 +1,4 @@
-import { a as ResultConfig, o as ResultError } from './types-BmU3deRO.cjs';
+import { a as ResultConfig, o as ResultError } from './types-BTdjI7Yj.cjs';
 
 declare const DEFAULT_ACCESS_TOKEN_COOKIE = "result_access_token";
 declare const DEFAULT_REFRESH_TOKEN_COOKIE = "result_refresh_token";

package/dist/ssr/middleware.d.cts

@@ -1,2 +1,2 @@
-export { b as AuthCookieNames, c as AuthCookieOptions, A as AuthCookieSettings, d as CookieOptions, e as CookieReader, C as CookieStore, a as CookieWriter, D as DEFAULT_ACCESS_TOKEN_COOKIE, f as DEFAULT_REFRESH_TOKEN_COOKIE, U as UpdateSessionOptions, g as UpdateSessionResult, i as clearAuthCookies, j as getAccessTokenCookieName, k as getRefreshTokenCookieName, s as setAuthCookies, u as updateSession } from '../middleware-VCWoai4o.cjs';
-import '../types-BmU3deRO.cjs';
+export { b as AuthCookieNames, c as AuthCookieOptions, A as AuthCookieSettings, d as CookieOptions, e as CookieReader, C as CookieStore, a as CookieWriter, D as DEFAULT_ACCESS_TOKEN_COOKIE, f as DEFAULT_REFRESH_TOKEN_COOKIE, U as UpdateSessionOptions, g as UpdateSessionResult, i as clearAuthCookies, j as getAccessTokenCookieName, k as getRefreshTokenCookieName, s as setAuthCookies, u as updateSession } from '../middleware-CGn44ocX.cjs';
+import '../types-BTdjI7Yj.cjs';

package/dist/ssr/middleware.d.ts

@@ -1,2 +1,2 @@
-export { b as AuthCookieNames, c as AuthCookieOptions, A as AuthCookieSettings, d as CookieOptions, e as CookieReader, C as CookieStore, a as CookieWriter, D as DEFAULT_ACCESS_TOKEN_COOKIE, f as DEFAULT_REFRESH_TOKEN_COOKIE, U as UpdateSessionOptions, g as UpdateSessionResult, i as clearAuthCookies, j as getAccessTokenCookieName, k as getRefreshTokenCookieName, s as setAuthCookies, u as updateSession } from '../middleware-Uh09_lFn.js';
-import '../types-BmU3deRO.js';
+export { b as AuthCookieNames, c as AuthCookieOptions, A as AuthCookieSettings, d as CookieOptions, e as CookieReader, C as CookieStore, a as CookieWriter, D as DEFAULT_ACCESS_TOKEN_COOKIE, f as DEFAULT_REFRESH_TOKEN_COOKIE, U as UpdateSessionOptions, g as UpdateSessionResult, i as clearAuthCookies, j as getAccessTokenCookieName, k as getRefreshTokenCookieName, s as setAuthCookies, u as updateSession } from '../middleware-8UNqItQG.js';
+import '../types-BTdjI7Yj.js';

package/dist/ssr.cjs

@@ -789,6 +789,7 @@ var HttpClient = class {
       }
       let controller;
       let timer;
+      let removeCallerAbortListener;
       if (this.timeout > 0 || callerSignal) {
         controller = new AbortController();
         if (this.timeout > 0) {
@@ -802,16 +803,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,
@@ -832,14 +828,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(
@@ -859,6 +850,13 @@ var HttpClient = class {
           0,
           "NETWORK_ERROR"
         );
+      } finally {
+        if (timer !== void 0) {
+          clearTimeout(timer);
+        }
+        if (detachOnExit) {
+          removeCallerAbortListener?.();
+        }
       }
     }
     throw lastError || new ResultError(
@@ -921,7 +919,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,
@@ -944,6 +942,8 @@ var HttpClient = class {
         );
       }
       throw err;
+    } finally {
+      releaseCallerSignal?.();
     }
     this.logger.logResponse(
       method,
@@ -1045,7 +1045,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,
@@ -1146,6 +1146,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;
@@ -1215,6 +1219,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",
@@ -1302,6 +1347,7 @@ var ChatCompletions = class {
   }
   http;
   async create(params) {
+    const usageRequestId = aiUsageRequestId();
     const contentSummary = summarizeContent(params.messages ?? []);
     assertSupportedContent(params.model, contentSummary);
     const backendParams = {
@@ -1346,7 +1392,7 @@ var ChatCompletions = class {
           contentSummary
         );
       }
-      return this.parseSSEStream(response2, params.model);
+      return this.parseSSEStream(response2, params.model, usageRequestId);
     }
     let response;
     try {
@@ -1355,6 +1401,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",
@@ -1381,14 +1437,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(
@@ -1466,6 +1522,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",
@@ -1537,17 +1602,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
@@ -1585,6 +1661,7 @@ var Images = class {
    * ```
    */
   async generate(params) {
+    const usageRequestId = aiUsageRequestId();
     const response = await this.http.post(
       "/api/ai/image/generation",
       params
@@ -1598,6 +1675,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/ssr.d.cts

@@ -1,7 +1,7 @@
-import { R as ResultClient } from './client-BrOD2EO5.cjs';
-import { o as ResultError, a as ResultConfig, G as AuthRefreshResponse } from './types-BmU3deRO.cjs';
-import { A as AuthCookieSettings, C as CookieStore, a as CookieWriter } from './middleware-VCWoai4o.cjs';
-export { b as AuthCookieNames, c as AuthCookieOptions, d as CookieOptions, e as CookieReader, D as DEFAULT_ACCESS_TOKEN_COOKIE, f as DEFAULT_REFRESH_TOKEN_COOKIE, U as UpdateSessionOptions, g as UpdateSessionResult, h as accessTokenCookieOptions, i as clearAuthCookies, j as getAccessTokenCookieName, k as getRefreshTokenCookieName, r as refreshTokenCookieOptions, s as setAuthCookies, u as updateSession } from './middleware-VCWoai4o.cjs';
+import { R as ResultClient } from './client-N6MW9IE1.cjs';
+import { o as ResultError, a as ResultConfig, G as AuthRefreshResponse } from './types-BTdjI7Yj.cjs';
+import { A as AuthCookieSettings, C as CookieStore, a as CookieWriter } from './middleware-CGn44ocX.cjs';
+export { b as AuthCookieNames, c as AuthCookieOptions, d as CookieOptions, e as CookieReader, D as DEFAULT_ACCESS_TOKEN_COOKIE, f as DEFAULT_REFRESH_TOKEN_COOKIE, U as UpdateSessionOptions, g as UpdateSessionResult, h as accessTokenCookieOptions, i as clearAuthCookies, j as getAccessTokenCookieName, k as getRefreshTokenCookieName, r as refreshTokenCookieOptions, s as setAuthCookies, u as updateSession } from './middleware-CGn44ocX.cjs';
 import '@supabase/postgrest-js';
 
 interface CreateAuthActionsOptions extends Omit<ResultConfig, "accessToken" | "edgeFunctionToken" | "isServerMode" | "auth">, AuthCookieSettings {

package/dist/ssr.d.ts

@@ -1,7 +1,7 @@
-import { R as ResultClient } from './client--Xjaaw1l.js';
-import { o as ResultError, a as ResultConfig, G as AuthRefreshResponse } from './types-BmU3deRO.js';
-import { A as AuthCookieSettings, C as CookieStore, a as CookieWriter } from './middleware-Uh09_lFn.js';
-export { b as AuthCookieNames, c as AuthCookieOptions, d as CookieOptions, e as CookieReader, D as DEFAULT_ACCESS_TOKEN_COOKIE, f as DEFAULT_REFRESH_TOKEN_COOKIE, U as UpdateSessionOptions, g as UpdateSessionResult, h as accessTokenCookieOptions, i as clearAuthCookies, j as getAccessTokenCookieName, k as getRefreshTokenCookieName, r as refreshTokenCookieOptions, s as setAuthCookies, u as updateSession } from './middleware-Uh09_lFn.js';
+import { R as ResultClient } from './client-D5IGLPW4.js';
+import { o as ResultError, a as ResultConfig, G as AuthRefreshResponse } from './types-BTdjI7Yj.js';
+import { A as AuthCookieSettings, C as CookieStore, a as CookieWriter } from './middleware-8UNqItQG.js';
+export { b as AuthCookieNames, c as AuthCookieOptions, d as CookieOptions, e as CookieReader, D as DEFAULT_ACCESS_TOKEN_COOKIE, f as DEFAULT_REFRESH_TOKEN_COOKIE, U as UpdateSessionOptions, g as UpdateSessionResult, h as accessTokenCookieOptions, i as clearAuthCookies, j as getAccessTokenCookieName, k as getRefreshTokenCookieName, r as refreshTokenCookieOptions, s as setAuthCookies, u as updateSession } from './middleware-8UNqItQG.js';
 import '@supabase/postgrest-js';
 
 interface CreateAuthActionsOptions extends Omit<ResultConfig, "accessToken" | "edgeFunctionToken" | "isServerMode" | "auth">, AuthCookieSettings {

package/dist/ssr.js

@@ -740,6 +740,7 @@ var HttpClient = class {
       }
       let controller;
       let timer;
+      let removeCallerAbortListener;
       if (this.timeout > 0 || callerSignal) {
         controller = new AbortController();
         if (this.timeout > 0) {
@@ -753,16 +754,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,
@@ -783,14 +779,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(
@@ -810,6 +801,13 @@ var HttpClient = class {
           0,
           "NETWORK_ERROR"
         );
+      } finally {
+        if (timer !== void 0) {
+          clearTimeout(timer);
+        }
+        if (detachOnExit) {
+          removeCallerAbortListener?.();
+        }
       }
     }
     throw lastError || new ResultError(
@@ -872,7 +870,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,
@@ -895,6 +893,8 @@ var HttpClient = class {
         );
       }
       throw err;
+    } finally {
+      releaseCallerSignal?.();
     }
     this.logger.logResponse(
       method,
@@ -996,7 +996,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,
@@ -1097,6 +1097,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;
@@ -1166,6 +1170,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",
@@ -1253,6 +1298,7 @@ var ChatCompletions = class {
   }
   http;
   async create(params) {
+    const usageRequestId = aiUsageRequestId();
     const contentSummary = summarizeContent(params.messages ?? []);
     assertSupportedContent(params.model, contentSummary);
     const backendParams = {
@@ -1297,7 +1343,7 @@ var ChatCompletions = class {
           contentSummary
         );
       }
-      return this.parseSSEStream(response2, params.model);
+      return this.parseSSEStream(response2, params.model, usageRequestId);
     }
     let response;
     try {
@@ -1306,6 +1352,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",
@@ -1332,14 +1388,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(
@@ -1417,6 +1473,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",
@@ -1488,17 +1553,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
@@ -1536,6 +1612,7 @@ var Images = class {
    * ```
    */
   async generate(params) {
+    const usageRequestId = aiUsageRequestId();
     const response = await this.http.post(
       "/api/ai/image/generation",
       params
@@ -1549,6 +1626,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/{types-BmU3deRO.d.cts → types-BTdjI7Yj.d.cts}

@@ -528,7 +528,8 @@ interface ResultConfig {
     /**
      * The base URL of the Result backend API (the NEXT_PUBLIC_BACKEND_URL
      * value from .env.local). Required at runtime: constructing a client
-     * without it throws MISSING_BASE_URL.
+     * without it throws MISSING_BASE_URL. (Kept optional in the type because
+     * the SSR entrypoints intentionally fill it from process.env.)
      */
     baseUrl?: string;
     /**

package/dist/{types-BmU3deRO.d.ts → types-BTdjI7Yj.d.ts}

@@ -528,7 +528,8 @@ interface ResultConfig {
     /**
      * The base URL of the Result backend API (the NEXT_PUBLIC_BACKEND_URL
      * value from .env.local). Required at runtime: constructing a client
-     * without it throws MISSING_BASE_URL.
+     * without it throws MISSING_BASE_URL. (Kept optional in the type because
+     * the SSR entrypoints intentionally fill it from process.env.)
      */
     baseUrl?: string;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@resultdev/sdk",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Result Backend SDK - authentication, database, storage, functions, realtime, AI, email, web analytics and customer support for apps built on Result.",
   "license": "UNLICENSED",
   "homepage": "https://docs.result.dev",
@@ -59,8 +59,19 @@
       }
     }
   },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "check-types": "tsc --noEmit -p tsconfig.json"
+  },
   "dependencies": {
     "@supabase/postgrest-js": "^1.21.3",
     "socket.io-client": "^4.8.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
   }
-}
+}