payluk-escrow-inline-checkout 0.2.8 → 0.2.10

package/README.md

@@ -241,22 +241,42 @@ import { useEscrowCheckout } from 'payluk-escrow-inline-checkout/react';
 - **Initialize on the client:** If using frameworks like Next.js, call `initEscrowCheckout(...)` in a client component or in an effect.
 - **Preloading:** The hook marks `ready` after the first successful `pay`. If you need earlier preloading, you can trigger a preparatory flow (depending on your setup).
 
-## Error Handling
-
-Common issues:
-- **Not initialized:** Ensure `initEscrowCheckout({ publicKey })` is called before `pay(...)`.
-- **Browser-only:** Do not call `pay(...)` on the server.
-- **Network/API errors:** If the session endpoint fails, `pay(...)` will reject with the error message from your backend (if any).
-
-**Example:**
-
-```ts
-try {
-  await pay({ /* ... */ });
-} catch (err) {
-  alert((err as Error).message);
-}
-```
+## Error Handling
+
+Common issues:
+- **Not initialized:** Ensure `initEscrowCheckout({ publicKey })` is called before `pay(...)`.
+- **Browser-only:** Do not call `pay(...)` on the server.
+- **Network/API errors:** If the session endpoint fails, `pay(...)` will reject with an `EscrowCheckoutError` that includes a `code`, optional HTTP `status`, and `details`.
+
+`EscrowCheckoutError` codes:
+- `NOT_INITIALIZED`
+- `BROWSER_ONLY`
+- `INVALID_INPUT`
+- `WIDGET_LOAD`
+- `NETWORK`
+- `SESSION_CREATE`
+- `SESSION_RESPONSE`
+
+You can import the error class if you want stricter checks in TypeScript:
+
+```ts
+import { EscrowCheckoutError } from 'payluk-escrow-inline-checkout';
+```
+
+**Example:**
+
+```ts
+try {
+  await pay({ /* ... */ });
+} catch (err) {
+  if (err instanceof EscrowCheckoutError) {
+    console.error(err.code, err.status, err.message);
+    alert(err.message);
+  } else {
+    alert('Checkout failed');
+  }
+}
+```
 
 ## Security
 

package/dist/chunk-TL6HBLNO.js

@@ -0,0 +1,171 @@
+// src/index.ts
+var EscrowCheckoutError = class extends Error {
+  constructor(message, code, options) {
+    super(message);
+    this.name = "EscrowCheckoutError";
+    this.code = code;
+    this.status = options?.status;
+    this.details = options?.details;
+  }
+};
+var DEFAULT_SCRIPT_URL = "https://checkout.payluk.ng/escrow-checkout.min.js";
+var DEFAULT_GLOBAL_NAME = "EscrowCheckout";
+var CONFIG = null;
+function initEscrowCheckout(config) {
+  if (!isNonEmptyString(config?.publicKey)) {
+    throw new EscrowCheckoutError('initEscrowCheckout(...) requires "publicKey".', "INVALID_INPUT");
+  }
+  CONFIG = {
+    publicKey: config.publicKey.trim(),
+    scriptUrl: config.scriptUrlOverride || DEFAULT_SCRIPT_URL,
+    globalName: config.globalName || DEFAULT_GLOBAL_NAME,
+    crossOrigin: config.crossOrigin ?? "anonymous"
+  };
+}
+function assertConfigured(config) {
+  if (!config) {
+    throw new EscrowCheckoutError(
+      "Escrow checkout not initialized. Call initEscrowCheckout({ publicKey }) first.",
+      "NOT_INITIALIZED"
+    );
+  }
+}
+function normalizeError(error) {
+  if (error instanceof Error) return error;
+  if (typeof error === "string") return new Error(error);
+  return new Error("Unknown error");
+}
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function isSessionResponse(value) {
+  if (!value || typeof value !== "object") return false;
+  return "session" in value;
+}
+async function parseErrorBody(resp) {
+  const text = await resp.text();
+  if (!text) return {};
+  try {
+    const json = JSON.parse(text);
+    const message = typeof json?.message === "string" ? json.message : void 0;
+    return { message, details: json };
+  } catch {
+    return { message: text, details: text };
+  }
+}
+async function parseJsonResponse(resp) {
+  try {
+    return await resp.json();
+  } catch {
+    throw new EscrowCheckoutError("Invalid JSON response from session endpoint.", "SESSION_RESPONSE", {
+      status: resp.status
+    });
+  }
+}
+async function loadWidget() {
+  assertConfigured(CONFIG);
+  const { scriptUrl, globalName, crossOrigin } = CONFIG;
+  if (typeof window === "undefined") {
+    throw new EscrowCheckoutError("EscrowCheckout can only be loaded in the browser.", "BROWSER_ONLY");
+  }
+  const win = window;
+  win.__escrowCheckoutLoader ?? (win.__escrowCheckoutLoader = {});
+  if (win.__escrowCheckoutLoader[scriptUrl]) {
+    return win.__escrowCheckoutLoader[scriptUrl];
+  }
+  if (typeof win[globalName] === "function") {
+    const fn = win[globalName];
+    win.__escrowCheckoutLoader[scriptUrl] = Promise.resolve(fn);
+    return fn;
+  }
+  win.__escrowCheckoutLoader[scriptUrl] = new Promise((resolve, reject) => {
+    const script = document.createElement("script");
+    script.src = scriptUrl;
+    script.async = true;
+    if (crossOrigin) script.crossOrigin = crossOrigin;
+    script.onload = () => {
+      const fn = win[globalName];
+      if (typeof fn === "function") resolve(fn);
+      else {
+        reject(
+          new EscrowCheckoutError(
+            `Escrow checkout script loaded, but window.${globalName} is not a function.`,
+            "WIDGET_LOAD"
+          )
+        );
+      }
+    };
+    script.onerror = () => reject(new EscrowCheckoutError(`Failed to load escrow checkout script: ${scriptUrl}`, "WIDGET_LOAD"));
+    document.head.appendChild(script);
+  });
+  return win.__escrowCheckoutLoader[scriptUrl];
+}
+async function createSession(input) {
+  assertConfigured(CONFIG);
+  const { publicKey } = CONFIG;
+  const apiBaseUrl = publicKey.startsWith("pk_live_") ? "https://live.payluk.ng" : "https://staging.live.payluk.ng";
+  let resp;
+  try {
+    resp = await fetch(`${apiBaseUrl}/v1/checkout/session`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        paymentToken: input.paymentToken,
+        redirectUrl: input.redirectUrl,
+        reference: input.reference,
+        customerId: input.customerId,
+        publicKey
+      })
+    });
+  } catch (error) {
+    const normalized = normalizeError(error);
+    throw new EscrowCheckoutError("Network error while creating checkout session.", "NETWORK", {
+      details: normalized.message
+    });
+  }
+  if (!resp.ok) {
+    const { message, details } = await parseErrorBody(resp);
+    throw new EscrowCheckoutError(message || `Failed to create session (HTTP ${resp.status}).`, "SESSION_CREATE", {
+      status: resp.status,
+      details
+    });
+  }
+  const data = await parseJsonResponse(resp);
+  if (!isSessionResponse(data)) {
+    throw new EscrowCheckoutError('Session response missing "session".', "SESSION_RESPONSE", {
+      status: resp.status,
+      details: data
+    });
+  }
+  return data;
+}
+async function pay(input) {
+  if (typeof window === "undefined") {
+    throw new EscrowCheckoutError("pay(...) can only run in the browser.", "BROWSER_ONLY");
+  }
+  assertConfigured(CONFIG);
+  if (!input || !isNonEmptyString(input.paymentToken)) {
+    throw new EscrowCheckoutError('pay(...) requires "paymentToken".', "INVALID_INPUT");
+  }
+  if (!isNonEmptyString(input.reference)) {
+    throw new EscrowCheckoutError('pay(...) requires "reference".', "INVALID_INPUT");
+  }
+  if (!isNonEmptyString(input.redirectUrl)) {
+    throw new EscrowCheckoutError('pay(...) requires "redirectUrl".', "INVALID_INPUT");
+  }
+  const [{ session }, widget] = await Promise.all([createSession(input), loadWidget()]);
+  widget({
+    session,
+    logoUrl: input.logoUrl,
+    brand: input.brand,
+    callback: input.callback,
+    onClose: input.onClose,
+    customerId: input.customerId,
+    publicKey: CONFIG.publicKey,
+    ...input.extra ?? {}
+  });
+}
+
+export { EscrowCheckoutError, initEscrowCheckout, pay };
+//# sourceMappingURL=chunk-TL6HBLNO.js.map
+//# sourceMappingURL=chunk-TL6HBLNO.js.map

package/dist/chunk-TL6HBLNO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"chunk-TL6HBLNO.js","sourcesContent":["export type EscrowWidget = (options: Record<string, unknown>) => void;\n\nexport type EscrowCheckoutErrorCode =\n    | 'NOT_INITIALIZED'\n    | 'BROWSER_ONLY'\n    | 'INVALID_INPUT'\n    | 'WIDGET_LOAD'\n    | 'NETWORK'\n    | 'SESSION_CREATE'\n    | 'SESSION_RESPONSE';\n\nexport class EscrowCheckoutError extends Error {\n    code: EscrowCheckoutErrorCode;\n    status?: number;\n    details?: unknown;\n\n    constructor(message: string, code: EscrowCheckoutErrorCode, options?: { status?: number; details?: unknown }) {\n        super(message);\n        this.name = 'EscrowCheckoutError';\n        this.code = code;\n        this.status = options?.status;\n        this.details = options?.details;\n    }\n}\n\nexport interface InitConfig {\n    publicKey: string; // publishable key only\n    /**\n     * Optional overrides for experts. End users don't need to set these.\n     */\n    scriptUrlOverride?: string;\r\n    globalName?: string; // default 'EscrowCheckout'\r\n    crossOrigin?: '' | 'anonymous' | 'use-credentials';\r\n}\r\n\r\nexport interface PayInput {\r\n    paymentToken: string;\r\n    reference: string;\r\n    redirectUrl: string;\r\n    logoUrl?: string;\r\n    brand?: string;\r\n    customerId?: string;\r\n    /**\r\n     * Extra fields supported by the widget.\r\n     */\r\n    extra?: Record<string, unknown>;\r\n    callback?: (result: any) => void;\r\n    onClose?: () => void;\r\n}\r\n\r\nexport interface SessionResponse {\r\n    session: unknown;\r\n}\r\n\r\nconst DEFAULT_SCRIPT_URL = 'https://checkout.payluk.ng/escrow-checkout.min.js';\r\nconst DEFAULT_GLOBAL_NAME = 'EscrowCheckout';\r\n\r\ntype ResolvedConfig = Required<Pick<InitConfig, 'publicKey'>> & {\r\n    scriptUrl: string;\r\n    globalName: string;\r\n    crossOrigin: '' | 'anonymous' | 'use-credentials';\r\n};\r\n\r\nlet CONFIG: ResolvedConfig | null = null;\r\n\r\n/**\r\n * Initialize the library once (e.g., in app bootstrap).\r\n * Hides script URL and session creation from consumers.\r\n */\r\nexport function initEscrowCheckout(config: InitConfig): void {\n    if (!isNonEmptyString(config?.publicKey)) {\n        throw new EscrowCheckoutError('initEscrowCheckout(...) requires \"publicKey\".', 'INVALID_INPUT');\n    }\n    CONFIG = {\n        publicKey: config.publicKey.trim(),\n        scriptUrl: config.scriptUrlOverride || DEFAULT_SCRIPT_URL,\n        globalName: config.globalName || DEFAULT_GLOBAL_NAME,\n        crossOrigin: config.crossOrigin ?? 'anonymous'\n    };\n}\n\r\n/**\r\n * Narrow a provided config to ResolvedConfig or throw if not initialized.\r\n */\r\nfunction assertConfigured(config: ResolvedConfig | null): asserts config is ResolvedConfig {\n    if (!config) {\n        throw new EscrowCheckoutError(\n            'Escrow checkout not initialized. Call initEscrowCheckout({ publicKey }) first.',\n            'NOT_INITIALIZED'\n        );\n    }\n}\n\nfunction normalizeError(error: unknown): Error {\n    if (error instanceof Error) return error;\n    if (typeof error === 'string') return new Error(error);\n    return new Error('Unknown error');\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n    return typeof value === 'string' && value.trim().length > 0;\n}\n\nfunction isSessionResponse(value: unknown): value is SessionResponse {\n    if (!value || typeof value !== 'object') return false;\n    return 'session' in value;\n}\n\nasync function parseErrorBody(resp: Response): Promise<{ message?: string; details?: unknown }> {\n    const text = await resp.text();\n    if (!text) return {};\n\n    try {\n        const json = JSON.parse(text) as { message?: unknown };\n        const message = typeof json?.message === 'string' ? json.message : undefined;\n        return { message, details: json };\n    } catch {\n        return { message: text, details: text };\n    }\n}\n\nasync function parseJsonResponse(resp: Response): Promise<unknown> {\n    try {\n        return await resp.json();\n    } catch {\n        throw new EscrowCheckoutError('Invalid JSON response from session endpoint.', 'SESSION_RESPONSE', {\n            status: resp.status\n        });\n    }\n}\n\n/**\n * Internal: load the widget script once and return the global function.\n */\nasync function loadWidget(): Promise<EscrowWidget> {\n    assertConfigured(CONFIG);\n    const { scriptUrl, globalName, crossOrigin } = CONFIG;\r\n\r\n    if (typeof window === 'undefined') {\n        throw new EscrowCheckoutError('EscrowCheckout can only be loaded in the browser.', 'BROWSER_ONLY');\n    }\n\r\n    const win = window as any;\r\n    win.__escrowCheckoutLoader ??= {};\r\n\r\n    if (win.__escrowCheckoutLoader[scriptUrl]) {\r\n        return win.__escrowCheckoutLoader[scriptUrl];\r\n    }\r\n\r\n    if (typeof win[globalName] === 'function') {\r\n        const fn = win[globalName] as EscrowWidget;\r\n        win.__escrowCheckoutLoader[scriptUrl] = Promise.resolve(fn);\r\n        return fn;\r\n    }\r\n\r\n    win.__escrowCheckoutLoader[scriptUrl] = new Promise<EscrowWidget>((resolve, reject) => {\r\n        const script = document.createElement('script');\r\n        script.src = scriptUrl;\r\n        script.async = true;\r\n        if (crossOrigin) script.crossOrigin = crossOrigin;\r\n\r\n        script.onload = () => {\r\n            const fn = win[globalName];\r\n            if (typeof fn === 'function') resolve(fn as EscrowWidget);\n            else {\n                reject(\n                    new EscrowCheckoutError(\n                        `Escrow checkout script loaded, but window.${globalName} is not a function.`,\n                        'WIDGET_LOAD'\n                    )\n                );\n            }\n        };\n\n        script.onerror = () =>\n            reject(new EscrowCheckoutError(`Failed to load escrow checkout script: ${scriptUrl}`, 'WIDGET_LOAD'));\n\n        document.head.appendChild(script);\n    });\n\r\n    return win.__escrowCheckoutLoader[scriptUrl];\r\n}\r\n\r\n/**\r\n * Internal: create a checkout session by calling your API.\r\n * This is intentionally inside the lib (user doesn't implement it).\r\n */\r\nasync function createSession(input: PayInput): Promise<SessionResponse> {\n    assertConfigured(CONFIG);\n    const { publicKey } = CONFIG;\n    const apiBaseUrl = publicKey.startsWith('pk_live_') ? 'https://live.payluk.ng' : 'https://staging.live.payluk.ng';\n    let resp: Response;\n\n    try {\n        resp = await fetch(`${apiBaseUrl}/v1/checkout/session`, {\n            method: 'POST',\n            headers: { 'Content-Type': 'application/json' },\n            body: JSON.stringify({\n                paymentToken: input.paymentToken,\n                redirectUrl: input.redirectUrl,\n                reference: input.reference,\n                customerId: input.customerId,\n                publicKey\n            })\n        });\n    } catch (error) {\n        const normalized = normalizeError(error);\n        throw new EscrowCheckoutError('Network error while creating checkout session.', 'NETWORK', {\n            details: normalized.message\n        });\n    }\n\n    if (!resp.ok) {\n        const { message, details } = await parseErrorBody(resp);\n        throw new EscrowCheckoutError(message || `Failed to create session (HTTP ${resp.status}).`, 'SESSION_CREATE', {\n            status: resp.status,\n            details\n        });\n    }\n\n    const data = await parseJsonResponse(resp);\n    if (!isSessionResponse(data)) {\n        throw new EscrowCheckoutError('Session response missing \"session\".', 'SESSION_RESPONSE', {\n            status: resp.status,\n            details: data\n        });\n    }\n\n    return data as SessionResponse;\n}\n\r\n/**\r\n * Public API: create the session and open the widget.\r\n * Consumers only supply business inputs (no script URL, no API calls).\r\n */\r\nexport async function pay(input: PayInput): Promise<void> {\n    if (typeof window === 'undefined') {\n        throw new EscrowCheckoutError('pay(...) can only run in the browser.', 'BROWSER_ONLY');\n    }\n\n    assertConfigured(CONFIG);\n    if (!input || !isNonEmptyString(input.paymentToken)) {\n        throw new EscrowCheckoutError('pay(...) requires \"paymentToken\".', 'INVALID_INPUT');\n    }\n    if (!isNonEmptyString(input.reference)) {\n        throw new EscrowCheckoutError('pay(...) requires \"reference\".', 'INVALID_INPUT');\n    }\n    if (!isNonEmptyString(input.redirectUrl)) {\n        throw new EscrowCheckoutError('pay(...) requires \"redirectUrl\".', 'INVALID_INPUT');\n    }\n\n    const [{ session }, widget] = await Promise.all([createSession(input), loadWidget()]);\n\n    widget({\n        session,\n        logoUrl: input.logoUrl,\n        brand: input.brand,\n        callback: input.callback,\n        onClose: input.onClose,\n        customerId: input.customerId,\n        publicKey: CONFIG.publicKey,\n        ...(input.extra ?? {})\n    });\n}\n"]}

package/dist/index.cjs

@@ -1,13 +1,24 @@
 'use strict';
 
 // src/index.ts
+var EscrowCheckoutError = class extends Error {
+  constructor(message, code, options) {
+    super(message);
+    this.name = "EscrowCheckoutError";
+    this.code = code;
+    this.status = options?.status;
+    this.details = options?.details;
+  }
+};
 var DEFAULT_SCRIPT_URL = "https://checkout.payluk.ng/escrow-checkout.min.js";
 var DEFAULT_GLOBAL_NAME = "EscrowCheckout";
 var CONFIG = null;
 function initEscrowCheckout(config) {
-  if (!config?.publicKey) throw new Error('initEscrowCheckout: "publicKey" is required.');
+  if (!isNonEmptyString(config?.publicKey)) {
+    throw new EscrowCheckoutError('initEscrowCheckout(...) requires "publicKey".', "INVALID_INPUT");
+  }
   CONFIG = {
-    publicKey: config.publicKey,
+    publicKey: config.publicKey.trim(),
     scriptUrl: config.scriptUrlOverride || DEFAULT_SCRIPT_URL,
     globalName: config.globalName || DEFAULT_GLOBAL_NAME,
     crossOrigin: config.crossOrigin ?? "anonymous"
@@ -15,14 +26,49 @@ function initEscrowCheckout(config) {
 }
 function assertConfigured(config) {
   if (!config) {
-    throw new Error("Escrow checkout not initialized. Call initEscrowCheckout({ apiBaseUrl, publicKey }) first.");
+    throw new EscrowCheckoutError(
+      "Escrow checkout not initialized. Call initEscrowCheckout({ publicKey }) first.",
+      "NOT_INITIALIZED"
+    );
+  }
+}
+function normalizeError(error) {
+  if (error instanceof Error) return error;
+  if (typeof error === "string") return new Error(error);
+  return new Error("Unknown error");
+}
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function isSessionResponse(value) {
+  if (!value || typeof value !== "object") return false;
+  return "session" in value;
+}
+async function parseErrorBody(resp) {
+  const text = await resp.text();
+  if (!text) return {};
+  try {
+    const json = JSON.parse(text);
+    const message = typeof json?.message === "string" ? json.message : void 0;
+    return { message, details: json };
+  } catch {
+    return { message: text, details: text };
+  }
+}
+async function parseJsonResponse(resp) {
+  try {
+    return await resp.json();
+  } catch {
+    throw new EscrowCheckoutError("Invalid JSON response from session endpoint.", "SESSION_RESPONSE", {
+      status: resp.status
+    });
   }
 }
 async function loadWidget() {
   assertConfigured(CONFIG);
   const { scriptUrl, globalName, crossOrigin } = CONFIG;
   if (typeof window === "undefined") {
-    throw new Error("EscrowCheckout can only be loaded in the browser.");
+    throw new EscrowCheckoutError("EscrowCheckout can only be loaded in the browser.", "BROWSER_ONLY");
   }
   const win = window;
   win.__escrowCheckoutLoader ?? (win.__escrowCheckoutLoader = {});
@@ -42,9 +88,16 @@ async function loadWidget() {
     script.onload = () => {
       const fn = win[globalName];
       if (typeof fn === "function") resolve(fn);
-      else reject(new Error(`Escrow checkout script loaded, but window.${globalName} is not a function.`));
+      else {
+        reject(
+          new EscrowCheckoutError(
+            `Escrow checkout script loaded, but window.${globalName} is not a function.`,
+            "WIDGET_LOAD"
+          )
+        );
+      }
     };
-    script.onerror = () => reject(new Error(`Failed to load escrow checkout script: ${scriptUrl}`));
+    script.onerror = () => reject(new EscrowCheckoutError(`Failed to load escrow checkout script: ${scriptUrl}`, "WIDGET_LOAD"));
     document.head.appendChild(script);
   });
   return win.__escrowCheckoutLoader[scriptUrl];
@@ -53,26 +106,54 @@ async function createSession(input) {
   assertConfigured(CONFIG);
   const { publicKey } = CONFIG;
   const apiBaseUrl = publicKey.startsWith("pk_live_") ? "https://live.payluk.ng" : "https://staging.live.payluk.ng";
-  const resp = await fetch(`${apiBaseUrl}/v1/checkout/session`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      paymentToken: input.paymentToken,
-      redirectUrl: input.redirectUrl,
-      reference: input.reference,
-      customerId: input.customerId,
-      publicKey
-    })
-  });
+  let resp;
+  try {
+    resp = await fetch(`${apiBaseUrl}/v1/checkout/session`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        paymentToken: input.paymentToken,
+        redirectUrl: input.redirectUrl,
+        reference: input.reference,
+        customerId: input.customerId,
+        publicKey
+      })
+    });
+  } catch (error) {
+    const normalized = normalizeError(error);
+    throw new EscrowCheckoutError("Network error while creating checkout session.", "NETWORK", {
+      details: normalized.message
+    });
+  }
   if (!resp.ok) {
-    const err = await resp.json().catch(() => ({}));
-    throw new Error(err.message || "Failed to create session");
+    const { message, details } = await parseErrorBody(resp);
+    throw new EscrowCheckoutError(message || `Failed to create session (HTTP ${resp.status}).`, "SESSION_CREATE", {
+      status: resp.status,
+      details
+    });
+  }
+  const data = await parseJsonResponse(resp);
+  if (!isSessionResponse(data)) {
+    throw new EscrowCheckoutError('Session response missing "session".', "SESSION_RESPONSE", {
+      status: resp.status,
+      details: data
+    });
   }
-  return await resp.json();
+  return data;
 }
 async function pay(input) {
   if (typeof window === "undefined") {
-    throw new Error("pay(...) can only run in the browser.");
+    throw new EscrowCheckoutError("pay(...) can only run in the browser.", "BROWSER_ONLY");
+  }
+  assertConfigured(CONFIG);
+  if (!input || !isNonEmptyString(input.paymentToken)) {
+    throw new EscrowCheckoutError('pay(...) requires "paymentToken".', "INVALID_INPUT");
+  }
+  if (!isNonEmptyString(input.reference)) {
+    throw new EscrowCheckoutError('pay(...) requires "reference".', "INVALID_INPUT");
+  }
+  if (!isNonEmptyString(input.redirectUrl)) {
+    throw new EscrowCheckoutError('pay(...) requires "redirectUrl".', "INVALID_INPUT");
   }
   const [{ session }, widget] = await Promise.all([createSession(input), loadWidget()]);
   widget({
@@ -82,10 +163,12 @@ async function pay(input) {
     callback: input.callback,
     onClose: input.onClose,
     customerId: input.customerId,
+    publicKey: CONFIG.publicKey,
     ...input.extra ?? {}
   });
 }
 
+exports.EscrowCheckoutError = EscrowCheckoutError;
 exports.initEscrowCheckout = initEscrowCheckout;
 exports.pay = pay;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export type EscrowWidget = (options: Record<string, unknown>) => void;\r\n\r\nexport interface InitConfig {\r\n    publicKey: string; // publishable key only\r\n    /**\r\n     * Optional overrides for experts. End users don't need to set these.\r\n     */\r\n    scriptUrlOverride?: string;\r\n    globalName?: string; // default 'EscrowCheckout'\r\n    crossOrigin?: '' | 'anonymous' | 'use-credentials';\r\n}\r\n\r\nexport interface PayInput {\r\n    paymentToken: string;\r\n    reference: string;\r\n    redirectUrl: string;\r\n    logoUrl?: string;\r\n    brand?: string;\r\n    customerId?: string;\r\n    /**\r\n     * Extra fields supported by the widget.\r\n     */\r\n    extra?: Record<string, unknown>;\r\n    callback?: (result: any) => void;\r\n    onClose?: () => void;\r\n}\r\n\r\nexport interface SessionResponse {\r\n    session: unknown;\r\n}\r\n\r\nconst DEFAULT_SCRIPT_URL = 'https://checkout.payluk.ng/escrow-checkout.min.js';\r\nconst DEFAULT_GLOBAL_NAME = 'EscrowCheckout';\r\n\r\ntype ResolvedConfig = Required<Pick<InitConfig, 'publicKey'>> & {\r\n    scriptUrl: string;\r\n    globalName: string;\r\n    crossOrigin: '' | 'anonymous' | 'use-credentials';\r\n};\r\n\r\nlet CONFIG: ResolvedConfig | null = null;\r\n\r\n/**\r\n * Initialize the library once (e.g., in app bootstrap).\r\n * Hides script URL and session creation from consumers.\r\n */\r\nexport function initEscrowCheckout(config: InitConfig): void {\r\n    if (!config?.publicKey) throw new Error('initEscrowCheckout: \"publicKey\" is required.');\r\n    CONFIG = {\r\n        publicKey: config.publicKey,\r\n        scriptUrl: config.scriptUrlOverride || DEFAULT_SCRIPT_URL,\r\n        globalName: config.globalName || DEFAULT_GLOBAL_NAME,\r\n        crossOrigin: config.crossOrigin ?? 'anonymous'\r\n    };\r\n}\r\n\r\n/**\r\n * Narrow a provided config to ResolvedConfig or throw if not initialized.\r\n */\r\nfunction assertConfigured(config: ResolvedConfig | null): asserts config is ResolvedConfig {\r\n    if (!config) {\r\n        throw new Error('Escrow checkout not initialized. Call initEscrowCheckout({ apiBaseUrl, publicKey }) first.');\r\n    }\r\n}\r\n\r\n/**\r\n * Internal: load the widget script once and return the global function.\r\n */\r\nasync function loadWidget(): Promise<EscrowWidget> {\r\n    assertConfigured(CONFIG);\r\n    const { scriptUrl, globalName, crossOrigin } = CONFIG;\r\n\r\n    if (typeof window === 'undefined') {\r\n        throw new Error('EscrowCheckout can only be loaded in the browser.');\r\n    }\r\n\r\n    const win = window as any;\r\n    win.__escrowCheckoutLoader ??= {};\r\n\r\n    if (win.__escrowCheckoutLoader[scriptUrl]) {\r\n        return win.__escrowCheckoutLoader[scriptUrl];\r\n    }\r\n\r\n    if (typeof win[globalName] === 'function') {\r\n        const fn = win[globalName] as EscrowWidget;\r\n        win.__escrowCheckoutLoader[scriptUrl] = Promise.resolve(fn);\r\n        return fn;\r\n    }\r\n\r\n    win.__escrowCheckoutLoader[scriptUrl] = new Promise<EscrowWidget>((resolve, reject) => {\r\n        const script = document.createElement('script');\r\n        script.src = scriptUrl;\r\n        script.async = true;\r\n        if (crossOrigin) script.crossOrigin = crossOrigin;\r\n\r\n        script.onload = () => {\r\n            const fn = win[globalName];\r\n            if (typeof fn === 'function') resolve(fn as EscrowWidget);\r\n            else reject(new Error(`Escrow checkout script loaded, but window.${globalName} is not a function.`));\r\n        };\r\n\r\n        script.onerror = () => reject(new Error(`Failed to load escrow checkout script: ${scriptUrl}`));\r\n\r\n        document.head.appendChild(script);\r\n    });\r\n\r\n    return win.__escrowCheckoutLoader[scriptUrl];\r\n}\r\n\r\n/**\r\n * Internal: create a checkout session by calling your API.\r\n * This is intentionally inside the lib (user doesn't implement it).\r\n */\r\nasync function createSession(input: PayInput): Promise<SessionResponse> {\r\n    assertConfigured(CONFIG);\r\n    const { publicKey } = CONFIG;\r\n    const apiBaseUrl = publicKey.startsWith(\"pk_live_\") ? 'https://live.payluk.ng' : 'https://staging.live.payluk.ng';\r\n\r\n    const resp = await fetch(`${apiBaseUrl}/v1/checkout/session`, {\r\n        method: 'POST',\r\n        headers: { 'Content-Type': 'application/json' },\r\n        body: JSON.stringify({\r\n            paymentToken: input.paymentToken,\r\n            redirectUrl: input.redirectUrl,\r\n            reference: input.reference,\r\n            customerId: input.customerId,\r\n            publicKey\r\n        })\r\n    });\r\n\r\n    if (!resp.ok) {\r\n        const err = await resp.json().catch(() => ({}));\r\n        throw new Error(err.message || 'Failed to create session');\r\n    }\r\n\r\n    return (await resp.json()) as SessionResponse;\r\n}\r\n\r\n/**\r\n * Public API: create the session and open the widget.\r\n * Consumers only supply business inputs (no script URL, no API calls).\r\n */\r\nexport async function pay(input: PayInput): Promise<void> {\r\n    if (typeof window === 'undefined') {\r\n        throw new Error('pay(...) can only run in the browser.');\r\n    }\r\n\r\n    const [{ session }, widget] = await Promise.all([createSession(input), loadWidget()]);\r\n\r\n    widget({\r\n        session,\r\n        logoUrl: input.logoUrl,\r\n        brand: input.brand,\r\n        callback: input.callback,\r\n        onClose: input.onClose,\r\n        customerId: input.customerId,\r\n        ...(input.extra ?? {})\r\n    });\r\n}"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export type EscrowWidget = (options: Record<string, unknown>) => void;\n\nexport type EscrowCheckoutErrorCode =\n    | 'NOT_INITIALIZED'\n    | 'BROWSER_ONLY'\n    | 'INVALID_INPUT'\n    | 'WIDGET_LOAD'\n    | 'NETWORK'\n    | 'SESSION_CREATE'\n    | 'SESSION_RESPONSE';\n\nexport class EscrowCheckoutError extends Error {\n    code: EscrowCheckoutErrorCode;\n    status?: number;\n    details?: unknown;\n\n    constructor(message: string, code: EscrowCheckoutErrorCode, options?: { status?: number; details?: unknown }) {\n        super(message);\n        this.name = 'EscrowCheckoutError';\n        this.code = code;\n        this.status = options?.status;\n        this.details = options?.details;\n    }\n}\n\nexport interface InitConfig {\n    publicKey: string; // publishable key only\n    /**\n     * Optional overrides for experts. End users don't need to set these.\n     */\n    scriptUrlOverride?: string;\r\n    globalName?: string; // default 'EscrowCheckout'\r\n    crossOrigin?: '' | 'anonymous' | 'use-credentials';\r\n}\r\n\r\nexport interface PayInput {\r\n    paymentToken: string;\r\n    reference: string;\r\n    redirectUrl: string;\r\n    logoUrl?: string;\r\n    brand?: string;\r\n    customerId?: string;\r\n    /**\r\n     * Extra fields supported by the widget.\r\n     */\r\n    extra?: Record<string, unknown>;\r\n    callback?: (result: any) => void;\r\n    onClose?: () => void;\r\n}\r\n\r\nexport interface SessionResponse {\r\n    session: unknown;\r\n}\r\n\r\nconst DEFAULT_SCRIPT_URL = 'https://checkout.payluk.ng/escrow-checkout.min.js';\r\nconst DEFAULT_GLOBAL_NAME = 'EscrowCheckout';\r\n\r\ntype ResolvedConfig = Required<Pick<InitConfig, 'publicKey'>> & {\r\n    scriptUrl: string;\r\n    globalName: string;\r\n    crossOrigin: '' | 'anonymous' | 'use-credentials';\r\n};\r\n\r\nlet CONFIG: ResolvedConfig | null = null;\r\n\r\n/**\r\n * Initialize the library once (e.g., in app bootstrap).\r\n * Hides script URL and session creation from consumers.\r\n */\r\nexport function initEscrowCheckout(config: InitConfig): void {\n    if (!isNonEmptyString(config?.publicKey)) {\n        throw new EscrowCheckoutError('initEscrowCheckout(...) requires \"publicKey\".', 'INVALID_INPUT');\n    }\n    CONFIG = {\n        publicKey: config.publicKey.trim(),\n        scriptUrl: config.scriptUrlOverride || DEFAULT_SCRIPT_URL,\n        globalName: config.globalName || DEFAULT_GLOBAL_NAME,\n        crossOrigin: config.crossOrigin ?? 'anonymous'\n    };\n}\n\r\n/**\r\n * Narrow a provided config to ResolvedConfig or throw if not initialized.\r\n */\r\nfunction assertConfigured(config: ResolvedConfig | null): asserts config is ResolvedConfig {\n    if (!config) {\n        throw new EscrowCheckoutError(\n            'Escrow checkout not initialized. Call initEscrowCheckout({ publicKey }) first.',\n            'NOT_INITIALIZED'\n        );\n    }\n}\n\nfunction normalizeError(error: unknown): Error {\n    if (error instanceof Error) return error;\n    if (typeof error === 'string') return new Error(error);\n    return new Error('Unknown error');\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n    return typeof value === 'string' && value.trim().length > 0;\n}\n\nfunction isSessionResponse(value: unknown): value is SessionResponse {\n    if (!value || typeof value !== 'object') return false;\n    return 'session' in value;\n}\n\nasync function parseErrorBody(resp: Response): Promise<{ message?: string; details?: unknown }> {\n    const text = await resp.text();\n    if (!text) return {};\n\n    try {\n        const json = JSON.parse(text) as { message?: unknown };\n        const message = typeof json?.message === 'string' ? json.message : undefined;\n        return { message, details: json };\n    } catch {\n        return { message: text, details: text };\n    }\n}\n\nasync function parseJsonResponse(resp: Response): Promise<unknown> {\n    try {\n        return await resp.json();\n    } catch {\n        throw new EscrowCheckoutError('Invalid JSON response from session endpoint.', 'SESSION_RESPONSE', {\n            status: resp.status\n        });\n    }\n}\n\n/**\n * Internal: load the widget script once and return the global function.\n */\nasync function loadWidget(): Promise<EscrowWidget> {\n    assertConfigured(CONFIG);\n    const { scriptUrl, globalName, crossOrigin } = CONFIG;\r\n\r\n    if (typeof window === 'undefined') {\n        throw new EscrowCheckoutError('EscrowCheckout can only be loaded in the browser.', 'BROWSER_ONLY');\n    }\n\r\n    const win = window as any;\r\n    win.__escrowCheckoutLoader ??= {};\r\n\r\n    if (win.__escrowCheckoutLoader[scriptUrl]) {\r\n        return win.__escrowCheckoutLoader[scriptUrl];\r\n    }\r\n\r\n    if (typeof win[globalName] === 'function') {\r\n        const fn = win[globalName] as EscrowWidget;\r\n        win.__escrowCheckoutLoader[scriptUrl] = Promise.resolve(fn);\r\n        return fn;\r\n    }\r\n\r\n    win.__escrowCheckoutLoader[scriptUrl] = new Promise<EscrowWidget>((resolve, reject) => {\r\n        const script = document.createElement('script');\r\n        script.src = scriptUrl;\r\n        script.async = true;\r\n        if (crossOrigin) script.crossOrigin = crossOrigin;\r\n\r\n        script.onload = () => {\r\n            const fn = win[globalName];\r\n            if (typeof fn === 'function') resolve(fn as EscrowWidget);\n            else {\n                reject(\n                    new EscrowCheckoutError(\n                        `Escrow checkout script loaded, but window.${globalName} is not a function.`,\n                        'WIDGET_LOAD'\n                    )\n                );\n            }\n        };\n\n        script.onerror = () =>\n            reject(new EscrowCheckoutError(`Failed to load escrow checkout script: ${scriptUrl}`, 'WIDGET_LOAD'));\n\n        document.head.appendChild(script);\n    });\n\r\n    return win.__escrowCheckoutLoader[scriptUrl];\r\n}\r\n\r\n/**\r\n * Internal: create a checkout session by calling your API.\r\n * This is intentionally inside the lib (user doesn't implement it).\r\n */\r\nasync function createSession(input: PayInput): Promise<SessionResponse> {\n    assertConfigured(CONFIG);\n    const { publicKey } = CONFIG;\n    const apiBaseUrl = publicKey.startsWith('pk_live_') ? 'https://live.payluk.ng' : 'https://staging.live.payluk.ng';\n    let resp: Response;\n\n    try {\n        resp = await fetch(`${apiBaseUrl}/v1/checkout/session`, {\n            method: 'POST',\n            headers: { 'Content-Type': 'application/json' },\n            body: JSON.stringify({\n                paymentToken: input.paymentToken,\n                redirectUrl: input.redirectUrl,\n                reference: input.reference,\n                customerId: input.customerId,\n                publicKey\n            })\n        });\n    } catch (error) {\n        const normalized = normalizeError(error);\n        throw new EscrowCheckoutError('Network error while creating checkout session.', 'NETWORK', {\n            details: normalized.message\n        });\n    }\n\n    if (!resp.ok) {\n        const { message, details } = await parseErrorBody(resp);\n        throw new EscrowCheckoutError(message || `Failed to create session (HTTP ${resp.status}).`, 'SESSION_CREATE', {\n            status: resp.status,\n            details\n        });\n    }\n\n    const data = await parseJsonResponse(resp);\n    if (!isSessionResponse(data)) {\n        throw new EscrowCheckoutError('Session response missing \"session\".', 'SESSION_RESPONSE', {\n            status: resp.status,\n            details: data\n        });\n    }\n\n    return data as SessionResponse;\n}\n\r\n/**\r\n * Public API: create the session and open the widget.\r\n * Consumers only supply business inputs (no script URL, no API calls).\r\n */\r\nexport async function pay(input: PayInput): Promise<void> {\n    if (typeof window === 'undefined') {\n        throw new EscrowCheckoutError('pay(...) can only run in the browser.', 'BROWSER_ONLY');\n    }\n\n    assertConfigured(CONFIG);\n    if (!input || !isNonEmptyString(input.paymentToken)) {\n        throw new EscrowCheckoutError('pay(...) requires \"paymentToken\".', 'INVALID_INPUT');\n    }\n    if (!isNonEmptyString(input.reference)) {\n        throw new EscrowCheckoutError('pay(...) requires \"reference\".', 'INVALID_INPUT');\n    }\n    if (!isNonEmptyString(input.redirectUrl)) {\n        throw new EscrowCheckoutError('pay(...) requires \"redirectUrl\".', 'INVALID_INPUT');\n    }\n\n    const [{ session }, widget] = await Promise.all([createSession(input), loadWidget()]);\n\n    widget({\n        session,\n        logoUrl: input.logoUrl,\n        brand: input.brand,\n        callback: input.callback,\n        onClose: input.onClose,\n        customerId: input.customerId,\n        publicKey: CONFIG.publicKey,\n        ...(input.extra ?? {})\n    });\n}\n"]}

package/dist/index.d.cts

@@ -1,4 +1,14 @@
 type EscrowWidget = (options: Record<string, unknown>) => void;
+type EscrowCheckoutErrorCode = 'NOT_INITIALIZED' | 'BROWSER_ONLY' | 'INVALID_INPUT' | 'WIDGET_LOAD' | 'NETWORK' | 'SESSION_CREATE' | 'SESSION_RESPONSE';
+declare class EscrowCheckoutError extends Error {
+    code: EscrowCheckoutErrorCode;
+    status?: number;
+    details?: unknown;
+    constructor(message: string, code: EscrowCheckoutErrorCode, options?: {
+        status?: number;
+        details?: unknown;
+    });
+}
 interface InitConfig {
     publicKey: string;
     /**
@@ -36,4 +46,4 @@ declare function initEscrowCheckout(config: InitConfig): void;
  */
 declare function pay(input: PayInput): Promise<void>;
 
-export { type EscrowWidget, type InitConfig, type PayInput, type SessionResponse, initEscrowCheckout, pay };
+export { EscrowCheckoutError, type EscrowCheckoutErrorCode, type EscrowWidget, type InitConfig, type PayInput, type SessionResponse, initEscrowCheckout, pay };

package/dist/index.d.ts

@@ -1,4 +1,14 @@
 type EscrowWidget = (options: Record<string, unknown>) => void;
+type EscrowCheckoutErrorCode = 'NOT_INITIALIZED' | 'BROWSER_ONLY' | 'INVALID_INPUT' | 'WIDGET_LOAD' | 'NETWORK' | 'SESSION_CREATE' | 'SESSION_RESPONSE';
+declare class EscrowCheckoutError extends Error {
+    code: EscrowCheckoutErrorCode;
+    status?: number;
+    details?: unknown;
+    constructor(message: string, code: EscrowCheckoutErrorCode, options?: {
+        status?: number;
+        details?: unknown;
+    });
+}
 interface InitConfig {
     publicKey: string;
     /**
@@ -36,4 +46,4 @@ declare function initEscrowCheckout(config: InitConfig): void;
  */
 declare function pay(input: PayInput): Promise<void>;
 
-export { type EscrowWidget, type InitConfig, type PayInput, type SessionResponse, initEscrowCheckout, pay };
+export { EscrowCheckoutError, type EscrowCheckoutErrorCode, type EscrowWidget, type InitConfig, type PayInput, type SessionResponse, initEscrowCheckout, pay };

package/dist/index.js

@@ -1,3 +1,3 @@
-export { initEscrowCheckout, pay } from './chunk-CQKTT6UR.js';
+export { EscrowCheckoutError, initEscrowCheckout, pay } from './chunk-TL6HBLNO.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react/index.cjs

@@ -6,17 +6,61 @@ var jsxRuntime = require('react/jsx-runtime');
 // src/react/useEscrowCheckout.ts
 
 // src/index.ts
+var EscrowCheckoutError = class extends Error {
+  constructor(message, code, options) {
+    super(message);
+    this.name = "EscrowCheckoutError";
+    this.code = code;
+    this.status = options?.status;
+    this.details = options?.details;
+  }
+};
 var CONFIG = null;
 function assertConfigured(config) {
   {
-    throw new Error("Escrow checkout not initialized. Call initEscrowCheckout({ apiBaseUrl, publicKey }) first.");
+    throw new EscrowCheckoutError(
+      "Escrow checkout not initialized. Call initEscrowCheckout({ publicKey }) first.",
+      "NOT_INITIALIZED"
+    );
+  }
+}
+function normalizeError(error) {
+  if (error instanceof Error) return error;
+  if (typeof error === "string") return new Error(error);
+  return new Error("Unknown error");
+}
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function isSessionResponse(value) {
+  if (!value || typeof value !== "object") return false;
+  return "session" in value;
+}
+async function parseErrorBody(resp) {
+  const text = await resp.text();
+  if (!text) return {};
+  try {
+    const json = JSON.parse(text);
+    const message = typeof json?.message === "string" ? json.message : void 0;
+    return { message, details: json };
+  } catch {
+    return { message: text, details: text };
+  }
+}
+async function parseJsonResponse(resp) {
+  try {
+    return await resp.json();
+  } catch {
+    throw new EscrowCheckoutError("Invalid JSON response from session endpoint.", "SESSION_RESPONSE", {
+      status: resp.status
+    });
   }
 }
 async function loadWidget() {
   assertConfigured();
   const { scriptUrl, globalName, crossOrigin } = CONFIG;
   if (typeof window === "undefined") {
-    throw new Error("EscrowCheckout can only be loaded in the browser.");
+    throw new EscrowCheckoutError("EscrowCheckout can only be loaded in the browser.", "BROWSER_ONLY");
   }
   const win = window;
   win.__escrowCheckoutLoader ?? (win.__escrowCheckoutLoader = {});
@@ -36,9 +80,16 @@ async function loadWidget() {
     script.onload = () => {
       const fn = win[globalName];
       if (typeof fn === "function") resolve(fn);
-      else reject(new Error(`Escrow checkout script loaded, but window.${globalName} is not a function.`));
+      else {
+        reject(
+          new EscrowCheckoutError(
+            `Escrow checkout script loaded, but window.${globalName} is not a function.`,
+            "WIDGET_LOAD"
+          )
+        );
+      }
     };
-    script.onerror = () => reject(new Error(`Failed to load escrow checkout script: ${scriptUrl}`));
+    script.onerror = () => reject(new EscrowCheckoutError(`Failed to load escrow checkout script: ${scriptUrl}`, "WIDGET_LOAD"));
     document.head.appendChild(script);
   });
   return win.__escrowCheckoutLoader[scriptUrl];
@@ -47,26 +98,54 @@ async function createSession(input) {
   assertConfigured();
   const { publicKey } = CONFIG;
   const apiBaseUrl = publicKey.startsWith("pk_live_") ? "https://live.payluk.ng" : "https://staging.live.payluk.ng";
-  const resp = await fetch(`${apiBaseUrl}/v1/checkout/session`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      paymentToken: input.paymentToken,
-      redirectUrl: input.redirectUrl,
-      reference: input.reference,
-      customerId: input.customerId,
-      publicKey
-    })
-  });
+  let resp;
+  try {
+    resp = await fetch(`${apiBaseUrl}/v1/checkout/session`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        paymentToken: input.paymentToken,
+        redirectUrl: input.redirectUrl,
+        reference: input.reference,
+        customerId: input.customerId,
+        publicKey
+      })
+    });
+  } catch (error) {
+    const normalized = normalizeError(error);
+    throw new EscrowCheckoutError("Network error while creating checkout session.", "NETWORK", {
+      details: normalized.message
+    });
+  }
   if (!resp.ok) {
-    const err = await resp.json().catch(() => ({}));
-    throw new Error(err.message || "Failed to create session");
+    const { message, details } = await parseErrorBody(resp);
+    throw new EscrowCheckoutError(message || `Failed to create session (HTTP ${resp.status}).`, "SESSION_CREATE", {
+      status: resp.status,
+      details
+    });
+  }
+  const data = await parseJsonResponse(resp);
+  if (!isSessionResponse(data)) {
+    throw new EscrowCheckoutError('Session response missing "session".', "SESSION_RESPONSE", {
+      status: resp.status,
+      details: data
+    });
   }
-  return await resp.json();
+  return data;
 }
 async function pay(input) {
   if (typeof window === "undefined") {
-    throw new Error("pay(...) can only run in the browser.");
+    throw new EscrowCheckoutError("pay(...) can only run in the browser.", "BROWSER_ONLY");
+  }
+  assertConfigured();
+  if (!input || !isNonEmptyString(input.paymentToken)) {
+    throw new EscrowCheckoutError('pay(...) requires "paymentToken".', "INVALID_INPUT");
+  }
+  if (!isNonEmptyString(input.reference)) {
+    throw new EscrowCheckoutError('pay(...) requires "reference".', "INVALID_INPUT");
+  }
+  if (!isNonEmptyString(input.redirectUrl)) {
+    throw new EscrowCheckoutError('pay(...) requires "redirectUrl".', "INVALID_INPUT");
   }
   const [{ session }, widget] = await Promise.all([createSession(input), loadWidget()]);
   widget({
@@ -76,6 +155,7 @@ async function pay(input) {
     callback: input.callback,
     onClose: input.onClose,
     customerId: input.customerId,
+    publicKey: CONFIG.publicKey,
     ...input.extra ?? {}
   });
 }
@@ -83,8 +163,13 @@ async function pay(input) {
 // src/react/useEscrowCheckout.ts
 function useEscrowCheckout() {
   const [ready, setReady] = react.useState(false);
-  const [loading, setLoading] = react.useState(() => typeof window !== "undefined");
+  const [loading, setLoading] = react.useState(false);
   const [error, setError] = react.useState(null);
+  const normalizeError2 = react.useCallback((err) => {
+    if (err instanceof Error) return err;
+    if (typeof err === "string") return new Error(err);
+    return new Error("Unknown error");
+  }, []);
   const pay2 = react.useCallback(async (input) => {
     setLoading(true);
     try {
@@ -92,12 +177,13 @@ function useEscrowCheckout() {
       setReady(true);
       setError(null);
     } catch (e) {
-      setError(e);
-      throw e;
+      const normalized = normalizeError2(e);
+      setError(normalized);
+      throw normalized;
     } finally {
       setLoading(false);
     }
-  }, []);
+  }, [normalizeError2]);
   react.useEffect(() => {
     if (typeof window === "undefined") {
       setLoading(false);
@@ -120,28 +206,31 @@ function EscrowCheckoutButton({
   title,
   customerId
 }) {
-  const { ready, loading, error, pay: pay2 } = useEscrowCheckout();
+  const { loading, error, pay: pay2 } = useEscrowCheckout();
   const handleClick = react.useCallback(async () => {
-    await pay2({
-      paymentToken,
-      reference,
-      redirectUrl,
-      brand,
-      logoUrl,
-      callback,
-      onClose,
-      extra,
-      customerId
-    });
+    try {
+      await pay2({
+        paymentToken,
+        reference,
+        redirectUrl,
+        brand,
+        logoUrl,
+        callback,
+        onClose,
+        extra,
+        customerId
+      });
+    } catch {
+    }
   }, [pay2, paymentToken, reference, redirectUrl, brand, logoUrl, callback, onClose, extra, customerId]);
   return /* @__PURE__ */ jsxRuntime.jsx(
     "button",
     {
       type: "button",
       onClick: handleClick,
-      disabled: disabled || loading || !ready,
+      disabled: disabled || loading,
       className,
-      "aria-disabled": disabled || loading || !ready,
+      "aria-disabled": disabled || loading,
       title: title ?? (error ? error.message : void 0),
       children
     }

package/dist/react/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/react/useEscrowCheckout.ts","../../src/react/EscrowCheckoutButton.tsx"],"names":["useState","pay","useCallback","useEffect","useMemo","jsx"],"mappings":"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","file":"index.cjs","sourcesContent":["export type EscrowWidget = (options: Record<string, unknown>) => void;\r\n\r\nexport interface InitConfig {\r\n    publicKey: string; // publishable key only\r\n    /**\r\n     * Optional overrides for experts. End users don't need to set these.\r\n     */\r\n    scriptUrlOverride?: string;\r\n    globalName?: string; // default 'EscrowCheckout'\r\n    crossOrigin?: '' | 'anonymous' | 'use-credentials';\r\n}\r\n\r\nexport interface PayInput {\r\n    paymentToken: string;\r\n    reference: string;\r\n    redirectUrl: string;\r\n    logoUrl?: string;\r\n    brand?: string;\r\n    customerId?: string;\r\n    /**\r\n     * Extra fields supported by the widget.\r\n     */\r\n    extra?: Record<string, unknown>;\r\n    callback?: (result: any) => void;\r\n    onClose?: () => void;\r\n}\r\n\r\nexport interface SessionResponse {\r\n    session: unknown;\r\n}\r\n\r\nconst DEFAULT_SCRIPT_URL = 'https://checkout.payluk.ng/escrow-checkout.min.js';\r\nconst DEFAULT_GLOBAL_NAME = 'EscrowCheckout';\r\n\r\ntype ResolvedConfig = Required<Pick<InitConfig, 'publicKey'>> & {\r\n    scriptUrl: string;\r\n    globalName: string;\r\n    crossOrigin: '' | 'anonymous' | 'use-credentials';\r\n};\r\n\r\nlet CONFIG: ResolvedConfig | null = null;\r\n\r\n/**\r\n * Initialize the library once (e.g., in app bootstrap).\r\n * Hides script URL and session creation from consumers.\r\n */\r\nexport function initEscrowCheckout(config: InitConfig): void {\r\n    if (!config?.publicKey) throw new Error('initEscrowCheckout: \"publicKey\" is required.');\r\n    CONFIG = {\r\n        publicKey: config.publicKey,\r\n        scriptUrl: config.scriptUrlOverride || DEFAULT_SCRIPT_URL,\r\n        globalName: config.globalName || DEFAULT_GLOBAL_NAME,\r\n        crossOrigin: config.crossOrigin ?? 'anonymous'\r\n    };\r\n}\r\n\r\n/**\r\n * Narrow a provided config to ResolvedConfig or throw if not initialized.\r\n */\r\nfunction assertConfigured(config: ResolvedConfig | null): asserts config is ResolvedConfig {\r\n    if (!config) {\r\n        throw new Error('Escrow checkout not initialized. Call initEscrowCheckout({ apiBaseUrl, publicKey }) first.');\r\n    }\r\n}\r\n\r\n/**\r\n * Internal: load the widget script once and return the global function.\r\n */\r\nasync function loadWidget(): Promise<EscrowWidget> {\r\n    assertConfigured(CONFIG);\r\n    const { scriptUrl, globalName, crossOrigin } = CONFIG;\r\n\r\n    if (typeof window === 'undefined') {\r\n        throw new Error('EscrowCheckout can only be loaded in the browser.');\r\n    }\r\n\r\n    const win = window as any;\r\n    win.__escrowCheckoutLoader ??= {};\r\n\r\n    if (win.__escrowCheckoutLoader[scriptUrl]) {\r\n        return win.__escrowCheckoutLoader[scriptUrl];\r\n    }\r\n\r\n    if (typeof win[globalName] === 'function') {\r\n        const fn = win[globalName] as EscrowWidget;\r\n        win.__escrowCheckoutLoader[scriptUrl] = Promise.resolve(fn);\r\n        return fn;\r\n    }\r\n\r\n    win.__escrowCheckoutLoader[scriptUrl] = new Promise<EscrowWidget>((resolve, reject) => {\r\n        const script = document.createElement('script');\r\n        script.src = scriptUrl;\r\n        script.async = true;\r\n        if (crossOrigin) script.crossOrigin = crossOrigin;\r\n\r\n        script.onload = () => {\r\n            const fn = win[globalName];\r\n            if (typeof fn === 'function') resolve(fn as EscrowWidget);\r\n            else reject(new Error(`Escrow checkout script loaded, but window.${globalName} is not a function.`));\r\n        };\r\n\r\n        script.onerror = () => reject(new Error(`Failed to load escrow checkout script: ${scriptUrl}`));\r\n\r\n        document.head.appendChild(script);\r\n    });\r\n\r\n    return win.__escrowCheckoutLoader[scriptUrl];\r\n}\r\n\r\n/**\r\n * Internal: create a checkout session by calling your API.\r\n * This is intentionally inside the lib (user doesn't implement it).\r\n */\r\nasync function createSession(input: PayInput): Promise<SessionResponse> {\r\n    assertConfigured(CONFIG);\r\n    const { publicKey } = CONFIG;\r\n    const apiBaseUrl = publicKey.startsWith(\"pk_live_\") ? 'https://live.payluk.ng' : 'https://staging.live.payluk.ng';\r\n\r\n    const resp = await fetch(`${apiBaseUrl}/v1/checkout/session`, {\r\n        method: 'POST',\r\n        headers: { 'Content-Type': 'application/json' },\r\n        body: JSON.stringify({\r\n            paymentToken: input.paymentToken,\r\n            redirectUrl: input.redirectUrl,\r\n            reference: input.reference,\r\n            customerId: input.customerId,\r\n            publicKey\r\n        })\r\n    });\r\n\r\n    if (!resp.ok) {\r\n        const err = await resp.json().catch(() => ({}));\r\n        throw new Error(err.message || 'Failed to create session');\r\n    }\r\n\r\n    return (await resp.json()) as SessionResponse;\r\n}\r\n\r\n/**\r\n * Public API: create the session and open the widget.\r\n * Consumers only supply business inputs (no script URL, no API calls).\r\n */\r\nexport async function pay(input: PayInput): Promise<void> {\r\n    if (typeof window === 'undefined') {\r\n        throw new Error('pay(...) can only run in the browser.');\r\n    }\r\n\r\n    const [{ session }, widget] = await Promise.all([createSession(input), loadWidget()]);\r\n\r\n    widget({\r\n        session,\r\n        logoUrl: input.logoUrl,\r\n        brand: input.brand,\r\n        callback: input.callback,\r\n        onClose: input.onClose,\r\n        customerId: input.customerId,\r\n        ...(input.extra ?? {})\r\n    });\r\n}","import { useCallback, useEffect, useMemo, useState } from 'react';\r\nimport { pay as corePay } from '../index';\r\n\r\nexport interface UseEscrowCheckoutResult {\r\n    ready: boolean;\r\n    loading: boolean;\r\n    error: Error | null;\r\n    pay: typeof corePay;\r\n}\r\n\r\n/**\r\n * React hook that preloads the widget script (implicitly via pay) and exposes pay(...)\r\n * Since the library abstracts script loading and session creation, the hook is thin.\r\n */\r\nexport function useEscrowCheckout(): UseEscrowCheckoutResult {\r\n    const [ready, setReady] = useState(false);\r\n    const [loading, setLoading] = useState<boolean>(() => typeof window !== 'undefined');\r\n    const [error, setError] = useState<Error | null>(null);\r\n\r\n    // Lazy mark \"ready\" after first successful pay or script load attempt.\r\n    // If you want to preload the script earlier, you may trigger a no-op pay with a dry-run endpoint on your side.\r\n\r\n    // Provide a stable pay function that reports loading state.\r\n    const pay = useCallback<typeof corePay>(async (input) => {\r\n        setLoading(true);\r\n        try {\r\n            await corePay(input);\r\n            setReady(true);\r\n            setError(null);\r\n        } catch (e) {\r\n            setError(e as Error);\r\n            throw e;\r\n        } finally {\r\n            setLoading(false);\r\n        }\r\n    }, []);\r\n\r\n    // In SSR, mark not loading\r\n    useEffect(() => {\r\n        if (typeof window === 'undefined') {\r\n            setLoading(false);\r\n        }\r\n    }, []);\r\n\r\n    return useMemo(() => ({ ready, loading, error, pay }), [ready, loading, error, pay]);\r\n}","import React, { useCallback } from 'react';\r\nimport { useEscrowCheckout } from './useEscrowCheckout';\r\n\r\nexport interface EscrowCheckoutButtonProps {\r\n    paymentToken: string;\r\n    reference: string;\r\n    redirectUrl: string;\r\n    children?: React.ReactNode;\r\n    disabled?: boolean;\r\n    className?: string;\r\n    title?: string;\r\n\r\n    brand?: string;\r\n    customerId?: string;\r\n    logoUrl?: string;\r\n    callback?: (result: any) => void;\r\n    onClose?: () => void;\r\n    extra?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Button that triggers pay(...) with your provided inputs.\r\n * The library handles both session creation and widget loading.\r\n */\r\nexport function EscrowCheckoutButton({\r\n                                         paymentToken,\r\n                                         reference,\r\n                                         redirectUrl,\r\n                                         brand,\r\n                                         logoUrl,\r\n                                         callback,\r\n                                         onClose,\r\n                                         extra,\r\n                                         children = 'Pay',\r\n                                         disabled,\r\n                                         className,\r\n                                         title,\r\n                                         customerId\r\n                                     }: EscrowCheckoutButtonProps) {\r\n    const { ready, loading, error, pay } = useEscrowCheckout();\r\n\r\n    const handleClick = useCallback(async () => {\r\n        await pay({\r\n            paymentToken,\r\n            reference,\r\n            redirectUrl,\r\n            brand,\r\n            logoUrl,\r\n            callback,\r\n            onClose,\r\n            extra,\r\n            customerId\r\n        });\r\n    }, [pay, paymentToken, reference, redirectUrl, brand, logoUrl, callback, onClose, extra, customerId]);\r\n\r\n    return (\r\n        <button\r\n            type=\"button\"\r\n            onClick={handleClick}\r\n            disabled={disabled || loading || !ready /* ready becomes true after first successful load */}\r\n            className={className}\r\n            aria-disabled={disabled || loading || !ready}\r\n            title={title ?? (error ? error.message : undefined)}\r\n        >\r\n            {children}\r\n        </button>\r\n    );\r\n}"]}
+{"version":3,"sources":["../../src/index.ts","../../src/react/useEscrowCheckout.ts","../../src/react/EscrowCheckoutButton.tsx"],"names":["useState","normalizeError","useCallback","pay","useEffect","useMemo","jsx"],"mappings":"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","file":"index.cjs","sourcesContent":["export type EscrowWidget = (options: Record<string, unknown>) => void;\n\nexport type EscrowCheckoutErrorCode =\n    | 'NOT_INITIALIZED'\n    | 'BROWSER_ONLY'\n    | 'INVALID_INPUT'\n    | 'WIDGET_LOAD'\n    | 'NETWORK'\n    | 'SESSION_CREATE'\n    | 'SESSION_RESPONSE';\n\nexport class EscrowCheckoutError extends Error {\n    code: EscrowCheckoutErrorCode;\n    status?: number;\n    details?: unknown;\n\n    constructor(message: string, code: EscrowCheckoutErrorCode, options?: { status?: number; details?: unknown }) {\n        super(message);\n        this.name = 'EscrowCheckoutError';\n        this.code = code;\n        this.status = options?.status;\n        this.details = options?.details;\n    }\n}\n\nexport interface InitConfig {\n    publicKey: string; // publishable key only\n    /**\n     * Optional overrides for experts. End users don't need to set these.\n     */\n    scriptUrlOverride?: string;\r\n    globalName?: string; // default 'EscrowCheckout'\r\n    crossOrigin?: '' | 'anonymous' | 'use-credentials';\r\n}\r\n\r\nexport interface PayInput {\r\n    paymentToken: string;\r\n    reference: string;\r\n    redirectUrl: string;\r\n    logoUrl?: string;\r\n    brand?: string;\r\n    customerId?: string;\r\n    /**\r\n     * Extra fields supported by the widget.\r\n     */\r\n    extra?: Record<string, unknown>;\r\n    callback?: (result: any) => void;\r\n    onClose?: () => void;\r\n}\r\n\r\nexport interface SessionResponse {\r\n    session: unknown;\r\n}\r\n\r\nconst DEFAULT_SCRIPT_URL = 'https://checkout.payluk.ng/escrow-checkout.min.js';\r\nconst DEFAULT_GLOBAL_NAME = 'EscrowCheckout';\r\n\r\ntype ResolvedConfig = Required<Pick<InitConfig, 'publicKey'>> & {\r\n    scriptUrl: string;\r\n    globalName: string;\r\n    crossOrigin: '' | 'anonymous' | 'use-credentials';\r\n};\r\n\r\nlet CONFIG: ResolvedConfig | null = null;\r\n\r\n/**\r\n * Initialize the library once (e.g., in app bootstrap).\r\n * Hides script URL and session creation from consumers.\r\n */\r\nexport function initEscrowCheckout(config: InitConfig): void {\n    if (!isNonEmptyString(config?.publicKey)) {\n        throw new EscrowCheckoutError('initEscrowCheckout(...) requires \"publicKey\".', 'INVALID_INPUT');\n    }\n    CONFIG = {\n        publicKey: config.publicKey.trim(),\n        scriptUrl: config.scriptUrlOverride || DEFAULT_SCRIPT_URL,\n        globalName: config.globalName || DEFAULT_GLOBAL_NAME,\n        crossOrigin: config.crossOrigin ?? 'anonymous'\n    };\n}\n\r\n/**\r\n * Narrow a provided config to ResolvedConfig or throw if not initialized.\r\n */\r\nfunction assertConfigured(config: ResolvedConfig | null): asserts config is ResolvedConfig {\n    if (!config) {\n        throw new EscrowCheckoutError(\n            'Escrow checkout not initialized. Call initEscrowCheckout({ publicKey }) first.',\n            'NOT_INITIALIZED'\n        );\n    }\n}\n\nfunction normalizeError(error: unknown): Error {\n    if (error instanceof Error) return error;\n    if (typeof error === 'string') return new Error(error);\n    return new Error('Unknown error');\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n    return typeof value === 'string' && value.trim().length > 0;\n}\n\nfunction isSessionResponse(value: unknown): value is SessionResponse {\n    if (!value || typeof value !== 'object') return false;\n    return 'session' in value;\n}\n\nasync function parseErrorBody(resp: Response): Promise<{ message?: string; details?: unknown }> {\n    const text = await resp.text();\n    if (!text) return {};\n\n    try {\n        const json = JSON.parse(text) as { message?: unknown };\n        const message = typeof json?.message === 'string' ? json.message : undefined;\n        return { message, details: json };\n    } catch {\n        return { message: text, details: text };\n    }\n}\n\nasync function parseJsonResponse(resp: Response): Promise<unknown> {\n    try {\n        return await resp.json();\n    } catch {\n        throw new EscrowCheckoutError('Invalid JSON response from session endpoint.', 'SESSION_RESPONSE', {\n            status: resp.status\n        });\n    }\n}\n\n/**\n * Internal: load the widget script once and return the global function.\n */\nasync function loadWidget(): Promise<EscrowWidget> {\n    assertConfigured(CONFIG);\n    const { scriptUrl, globalName, crossOrigin } = CONFIG;\r\n\r\n    if (typeof window === 'undefined') {\n        throw new EscrowCheckoutError('EscrowCheckout can only be loaded in the browser.', 'BROWSER_ONLY');\n    }\n\r\n    const win = window as any;\r\n    win.__escrowCheckoutLoader ??= {};\r\n\r\n    if (win.__escrowCheckoutLoader[scriptUrl]) {\r\n        return win.__escrowCheckoutLoader[scriptUrl];\r\n    }\r\n\r\n    if (typeof win[globalName] === 'function') {\r\n        const fn = win[globalName] as EscrowWidget;\r\n        win.__escrowCheckoutLoader[scriptUrl] = Promise.resolve(fn);\r\n        return fn;\r\n    }\r\n\r\n    win.__escrowCheckoutLoader[scriptUrl] = new Promise<EscrowWidget>((resolve, reject) => {\r\n        const script = document.createElement('script');\r\n        script.src = scriptUrl;\r\n        script.async = true;\r\n        if (crossOrigin) script.crossOrigin = crossOrigin;\r\n\r\n        script.onload = () => {\r\n            const fn = win[globalName];\r\n            if (typeof fn === 'function') resolve(fn as EscrowWidget);\n            else {\n                reject(\n                    new EscrowCheckoutError(\n                        `Escrow checkout script loaded, but window.${globalName} is not a function.`,\n                        'WIDGET_LOAD'\n                    )\n                );\n            }\n        };\n\n        script.onerror = () =>\n            reject(new EscrowCheckoutError(`Failed to load escrow checkout script: ${scriptUrl}`, 'WIDGET_LOAD'));\n\n        document.head.appendChild(script);\n    });\n\r\n    return win.__escrowCheckoutLoader[scriptUrl];\r\n}\r\n\r\n/**\r\n * Internal: create a checkout session by calling your API.\r\n * This is intentionally inside the lib (user doesn't implement it).\r\n */\r\nasync function createSession(input: PayInput): Promise<SessionResponse> {\n    assertConfigured(CONFIG);\n    const { publicKey } = CONFIG;\n    const apiBaseUrl = publicKey.startsWith('pk_live_') ? 'https://live.payluk.ng' : 'https://staging.live.payluk.ng';\n    let resp: Response;\n\n    try {\n        resp = await fetch(`${apiBaseUrl}/v1/checkout/session`, {\n            method: 'POST',\n            headers: { 'Content-Type': 'application/json' },\n            body: JSON.stringify({\n                paymentToken: input.paymentToken,\n                redirectUrl: input.redirectUrl,\n                reference: input.reference,\n                customerId: input.customerId,\n                publicKey\n            })\n        });\n    } catch (error) {\n        const normalized = normalizeError(error);\n        throw new EscrowCheckoutError('Network error while creating checkout session.', 'NETWORK', {\n            details: normalized.message\n        });\n    }\n\n    if (!resp.ok) {\n        const { message, details } = await parseErrorBody(resp);\n        throw new EscrowCheckoutError(message || `Failed to create session (HTTP ${resp.status}).`, 'SESSION_CREATE', {\n            status: resp.status,\n            details\n        });\n    }\n\n    const data = await parseJsonResponse(resp);\n    if (!isSessionResponse(data)) {\n        throw new EscrowCheckoutError('Session response missing \"session\".', 'SESSION_RESPONSE', {\n            status: resp.status,\n            details: data\n        });\n    }\n\n    return data as SessionResponse;\n}\n\r\n/**\r\n * Public API: create the session and open the widget.\r\n * Consumers only supply business inputs (no script URL, no API calls).\r\n */\r\nexport async function pay(input: PayInput): Promise<void> {\n    if (typeof window === 'undefined') {\n        throw new EscrowCheckoutError('pay(...) can only run in the browser.', 'BROWSER_ONLY');\n    }\n\n    assertConfigured(CONFIG);\n    if (!input || !isNonEmptyString(input.paymentToken)) {\n        throw new EscrowCheckoutError('pay(...) requires \"paymentToken\".', 'INVALID_INPUT');\n    }\n    if (!isNonEmptyString(input.reference)) {\n        throw new EscrowCheckoutError('pay(...) requires \"reference\".', 'INVALID_INPUT');\n    }\n    if (!isNonEmptyString(input.redirectUrl)) {\n        throw new EscrowCheckoutError('pay(...) requires \"redirectUrl\".', 'INVALID_INPUT');\n    }\n\n    const [{ session }, widget] = await Promise.all([createSession(input), loadWidget()]);\n\n    widget({\n        session,\n        logoUrl: input.logoUrl,\n        brand: input.brand,\n        callback: input.callback,\n        onClose: input.onClose,\n        customerId: input.customerId,\n        publicKey: CONFIG.publicKey,\n        ...(input.extra ?? {})\n    });\n}\n","import { useCallback, useEffect, useMemo, useState } from 'react';\r\nimport { pay as corePay } from '../index';\r\n\r\nexport interface UseEscrowCheckoutResult {\r\n    ready: boolean;\r\n    loading: boolean;\r\n    error: Error | null;\r\n    pay: typeof corePay;\r\n}\r\n\r\n/**\r\n * React hook that preloads the widget script (implicitly via pay) and exposes pay(...)\r\n * Since the library abstracts script loading and session creation, the hook is thin.\r\n */\r\nexport function useEscrowCheckout(): UseEscrowCheckoutResult {\n    const [ready, setReady] = useState(false);\n    const [loading, setLoading] = useState(false);\n    const [error, setError] = useState<Error | null>(null);\n\n    const normalizeError = useCallback((err: unknown): Error => {\n        if (err instanceof Error) return err;\n        if (typeof err === 'string') return new Error(err);\n        return new Error('Unknown error');\n    }, []);\n\n    // Lazy mark \"ready\" after first successful pay or script load attempt.\n    // If you want to preload the script earlier, you may trigger a no-op pay with a dry-run endpoint on your side.\n\n    // Provide a stable pay function that reports loading state.\n    const pay = useCallback<typeof corePay>(async (input) => {\n        setLoading(true);\r\n        try {\r\n            await corePay(input);\n            setReady(true);\n            setError(null);\n        } catch (e) {\n            const normalized = normalizeError(e);\n            setError(normalized);\n            throw normalized;\n        } finally {\n            setLoading(false);\n        }\n    }, [normalizeError]);\n\r\n    // In SSR, mark not loading\n    useEffect(() => {\n        if (typeof window === 'undefined') {\n            setLoading(false);\n        }\n    }, []);\n\r\n    return useMemo(() => ({ ready, loading, error, pay }), [ready, loading, error, pay]);\r\n}\n","import React, { useCallback } from 'react';\r\nimport { useEscrowCheckout } from './useEscrowCheckout';\r\n\r\nexport interface EscrowCheckoutButtonProps {\r\n    paymentToken: string;\r\n    reference: string;\r\n    redirectUrl: string;\r\n    children?: React.ReactNode;\r\n    disabled?: boolean;\r\n    className?: string;\r\n    title?: string;\r\n\r\n    brand?: string;\r\n    customerId?: string;\r\n    logoUrl?: string;\r\n    callback?: (result: any) => void;\r\n    onClose?: () => void;\r\n    extra?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Button that triggers pay(...) with your provided inputs.\r\n * The library handles both session creation and widget loading.\r\n */\r\nexport function EscrowCheckoutButton({\r\n                                         paymentToken,\r\n                                         reference,\r\n                                         redirectUrl,\r\n                                         brand,\r\n                                         logoUrl,\r\n                                         callback,\r\n                                         onClose,\r\n                                         extra,\r\n                                         children = 'Pay',\r\n                                         disabled,\r\n                                         className,\r\n                                         title,\r\n                                         customerId\r\n                                     }: EscrowCheckoutButtonProps) {\r\n    const { loading, error, pay } = useEscrowCheckout();\n\n    const handleClick = useCallback(async () => {\n        try {\n            await pay({\n                paymentToken,\n                reference,\n                redirectUrl,\n                brand,\n                logoUrl,\n                callback,\n                onClose,\n                extra,\n                customerId\n            });\n        } catch {\n            // Error state is already exposed via the hook.\n        }\n    }, [pay, paymentToken, reference, redirectUrl, brand, logoUrl, callback, onClose, extra, customerId]);\n\r\n    return (\r\n        <button\r\n            type=\"button\"\n            onClick={handleClick}\n            disabled={disabled || loading}\n            className={className}\n            aria-disabled={disabled || loading}\n            title={title ?? (error ? error.message : undefined)}\n        >\n            {children}\n        </button>\n    );\r\n}\n"]}

package/dist/react/index.js

@@ -1,11 +1,16 @@
-import { pay } from '../chunk-CQKTT6UR.js';
+import { pay } from '../chunk-TL6HBLNO.js';
 import { useState, useCallback, useEffect, useMemo } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
 function useEscrowCheckout() {
   const [ready, setReady] = useState(false);
-  const [loading, setLoading] = useState(() => typeof window !== "undefined");
+  const [loading, setLoading] = useState(false);
   const [error, setError] = useState(null);
+  const normalizeError = useCallback((err) => {
+    if (err instanceof Error) return err;
+    if (typeof err === "string") return new Error(err);
+    return new Error("Unknown error");
+  }, []);
   const pay2 = useCallback(async (input) => {
     setLoading(true);
     try {
@@ -13,12 +18,13 @@ function useEscrowCheckout() {
       setReady(true);
       setError(null);
     } catch (e) {
-      setError(e);
-      throw e;
+      const normalized = normalizeError(e);
+      setError(normalized);
+      throw normalized;
     } finally {
       setLoading(false);
     }
-  }, []);
+  }, [normalizeError]);
   useEffect(() => {
     if (typeof window === "undefined") {
       setLoading(false);
@@ -41,28 +47,31 @@ function EscrowCheckoutButton({
   title,
   customerId
 }) {
-  const { ready, loading, error, pay: pay2 } = useEscrowCheckout();
+  const { loading, error, pay: pay2 } = useEscrowCheckout();
   const handleClick = useCallback(async () => {
-    await pay2({
-      paymentToken,
-      reference,
-      redirectUrl,
-      brand,
-      logoUrl,
-      callback,
-      onClose,
-      extra,
-      customerId
-    });
+    try {
+      await pay2({
+        paymentToken,
+        reference,
+        redirectUrl,
+        brand,
+        logoUrl,
+        callback,
+        onClose,
+        extra,
+        customerId
+      });
+    } catch {
+    }
   }, [pay2, paymentToken, reference, redirectUrl, brand, logoUrl, callback, onClose, extra, customerId]);
   return /* @__PURE__ */ jsx(
     "button",
     {
       type: "button",
       onClick: handleClick,
-      disabled: disabled || loading || !ready,
+      disabled: disabled || loading,
       className,
-      "aria-disabled": disabled || loading || !ready,
+      "aria-disabled": disabled || loading,
       title: title ?? (error ? error.message : void 0),
       children
     }

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react/useEscrowCheckout.ts","../../src/react/EscrowCheckoutButton.tsx"],"names":["pay","useCallback"],"mappings":";;;;AAcO,SAAS,iBAAA,GAA6C;AACzD,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAAS,KAAK,CAAA;AACxC,EAAA,MAAM,CAAC,SAAS,UAAU,CAAA,GAAI,SAAkB,MAAM,OAAO,WAAW,WAAW,CAAA;AACnF,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAAuB,IAAI,CAAA;AAMrD,EAAA,MAAMA,IAAAA,GAAM,WAAA,CAA4B,OAAO,KAAA,KAAU;AACrD,IAAA,UAAA,CAAW,IAAI,CAAA;AACf,IAAA,IAAI;AACA,MAAA,MAAM,IAAQ,KAAK,CAAA;AACnB,MAAA,QAAA,CAAS,IAAI,CAAA;AACb,MAAA,QAAA,CAAS,IAAI,CAAA;AAAA,IACjB,SAAS,CAAA,EAAG;AACR,MAAA,QAAA,CAAS,CAAU,CAAA;AACnB,MAAA,MAAM,CAAA;AAAA,IACV,CAAA,SAAE;AACE,MAAA,UAAA,CAAW,KAAK,CAAA;AAAA,IACpB;AAAA,EACJ,CAAA,EAAG,EAAE,CAAA;AAGL,EAAA,SAAA,CAAU,MAAM;AACZ,IAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AAC/B,MAAA,UAAA,CAAW,KAAK,CAAA;AAAA,IACpB;AAAA,EACJ,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,OAAA,CAAQ,OAAO,EAAE,KAAA,EAAO,SAAS,KAAA,EAAO,GAAA,EAAAA,IAAAA,EAAI,CAAA,EAAI,CAAC,KAAA,EAAO,OAAA,EAAS,KAAA,EAAOA,IAAG,CAAC,CAAA;AACvF;ACrBO,SAAS,oBAAA,CAAqB;AAAA,EACI,YAAA;AAAA,EACA,SAAA;AAAA,EACA,WAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA,KAAA;AAAA,EACA,QAAA,GAAW,KAAA;AAAA,EACX,QAAA;AAAA,EACA,SAAA;AAAA,EACA,KAAA;AAAA,EACA;AACJ,CAAA,EAA8B;AAC/D,EAAA,MAAM,EAAE,KAAA,EAAO,OAAA,EAAS,OAAO,GAAA,EAAAA,IAAAA,KAAQ,iBAAA,EAAkB;AAEzD,EAAA,MAAM,WAAA,GAAcC,YAAY,YAAY;AACxC,IAAA,MAAMD,IAAAA,CAAI;AAAA,MACN,YAAA;AAAA,MACA,SAAA;AAAA,MACA,WAAA;AAAA,MACA,KAAA;AAAA,MACA,OAAA;AAAA,MACA,QAAA;AAAA,MACA,OAAA;AAAA,MACA,KAAA;AAAA,MACA;AAAA,KACH,CAAA;AAAA,EACL,CAAA,EAAG,CAACA,IAAAA,EAAK,YAAA,EAAc,SAAA,EAAW,WAAA,EAAa,KAAA,EAAO,OAAA,EAAS,QAAA,EAAU,OAAA,EAAS,KAAA,EAAO,UAAU,CAAC,CAAA;AAEpG,EAAA,uBACI,GAAA;AAAA,IAAC,QAAA;AAAA,IAAA;AAAA,MACG,IAAA,EAAK,QAAA;AAAA,MACL,OAAA,EAAS,WAAA;AAAA,MACT,QAAA,EAAU,QAAA,IAAY,OAAA,IAAW,CAAC,KAAA;AAAA,MAClC,SAAA;AAAA,MACA,eAAA,EAAe,QAAA,IAAY,OAAA,IAAW,CAAC,KAAA;AAAA,MACvC,KAAA,EAAO,KAAA,KAAU,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,MAAA,CAAA;AAAA,MAExC;AAAA;AAAA,GACL;AAER","file":"index.js","sourcesContent":["import { useCallback, useEffect, useMemo, useState } from 'react';\r\nimport { pay as corePay } from '../index';\r\n\r\nexport interface UseEscrowCheckoutResult {\r\n    ready: boolean;\r\n    loading: boolean;\r\n    error: Error | null;\r\n    pay: typeof corePay;\r\n}\r\n\r\n/**\r\n * React hook that preloads the widget script (implicitly via pay) and exposes pay(...)\r\n * Since the library abstracts script loading and session creation, the hook is thin.\r\n */\r\nexport function useEscrowCheckout(): UseEscrowCheckoutResult {\r\n    const [ready, setReady] = useState(false);\r\n    const [loading, setLoading] = useState<boolean>(() => typeof window !== 'undefined');\r\n    const [error, setError] = useState<Error | null>(null);\r\n\r\n    // Lazy mark \"ready\" after first successful pay or script load attempt.\r\n    // If you want to preload the script earlier, you may trigger a no-op pay with a dry-run endpoint on your side.\r\n\r\n    // Provide a stable pay function that reports loading state.\r\n    const pay = useCallback<typeof corePay>(async (input) => {\r\n        setLoading(true);\r\n        try {\r\n            await corePay(input);\r\n            setReady(true);\r\n            setError(null);\r\n        } catch (e) {\r\n            setError(e as Error);\r\n            throw e;\r\n        } finally {\r\n            setLoading(false);\r\n        }\r\n    }, []);\r\n\r\n    // In SSR, mark not loading\r\n    useEffect(() => {\r\n        if (typeof window === 'undefined') {\r\n            setLoading(false);\r\n        }\r\n    }, []);\r\n\r\n    return useMemo(() => ({ ready, loading, error, pay }), [ready, loading, error, pay]);\r\n}","import React, { useCallback } from 'react';\r\nimport { useEscrowCheckout } from './useEscrowCheckout';\r\n\r\nexport interface EscrowCheckoutButtonProps {\r\n    paymentToken: string;\r\n    reference: string;\r\n    redirectUrl: string;\r\n    children?: React.ReactNode;\r\n    disabled?: boolean;\r\n    className?: string;\r\n    title?: string;\r\n\r\n    brand?: string;\r\n    customerId?: string;\r\n    logoUrl?: string;\r\n    callback?: (result: any) => void;\r\n    onClose?: () => void;\r\n    extra?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Button that triggers pay(...) with your provided inputs.\r\n * The library handles both session creation and widget loading.\r\n */\r\nexport function EscrowCheckoutButton({\r\n                                         paymentToken,\r\n                                         reference,\r\n                                         redirectUrl,\r\n                                         brand,\r\n                                         logoUrl,\r\n                                         callback,\r\n                                         onClose,\r\n                                         extra,\r\n                                         children = 'Pay',\r\n                                         disabled,\r\n                                         className,\r\n                                         title,\r\n                                         customerId\r\n                                     }: EscrowCheckoutButtonProps) {\r\n    const { ready, loading, error, pay } = useEscrowCheckout();\r\n\r\n    const handleClick = useCallback(async () => {\r\n        await pay({\r\n            paymentToken,\r\n            reference,\r\n            redirectUrl,\r\n            brand,\r\n            logoUrl,\r\n            callback,\r\n            onClose,\r\n            extra,\r\n            customerId\r\n        });\r\n    }, [pay, paymentToken, reference, redirectUrl, brand, logoUrl, callback, onClose, extra, customerId]);\r\n\r\n    return (\r\n        <button\r\n            type=\"button\"\r\n            onClick={handleClick}\r\n            disabled={disabled || loading || !ready /* ready becomes true after first successful load */}\r\n            className={className}\r\n            aria-disabled={disabled || loading || !ready}\r\n            title={title ?? (error ? error.message : undefined)}\r\n        >\r\n            {children}\r\n        </button>\r\n    );\r\n}"]}
+{"version":3,"sources":["../../src/react/useEscrowCheckout.ts","../../src/react/EscrowCheckoutButton.tsx"],"names":["pay","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["import { useCallback, useEffect, useMemo, useState } from 'react';\r\nimport { pay as corePay } from '../index';\r\n\r\nexport interface UseEscrowCheckoutResult {\r\n    ready: boolean;\r\n    loading: boolean;\r\n    error: Error | null;\r\n    pay: typeof corePay;\r\n}\r\n\r\n/**\r\n * React hook that preloads the widget script (implicitly via pay) and exposes pay(...)\r\n * Since the library abstracts script loading and session creation, the hook is thin.\r\n */\r\nexport function useEscrowCheckout(): UseEscrowCheckoutResult {\n    const [ready, setReady] = useState(false);\n    const [loading, setLoading] = useState(false);\n    const [error, setError] = useState<Error | null>(null);\n\n    const normalizeError = useCallback((err: unknown): Error => {\n        if (err instanceof Error) return err;\n        if (typeof err === 'string') return new Error(err);\n        return new Error('Unknown error');\n    }, []);\n\n    // Lazy mark \"ready\" after first successful pay or script load attempt.\n    // If you want to preload the script earlier, you may trigger a no-op pay with a dry-run endpoint on your side.\n\n    // Provide a stable pay function that reports loading state.\n    const pay = useCallback<typeof corePay>(async (input) => {\n        setLoading(true);\r\n        try {\r\n            await corePay(input);\n            setReady(true);\n            setError(null);\n        } catch (e) {\n            const normalized = normalizeError(e);\n            setError(normalized);\n            throw normalized;\n        } finally {\n            setLoading(false);\n        }\n    }, [normalizeError]);\n\r\n    // In SSR, mark not loading\n    useEffect(() => {\n        if (typeof window === 'undefined') {\n            setLoading(false);\n        }\n    }, []);\n\r\n    return useMemo(() => ({ ready, loading, error, pay }), [ready, loading, error, pay]);\r\n}\n","import React, { useCallback } from 'react';\r\nimport { useEscrowCheckout } from './useEscrowCheckout';\r\n\r\nexport interface EscrowCheckoutButtonProps {\r\n    paymentToken: string;\r\n    reference: string;\r\n    redirectUrl: string;\r\n    children?: React.ReactNode;\r\n    disabled?: boolean;\r\n    className?: string;\r\n    title?: string;\r\n\r\n    brand?: string;\r\n    customerId?: string;\r\n    logoUrl?: string;\r\n    callback?: (result: any) => void;\r\n    onClose?: () => void;\r\n    extra?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Button that triggers pay(...) with your provided inputs.\r\n * The library handles both session creation and widget loading.\r\n */\r\nexport function EscrowCheckoutButton({\r\n                                         paymentToken,\r\n                                         reference,\r\n                                         redirectUrl,\r\n                                         brand,\r\n                                         logoUrl,\r\n                                         callback,\r\n                                         onClose,\r\n                                         extra,\r\n                                         children = 'Pay',\r\n                                         disabled,\r\n                                         className,\r\n                                         title,\r\n                                         customerId\r\n                                     }: EscrowCheckoutButtonProps) {\r\n    const { loading, error, pay } = useEscrowCheckout();\n\n    const handleClick = useCallback(async () => {\n        try {\n            await pay({\n                paymentToken,\n                reference,\n                redirectUrl,\n                brand,\n                logoUrl,\n                callback,\n                onClose,\n                extra,\n                customerId\n            });\n        } catch {\n            // Error state is already exposed via the hook.\n        }\n    }, [pay, paymentToken, reference, redirectUrl, brand, logoUrl, callback, onClose, extra, customerId]);\n\r\n    return (\r\n        <button\r\n            type=\"button\"\n            onClick={handleClick}\n            disabled={disabled || loading}\n            className={className}\n            aria-disabled={disabled || loading}\n            title={title ?? (error ? error.message : undefined)}\n        >\n            {children}\n        </button>\n    );\r\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "payluk-escrow-inline-checkout",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "TypeScript escrow checkout wrapper with built-in script loader and session creation, ready for React/Next.js",
   "license": "MIT",
   "type": "module",
@@ -29,12 +29,14 @@
     "@types/react": "^18.3.5",
     "rimraf": "^6.0.1",
     "tsup": "^8.0.1",
-    "typescript": "^5.6.3"
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.5"
   },
   "scripts": {
     "clean": "rimraf dist",
     "build": "tsup",
+    "test": "vitest run",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run clean && npm run build"
+    "prepublishOnly": "npm run clean && npm run test & npm run build"
   }
-}
+}

package/dist/chunk-CQKTT6UR.js

@@ -1,89 +0,0 @@
-// src/index.ts
-var DEFAULT_SCRIPT_URL = "https://checkout.payluk.ng/escrow-checkout.min.js";
-var DEFAULT_GLOBAL_NAME = "EscrowCheckout";
-var CONFIG = null;
-function initEscrowCheckout(config) {
-  if (!config?.publicKey) throw new Error('initEscrowCheckout: "publicKey" is required.');
-  CONFIG = {
-    publicKey: config.publicKey,
-    scriptUrl: config.scriptUrlOverride || DEFAULT_SCRIPT_URL,
-    globalName: config.globalName || DEFAULT_GLOBAL_NAME,
-    crossOrigin: config.crossOrigin ?? "anonymous"
-  };
-}
-function assertConfigured(config) {
-  if (!config) {
-    throw new Error("Escrow checkout not initialized. Call initEscrowCheckout({ apiBaseUrl, publicKey }) first.");
-  }
-}
-async function loadWidget() {
-  assertConfigured(CONFIG);
-  const { scriptUrl, globalName, crossOrigin } = CONFIG;
-  if (typeof window === "undefined") {
-    throw new Error("EscrowCheckout can only be loaded in the browser.");
-  }
-  const win = window;
-  win.__escrowCheckoutLoader ?? (win.__escrowCheckoutLoader = {});
-  if (win.__escrowCheckoutLoader[scriptUrl]) {
-    return win.__escrowCheckoutLoader[scriptUrl];
-  }
-  if (typeof win[globalName] === "function") {
-    const fn = win[globalName];
-    win.__escrowCheckoutLoader[scriptUrl] = Promise.resolve(fn);
-    return fn;
-  }
-  win.__escrowCheckoutLoader[scriptUrl] = new Promise((resolve, reject) => {
-    const script = document.createElement("script");
-    script.src = scriptUrl;
-    script.async = true;
-    if (crossOrigin) script.crossOrigin = crossOrigin;
-    script.onload = () => {
-      const fn = win[globalName];
-      if (typeof fn === "function") resolve(fn);
-      else reject(new Error(`Escrow checkout script loaded, but window.${globalName} is not a function.`));
-    };
-    script.onerror = () => reject(new Error(`Failed to load escrow checkout script: ${scriptUrl}`));
-    document.head.appendChild(script);
-  });
-  return win.__escrowCheckoutLoader[scriptUrl];
-}
-async function createSession(input) {
-  assertConfigured(CONFIG);
-  const { publicKey } = CONFIG;
-  const apiBaseUrl = publicKey.startsWith("pk_live_") ? "https://live.payluk.ng" : "https://staging.live.payluk.ng";
-  const resp = await fetch(`${apiBaseUrl}/v1/checkout/session`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      paymentToken: input.paymentToken,
-      redirectUrl: input.redirectUrl,
-      reference: input.reference,
-      customerId: input.customerId,
-      publicKey
-    })
-  });
-  if (!resp.ok) {
-    const err = await resp.json().catch(() => ({}));
-    throw new Error(err.message || "Failed to create session");
-  }
-  return await resp.json();
-}
-async function pay(input) {
-  if (typeof window === "undefined") {
-    throw new Error("pay(...) can only run in the browser.");
-  }
-  const [{ session }, widget] = await Promise.all([createSession(input), loadWidget()]);
-  widget({
-    session,
-    logoUrl: input.logoUrl,
-    brand: input.brand,
-    callback: input.callback,
-    onClose: input.onClose,
-    customerId: input.customerId,
-    ...input.extra ?? {}
-  });
-}
-
-export { initEscrowCheckout, pay };
-//# sourceMappingURL=chunk-CQKTT6UR.js.map
-//# sourceMappingURL=chunk-CQKTT6UR.js.map

package/dist/chunk-CQKTT6UR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"chunk-CQKTT6UR.js","sourcesContent":["export type EscrowWidget = (options: Record<string, unknown>) => void;\r\n\r\nexport interface InitConfig {\r\n    publicKey: string; // publishable key only\r\n    /**\r\n     * Optional overrides for experts. End users don't need to set these.\r\n     */\r\n    scriptUrlOverride?: string;\r\n    globalName?: string; // default 'EscrowCheckout'\r\n    crossOrigin?: '' | 'anonymous' | 'use-credentials';\r\n}\r\n\r\nexport interface PayInput {\r\n    paymentToken: string;\r\n    reference: string;\r\n    redirectUrl: string;\r\n    logoUrl?: string;\r\n    brand?: string;\r\n    customerId?: string;\r\n    /**\r\n     * Extra fields supported by the widget.\r\n     */\r\n    extra?: Record<string, unknown>;\r\n    callback?: (result: any) => void;\r\n    onClose?: () => void;\r\n}\r\n\r\nexport interface SessionResponse {\r\n    session: unknown;\r\n}\r\n\r\nconst DEFAULT_SCRIPT_URL = 'https://checkout.payluk.ng/escrow-checkout.min.js';\r\nconst DEFAULT_GLOBAL_NAME = 'EscrowCheckout';\r\n\r\ntype ResolvedConfig = Required<Pick<InitConfig, 'publicKey'>> & {\r\n    scriptUrl: string;\r\n    globalName: string;\r\n    crossOrigin: '' | 'anonymous' | 'use-credentials';\r\n};\r\n\r\nlet CONFIG: ResolvedConfig | null = null;\r\n\r\n/**\r\n * Initialize the library once (e.g., in app bootstrap).\r\n * Hides script URL and session creation from consumers.\r\n */\r\nexport function initEscrowCheckout(config: InitConfig): void {\r\n    if (!config?.publicKey) throw new Error('initEscrowCheckout: \"publicKey\" is required.');\r\n    CONFIG = {\r\n        publicKey: config.publicKey,\r\n        scriptUrl: config.scriptUrlOverride || DEFAULT_SCRIPT_URL,\r\n        globalName: config.globalName || DEFAULT_GLOBAL_NAME,\r\n        crossOrigin: config.crossOrigin ?? 'anonymous'\r\n    };\r\n}\r\n\r\n/**\r\n * Narrow a provided config to ResolvedConfig or throw if not initialized.\r\n */\r\nfunction assertConfigured(config: ResolvedConfig | null): asserts config is ResolvedConfig {\r\n    if (!config) {\r\n        throw new Error('Escrow checkout not initialized. Call initEscrowCheckout({ apiBaseUrl, publicKey }) first.');\r\n    }\r\n}\r\n\r\n/**\r\n * Internal: load the widget script once and return the global function.\r\n */\r\nasync function loadWidget(): Promise<EscrowWidget> {\r\n    assertConfigured(CONFIG);\r\n    const { scriptUrl, globalName, crossOrigin } = CONFIG;\r\n\r\n    if (typeof window === 'undefined') {\r\n        throw new Error('EscrowCheckout can only be loaded in the browser.');\r\n    }\r\n\r\n    const win = window as any;\r\n    win.__escrowCheckoutLoader ??= {};\r\n\r\n    if (win.__escrowCheckoutLoader[scriptUrl]) {\r\n        return win.__escrowCheckoutLoader[scriptUrl];\r\n    }\r\n\r\n    if (typeof win[globalName] === 'function') {\r\n        const fn = win[globalName] as EscrowWidget;\r\n        win.__escrowCheckoutLoader[scriptUrl] = Promise.resolve(fn);\r\n        return fn;\r\n    }\r\n\r\n    win.__escrowCheckoutLoader[scriptUrl] = new Promise<EscrowWidget>((resolve, reject) => {\r\n        const script = document.createElement('script');\r\n        script.src = scriptUrl;\r\n        script.async = true;\r\n        if (crossOrigin) script.crossOrigin = crossOrigin;\r\n\r\n        script.onload = () => {\r\n            const fn = win[globalName];\r\n            if (typeof fn === 'function') resolve(fn as EscrowWidget);\r\n            else reject(new Error(`Escrow checkout script loaded, but window.${globalName} is not a function.`));\r\n        };\r\n\r\n        script.onerror = () => reject(new Error(`Failed to load escrow checkout script: ${scriptUrl}`));\r\n\r\n        document.head.appendChild(script);\r\n    });\r\n\r\n    return win.__escrowCheckoutLoader[scriptUrl];\r\n}\r\n\r\n/**\r\n * Internal: create a checkout session by calling your API.\r\n * This is intentionally inside the lib (user doesn't implement it).\r\n */\r\nasync function createSession(input: PayInput): Promise<SessionResponse> {\r\n    assertConfigured(CONFIG);\r\n    const { publicKey } = CONFIG;\r\n    const apiBaseUrl = publicKey.startsWith(\"pk_live_\") ? 'https://live.payluk.ng' : 'https://staging.live.payluk.ng';\r\n\r\n    const resp = await fetch(`${apiBaseUrl}/v1/checkout/session`, {\r\n        method: 'POST',\r\n        headers: { 'Content-Type': 'application/json' },\r\n        body: JSON.stringify({\r\n            paymentToken: input.paymentToken,\r\n            redirectUrl: input.redirectUrl,\r\n            reference: input.reference,\r\n            customerId: input.customerId,\r\n            publicKey\r\n        })\r\n    });\r\n\r\n    if (!resp.ok) {\r\n        const err = await resp.json().catch(() => ({}));\r\n        throw new Error(err.message || 'Failed to create session');\r\n    }\r\n\r\n    return (await resp.json()) as SessionResponse;\r\n}\r\n\r\n/**\r\n * Public API: create the session and open the widget.\r\n * Consumers only supply business inputs (no script URL, no API calls).\r\n */\r\nexport async function pay(input: PayInput): Promise<void> {\r\n    if (typeof window === 'undefined') {\r\n        throw new Error('pay(...) can only run in the browser.');\r\n    }\r\n\r\n    const [{ session }, widget] = await Promise.all([createSession(input), loadWidget()]);\r\n\r\n    widget({\r\n        session,\r\n        logoUrl: input.logoUrl,\r\n        brand: input.brand,\r\n        callback: input.callback,\r\n        onClose: input.onClose,\r\n        customerId: input.customerId,\r\n        ...(input.extra ?? {})\r\n    });\r\n}"]}