@ragable/sdk 0.6.17 → 0.6.19

package/dist/index.d.mts

@@ -22,11 +22,9 @@ type RagableTableDefinition<Row extends Record<string, unknown> = Record<string,
  */
 interface RagableDatabase {
     public: {
-        Tables: Record<string, RagableTableDefinition>;
-        Views?: Record<string, {
-            Row: Record<string, unknown>;
-        }>;
-        Enums?: Record<string, string>;
+        Tables: object;
+        Views?: object;
+        Enums?: object;
     };
 }
 /**
@@ -928,11 +926,29 @@ interface BrowserSqlQueryResult<Row extends Record<string, unknown> = Record<str
     rows: Row[];
 }
 interface BrowserCollectionRecord<Row extends Record<string, unknown> = Record<string, unknown>> {
+    [key: string]: unknown;
     id: string;
     data: Row;
     createdAt: string;
     updatedAt: string;
 }
+/**
+ * Collection APIs return record envelopes, but user schema `Row` types should be
+ * the JSON row inside `record.data`. If generated app types accidentally use the
+ * envelope as `Row`, unwrap it so consumers still get `record.data.<field>`.
+ */
+type BrowserCollectionRowData<Row extends Record<string, unknown> = Record<string, unknown>> = Row extends {
+    id: string;
+    data: infer Data;
+    createdAt: string;
+    updatedAt: string;
+} ? Data extends Record<string, unknown> ? Data : Row : Row;
+type BrowserCollectionInsertData<Row extends Record<string, unknown>, Insert extends Record<string, unknown>> = BrowserCollectionRowData<Row> extends Row ? Insert : Insert extends {
+    data: infer Data;
+} ? Data extends Record<string, unknown> ? Data : BrowserCollectionRowData<Row> : BrowserCollectionRowData<Row>;
+type BrowserCollectionUpdateData<Row extends Record<string, unknown>, Update extends Record<string, unknown>> = BrowserCollectionRowData<Row> extends Row ? Update : Update extends {
+    data?: infer Data;
+} ? Data extends Record<string, unknown> ? Partial<Data> : Partial<BrowserCollectionRowData<Row>> : Partial<BrowserCollectionRowData<Row>>;
 interface BrowserCollectionDefinition {
     id: string;
     name: string;
@@ -940,40 +956,57 @@ interface BrowserCollectionDefinition {
     createdAt: string;
     updatedAt: string;
 }
-interface BrowserCollectionFindParams {
-    where?: Record<string, unknown>;
+type CollectionWhere<Row extends Record<string, unknown>> = Partial<Row> & Record<string, unknown>;
+type CollectionFilter<Row extends Record<string, unknown>> = {
+    [Field in Extract<keyof Row, string>]: {
+        field: Field;
+        op?: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "contains";
+        value: Row[Field];
+    };
+}[Extract<keyof Row, string>];
+type BrowserCollectionFindParams<Row extends Record<string, unknown> = Record<string, unknown>> = {
+    where?: CollectionWhere<Row>;
     filters?: Array<{
-        field: string;
+        field: Extract<keyof Row, string> | (string & {});
         op?: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "contains";
         value: unknown;
-    }>;
+    } | CollectionFilter<Row>>;
     limit?: number;
     offset?: number;
-    orderBy?: string;
+    orderBy?: Extract<keyof Row, string> | (string & {});
     orderDirection?: "asc" | "desc";
-}
-declare class BrowserCollectionApi<Row extends Record<string, unknown> = Record<string, unknown>> {
+};
+declare class BrowserCollectionApi<Row extends Record<string, unknown> = Record<string, unknown>, Insert extends Record<string, unknown> = Row, Update extends Record<string, unknown> = Partial<Row>> {
     private readonly database;
     private readonly name;
     private readonly databaseInstanceId?;
     constructor(database: RagableBrowserDatabaseClient<any>, name: string, databaseInstanceId?: string | undefined);
-    find: (whereOrParams?: Record<string, unknown> | BrowserCollectionFindParams) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
-    insert: (data: Row) => Promise<PostgrestResult<BrowserCollectionRecord<Row>>>;
-    update: (where: Record<string, unknown>, patch: Partial<Row>, options?: {
+    find: (whereOrParams?: CollectionWhere<BrowserCollectionRowData<Row>> | BrowserCollectionFindParams<BrowserCollectionRowData<Row>>) => Promise<PostgrestResult<BrowserCollectionRecord<BrowserCollectionRowData<Row>>[]>>;
+    insert: (data: BrowserCollectionInsertData<Row, Insert>) => Promise<PostgrestResult<BrowserCollectionRecord<BrowserCollectionRowData<Row>>>>;
+    update: (where: CollectionWhere<BrowserCollectionRowData<Row>>, patch: BrowserCollectionUpdateData<Row, Update>, options?: {
         limit?: number;
-    }) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
-    delete: (where: Record<string, unknown>, options?: {
+    }) => Promise<PostgrestResult<BrowserCollectionRecord<BrowserCollectionRowData<Row>>[]>>;
+    delete: (where: CollectionWhere<BrowserCollectionRowData<Row>>, options?: {
         limit?: number;
     }) => Promise<PostgrestResult<{
         deleted: number;
-        records: BrowserCollectionRecord<Row>[];
+        records: BrowserCollectionRecord<BrowserCollectionRowData<Row>>[];
     }>>;
 }
+type BrowserCollections<Database extends RagableDatabase = DefaultRagableDatabase> = [keyof Database["public"]["Tables"]] extends [never] ? Record<string, BrowserCollectionApi<Record<string, unknown>>> : {
+    readonly [Name in RagableTableNames<Database>]: BrowserCollectionApi<TableRow<Database, Name>, TableInsertRow<Database, Name>, TableUpdatePatch<Database, Name>>;
+};
+type BrowserCollectionFactory<Database extends RagableDatabase = DefaultRagableDatabase> = {
+    <Name extends RagableTableNames<Database>>(name: Name, databaseInstanceId?: string): BrowserCollectionApi<TableRow<Database, Name>, TableInsertRow<Database, Name>, TableUpdatePatch<Database, Name>>;
+    <Row extends Record<string, unknown>>(name: string, databaseInstanceId?: string): BrowserCollectionApi<Row>;
+};
 declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = DefaultRagableDatabase> {
     private readonly options;
     private readonly ragableAuth;
     private readonly fetchImpl;
     private _transport;
+    readonly collections: BrowserCollections<Database>;
+    readonly collection: BrowserCollectionFactory<Database>;
     constructor(options: RagableBrowserClientOptions, ragableAuth?: RagableAuth | null);
     /** @internal Called by RagableBrowser to share the Transport instance. */
     _setTransport(transport: Transport): void;
@@ -983,7 +1016,6 @@ declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = De
      */
     from: <TableName extends RagableTableNames<Database>>(table: TableName, databaseInstanceId?: string) => PostgrestTableApi<Database, TableName>;
     private toUrl;
-    collection: <Row extends Record<string, unknown> = Record<string, unknown>>(name: string, databaseInstanceId?: string) => BrowserCollectionApi<Row>;
     defineCollection: (name: string, schema?: Record<string, unknown>, databaseInstanceId?: string) => Promise<PostgrestResult<BrowserCollectionDefinition>>;
     listCollections: (databaseInstanceId?: string) => Promise<PostgrestResult<BrowserCollectionDefinition[]>>;
     _requestCollection<T>(method: "GET" | "POST" | "PATCH" | "DELETE", path: string, body?: unknown, databaseInstanceId?: string): Promise<T>;
@@ -1175,4 +1207,4 @@ declare function createClient(options: RagableClientOptions): Ragable;
 declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends Record<string, unknown> = Record<string, unknown>>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
 declare function createRagableServerClient(options: RagableClientOptions): Ragable;
 
-export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, type AgentPublicChatParams, type AgentStreamEvent, type AgentSummary, AgentsClient, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type BrowserAuthSession, type BrowserAuthTokens, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, 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, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetrieveParams, type RetryOptions, 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, asPostgrestResponse, bindFetch, createBrowserClient, createClient, createRagPipeline, createRagableBrowserClient, createRagableServerClient, detectStorage, effectiveDataAuth, extractErrorMessage, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, normalizeBrowserApiBase, parseSseDataLine, parseTransportResponse, readSseStream };
+export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, type AgentPublicChatParams, type AgentStreamEvent, type AgentSummary, AgentsClient, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, 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 ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, 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, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetrieveParams, type RetryOptions, 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, asPostgrestResponse, bindFetch, createBrowserClient, createClient, createRagPipeline, createRagableBrowserClient, createRagableServerClient, detectStorage, effectiveDataAuth, extractErrorMessage, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, normalizeBrowserApiBase, parseSseDataLine, parseTransportResponse, readSseStream };

package/dist/index.d.ts

@@ -22,11 +22,9 @@ type RagableTableDefinition<Row extends Record<string, unknown> = Record<string,
  */
 interface RagableDatabase {
     public: {
-        Tables: Record<string, RagableTableDefinition>;
-        Views?: Record<string, {
-            Row: Record<string, unknown>;
-        }>;
-        Enums?: Record<string, string>;
+        Tables: object;
+        Views?: object;
+        Enums?: object;
     };
 }
 /**
@@ -928,11 +926,29 @@ interface BrowserSqlQueryResult<Row extends Record<string, unknown> = Record<str
     rows: Row[];
 }
 interface BrowserCollectionRecord<Row extends Record<string, unknown> = Record<string, unknown>> {
+    [key: string]: unknown;
     id: string;
     data: Row;
     createdAt: string;
     updatedAt: string;
 }
+/**
+ * Collection APIs return record envelopes, but user schema `Row` types should be
+ * the JSON row inside `record.data`. If generated app types accidentally use the
+ * envelope as `Row`, unwrap it so consumers still get `record.data.<field>`.
+ */
+type BrowserCollectionRowData<Row extends Record<string, unknown> = Record<string, unknown>> = Row extends {
+    id: string;
+    data: infer Data;
+    createdAt: string;
+    updatedAt: string;
+} ? Data extends Record<string, unknown> ? Data : Row : Row;
+type BrowserCollectionInsertData<Row extends Record<string, unknown>, Insert extends Record<string, unknown>> = BrowserCollectionRowData<Row> extends Row ? Insert : Insert extends {
+    data: infer Data;
+} ? Data extends Record<string, unknown> ? Data : BrowserCollectionRowData<Row> : BrowserCollectionRowData<Row>;
+type BrowserCollectionUpdateData<Row extends Record<string, unknown>, Update extends Record<string, unknown>> = BrowserCollectionRowData<Row> extends Row ? Update : Update extends {
+    data?: infer Data;
+} ? Data extends Record<string, unknown> ? Partial<Data> : Partial<BrowserCollectionRowData<Row>> : Partial<BrowserCollectionRowData<Row>>;
 interface BrowserCollectionDefinition {
     id: string;
     name: string;
@@ -940,40 +956,57 @@ interface BrowserCollectionDefinition {
     createdAt: string;
     updatedAt: string;
 }
-interface BrowserCollectionFindParams {
-    where?: Record<string, unknown>;
+type CollectionWhere<Row extends Record<string, unknown>> = Partial<Row> & Record<string, unknown>;
+type CollectionFilter<Row extends Record<string, unknown>> = {
+    [Field in Extract<keyof Row, string>]: {
+        field: Field;
+        op?: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "contains";
+        value: Row[Field];
+    };
+}[Extract<keyof Row, string>];
+type BrowserCollectionFindParams<Row extends Record<string, unknown> = Record<string, unknown>> = {
+    where?: CollectionWhere<Row>;
     filters?: Array<{
-        field: string;
+        field: Extract<keyof Row, string> | (string & {});
         op?: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "contains";
         value: unknown;
-    }>;
+    } | CollectionFilter<Row>>;
     limit?: number;
     offset?: number;
-    orderBy?: string;
+    orderBy?: Extract<keyof Row, string> | (string & {});
     orderDirection?: "asc" | "desc";
-}
-declare class BrowserCollectionApi<Row extends Record<string, unknown> = Record<string, unknown>> {
+};
+declare class BrowserCollectionApi<Row extends Record<string, unknown> = Record<string, unknown>, Insert extends Record<string, unknown> = Row, Update extends Record<string, unknown> = Partial<Row>> {
     private readonly database;
     private readonly name;
     private readonly databaseInstanceId?;
     constructor(database: RagableBrowserDatabaseClient<any>, name: string, databaseInstanceId?: string | undefined);
-    find: (whereOrParams?: Record<string, unknown> | BrowserCollectionFindParams) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
-    insert: (data: Row) => Promise<PostgrestResult<BrowserCollectionRecord<Row>>>;
-    update: (where: Record<string, unknown>, patch: Partial<Row>, options?: {
+    find: (whereOrParams?: CollectionWhere<BrowserCollectionRowData<Row>> | BrowserCollectionFindParams<BrowserCollectionRowData<Row>>) => Promise<PostgrestResult<BrowserCollectionRecord<BrowserCollectionRowData<Row>>[]>>;
+    insert: (data: BrowserCollectionInsertData<Row, Insert>) => Promise<PostgrestResult<BrowserCollectionRecord<BrowserCollectionRowData<Row>>>>;
+    update: (where: CollectionWhere<BrowserCollectionRowData<Row>>, patch: BrowserCollectionUpdateData<Row, Update>, options?: {
         limit?: number;
-    }) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
-    delete: (where: Record<string, unknown>, options?: {
+    }) => Promise<PostgrestResult<BrowserCollectionRecord<BrowserCollectionRowData<Row>>[]>>;
+    delete: (where: CollectionWhere<BrowserCollectionRowData<Row>>, options?: {
         limit?: number;
     }) => Promise<PostgrestResult<{
         deleted: number;
-        records: BrowserCollectionRecord<Row>[];
+        records: BrowserCollectionRecord<BrowserCollectionRowData<Row>>[];
     }>>;
 }
+type BrowserCollections<Database extends RagableDatabase = DefaultRagableDatabase> = [keyof Database["public"]["Tables"]] extends [never] ? Record<string, BrowserCollectionApi<Record<string, unknown>>> : {
+    readonly [Name in RagableTableNames<Database>]: BrowserCollectionApi<TableRow<Database, Name>, TableInsertRow<Database, Name>, TableUpdatePatch<Database, Name>>;
+};
+type BrowserCollectionFactory<Database extends RagableDatabase = DefaultRagableDatabase> = {
+    <Name extends RagableTableNames<Database>>(name: Name, databaseInstanceId?: string): BrowserCollectionApi<TableRow<Database, Name>, TableInsertRow<Database, Name>, TableUpdatePatch<Database, Name>>;
+    <Row extends Record<string, unknown>>(name: string, databaseInstanceId?: string): BrowserCollectionApi<Row>;
+};
 declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = DefaultRagableDatabase> {
     private readonly options;
     private readonly ragableAuth;
     private readonly fetchImpl;
     private _transport;
+    readonly collections: BrowserCollections<Database>;
+    readonly collection: BrowserCollectionFactory<Database>;
     constructor(options: RagableBrowserClientOptions, ragableAuth?: RagableAuth | null);
     /** @internal Called by RagableBrowser to share the Transport instance. */
     _setTransport(transport: Transport): void;
@@ -983,7 +1016,6 @@ declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = De
      */
     from: <TableName extends RagableTableNames<Database>>(table: TableName, databaseInstanceId?: string) => PostgrestTableApi<Database, TableName>;
     private toUrl;
-    collection: <Row extends Record<string, unknown> = Record<string, unknown>>(name: string, databaseInstanceId?: string) => BrowserCollectionApi<Row>;
     defineCollection: (name: string, schema?: Record<string, unknown>, databaseInstanceId?: string) => Promise<PostgrestResult<BrowserCollectionDefinition>>;
     listCollections: (databaseInstanceId?: string) => Promise<PostgrestResult<BrowserCollectionDefinition[]>>;
     _requestCollection<T>(method: "GET" | "POST" | "PATCH" | "DELETE", path: string, body?: unknown, databaseInstanceId?: string): Promise<T>;
@@ -1175,4 +1207,4 @@ declare function createClient(options: RagableClientOptions): Ragable;
 declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends Record<string, unknown> = Record<string, unknown>>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
 declare function createRagableServerClient(options: RagableClientOptions): Ragable;
 
-export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, type AgentPublicChatParams, type AgentStreamEvent, type AgentSummary, AgentsClient, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type BrowserAuthSession, type BrowserAuthTokens, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, 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, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetrieveParams, type RetryOptions, 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, asPostgrestResponse, bindFetch, createBrowserClient, createClient, createRagPipeline, createRagableBrowserClient, createRagableServerClient, detectStorage, effectiveDataAuth, extractErrorMessage, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, normalizeBrowserApiBase, parseSseDataLine, parseTransportResponse, readSseStream };
+export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, type AgentPublicChatParams, type AgentStreamEvent, type AgentSummary, AgentsClient, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, 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 ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, 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, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetrieveParams, type RetryOptions, 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, asPostgrestResponse, bindFetch, createBrowserClient, createClient, createRagPipeline, createRagableBrowserClient, createRagableServerClient, detectStorage, effectiveDataAuth, extractErrorMessage, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, normalizeBrowserApiBase, parseSseDataLine, parseTransportResponse, readSseStream };

package/dist/index.js

@@ -2321,6 +2321,8 @@ var RagableBrowserDatabaseClient = class {
     this.ragableAuth = ragableAuth;
     __publicField(this, "fetchImpl");
     __publicField(this, "_transport", null);
+    __publicField(this, "collections");
+    __publicField(this, "collection");
     /**
      * PostgREST table access. Instance field so `client.database.from` is always an own,
      * enumerable function (avoids rare prototype/bundler issues).
@@ -2374,9 +2376,6 @@ var RagableBrowserDatabaseClient = class {
       };
       return new PostgrestTableApi(pgFetch, id, table);
     });
-    __publicField(this, "collection", (name, databaseInstanceId) => {
-      return new BrowserCollectionApi(this, name, databaseInstanceId);
-    });
     __publicField(this, "defineCollection", (name, schema, databaseInstanceId) => asPostgrestResponse(
       () => this._requestCollection(
         "POST",
@@ -2459,6 +2458,21 @@ var RagableBrowserDatabaseClient = class {
       )
     });
     this.fetchImpl = bindFetch(options.fetch);
+    this.collections = new Proxy(
+      {},
+      {
+        get: (_target, prop) => {
+          if (typeof prop !== "string") return void 0;
+          if (prop === "then") return void 0;
+          return this.collection(prop);
+        }
+      }
+    );
+    this.collection = ((name, databaseInstanceId) => new BrowserCollectionApi(
+      this,
+      name,
+      databaseInstanceId
+    ));
   }
   /** @internal Called by RagableBrowser to share the Transport instance. */
   _setTransport(transport) {
@@ -2473,7 +2487,7 @@ var RagableBrowserDatabaseClient = class {
     const id = databaseInstanceId?.trim() || this.options.databaseInstanceId?.trim();
     if (!id) {
       throw new RagableError(
-        "db.collection() requires databaseInstanceId in client options or as an argument",
+        "db.collections requires databaseInstanceId in client options. For dynamic collection() calls, you can also pass databaseInstanceId as the second argument.",
         400,
         { code: "SDK_MISSING_DATABASE_INSTANCE_ID" }
       );
@@ -2843,7 +2857,7 @@ function createClient(options) {
   if (isServerClientOptions(options)) {
     if (typeof options === "object" && options !== null && "organizationId" in options && typeof options.organizationId === "string") {
       console.warn(
-        "[@ragable/sdk] createClient: `apiKey` is set, so the server client is returned. It has no `database` or `auth` \u2014 only `agents` and `shift`. For `db.collection()` / `database.from()` / `auth.*`, use the browser client without `apiKey` (e.g. createClient({ organizationId, authGroupId, databaseInstanceId, ... }))."
+        "[@ragable/sdk] createClient: `apiKey` is set, so the server client is returned. It has no `database` or `auth` \u2014 only `agents` and `shift`. For `db.collections.<name>` / `database.from()` / `auth.*`, use the browser client without `apiKey` (e.g. createClient({ organizationId, authGroupId, databaseInstanceId, ... }))."
       );
     }
     return new Ragable(options);