@ragable/sdk 0.7.9 → 0.8.0

package/dist/index.d.mts

@@ -1246,6 +1246,98 @@ declare function streamObjectFromContext<T = unknown>(ctx: InferenceRequestConte
  */
 declare function wrapStreamTextAsObject<T = unknown>(inner: StreamTextResult): StreamObjectResult<T>;
 
+/**
+ * Backend "edge functions".
+ *
+ * A function is a single file in the project's `/functions` folder whose name is
+ * the function name and whose **default export is the handler**:
+ *
+ * ```ts
+ * // /functions/getUsers.ts
+ * import type { RagableFunctionContext } from "@ragable/sdk";
+ *
+ * export default async function getUsers(
+ *   input: { limit?: number },
+ *   context: RagableFunctionContext,
+ * ) {
+ *   const res = await fetch("https://api.example.com/users", {
+ *     headers: { Authorization: `Bearer ${context.env.API_KEY}` },
+ *   });
+ *   return (await res.json()).slice(0, input.limit ?? 20);
+ * }
+ * ```
+ *
+ * Saving the file deploys it (near-instant). It runs **server-side** — so secrets
+ * stay off the client and there are no browser CORS limits — and is invoked from
+ * the browser with `client.functions.getUsers({ limit: 5 })`.
+ *
+ * The handler's second argument (`context`) is injected by the server; callers
+ * pass only `input`.
+ */
+/**
+ * Server-injected second argument to every function handler. Never constructed
+ * on the client — the values come from the backend at invocation time.
+ */
+interface RagableFunctionContext {
+    /**
+     * Secrets for this function, parsed from the project's `/functions/.env`.
+     * Server-only: this file is read at invoke time and never bundled into the
+     * browser app. Empty when no `/functions/.env` exists.
+     */
+    env: Record<string, string>;
+    /** Metadata about the invoking HTTP request. */
+    request: {
+        method: string;
+        headers: Record<string, string>;
+    };
+    /**
+     * End-user auth forwarded from the caller. `token` is the bearer the browser
+     * client was holding (an end-user access token or the data static key), or
+     * `null` for anonymous calls.
+     */
+    auth: {
+        token: string | null;
+    };
+}
+/**
+ * The shape a `/functions/<name>.ts` default export must satisfy. Type the
+ * `input` parameter as optional (`input?: Foo`) when callers may omit it.
+ */
+type RagableFunctionHandler<Input = any, Output = any> = (input: Input, context: RagableFunctionContext) => Output | Promise<Output>;
+/**
+ * A project's function map: function name → handler. Generated as `AppFunctions`.
+ * The constraint is intentionally loose (any function shape) so a handler that
+ * deviates from `(input, context)` never breaks the generated client as a whole;
+ * the per-call typing in {@link RagableFunctionCall} adapts to each signature.
+ */
+type RagableFunctions = Record<string, (...args: any[]) => any>;
+/** Permissive default used when no generated `AppFunctions` is supplied. */
+interface DefaultRagableFunctions {
+    [name: string]: (...args: any[]) => any;
+}
+/** Per-call options for an invocation. */
+interface RagableFunctionInvokeOptions {
+    signal?: AbortSignal;
+    headers?: HeadersInit;
+}
+/**
+ * The browser-side call signature derived from a server handler `H`: the server
+ * injects `context`, so the caller passes only `input`. `input` is optional when
+ * the handler's input type permits `undefined`.
+ */
+type RagableFunctionCall<H> = H extends (input: infer I, ...rest: any[]) => infer R ? undefined extends I ? (input?: I, options?: RagableFunctionInvokeOptions) => Promise<Awaited<R>> : (input: I, options?: RagableFunctionInvokeOptions) => Promise<Awaited<R>> : (input?: unknown, options?: RagableFunctionInvokeOptions) => Promise<unknown>;
+/**
+ * The type of `client.functions`: a typed callable per function in `F`, plus an
+ * `invoke(name, input?)` escape hatch for dynamic dispatch. (A function literally
+ * named `invoke` is therefore reserved.)
+ */
+type FunctionInvoker<F extends RagableFunctions = DefaultRagableFunctions> = {
+    [K in keyof F]: RagableFunctionCall<F[K]>;
+} & {
+    /** Invoke a function by name. Useful when the name is dynamic. */
+    invoke<Result = unknown>(name: string, input?: unknown, options?: RagableFunctionInvokeOptions): Promise<Result>;
+};
+
 /** Canonical browser/server API base (`…/api`, no trailing slash). */
 declare function normalizeBrowserApiBase(): string;
 type BrowserDataAuthMode = "user" | "publicAnon" | "admin";
@@ -1887,6 +1979,33 @@ declare class RagableBrowserMailClient {
     /** Fetch a single message in full (headers + decoded text/html body). */
     getMessage(messageId: string): Promise<MailMessageDetail>;
 }
+/**
+ * Invokes the project's backend edge functions (handlers in `/functions/<name>.ts`).
+ *
+ * Exposed on the client as a typed Proxy — `client.functions.<name>(input)` — so
+ * each generated function name is a direct callable. Functions run server-side,
+ * so calls can use secrets and reach any external API without browser CORS limits.
+ */
+declare class RagableBrowserFunctionsClient {
+    private readonly options;
+    private readonly auth;
+    private readonly fetchImpl;
+    constructor(options: RagableBrowserClientOptions, auth: RagableAuth | null);
+    private requireWebsiteId;
+    private toUrl;
+    /**
+     * 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.
+     */
+    private getOptionalToken;
+    /**
+     * Invoke a function by name. Prefer the typed `client.functions.<name>(input)`
+     * accessors; use this when the name is dynamic.
+     */
+    invoke<Result = unknown>(name: string, input?: unknown, options?: RagableFunctionInvokeOptions): Promise<Result>;
+    /** Build the typed Proxy exposed as `client.functions`. */
+    asInvoker<F extends RagableFunctions = DefaultRagableFunctions>(): FunctionInvoker<F>;
+}
 interface AgentConversationMessage {
     role: "user" | "assistant";
     content: string;
@@ -2019,7 +2138,7 @@ interface AgentPublicChatParams extends AgentChatParams {
     triggerSubtype?: string;
     triggerNodeId?: string;
 }
-declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser> {
+declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser, Functions extends RagableFunctions = DefaultRagableFunctions> {
     readonly agents: RagableBrowserAgentsClient;
     readonly ai: RagableBrowserAiClient;
     readonly auth: RagableBrowserAuthClient<AuthUser>;
@@ -2027,6 +2146,11 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     readonly db: RagableBrowserDatabaseClient<Database>;
     readonly storage: RagableBrowserStorageClient;
     readonly mail: RagableBrowserMailClient;
+    /**
+     * Backend edge functions — call a `/functions/<name>.ts` handler with
+     * `client.functions.<name>(input)`. Runs server-side. See {@link FunctionInvoker}.
+     */
+    readonly functions: FunctionInvoker<Functions>;
     readonly transport: Transport;
     private readonly _ragableAuth;
     constructor(options: RagableBrowserClientOptions);
@@ -2034,7 +2158,7 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     from: <TableName extends RagableTableNames<Database>>(table: TableName, databaseInstanceId?: string) => PostgrestTableApi<Database, TableName>;
     destroy(): void;
 }
-declare function createBrowserClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
+declare function createBrowserClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser, Functions extends RagableFunctions = DefaultRagableFunctions>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser, Functions>;
 declare const createRagableBrowserClient: typeof createBrowserClient;
 
 /**
@@ -2065,6 +2189,6 @@ declare function readSseStream(body: ReadableStream<Uint8Array>): AsyncGenerator
  */
 declare function tryParsePartialJson(text: string): unknown | undefined;
 
-declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
+declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser, Functions extends RagableFunctions = DefaultRagableFunctions>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser, Functions>;
 
-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 };
+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 DefaultRagableFunctions, type FinishReason, type FunctionInvoker, 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, RagableBrowserFunctionsClient, RagableBrowserMailClient, RagableBrowserStorageClient, type RagableDatabase, RagableError, type RagableFunctionCall, type RagableFunctionContext, type RagableFunctionHandler, type RagableFunctionInvokeOptions, type RagableFunctions, 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

@@ -1246,6 +1246,98 @@ declare function streamObjectFromContext<T = unknown>(ctx: InferenceRequestConte
  */
 declare function wrapStreamTextAsObject<T = unknown>(inner: StreamTextResult): StreamObjectResult<T>;
 
+/**
+ * Backend "edge functions".
+ *
+ * A function is a single file in the project's `/functions` folder whose name is
+ * the function name and whose **default export is the handler**:
+ *
+ * ```ts
+ * // /functions/getUsers.ts
+ * import type { RagableFunctionContext } from "@ragable/sdk";
+ *
+ * export default async function getUsers(
+ *   input: { limit?: number },
+ *   context: RagableFunctionContext,
+ * ) {
+ *   const res = await fetch("https://api.example.com/users", {
+ *     headers: { Authorization: `Bearer ${context.env.API_KEY}` },
+ *   });
+ *   return (await res.json()).slice(0, input.limit ?? 20);
+ * }
+ * ```
+ *
+ * Saving the file deploys it (near-instant). It runs **server-side** — so secrets
+ * stay off the client and there are no browser CORS limits — and is invoked from
+ * the browser with `client.functions.getUsers({ limit: 5 })`.
+ *
+ * The handler's second argument (`context`) is injected by the server; callers
+ * pass only `input`.
+ */
+/**
+ * Server-injected second argument to every function handler. Never constructed
+ * on the client — the values come from the backend at invocation time.
+ */
+interface RagableFunctionContext {
+    /**
+     * Secrets for this function, parsed from the project's `/functions/.env`.
+     * Server-only: this file is read at invoke time and never bundled into the
+     * browser app. Empty when no `/functions/.env` exists.
+     */
+    env: Record<string, string>;
+    /** Metadata about the invoking HTTP request. */
+    request: {
+        method: string;
+        headers: Record<string, string>;
+    };
+    /**
+     * End-user auth forwarded from the caller. `token` is the bearer the browser
+     * client was holding (an end-user access token or the data static key), or
+     * `null` for anonymous calls.
+     */
+    auth: {
+        token: string | null;
+    };
+}
+/**
+ * The shape a `/functions/<name>.ts` default export must satisfy. Type the
+ * `input` parameter as optional (`input?: Foo`) when callers may omit it.
+ */
+type RagableFunctionHandler<Input = any, Output = any> = (input: Input, context: RagableFunctionContext) => Output | Promise<Output>;
+/**
+ * A project's function map: function name → handler. Generated as `AppFunctions`.
+ * The constraint is intentionally loose (any function shape) so a handler that
+ * deviates from `(input, context)` never breaks the generated client as a whole;
+ * the per-call typing in {@link RagableFunctionCall} adapts to each signature.
+ */
+type RagableFunctions = Record<string, (...args: any[]) => any>;
+/** Permissive default used when no generated `AppFunctions` is supplied. */
+interface DefaultRagableFunctions {
+    [name: string]: (...args: any[]) => any;
+}
+/** Per-call options for an invocation. */
+interface RagableFunctionInvokeOptions {
+    signal?: AbortSignal;
+    headers?: HeadersInit;
+}
+/**
+ * The browser-side call signature derived from a server handler `H`: the server
+ * injects `context`, so the caller passes only `input`. `input` is optional when
+ * the handler's input type permits `undefined`.
+ */
+type RagableFunctionCall<H> = H extends (input: infer I, ...rest: any[]) => infer R ? undefined extends I ? (input?: I, options?: RagableFunctionInvokeOptions) => Promise<Awaited<R>> : (input: I, options?: RagableFunctionInvokeOptions) => Promise<Awaited<R>> : (input?: unknown, options?: RagableFunctionInvokeOptions) => Promise<unknown>;
+/**
+ * The type of `client.functions`: a typed callable per function in `F`, plus an
+ * `invoke(name, input?)` escape hatch for dynamic dispatch. (A function literally
+ * named `invoke` is therefore reserved.)
+ */
+type FunctionInvoker<F extends RagableFunctions = DefaultRagableFunctions> = {
+    [K in keyof F]: RagableFunctionCall<F[K]>;
+} & {
+    /** Invoke a function by name. Useful when the name is dynamic. */
+    invoke<Result = unknown>(name: string, input?: unknown, options?: RagableFunctionInvokeOptions): Promise<Result>;
+};
+
 /** Canonical browser/server API base (`…/api`, no trailing slash). */
 declare function normalizeBrowserApiBase(): string;
 type BrowserDataAuthMode = "user" | "publicAnon" | "admin";
@@ -1887,6 +1979,33 @@ declare class RagableBrowserMailClient {
     /** Fetch a single message in full (headers + decoded text/html body). */
     getMessage(messageId: string): Promise<MailMessageDetail>;
 }
+/**
+ * Invokes the project's backend edge functions (handlers in `/functions/<name>.ts`).
+ *
+ * Exposed on the client as a typed Proxy — `client.functions.<name>(input)` — so
+ * each generated function name is a direct callable. Functions run server-side,
+ * so calls can use secrets and reach any external API without browser CORS limits.
+ */
+declare class RagableBrowserFunctionsClient {
+    private readonly options;
+    private readonly auth;
+    private readonly fetchImpl;
+    constructor(options: RagableBrowserClientOptions, auth: RagableAuth | null);
+    private requireWebsiteId;
+    private toUrl;
+    /**
+     * 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.
+     */
+    private getOptionalToken;
+    /**
+     * Invoke a function by name. Prefer the typed `client.functions.<name>(input)`
+     * accessors; use this when the name is dynamic.
+     */
+    invoke<Result = unknown>(name: string, input?: unknown, options?: RagableFunctionInvokeOptions): Promise<Result>;
+    /** Build the typed Proxy exposed as `client.functions`. */
+    asInvoker<F extends RagableFunctions = DefaultRagableFunctions>(): FunctionInvoker<F>;
+}
 interface AgentConversationMessage {
     role: "user" | "assistant";
     content: string;
@@ -2019,7 +2138,7 @@ interface AgentPublicChatParams extends AgentChatParams {
     triggerSubtype?: string;
     triggerNodeId?: string;
 }
-declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser> {
+declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser, Functions extends RagableFunctions = DefaultRagableFunctions> {
     readonly agents: RagableBrowserAgentsClient;
     readonly ai: RagableBrowserAiClient;
     readonly auth: RagableBrowserAuthClient<AuthUser>;
@@ -2027,6 +2146,11 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     readonly db: RagableBrowserDatabaseClient<Database>;
     readonly storage: RagableBrowserStorageClient;
     readonly mail: RagableBrowserMailClient;
+    /**
+     * Backend edge functions — call a `/functions/<name>.ts` handler with
+     * `client.functions.<name>(input)`. Runs server-side. See {@link FunctionInvoker}.
+     */
+    readonly functions: FunctionInvoker<Functions>;
     readonly transport: Transport;
     private readonly _ragableAuth;
     constructor(options: RagableBrowserClientOptions);
@@ -2034,7 +2158,7 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     from: <TableName extends RagableTableNames<Database>>(table: TableName, databaseInstanceId?: string) => PostgrestTableApi<Database, TableName>;
     destroy(): void;
 }
-declare function createBrowserClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
+declare function createBrowserClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser, Functions extends RagableFunctions = DefaultRagableFunctions>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser, Functions>;
 declare const createRagableBrowserClient: typeof createBrowserClient;
 
 /**
@@ -2065,6 +2189,6 @@ declare function readSseStream(body: ReadableStream<Uint8Array>): AsyncGenerator
  */
 declare function tryParsePartialJson(text: string): unknown | undefined;
 
-declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
+declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser, Functions extends RagableFunctions = DefaultRagableFunctions>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser, Functions>;
 
-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 };
+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 DefaultRagableFunctions, type FinishReason, type FunctionInvoker, 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, RagableBrowserFunctionsClient, RagableBrowserMailClient, RagableBrowserStorageClient, type RagableDatabase, RagableError, type RagableFunctionCall, type RagableFunctionContext, type RagableFunctionHandler, type RagableFunctionInvokeOptions, type RagableFunctions, 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,
+  RagableBrowserFunctionsClient: () => RagableBrowserFunctionsClient,
   RagableBrowserMailClient: () => RagableBrowserMailClient,
   RagableBrowserStorageClient: () => RagableBrowserStorageClient,
   RagableError: () => RagableError,
@@ -3989,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;
@@ -4316,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()`. */
@@ -4362,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();
@@ -4403,6 +4506,7 @@ function createClient(options) {
   RagableBrowserAiClient,
   RagableBrowserAuthClient,
   RagableBrowserDatabaseClient,
+  RagableBrowserFunctionsClient,
   RagableBrowserMailClient,
   RagableBrowserStorageClient,
   RagableError,