@ragable/sdk 0.7.10 → 0.8.0

package/dist/index.js

@@ -47,6 +47,7 @@ __export(index_exports, {
   RagableBrowserAiClient: () => RagableBrowserAiClient,
   RagableBrowserAuthClient: () => RagableBrowserAuthClient,
   RagableBrowserDatabaseClient: () => RagableBrowserDatabaseClient,
+  RagableBrowserFunctionsClient: () => RagableBrowserFunctionsClient,
   RagableBrowserMailClient: () => RagableBrowserMailClient,
   RagableBrowserStorageClient: () => RagableBrowserStorageClient,
   RagableError: () => RagableError,
@@ -60,7 +61,6 @@ __export(index_exports, {
   bindFetch: () => bindFetch,
   buildInferenceRequestBody: () => buildInferenceRequestBody,
   buildResponseFormat: () => buildResponseFormat,
-  bytesToBase64: () => bytesToBase64,
   collectAssistantTextFromUiSegments: () => collectAssistantTextFromUiSegments,
   collectionRecordToRowWithMeta: () => collectionRecordToRowWithMeta,
   collectionRecordsToRowWithMeta: () => collectionRecordsToRowWithMeta,
@@ -76,7 +76,6 @@ __export(index_exports, {
   formatPostgrestError: () => formatPostgrestError,
   formatSdkError: () => formatSdkError,
   generateIdempotencyKey: () => generateIdempotencyKey,
-  imagePartToUrl: () => imagePartToUrl,
   isIncompleteAgentStreamError: () => isIncompleteAgentStreamError,
   mapAgentEvent: () => mapAgentEvent,
   mapFireworksChunk: () => mapFireworksChunk,
@@ -91,7 +90,6 @@ __export(index_exports, {
   runAgentChatStreamLenient: () => runAgentChatStreamLenient,
   streamObjectFromContext: () => streamObjectFromContext,
   toRagableResult: () => toRagableResult,
-  toWireUserContent: () => toWireUserContent,
   tryParsePartialJson: () => tryParsePartialJson,
   unwrapPostgrest: () => unwrapPostgrest,
   wrapStreamTextAsObject: () => wrapStreamTextAsObject
@@ -2431,95 +2429,6 @@ function stripTrailingCommas(text) {
   return text.replace(/,(\s*[}\]])/g, "$1").replace(/,\s*$/, "");
 }
 
-// src/content.ts
-var MAX_IMAGE_BYTES = 5 * 1024 * 1024;
-function toWireUserContent(content) {
-  if (typeof content === "string") return content;
-  const out = [];
-  for (const part of content) {
-    if (!part) continue;
-    if (part.type === "text") {
-      out.push(toWireTextPart(part));
-    } else if (part.type === "image") {
-      out.push(toWireImagePart(part));
-    }
-  }
-  return out;
-}
-function toWireTextPart(part) {
-  return { type: "text", text: part.text };
-}
-function toWireImagePart(part) {
-  const url = imagePartToUrl(part);
-  const detail = part.detail;
-  return {
-    type: "image_url",
-    image_url: detail ? { url, detail } : { url }
-  };
-}
-function imagePartToUrl(part) {
-  const img = part.image;
-  if (img instanceof URL) return img.href;
-  if (typeof img === "string") {
-    if (img.startsWith("http://") || img.startsWith("https://")) return img;
-    if (img.startsWith("data:")) return img;
-    const mediaType = requireMediaType(part, "raw base64 string");
-    assertBase64SizeOk(img);
-    return `data:${mediaType};base64,${img}`;
-  }
-  if (img instanceof Uint8Array || img instanceof ArrayBuffer) {
-    const bytes = img instanceof Uint8Array ? img : new Uint8Array(img);
-    assertBinarySizeOk(bytes);
-    const mediaType = requireMediaType(part, "binary image data");
-    const b64 = bytesToBase64(bytes);
-    return `data:${mediaType};base64,${b64}`;
-  }
-  throw new RagableError(
-    "ImagePart.image must be a string, URL, Uint8Array, or ArrayBuffer",
-    400,
-    { code: "SDK_INVALID_IMAGE_PART" }
-  );
-}
-function requireMediaType(part, what) {
-  const m = part.mediaType?.trim();
-  if (!m) {
-    throw new RagableError(
-      `ImagePart.mediaType is required for ${what} (e.g. "image/png")`,
-      400,
-      { code: "SDK_IMAGE_MEDIA_TYPE_REQUIRED" }
-    );
-  }
-  return m;
-}
-function assertBinarySizeOk(bytes) {
-  if (bytes.byteLength > MAX_IMAGE_BYTES) {
-    throw new RagableError(
-      `Image exceeds 5MB limit (${bytes.byteLength} bytes)`,
-      400,
-      { code: "SDK_IMAGE_TOO_LARGE" }
-    );
-  }
-}
-function assertBase64SizeOk(b64) {
-  const approxBytes = Math.floor(b64.length * 3 / 4);
-  if (approxBytes > MAX_IMAGE_BYTES) {
-    throw new RagableError(
-      `Image exceeds 5MB limit (~${approxBytes} bytes decoded)`,
-      400,
-      { code: "SDK_IMAGE_TOO_LARGE" }
-    );
-  }
-}
-function bytesToBase64(bytes) {
-  const CHUNK = 32768;
-  let binary = "";
-  for (let i = 0; i < bytes.length; i += CHUNK) {
-    const slice = bytes.subarray(i, i + CHUNK);
-    binary += String.fromCharCode(...slice);
-  }
-  return btoa(binary);
-}
-
 // src/stream-parts.ts
 function normalizeFinishReason(raw) {
   switch (raw) {
@@ -2732,9 +2641,7 @@ var ZERO_USAGE = {
 function buildInferenceRequestBody(params, responseFormat) {
   const body = {
     model: params.model,
-    messages: params.messages.map(
-      (m) => m.role === "user" ? { role: "user", content: toWireUserContent(m.content) } : m
-    )
+    messages: params.messages
   };
   if (params.system !== void 0) body.system = params.system;
   if (typeof params.temperature === "number")
@@ -4083,6 +3990,99 @@ var RagableBrowserMailClient = class {
     return message;
   }
 };
+var RagableBrowserFunctionsClient = class {
+  constructor(options, auth) {
+    this.options = options;
+    this.auth = auth;
+    __publicField(this, "fetchImpl");
+    this.fetchImpl = bindFetch(options.fetch);
+  }
+  requireWebsiteId() {
+    const websiteId = this.options.websiteId?.trim();
+    if (!websiteId) {
+      throw new RagableError(
+        "websiteId is required for functions. Use createWebsiteRagableClient()/createAppClient() or pass createBrowserClient({ websiteId, ... }).",
+        400,
+        { code: "SDK_MISSING_WEBSITE_ID" }
+      );
+    }
+    return websiteId;
+  }
+  toUrl(name) {
+    const orgId = this.options.organizationId;
+    const websiteId = this.requireWebsiteId();
+    return `${normalizeBrowserApiBase()}/public/organizations/${orgId}/websites/${websiteId}/functions/${encodeURIComponent(
+      name
+    )}/invoke`;
+  }
+  /**
+   * Best-effort end-user bearer, forwarded to the function as `context.auth.token`.
+   * Functions are public, so this never throws — anonymous calls send no token.
+   */
+  async getOptionalToken() {
+    if (this.auth) {
+      const token = await this.auth.getValidAccessToken().catch(() => null);
+      if (token) return token;
+    }
+    const caller = await Promise.resolve(this.options.getAccessToken?.()).catch(
+      () => null
+    );
+    if (typeof caller === "string" && caller.trim()) return caller.trim();
+    const staticKey = this.options.dataStaticKey?.trim();
+    if (staticKey) return staticKey;
+    return null;
+  }
+  /**
+   * Invoke a function by name. Prefer the typed `client.functions.<name>(input)`
+   * accessors; use this when the name is dynamic.
+   */
+  async invoke(name, input, options) {
+    const fnName = String(name ?? "").trim();
+    if (!fnName) {
+      throw new RagableError(
+        "functions.invoke requires a function name",
+        400,
+        { code: "SDK_MISSING_FUNCTION_NAME" }
+      );
+    }
+    const headers = new Headers(options?.headers ?? this.options.headers);
+    headers.set("Content-Type", "application/json");
+    const token = await this.getOptionalToken();
+    if (token) headers.set("Authorization", `Bearer ${token}`);
+    const response = await this.fetchImpl(this.toUrl(fnName), {
+      method: "POST",
+      headers,
+      body: JSON.stringify({ input: input ?? null }),
+      ...options?.signal ? { signal: options.signal } : {}
+    });
+    const payload = await parseMaybeJsonBody(response);
+    if (!response.ok) {
+      const message = extractErrorMessage(payload, response.statusText);
+      throw new RagableError(message, response.status, payload);
+    }
+    if (payload && typeof payload === "object" && !Array.isArray(payload) && "result" in payload) {
+      return payload.result;
+    }
+    return payload;
+  }
+  /** Build the typed Proxy exposed as `client.functions`. */
+  asInvoker() {
+    const invoke = this.invoke.bind(this);
+    return new Proxy(
+      {},
+      {
+        get: (_target, prop) => {
+          if (typeof prop !== "string") return void 0;
+          if (prop === "then") return void 0;
+          if (prop === "invoke") {
+            return (name, input, options) => invoke(name, input, options);
+          }
+          return (input, options) => invoke(prop, input, options);
+        }
+      }
+    );
+  }
+};
 var RagableBrowserAgentsClient = class {
   constructor(options) {
     this.options = options;
@@ -4410,6 +4410,11 @@ var RagableBrowser = class {
     __publicField(this, "db");
     __publicField(this, "storage");
     __publicField(this, "mail");
+    /**
+     * Backend edge functions — call a `/functions/<name>.ts` handler with
+     * `client.functions.<name>(input)`. Runs server-side. See {@link FunctionInvoker}.
+     */
+    __publicField(this, "functions");
     __publicField(this, "transport");
     __publicField(this, "_ragableAuth");
     /** Delegates to `database.from()`. Kept for back-compat — prefer `database.from()`. */
@@ -4456,6 +4461,10 @@ var RagableBrowser = class {
     this.db = this.database;
     this.storage = new RagableBrowserStorageClient(options, bindFetch(options.fetch));
     this.mail = new RagableBrowserMailClient(options, this._ragableAuth);
+    this.functions = new RagableBrowserFunctionsClient(
+      options,
+      this._ragableAuth
+    ).asInvoker();
   }
   destroy() {
     this._ragableAuth?.destroy();
@@ -4497,6 +4506,7 @@ function createClient(options) {
   RagableBrowserAiClient,
   RagableBrowserAuthClient,
   RagableBrowserDatabaseClient,
+  RagableBrowserFunctionsClient,
   RagableBrowserMailClient,
   RagableBrowserStorageClient,
   RagableError,
@@ -4510,7 +4520,6 @@ function createClient(options) {
   bindFetch,
   buildInferenceRequestBody,
   buildResponseFormat,
-  bytesToBase64,
   collectAssistantTextFromUiSegments,
   collectionRecordToRowWithMeta,
   collectionRecordsToRowWithMeta,
@@ -4526,7 +4535,6 @@ function createClient(options) {
   formatPostgrestError,
   formatSdkError,
   generateIdempotencyKey,
-  imagePartToUrl,
   isIncompleteAgentStreamError,
   mapAgentEvent,
   mapFireworksChunk,
@@ -4541,7 +4549,6 @@ function createClient(options) {
   runAgentChatStreamLenient,
   streamObjectFromContext,
   toRagableResult,
-  toWireUserContent,
   tryParsePartialJson,
   unwrapPostgrest,
   wrapStreamTextAsObject