@oleq-ai/pay 0.4.2

package/dist/index.mjs

@@ -0,0 +1,270 @@
+// 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;
+  }
+};
+export {
+  OleqPayCheckout,
+  OleqPayCheckoutError,
+  OleqPayCheckout as default
+};

package/dist/nest/index.d.mts

@@ -0,0 +1,19 @@
+import { DynamicModule } from '@nestjs/common';
+import { OleqPayCheckoutOptions, OleqPayCheckout } from '@oleq-ai/pay';
+
+declare const OLEQPAY_CHECKOUT_OPTIONS: unique symbol;
+type OleqPayCheckoutModuleOptions = OleqPayCheckoutOptions;
+type OleqPayCheckoutModuleAsyncOptions = {
+    useFactory: (...args: any[]) => OleqPayCheckoutModuleOptions | Promise<OleqPayCheckoutModuleOptions>;
+    inject?: any[];
+};
+declare function createOleqPayCheckout(options?: OleqPayCheckoutModuleOptions): OleqPayCheckout;
+
+declare class OleqPayCheckoutModule {
+    /** Register with static options (checkoutBaseUrl/locale), or empty for the defaults. */
+    static forRoot(options?: OleqPayCheckoutModuleOptions): DynamicModule;
+    /** Register with Nest config / async factory. */
+    static forRootAsync(options: OleqPayCheckoutModuleAsyncOptions): DynamicModule;
+}
+
+export { OLEQPAY_CHECKOUT_OPTIONS, OleqPayCheckoutModule, type OleqPayCheckoutModuleAsyncOptions, type OleqPayCheckoutModuleOptions, createOleqPayCheckout };

package/dist/nest/index.d.ts

@@ -0,0 +1,19 @@
+import { DynamicModule } from '@nestjs/common';
+import { OleqPayCheckoutOptions, OleqPayCheckout } from '@oleq-ai/pay';
+
+declare const OLEQPAY_CHECKOUT_OPTIONS: unique symbol;
+type OleqPayCheckoutModuleOptions = OleqPayCheckoutOptions;
+type OleqPayCheckoutModuleAsyncOptions = {
+    useFactory: (...args: any[]) => OleqPayCheckoutModuleOptions | Promise<OleqPayCheckoutModuleOptions>;
+    inject?: any[];
+};
+declare function createOleqPayCheckout(options?: OleqPayCheckoutModuleOptions): OleqPayCheckout;
+
+declare class OleqPayCheckoutModule {
+    /** Register with static options (checkoutBaseUrl/locale), or empty for the defaults. */
+    static forRoot(options?: OleqPayCheckoutModuleOptions): DynamicModule;
+    /** Register with Nest config / async factory. */
+    static forRootAsync(options: OleqPayCheckoutModuleAsyncOptions): DynamicModule;
+}
+
+export { OLEQPAY_CHECKOUT_OPTIONS, OleqPayCheckoutModule, type OleqPayCheckoutModuleAsyncOptions, type OleqPayCheckoutModuleOptions, createOleqPayCheckout };

package/dist/nest/index.js

@@ -0,0 +1,129 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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);
+var __decoratorStart = (base) => [, , , __create(base?.[__knownSymbol("metadata")] ?? null)];
+var __decoratorStrings = ["class", "method", "getter", "setter", "accessor", "field", "value", "get", "set"];
+var __expectFn = (fn) => fn !== void 0 && typeof fn !== "function" ? __typeError("Function expected") : fn;
+var __decoratorContext = (kind, name, done, metadata, fns) => ({ kind: __decoratorStrings[kind], name, metadata, addInitializer: (fn) => done._ ? __typeError("Already initialized") : fns.push(__expectFn(fn || null)) });
+var __decoratorMetadata = (array, target) => __defNormalProp(target, __knownSymbol("metadata"), array[3]);
+var __runInitializers = (array, flags, self, value) => {
+  for (var i = 0, fns = array[flags >> 1], n = fns && fns.length; i < n; i++) flags & 1 ? fns[i].call(self) : value = fns[i].call(self, value);
+  return value;
+};
+var __decorateElement = (array, flags, name, decorators, target, extra) => {
+  var fn, it, done, ctx, access, k = flags & 7, s = !!(flags & 8), p = !!(flags & 16);
+  var j = k > 3 ? array.length + 1 : k ? s ? 1 : 2 : 0, key = __decoratorStrings[k + 5];
+  var initializers = k > 3 && (array[j - 1] = []), extraInitializers = array[j] || (array[j] = []);
+  var desc = k && (!p && !s && (target = target.prototype), k < 5 && (k > 3 || !p) && __getOwnPropDesc(k < 4 ? target : { get [name]() {
+    return __privateGet(this, extra);
+  }, set [name](x) {
+    return __privateSet(this, extra, x);
+  } }, name));
+  k ? p && k < 4 && __name(extra, (k > 2 ? "set " : k > 1 ? "get " : "") + name) : __name(target, name);
+  for (var i = decorators.length - 1; i >= 0; i--) {
+    ctx = __decoratorContext(k, name, done = {}, array[3], extraInitializers);
+    if (k) {
+      ctx.static = s, ctx.private = p, access = ctx.access = { has: p ? (x) => __privateIn(target, x) : (x) => name in x };
+      if (k ^ 3) access.get = p ? (x) => (k ^ 1 ? __privateGet : __privateMethod)(x, target, k ^ 4 ? extra : desc.get) : (x) => x[name];
+      if (k > 2) access.set = p ? (x, y) => __privateSet(x, target, y, k ^ 4 ? extra : desc.set) : (x, y) => x[name] = y;
+    }
+    it = (0, decorators[i])(k ? k < 4 ? p ? extra : desc[key] : k > 4 ? void 0 : { get: desc.get, set: desc.set } : target, ctx), done._ = 1;
+    if (k ^ 4 || it === void 0) __expectFn(it) && (k > 4 ? initializers.unshift(it) : k ? p ? extra = it : desc[key] = it : target = it);
+    else if (typeof it !== "object" || it === null) __typeError("Object expected");
+    else __expectFn(fn = it.get) && (desc.get = fn), __expectFn(fn = it.set) && (desc.set = fn), __expectFn(fn = it.init) && initializers.unshift(fn);
+  }
+  return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use the "in" operator on this value') : member.has(obj);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+
+// src/nest/index.ts
+var index_exports = {};
+__export(index_exports, {
+  OLEQPAY_CHECKOUT_OPTIONS: () => OLEQPAY_CHECKOUT_OPTIONS,
+  OleqPayCheckoutModule: () => OleqPayCheckoutModule,
+  createOleqPayCheckout: () => createOleqPayCheckout
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/nest/module.ts
+var import_common = require("@nestjs/common");
+var import_pay2 = require("@oleq-ai/pay");
+
+// src/nest/options.ts
+var import_pay = require("@oleq-ai/pay");
+var OLEQPAY_CHECKOUT_OPTIONS = /* @__PURE__ */ Symbol("OLEQPAY_CHECKOUT_OPTIONS");
+function createOleqPayCheckout(options = {}) {
+  return new import_pay.OleqPayCheckout(options);
+}
+
+// src/nest/module.ts
+var _OleqPayCheckoutModule_decorators, _init;
+_OleqPayCheckoutModule_decorators = [(0, import_common.Module)({})];
+var _OleqPayCheckoutModule = class _OleqPayCheckoutModule {
+  /** Register with static options (checkoutBaseUrl/locale), or empty for the defaults. */
+  static forRoot(options = {}) {
+    const optionsProvider = {
+      provide: OLEQPAY_CHECKOUT_OPTIONS,
+      useValue: options
+    };
+    return {
+      module: _OleqPayCheckoutModule,
+      providers: [optionsProvider, oleqPayCheckoutProvider],
+      exports: [import_pay2.OleqPayCheckout]
+    };
+  }
+  /** Register with Nest config / async factory. */
+  static forRootAsync(options) {
+    const optionsProvider = {
+      provide: OLEQPAY_CHECKOUT_OPTIONS,
+      useFactory: options.useFactory,
+      inject: options.inject ?? []
+    };
+    return {
+      module: _OleqPayCheckoutModule,
+      providers: [optionsProvider, oleqPayCheckoutProvider],
+      exports: [import_pay2.OleqPayCheckout]
+    };
+  }
+};
+_init = __decoratorStart(null);
+_OleqPayCheckoutModule = __decorateElement(_init, 0, "OleqPayCheckoutModule", _OleqPayCheckoutModule_decorators, _OleqPayCheckoutModule);
+__runInitializers(_init, 1, _OleqPayCheckoutModule);
+var OleqPayCheckoutModule = _OleqPayCheckoutModule;
+var oleqPayCheckoutProvider = {
+  provide: import_pay2.OleqPayCheckout,
+  useFactory: (opts) => createOleqPayCheckout(opts),
+  inject: [OLEQPAY_CHECKOUT_OPTIONS]
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  OLEQPAY_CHECKOUT_OPTIONS,
+  OleqPayCheckoutModule,
+  createOleqPayCheckout
+});

package/dist/nest/index.mjs

@@ -0,0 +1,105 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __decoratorStart = (base) => [, , , __create(base?.[__knownSymbol("metadata")] ?? null)];
+var __decoratorStrings = ["class", "method", "getter", "setter", "accessor", "field", "value", "get", "set"];
+var __expectFn = (fn) => fn !== void 0 && typeof fn !== "function" ? __typeError("Function expected") : fn;
+var __decoratorContext = (kind, name, done, metadata, fns) => ({ kind: __decoratorStrings[kind], name, metadata, addInitializer: (fn) => done._ ? __typeError("Already initialized") : fns.push(__expectFn(fn || null)) });
+var __decoratorMetadata = (array, target) => __defNormalProp(target, __knownSymbol("metadata"), array[3]);
+var __runInitializers = (array, flags, self, value) => {
+  for (var i = 0, fns = array[flags >> 1], n = fns && fns.length; i < n; i++) flags & 1 ? fns[i].call(self) : value = fns[i].call(self, value);
+  return value;
+};
+var __decorateElement = (array, flags, name, decorators, target, extra) => {
+  var fn, it, done, ctx, access, k = flags & 7, s = !!(flags & 8), p = !!(flags & 16);
+  var j = k > 3 ? array.length + 1 : k ? s ? 1 : 2 : 0, key = __decoratorStrings[k + 5];
+  var initializers = k > 3 && (array[j - 1] = []), extraInitializers = array[j] || (array[j] = []);
+  var desc = k && (!p && !s && (target = target.prototype), k < 5 && (k > 3 || !p) && __getOwnPropDesc(k < 4 ? target : { get [name]() {
+    return __privateGet(this, extra);
+  }, set [name](x) {
+    return __privateSet(this, extra, x);
+  } }, name));
+  k ? p && k < 4 && __name(extra, (k > 2 ? "set " : k > 1 ? "get " : "") + name) : __name(target, name);
+  for (var i = decorators.length - 1; i >= 0; i--) {
+    ctx = __decoratorContext(k, name, done = {}, array[3], extraInitializers);
+    if (k) {
+      ctx.static = s, ctx.private = p, access = ctx.access = { has: p ? (x) => __privateIn(target, x) : (x) => name in x };
+      if (k ^ 3) access.get = p ? (x) => (k ^ 1 ? __privateGet : __privateMethod)(x, target, k ^ 4 ? extra : desc.get) : (x) => x[name];
+      if (k > 2) access.set = p ? (x, y) => __privateSet(x, target, y, k ^ 4 ? extra : desc.set) : (x, y) => x[name] = y;
+    }
+    it = (0, decorators[i])(k ? k < 4 ? p ? extra : desc[key] : k > 4 ? void 0 : { get: desc.get, set: desc.set } : target, ctx), done._ = 1;
+    if (k ^ 4 || it === void 0) __expectFn(it) && (k > 4 ? initializers.unshift(it) : k ? p ? extra = it : desc[key] = it : target = it);
+    else if (typeof it !== "object" || it === null) __typeError("Object expected");
+    else __expectFn(fn = it.get) && (desc.get = fn), __expectFn(fn = it.set) && (desc.set = fn), __expectFn(fn = it.init) && initializers.unshift(fn);
+  }
+  return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use the "in" operator on this value') : member.has(obj);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+
+// src/nest/module.ts
+import { Module } from "@nestjs/common";
+import { OleqPayCheckout as OleqPayCheckout2 } from "@oleq-ai/pay";
+
+// src/nest/options.ts
+import {
+  OleqPayCheckout
+} from "@oleq-ai/pay";
+var OLEQPAY_CHECKOUT_OPTIONS = /* @__PURE__ */ Symbol("OLEQPAY_CHECKOUT_OPTIONS");
+function createOleqPayCheckout(options = {}) {
+  return new OleqPayCheckout(options);
+}
+
+// src/nest/module.ts
+var _OleqPayCheckoutModule_decorators, _init;
+_OleqPayCheckoutModule_decorators = [Module({})];
+var _OleqPayCheckoutModule = class _OleqPayCheckoutModule {
+  /** Register with static options (checkoutBaseUrl/locale), or empty for the defaults. */
+  static forRoot(options = {}) {
+    const optionsProvider = {
+      provide: OLEQPAY_CHECKOUT_OPTIONS,
+      useValue: options
+    };
+    return {
+      module: _OleqPayCheckoutModule,
+      providers: [optionsProvider, oleqPayCheckoutProvider],
+      exports: [OleqPayCheckout2]
+    };
+  }
+  /** Register with Nest config / async factory. */
+  static forRootAsync(options) {
+    const optionsProvider = {
+      provide: OLEQPAY_CHECKOUT_OPTIONS,
+      useFactory: options.useFactory,
+      inject: options.inject ?? []
+    };
+    return {
+      module: _OleqPayCheckoutModule,
+      providers: [optionsProvider, oleqPayCheckoutProvider],
+      exports: [OleqPayCheckout2]
+    };
+  }
+};
+_init = __decoratorStart(null);
+_OleqPayCheckoutModule = __decorateElement(_init, 0, "OleqPayCheckoutModule", _OleqPayCheckoutModule_decorators, _OleqPayCheckoutModule);
+__runInitializers(_init, 1, _OleqPayCheckoutModule);
+var OleqPayCheckoutModule = _OleqPayCheckoutModule;
+var oleqPayCheckoutProvider = {
+  provide: OleqPayCheckout2,
+  useFactory: (opts) => createOleqPayCheckout(opts),
+  inject: [OLEQPAY_CHECKOUT_OPTIONS]
+};
+export {
+  OLEQPAY_CHECKOUT_OPTIONS,
+  OleqPayCheckoutModule,
+  createOleqPayCheckout
+};

package/dist/react/index.d.mts

@@ -0,0 +1,51 @@
+interface CheckoutPayload {
+    apikey: string;
+    amount: string | number;
+    orderid: string | number;
+    reference: string;
+    callbackurl?: string;
+    returnurl?: string;
+}
+type CheckoutEvent = {
+    type: 'oleqpay:ready';
+} | {
+    type: 'oleqpay:success';
+    vreference: string;
+    amount?: string;
+} | {
+    type: 'oleqpay:failed';
+    vreference?: string;
+    message?: string;
+} | {
+    type: 'oleqpay:close';
+};
+type OleqPayCheckoutOptions = {
+    checkoutBaseUrl?: string;
+    locale?: string;
+};
+
+type UseOleqPayCheckoutOptions = OleqPayCheckoutOptions & {
+    /** Called once the checkout iframe confirms the payment succeeded. */
+    onSuccess?: (event: Extract<CheckoutEvent, {
+        type: 'oleqpay:success';
+    }>) => void;
+    /** Called if the payment fails or is cancelled inside the checkout flow. */
+    onError?: (event: Extract<CheckoutEvent, {
+        type: 'oleqpay:failed';
+    }>) => void;
+};
+type OleqPayCheckoutResult = {
+    /** Open checkout in a modal iframe. */
+    openIframe: (payloadOrUrl: CheckoutPayload | string) => void;
+    /** Full-page redirect to hosted checkout. */
+    redirect: (payloadOrUrl: CheckoutPayload | string) => void;
+    /** Programmatically close an open modal. */
+    close: () => void;
+    isOpen: boolean;
+    error: string | null;
+    clearError: () => void;
+};
+/** React wrapper around {@link OleqPayCheckout} — modal lifecycle as state. */
+declare function useOleqPayCheckout(options?: UseOleqPayCheckoutOptions): OleqPayCheckoutResult;
+
+export { type OleqPayCheckoutResult, type UseOleqPayCheckoutOptions, useOleqPayCheckout };

package/dist/react/index.d.ts

@@ -0,0 +1,51 @@
+interface CheckoutPayload {
+    apikey: string;
+    amount: string | number;
+    orderid: string | number;
+    reference: string;
+    callbackurl?: string;
+    returnurl?: string;
+}
+type CheckoutEvent = {
+    type: 'oleqpay:ready';
+} | {
+    type: 'oleqpay:success';
+    vreference: string;
+    amount?: string;
+} | {
+    type: 'oleqpay:failed';
+    vreference?: string;
+    message?: string;
+} | {
+    type: 'oleqpay:close';
+};
+type OleqPayCheckoutOptions = {
+    checkoutBaseUrl?: string;
+    locale?: string;
+};
+
+type UseOleqPayCheckoutOptions = OleqPayCheckoutOptions & {
+    /** Called once the checkout iframe confirms the payment succeeded. */
+    onSuccess?: (event: Extract<CheckoutEvent, {
+        type: 'oleqpay:success';
+    }>) => void;
+    /** Called if the payment fails or is cancelled inside the checkout flow. */
+    onError?: (event: Extract<CheckoutEvent, {
+        type: 'oleqpay:failed';
+    }>) => void;
+};
+type OleqPayCheckoutResult = {
+    /** Open checkout in a modal iframe. */
+    openIframe: (payloadOrUrl: CheckoutPayload | string) => void;
+    /** Full-page redirect to hosted checkout. */
+    redirect: (payloadOrUrl: CheckoutPayload | string) => void;
+    /** Programmatically close an open modal. */
+    close: () => void;
+    isOpen: boolean;
+    error: string | null;
+    clearError: () => void;
+};
+/** React wrapper around {@link OleqPayCheckout} — modal lifecycle as state. */
+declare function useOleqPayCheckout(options?: UseOleqPayCheckoutOptions): OleqPayCheckoutResult;
+
+export { type OleqPayCheckoutResult, type UseOleqPayCheckoutOptions, useOleqPayCheckout };