@ragable/sdk 0.6.5 → 0.6.6

package/dist/index.d.mts

@@ -359,6 +359,24 @@ declare class PostgrestSelectBuilder<Row extends Record<string, unknown> = Recor
     single(): Promise<PostgrestResult<Row>>;
     maybeSingle(): Promise<PostgrestResult<Row | null>>;
 }
+/**
+ * Awaitable `{ data: null, error }` chain when `.insert()` is called with invalid extra
+ * arguments — matches Supabase-style result shapes without throwing.
+ */
+declare class PostgrestInsertSdkErrorRoot<Row extends Record<string, unknown> = Record<string, unknown>> implements PromiseLike<PostgrestResult<null>> {
+    private readonly error;
+    constructor(error: RagableError);
+    select(_columns?: string): PostgrestInsertSdkErrorReturning<Row>;
+    abortSignal(_signal: AbortSignal): this;
+    then<TResult1 = PostgrestResult<null>, TResult2 = never>(onfulfilled?: ((value: PostgrestResult<null>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+}
+declare class PostgrestInsertSdkErrorReturning<Row extends Record<string, unknown> = Record<string, unknown>> implements PromiseLike<PostgrestResult<Row[]>> {
+    private readonly error;
+    constructor(error: RagableError);
+    then<TResult1 = PostgrestResult<Row[]>, TResult2 = never>(onfulfilled?: ((value: PostgrestResult<Row[]>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    single(): Promise<PostgrestResult<Row>>;
+    maybeSingle(): Promise<PostgrestResult<Row | null>>;
+}
 declare class PostgrestInsertRootBuilder<Row extends Record<string, unknown> = Record<string, unknown>> implements PromiseLike<PostgrestResult<null>> {
     private readonly pgFetch;
     private readonly databaseInstanceId;
@@ -882,7 +900,7 @@ declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = De
     _setTransport(transport: Transport): void;
     from<TableName extends RagableTableNames<Database>>(table: TableName, databaseInstanceId?: string): PostgrestTableApi<Database, TableName>;
     private toUrl;
-    query<Row extends Record<string, unknown> = Record<string, unknown>>(params: BrowserSqlQueryParams): Promise<BrowserSqlQueryResult<Row>>;
+    query<Row extends Record<string, unknown> = Record<string, unknown>>(params: BrowserSqlQueryParams): Promise<PostgrestResult<BrowserSqlQueryResult<Row>>>;
     private baseHeaders;
 }
 declare class RagableBrowserAgentsClient {
@@ -986,4 +1004,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 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, 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, 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, type BrowserDataAuthMode, 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, extractErrorMessage, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, normalizeBrowserApiBase, parseSseDataLine, parseTransportResponse, readSseStream };

package/dist/index.d.ts

@@ -359,6 +359,24 @@ declare class PostgrestSelectBuilder<Row extends Record<string, unknown> = Recor
     single(): Promise<PostgrestResult<Row>>;
     maybeSingle(): Promise<PostgrestResult<Row | null>>;
 }
+/**
+ * Awaitable `{ data: null, error }` chain when `.insert()` is called with invalid extra
+ * arguments — matches Supabase-style result shapes without throwing.
+ */
+declare class PostgrestInsertSdkErrorRoot<Row extends Record<string, unknown> = Record<string, unknown>> implements PromiseLike<PostgrestResult<null>> {
+    private readonly error;
+    constructor(error: RagableError);
+    select(_columns?: string): PostgrestInsertSdkErrorReturning<Row>;
+    abortSignal(_signal: AbortSignal): this;
+    then<TResult1 = PostgrestResult<null>, TResult2 = never>(onfulfilled?: ((value: PostgrestResult<null>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+}
+declare class PostgrestInsertSdkErrorReturning<Row extends Record<string, unknown> = Record<string, unknown>> implements PromiseLike<PostgrestResult<Row[]>> {
+    private readonly error;
+    constructor(error: RagableError);
+    then<TResult1 = PostgrestResult<Row[]>, TResult2 = never>(onfulfilled?: ((value: PostgrestResult<Row[]>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    single(): Promise<PostgrestResult<Row>>;
+    maybeSingle(): Promise<PostgrestResult<Row | null>>;
+}
 declare class PostgrestInsertRootBuilder<Row extends Record<string, unknown> = Record<string, unknown>> implements PromiseLike<PostgrestResult<null>> {
     private readonly pgFetch;
     private readonly databaseInstanceId;
@@ -882,7 +900,7 @@ declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = De
     _setTransport(transport: Transport): void;
     from<TableName extends RagableTableNames<Database>>(table: TableName, databaseInstanceId?: string): PostgrestTableApi<Database, TableName>;
     private toUrl;
-    query<Row extends Record<string, unknown> = Record<string, unknown>>(params: BrowserSqlQueryParams): Promise<BrowserSqlQueryResult<Row>>;
+    query<Row extends Record<string, unknown> = Record<string, unknown>>(params: BrowserSqlQueryParams): Promise<PostgrestResult<BrowserSqlQueryResult<Row>>>;
     private baseHeaders;
 }
 declare class RagableBrowserAgentsClient {
@@ -986,4 +1004,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 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, 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, 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, type BrowserDataAuthMode, 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, extractErrorMessage, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, normalizeBrowserApiBase, parseSseDataLine, parseTransportResponse, readSseStream };

package/dist/index.js

@@ -32,6 +32,8 @@ __export(index_exports, {
   PostgrestDeleteRootBuilder: () => PostgrestDeleteRootBuilder,
   PostgrestInsertReturningBuilder: () => PostgrestInsertReturningBuilder,
   PostgrestInsertRootBuilder: () => PostgrestInsertRootBuilder,
+  PostgrestInsertSdkErrorReturning: () => PostgrestInsertSdkErrorReturning,
+  PostgrestInsertSdkErrorRoot: () => PostgrestInsertSdkErrorRoot,
   PostgrestSelectBuilder: () => PostgrestSelectBuilder,
   PostgrestTableApi: () => PostgrestTableApi,
   PostgrestUpdateReturningBuilder: () => PostgrestUpdateReturningBuilder,
@@ -932,24 +934,48 @@ var PostgrestSelectBuilder = class {
     });
   }
   async maybeSingle() {
-    return asPostgrestResponse(async () => {
-      const response = await this.pgFetch({
-        method: "GET",
-        table: this.table,
-        searchParams: this.buildSearchParams(),
-        databaseInstanceId: this.databaseInstanceId,
-        signal: this._signal
-      });
-      const rows = await parsePostgRESTResponse(response);
-      if (rows.length > 1) {
-        throw new RagableError(
+    const many = await this.executeMany();
+    if (many.error) return { data: null, error: many.error };
+    const rows = many.data ?? [];
+    if (rows.length > 1) {
+      return {
+        data: null,
+        error: new RagableError(
           "JSON object requested, multiple (or no) rows returned",
           406,
           { code: "PGRST116" }
-        );
-      }
-      return rows[0] ?? null;
-    });
+        )
+      };
+    }
+    return { data: rows[0] ?? null, error: null };
+  }
+};
+var PostgrestInsertSdkErrorRoot = class {
+  constructor(error) {
+    this.error = error;
+  }
+  select(_columns = "*") {
+    return new PostgrestInsertSdkErrorReturning(this.error);
+  }
+  abortSignal(_signal) {
+    return this;
+  }
+  then(onfulfilled, onrejected) {
+    return Promise.resolve({ data: null, error: this.error }).then(onfulfilled, onrejected);
+  }
+};
+var PostgrestInsertSdkErrorReturning = class {
+  constructor(error) {
+    this.error = error;
+  }
+  then(onfulfilled, onrejected) {
+    return Promise.resolve({ data: null, error: this.error }).then(onfulfilled, onrejected);
+  }
+  async single() {
+    return { data: null, error: this.error };
+  }
+  async maybeSingle() {
+    return { data: null, error: this.error };
   }
 };
 var PostgrestInsertRootBuilder = class {
@@ -1030,34 +1056,36 @@ var PostgrestInsertReturningBuilder = class {
     });
   }
   async single() {
-    return asPostgrestResponse(async () => {
-      const { data, error } = await this.executeMany();
-      if (error) throw error;
-      const rows = data ?? [];
-      if (rows.length === 0 || rows.length > 1) {
-        throw new RagableError(
+    const many = await this.executeMany();
+    if (many.error) return { data: null, error: many.error };
+    const rows = many.data ?? [];
+    if (rows.length === 0 || rows.length > 1) {
+      return {
+        data: null,
+        error: new RagableError(
           "JSON object requested, multiple (or no) rows returned",
           406,
           { code: "PGRST116" }
-        );
-      }
-      return rows[0];
-    });
+        )
+      };
+    }
+    return { data: rows[0], error: null };
   }
   async maybeSingle() {
-    return asPostgrestResponse(async () => {
-      const { data, error } = await this.executeMany();
-      if (error) throw error;
-      const rows = data ?? [];
-      if (rows.length > 1) {
-        throw new RagableError(
+    const many = await this.executeMany();
+    if (many.error) return { data: null, error: many.error };
+    const rows = many.data ?? [];
+    if (rows.length > 1) {
+      return {
+        data: null,
+        error: new RagableError(
           "JSON object requested, multiple (or no) rows returned",
           406,
           { code: "PGRST116" }
-        );
-      }
-      return rows[0] ?? null;
-    });
+        )
+      };
+    }
+    return { data: rows[0] ?? null, error: null };
   }
 };
 var PostgrestUpdateRootBuilder = class {
@@ -1205,34 +1233,36 @@ var PostgrestUpdateReturningBuilder = class {
     });
   }
   async single() {
-    return asPostgrestResponse(async () => {
-      const { data, error } = await this.executeMany();
-      if (error) throw error;
-      const rows = data ?? [];
-      if (rows.length === 0 || rows.length > 1) {
-        throw new RagableError(
+    const many = await this.executeMany();
+    if (many.error) return { data: null, error: many.error };
+    const rows = many.data ?? [];
+    if (rows.length === 0 || rows.length > 1) {
+      return {
+        data: null,
+        error: new RagableError(
           "JSON object requested, multiple (or no) rows returned",
           406,
           { code: "PGRST116" }
-        );
-      }
-      return rows[0];
-    });
+        )
+      };
+    }
+    return { data: rows[0], error: null };
   }
   async maybeSingle() {
-    return asPostgrestResponse(async () => {
-      const { data, error } = await this.executeMany();
-      if (error) throw error;
-      const rows = data ?? [];
-      if (rows.length > 1) {
-        throw new RagableError(
+    const many = await this.executeMany();
+    if (many.error) return { data: null, error: many.error };
+    const rows = many.data ?? [];
+    if (rows.length > 1) {
+      return {
+        data: null,
+        error: new RagableError(
           "JSON object requested, multiple (or no) rows returned",
           406,
           { code: "PGRST116" }
-        );
-      }
-      return rows[0] ?? null;
-    });
+        )
+      };
+    }
+    return { data: rows[0] ?? null, error: null };
   }
 };
 var PostgrestDeleteRootBuilder = class {
@@ -1364,34 +1394,36 @@ var PostgrestDeleteReturningBuilder = class {
     });
   }
   async single() {
-    return asPostgrestResponse(async () => {
-      const { data, error } = await this.executeMany();
-      if (error) throw error;
-      const rows = data ?? [];
-      if (rows.length === 0 || rows.length > 1) {
-        throw new RagableError(
+    const many = await this.executeMany();
+    if (many.error) return { data: null, error: many.error };
+    const rows = many.data ?? [];
+    if (rows.length === 0 || rows.length > 1) {
+      return {
+        data: null,
+        error: new RagableError(
           "JSON object requested, multiple (or no) rows returned",
           406,
           { code: "PGRST116" }
-        );
-      }
-      return rows[0];
-    });
+        )
+      };
+    }
+    return { data: rows[0], error: null };
   }
   async maybeSingle() {
-    return asPostgrestResponse(async () => {
-      const { data, error } = await this.executeMany();
-      if (error) throw error;
-      const rows = data ?? [];
-      if (rows.length > 1) {
-        throw new RagableError(
+    const many = await this.executeMany();
+    if (many.error) return { data: null, error: many.error };
+    const rows = many.data ?? [];
+    if (rows.length > 1) {
+      return {
+        data: null,
+        error: new RagableError(
           "JSON object requested, multiple (or no) rows returned",
           406,
           { code: "PGRST116" }
-        );
-      }
-      return rows[0] ?? null;
-    });
+        )
+      };
+    }
+    return { data: rows[0] ?? null, error: null };
   }
 };
 var PostgrestUpsertRootBuilder = class {
@@ -1460,34 +1492,36 @@ var PostgrestUpsertReturningBuilder = class {
     });
   }
   async single() {
-    return asPostgrestResponse(async () => {
-      const { data, error } = await this.executeMany();
-      if (error) throw error;
-      const rows = data ?? [];
-      if (rows.length === 0 || rows.length > 1) {
-        throw new RagableError(
+    const many = await this.executeMany();
+    if (many.error) return { data: null, error: many.error };
+    const rows = many.data ?? [];
+    if (rows.length === 0 || rows.length > 1) {
+      return {
+        data: null,
+        error: new RagableError(
           "JSON object requested, multiple (or no) rows returned",
           406,
           { code: "PGRST116" }
-        );
-      }
-      return rows[0];
-    });
+        )
+      };
+    }
+    return { data: rows[0], error: null };
   }
   async maybeSingle() {
-    return asPostgrestResponse(async () => {
-      const { data, error } = await this.executeMany();
-      if (error) throw error;
-      const rows = data ?? [];
-      if (rows.length > 1) {
-        throw new RagableError(
+    const many = await this.executeMany();
+    if (many.error) return { data: null, error: many.error };
+    const rows = many.data ?? [];
+    if (rows.length > 1) {
+      return {
+        data: null,
+        error: new RagableError(
           "JSON object requested, multiple (or no) rows returned",
           406,
           { code: "PGRST116" }
-        );
-      }
-      return rows[0] ?? null;
-    });
+        )
+      };
+    }
+    return { data: rows[0] ?? null, error: null };
   }
 };
 var PostgrestTableApi = class {
@@ -1506,11 +1540,14 @@ var PostgrestTableApi = class {
   }
   insert(values, ...rest) {
     if (rest.length > 0) {
-      throw new RagableError(
+      const err = new RagableError(
         ".insert() accepts only one argument: the row object or an array of rows. Do not pass readOnly, options, or a second object \u2014 those apply only to database.query({ sql, readOnly }). PostgREST inserts are writes by default.",
         400,
         { code: "SDK_INSERT_EXTRA_ARGS" }
       );
+      return new PostgrestInsertSdkErrorRoot(
+        err
+      );
     }
     const rows = Array.isArray(values) ? values : [values];
     return new PostgrestInsertRootBuilder(
@@ -2125,14 +2162,6 @@ async function resolveDatabaseAuthBearer(options, ragableAuth) {
   }
   return key;
 }
-async function parseJsonOrThrow2(response) {
-  const payload = await parseMaybeJsonBody(response);
-  if (!response.ok) {
-    const message = extractErrorMessage(payload, response.statusText);
-    throw new RagableError(message, response.status, payload);
-  }
-  return payload;
-}
 var RagableBrowserAuthClient = class {
   constructor(_options, ragableAuth = null) {
     this.ragableAuth = ragableAuth;
@@ -2241,20 +2270,20 @@ var RagableBrowserDatabaseClient = class {
     this._transport = transport;
   }
   from(table, databaseInstanceId) {
-    const id = databaseInstanceId?.trim() || this.options.databaseInstanceId?.trim();
-    if (!id) {
-      throw new RagableError(
-        "database.from() requires databaseInstanceId in client options or as the second argument",
-        400,
-        { code: "SDK_MISSING_DATABASE_INSTANCE_ID" }
-      );
-    }
-    const gid = requireAuthGroupId(this.options);
+    const id = databaseInstanceId?.trim() || this.options.databaseInstanceId?.trim() || "";
     const ragableAuth = this.ragableAuth;
     const opts = this.options;
     const transport = this._transport;
     const fetchImpl = this.fetchImpl;
     const pgFetch = async (params) => {
+      if (!params.databaseInstanceId?.trim()) {
+        throw new RagableError(
+          "database.from() requires databaseInstanceId in client options or as the second argument",
+          400,
+          { code: "SDK_MISSING_DATABASE_INSTANCE_ID" }
+        );
+      }
+      const gid = requireAuthGroupId(opts);
       const token = await resolveDatabaseAuthBearer(opts, ragableAuth);
       const baseUrl = normalizeBrowserApiBase(opts.baseUrl);
       const qs = params.searchParams.toString();
@@ -2293,36 +2322,43 @@ var RagableBrowserDatabaseClient = class {
     return `${normalizeBrowserApiBase(this.options.baseUrl)}${path.startsWith("/") ? path : `/${path}`}`;
   }
   async query(params) {
-    const gid = requireAuthGroupId(this.options);
-    const token = await resolveDatabaseAuthBearer(this.options, this.ragableAuth);
-    const databaseInstanceId = params.databaseInstanceId?.trim() || this.options.databaseInstanceId?.trim();
-    if (!databaseInstanceId) {
-      throw new RagableError(
-        "database.query requires databaseInstanceId in the request or on createBrowserClient({ databaseInstanceId })",
-        400,
-        { code: "SDK_MISSING_DATABASE_INSTANCE_ID" }
+    return asPostgrestResponse(async () => {
+      const gid = requireAuthGroupId(this.options);
+      const token = await resolveDatabaseAuthBearer(this.options, this.ragableAuth);
+      const databaseInstanceId = params.databaseInstanceId?.trim() || this.options.databaseInstanceId?.trim();
+      if (!databaseInstanceId) {
+        throw new RagableError(
+          "database.query requires databaseInstanceId in the request or on createBrowserClient({ databaseInstanceId })",
+          400,
+          { code: "SDK_MISSING_DATABASE_INSTANCE_ID" }
+        );
+      }
+      const headers = this.baseHeaders();
+      headers.set("Authorization", `Bearer ${token}`);
+      headers.set("Content-Type", "application/json");
+      const readOnly = (this.options.dataAuth ?? "user") === "publicAnon" ? true : params.readOnly !== false;
+      const response = await this.fetchImpl(
+        this.toUrl(`/auth-groups/${gid}/data/query`),
+        {
+          method: "POST",
+          headers,
+          body: JSON.stringify({
+            databaseInstanceId,
+            sql: params.sql,
+            ...params.params !== void 0 ? { params: params.params } : {},
+            readOnly,
+            ...params.timeoutMs !== void 0 ? { timeoutMs: params.timeoutMs } : {},
+            ...params.rowLimit !== void 0 ? { rowLimit: params.rowLimit } : {}
+          })
+        }
       );
-    }
-    const headers = this.baseHeaders();
-    headers.set("Authorization", `Bearer ${token}`);
-    headers.set("Content-Type", "application/json");
-    const readOnly = (this.options.dataAuth ?? "user") === "publicAnon" ? true : params.readOnly !== false;
-    const response = await this.fetchImpl(
-      this.toUrl(`/auth-groups/${gid}/data/query`),
-      {
-        method: "POST",
-        headers,
-        body: JSON.stringify({
-          databaseInstanceId,
-          sql: params.sql,
-          ...params.params !== void 0 ? { params: params.params } : {},
-          readOnly,
-          ...params.timeoutMs !== void 0 ? { timeoutMs: params.timeoutMs } : {},
-          ...params.rowLimit !== void 0 ? { rowLimit: params.rowLimit } : {}
-        })
+      const payload = await parseMaybeJsonBody(response);
+      if (!response.ok) {
+        const message = extractErrorMessage(payload, response.statusText);
+        throw new RagableError(message, response.status, payload);
       }
-    );
-    return parseJsonOrThrow2(response);
+      return payload;
+    });
   }
   baseHeaders() {
     return new Headers(this.options.headers);
@@ -2521,6 +2557,8 @@ function createRagableServerClient(options) {
   PostgrestDeleteRootBuilder,
   PostgrestInsertReturningBuilder,
   PostgrestInsertRootBuilder,
+  PostgrestInsertSdkErrorReturning,
+  PostgrestInsertSdkErrorRoot,
   PostgrestSelectBuilder,
   PostgrestTableApi,
   PostgrestUpdateReturningBuilder,