@ragable/sdk 0.7.8 → 0.7.9

package/dist/index.d.mts

@@ -1794,6 +1794,99 @@ declare class RagableBrowserStorageClient {
     constructor(options: RagableBrowserClientOptions, fetchImpl: typeof fetch);
     from(bucketId: string): BrowserStorageBucketClient;
 }
+interface MailSendParams {
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    /** Plain-text body. At least one of `bodyText` / `bodyHtml` is required. */
+    bodyText?: string;
+    /** HTML body. If both are set, sent as multipart/alternative. */
+    bodyHtml?: string;
+    /** RFC 822 Message-ID of the message you're replying to (enables threading). */
+    inReplyToMessageId?: string;
+    /** Existing References header value, chained with In-Reply-To. */
+    referencesHeader?: string;
+}
+interface MailSendResult {
+    sentMailMessageId: string;
+    gmailMessageId: string;
+    gmailThreadId: string;
+    fromAddress: string;
+}
+interface MailSearchParams {
+    /** Gmail search syntax, e.g. `from:alice is:unread newer_than:7d`. */
+    query?: string;
+    /** 1–50; default 20. */
+    maxResults?: number;
+    pageToken?: string;
+    labelIds?: string[];
+}
+interface MailMessagePreview {
+    id: string;
+    threadId: string;
+    snippet: string;
+    labelIds: string[];
+}
+interface MailMessageDetail {
+    id: string;
+    threadId: string;
+    receivedAt: number;
+    fromAddress: string;
+    fromName: string | null;
+    to: string[];
+    cc: string[];
+    subject: string;
+    snippet: string;
+    bodyText: string | null;
+    bodyHtml: string | null;
+    messageIdHeader: string | null;
+    referencesHeader: string | null;
+    labelIds: string[];
+}
+/**
+ * Send and read email through the Gmail account linked to this Ragable
+ * website (via the IDE Infrastructure → Integrations tab).
+ *
+ * All requests require a Bearer token — either an end-user JWT from this
+ * website's auth group (call `client.auth.signIn(...)` first) or the
+ * data-admin key (server-side use).
+ *
+ * The website MUST have:
+ *   1. A Gmail account linked under Integrations
+ *   2. An auth group linked under Auth
+ *
+ * Otherwise calls return a 412 with a clear error message.
+ */
+declare class RagableBrowserMailClient {
+    private readonly options;
+    private readonly auth;
+    private readonly fetchImpl;
+    constructor(options: RagableBrowserClientOptions, auth: RagableAuth | null);
+    private requireWebsiteId;
+    private pathTo;
+    /**
+     * 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`.
+     */
+    private getBearerToken;
+    private request;
+    /** Send an email from this website's linked Gmail account. */
+    send(params: MailSendParams): Promise<MailSendResult>;
+    /** Search messages with Gmail query syntax. */
+    search(params?: MailSearchParams): Promise<{
+        messages: MailMessagePreview[];
+        nextPageToken: string | null;
+    }>;
+    /** Fetch a single message in full (headers + decoded text/html body). */
+    getMessage(messageId: string): Promise<MailMessageDetail>;
+}
 interface AgentConversationMessage {
     role: "user" | "assistant";
     content: string;
@@ -1933,6 +2026,7 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     readonly database: RagableBrowserDatabaseClient<Database>;
     readonly db: RagableBrowserDatabaseClient<Database>;
     readonly storage: RagableBrowserStorageClient;
+    readonly mail: RagableBrowserMailClient;
     readonly transport: Transport;
     private readonly _ragableAuth;
     constructor(options: RagableBrowserClientOptions);
@@ -1973,4 +2067,4 @@ declare function tryParsePartialJson(text: string): unknown | undefined;
 
 declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
 
-export { type AgentChatMessage, type AgentChatParams, type AgentChatStreamDonePayload, type AgentChatStreamHandlers, type AgentChatStreamResult, type AgentChatStreamUiHandlers, type AgentChatUiAssistantMessage, type AgentChatUiSegment, type AgentChatUiStreamResult, type AgentConversation, type AgentConversationMessage, type AgentConversationSubscription, type AgentPublicChatParams, type AgentStreamAgentInfoEvent, type AgentStreamEvent, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type AuthSignUpCredentials, type AuthUpdateUserAttributes, type AuthUserMetadata, type BrowserAuthSession, type BrowserAuthTokens, BrowserCollectionApi, type BrowserCollectionDefinition, type BrowserCollectionFactory, type BrowserCollectionFindParams, type BrowserCollectionRecord, type BrowserCollections, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, BrowserStorageBucketClient, type BrowserStorageBulkDeleteResult, type BrowserStorageDownloadResult, type BrowserStorageItem, type BrowserStorageListResult, type BrowserStorageSignedUrlResult, type BrowserStorageUploadResult, type CollectionReturnMode, type CollectionRowData, type CollectionRowWithMeta, type CollectionWhere, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FinishReason, type GenerateObjectResult, type GenerateTextResult, type HttpMethod, type Json, type JsonSchema, LocalStorageAdapter, MemoryStorageAdapter, type Message, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAiClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, RagableBrowserStorageClient, type RagableDatabase, RagableError, RagableNetworkError, type RagableResult, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetryOptions, type RunAgentChatStreamOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type SseJsonEvent, type StreamObjectParams, type StreamObjectResult, type StreamPart, type StreamTextParams, type StreamTextResult, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, type TokenUsage, type ToolCallRecord, Transport, type TransportOptions, type TransportRequest, type WhereInput, type WhereOperatorObject, asPostgrestResponse, assertPostgrestSuccess, bindFetch, buildInferenceRequestBody, buildResponseFormat, collectAssistantTextFromUiSegments, collectionRecordToRowWithMeta, collectionRecordsToRowWithMeta, createBrowserClient, createClient, createRagableBrowserClient, createStreamResultFromParts, detectStorage, effectiveDataAuth, extractErrorMessage, finalizeAgentChatUiTurn, foldAgentStreamIntoUiSegments, formatPostgrestError, formatSdkError, generateIdempotencyKey, isIncompleteAgentStreamError, mapAgentEvent, mapFireworksChunk, normalizeBrowserApiBase, parseAgentStreamAgentInfo, parseAgentStreamDone, parseSseDataLine, parseTransportResponse, readSseStream, runAgentChatStream, runAgentChatStreamForUi, runAgentChatStreamLenient, streamObjectFromContext, toRagableResult, tryParsePartialJson, unwrapPostgrest, wrapStreamTextAsObject };
+export { type AgentChatMessage, type AgentChatParams, type AgentChatStreamDonePayload, type AgentChatStreamHandlers, type AgentChatStreamResult, type AgentChatStreamUiHandlers, type AgentChatUiAssistantMessage, type AgentChatUiSegment, type AgentChatUiStreamResult, type AgentConversation, type AgentConversationMessage, type AgentConversationSubscription, type AgentPublicChatParams, type AgentStreamAgentInfoEvent, type AgentStreamEvent, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type AuthSignUpCredentials, type AuthUpdateUserAttributes, type AuthUserMetadata, type BrowserAuthSession, type BrowserAuthTokens, BrowserCollectionApi, type BrowserCollectionDefinition, type BrowserCollectionFactory, type BrowserCollectionFindParams, type BrowserCollectionRecord, type BrowserCollections, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, BrowserStorageBucketClient, type BrowserStorageBulkDeleteResult, type BrowserStorageDownloadResult, type BrowserStorageItem, type BrowserStorageListResult, type BrowserStorageSignedUrlResult, type BrowserStorageUploadResult, type CollectionReturnMode, type CollectionRowData, type CollectionRowWithMeta, type CollectionWhere, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FinishReason, type GenerateObjectResult, type GenerateTextResult, type HttpMethod, type Json, type JsonSchema, LocalStorageAdapter, type MailMessageDetail, type MailMessagePreview, type MailSearchParams, type MailSendParams, type MailSendResult, MemoryStorageAdapter, type Message, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAiClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, RagableBrowserMailClient, RagableBrowserStorageClient, type RagableDatabase, RagableError, RagableNetworkError, type RagableResult, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetryOptions, type RunAgentChatStreamOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type SseJsonEvent, type StreamObjectParams, type StreamObjectResult, type StreamPart, type StreamTextParams, type StreamTextResult, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, type TokenUsage, type ToolCallRecord, Transport, type TransportOptions, type TransportRequest, type WhereInput, type WhereOperatorObject, asPostgrestResponse, assertPostgrestSuccess, bindFetch, buildInferenceRequestBody, buildResponseFormat, collectAssistantTextFromUiSegments, collectionRecordToRowWithMeta, collectionRecordsToRowWithMeta, createBrowserClient, createClient, createRagableBrowserClient, createStreamResultFromParts, detectStorage, effectiveDataAuth, extractErrorMessage, finalizeAgentChatUiTurn, foldAgentStreamIntoUiSegments, formatPostgrestError, formatSdkError, generateIdempotencyKey, isIncompleteAgentStreamError, mapAgentEvent, mapFireworksChunk, normalizeBrowserApiBase, parseAgentStreamAgentInfo, parseAgentStreamDone, parseSseDataLine, parseTransportResponse, readSseStream, runAgentChatStream, runAgentChatStreamForUi, runAgentChatStreamLenient, streamObjectFromContext, toRagableResult, tryParsePartialJson, unwrapPostgrest, wrapStreamTextAsObject };

package/dist/index.d.ts

@@ -1794,6 +1794,99 @@ declare class RagableBrowserStorageClient {
     constructor(options: RagableBrowserClientOptions, fetchImpl: typeof fetch);
     from(bucketId: string): BrowserStorageBucketClient;
 }
+interface MailSendParams {
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    /** Plain-text body. At least one of `bodyText` / `bodyHtml` is required. */
+    bodyText?: string;
+    /** HTML body. If both are set, sent as multipart/alternative. */
+    bodyHtml?: string;
+    /** RFC 822 Message-ID of the message you're replying to (enables threading). */
+    inReplyToMessageId?: string;
+    /** Existing References header value, chained with In-Reply-To. */
+    referencesHeader?: string;
+}
+interface MailSendResult {
+    sentMailMessageId: string;
+    gmailMessageId: string;
+    gmailThreadId: string;
+    fromAddress: string;
+}
+interface MailSearchParams {
+    /** Gmail search syntax, e.g. `from:alice is:unread newer_than:7d`. */
+    query?: string;
+    /** 1–50; default 20. */
+    maxResults?: number;
+    pageToken?: string;
+    labelIds?: string[];
+}
+interface MailMessagePreview {
+    id: string;
+    threadId: string;
+    snippet: string;
+    labelIds: string[];
+}
+interface MailMessageDetail {
+    id: string;
+    threadId: string;
+    receivedAt: number;
+    fromAddress: string;
+    fromName: string | null;
+    to: string[];
+    cc: string[];
+    subject: string;
+    snippet: string;
+    bodyText: string | null;
+    bodyHtml: string | null;
+    messageIdHeader: string | null;
+    referencesHeader: string | null;
+    labelIds: string[];
+}
+/**
+ * Send and read email through the Gmail account linked to this Ragable
+ * website (via the IDE Infrastructure → Integrations tab).
+ *
+ * All requests require a Bearer token — either an end-user JWT from this
+ * website's auth group (call `client.auth.signIn(...)` first) or the
+ * data-admin key (server-side use).
+ *
+ * The website MUST have:
+ *   1. A Gmail account linked under Integrations
+ *   2. An auth group linked under Auth
+ *
+ * Otherwise calls return a 412 with a clear error message.
+ */
+declare class RagableBrowserMailClient {
+    private readonly options;
+    private readonly auth;
+    private readonly fetchImpl;
+    constructor(options: RagableBrowserClientOptions, auth: RagableAuth | null);
+    private requireWebsiteId;
+    private pathTo;
+    /**
+     * 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`.
+     */
+    private getBearerToken;
+    private request;
+    /** Send an email from this website's linked Gmail account. */
+    send(params: MailSendParams): Promise<MailSendResult>;
+    /** Search messages with Gmail query syntax. */
+    search(params?: MailSearchParams): Promise<{
+        messages: MailMessagePreview[];
+        nextPageToken: string | null;
+    }>;
+    /** Fetch a single message in full (headers + decoded text/html body). */
+    getMessage(messageId: string): Promise<MailMessageDetail>;
+}
 interface AgentConversationMessage {
     role: "user" | "assistant";
     content: string;
@@ -1933,6 +2026,7 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     readonly database: RagableBrowserDatabaseClient<Database>;
     readonly db: RagableBrowserDatabaseClient<Database>;
     readonly storage: RagableBrowserStorageClient;
+    readonly mail: RagableBrowserMailClient;
     readonly transport: Transport;
     private readonly _ragableAuth;
     constructor(options: RagableBrowserClientOptions);
@@ -1973,4 +2067,4 @@ declare function tryParsePartialJson(text: string): unknown | undefined;
 
 declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
 
-export { type AgentChatMessage, type AgentChatParams, type AgentChatStreamDonePayload, type AgentChatStreamHandlers, type AgentChatStreamResult, type AgentChatStreamUiHandlers, type AgentChatUiAssistantMessage, type AgentChatUiSegment, type AgentChatUiStreamResult, type AgentConversation, type AgentConversationMessage, type AgentConversationSubscription, type AgentPublicChatParams, type AgentStreamAgentInfoEvent, type AgentStreamEvent, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type AuthSignUpCredentials, type AuthUpdateUserAttributes, type AuthUserMetadata, type BrowserAuthSession, type BrowserAuthTokens, BrowserCollectionApi, type BrowserCollectionDefinition, type BrowserCollectionFactory, type BrowserCollectionFindParams, type BrowserCollectionRecord, type BrowserCollections, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, BrowserStorageBucketClient, type BrowserStorageBulkDeleteResult, type BrowserStorageDownloadResult, type BrowserStorageItem, type BrowserStorageListResult, type BrowserStorageSignedUrlResult, type BrowserStorageUploadResult, type CollectionReturnMode, type CollectionRowData, type CollectionRowWithMeta, type CollectionWhere, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FinishReason, type GenerateObjectResult, type GenerateTextResult, type HttpMethod, type Json, type JsonSchema, LocalStorageAdapter, MemoryStorageAdapter, type Message, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAiClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, RagableBrowserStorageClient, type RagableDatabase, RagableError, RagableNetworkError, type RagableResult, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetryOptions, type RunAgentChatStreamOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type SseJsonEvent, type StreamObjectParams, type StreamObjectResult, type StreamPart, type StreamTextParams, type StreamTextResult, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, type TokenUsage, type ToolCallRecord, Transport, type TransportOptions, type TransportRequest, type WhereInput, type WhereOperatorObject, asPostgrestResponse, assertPostgrestSuccess, bindFetch, buildInferenceRequestBody, buildResponseFormat, collectAssistantTextFromUiSegments, collectionRecordToRowWithMeta, collectionRecordsToRowWithMeta, createBrowserClient, createClient, createRagableBrowserClient, createStreamResultFromParts, detectStorage, effectiveDataAuth, extractErrorMessage, finalizeAgentChatUiTurn, foldAgentStreamIntoUiSegments, formatPostgrestError, formatSdkError, generateIdempotencyKey, isIncompleteAgentStreamError, mapAgentEvent, mapFireworksChunk, normalizeBrowserApiBase, parseAgentStreamAgentInfo, parseAgentStreamDone, parseSseDataLine, parseTransportResponse, readSseStream, runAgentChatStream, runAgentChatStreamForUi, runAgentChatStreamLenient, streamObjectFromContext, toRagableResult, tryParsePartialJson, unwrapPostgrest, wrapStreamTextAsObject };
+export { type AgentChatMessage, type AgentChatParams, type AgentChatStreamDonePayload, type AgentChatStreamHandlers, type AgentChatStreamResult, type AgentChatStreamUiHandlers, type AgentChatUiAssistantMessage, type AgentChatUiSegment, type AgentChatUiStreamResult, type AgentConversation, type AgentConversationMessage, type AgentConversationSubscription, type AgentPublicChatParams, type AgentStreamAgentInfoEvent, type AgentStreamEvent, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type AuthSignUpCredentials, type AuthUpdateUserAttributes, type AuthUserMetadata, type BrowserAuthSession, type BrowserAuthTokens, BrowserCollectionApi, type BrowserCollectionDefinition, type BrowserCollectionFactory, type BrowserCollectionFindParams, type BrowserCollectionRecord, type BrowserCollections, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, BrowserStorageBucketClient, type BrowserStorageBulkDeleteResult, type BrowserStorageDownloadResult, type BrowserStorageItem, type BrowserStorageListResult, type BrowserStorageSignedUrlResult, type BrowserStorageUploadResult, type CollectionReturnMode, type CollectionRowData, type CollectionRowWithMeta, type CollectionWhere, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FinishReason, type GenerateObjectResult, type GenerateTextResult, type HttpMethod, type Json, type JsonSchema, LocalStorageAdapter, type MailMessageDetail, type MailMessagePreview, type MailSearchParams, type MailSendParams, type MailSendResult, MemoryStorageAdapter, type Message, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAiClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, RagableBrowserMailClient, RagableBrowserStorageClient, type RagableDatabase, RagableError, RagableNetworkError, type RagableResult, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetryOptions, type RunAgentChatStreamOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type SseJsonEvent, type StreamObjectParams, type StreamObjectResult, type StreamPart, type StreamTextParams, type StreamTextResult, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, type TokenUsage, type ToolCallRecord, Transport, type TransportOptions, type TransportRequest, type WhereInput, type WhereOperatorObject, asPostgrestResponse, assertPostgrestSuccess, bindFetch, buildInferenceRequestBody, buildResponseFormat, collectAssistantTextFromUiSegments, collectionRecordToRowWithMeta, collectionRecordsToRowWithMeta, createBrowserClient, createClient, createRagableBrowserClient, createStreamResultFromParts, detectStorage, effectiveDataAuth, extractErrorMessage, finalizeAgentChatUiTurn, foldAgentStreamIntoUiSegments, formatPostgrestError, formatSdkError, generateIdempotencyKey, isIncompleteAgentStreamError, mapAgentEvent, mapFireworksChunk, normalizeBrowserApiBase, parseAgentStreamAgentInfo, parseAgentStreamDone, parseSseDataLine, parseTransportResponse, readSseStream, runAgentChatStream, runAgentChatStreamForUi, runAgentChatStreamLenient, streamObjectFromContext, toRagableResult, tryParsePartialJson, unwrapPostgrest, wrapStreamTextAsObject };

package/dist/index.js

@@ -47,6 +47,7 @@ __export(index_exports, {
   RagableBrowserAiClient: () => RagableBrowserAiClient,
   RagableBrowserAuthClient: () => RagableBrowserAuthClient,
   RagableBrowserDatabaseClient: () => RagableBrowserDatabaseClient,
+  RagableBrowserMailClient: () => RagableBrowserMailClient,
   RagableBrowserStorageClient: () => RagableBrowserStorageClient,
   RagableError: () => RagableError,
   RagableNetworkError: () => RagableNetworkError,
@@ -3874,6 +3875,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;
@@ -4200,6 +4315,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()`. */
@@ -4245,6 +4361,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();
@@ -4286,6 +4403,7 @@ function createClient(options) {
   RagableBrowserAiClient,
   RagableBrowserAuthClient,
   RagableBrowserDatabaseClient,
+  RagableBrowserMailClient,
   RagableBrowserStorageClient,
   RagableError,
   RagableNetworkError,