payluk-escrow-inline-checkout 0.2.0 → 0.2.2

package/README.md

@@ -0,0 +1,196 @@
+# Escrow Checkout JS/TS SDK
+
+A lightweight client SDK that initializes your checkout configuration, creates a session via your API, and launches the escrow checkout widget. Includes a React hook for easy integration in React apps.
+
+- Zero manual script tags: the widget script is loaded automatically.
+- Promise-based API.
+- First-class TypeScript types.
+- Optional React hook with loading/error state.
+
+## Installation
+
+```bash
+npm i payluk-escrow-inline-checkout
+```
+
+## Quick Start (Vanilla JS/TS)
+
+```ts
+// app.ts
+import { initEscrowCheckout, pay } from 'payluk-escrow-inline-checkout';
+
+// 1) Initialize once at app startup
+initEscrowCheckout({
+  apiBaseUrl: 'https://api.example.com', // your backend base URL
+  publicKey: '<YOUR_PUBLISHABLE_KEY>' // publishable key only
+});
+
+// 2) Trigger a payment flow (e.g., on a button click)
+async function onPayClick() {
+  try {
+    await pay({
+      paymentToken: '<PAYMENT_TOKEN_FROM_YOUR_BACKEND_OR_PROVIDER>',
+      reference: '<ORDER_OR_REFERENCE_ID>',
+      redirectUrl: 'https://your-app.example.com/checkout/complete',
+      logoUrl: 'https://your-cdn.example.com/logo.png', // optional
+      brand: 'YourBrand', // optional
+      extra: { theme: 'dark' }, // optional
+      callback: (result) => {
+        console.log('Checkout result:', result);
+      },
+      onClose: () => {
+        console.log('Widget closed');
+      }
+    });
+  } catch (err) {
+    console.error('Payment failed:', err);
+  }
+}
+```
+
+## React Usage
+
+```tsx
+// CheckoutButton.tsx
+import React from 'react';
+import { useEscrowCheckout } from 'payluk-escrow-inline-checkout/react';
+
+export function CheckoutButton() {
+  const { pay, loading, error, ready } = useEscrowCheckout();
+
+  const handleClick = async () => {
+    try {
+      await pay({
+        paymentToken: '<PAYMENT_TOKEN>',
+        reference: '<ORDER_OR_REFERENCE_ID>',
+        redirectUrl: 'https://your-app.example.com/checkout/complete',
+        logoUrl: 'https://your-cdn.example.com/logo.png',
+        brand: 'YourBrand',
+        extra: { theme: 'light' },
+        callback: (result) => console.log(result)
+      });
+    } catch {
+      // error is also exposed via `error` state
+    }
+  };
+
+  return (
+    <button onClick={handleClick} disabled={loading || !ready}>
+      {loading ? 'Processing…' : 'Pay now'}
+      {!ready && <span>Preparing checkout…</span>}
+      {error && <small style={{ color: 'red' }}>{error.message}</small>}
+    </button>
+  );
+}
+```
+
+**Note:** In React apps, call `initEscrowCheckout(...)` once in your app bootstrap (e.g., in the root component or an app initializer). The hook uses that configuration.
+
+**Important:**
+- Only use publishable keys in the browser. Keep any secret keys on your server.
+- Validate inputs on your backend and return the required session payload.
+
+## API
+
+### `initEscrowCheckout(config)`
+
+Initializes the SDK. Must be called before any `pay(...)`.
+
+**Required:**
+- `apiBaseUrl`: `string` — your backend base URL (no trailing slash required)
+- `publicKey`: `string` — publishable key only
+
+**Advanced (optional):**
+- `scriptUrlOverride?`: `string` — custom widget script URL
+- `globalName?`: `string` — custom global widget function name
+- `crossOrigin?`: `'' | 'anonymous' | 'use-credentials'` — script tag crossOrigin
+
+**Example:**
+
+```ts
+import { initEscrowCheckout } from 'payluk-escrow-inline-checkout';
+
+initEscrowCheckout({
+  apiBaseUrl: 'https://api.example.com',
+  publicKey: '<YOUR_PUBLISHABLE_KEY>',
+  // scriptUrlOverride: 'https://cdn.example.com/custom-widget.js',
+  // globalName: 'EscrowCheckout',
+  // crossOrigin: 'anonymous'
+});
+```
+
+### `pay(input): Promise<void>`
+
+Creates a checkout session via your backend and opens the widget.
+
+**Required:**
+- `paymentToken`: `string`
+- `reference`: `string`
+- `redirectUrl`: `string`
+
+**Optional:**
+- `logoUrl?`: `string`
+- `brand?`: `string`
+- `extra?`: `Record<string, unknown>`
+- `callback?`: `(result: unknown) => void`
+- `onClose?`: `() => void`
+
+**Returns:**
+- `Promise<void>` that resolves when the widget is opened (and rejects on errors).
+
+### `useEscrowCheckout(): { ready, loading, error, pay }`
+
+React hook that exposes:
+- `ready`: `boolean` — becomes true after a successful load/pay attempt
+- `loading`: `boolean` — true while pay is running
+- `error`: `Error | null` — last error encountered
+- `pay`: same function as `pay(...)`
+
+**Import:**
+
+```ts
+import { useEscrowCheckout } from 'payluk-escrow-inline-checkout/react';
+```
+
+## Framework and SSR Notes
+
+- **Browser-only:** `pay(...)` and the widget require `window`. Avoid calling them during server-side rendering.
+- **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({ apiBaseUrl, 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);
+}
+```
+
+## Security
+
+- Use only publishable keys in the client.
+- Keep any secret or private keys on your server.
+- Validate and authorize requests on your backend before creating sessions.
+
+## Types
+
+This package ships with TypeScript types. No additional type packages are required.
+
+## Contributing
+
+- Install dependencies: `npm install`
+- Build: `npm run build`
+- Lint/Test: add scripts as needed for your project
+
+## License
+
+MIT (or your chosen license)

package/dist/chunk-D6ZMSUAT.js

@@ -0,0 +1,87 @@
+// 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 = "https://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,
+      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,
+    ...input.extra ?? {}
+  });
+}
+
+export { initEscrowCheckout, pay };
+//# sourceMappingURL=chunk-D6ZMSUAT.js.map
+//# sourceMappingURL=chunk-D6ZMSUAT.js.map

package/dist/chunk-D6ZMSUAT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"chunk-D6ZMSUAT.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    /**\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 = 'https://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            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        ...(input.extra ?? {})\r\n    });\r\n}"]}

package/dist/index.cjs

@@ -0,0 +1,90 @@
+'use strict';
+
+// 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 = "https://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,
+      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,
+    ...input.extra ?? {}
+  });
+}
+
+exports.initEscrowCheckout = initEscrowCheckout;
+exports.pay = pay;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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    /**\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 = 'https://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            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        ...(input.extra ?? {})\r\n    });\r\n}"]}

package/dist/index.d.cts

@@ -0,0 +1,38 @@
+type EscrowWidget = (options: Record<string, unknown>) => void;
+interface InitConfig {
+    publicKey: string;
+    /**
+     * Optional overrides for experts. End users don't need to set these.
+     */
+    scriptUrlOverride?: string;
+    globalName?: string;
+    crossOrigin?: '' | 'anonymous' | 'use-credentials';
+}
+interface PayInput {
+    paymentToken: string;
+    reference: string;
+    redirectUrl: string;
+    logoUrl?: string;
+    brand?: string;
+    /**
+     * Extra fields supported by the widget.
+     */
+    extra?: Record<string, unknown>;
+    callback?: (result: any) => void;
+    onClose?: () => void;
+}
+interface SessionResponse {
+    session: unknown;
+}
+/**
+ * Initialize the library once (e.g., in app bootstrap).
+ * Hides script URL and session creation from consumers.
+ */
+declare function initEscrowCheckout(config: InitConfig): void;
+/**
+ * Public API: create the session and open the widget.
+ * Consumers only supply business inputs (no script URL, no API calls).
+ */
+declare function pay(input: PayInput): Promise<void>;
+
+export { type EscrowWidget, type InitConfig, type PayInput, type SessionResponse, initEscrowCheckout, pay };

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+type EscrowWidget = (options: Record<string, unknown>) => void;
+interface InitConfig {
+    publicKey: string;
+    /**
+     * Optional overrides for experts. End users don't need to set these.
+     */
+    scriptUrlOverride?: string;
+    globalName?: string;
+    crossOrigin?: '' | 'anonymous' | 'use-credentials';
+}
+interface PayInput {
+    paymentToken: string;
+    reference: string;
+    redirectUrl: string;
+    logoUrl?: string;
+    brand?: string;
+    /**
+     * Extra fields supported by the widget.
+     */
+    extra?: Record<string, unknown>;
+    callback?: (result: any) => void;
+    onClose?: () => void;
+}
+interface SessionResponse {
+    session: unknown;
+}
+/**
+ * Initialize the library once (e.g., in app bootstrap).
+ * Hides script URL and session creation from consumers.
+ */
+declare function initEscrowCheckout(config: InitConfig): void;
+/**
+ * Public API: create the session and open the widget.
+ * Consumers only supply business inputs (no script URL, no API calls).
+ */
+declare function pay(input: PayInput): Promise<void>;
+
+export { type EscrowWidget, type InitConfig, type PayInput, type SessionResponse, initEscrowCheckout, pay };

package/dist/index.js

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

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/react/index.cjs

@@ -0,0 +1,150 @@
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/react/useEscrowCheckout.ts
+
+// src/index.ts
+var CONFIG = null;
+function assertConfigured(config) {
+  {
+    throw new Error("Escrow checkout not initialized. Call initEscrowCheckout({ apiBaseUrl, publicKey }) first.");
+  }
+}
+async function loadWidget() {
+  assertConfigured();
+  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();
+  const { publicKey } = CONFIG;
+  const apiBaseUrl = "https://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,
+      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,
+    ...input.extra ?? {}
+  });
+}
+
+// src/react/useEscrowCheckout.ts
+function useEscrowCheckout() {
+  const [ready, setReady] = react.useState(false);
+  const [loading, setLoading] = react.useState(() => typeof window !== "undefined");
+  const [error, setError] = react.useState(null);
+  const pay2 = react.useCallback(async (input) => {
+    setLoading(true);
+    try {
+      await pay(input);
+      setReady(true);
+      setError(null);
+    } catch (e) {
+      setError(e);
+      throw e;
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+  react.useEffect(() => {
+    if (typeof window === "undefined") {
+      setLoading(false);
+    }
+  }, []);
+  return react.useMemo(() => ({ ready, loading, error, pay: pay2 }), [ready, loading, error, pay2]);
+}
+function EscrowCheckoutButton({
+  paymentToken,
+  reference,
+  redirectUrl,
+  brand,
+  logoUrl,
+  callback,
+  onClose,
+  extra,
+  children = "Pay",
+  disabled,
+  className,
+  title
+}) {
+  const { ready, loading, error, pay: pay2 } = useEscrowCheckout();
+  const handleClick = react.useCallback(async () => {
+    await pay2({
+      paymentToken,
+      reference,
+      redirectUrl,
+      brand,
+      logoUrl,
+      callback,
+      onClose,
+      extra
+    });
+  }, [pay2, paymentToken, reference, redirectUrl, brand, logoUrl, callback, onClose, extra]);
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "button",
+    {
+      type: "button",
+      onClick: handleClick,
+      disabled: disabled || loading || !ready,
+      className,
+      "aria-disabled": disabled || loading || !ready,
+      title: title ?? (error ? error.message : void 0),
+      children
+    }
+  );
+}
+
+exports.EscrowCheckoutButton = EscrowCheckoutButton;
+exports.useEscrowCheckout = useEscrowCheckout;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/react/index.cjs.map

@@ -0,0 +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    /**\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 = 'https://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            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        ...(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    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                                     }: 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        });\r\n    }, [pay, paymentToken, reference, redirectUrl, brand, logoUrl, callback, onClose, extra]);\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}"]}

package/dist/react/index.d.cts

@@ -0,0 +1,37 @@
+import { pay } from '../index.cjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+
+interface UseEscrowCheckoutResult {
+    ready: boolean;
+    loading: boolean;
+    error: Error | null;
+    pay: typeof pay;
+}
+/**
+ * React hook that preloads the widget script (implicitly via pay) and exposes pay(...)
+ * Since the library abstracts script loading and session creation, the hook is thin.
+ */
+declare function useEscrowCheckout(): UseEscrowCheckoutResult;
+
+interface EscrowCheckoutButtonProps {
+    paymentToken: string;
+    reference: string;
+    redirectUrl: string;
+    children?: React.ReactNode;
+    disabled?: boolean;
+    className?: string;
+    title?: string;
+    brand?: string;
+    logoUrl?: string;
+    callback?: (result: any) => void;
+    onClose?: () => void;
+    extra?: Record<string, unknown>;
+}
+/**
+ * Button that triggers pay(...) with your provided inputs.
+ * The library handles both session creation and widget loading.
+ */
+declare function EscrowCheckoutButton({ paymentToken, reference, redirectUrl, brand, logoUrl, callback, onClose, extra, children, disabled, className, title }: EscrowCheckoutButtonProps): react_jsx_runtime.JSX.Element;
+
+export { EscrowCheckoutButton, type EscrowCheckoutButtonProps, useEscrowCheckout };

package/dist/react/index.d.ts

@@ -0,0 +1,37 @@
+import { pay } from '../index.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+
+interface UseEscrowCheckoutResult {
+    ready: boolean;
+    loading: boolean;
+    error: Error | null;
+    pay: typeof pay;
+}
+/**
+ * React hook that preloads the widget script (implicitly via pay) and exposes pay(...)
+ * Since the library abstracts script loading and session creation, the hook is thin.
+ */
+declare function useEscrowCheckout(): UseEscrowCheckoutResult;
+
+interface EscrowCheckoutButtonProps {
+    paymentToken: string;
+    reference: string;
+    redirectUrl: string;
+    children?: React.ReactNode;
+    disabled?: boolean;
+    className?: string;
+    title?: string;
+    brand?: string;
+    logoUrl?: string;
+    callback?: (result: any) => void;
+    onClose?: () => void;
+    extra?: Record<string, unknown>;
+}
+/**
+ * Button that triggers pay(...) with your provided inputs.
+ * The library handles both session creation and widget loading.
+ */
+declare function EscrowCheckoutButton({ paymentToken, reference, redirectUrl, brand, logoUrl, callback, onClose, extra, children, disabled, className, title }: EscrowCheckoutButtonProps): react_jsx_runtime.JSX.Element;
+
+export { EscrowCheckoutButton, type EscrowCheckoutButtonProps, useEscrowCheckout };

package/dist/react/index.js

@@ -0,0 +1,72 @@
+import { pay } from '../chunk-D6ZMSUAT.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 [error, setError] = useState(null);
+  const pay2 = useCallback(async (input) => {
+    setLoading(true);
+    try {
+      await pay(input);
+      setReady(true);
+      setError(null);
+    } catch (e) {
+      setError(e);
+      throw e;
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+  useEffect(() => {
+    if (typeof window === "undefined") {
+      setLoading(false);
+    }
+  }, []);
+  return useMemo(() => ({ ready, loading, error, pay: pay2 }), [ready, loading, error, pay2]);
+}
+function EscrowCheckoutButton({
+  paymentToken,
+  reference,
+  redirectUrl,
+  brand,
+  logoUrl,
+  callback,
+  onClose,
+  extra,
+  children = "Pay",
+  disabled,
+  className,
+  title
+}) {
+  const { ready, loading, error, pay: pay2 } = useEscrowCheckout();
+  const handleClick = useCallback(async () => {
+    await pay2({
+      paymentToken,
+      reference,
+      redirectUrl,
+      brand,
+      logoUrl,
+      callback,
+      onClose,
+      extra
+    });
+  }, [pay2, paymentToken, reference, redirectUrl, brand, logoUrl, callback, onClose, extra]);
+  return /* @__PURE__ */ jsx(
+    "button",
+    {
+      type: "button",
+      onClick: handleClick,
+      disabled: disabled || loading || !ready,
+      className,
+      "aria-disabled": disabled || loading || !ready,
+      title: title ?? (error ? error.message : void 0),
+      children
+    }
+  );
+}
+
+export { EscrowCheckoutButton, useEscrowCheckout };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +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;ACtBO,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;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;AAAA,KACH,CAAA;AAAA,EACL,CAAA,EAAG,CAACA,IAAAA,EAAK,YAAA,EAAc,SAAA,EAAW,WAAA,EAAa,KAAA,EAAO,OAAA,EAAS,QAAA,EAAU,OAAA,EAAS,KAAK,CAAC,CAAA;AAExF,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    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                                     }: 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        });\r\n    }, [pay, paymentToken, reference, redirectUrl, brand, logoUrl, callback, onClose, extra]);\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}"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "payluk-escrow-inline-checkout",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "TypeScript escrow checkout wrapper with built-in script loader and session creation, ready for React/Next.js",
   "license": "MIT",
   "type": "module",
@@ -34,6 +34,7 @@
   "scripts": {
     "clean": "rimraf dist",
     "build": "tsup",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run clean && npm run build"
   }
 }