prividium 0.6.0 → 0.7.0

package/dist/sdk/error-utils.d.ts

@@ -2,3 +2,10 @@
  * Checks if a Response contains a Prividium unauthorized/forbidden error.
  */
 export declare function hasPrividiumUnauthorizedError(response: Response): Promise<boolean>;
+/**
+ * Extracts a human-readable error string from a failed HTTP response.
+ * Attempts to parse the server's `{ error: { code, message } }` JSON structure,
+ * falls back to plain text, and ultimately to status + statusText.
+ * Never throws — always returns a usable string.
+ */
+export declare function extractResponseError(response: Response): Promise<string>;

package/dist/sdk/error-utils.js

@@ -7,6 +7,12 @@ const jsonRpcErrorSchema = z.object({
         data: z.unknown().optional()
     })
 });
+const apiErrorSchema = z.object({
+    error: z.object({
+        code: z.string(),
+        message: z.string()
+    })
+});
 /**
  * Checks if a Response contains a Prividium unauthorized/forbidden error.
  */
@@ -19,3 +25,35 @@ export async function hasPrividiumUnauthorizedError(response) {
     }
     return false;
 }
+/**
+ * Extracts a human-readable error string from a failed HTTP response.
+ * Attempts to parse the server's `{ error: { code, message } }` JSON structure,
+ * falls back to plain text, and ultimately to status + statusText.
+ * Never throws — always returns a usable string.
+ */
+export async function extractResponseError(response) {
+    const base = `${response.status} ${response.statusText}`;
+    try {
+        const cloned = response.clone();
+        const text = await cloned.text();
+        if (!text) {
+            return base;
+        }
+        try {
+            const json = JSON.parse(text);
+            const parsed = apiErrorSchema.safeParse(json);
+            if (parsed.success) {
+                const { code, message } = parsed.data.error;
+                return `${base}: ${message} (${code})`;
+            }
+        }
+        catch {
+            // Not JSON
+        }
+        return `${base}: ${text}`;
+    }
+    catch {
+        // Body unreadable
+    }
+    return base;
+}

package/dist/sdk/prividium-chain.js

@@ -1,7 +1,7 @@
 import { http } from 'viem';
 import { LocalStorage, TokenManager } from './storage.js';
 import { PopupAuth } from './popup-auth.js';
-import { hasPrividiumUnauthorizedError } from './error-utils.js';
+import { extractResponseError, hasPrividiumUnauthorizedError } from './error-utils.js';
 import { PrividiumSessionError } from './errors.js';
 import { buildChainObject, createApiMethods, rpcUrl } from './chain-core.js';
 export function createPrividiumChain(config) {
@@ -44,7 +44,8 @@ export function createPrividiumChain(config) {
             throw new PrividiumSessionError();
         }
         if (!response.ok) {
-            throw new Error(`Error calling ${url}: ${response.status} ${response.statusText}`);
+            const detail = await extractResponseError(response);
+            throw new Error(`Error calling ${url}: ${detail}`);
         }
         const parsed = schema.safeParse(await response.json());
         if (!parsed.success) {

package/dist/sdk/siwe-auth.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { extractResponseError } from './error-utils.js';
 const siweMessageResponseSchema = z.object({
     msg: z.string()
 });
@@ -19,8 +20,7 @@ export class SiweAuth {
     }
     async authorize() {
         // Step 1: Request SIWE message
-        const siweMessageUrl = new URL('/api/siwe-messages', this.config.prividiumApiBaseUrl).toString();
-        const siweResponse = await fetch(siweMessageUrl, {
+        const siweResponse = await fetch(new URL('/api/siwe-messages', this.config.prividiumApiBaseUrl), {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({
@@ -29,20 +29,21 @@ export class SiweAuth {
             })
         });
         if (!siweResponse.ok) {
-            throw new Error(`Failed to get SIWE message: ${siweResponse.status} ${siweResponse.statusText}`);
+            const detail = await extractResponseError(siweResponse);
+            throw new Error(`Failed to get SIWE message: ${detail}`);
         }
         const siweData = siweMessageResponseSchema.parse(await siweResponse.json());
         // Step 2: Sign the message
         const signature = await this.config.account.signMessage({ message: siweData.msg });
         // Step 3: Login
-        const loginUrl = new URL('/auth/login/crypto-native', this.config.prividiumApiBaseUrl).toString();
-        const loginResponse = await fetch(loginUrl, {
+        const loginResponse = await fetch(new URL('/api/auth/login/crypto-native', this.config.prividiumApiBaseUrl), {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({ message: siweData.msg, signature })
         });
         if (!loginResponse.ok) {
-            throw new Error(`SIWE login failed: ${loginResponse.status} ${loginResponse.statusText}`);
+            const detail = await extractResponseError(loginResponse);
+            throw new Error(`SIWE login failed: ${detail}`);
         }
         const loginJson = await loginResponse.json();
         // Check for MFA requirement (admin users with passkeys)

package/dist/sdk/siwe-chain.js

@@ -2,7 +2,7 @@ import { http } from 'viem';
 import { TokenManager } from './storage.js';
 import { MemoryStorage } from './memory-storage.js';
 import { SiweAuth } from './siwe-auth.js';
-import { hasPrividiumUnauthorizedError } from './error-utils.js';
+import { extractResponseError, hasPrividiumUnauthorizedError } from './error-utils.js';
 import { PrividiumSessionError } from './errors.js';
 import { buildChainObject, createApiMethods, rpcUrl } from './chain-core.js';
 export function createPrividiumSiweChain(config) {
@@ -102,7 +102,8 @@ export function createPrividiumSiweChain(config) {
             throw new PrividiumSessionError();
         }
         if (!response.ok) {
-            throw new Error(`Error calling ${url}: ${response.status} ${response.statusText}`);
+            const detail = await extractResponseError(response);
+            throw new Error(`Error calling ${url}: ${detail}`);
         }
         const parsed = schema.safeParse(await response.json());
         if (!parsed.success) {

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "prividium",
-  "version": "0.6.0",
+  "version": "0.7.0",
+  "type": "module",
   "bin": {
     "prividium": "bin/cli.js"
   },