@paykit-sdk/react 1.1.96 → 1.1.97

package/dist/resources/refund.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/refund.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/subscription.d.mts

@@ -1,24 +1,25 @@
+import { PayKitClientError } from '../util.mjs';
 import * as _paykit_sdk_core from '@paykit-sdk/core';
 
 declare const useSubscription: () => {
     create: {
-        run: (params: _paykit_sdk_core.CreateSubscriptionSchema) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Subscription, error: undefined]>;
+        run: (params: _paykit_sdk_core.CreateSubscriptionSchema<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Subscription, error: undefined]>;
         loading: boolean;
     };
     update: {
-        run: (id: string, params: _paykit_sdk_core.UpdateSubscriptionSchema) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Subscription, error: undefined]>;
+        run: (id: string, params: _paykit_sdk_core.UpdateSubscriptionSchema<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Subscription, error: undefined]>;
         loading: boolean;
     };
     retrieve: {
-        run: (id: string) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Subscription | null, error: undefined]>;
+        run: (id: string) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Subscription | null, error: undefined]>;
         loading: boolean;
     };
     cancel: {
-        run: (id: string) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Subscription, error: undefined]>;
+        run: (id: string) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Subscription, 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/subscription.d.ts

@@ -1,24 +1,25 @@
+import { PayKitClientError } from '../util.js';
 import * as _paykit_sdk_core from '@paykit-sdk/core';
 
 declare const useSubscription: () => {
     create: {
-        run: (params: _paykit_sdk_core.CreateSubscriptionSchema) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Subscription, error: undefined]>;
+        run: (params: _paykit_sdk_core.CreateSubscriptionSchema<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Subscription, error: undefined]>;
         loading: boolean;
     };
     update: {
-        run: (id: string, params: _paykit_sdk_core.UpdateSubscriptionSchema) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Subscription, error: undefined]>;
+        run: (id: string, params: _paykit_sdk_core.UpdateSubscriptionSchema<Record<string, unknown>>) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Subscription, error: undefined]>;
         loading: boolean;
     };
     retrieve: {
-        run: (id: string) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Subscription | null, error: undefined]>;
+        run: (id: string) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Subscription | null, error: undefined]>;
         loading: boolean;
     };
     cancel: {
-        run: (id: string) => Promise<[data: undefined, error: Error] | [data: _paykit_sdk_core.Subscription, error: undefined]>;
+        run: (id: string) => Promise<[data: undefined, error: PayKitClientError] | [data: _paykit_sdk_core.Subscription, 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/subscription.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/subscription.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/util.d.mts

@@ -0,0 +1,19 @@
+interface PayKitClientErrorData {
+    message: string;
+    code?: string;
+    statusCode: number;
+    provider?: string;
+    method?: string;
+    context?: Record<string, unknown>;
+}
+declare class PayKitClientError extends Error {
+    readonly code?: string;
+    readonly statusCode: number;
+    readonly provider?: string;
+    readonly method?: string;
+    readonly context?: Record<string, unknown>;
+    constructor(errorData: PayKitClientErrorData);
+}
+declare const parsePayKitClientError: (response: Response, errorData: unknown) => PayKitClientError;
+
+export { PayKitClientError, type PayKitClientErrorData, parsePayKitClientError };

package/dist/util.d.ts

@@ -0,0 +1,19 @@
+interface PayKitClientErrorData {
+    message: string;
+    code?: string;
+    statusCode: number;
+    provider?: string;
+    method?: string;
+    context?: Record<string, unknown>;
+}
+declare class PayKitClientError extends Error {
+    readonly code?: string;
+    readonly statusCode: number;
+    readonly provider?: string;
+    readonly method?: string;
+    readonly context?: Record<string, unknown>;
+    constructor(errorData: PayKitClientErrorData);
+}
+declare const parsePayKitClientError: (response: Response, errorData: unknown) => PayKitClientError;
+
+export { PayKitClientError, type PayKitClientErrorData, parsePayKitClientError };

package/dist/util.js

@@ -0,0 +1,37 @@
+'use strict';
+
+// 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
+  });
+};
+
+exports.PayKitClientError = PayKitClientError;
+exports.parsePayKitClientError = parsePayKitClientError;

package/dist/util.mjs

@@ -0,0 +1,34 @@
+// 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
+  });
+};
+
+export { PayKitClientError, parsePayKitClientError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paykit-sdk/react",
-  "version": "1.1.96",
+  "version": "1.1.97",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -20,7 +20,7 @@
   "peerDependencies": {
     "react": ">=16.8.0",
     "react-dom": ">=16.8.0",
-    "@paykit-sdk/core": ">=1.1.97"
+    "@paykit-sdk/core": ">=1.2.3"
   },
   "devDependencies": {
     "@swc/core": "^1.12.9",
@@ -30,7 +30,7 @@
     "react-dom": "^19.2.0",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
-    "@paykit-sdk/core": "1.1.97"
+    "@paykit-sdk/core": "1.2.3"
   },
   "description": "React hooks and components for PayKit SDK - Universal payment processing with Stripe, Polar, and more",
   "keywords": [