@ragable/sdk 0.7.9 → 0.8.0

package/dist/index.mjs

@@ -3896,6 +3896,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;
@@ -4223,6 +4316,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()`. */
@@ -4269,6 +4367,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();
@@ -4309,6 +4411,7 @@ export {
   RagableBrowserAiClient,
   RagableBrowserAuthClient,
   RagableBrowserDatabaseClient,
+  RagableBrowserFunctionsClient,
   RagableBrowserMailClient,
   RagableBrowserStorageClient,
   RagableError,