@ragable/sdk 0.6.1 → 0.6.3

package/dist/index.mjs

@@ -45,7 +45,34 @@ var RagableError = class extends RagableSdkError {
       details: this.details
     };
   }
+  /** Stable string for logs — avoids `{}` when coercing or stringifying. */
+  toString() {
+    const bits = [`${this.name}: ${this.message}`];
+    if (this.status) bits.push(`status=${this.status}`);
+    if (this.code) bits.push(`code=${this.code}`);
+    return bits.join(" \xB7 ");
+  }
 };
+function formatSdkError(err) {
+  if (err instanceof RagableError) {
+    return `${err.message} (HTTP ${err.status}${err.code ? `, ${err.code}` : ""})`;
+  }
+  if (err instanceof RagableSdkError) {
+    return err.message;
+  }
+  if (err instanceof Error) {
+    return err.message || err.name;
+  }
+  if (typeof err === "string") return err;
+  if (err && typeof err === "object") {
+    try {
+      const s = JSON.stringify(err);
+      if (s !== "{}") return s;
+    } catch {
+    }
+  }
+  return String(err);
+}
 var RagableNetworkError = class extends RagableSdkError {
   constructor(message, cause) {
     super(message);
@@ -1376,7 +1403,14 @@ var PostgrestTableApi = class {
       columns
     );
   }
-  insert(values) {
+  insert(values, ...rest) {
+    if (rest.length > 0) {
+      throw 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" }
+      );
+    }
     const rows = Array.isArray(values) ? values : [values];
     return new PostgrestInsertRootBuilder(
       this.pgFetch,
@@ -2094,12 +2128,27 @@ var RagableBrowserAuthClient = class {
   }
 };
 var RagableBrowserDatabaseClient = class {
-  constructor(options, ragableAuth = null) {
+  constructor(options, ragableAuth = null, postgrestFrom) {
     this.options = options;
     this.ragableAuth = ragableAuth;
+    this.postgrestFrom = postgrestFrom;
     __publicField(this, "fetchImpl");
     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.
+   */
+  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);
+  }
   toUrl(path) {
     return `${normalizeBrowserApiBase(this.options.baseUrl)}${path.startsWith("/") ? path : `/${path}`}`;
   }
@@ -2213,7 +2262,11 @@ var RagableBrowser = class {
     }
     this.agents = new RagableBrowserAgentsClient(options);
     this.auth = new RagableBrowserAuthClient(options, this._ragableAuth);
-    this.database = new RagableBrowserDatabaseClient(options, this._ragableAuth);
+    this.database = new RagableBrowserDatabaseClient(
+      options,
+      this._ragableAuth,
+      (table, databaseInstanceId) => this.from(table, databaseInstanceId)
+    );
   }
   from(table, databaseInstanceId) {
     const id = databaseInstanceId?.trim() || this.options.databaseInstanceId?.trim();
@@ -2394,6 +2447,7 @@ export {
   detectStorage,
   extractErrorMessage,
   formatRetrievalContext,
+  formatSdkError,
   generateIdempotencyKey,
   normalizeBrowserApiBase,
   parseSseDataLine,