@oleq-ai/pay 0.4.2

package/dist/react/index.js

@@ -0,0 +1,353 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react/index.ts
+var index_exports = {};
+__export(index_exports, {
+  useOleqPayCheckout: () => useOleqPayCheckout
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/react/use-oleqpay-checkout.ts
+var import_react = require("react");
+
+// src/encode.ts
+function encodePaymentData(payload) {
+  const json = JSON.stringify(payload);
+  const firstEncode = utf8ToBase64(json);
+  return utf8ToBase64(firstEncode);
+}
+function utf8ToBase64(input) {
+  const bytes = new TextEncoder().encode(input);
+  let binary = "";
+  bytes.forEach((byte) => {
+    binary += String.fromCharCode(byte);
+  });
+  return btoa(binary);
+}
+function buildCheckoutUrl(baseUrl, payload, options) {
+  const qp = encodePaymentData(payload);
+  const locale = options?.locale ?? "en";
+  const path = options?.path ?? "p";
+  const normalizedBase = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+  const url = new URL(`${locale}/${path}`, normalizedBase);
+  url.searchParams.set("qp", qp);
+  return url.toString();
+}
+
+// src/errors.ts
+var OleqPayCheckoutError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = "OleqPayCheckoutError";
+    this.code = code;
+  }
+};
+
+// src/modal.ts
+var OVERLAY_ID = "oleqpay-checkout-overlay";
+function openCheckoutModal(url, onCloseRequested) {
+  removeExistingModal();
+  const overlay = document.createElement("div");
+  overlay.id = OVERLAY_ID;
+  Object.assign(overlay.style, {
+    position: "fixed",
+    inset: "0",
+    zIndex: "2147483000",
+    display: "flex",
+    alignItems: "center",
+    justifyContent: "center",
+    background: "rgba(15, 23, 42, 0.55)",
+    backdropFilter: "blur(2px)"
+  });
+  const panel = document.createElement("div");
+  Object.assign(panel.style, {
+    position: "relative",
+    width: "min(440px, calc(100vw - 32px))",
+    height: "min(720px, calc(100vh - 32px))",
+    borderRadius: "16px",
+    overflow: "hidden",
+    boxShadow: "0 20px 60px rgba(0,0,0,0.35)",
+    background: "#fff"
+  });
+  const closeBtn = document.createElement("button");
+  closeBtn.setAttribute("aria-label", "Close checkout");
+  closeBtn.textContent = "\xD7";
+  Object.assign(closeBtn.style, {
+    position: "absolute",
+    top: "8px",
+    right: "8px",
+    width: "32px",
+    height: "32px",
+    borderRadius: "9999px",
+    border: "none",
+    background: "rgba(0,0,0,0.06)",
+    fontSize: "20px",
+    lineHeight: "1",
+    cursor: "pointer",
+    zIndex: "1"
+  });
+  closeBtn.onclick = () => onCloseRequested();
+  const iframe = document.createElement("iframe");
+  iframe.src = url;
+  iframe.title = "OleqPay Checkout";
+  iframe.setAttribute(
+    "allow",
+    "payment *; clipboard-write; camera; publickey-credentials-get"
+  );
+  Object.assign(iframe.style, {
+    width: "100%",
+    height: "100%",
+    border: "0"
+  });
+  panel.appendChild(closeBtn);
+  panel.appendChild(iframe);
+  overlay.appendChild(panel);
+  document.body.appendChild(overlay);
+  document.body.style.overflow = "hidden";
+  const onKeydown = (e) => {
+    if (e.key === "Escape") onCloseRequested();
+  };
+  window.addEventListener("keydown", onKeydown);
+  return {
+    iframe,
+    close: () => {
+      window.removeEventListener("keydown", onKeydown);
+      document.body.style.overflow = "";
+      overlay.remove();
+    }
+  };
+}
+function removeExistingModal() {
+  const existing = document.getElementById(OVERLAY_ID);
+  if (!existing) return;
+  existing.remove();
+  document.body.style.overflow = "";
+}
+
+// src/api-key.ts
+function assertPublicApiKey(apikey) {
+  if (!apikey) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: apikey is required.",
+      "invalid_api_key"
+    );
+  }
+  if (apikey.startsWith("sk_")) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: this looks like a secret key (sk_\u2026). Only public keys belong in browser code \u2014 mint a session server-side with buildUrl() and pass the resulting URL to openIframe()/redirect() instead.",
+      "invalid_api_key"
+    );
+  }
+}
+
+// src/payload.ts
+function assertValidPayload(payload) {
+  assertPublicApiKey(payload.apikey);
+  if (payload.apikey.length < 10) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: apikey must be at least 10 characters.",
+      "invalid_api_key"
+    );
+  }
+  if (payload.orderid === void 0 || payload.orderid === "") {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: orderid is required \u2014 the checkout page rejects payloads without it.",
+      "invalid_payload"
+    );
+  }
+  if (!payload.reference) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: reference is required \u2014 the checkout page rejects payloads without it.",
+      "invalid_payload"
+    );
+  }
+  const amountValue = typeof payload.amount === "number" ? payload.amount : parseFloat(payload.amount);
+  if (!Number.isFinite(amountValue) || amountValue <= 0) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: amount must be a number greater than 0.",
+      "invalid_payload"
+    );
+  }
+  if (payload.callbackurl && !isValidUrl(payload.callbackurl)) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: callbackurl must be a valid URL.",
+      "invalid_payload"
+    );
+  }
+  if (payload.returnurl && !isValidUrl(payload.returnurl)) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: returnurl must be a valid URL.",
+      "invalid_payload"
+    );
+  }
+}
+function isValidUrl(value) {
+  try {
+    new URL(value);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/types.ts
+var DEFAULT_CHECKOUT_BASE_URL = "https://my.olefi.co";
+
+// src/client.ts
+var OleqPayCheckout = class {
+  constructor(options = {}) {
+    this.activeModal = null;
+    this.messageHandler = null;
+    this.checkoutBaseUrl = options.checkoutBaseUrl ?? DEFAULT_CHECKOUT_BASE_URL;
+    this.locale = options.locale ?? "en";
+  }
+  /**
+   * Build a hosted-checkout URL from a payload.
+   * Safe on the server (no DOM) — use this to mint session URLs in Nest/backends.
+   */
+  buildUrl(payload) {
+    assertValidPayload(payload);
+    return buildCheckoutUrl(this.checkoutBaseUrl, payload, {
+      locale: this.locale
+    });
+  }
+  /** Opens checkout in a modal iframe. Accepts either a raw payload or a pre-built session URL. */
+  openIframe(payloadOrUrl, options = {}) {
+    if (typeof window === "undefined") {
+      throw new OleqPayCheckoutError(
+        "OleqPayCheckout.openIframe() can only run in a browser.",
+        "ssr_unsupported"
+      );
+    }
+    this.close();
+    const url = this.resolveUrl(payloadOrUrl);
+    const targetOrigin = new URL(url).origin;
+    const onUserClose = () => {
+      this.close();
+      options.onClose?.();
+    };
+    this.activeModal = openCheckoutModal(url, onUserClose);
+    this.messageHandler = (event) => {
+      if (event.origin !== targetOrigin) return;
+      const data = event.data;
+      if (!data || typeof data !== "object" || !("type" in data)) return;
+      switch (data.type) {
+        case "oleqpay:success":
+          options.onSuccess?.(data);
+          this.close();
+          break;
+        case "oleqpay:failed":
+          options.onError?.(data);
+          break;
+        case "oleqpay:close":
+          onUserClose();
+          break;
+        default:
+          break;
+      }
+    };
+    window.addEventListener("message", this.messageHandler);
+  }
+  /** Full-page redirect to hosted checkout — mirrors Stripe Checkout / Paystack redirect flow. */
+  redirect(payloadOrUrl) {
+    if (typeof window === "undefined") {
+      throw new OleqPayCheckoutError(
+        "OleqPayCheckout.redirect() can only run in a browser.",
+        "ssr_unsupported"
+      );
+    }
+    window.location.href = this.resolveUrl(payloadOrUrl);
+  }
+  /** Programmatically close an open iframe modal. */
+  close() {
+    this.activeModal?.close();
+    this.teardown();
+  }
+  resolveUrl(payloadOrUrl) {
+    if (typeof payloadOrUrl === "string") return payloadOrUrl;
+    return this.buildUrl(payloadOrUrl);
+  }
+  teardown() {
+    if (this.messageHandler) {
+      window.removeEventListener("message", this.messageHandler);
+      this.messageHandler = null;
+    }
+    this.activeModal = null;
+  }
+};
+
+// src/react/use-oleqpay-checkout.ts
+function useOleqPayCheckout(options = {}) {
+  const { checkoutBaseUrl, locale, onSuccess, onError } = options;
+  const client = (0, import_react.useMemo)(
+    () => new OleqPayCheckout({ checkoutBaseUrl, locale }),
+    [checkoutBaseUrl, locale]
+  );
+  const [isOpen, setIsOpen] = (0, import_react.useState)(false);
+  const [error, setError] = (0, import_react.useState)(null);
+  const clearError = (0, import_react.useCallback)(() => setError(null), []);
+  const openIframe = (0, import_react.useCallback)(
+    (payloadOrUrl) => {
+      setError(null);
+      try {
+        client.openIframe(payloadOrUrl, {
+          onSuccess: (event) => {
+            setIsOpen(false);
+            onSuccess?.(event);
+          },
+          onError: (event) => {
+            setError(event.message ?? "Payment failed");
+            onError?.(event);
+          },
+          onClose: () => setIsOpen(false)
+        });
+        setIsOpen(true);
+      } catch (err) {
+        setError(
+          err instanceof Error ? err.message : "Unable to open checkout"
+        );
+      }
+    },
+    [client, onSuccess, onError]
+  );
+  const redirect = (0, import_react.useCallback)(
+    (payloadOrUrl) => {
+      setError(null);
+      try {
+        client.redirect(payloadOrUrl);
+      } catch (err) {
+        setError(
+          err instanceof Error ? err.message : "Unable to redirect to checkout"
+        );
+      }
+    },
+    [client]
+  );
+  const close = (0, import_react.useCallback)(() => {
+    client.close();
+    setIsOpen(false);
+  }, [client]);
+  (0, import_react.useEffect)(() => () => client.close(), [client]);
+  return { openIframe, redirect, close, isOpen, error, clearError };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useOleqPayCheckout
+});

package/dist/react/index.mjs

@@ -0,0 +1,326 @@
+// src/react/use-oleqpay-checkout.ts
+import { useCallback, useEffect, useMemo, useState } from "react";
+
+// src/encode.ts
+function encodePaymentData(payload) {
+  const json = JSON.stringify(payload);
+  const firstEncode = utf8ToBase64(json);
+  return utf8ToBase64(firstEncode);
+}
+function utf8ToBase64(input) {
+  const bytes = new TextEncoder().encode(input);
+  let binary = "";
+  bytes.forEach((byte) => {
+    binary += String.fromCharCode(byte);
+  });
+  return btoa(binary);
+}
+function buildCheckoutUrl(baseUrl, payload, options) {
+  const qp = encodePaymentData(payload);
+  const locale = options?.locale ?? "en";
+  const path = options?.path ?? "p";
+  const normalizedBase = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+  const url = new URL(`${locale}/${path}`, normalizedBase);
+  url.searchParams.set("qp", qp);
+  return url.toString();
+}
+
+// src/errors.ts
+var OleqPayCheckoutError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = "OleqPayCheckoutError";
+    this.code = code;
+  }
+};
+
+// src/modal.ts
+var OVERLAY_ID = "oleqpay-checkout-overlay";
+function openCheckoutModal(url, onCloseRequested) {
+  removeExistingModal();
+  const overlay = document.createElement("div");
+  overlay.id = OVERLAY_ID;
+  Object.assign(overlay.style, {
+    position: "fixed",
+    inset: "0",
+    zIndex: "2147483000",
+    display: "flex",
+    alignItems: "center",
+    justifyContent: "center",
+    background: "rgba(15, 23, 42, 0.55)",
+    backdropFilter: "blur(2px)"
+  });
+  const panel = document.createElement("div");
+  Object.assign(panel.style, {
+    position: "relative",
+    width: "min(440px, calc(100vw - 32px))",
+    height: "min(720px, calc(100vh - 32px))",
+    borderRadius: "16px",
+    overflow: "hidden",
+    boxShadow: "0 20px 60px rgba(0,0,0,0.35)",
+    background: "#fff"
+  });
+  const closeBtn = document.createElement("button");
+  closeBtn.setAttribute("aria-label", "Close checkout");
+  closeBtn.textContent = "\xD7";
+  Object.assign(closeBtn.style, {
+    position: "absolute",
+    top: "8px",
+    right: "8px",
+    width: "32px",
+    height: "32px",
+    borderRadius: "9999px",
+    border: "none",
+    background: "rgba(0,0,0,0.06)",
+    fontSize: "20px",
+    lineHeight: "1",
+    cursor: "pointer",
+    zIndex: "1"
+  });
+  closeBtn.onclick = () => onCloseRequested();
+  const iframe = document.createElement("iframe");
+  iframe.src = url;
+  iframe.title = "OleqPay Checkout";
+  iframe.setAttribute(
+    "allow",
+    "payment *; clipboard-write; camera; publickey-credentials-get"
+  );
+  Object.assign(iframe.style, {
+    width: "100%",
+    height: "100%",
+    border: "0"
+  });
+  panel.appendChild(closeBtn);
+  panel.appendChild(iframe);
+  overlay.appendChild(panel);
+  document.body.appendChild(overlay);
+  document.body.style.overflow = "hidden";
+  const onKeydown = (e) => {
+    if (e.key === "Escape") onCloseRequested();
+  };
+  window.addEventListener("keydown", onKeydown);
+  return {
+    iframe,
+    close: () => {
+      window.removeEventListener("keydown", onKeydown);
+      document.body.style.overflow = "";
+      overlay.remove();
+    }
+  };
+}
+function removeExistingModal() {
+  const existing = document.getElementById(OVERLAY_ID);
+  if (!existing) return;
+  existing.remove();
+  document.body.style.overflow = "";
+}
+
+// src/api-key.ts
+function assertPublicApiKey(apikey) {
+  if (!apikey) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: apikey is required.",
+      "invalid_api_key"
+    );
+  }
+  if (apikey.startsWith("sk_")) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: this looks like a secret key (sk_\u2026). Only public keys belong in browser code \u2014 mint a session server-side with buildUrl() and pass the resulting URL to openIframe()/redirect() instead.",
+      "invalid_api_key"
+    );
+  }
+}
+
+// src/payload.ts
+function assertValidPayload(payload) {
+  assertPublicApiKey(payload.apikey);
+  if (payload.apikey.length < 10) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: apikey must be at least 10 characters.",
+      "invalid_api_key"
+    );
+  }
+  if (payload.orderid === void 0 || payload.orderid === "") {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: orderid is required \u2014 the checkout page rejects payloads without it.",
+      "invalid_payload"
+    );
+  }
+  if (!payload.reference) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: reference is required \u2014 the checkout page rejects payloads without it.",
+      "invalid_payload"
+    );
+  }
+  const amountValue = typeof payload.amount === "number" ? payload.amount : parseFloat(payload.amount);
+  if (!Number.isFinite(amountValue) || amountValue <= 0) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: amount must be a number greater than 0.",
+      "invalid_payload"
+    );
+  }
+  if (payload.callbackurl && !isValidUrl(payload.callbackurl)) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: callbackurl must be a valid URL.",
+      "invalid_payload"
+    );
+  }
+  if (payload.returnurl && !isValidUrl(payload.returnurl)) {
+    throw new OleqPayCheckoutError(
+      "OleqPayCheckout: returnurl must be a valid URL.",
+      "invalid_payload"
+    );
+  }
+}
+function isValidUrl(value) {
+  try {
+    new URL(value);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/types.ts
+var DEFAULT_CHECKOUT_BASE_URL = "https://my.olefi.co";
+
+// src/client.ts
+var OleqPayCheckout = class {
+  constructor(options = {}) {
+    this.activeModal = null;
+    this.messageHandler = null;
+    this.checkoutBaseUrl = options.checkoutBaseUrl ?? DEFAULT_CHECKOUT_BASE_URL;
+    this.locale = options.locale ?? "en";
+  }
+  /**
+   * Build a hosted-checkout URL from a payload.
+   * Safe on the server (no DOM) — use this to mint session URLs in Nest/backends.
+   */
+  buildUrl(payload) {
+    assertValidPayload(payload);
+    return buildCheckoutUrl(this.checkoutBaseUrl, payload, {
+      locale: this.locale
+    });
+  }
+  /** Opens checkout in a modal iframe. Accepts either a raw payload or a pre-built session URL. */
+  openIframe(payloadOrUrl, options = {}) {
+    if (typeof window === "undefined") {
+      throw new OleqPayCheckoutError(
+        "OleqPayCheckout.openIframe() can only run in a browser.",
+        "ssr_unsupported"
+      );
+    }
+    this.close();
+    const url = this.resolveUrl(payloadOrUrl);
+    const targetOrigin = new URL(url).origin;
+    const onUserClose = () => {
+      this.close();
+      options.onClose?.();
+    };
+    this.activeModal = openCheckoutModal(url, onUserClose);
+    this.messageHandler = (event) => {
+      if (event.origin !== targetOrigin) return;
+      const data = event.data;
+      if (!data || typeof data !== "object" || !("type" in data)) return;
+      switch (data.type) {
+        case "oleqpay:success":
+          options.onSuccess?.(data);
+          this.close();
+          break;
+        case "oleqpay:failed":
+          options.onError?.(data);
+          break;
+        case "oleqpay:close":
+          onUserClose();
+          break;
+        default:
+          break;
+      }
+    };
+    window.addEventListener("message", this.messageHandler);
+  }
+  /** Full-page redirect to hosted checkout — mirrors Stripe Checkout / Paystack redirect flow. */
+  redirect(payloadOrUrl) {
+    if (typeof window === "undefined") {
+      throw new OleqPayCheckoutError(
+        "OleqPayCheckout.redirect() can only run in a browser.",
+        "ssr_unsupported"
+      );
+    }
+    window.location.href = this.resolveUrl(payloadOrUrl);
+  }
+  /** Programmatically close an open iframe modal. */
+  close() {
+    this.activeModal?.close();
+    this.teardown();
+  }
+  resolveUrl(payloadOrUrl) {
+    if (typeof payloadOrUrl === "string") return payloadOrUrl;
+    return this.buildUrl(payloadOrUrl);
+  }
+  teardown() {
+    if (this.messageHandler) {
+      window.removeEventListener("message", this.messageHandler);
+      this.messageHandler = null;
+    }
+    this.activeModal = null;
+  }
+};
+
+// src/react/use-oleqpay-checkout.ts
+function useOleqPayCheckout(options = {}) {
+  const { checkoutBaseUrl, locale, onSuccess, onError } = options;
+  const client = useMemo(
+    () => new OleqPayCheckout({ checkoutBaseUrl, locale }),
+    [checkoutBaseUrl, locale]
+  );
+  const [isOpen, setIsOpen] = useState(false);
+  const [error, setError] = useState(null);
+  const clearError = useCallback(() => setError(null), []);
+  const openIframe = useCallback(
+    (payloadOrUrl) => {
+      setError(null);
+      try {
+        client.openIframe(payloadOrUrl, {
+          onSuccess: (event) => {
+            setIsOpen(false);
+            onSuccess?.(event);
+          },
+          onError: (event) => {
+            setError(event.message ?? "Payment failed");
+            onError?.(event);
+          },
+          onClose: () => setIsOpen(false)
+        });
+        setIsOpen(true);
+      } catch (err) {
+        setError(
+          err instanceof Error ? err.message : "Unable to open checkout"
+        );
+      }
+    },
+    [client, onSuccess, onError]
+  );
+  const redirect = useCallback(
+    (payloadOrUrl) => {
+      setError(null);
+      try {
+        client.redirect(payloadOrUrl);
+      } catch (err) {
+        setError(
+          err instanceof Error ? err.message : "Unable to redirect to checkout"
+        );
+      }
+    },
+    [client]
+  );
+  const close = useCallback(() => {
+    client.close();
+    setIsOpen(false);
+  }, [client]);
+  useEffect(() => () => client.close(), [client]);
+  return { openIframe, redirect, close, isOpen, error, clearError };
+}
+export {
+  useOleqPayCheckout
+};