@ragable/sdk 0.6.2 → 0.6.4

package/dist/index.mjs

@@ -14,6 +14,12 @@ var RagableSdkError = class extends Error {
   constructor(message) {
     super(message);
     this.name = this.constructor.name;
+    Object.defineProperty(this, "message", {
+      configurable: true,
+      enumerable: true,
+      writable: true,
+      value: message
+    });
   }
   toJSON() {
     return {
@@ -33,7 +39,7 @@ var RagableError = class extends RagableSdkError {
     __publicField(this, "details");
     this.status = status;
     this.body = body;
-    this.code = body && typeof body === "object" ? typeof body.code === "string" ? body.code : void 0 : void 0;
+    this.code = body && typeof body === "object" ? typeof body.code === "string" ? body.code : typeof body.code === "number" ? String(body.code) : void 0 : void 0;
     this.details = body && typeof body === "object" ? typeof body.details === "string" ? body.details : void 0 : void 0;
   }
   toJSON() {
@@ -45,7 +51,38 @@ 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;
+      return "Unknown error (empty object \u2014 avoid `{...error}` spread; use error.message or formatSdkError)";
+    } catch {
+    }
+  }
+  return String(err);
+}
+function formatPostgrestError(error) {
+  return formatSdkError(error);
+}
 var RagableNetworkError = class extends RagableSdkError {
   constructor(message, cause) {
     super(message);
@@ -615,6 +652,27 @@ function encodeFilterValue(op, value) {
   }
   return `${op}.${value}`;
 }
+function extractPostgRESTErrorMessage(payload, status, statusText) {
+  const st = (statusText ?? "").trim();
+  if (typeof payload !== "object" || payload === null) {
+    return st || `HTTP ${status}`;
+  }
+  const p = payload;
+  const raw = p.message ?? p.error ?? p.hint;
+  let msg;
+  if (typeof raw === "string") {
+    msg = raw;
+  } else if (typeof raw === "number" || typeof raw === "boolean") {
+    msg = String(raw);
+  } else if (raw !== null && raw !== void 0 && typeof raw === "object") {
+    msg = JSON.stringify(raw);
+  } else {
+    msg = st || `HTTP ${status}`;
+  }
+  msg = msg.trim();
+  if (!msg) return st || `HTTP ${status}`;
+  return msg;
+}
 async function parsePostgRESTResponse(response) {
   if (response.status === 204) return null;
   const text = await response.text();
@@ -630,9 +688,8 @@ async function parsePostgRESTResponse(response) {
     );
   }
   if (!response.ok) {
-    const msg = typeof payload === "object" && payload !== null ? payload.message ?? payload.error ?? response.statusText : response.statusText;
-    const code = typeof payload === "object" && payload !== null ? payload.code : void 0;
-    throw new RagableError(String(msg), response.status, { code });
+    const msg = extractPostgRESTErrorMessage(payload, response.status, response.statusText);
+    throw new RagableError(msg, response.status, payload);
   }
   return payload;
 }
@@ -1376,7 +1433,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,
@@ -2412,7 +2476,9 @@ export {
   createRagableServerClient,
   detectStorage,
   extractErrorMessage,
+  formatPostgrestError,
   formatRetrievalContext,
+  formatSdkError,
   generateIdempotencyKey,
   normalizeBrowserApiBase,
   parseSseDataLine,