@ragable/sdk 0.6.16 → 0.6.18

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;
     };
 }
 /**
@@ -798,10 +796,10 @@ declare function normalizeBrowserApiBase(): string;
 type BrowserDataAuthMode = "user" | "publicAnon" | "admin";
 /**
  * Resolves how database requests are authorized. If `dataAuth` is omitted and a
- * static browser SQL key is configured (`dataStaticKey` / `getDataStaticKey`),
- * defaults to **`publicAnon`** so read-only public apps work without sign-in.
- * Use explicit **`dataAuth: "user"`** when you need JWT sessions; use **`"admin"`**
- * when the static key is a data-admin key (writes) — do not rely on inference for admin keys.
+ * static browser data key is configured (`dataStaticKey` / `getDataStaticKey`),
+ * defaults to **`publicAnon`** so public apps can use shared collections without
+ * sign-in. Use explicit **`dataAuth: "user"`** when you need JWT sessions; use
+ * **`"admin"`** when the static key is a data-admin key.
  */
 declare function effectiveDataAuth(options: RagableBrowserClientOptions): BrowserDataAuthMode;
 interface RagableBrowserClientOptions {
@@ -810,7 +808,7 @@ interface RagableBrowserClientOptions {
     databaseInstanceId?: string;
     /** When omitted, inferred from static keys — see {@link effectiveDataAuth}. */
     dataAuth?: BrowserDataAuthMode;
-    /** Public anon or data-admin key from the dashboard (Browser SQL API keys). */
+    /** Public anon or data-admin key from the dashboard (Browser Data API keys). */
     dataStaticKey?: string;
     getDataStaticKey?: () => string | null | Promise<string | null>;
     getAccessToken?: () => string | null | Promise<string | null>;
@@ -940,40 +938,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<Row> | BrowserCollectionFindParams<Row>) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
+    insert: (data: Insert) => Promise<PostgrestResult<BrowserCollectionRecord<Row>>>;
+    update: (where: CollectionWhere<Row>, patch: Update, options?: {
         limit?: number;
     }) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
-    delete: (where: Record<string, unknown>, options?: {
+    delete: (where: CollectionWhere<Row>, options?: {
         limit?: number;
     }) => Promise<PostgrestResult<{
         deleted: number;
         records: BrowserCollectionRecord<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 +998,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 +1189,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;
     };
 }
 /**
@@ -798,10 +796,10 @@ declare function normalizeBrowserApiBase(): string;
 type BrowserDataAuthMode = "user" | "publicAnon" | "admin";
 /**
  * Resolves how database requests are authorized. If `dataAuth` is omitted and a
- * static browser SQL key is configured (`dataStaticKey` / `getDataStaticKey`),
- * defaults to **`publicAnon`** so read-only public apps work without sign-in.
- * Use explicit **`dataAuth: "user"`** when you need JWT sessions; use **`"admin"`**
- * when the static key is a data-admin key (writes) — do not rely on inference for admin keys.
+ * static browser data key is configured (`dataStaticKey` / `getDataStaticKey`),
+ * defaults to **`publicAnon`** so public apps can use shared collections without
+ * sign-in. Use explicit **`dataAuth: "user"`** when you need JWT sessions; use
+ * **`"admin"`** when the static key is a data-admin key.
  */
 declare function effectiveDataAuth(options: RagableBrowserClientOptions): BrowserDataAuthMode;
 interface RagableBrowserClientOptions {
@@ -810,7 +808,7 @@ interface RagableBrowserClientOptions {
     databaseInstanceId?: string;
     /** When omitted, inferred from static keys — see {@link effectiveDataAuth}. */
     dataAuth?: BrowserDataAuthMode;
-    /** Public anon or data-admin key from the dashboard (Browser SQL API keys). */
+    /** Public anon or data-admin key from the dashboard (Browser Data API keys). */
     dataStaticKey?: string;
     getDataStaticKey?: () => string | null | Promise<string | null>;
     getAccessToken?: () => string | null | Promise<string | null>;
@@ -940,40 +938,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<Row> | BrowserCollectionFindParams<Row>) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
+    insert: (data: Insert) => Promise<PostgrestResult<BrowserCollectionRecord<Row>>>;
+    update: (where: CollectionWhere<Row>, patch: Update, options?: {
         limit?: number;
     }) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
-    delete: (where: Record<string, unknown>, options?: {
+    delete: (where: CollectionWhere<Row>, options?: {
         limit?: number;
     }) => Promise<PostgrestResult<{
         deleted: number;
         records: BrowserCollectionRecord<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 +998,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 +1189,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);