@resultdev/sdk 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { R as ResultClient } from './client-Z0zUHGE3.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-Z0zUHGE3.js';
-import { R as ResultAdminConfig, a as ResultConfig } from './types-CbsaMttt.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-CbsaMttt.js';
+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 '@supabase/postgrest-js';
 
 /**

package/dist/index.js

@@ -966,6 +966,70 @@ var HttpClient = class {
 };
 
 // src/modules/ai.ts
+var SUPPORTED_AUDIO_FORMATS = [
+  "wav",
+  "mp3",
+  "aiff",
+  "aac",
+  "ogg",
+  "flac",
+  "m4a"
+];
+var MULTIMODAL_MODEL = "google/gemini-2.5-flash";
+function summarizeContent(messages) {
+  const summary = {
+    hasImage: false,
+    hasAudio: false,
+    badAudioFormats: []
+  };
+  for (const message of messages) {
+    if (message.images?.length) {
+      summary.hasImage = true;
+    }
+    if (!Array.isArray(message.content)) {
+      continue;
+    }
+    for (const part of message.content) {
+      if (part?.type === "image_url") {
+        summary.hasImage = true;
+      } else if (part?.type === "input_audio") {
+        summary.hasAudio = true;
+        const format2 = part.input_audio?.format;
+        if (format2 && !SUPPORTED_AUDIO_FORMATS.includes(format2)) {
+          summary.badAudioFormats.push(format2);
+        }
+      }
+    }
+  }
+  return summary;
+}
+function assertSupportedContent(model, summary) {
+  if (summary.badAudioFormats.length) {
+    throw new ResultError(
+      `Audio format "${summary.badAudioFormats[0]}" is not supported. Supported formats: ${SUPPORTED_AUDIO_FORMATS.join(", ")}. Browser MediaRecorder produces webm/opus, which the gateway rejects - capture PCM with the Web Audio API and encode a 16 kHz mono WAV instead.`,
+      400,
+      "AI_INVALID_INPUT"
+    );
+  }
+  if (summary.hasAudio && model.startsWith("openai/")) {
+    throw new ResultError(
+      `Model "${model}" does not accept audio input on this gateway. Use ${MULTIMODAL_MODEL} (verified for audio).`,
+      400,
+      "AI_INVALID_INPUT"
+    );
+  }
+}
+function enrichUpstreamError(error, summary) {
+  if (!(error instanceof ResultError) || error.error !== "AI_UPSTREAM_UNAVAILABLE" || !summary.hasImage && !summary.hasAudio) {
+    return error;
+  }
+  const kind = summary.hasImage && summary.hasAudio ? "image and audio" : summary.hasImage ? "image" : "audio";
+  return new ResultError(
+    `${error.message} This request included ${kind} input; if the error persists, use ${MULTIMODAL_MODEL} (verified for vision and audio).`,
+    error.statusCode,
+    error.error
+  );
+}
 var AI = class {
   chat;
   images;
@@ -988,6 +1052,8 @@ var ChatCompletions = class {
   }
   http;
   async create(params) {
+    const contentSummary = summarizeContent(params.messages ?? []);
+    assertSupportedContent(params.model, contentSummary);
     const backendParams = {
       model: params.model,
       messages: params.messages,
@@ -1016,15 +1082,28 @@ var ChatCompletions = class {
         }
       );
       if (!response2.ok) {
-        const error = await response2.json();
-        throw new Error(error.error || "Stream request failed");
+        let body = null;
+        try {
+          body = await response2.json();
+        } catch {
+        }
+        throw enrichUpstreamError(
+          new ResultError(
+            body?.message || body?.error || "Stream request failed",
+            body?.statusCode ?? response2.status,
+            body?.error || "AI_STREAM_ERROR"
+          ),
+          contentSummary
+        );
       }
       return this.parseSSEStream(response2, params.model);
     }
-    const response = await this.http.post(
-      "/api/ai/chat/completion",
-      backendParams
-    );
+    let response;
+    try {
+      response = await this.http.post("/api/ai/chat/completion", backendParams);
+    } catch (error) {
+      throw enrichUpstreamError(error, contentSummary);
+    }
     const content = response.text || "";
     return {
       id: `chatcmpl-${Date.now()}`,
@@ -1119,6 +1198,37 @@ var ChatCompletions = class {
                     ]
                   };
                 }
+                if (data.annotations?.length) {
+                  yield {
+                    id: `chatcmpl-${Date.now()}`,
+                    object: "chat.completion.chunk",
+                    created: Math.floor(Date.now() / 1e3),
+                    model,
+                    choices: [
+                      {
+                        index: 0,
+                        delta: {
+                          annotations: data.annotations
+                        },
+                        finish_reason: null
+                      }
+                    ]
+                  };
+                }
+                if (data.tokenUsage) {
+                  yield {
+                    id: `chatcmpl-${Date.now()}`,
+                    object: "chat.completion.chunk",
+                    created: Math.floor(Date.now() / 1e3),
+                    model,
+                    choices: [],
+                    usage: {
+                      prompt_tokens: data.tokenUsage.promptTokens || 0,
+                      completion_tokens: data.tokenUsage.completionTokens || 0,
+                      total_tokens: data.tokenUsage.totalTokens || 0
+                    }
+                  };
+                }
                 if (data.done) {
                   reader.releaseLock();
                   return;
@@ -2355,13 +2465,13 @@ var Functions = class _Functions {
   functionsUrl;
   constructor(http, functionsUrl) {
     this.http = http;
-    this.functionsUrl = functionsUrl || _Functions.deriveSubhostingUrl(http.baseUrl);
+    this.functionsUrl = functionsUrl;
   }
   /**
-   * Derive the subhosting URL from the base URL.
-   * Rewrites the backend base URL to its functions subhosting URL
+   * Derive the legacy subhosting URL from the base URL
    * ({appKey}.{region}.<domain> -> {appKey}.functions.<domain>).
-   * Only applies to platform-hosted backends.
+   * Only used to recognize when a configured functionsUrl still points at
+   * the local deployment, so in-process dispatch can short-circuit it.
    */
   static deriveSubhostingUrl(baseUrl) {
     try {
@@ -2394,11 +2504,13 @@ var Functions = class _Functions {
    * Invoke an Edge Function.
    *
    * Dispatch order:
-   * 1. If the platform's in-process dispatch hook is present, call it directly.
-   *    This avoids Deno Subhosting's 508 Loop Detected when one bundled
-   *    function invokes another inside the same deployment.
-   * 2. Otherwise, try the configured subhosting URL.
-   * 3. On 404 from subhosting, fall back to the proxy path.
+   * 1. If the platform's in-process dispatch hook is present and no foreign
+   *    functionsUrl is configured, call it directly (function-to-function
+   *    calls inside the same deployment).
+   * 2. If a custom functionsUrl is configured, try it; fall back to the
+   *    proxy path on 404 or network failure.
+   * 3. Otherwise, invoke through the main host's /functions/{slug} proxy.
+   *    This route works from browsers too (correct CORS).
    *
    * @param slug The function slug to invoke
    * @param options Request options
@@ -2407,7 +2519,7 @@ var Functions = class _Functions {
     const { method = "POST", body, headers = {} } = options;
     const dispatch = globalThis.__insforge_dispatch__;
     const localFunctionsUrl = _Functions.deriveSubhostingUrl(this.http.baseUrl);
-    if (typeof dispatch === "function" && !!localFunctionsUrl && this.functionsUrl === localFunctionsUrl) {
+    if (typeof dispatch === "function" && (this.functionsUrl === void 0 || !!localFunctionsUrl && this.functionsUrl === localFunctionsUrl)) {
       try {
         const req = this.buildInProcessRequest(slug, method, body, headers);
         const res = await dispatch(req);
@@ -2442,7 +2554,8 @@ var Functions = class _Functions {
         if (error instanceof Error && error.name === "AbortError") {
           throw error;
         }
-        if (error instanceof ResultError && error.statusCode === 404) {
+        const unreachable = error instanceof ResultError && (error.statusCode === 404 || error.statusCode === 0);
+        if (unreachable) {
         } else {
           return {
             data: null,
@@ -2478,6 +2591,17 @@ var Functions = class _Functions {
 // src/modules/realtime.ts
 var CONNECT_TIMEOUT = 1e4;
 var SUBSCRIBE_TIMEOUT = 1e4;
+var CHANNEL_PREFIX = "realtime:";
+function normalizeChannelMeta(message) {
+  const channel = message?.meta?.channel;
+  if (typeof channel !== "string" || !channel.startsWith(CHANNEL_PREFIX)) {
+    return message;
+  }
+  return {
+    ...message,
+    meta: { ...message.meta, channel: channel.slice(CHANNEL_PREFIX.length) }
+  };
+}
 var Realtime = class {
   constructor(baseUrl, tokenManager, anonKey, getValidAccessToken = async () => tokenManager.getAccessToken()) {
     this.baseUrl = baseUrl;
@@ -2599,8 +2723,9 @@ var Realtime = class {
           if (event === "realtime:error") {
             return;
           }
-          this.applyPresenceEvent(event, message);
-          this.notifyListeners(event, message);
+          const normalized = normalizeChannelMeta(message);
+          this.applyPresenceEvent(event, normalized);
+          this.notifyListeners(event, normalized);
         };
         this.connectionAttempt = { id: attemptId, socket, cancel: fail };
         socket.on("connect", onConnect);
@@ -2848,6 +2973,17 @@ var Realtime = class {
       this.socket.emit("realtime:unsubscribe", { channel });
     }
   }
+  /**
+   * Publish an event to a channel.
+   *
+   * Delivery notes (verified against a live backend):
+   * - Payload fields arrive spread onto the received message itself, next to
+   *   `meta` - not nested under a `payload` key. Publishing `{ text: "hi" }`
+   *   means receivers read `msg.text`.
+   * - The sender receives its own message too. Deduplicate with
+   *   `msg.meta.messageId` (or `msg.meta.senderId`) if you also update local
+   *   state optimistically.
+   */
   async publish(channel, event, payload) {
     if (!this.socket?.connected) {
       throw new Error(
@@ -2856,6 +2992,12 @@ var Realtime = class {
     }
     this.socket.emit("realtime:publish", { channel, event, payload });
   }
+  /**
+   * Listen for an event by name, across all subscribed channels.
+   * Filter by channel inside the callback: `msg.meta.channel` always matches
+   * the exact name passed to subscribe() (the SDK strips the server's
+   * transport prefix before delivery).
+   */
   on(event, callback) {
     const listeners = this.eventListeners.get(event) ?? /* @__PURE__ */ new Set();
     listeners.add(callback);

package/dist/{middleware-TGaDOhE9.d.ts → middleware-BJl9JRg3.d.ts}

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

package/dist/{middleware-BBY_6hyx.d.cts → middleware-C1Z6aMvn.d.cts}

@@ -1,4 +1,4 @@
-import { a as ResultConfig, o as ResultError } from './types-CbsaMttt.cjs';
+import { a as ResultConfig, o as ResultError } from './types-DSVtGaIA.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-BBY_6hyx.cjs';
-import '../types-CbsaMttt.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-C1Z6aMvn.cjs';
+import '../types-DSVtGaIA.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-TGaDOhE9.js';
-import '../types-CbsaMttt.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-BJl9JRg3.js';
+import '../types-DSVtGaIA.js';

package/dist/ssr.cjs

@@ -1208,6 +1208,70 @@ var HttpClient = class {
 };
 
 // src/modules/ai.ts
+var SUPPORTED_AUDIO_FORMATS = [
+  "wav",
+  "mp3",
+  "aiff",
+  "aac",
+  "ogg",
+  "flac",
+  "m4a"
+];
+var MULTIMODAL_MODEL = "google/gemini-2.5-flash";
+function summarizeContent(messages) {
+  const summary = {
+    hasImage: false,
+    hasAudio: false,
+    badAudioFormats: []
+  };
+  for (const message of messages) {
+    if (message.images?.length) {
+      summary.hasImage = true;
+    }
+    if (!Array.isArray(message.content)) {
+      continue;
+    }
+    for (const part of message.content) {
+      if (part?.type === "image_url") {
+        summary.hasImage = true;
+      } else if (part?.type === "input_audio") {
+        summary.hasAudio = true;
+        const format2 = part.input_audio?.format;
+        if (format2 && !SUPPORTED_AUDIO_FORMATS.includes(format2)) {
+          summary.badAudioFormats.push(format2);
+        }
+      }
+    }
+  }
+  return summary;
+}
+function assertSupportedContent(model, summary) {
+  if (summary.badAudioFormats.length) {
+    throw new ResultError(
+      `Audio format "${summary.badAudioFormats[0]}" is not supported. Supported formats: ${SUPPORTED_AUDIO_FORMATS.join(", ")}. Browser MediaRecorder produces webm/opus, which the gateway rejects - capture PCM with the Web Audio API and encode a 16 kHz mono WAV instead.`,
+      400,
+      "AI_INVALID_INPUT"
+    );
+  }
+  if (summary.hasAudio && model.startsWith("openai/")) {
+    throw new ResultError(
+      `Model "${model}" does not accept audio input on this gateway. Use ${MULTIMODAL_MODEL} (verified for audio).`,
+      400,
+      "AI_INVALID_INPUT"
+    );
+  }
+}
+function enrichUpstreamError(error, summary) {
+  if (!(error instanceof ResultError) || error.error !== "AI_UPSTREAM_UNAVAILABLE" || !summary.hasImage && !summary.hasAudio) {
+    return error;
+  }
+  const kind = summary.hasImage && summary.hasAudio ? "image and audio" : summary.hasImage ? "image" : "audio";
+  return new ResultError(
+    `${error.message} This request included ${kind} input; if the error persists, use ${MULTIMODAL_MODEL} (verified for vision and audio).`,
+    error.statusCode,
+    error.error
+  );
+}
 var AI = class {
   chat;
   images;
@@ -1230,6 +1294,8 @@ var ChatCompletions = class {
   }
   http;
   async create(params) {
+    const contentSummary = summarizeContent(params.messages ?? []);
+    assertSupportedContent(params.model, contentSummary);
     const backendParams = {
       model: params.model,
       messages: params.messages,
@@ -1258,15 +1324,28 @@ var ChatCompletions = class {
         }
       );
       if (!response2.ok) {
-        const error = await response2.json();
-        throw new Error(error.error || "Stream request failed");
+        let body = null;
+        try {
+          body = await response2.json();
+        } catch {
+        }
+        throw enrichUpstreamError(
+          new ResultError(
+            body?.message || body?.error || "Stream request failed",
+            body?.statusCode ?? response2.status,
+            body?.error || "AI_STREAM_ERROR"
+          ),
+          contentSummary
+        );
       }
       return this.parseSSEStream(response2, params.model);
     }
-    const response = await this.http.post(
-      "/api/ai/chat/completion",
-      backendParams
-    );
+    let response;
+    try {
+      response = await this.http.post("/api/ai/chat/completion", backendParams);
+    } catch (error) {
+      throw enrichUpstreamError(error, contentSummary);
+    }
     const content = response.text || "";
     return {
       id: `chatcmpl-${Date.now()}`,
@@ -1361,6 +1440,37 @@ var ChatCompletions = class {
                     ]
                   };
                 }
+                if (data.annotations?.length) {
+                  yield {
+                    id: `chatcmpl-${Date.now()}`,
+                    object: "chat.completion.chunk",
+                    created: Math.floor(Date.now() / 1e3),
+                    model,
+                    choices: [
+                      {
+                        index: 0,
+                        delta: {
+                          annotations: data.annotations
+                        },
+                        finish_reason: null
+                      }
+                    ]
+                  };
+                }
+                if (data.tokenUsage) {
+                  yield {
+                    id: `chatcmpl-${Date.now()}`,
+                    object: "chat.completion.chunk",
+                    created: Math.floor(Date.now() / 1e3),
+                    model,
+                    choices: [],
+                    usage: {
+                      prompt_tokens: data.tokenUsage.promptTokens || 0,
+                      completion_tokens: data.tokenUsage.completionTokens || 0,
+                      total_tokens: data.tokenUsage.totalTokens || 0
+                    }
+                  };
+                }
                 if (data.done) {
                   reader.releaseLock();
                   return;
@@ -2597,13 +2707,13 @@ var Functions = class _Functions {
   functionsUrl;
   constructor(http, functionsUrl) {
     this.http = http;
-    this.functionsUrl = functionsUrl || _Functions.deriveSubhostingUrl(http.baseUrl);
+    this.functionsUrl = functionsUrl;
   }
   /**
-   * Derive the subhosting URL from the base URL.
-   * Rewrites the backend base URL to its functions subhosting URL
+   * Derive the legacy subhosting URL from the base URL
    * ({appKey}.{region}.<domain> -> {appKey}.functions.<domain>).
-   * Only applies to platform-hosted backends.
+   * Only used to recognize when a configured functionsUrl still points at
+   * the local deployment, so in-process dispatch can short-circuit it.
    */
   static deriveSubhostingUrl(baseUrl) {
     try {
@@ -2636,11 +2746,13 @@ var Functions = class _Functions {
    * Invoke an Edge Function.
    *
    * Dispatch order:
-   * 1. If the platform's in-process dispatch hook is present, call it directly.
-   *    This avoids Deno Subhosting's 508 Loop Detected when one bundled
-   *    function invokes another inside the same deployment.
-   * 2. Otherwise, try the configured subhosting URL.
-   * 3. On 404 from subhosting, fall back to the proxy path.
+   * 1. If the platform's in-process dispatch hook is present and no foreign
+   *    functionsUrl is configured, call it directly (function-to-function
+   *    calls inside the same deployment).
+   * 2. If a custom functionsUrl is configured, try it; fall back to the
+   *    proxy path on 404 or network failure.
+   * 3. Otherwise, invoke through the main host's /functions/{slug} proxy.
+   *    This route works from browsers too (correct CORS).
    *
    * @param slug The function slug to invoke
    * @param options Request options
@@ -2649,7 +2761,7 @@ var Functions = class _Functions {
     const { method = "POST", body, headers = {} } = options;
     const dispatch = globalThis.__insforge_dispatch__;
     const localFunctionsUrl = _Functions.deriveSubhostingUrl(this.http.baseUrl);
-    if (typeof dispatch === "function" && !!localFunctionsUrl && this.functionsUrl === localFunctionsUrl) {
+    if (typeof dispatch === "function" && (this.functionsUrl === void 0 || !!localFunctionsUrl && this.functionsUrl === localFunctionsUrl)) {
       try {
         const req = this.buildInProcessRequest(slug, method, body, headers);
         const res = await dispatch(req);
@@ -2684,7 +2796,8 @@ var Functions = class _Functions {
         if (error instanceof Error && error.name === "AbortError") {
           throw error;
         }
-        if (error instanceof ResultError && error.statusCode === 404) {
+        const unreachable = error instanceof ResultError && (error.statusCode === 404 || error.statusCode === 0);
+        if (unreachable) {
         } else {
           return {
             data: null,
@@ -2720,6 +2833,17 @@ var Functions = class _Functions {
 // src/modules/realtime.ts
 var CONNECT_TIMEOUT = 1e4;
 var SUBSCRIBE_TIMEOUT = 1e4;
+var CHANNEL_PREFIX = "realtime:";
+function normalizeChannelMeta(message) {
+  const channel = message?.meta?.channel;
+  if (typeof channel !== "string" || !channel.startsWith(CHANNEL_PREFIX)) {
+    return message;
+  }
+  return {
+    ...message,
+    meta: { ...message.meta, channel: channel.slice(CHANNEL_PREFIX.length) }
+  };
+}
 var Realtime = class {
   constructor(baseUrl, tokenManager, anonKey, getValidAccessToken = async () => tokenManager.getAccessToken()) {
     this.baseUrl = baseUrl;
@@ -2841,8 +2965,9 @@ var Realtime = class {
           if (event === "realtime:error") {
             return;
           }
-          this.applyPresenceEvent(event, message);
-          this.notifyListeners(event, message);
+          const normalized = normalizeChannelMeta(message);
+          this.applyPresenceEvent(event, normalized);
+          this.notifyListeners(event, normalized);
         };
         this.connectionAttempt = { id: attemptId, socket, cancel: fail };
         socket.on("connect", onConnect);
@@ -3090,6 +3215,17 @@ var Realtime = class {
       this.socket.emit("realtime:unsubscribe", { channel });
     }
   }
+  /**
+   * Publish an event to a channel.
+   *
+   * Delivery notes (verified against a live backend):
+   * - Payload fields arrive spread onto the received message itself, next to
+   *   `meta` - not nested under a `payload` key. Publishing `{ text: "hi" }`
+   *   means receivers read `msg.text`.
+   * - The sender receives its own message too. Deduplicate with
+   *   `msg.meta.messageId` (or `msg.meta.senderId`) if you also update local
+   *   state optimistically.
+   */
   async publish(channel, event, payload) {
     if (!this.socket?.connected) {
       throw new Error(
@@ -3098,6 +3234,12 @@ var Realtime = class {
     }
     this.socket.emit("realtime:publish", { channel, event, payload });
   }
+  /**
+   * Listen for an event by name, across all subscribed channels.
+   * Filter by channel inside the callback: `msg.meta.channel` always matches
+   * the exact name passed to subscribe() (the SDK strips the server's
+   * transport prefix before delivery).
+   */
   on(event, callback) {
     const listeners = this.eventListeners.get(event) ?? /* @__PURE__ */ new Set();
     listeners.add(callback);

package/dist/ssr.d.cts

@@ -1,7 +1,7 @@
-import { R as ResultClient } from './client-DeE086La.cjs';
-import { o as ResultError, a as ResultConfig, G as AuthRefreshResponse } from './types-CbsaMttt.cjs';
-import { A as AuthCookieSettings, C as CookieStore, a as CookieWriter } from './middleware-BBY_6hyx.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-BBY_6hyx.cjs';
+import { R as ResultClient } from './client-CJv_awPt.cjs';
+import { o as ResultError, a as ResultConfig, G as AuthRefreshResponse } from './types-DSVtGaIA.cjs';
+import { A as AuthCookieSettings, C as CookieStore, a as CookieWriter } from './middleware-C1Z6aMvn.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-C1Z6aMvn.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-Z0zUHGE3.js';
-import { o as ResultError, a as ResultConfig, G as AuthRefreshResponse } from './types-CbsaMttt.js';
-import { A as AuthCookieSettings, C as CookieStore, a as CookieWriter } from './middleware-TGaDOhE9.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-TGaDOhE9.js';
+import { R as ResultClient } from './client-DrsZ1qIm.js';
+import { o as ResultError, a as ResultConfig, G as AuthRefreshResponse } from './types-DSVtGaIA.js';
+import { A as AuthCookieSettings, C as CookieStore, a as CookieWriter } from './middleware-BJl9JRg3.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-BJl9JRg3.js';
 import '@supabase/postgrest-js';
 
 interface CreateAuthActionsOptions extends Omit<ResultConfig, "accessToken" | "edgeFunctionToken" | "isServerMode" | "auth">, AuthCookieSettings {