@ragable/sdk 0.6.4 → 0.6.6

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;
@@ -2229,59 +2258,107 @@ var RagableBrowserAuthClient = class {
   }
 };
 var RagableBrowserDatabaseClient = class {
-  constructor(options, ragableAuth = null, postgrestFrom) {
+  constructor(options, ragableAuth = null) {
     this.options = options;
     this.ragableAuth = ragableAuth;
-    this.postgrestFrom = postgrestFrom;
     __publicField(this, "fetchImpl");
+    __publicField(this, "_transport", null);
     this.fetchImpl = bindFetch(options.fetch);
   }
-  /**
-   * PostgREST fluent API — same as `client.from('table')`.
-   * Use either the root client or `database` for Supabase-style table access; `database.query()` is raw SQL only.
-   */
+  /** @internal Called by RagableBrowser to share the Transport instance. */
+  _setTransport(transport) {
+    this._transport = transport;
+  }
   from(table, databaseInstanceId) {
-    if (!this.postgrestFrom) {
-      throw new RagableError(
-        "database.from() is only available on the client from createBrowserClient().",
-        500,
-        { code: "SDK_DATABASE_FROM_UNAVAILABLE" }
-      );
-    }
-    return this.postgrestFrom(table, databaseInstanceId);
+    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();
+      const url = `${baseUrl}/auth-groups/${gid}/data/rest/${params.table}${qs ? `?${qs}` : ""}`;
+      const headers = new Headers(opts.headers);
+      headers.set("Authorization", `Bearer ${token}`);
+      headers.set("X-Database-Instance-Id", params.databaseInstanceId);
+      if (params.body !== void 0) {
+        headers.set("Content-Type", "application/json");
+      }
+      if (params.headers) {
+        for (const [k, v] of Object.entries(params.headers)) {
+          headers.set(k, v);
+        }
+      }
+      if (transport) {
+        return transport.execute({
+          url,
+          method: params.method,
+          headers,
+          body: params.body !== void 0 ? JSON.stringify(params.body) : void 0,
+          signal: params.signal,
+          idempotencyKey: params.idempotencyKey
+        });
+      }
+      return fetchImpl(url, {
+        method: params.method,
+        headers,
+        body: params.body !== void 0 ? JSON.stringify(params.body) : void 0,
+        signal: params.signal
+      });
+    };
+    return new PostgrestTableApi(pgFetch, id, table);
   }
   toUrl(path) {
     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 Error(
-        "database.query requires databaseInstanceId in the request or on createBrowserClient({ databaseInstanceId })"
+    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);
@@ -2332,9 +2409,7 @@ var RagableBrowser = class {
     __publicField(this, "auth");
     __publicField(this, "database");
     __publicField(this, "transport");
-    __publicField(this, "options");
     __publicField(this, "_ragableAuth");
-    this.options = options;
     this.transport = new Transport({
       fetch: options.fetch,
       headers: options.headers,
@@ -2365,49 +2440,13 @@ var RagableBrowser = class {
     this.auth = new RagableBrowserAuthClient(options, this._ragableAuth);
     this.database = new RagableBrowserDatabaseClient(
       options,
-      this._ragableAuth,
-      (table, databaseInstanceId) => this.from(table, databaseInstanceId)
+      this._ragableAuth
     );
+    this.database._setTransport(this.transport);
   }
+  /** Delegates to `database.from()`. Kept for back-compat — prefer `database.from()`. */
   from(table, databaseInstanceId) {
-    const id = databaseInstanceId?.trim() || this.options.databaseInstanceId?.trim();
-    if (!id) {
-      throw new RagableError(
-        "RagableBrowser.from() requires databaseInstanceId in client options or as the second argument",
-        400,
-        { code: "SDK_MISSING_DATABASE_INSTANCE_ID" }
-      );
-    }
-    const gid = requireAuthGroupId(this.options);
-    const ragableAuth = this._ragableAuth;
-    const opts = this.options;
-    const transport = this.transport;
-    const pgFetch = async (params) => {
-      const token = await resolveDatabaseAuthBearer(opts, ragableAuth);
-      const baseUrl = normalizeBrowserApiBase(opts.baseUrl);
-      const qs = params.searchParams.toString();
-      const url = `${baseUrl}/auth-groups/${gid}/data/rest/${params.table}${qs ? `?${qs}` : ""}`;
-      const headers = new Headers(opts.headers);
-      headers.set("Authorization", `Bearer ${token}`);
-      headers.set("X-Database-Instance-Id", params.databaseInstanceId);
-      if (params.body !== void 0) {
-        headers.set("Content-Type", "application/json");
-      }
-      if (params.headers) {
-        for (const [k, v] of Object.entries(params.headers)) {
-          headers.set(k, v);
-        }
-      }
-      return transport.execute({
-        url,
-        method: params.method,
-        headers,
-        body: params.body !== void 0 ? JSON.stringify(params.body) : void 0,
-        signal: params.signal,
-        idempotencyKey: params.idempotencyKey
-      });
-    };
-    return new PostgrestTableApi(pgFetch, id, table);
+    return this.database.from(table, databaseInstanceId);
   }
   destroy() {
     this._ragableAuth?.destroy();
@@ -2518,6 +2557,8 @@ function createRagableServerClient(options) {
   PostgrestDeleteRootBuilder,
   PostgrestInsertReturningBuilder,
   PostgrestInsertRootBuilder,
+  PostgrestInsertSdkErrorReturning,
+  PostgrestInsertSdkErrorRoot,
   PostgrestSelectBuilder,
   PostgrestTableApi,
   PostgrestUpdateReturningBuilder,