@ragable/sdk 0.6.2 → 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,
@@ -2413,6 +2447,7 @@ export {
   detectStorage,
   extractErrorMessage,
   formatRetrievalContext,
+  formatSdkError,
   generateIdempotencyKey,
   normalizeBrowserApiBase,
   parseSseDataLine,