@paykit-sdk/react 1.1.96 → 1.2.0

package/dist/resources/checkout.mjs

@@ -6,9 +6,46 @@ var PaykitContext = React.createContext(void 0);
 var usePaykitContext = () => {
   const ctx = React.useContext(PaykitContext);
   if (!ctx)
-    throw new Error("Your app must be wrapped in PayKitProvider to use PayKit hooks.");
+    throw new Error(
+      "Your app must be wrapped in PayKitProvider to use PayKit hooks."
+    );
   return ctx;
 };
+
+// src/util.ts
+var PayKitClientError = class extends Error {
+  constructor(errorData) {
+    super(errorData.message);
+    this.name = "PayKitClientError";
+    this.code = errorData.code;
+    this.statusCode = errorData.statusCode;
+    this.provider = errorData.provider;
+    this.method = errorData.method;
+    this.context = errorData.context;
+  }
+};
+var parsePayKitClientError = (response, errorData) => {
+  if (errorData && typeof errorData === "object" && "message" in errorData) {
+    const data = errorData;
+    return new PayKitClientError({
+      message: data.message,
+      code: data.code,
+      statusCode: data.statusCode || response.status,
+      provider: data.provider,
+      method: data.method,
+      context: data.context
+    });
+  }
+  return new PayKitClientError({
+    message: typeof errorData === "string" ? errorData : (errorData == null ? void 0 : errorData.message) || `HTTP ${response.status}: ${response.statusText}`,
+    statusCode: response.status,
+    provider: errorData == null ? void 0 : errorData.provider,
+    method: errorData == null ? void 0 : errorData.method,
+    context: errorData == null ? void 0 : errorData.context
+  });
+};
+
+// src/hooks/use-async-fn.ts
 var useAsyncFn = (path, apiUrl, headersEsque) => {
   const [loading, setLoading] = React.useState(false);
   const run = React.useCallback(
@@ -16,22 +53,37 @@ var useAsyncFn = (path, apiUrl, headersEsque) => {
       setLoading(true);
       try {
         const headers = typeof headersEsque === "function" ? headersEsque() : headersEsque != null ? headersEsque : {};
-        const response = await fetch(`${apiUrl}${path}`, {
+        const res = await fetch(`${apiUrl}${path}`, {
           method: "POST",
           headers: { "Content-Type": "application/json", ...headers },
           credentials: "include",
           body: JSON.stringify({ args })
         });
-        if (!response.ok) {
-          const errorData = await response.json().catch(() => ({ message: "Request failed" }));
-          throw new Error(errorData.message || `HTTP ${response.status}`);
+        if (!res.ok) {
+          const errorData = await res.json().catch(() => ({
+            message: res.statusText || "Request failed"
+          }));
+          throw parsePayKitClientError(res, errorData);
         }
-        const data = await response.json();
-        setLoading(false);
-        return [data.result, void 0];
-      } catch (error) {
+        const response = await res.json();
+        if (typeof response === "object" && "result" in response) {
+          return [response.result, void 0];
+        }
+        throw new PayKitClientError({
+          message: "Unknown response format (API must return JSON with a top-level 'result' property)",
+          statusCode: 500,
+          context: {
+            response: JSON.stringify(response, null, 2)
+          }
+        });
+      } catch (err) {
+        const error = err instanceof PayKitClientError ? err : new PayKitClientError({
+          message: err instanceof Error ? err.message : "An unexpected error occurred",
+          statusCode: err instanceof Error ? 0 : 500
+        });
+        return [void 0, error];
+      } finally {
         setLoading(false);
-        return [void 0, error instanceof Error ? error : new Error(String(error))];
       }
     },
     [path, apiUrl, headersEsque]

package/dist/resources/customer.d.mts

@@ -1,20 +1,21 @@
 import * as _paykit_sdk_core from '@paykit-sdk/core';
+import { PayKitClientError } from '../util.mjs';
 
 declare const useCustomer: () => {
     retrieve: {
-        run: (id: string) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Customer | null, error: undefined]>;
+        run: (id: string) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Customer | null, error: undefined]>;
         loading: boolean;
     };
     create: {
-        run: (params: _paykit_sdk_core.CreateCustomerParams) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Customer, error: undefined]>;
+        run: (params: _paykit_sdk_core.CreateCustomerParams<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Customer, error: undefined]>;
         loading: boolean;
     };
     update: {
-        run: (id: string, params: _paykit_sdk_core.UpdateCustomerParams) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Customer, error: undefined]>;
+        run: (id: string, params: _paykit_sdk_core.UpdateCustomerParams<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Customer, error: undefined]>;
         loading: boolean;
     };
     remove: {
-        run: (id: string) => Promise<[data: undefined, error: Error] | [data: null, error: undefined]>;
+        run: (id: string) => Promise<[data: undefined, error: PayKitClientError] | [data: null, error: undefined]>;
         loading: boolean;
     };
 };

package/dist/resources/customer.d.ts

@@ -1,20 +1,21 @@
 import * as _paykit_sdk_core from '@paykit-sdk/core';
+import { PayKitClientError } from '../util.js';
 
 declare const useCustomer: () => {
     retrieve: {
-        run: (id: string) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Customer | null, error: undefined]>;
+        run: (id: string) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Customer | null, error: undefined]>;
         loading: boolean;
     };
     create: {
-        run: (params: _paykit_sdk_core.CreateCustomerParams) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Customer, error: undefined]>;
+        run: (params: _paykit_sdk_core.CreateCustomerParams<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Customer, error: undefined]>;
         loading: boolean;
     };
     update: {
-        run: (id: string, params: _paykit_sdk_core.UpdateCustomerParams) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Customer, error: undefined]>;
+        run: (id: string, params: _paykit_sdk_core.UpdateCustomerParams<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Customer, error: undefined]>;
         loading: boolean;
     };
     remove: {
-        run: (id: string) => Promise<[data: undefined, error: Error] | [data: null, error: undefined]>;
+        run: (id: string) => Promise<[data: undefined, error: PayKitClientError] | [data: null, error: undefined]>;
         loading: boolean;
     };
 };

package/dist/resources/customer.js

@@ -28,9 +28,46 @@ var PaykitContext = React__namespace.createContext(void 0);
 var usePaykitContext = () => {
   const ctx = React__namespace.useContext(PaykitContext);
   if (!ctx)
-    throw new Error("Your app must be wrapped in PayKitProvider to use PayKit hooks.");
+    throw new Error(
+      "Your app must be wrapped in PayKitProvider to use PayKit hooks."
+    );
   return ctx;
 };
+
+// src/util.ts
+var PayKitClientError = class extends Error {
+  constructor(errorData) {
+    super(errorData.message);
+    this.name = "PayKitClientError";
+    this.code = errorData.code;
+    this.statusCode = errorData.statusCode;
+    this.provider = errorData.provider;
+    this.method = errorData.method;
+    this.context = errorData.context;
+  }
+};
+var parsePayKitClientError = (response, errorData) => {
+  if (errorData && typeof errorData === "object" && "message" in errorData) {
+    const data = errorData;
+    return new PayKitClientError({
+      message: data.message,
+      code: data.code,
+      statusCode: data.statusCode || response.status,
+      provider: data.provider,
+      method: data.method,
+      context: data.context
+    });
+  }
+  return new PayKitClientError({
+    message: typeof errorData === "string" ? errorData : (errorData == null ? void 0 : errorData.message) || `HTTP ${response.status}: ${response.statusText}`,
+    statusCode: response.status,
+    provider: errorData == null ? void 0 : errorData.provider,
+    method: errorData == null ? void 0 : errorData.method,
+    context: errorData == null ? void 0 : errorData.context
+  });
+};
+
+// src/hooks/use-async-fn.ts
 var useAsyncFn = (path, apiUrl, headersEsque) => {
   const [loading, setLoading] = React__namespace.useState(false);
   const run = React__namespace.useCallback(
@@ -38,22 +75,37 @@ var useAsyncFn = (path, apiUrl, headersEsque) => {
       setLoading(true);
       try {
         const headers = typeof headersEsque === "function" ? headersEsque() : headersEsque != null ? headersEsque : {};
-        const response = await fetch(`${apiUrl}${path}`, {
+        const res = await fetch(`${apiUrl}${path}`, {
           method: "POST",
           headers: { "Content-Type": "application/json", ...headers },
           credentials: "include",
           body: JSON.stringify({ args })
         });
-        if (!response.ok) {
-          const errorData = await response.json().catch(() => ({ message: "Request failed" }));
-          throw new Error(errorData.message || `HTTP ${response.status}`);
+        if (!res.ok) {
+          const errorData = await res.json().catch(() => ({
+            message: res.statusText || "Request failed"
+          }));
+          throw parsePayKitClientError(res, errorData);
         }
-        const data = await response.json();
-        setLoading(false);
-        return [data.result, void 0];
-      } catch (error) {
+        const response = await res.json();
+        if (typeof response === "object" && "result" in response) {
+          return [response.result, void 0];
+        }
+        throw new PayKitClientError({
+          message: "Unknown response format (API must return JSON with a top-level 'result' property)",
+          statusCode: 500,
+          context: {
+            response: JSON.stringify(response, null, 2)
+          }
+        });
+      } catch (err) {
+        const error = err instanceof PayKitClientError ? err : new PayKitClientError({
+          message: err instanceof Error ? err.message : "An unexpected error occurred",
+          statusCode: err instanceof Error ? 0 : 500
+        });
+        return [void 0, error];
+      } finally {
         setLoading(false);
-        return [void 0, error instanceof Error ? error : new Error(String(error))];
       }
     },
     [path, apiUrl, headersEsque]

package/dist/resources/customer.mjs

@@ -6,9 +6,46 @@ var PaykitContext = React.createContext(void 0);
 var usePaykitContext = () => {
   const ctx = React.useContext(PaykitContext);
   if (!ctx)
-    throw new Error("Your app must be wrapped in PayKitProvider to use PayKit hooks.");
+    throw new Error(
+      "Your app must be wrapped in PayKitProvider to use PayKit hooks."
+    );
   return ctx;
 };
+
+// src/util.ts
+var PayKitClientError = class extends Error {
+  constructor(errorData) {
+    super(errorData.message);
+    this.name = "PayKitClientError";
+    this.code = errorData.code;
+    this.statusCode = errorData.statusCode;
+    this.provider = errorData.provider;
+    this.method = errorData.method;
+    this.context = errorData.context;
+  }
+};
+var parsePayKitClientError = (response, errorData) => {
+  if (errorData && typeof errorData === "object" && "message" in errorData) {
+    const data = errorData;
+    return new PayKitClientError({
+      message: data.message,
+      code: data.code,
+      statusCode: data.statusCode || response.status,
+      provider: data.provider,
+      method: data.method,
+      context: data.context
+    });
+  }
+  return new PayKitClientError({
+    message: typeof errorData === "string" ? errorData : (errorData == null ? void 0 : errorData.message) || `HTTP ${response.status}: ${response.statusText}`,
+    statusCode: response.status,
+    provider: errorData == null ? void 0 : errorData.provider,
+    method: errorData == null ? void 0 : errorData.method,
+    context: errorData == null ? void 0 : errorData.context
+  });
+};
+
+// src/hooks/use-async-fn.ts
 var useAsyncFn = (path, apiUrl, headersEsque) => {
   const [loading, setLoading] = React.useState(false);
   const run = React.useCallback(
@@ -16,22 +53,37 @@ var useAsyncFn = (path, apiUrl, headersEsque) => {
       setLoading(true);
       try {
         const headers = typeof headersEsque === "function" ? headersEsque() : headersEsque != null ? headersEsque : {};
-        const response = await fetch(`${apiUrl}${path}`, {
+        const res = await fetch(`${apiUrl}${path}`, {
           method: "POST",
           headers: { "Content-Type": "application/json", ...headers },
           credentials: "include",
           body: JSON.stringify({ args })
         });
-        if (!response.ok) {
-          const errorData = await response.json().catch(() => ({ message: "Request failed" }));
-          throw new Error(errorData.message || `HTTP ${response.status}`);
+        if (!res.ok) {
+          const errorData = await res.json().catch(() => ({
+            message: res.statusText || "Request failed"
+          }));
+          throw parsePayKitClientError(res, errorData);
         }
-        const data = await response.json();
-        setLoading(false);
-        return [data.result, void 0];
-      } catch (error) {
+        const response = await res.json();
+        if (typeof response === "object" && "result" in response) {
+          return [response.result, void 0];
+        }
+        throw new PayKitClientError({
+          message: "Unknown response format (API must return JSON with a top-level 'result' property)",
+          statusCode: 500,
+          context: {
+            response: JSON.stringify(response, null, 2)
+          }
+        });
+      } catch (err) {
+        const error = err instanceof PayKitClientError ? err : new PayKitClientError({
+          message: err instanceof Error ? err.message : "An unexpected error occurred",
+          statusCode: err instanceof Error ? 0 : 500
+        });
+        return [void 0, error];
+      } finally {
         setLoading(false);
-        return [void 0, error instanceof Error ? error : new Error(String(error))];
       }
     },
     [path, apiUrl, headersEsque]

package/dist/resources/payment.d.mts

@@ -1,29 +1,30 @@
+import { PayKitClientError } from '../util.mjs';
 import * as _paykit_sdk_core from '@paykit-sdk/core';
 import { Payment } from '@paykit-sdk/core';
 
 declare const usePayment: () => {
     create: {
-        run: (params: _paykit_sdk_core.CreatePaymentSchema) => Promise<[data: undefined, error: Error] | [data: Payment, error: undefined]>;
+        run: (params: _paykit_sdk_core.CreatePaymentSchema<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: Payment, error: undefined]>;
         loading: boolean;
     };
     retrieve: {
-        run: (id: string) => Promise<[data: undefined, error: Error] | [data: Payment | null, error: undefined]>;
+        run: (id: string) => Promise<[data: undefined, error: PayKitClientError] | [data: Payment | null, error: undefined]>;
         loading: boolean;
     };
     update: {
-        run: (id: string, params: _paykit_sdk_core.UpdatePaymentSchema) => Promise<[data: undefined, error: Error] | [data: Payment, error: undefined]>;
+        run: (id: string, params: _paykit_sdk_core.UpdatePaymentSchema<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: Payment, error: undefined]>;
         loading: boolean;
     };
     remove: {
-        run: (id: string) => Promise<[data: undefined, error: Error] | [data: null, error: undefined]>;
+        run: (id: string) => Promise<[data: undefined, error: PayKitClientError] | [data: null, error: undefined]>;
         loading: boolean;
     };
     capture: {
-        run: (id: string, params: _paykit_sdk_core.CapturePaymentSchema) => Promise<[data: undefined, error: Error] | [data: Payment, error: undefined]>;
+        run: (id: string, params: _paykit_sdk_core.CapturePaymentSchema) => Promise<[data: undefined, error: PayKitClientError] | [data: Payment, error: undefined]>;
         loading: boolean;
     };
     cancel: {
-        run: (args_0: string) => Promise<[data: undefined, error: Error] | [data: Payment, error: undefined]>;
+        run: (args_0: string) => Promise<[data: undefined, error: PayKitClientError] | [data: Payment, error: undefined]>;
         loading: boolean;
     };
 };

package/dist/resources/payment.d.ts

@@ -1,29 +1,30 @@
+import { PayKitClientError } from '../util.js';
 import * as _paykit_sdk_core from '@paykit-sdk/core';
 import { Payment } from '@paykit-sdk/core';
 
 declare const usePayment: () => {
     create: {
-        run: (params: _paykit_sdk_core.CreatePaymentSchema) => Promise<[data: undefined, error: Error] | [data: Payment, error: undefined]>;
+        run: (params: _paykit_sdk_core.CreatePaymentSchema<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: Payment, error: undefined]>;
         loading: boolean;
     };
     retrieve: {
-        run: (id: string) => Promise<[data: undefined, error: Error] | [data: Payment | null, error: undefined]>;
+        run: (id: string) => Promise<[data: undefined, error: PayKitClientError] | [data: Payment | null, error: undefined]>;
         loading: boolean;
     };
     update: {
-        run: (id: string, params: _paykit_sdk_core.UpdatePaymentSchema) => Promise<[data: undefined, error: Error] | [data: Payment, error: undefined]>;
+        run: (id: string, params: _paykit_sdk_core.UpdatePaymentSchema<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: Payment, error: undefined]>;
         loading: boolean;
     };
     remove: {
-        run: (id: string) => Promise<[data: undefined, error: Error] | [data: null, error: undefined]>;
+        run: (id: string) => Promise<[data: undefined, error: PayKitClientError] | [data: null, error: undefined]>;
         loading: boolean;
     };
     capture: {
-        run: (id: string, params: _paykit_sdk_core.CapturePaymentSchema) => Promise<[data: undefined, error: Error] | [data: Payment, error: undefined]>;
+        run: (id: string, params: _paykit_sdk_core.CapturePaymentSchema) => Promise<[data: undefined, error: PayKitClientError] | [data: Payment, error: undefined]>;
         loading: boolean;
     };
     cancel: {
-        run: (args_0: string) => Promise<[data: undefined, error: Error] | [data: Payment, error: undefined]>;
+        run: (args_0: string) => Promise<[data: undefined, error: PayKitClientError] | [data: Payment, error: undefined]>;
         loading: boolean;
     };
 };

package/dist/resources/payment.js

@@ -28,9 +28,46 @@ var PaykitContext = React__namespace.createContext(void 0);
 var usePaykitContext = () => {
   const ctx = React__namespace.useContext(PaykitContext);
   if (!ctx)
-    throw new Error("Your app must be wrapped in PayKitProvider to use PayKit hooks.");
+    throw new Error(
+      "Your app must be wrapped in PayKitProvider to use PayKit hooks."
+    );
   return ctx;
 };
+
+// src/util.ts
+var PayKitClientError = class extends Error {
+  constructor(errorData) {
+    super(errorData.message);
+    this.name = "PayKitClientError";
+    this.code = errorData.code;
+    this.statusCode = errorData.statusCode;
+    this.provider = errorData.provider;
+    this.method = errorData.method;
+    this.context = errorData.context;
+  }
+};
+var parsePayKitClientError = (response, errorData) => {
+  if (errorData && typeof errorData === "object" && "message" in errorData) {
+    const data = errorData;
+    return new PayKitClientError({
+      message: data.message,
+      code: data.code,
+      statusCode: data.statusCode || response.status,
+      provider: data.provider,
+      method: data.method,
+      context: data.context
+    });
+  }
+  return new PayKitClientError({
+    message: typeof errorData === "string" ? errorData : (errorData == null ? void 0 : errorData.message) || `HTTP ${response.status}: ${response.statusText}`,
+    statusCode: response.status,
+    provider: errorData == null ? void 0 : errorData.provider,
+    method: errorData == null ? void 0 : errorData.method,
+    context: errorData == null ? void 0 : errorData.context
+  });
+};
+
+// src/hooks/use-async-fn.ts
 var useAsyncFn = (path, apiUrl, headersEsque) => {
   const [loading, setLoading] = React__namespace.useState(false);
   const run = React__namespace.useCallback(
@@ -38,22 +75,37 @@ var useAsyncFn = (path, apiUrl, headersEsque) => {
       setLoading(true);
       try {
         const headers = typeof headersEsque === "function" ? headersEsque() : headersEsque != null ? headersEsque : {};
-        const response = await fetch(`${apiUrl}${path}`, {
+        const res = await fetch(`${apiUrl}${path}`, {
           method: "POST",
           headers: { "Content-Type": "application/json", ...headers },
           credentials: "include",
           body: JSON.stringify({ args })
         });
-        if (!response.ok) {
-          const errorData = await response.json().catch(() => ({ message: "Request failed" }));
-          throw new Error(errorData.message || `HTTP ${response.status}`);
+        if (!res.ok) {
+          const errorData = await res.json().catch(() => ({
+            message: res.statusText || "Request failed"
+          }));
+          throw parsePayKitClientError(res, errorData);
         }
-        const data = await response.json();
-        setLoading(false);
-        return [data.result, void 0];
-      } catch (error) {
+        const response = await res.json();
+        if (typeof response === "object" && "result" in response) {
+          return [response.result, void 0];
+        }
+        throw new PayKitClientError({
+          message: "Unknown response format (API must return JSON with a top-level 'result' property)",
+          statusCode: 500,
+          context: {
+            response: JSON.stringify(response, null, 2)
+          }
+        });
+      } catch (err) {
+        const error = err instanceof PayKitClientError ? err : new PayKitClientError({
+          message: err instanceof Error ? err.message : "An unexpected error occurred",
+          statusCode: err instanceof Error ? 0 : 500
+        });
+        return [void 0, error];
+      } finally {
         setLoading(false);
-        return [void 0, error instanceof Error ? error : new Error(String(error))];
       }
     },
     [path, apiUrl, headersEsque]

package/dist/resources/payment.mjs

@@ -6,9 +6,46 @@ var PaykitContext = React.createContext(void 0);
 var usePaykitContext = () => {
   const ctx = React.useContext(PaykitContext);
   if (!ctx)
-    throw new Error("Your app must be wrapped in PayKitProvider to use PayKit hooks.");
+    throw new Error(
+      "Your app must be wrapped in PayKitProvider to use PayKit hooks."
+    );
   return ctx;
 };
+
+// src/util.ts
+var PayKitClientError = class extends Error {
+  constructor(errorData) {
+    super(errorData.message);
+    this.name = "PayKitClientError";
+    this.code = errorData.code;
+    this.statusCode = errorData.statusCode;
+    this.provider = errorData.provider;
+    this.method = errorData.method;
+    this.context = errorData.context;
+  }
+};
+var parsePayKitClientError = (response, errorData) => {
+  if (errorData && typeof errorData === "object" && "message" in errorData) {
+    const data = errorData;
+    return new PayKitClientError({
+      message: data.message,
+      code: data.code,
+      statusCode: data.statusCode || response.status,
+      provider: data.provider,
+      method: data.method,
+      context: data.context
+    });
+  }
+  return new PayKitClientError({
+    message: typeof errorData === "string" ? errorData : (errorData == null ? void 0 : errorData.message) || `HTTP ${response.status}: ${response.statusText}`,
+    statusCode: response.status,
+    provider: errorData == null ? void 0 : errorData.provider,
+    method: errorData == null ? void 0 : errorData.method,
+    context: errorData == null ? void 0 : errorData.context
+  });
+};
+
+// src/hooks/use-async-fn.ts
 var useAsyncFn = (path, apiUrl, headersEsque) => {
   const [loading, setLoading] = React.useState(false);
   const run = React.useCallback(
@@ -16,22 +53,37 @@ var useAsyncFn = (path, apiUrl, headersEsque) => {
       setLoading(true);
       try {
         const headers = typeof headersEsque === "function" ? headersEsque() : headersEsque != null ? headersEsque : {};
-        const response = await fetch(`${apiUrl}${path}`, {
+        const res = await fetch(`${apiUrl}${path}`, {
           method: "POST",
           headers: { "Content-Type": "application/json", ...headers },
           credentials: "include",
           body: JSON.stringify({ args })
         });
-        if (!response.ok) {
-          const errorData = await response.json().catch(() => ({ message: "Request failed" }));
-          throw new Error(errorData.message || `HTTP ${response.status}`);
+        if (!res.ok) {
+          const errorData = await res.json().catch(() => ({
+            message: res.statusText || "Request failed"
+          }));
+          throw parsePayKitClientError(res, errorData);
         }
-        const data = await response.json();
-        setLoading(false);
-        return [data.result, void 0];
-      } catch (error) {
+        const response = await res.json();
+        if (typeof response === "object" && "result" in response) {
+          return [response.result, void 0];
+        }
+        throw new PayKitClientError({
+          message: "Unknown response format (API must return JSON with a top-level 'result' property)",
+          statusCode: 500,
+          context: {
+            response: JSON.stringify(response, null, 2)
+          }
+        });
+      } catch (err) {
+        const error = err instanceof PayKitClientError ? err : new PayKitClientError({
+          message: err instanceof Error ? err.message : "An unexpected error occurred",
+          statusCode: err instanceof Error ? 0 : 500
+        });
+        return [void 0, error];
+      } finally {
         setLoading(false);
-        return [void 0, error instanceof Error ? error : new Error(String(error))];
       }
     },
     [path, apiUrl, headersEsque]

package/dist/resources/refund.d.mts

@@ -1,8 +1,9 @@
+import { PayKitClientError } from '../util.mjs';
 import * as _paykit_sdk_core from '@paykit-sdk/core';
 
 declare const useRefund: () => {
     create: {
-        run: (params: _paykit_sdk_core.CreateRefundSchema) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Refund, error: undefined]>;
+        run: (params: _paykit_sdk_core.CreateRefundSchema<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Refund, error: undefined]>;
         loading: boolean;
     };
 };

package/dist/resources/refund.d.ts

@@ -1,8 +1,9 @@
+import { PayKitClientError } from '../util.js';
 import * as _paykit_sdk_core from '@paykit-sdk/core';
 
 declare const useRefund: () => {
     create: {
-        run: (params: _paykit_sdk_core.CreateRefundSchema) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Refund, error: undefined]>;
+        run: (params: _paykit_sdk_core.CreateRefundSchema<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Refund, error: undefined]>;
         loading: boolean;
     };
 };