@ragable/sdk 0.7.8 → 0.7.9

package/dist/index.mjs

@@ -3782,6 +3782,120 @@ var RagableBrowserStorageClient = class {
     return new BrowserStorageBucketClient(this.options, this.fetchImpl, bucketId);
   }
 };
+var RagableBrowserMailClient = 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 mail operations. Use createWebsiteRagableClient() or pass createBrowserClient({ websiteId, ... }).",
+        400,
+        { code: "SDK_MISSING_WEBSITE_ID" }
+      );
+    }
+    return websiteId;
+  }
+  pathTo(p) {
+    const websiteId = this.requireWebsiteId();
+    const orgId = this.options.organizationId;
+    return `${normalizeBrowserApiBase()}/public/organizations/${orgId}/websites/${websiteId}/mail${p.startsWith("/") ? p : `/${p}`}`;
+  }
+  /**
+   * Get the Bearer token used to authenticate the call:
+   *  1. End-user access token (preferred when an auth group is configured
+   *     and the user has signed in)
+   *  2. `dataStaticKey` from createBrowserClient options
+   *  3. Caller-supplied `getAccessToken()`
+   *
+   * If none is available, throws — server-side use should pass the
+   * data-admin key as `dataStaticKey`.
+   */
+  async getBearerToken() {
+    if (this.auth) {
+      const token = await this.auth.getValidAccessToken().catch(() => null);
+      if (token) return token;
+    }
+    const callerProvided = await this.options.getAccessToken?.();
+    if (typeof callerProvided === "string" && callerProvided.length > 0) {
+      return callerProvided;
+    }
+    if (this.options.dataStaticKey?.trim()) {
+      return this.options.dataStaticKey.trim();
+    }
+    throw new RagableError(
+      "Mail requests need authentication: either sign in via client.auth.signIn(...) or pass dataStaticKey (the auth group data-admin key) when creating the client.",
+      401,
+      { code: "SDK_MAIL_NOT_AUTHENTICATED" }
+    );
+  }
+  async request(path, init = {}) {
+    const token = await this.getBearerToken();
+    const headers = new Headers(init.headers ?? this.options.headers);
+    headers.set("Authorization", `Bearer ${token}`);
+    if (init.body && !headers.has("Content-Type")) {
+      headers.set("Content-Type", "application/json");
+    }
+    const response = await this.fetchImpl(this.pathTo(path), {
+      ...init,
+      headers
+    });
+    const payload = await parseMaybeJsonBody(response);
+    if (!response.ok) {
+      const message = extractErrorMessage(payload, response.statusText);
+      throw new RagableError(message, response.status, payload);
+    }
+    return payload;
+  }
+  /** Send an email from this website's linked Gmail account. */
+  async send(params) {
+    if (!params.to?.length) {
+      throw new RagableError(
+        "`to` must contain at least one recipient.",
+        400,
+        { code: "SDK_MAIL_NO_RECIPIENTS" }
+      );
+    }
+    if (!params.bodyText && !params.bodyHtml) {
+      throw new RagableError(
+        "Provide at least one of `bodyText` or `bodyHtml`.",
+        400,
+        { code: "SDK_MAIL_NO_BODY" }
+      );
+    }
+    return this.request("/send", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /** Search messages with Gmail query syntax. */
+  async search(params = {}) {
+    const qs = new URLSearchParams();
+    if (params.query) qs.set("q", params.query);
+    if (params.maxResults) qs.set("maxResults", String(params.maxResults));
+    if (params.pageToken) qs.set("pageToken", params.pageToken);
+    if (params.labelIds?.length) qs.set("labelIds", params.labelIds.join(","));
+    const suffix = qs.toString() ? `?${qs.toString()}` : "";
+    return this.request(`/search${suffix}`, { method: "GET" });
+  }
+  /** Fetch a single message in full (headers + decoded text/html body). */
+  async getMessage(messageId) {
+    if (!messageId) {
+      throw new RagableError("`messageId` is required.", 400, {
+        code: "SDK_MAIL_NO_MESSAGE_ID"
+      });
+    }
+    const { message } = await this.request(
+      `/messages/${encodeURIComponent(messageId)}`,
+      { method: "GET" }
+    );
+    return message;
+  }
+};
 var RagableBrowserAgentsClient = class {
   constructor(options) {
     this.options = options;
@@ -4108,6 +4222,7 @@ var RagableBrowser = class {
     __publicField(this, "database");
     __publicField(this, "db");
     __publicField(this, "storage");
+    __publicField(this, "mail");
     __publicField(this, "transport");
     __publicField(this, "_ragableAuth");
     /** Delegates to `database.from()`. Kept for back-compat — prefer `database.from()`. */
@@ -4153,6 +4268,7 @@ var RagableBrowser = class {
     this.database._setTransport(this.transport);
     this.db = this.database;
     this.storage = new RagableBrowserStorageClient(options, bindFetch(options.fetch));
+    this.mail = new RagableBrowserMailClient(options, this._ragableAuth);
   }
   destroy() {
     this._ragableAuth?.destroy();
@@ -4193,6 +4309,7 @@ export {
   RagableBrowserAiClient,
   RagableBrowserAuthClient,
   RagableBrowserDatabaseClient,
+  RagableBrowserMailClient,
   RagableBrowserStorageClient,
   RagableError,
   RagableNetworkError,