@ragable/sdk 0.6.23 → 0.6.24

package/dist/index.d.mts

@@ -74,10 +74,20 @@ type ColumnValue<D extends RagableDatabase, T extends RagableTableNames<D>, C ex
  * or the browser throws **Illegal invocation**. Use this for defaults and for `options.fetch`.
  */
 declare function bindFetch(custom?: typeof fetch): typeof fetch;
-/** Hosted Ragable HTTP API base (`…/api`) — used by all SDK clients (not configurable). */
+/** Default hosted Ragable HTTP API base (`…/api`) when **`baseUrl`** is omitted. */
 declare const DEFAULT_RAGABLE_API_BASE = "https://ragable-341305259977.asia-southeast1.run.app/api";
+/**
+ * Normalize the API base (no trailing slash). Use **`DEFAULT_RAGABLE_API_BASE`** when
+ * **`explicitBaseUrl`** is missing or blank.
+ */
+declare function resolveRagableApiBase(explicitBaseUrl?: string | null | undefined): string;
 interface RagableClientOptions {
     apiKey: string;
+    /**
+     * HTTP API root including the **`/api`** segment, e.g. `https://your-host.com/api`.
+     * Defaults to {@link DEFAULT_RAGABLE_API_BASE}.
+     */
+    baseUrl?: string;
     fetch?: typeof fetch;
     headers?: HeadersInit;
 }
@@ -894,6 +904,8 @@ interface AuthOptions {
 }
 interface RagableAuthConfig {
     authGroupId: string;
+    /** HTTP API root (including `/api`); set from the browser client **`baseUrl`** option. */
+    baseUrl?: string;
     fetch?: typeof fetch;
     headers?: HeadersInit;
     auth?: AuthOptions;
@@ -1098,8 +1110,11 @@ declare class Transport {
 }
 declare function parseTransportResponse<T>(response: Response): Promise<T>;
 
-/** Canonical browser/server API base (`…/api`, no trailing slash). */
-declare function normalizeBrowserApiBase(): string;
+/**
+ * Resolved API base (`…/api`, no trailing slash). With no argument, uses the same default as
+ * {@link resolveRagableApiBase}.
+ */
+declare function normalizeBrowserApiBase(explicitBaseUrl?: string): string;
 type BrowserDataAuthMode = "user" | "publicAnon" | "admin";
 /**
  * Resolves how database requests are authorized. If `dataAuth` is omitted and a
@@ -1111,6 +1126,12 @@ type BrowserDataAuthMode = "user" | "publicAnon" | "admin";
 declare function effectiveDataAuth(options: RagableBrowserClientOptions): BrowserDataAuthMode;
 interface RagableBrowserClientOptions {
     organizationId: string;
+    /**
+     * HTTP API root including **`/api`**, e.g. `https://your-host.com/api` or
+     * `import.meta.env.VITE_RAGABLE_API_BASE`. Trailing slashes are stripped.
+     * When omitted, the package default **`DEFAULT_RAGABLE_API_BASE`** is used.
+     */
+    baseUrl?: string;
     websiteId?: string;
     authGroupId?: string;
     databaseInstanceId?: string;
@@ -1418,6 +1439,7 @@ declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = De
     private readonly options;
     private readonly ragableAuth;
     private readonly fetchImpl;
+    private readonly apiBase;
     private _transport;
     readonly collections: BrowserCollections<Database>;
     readonly collection: BrowserCollectionFactory<Database>;
@@ -1541,6 +1563,7 @@ interface AgentConversationSubscription {
 declare class RagableBrowserAgentsClient {
     private readonly options;
     private readonly fetchImpl;
+    private readonly apiBase;
     constructor(options: RagableBrowserClientOptions);
     private toUrl;
     private requireWebsiteId;
@@ -1673,4 +1696,4 @@ declare function createClient(options: RagableClientOptions): Ragable;
 declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
 declare function createRagableServerClient(options: RagableClientOptions): Ragable;
 
-export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, 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, type AgentSummary, AgentsClient, 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, type CollectionReturnMode, type CollectionRowData, type CollectionRowWithMeta, type CollectionWhere, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FormatContextOptions, type HttpMethod, type Json, LocalStorageAdapter, MemoryStorageAdapter, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, type RagClientForPipeline, type RagPipeline, type RagPipelineOptions, Ragable, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, type RagableClientOptions, type RagableDatabase, RagableError, RagableNetworkError, RagableRequestClient, type RagableResult, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetrieveParams, type RetryOptions, type RunAgentChatStreamOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type ShiftAddDocumentParams, ShiftClient, type ShiftCreateIndexParams, type ShiftEntry, type ShiftIndex, type ShiftIngestResponse, type ShiftListEntriesParams, type ShiftListEntriesResponse, type ShiftSearchParams, type ShiftSearchResult, type ShiftUpdateIndexParams, type ShiftUploadFileParams, type ShiftUploadableFile, type SseJsonEvent, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, Transport, type TransportOptions, type TransportRequest, type WhereInput, type WhereOperatorObject, asPostgrestResponse, assertPostgrestSuccess, bindFetch, collectAssistantTextFromUiSegments, collectionRecordToRowWithMeta, collectionRecordsToRowWithMeta, createBrowserClient, createClient, createRagPipeline, createRagableBrowserClient, createRagableServerClient, detectStorage, effectiveDataAuth, extractErrorMessage, finalizeAgentChatUiTurn, foldAgentStreamIntoUiSegments, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, isIncompleteAgentStreamError, normalizeBrowserApiBase, parseAgentStreamAgentInfo, parseAgentStreamDone, parseSseDataLine, parseTransportResponse, readSseStream, runAgentChatStream, runAgentChatStreamForUi, runAgentChatStreamLenient, toRagableResult, unwrapPostgrest };
+export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, 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, type AgentSummary, AgentsClient, 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, type CollectionReturnMode, type CollectionRowData, type CollectionRowWithMeta, type CollectionWhere, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FormatContextOptions, type HttpMethod, type Json, LocalStorageAdapter, MemoryStorageAdapter, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, type RagClientForPipeline, type RagPipeline, type RagPipelineOptions, Ragable, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, type RagableClientOptions, type RagableDatabase, RagableError, RagableNetworkError, RagableRequestClient, type RagableResult, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetrieveParams, type RetryOptions, type RunAgentChatStreamOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type ShiftAddDocumentParams, ShiftClient, type ShiftCreateIndexParams, type ShiftEntry, type ShiftIndex, type ShiftIngestResponse, type ShiftListEntriesParams, type ShiftListEntriesResponse, type ShiftSearchParams, type ShiftSearchResult, type ShiftUpdateIndexParams, type ShiftUploadFileParams, type ShiftUploadableFile, type SseJsonEvent, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, Transport, type TransportOptions, type TransportRequest, type WhereInput, type WhereOperatorObject, asPostgrestResponse, assertPostgrestSuccess, bindFetch, collectAssistantTextFromUiSegments, collectionRecordToRowWithMeta, collectionRecordsToRowWithMeta, createBrowserClient, createClient, createRagPipeline, createRagableBrowserClient, createRagableServerClient, detectStorage, effectiveDataAuth, extractErrorMessage, finalizeAgentChatUiTurn, foldAgentStreamIntoUiSegments, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, isIncompleteAgentStreamError, normalizeBrowserApiBase, parseAgentStreamAgentInfo, parseAgentStreamDone, parseSseDataLine, parseTransportResponse, readSseStream, resolveRagableApiBase, runAgentChatStream, runAgentChatStreamForUi, runAgentChatStreamLenient, toRagableResult, unwrapPostgrest };

package/dist/index.d.ts

@@ -74,10 +74,20 @@ type ColumnValue<D extends RagableDatabase, T extends RagableTableNames<D>, C ex
  * or the browser throws **Illegal invocation**. Use this for defaults and for `options.fetch`.
  */
 declare function bindFetch(custom?: typeof fetch): typeof fetch;
-/** Hosted Ragable HTTP API base (`…/api`) — used by all SDK clients (not configurable). */
+/** Default hosted Ragable HTTP API base (`…/api`) when **`baseUrl`** is omitted. */
 declare const DEFAULT_RAGABLE_API_BASE = "https://ragable-341305259977.asia-southeast1.run.app/api";
+/**
+ * Normalize the API base (no trailing slash). Use **`DEFAULT_RAGABLE_API_BASE`** when
+ * **`explicitBaseUrl`** is missing or blank.
+ */
+declare function resolveRagableApiBase(explicitBaseUrl?: string | null | undefined): string;
 interface RagableClientOptions {
     apiKey: string;
+    /**
+     * HTTP API root including the **`/api`** segment, e.g. `https://your-host.com/api`.
+     * Defaults to {@link DEFAULT_RAGABLE_API_BASE}.
+     */
+    baseUrl?: string;
     fetch?: typeof fetch;
     headers?: HeadersInit;
 }
@@ -894,6 +904,8 @@ interface AuthOptions {
 }
 interface RagableAuthConfig {
     authGroupId: string;
+    /** HTTP API root (including `/api`); set from the browser client **`baseUrl`** option. */
+    baseUrl?: string;
     fetch?: typeof fetch;
     headers?: HeadersInit;
     auth?: AuthOptions;
@@ -1098,8 +1110,11 @@ declare class Transport {
 }
 declare function parseTransportResponse<T>(response: Response): Promise<T>;
 
-/** Canonical browser/server API base (`…/api`, no trailing slash). */
-declare function normalizeBrowserApiBase(): string;
+/**
+ * Resolved API base (`…/api`, no trailing slash). With no argument, uses the same default as
+ * {@link resolveRagableApiBase}.
+ */
+declare function normalizeBrowserApiBase(explicitBaseUrl?: string): string;
 type BrowserDataAuthMode = "user" | "publicAnon" | "admin";
 /**
  * Resolves how database requests are authorized. If `dataAuth` is omitted and a
@@ -1111,6 +1126,12 @@ type BrowserDataAuthMode = "user" | "publicAnon" | "admin";
 declare function effectiveDataAuth(options: RagableBrowserClientOptions): BrowserDataAuthMode;
 interface RagableBrowserClientOptions {
     organizationId: string;
+    /**
+     * HTTP API root including **`/api`**, e.g. `https://your-host.com/api` or
+     * `import.meta.env.VITE_RAGABLE_API_BASE`. Trailing slashes are stripped.
+     * When omitted, the package default **`DEFAULT_RAGABLE_API_BASE`** is used.
+     */
+    baseUrl?: string;
     websiteId?: string;
     authGroupId?: string;
     databaseInstanceId?: string;
@@ -1418,6 +1439,7 @@ declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = De
     private readonly options;
     private readonly ragableAuth;
     private readonly fetchImpl;
+    private readonly apiBase;
     private _transport;
     readonly collections: BrowserCollections<Database>;
     readonly collection: BrowserCollectionFactory<Database>;
@@ -1541,6 +1563,7 @@ interface AgentConversationSubscription {
 declare class RagableBrowserAgentsClient {
     private readonly options;
     private readonly fetchImpl;
+    private readonly apiBase;
     constructor(options: RagableBrowserClientOptions);
     private toUrl;
     private requireWebsiteId;
@@ -1673,4 +1696,4 @@ declare function createClient(options: RagableClientOptions): Ragable;
 declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
 declare function createRagableServerClient(options: RagableClientOptions): Ragable;
 
-export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, 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, type AgentSummary, AgentsClient, 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, type CollectionReturnMode, type CollectionRowData, type CollectionRowWithMeta, type CollectionWhere, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FormatContextOptions, type HttpMethod, type Json, LocalStorageAdapter, MemoryStorageAdapter, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, type RagClientForPipeline, type RagPipeline, type RagPipelineOptions, Ragable, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, type RagableClientOptions, type RagableDatabase, RagableError, RagableNetworkError, RagableRequestClient, type RagableResult, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetrieveParams, type RetryOptions, type RunAgentChatStreamOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type ShiftAddDocumentParams, ShiftClient, type ShiftCreateIndexParams, type ShiftEntry, type ShiftIndex, type ShiftIngestResponse, type ShiftListEntriesParams, type ShiftListEntriesResponse, type ShiftSearchParams, type ShiftSearchResult, type ShiftUpdateIndexParams, type ShiftUploadFileParams, type ShiftUploadableFile, type SseJsonEvent, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, Transport, type TransportOptions, type TransportRequest, type WhereInput, type WhereOperatorObject, asPostgrestResponse, assertPostgrestSuccess, bindFetch, collectAssistantTextFromUiSegments, collectionRecordToRowWithMeta, collectionRecordsToRowWithMeta, createBrowserClient, createClient, createRagPipeline, createRagableBrowserClient, createRagableServerClient, detectStorage, effectiveDataAuth, extractErrorMessage, finalizeAgentChatUiTurn, foldAgentStreamIntoUiSegments, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, isIncompleteAgentStreamError, normalizeBrowserApiBase, parseAgentStreamAgentInfo, parseAgentStreamDone, parseSseDataLine, parseTransportResponse, readSseStream, runAgentChatStream, runAgentChatStreamForUi, runAgentChatStreamLenient, toRagableResult, unwrapPostgrest };
+export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, 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, type AgentSummary, AgentsClient, 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, type CollectionReturnMode, type CollectionRowData, type CollectionRowWithMeta, type CollectionWhere, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FormatContextOptions, type HttpMethod, type Json, LocalStorageAdapter, MemoryStorageAdapter, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, type RagClientForPipeline, type RagPipeline, type RagPipelineOptions, Ragable, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, type RagableClientOptions, type RagableDatabase, RagableError, RagableNetworkError, RagableRequestClient, type RagableResult, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetrieveParams, type RetryOptions, type RunAgentChatStreamOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type ShiftAddDocumentParams, ShiftClient, type ShiftCreateIndexParams, type ShiftEntry, type ShiftIndex, type ShiftIngestResponse, type ShiftListEntriesParams, type ShiftListEntriesResponse, type ShiftSearchParams, type ShiftSearchResult, type ShiftUpdateIndexParams, type ShiftUploadFileParams, type ShiftUploadableFile, type SseJsonEvent, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, Transport, type TransportOptions, type TransportRequest, type WhereInput, type WhereOperatorObject, asPostgrestResponse, assertPostgrestSuccess, bindFetch, collectAssistantTextFromUiSegments, collectionRecordToRowWithMeta, collectionRecordsToRowWithMeta, createBrowserClient, createClient, createRagPipeline, createRagableBrowserClient, createRagableServerClient, detectStorage, effectiveDataAuth, extractErrorMessage, finalizeAgentChatUiTurn, foldAgentStreamIntoUiSegments, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, isIncompleteAgentStreamError, normalizeBrowserApiBase, parseAgentStreamAgentInfo, parseAgentStreamDone, parseSseDataLine, parseTransportResponse, readSseStream, resolveRagableApiBase, runAgentChatStream, runAgentChatStreamForUi, runAgentChatStreamLenient, toRagableResult, unwrapPostgrest };

package/dist/index.js

@@ -82,6 +82,7 @@ __export(index_exports, {
   parseSseDataLine: () => parseSseDataLine,
   parseTransportResponse: () => parseTransportResponse,
   readSseStream: () => readSseStream,
+  resolveRagableApiBase: () => resolveRagableApiBase,
   runAgentChatStream: () => runAgentChatStream,
   runAgentChatStreamForUi: () => runAgentChatStreamForUi,
   runAgentChatStreamLenient: () => runAgentChatStreamLenient,
@@ -98,6 +99,10 @@ function bindFetch(custom) {
   };
 }
 var DEFAULT_RAGABLE_API_BASE = "https://ragable-341305259977.asia-southeast1.run.app/api";
+function resolveRagableApiBase(explicitBaseUrl) {
+  const raw = typeof explicitBaseUrl === "string" && explicitBaseUrl.trim().length > 0 ? explicitBaseUrl.trim() : DEFAULT_RAGABLE_API_BASE.trim();
+  return raw.replace(/\/+$/, "");
+}
 var RagableSdkError = class extends Error {
   constructor(message) {
     super(message);
@@ -226,7 +231,7 @@ var RagableRequestClient = class {
     __publicField(this, "fetchImpl");
     __publicField(this, "defaultHeaders");
     this.apiKey = options.apiKey;
-    this.baseUrl = DEFAULT_RAGABLE_API_BASE.replace(/\/+$/, "");
+    this.baseUrl = resolveRagableApiBase(options.baseUrl);
     this.fetchImpl = bindFetch(options.fetch);
     this.defaultHeaders = options.headers;
   }
@@ -2250,7 +2255,7 @@ var RagableAuth = class {
     __publicField(this, "broadcast", null);
     __publicField(this, "visibilityHandler", null);
     __publicField(this, "initialized", false);
-    this.baseUrl = DEFAULT_RAGABLE_API_BASE.replace(/\/+$/, "");
+    this.baseUrl = resolveRagableApiBase(config.baseUrl);
     this.authGroupId = config.authGroupId;
     this.fetchImpl = bindFetch(config.fetch);
     this.defaultHeaders = config.headers;
@@ -2619,8 +2624,8 @@ function decodeJwtExpiry(jwt) {
 }
 
 // src/browser.ts
-function normalizeBrowserApiBase() {
-  return DEFAULT_RAGABLE_API_BASE.replace(/\/+$/, "");
+function normalizeBrowserApiBase(explicitBaseUrl) {
+  return resolveRagableApiBase(explicitBaseUrl);
 }
 function effectiveDataAuth(options) {
   if (options.dataAuth) return options.dataAuth;
@@ -2911,6 +2916,7 @@ var RagableBrowserDatabaseClient = class {
     this.options = options;
     this.ragableAuth = ragableAuth;
     __publicField(this, "fetchImpl");
+    __publicField(this, "apiBase");
     __publicField(this, "_transport", null);
     __publicField(this, "collections");
     __publicField(this, "collection");
@@ -2934,7 +2940,7 @@ var RagableBrowserDatabaseClient = class {
         }
         const gid = requireAuthGroupId(opts);
         const token = await resolveDatabaseAuthBearer(opts, ragableAuth);
-        const apiBase = normalizeBrowserApiBase();
+        const apiBase = this.apiBase;
         const qs = params.searchParams.toString();
         const url = `${apiBase}/auth-groups/${gid}/data/rest/${params.table}${qs ? `?${qs}` : ""}`;
         const headers = new Headers(opts.headers);
@@ -3049,6 +3055,7 @@ var RagableBrowserDatabaseClient = class {
       )
     });
     this.fetchImpl = bindFetch(options.fetch);
+    this.apiBase = resolveRagableApiBase(options.baseUrl);
     this.collections = new Proxy(
       {},
       {
@@ -3070,7 +3077,7 @@ var RagableBrowserDatabaseClient = class {
     this._transport = transport;
   }
   toUrl(path) {
-    return `${normalizeBrowserApiBase()}${path.startsWith("/") ? path : `/${path}`}`;
+    return `${this.apiBase}${path.startsWith("/") ? path : `/${path}`}`;
   }
   async _requestCollection(method, path, body, databaseInstanceId) {
     const gid = requireAuthGroupId(this.options);
@@ -3161,7 +3168,7 @@ async function subscribeBrowserRealtime(options, ragableAuth, fetchImpl, params)
     headers.set("Authorization", `Bearer ${token}`);
     headers.set("Content-Type", "application/json");
     const response = await fetchImpl(
-      `${normalizeBrowserApiBase()}/auth-groups/${gid}/data/realtime/stream`,
+      `${resolveRagableApiBase(options.baseUrl)}/auth-groups/${gid}/data/realtime/stream`,
       {
         method: "POST",
         headers,
@@ -3294,10 +3301,12 @@ var RagableBrowserAgentsClient = class {
   constructor(options) {
     this.options = options;
     __publicField(this, "fetchImpl");
+    __publicField(this, "apiBase");
     this.fetchImpl = bindFetch(options.fetch);
+    this.apiBase = resolveRagableApiBase(options.baseUrl);
   }
   toUrl(path) {
-    return `${normalizeBrowserApiBase()}${path.startsWith("/") ? path : `/${path}`}`;
+    return `${this.apiBase}${path.startsWith("/") ? path : `/${path}`}`;
   }
   requireWebsiteId() {
     const websiteId = this.options.websiteId?.trim();
@@ -3497,6 +3506,7 @@ var RagableBrowser = class {
     if (options.authGroupId) {
       this._ragableAuth = new RagableAuth({
         authGroupId: options.authGroupId,
+        baseUrl: options.baseUrl,
         fetch: options.fetch,
         headers: options.headers,
         auth: options.auth
@@ -3672,6 +3682,7 @@ function createRagableServerClient(options) {
   parseSseDataLine,
   parseTransportResponse,
   readSseStream,
+  resolveRagableApiBase,
   runAgentChatStream,
   runAgentChatStreamForUi,
   runAgentChatStreamLenient,