@konetpay/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KonetPay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# @konetpay/core
+
+Framework-agnostic API client for KonetPay. No DOM/browser assumptions —
+works in Node backends, browsers, and React Native.
+
+```bash
+npm install @konetpay/core
+```
+
+## Quick start
+
+```ts
+// backend — secret key, initializes a transaction
+import { KonetPayServerClient } from "@konetpay/core";
+
+const konet = new KonetPayServerClient({ secretKey: process.env.KONETPAY_SECRET_KEY! });
+
+const transaction = await konet.initializeTransaction({
+  amount: 500_000, // ₦5,000.00, in kobo
+  currency: "NGN",
+  customer: { email: "customer@example.com" },
+});
+// { reference, accessCode, authorizationUrl }
+```
+
+```ts
+// browser or backend — publishable key, checks status
+import { KonetPayClient } from "@konetpay/core";
+
+const konet = new KonetPayClient({ publicKey: "pk_test_..." });
+
+const result = await konet.verifyTransaction(reference);
+if (result.paymentStatus === "successful") {
+  // fulfill the order
+}
+```
+
+`authorizationUrl` is a hosted checkout page — this package never renders
+payment UI itself. To open it as an iframe overlay in a browser, see
+[`@konetpay/web`](https://github.com/21st-Century-Technologies/konetpay-sdk-frontend/tree/main/packages/web).
+
+## Why the key split?
+
+Only the secret key can initialize a transaction — that's what makes the
+amount trustworthy, since a browser holding only the publishable key can
+never create one and so can't tamper with it. The publishable key can verify
+a transaction's status, a read-only operation safe to call from the browser
+or your backend.
+
+See [USAGE.md](https://github.com/21st-Century-Technologies/konetpay-sdk-frontend/blob/main/USAGE.md)
+in the repo root for the full integration guide, including the
+`openCheckout` → `verifyTransaction` flow end to end.

package/dist/index.cjs

@@ -0,0 +1,177 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CHECKOUT_MESSAGE_TYPE: () => CHECKOUT_MESSAGE_TYPE,
+  KonetPayApiError: () => KonetPayApiError,
+  KonetPayClient: () => KonetPayClient,
+  KonetPayError: () => KonetPayError,
+  KonetPayServerClient: () => KonetPayServerClient,
+  KonetPayValidationError: () => KonetPayValidationError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors/index.ts
+var KonetPayError = class extends Error {
+  constructor(message, code = "unknown_error", details) {
+    super(message);
+    this.name = "KonetPayError";
+    this.code = code;
+    this.details = details;
+  }
+};
+var KonetPayApiError = class extends KonetPayError {
+  constructor(message, statusCode, code = "api_error", details) {
+    super(message, code, details);
+    this.name = "KonetPayApiError";
+    this.statusCode = statusCode;
+  }
+};
+var KonetPayValidationError = class extends KonetPayError {
+  constructor(message, field) {
+    super(message, "validation_error");
+    this.name = "KonetPayValidationError";
+    this.field = field;
+  }
+};
+
+// src/transport/index.ts
+var DEFAULT_BASE_URLS = {
+  sandbox: "https://core-dev-api.konetpay.com",
+  live: "https://core-api.konetpay.com"
+};
+var HttpClient = class {
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new KonetPayApiError("A valid API key is required to initialize this client.", 0, "missing_api_key");
+    }
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URLS[config.environment ?? "sandbox"];
+  }
+  async request(path, init = {}) {
+    const response = await fetch(`${this.baseUrl}${path}`, {
+      ...init,
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`,
+        ...init.headers
+      }
+    });
+    const body = await response.json().catch(() => void 0);
+    if (!response.ok || body?.status === "error") {
+      throw new KonetPayApiError(
+        body?.message ?? `Request to ${path} failed with status ${response.status}`,
+        response.status,
+        body?.code ?? "api_error",
+        body
+      );
+    }
+    return body?.data;
+  }
+};
+
+// src/client.ts
+var KonetPayClient = class {
+  constructor(config) {
+    this.http = new HttpClient({
+      apiKey: config.publicKey,
+      baseUrl: config.baseUrl,
+      environment: config.environment
+    });
+  }
+  async verifyTransaction(reference) {
+    const raw = await this.http.request(`/api/transactions/status/${reference}/`);
+    return {
+      reference: raw.reference,
+      originalAmount: raw.original_amount,
+      paidAmount: raw.paid_amount,
+      totalAmount: raw.total_amount,
+      totalFee: raw.total_fee,
+      currencyCode: raw.currency_code,
+      currencySymbol: raw.currency_symbol,
+      paymentStatus: raw.payment_status,
+      message: raw.message,
+      mode: raw.mode,
+      paymentRedirectUrl: raw.payment_redirect_url
+    };
+  }
+};
+
+// src/validate-transaction-params.ts
+function assertValidInitializeTransactionParams(params) {
+  if (!Number.isInteger(params.amount) || params.amount <= 0) {
+    throw new KonetPayValidationError("amount must be a positive integer (minor currency units).", "amount");
+  }
+  if (!params.customer?.email) {
+    throw new KonetPayValidationError("customer.email is required.", "customer.email");
+  }
+}
+
+// src/server-client.ts
+var KonetPayServerClient = class {
+  constructor(config) {
+    this.http = new HttpClient({
+      apiKey: config.secretKey,
+      baseUrl: config.baseUrl,
+      environment: config.environment
+    });
+  }
+  async initializeTransaction(params) {
+    assertValidInitializeTransactionParams(params);
+    const raw = await this.http.request("/api/transactions/initialize/", {
+      method: "POST",
+      body: JSON.stringify({
+        amount: params.amount,
+        currency: params.currency,
+        email: params.customer.email,
+        customer_first_name: params.customer.firstName,
+        customer_last_name: params.customer.lastName,
+        customer_phone_number: params.customer.phoneNumber,
+        channels: params.channels,
+        fee_bearer: params.feeBearer,
+        metadata: params.metadata,
+        callback_url: params.callbackUrl
+      })
+    });
+    return {
+      reference: raw.reference,
+      accessCode: raw.access_code,
+      authorizationUrl: raw.authorization_url
+    };
+  }
+};
+
+// src/checkout/protocol.ts
+var CHECKOUT_MESSAGE_TYPE = {
+  SUCCESS: "konetpay:checkout:success",
+  CLOSE: "konetpay:checkout:close",
+  ERROR: "konetpay:checkout:error"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CHECKOUT_MESSAGE_TYPE,
+  KonetPayApiError,
+  KonetPayClient,
+  KonetPayError,
+  KonetPayServerClient,
+  KonetPayValidationError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors/index.ts","../src/transport/index.ts","../src/client.ts","../src/validate-transaction-params.ts","../src/server-client.ts","../src/checkout/protocol.ts"],"sourcesContent":["export { KonetPayClient } from \"./client\";\nexport type { KonetPayClientConfig } from \"./client\";\n\nexport { KonetPayServerClient } from \"./server-client\";\nexport type { KonetPayServerClientConfig } from \"./server-client\";\n\nexport * from \"./types\";\nexport * from \"./errors\";\nexport * from \"./checkout/protocol\";\n","export class KonetPayError extends Error {\n  readonly code: string;\n  readonly details?: unknown;\n\n  constructor(message: string, code = \"unknown_error\", details?: unknown) {\n    super(message);\n    this.name = \"KonetPayError\";\n    this.code = code;\n    this.details = details;\n  }\n}\n\nexport class KonetPayApiError extends KonetPayError {\n  readonly statusCode: number;\n\n  constructor(message: string, statusCode: number, code = \"api_error\", details?: unknown) {\n    super(message, code, details);\n    this.name = \"KonetPayApiError\";\n    this.statusCode = statusCode;\n  }\n}\n\nexport class KonetPayValidationError extends KonetPayError {\n  readonly field?: string;\n\n  constructor(message: string, field?: string) {\n    super(message, \"validation_error\");\n    this.name = \"KonetPayValidationError\";\n    this.field = field;\n  }\n}\n","import { KonetPayApiError } from \"../errors\";\n\nexport interface HttpClientConfig {\n  apiKey: string;\n  baseUrl?: string;\n  environment?: \"sandbox\" | \"live\";\n}\n\nconst DEFAULT_BASE_URLS: Record<\"sandbox\" | \"live\", string> = {\n  sandbox: \"https://core-dev-api.konetpay.com\",\n  live: \"https://core-api.konetpay.com\",\n};\n\nexport class HttpClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n\n  constructor(config: HttpClientConfig) {\n    if (!config.apiKey) {\n      throw new KonetPayApiError(\"A valid API key is required to initialize this client.\", 0, \"missing_api_key\");\n    }\n    this.apiKey = config.apiKey;\n    this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URLS[config.environment ?? \"sandbox\"];\n  }\n\n  async request<T>(path: string, init: RequestInit = {}): Promise<T> {\n    const response = await fetch(`${this.baseUrl}${path}`, {\n      ...init,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${this.apiKey}`,\n        ...init.headers,\n      },\n    });\n\n    const body = await response.json().catch(() => undefined);\n\n    if (!response.ok || body?.status === \"error\") {\n      throw new KonetPayApiError(\n        body?.message ?? `Request to ${path} failed with status ${response.status}`,\n        response.status,\n        body?.code ?? \"api_error\",\n        body,\n      );\n    }\n\n    // Every response is wrapped as { status, message, data }.\n    return body?.data as T;\n  }\n}\n","import { HttpClient } from \"./transport\";\nimport type { Currency, PaymentStatus, VerifyTransactionResult } from \"./types\";\n\nexport interface KonetPayClientConfig {\n  /** Publishable key — safe to ship in a browser bundle. Never put a secret key here. */\n  publicKey: string;\n  baseUrl?: string;\n  environment?: \"sandbox\" | \"live\";\n}\n\n/**\n * Browser-safe client. Initializing a transaction requires a secret key and\n * lives on KonetPayServerClient instead, which must only run on your\n * backend. This client only checks transaction status — that's safe with a\n * publishable key, so it can be called directly from the browser or from\n * your backend, whichever suits your flow.\n */\nexport class KonetPayClient {\n  private readonly http: HttpClient;\n\n  constructor(config: KonetPayClientConfig) {\n    this.http = new HttpClient({\n      apiKey: config.publicKey,\n      baseUrl: config.baseUrl,\n      environment: config.environment,\n    });\n  }\n\n  async verifyTransaction(reference: string): Promise<VerifyTransactionResult> {\n    // Not /api/transactions/verify/ — that endpoint is secret-key-gated and\n    // returns an unrelated webhook-payload shape. This is the one publishable\n    // keys can actually call, and the one the hosted checkout page itself uses.\n    const raw = await this.http.request<RawVerifyTransactionResponse>(`/api/transactions/status/${reference}/`);\n    return {\n      reference: raw.reference,\n      originalAmount: raw.original_amount,\n      paidAmount: raw.paid_amount,\n      totalAmount: raw.total_amount,\n      totalFee: raw.total_fee,\n      currencyCode: raw.currency_code,\n      currencySymbol: raw.currency_symbol,\n      paymentStatus: raw.payment_status,\n      message: raw.message,\n      mode: raw.mode,\n      paymentRedirectUrl: raw.payment_redirect_url,\n    };\n  }\n}\n\n/** Wire shape — the API returns snake_case, the SDK exposes camelCase. */\ninterface RawVerifyTransactionResponse {\n  reference: string;\n  original_amount: number;\n  paid_amount: number;\n  total_amount: number;\n  total_fee: number;\n  currency_code: Currency;\n  currency_symbol: string;\n  payment_status: PaymentStatus;\n  message: string;\n  mode: \"test\" | \"live\";\n  payment_redirect_url: string | null;\n}\n","import { KonetPayValidationError } from \"./errors\";\nimport type { InitializeTransactionParams } from \"./types\";\n\nexport function assertValidInitializeTransactionParams(params: InitializeTransactionParams): void {\n  if (!Number.isInteger(params.amount) || params.amount <= 0) {\n    throw new KonetPayValidationError(\"amount must be a positive integer (minor currency units).\", \"amount\");\n  }\n  if (!params.customer?.email) {\n    throw new KonetPayValidationError(\"customer.email is required.\", \"customer.email\");\n  }\n}\n","import { HttpClient } from \"./transport\";\nimport { assertValidInitializeTransactionParams } from \"./validate-transaction-params\";\nimport type { InitializeTransactionParams, InitializeTransactionResult } from \"./types\";\n\nexport interface KonetPayServerClientConfig {\n  /** Secret key — backend-only. Never ship this to a browser bundle. */\n  secretKey: string;\n  baseUrl?: string;\n  environment?: \"sandbox\" | \"live\";\n}\n\n/**\n * Backend-only client. Requires a secret key, so it must never run in a\n * browser bundle or React Native app. Only the secret key can initialize a\n * transaction — this is what makes the amount trustworthy, since the client\n * never sees this key or picks the amount itself.\n */\nexport class KonetPayServerClient {\n  private readonly http: HttpClient;\n\n  constructor(config: KonetPayServerClientConfig) {\n    this.http = new HttpClient({\n      apiKey: config.secretKey,\n      baseUrl: config.baseUrl,\n      environment: config.environment,\n    });\n  }\n\n  async initializeTransaction(params: InitializeTransactionParams): Promise<InitializeTransactionResult> {\n    assertValidInitializeTransactionParams(params);\n    const raw = await this.http.request<RawInitializeTransactionResponse>(\"/api/transactions/initialize/\", {\n      method: \"POST\",\n      body: JSON.stringify({\n        amount: params.amount,\n        currency: params.currency,\n        email: params.customer.email,\n        customer_first_name: params.customer.firstName,\n        customer_last_name: params.customer.lastName,\n        customer_phone_number: params.customer.phoneNumber,\n        channels: params.channels,\n        fee_bearer: params.feeBearer,\n        metadata: params.metadata,\n        callback_url: params.callbackUrl,\n      }),\n    });\n    return {\n      reference: raw.reference,\n      accessCode: raw.access_code,\n      authorizationUrl: raw.authorization_url,\n    };\n  }\n}\n\n/** Wire shape — the API returns snake_case, the SDK exposes camelCase. */\ninterface RawInitializeTransactionResponse {\n  reference: string;\n  access_code: string;\n  authorization_url: string;\n}\n","/**\n * Message contract between the hosted checkout page and any SDK-side trigger\n * (browser iframe overlay via postMessage, React Native via a WebView bridge, ...).\n * Kept here, not in a platform package, so every transport agrees on the same shape.\n */\nexport const CHECKOUT_MESSAGE_TYPE = {\n  SUCCESS: \"konetpay:checkout:success\",\n  CLOSE: \"konetpay:checkout:close\",\n  ERROR: \"konetpay:checkout:error\",\n} as const;\n\nexport interface CheckoutSuccessMessage {\n  type: typeof CHECKOUT_MESSAGE_TYPE.SUCCESS;\n  reference: string;\n}\n\nexport interface CheckoutCloseMessage {\n  type: typeof CHECKOUT_MESSAGE_TYPE.CLOSE;\n}\n\nexport interface CheckoutErrorMessage {\n  type: typeof CHECKOUT_MESSAGE_TYPE.ERROR;\n  reference: string;\n  message?: string;\n}\n\nexport type CheckoutMessage = CheckoutSuccessMessage | CheckoutCloseMessage | CheckoutErrorMessage;\n\nexport type CheckoutResult =\n  | { status: \"success\"; reference: string }\n  | { status: \"cancelled\" }\n  | { status: \"error\"; reference: string; message?: string };\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,135 @@
+type Currency = "NGN" | "USD" | "GBP" | "EUR";
+type PaymentMethodType = "card" | "bank_transfer";
+/** Who pays the transaction fee. Extend as the API adds more values. */
+type FeeBearer = "merchant" | "customer" | (string & {});
+/**
+ * Known values seen from the API so far — treated as an open string union
+ * since the full set hasn't been confirmed. Widen this as more are observed.
+ */
+type PaymentStatus = "abandoned" | "pending" | "successful" | "failed" | "expired" | (string & {});
+interface TransactionCustomer {
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    phoneNumber?: string;
+}
+interface InitializeTransactionParams {
+    /** Positive integer, minor currency units (e.g. kobo, not naira). */
+    amount: number;
+    currency: Currency;
+    customer: TransactionCustomer;
+    /** Restrict which payment methods the hosted checkout offers. Omit to allow all enabled methods. */
+    channels?: PaymentMethodType[];
+    feeBearer?: FeeBearer;
+    metadata?: Record<string, unknown>;
+    /** Where the API's own redirect fallback points after payment (?reference=&status=). Omit to fall back to the business's configured default redirect URL. Separate from this SDK's iframe/postMessage flow. */
+    callbackUrl?: string;
+}
+interface InitializeTransactionResult {
+    reference: string;
+    accessCode: string;
+    /** The hosted checkout page to open in a popup/iframe/redirect — never rendered by this SDK. */
+    authorizationUrl: string;
+}
+interface VerifyTransactionResult {
+    reference: string;
+    /** Amounts below are in MAJOR currency units (e.g. naira, not kobo) — unlike InitializeTransactionParams.amount. */
+    originalAmount: number;
+    paidAmount: number;
+    totalAmount: number;
+    totalFee: number;
+    currencyCode: Currency;
+    currencySymbol: string;
+    paymentStatus: PaymentStatus;
+    message: string;
+    mode: "test" | "live";
+    /** Merchant's post-payment redirect URL (`?reference=&status=`), populated only once the transaction reaches a terminal status. This is the same fallback the hosted checkout page redirects to when it wasn't opened inside the SDK's iframe. */
+    paymentRedirectUrl: string | null;
+}
+
+interface KonetPayClientConfig {
+    /** Publishable key — safe to ship in a browser bundle. Never put a secret key here. */
+    publicKey: string;
+    baseUrl?: string;
+    environment?: "sandbox" | "live";
+}
+/**
+ * Browser-safe client. Initializing a transaction requires a secret key and
+ * lives on KonetPayServerClient instead, which must only run on your
+ * backend. This client only checks transaction status — that's safe with a
+ * publishable key, so it can be called directly from the browser or from
+ * your backend, whichever suits your flow.
+ */
+declare class KonetPayClient {
+    private readonly http;
+    constructor(config: KonetPayClientConfig);
+    verifyTransaction(reference: string): Promise<VerifyTransactionResult>;
+}
+
+interface KonetPayServerClientConfig {
+    /** Secret key — backend-only. Never ship this to a browser bundle. */
+    secretKey: string;
+    baseUrl?: string;
+    environment?: "sandbox" | "live";
+}
+/**
+ * Backend-only client. Requires a secret key, so it must never run in a
+ * browser bundle or React Native app. Only the secret key can initialize a
+ * transaction — this is what makes the amount trustworthy, since the client
+ * never sees this key or picks the amount itself.
+ */
+declare class KonetPayServerClient {
+    private readonly http;
+    constructor(config: KonetPayServerClientConfig);
+    initializeTransaction(params: InitializeTransactionParams): Promise<InitializeTransactionResult>;
+}
+
+declare class KonetPayError extends Error {
+    readonly code: string;
+    readonly details?: unknown;
+    constructor(message: string, code?: string, details?: unknown);
+}
+declare class KonetPayApiError extends KonetPayError {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number, code?: string, details?: unknown);
+}
+declare class KonetPayValidationError extends KonetPayError {
+    readonly field?: string;
+    constructor(message: string, field?: string);
+}
+
+/**
+ * Message contract between the hosted checkout page and any SDK-side trigger
+ * (browser iframe overlay via postMessage, React Native via a WebView bridge, ...).
+ * Kept here, not in a platform package, so every transport agrees on the same shape.
+ */
+declare const CHECKOUT_MESSAGE_TYPE: {
+    readonly SUCCESS: "konetpay:checkout:success";
+    readonly CLOSE: "konetpay:checkout:close";
+    readonly ERROR: "konetpay:checkout:error";
+};
+interface CheckoutSuccessMessage {
+    type: typeof CHECKOUT_MESSAGE_TYPE.SUCCESS;
+    reference: string;
+}
+interface CheckoutCloseMessage {
+    type: typeof CHECKOUT_MESSAGE_TYPE.CLOSE;
+}
+interface CheckoutErrorMessage {
+    type: typeof CHECKOUT_MESSAGE_TYPE.ERROR;
+    reference: string;
+    message?: string;
+}
+type CheckoutMessage = CheckoutSuccessMessage | CheckoutCloseMessage | CheckoutErrorMessage;
+type CheckoutResult = {
+    status: "success";
+    reference: string;
+} | {
+    status: "cancelled";
+} | {
+    status: "error";
+    reference: string;
+    message?: string;
+};
+
+export { CHECKOUT_MESSAGE_TYPE, type CheckoutCloseMessage, type CheckoutErrorMessage, type CheckoutMessage, type CheckoutResult, type CheckoutSuccessMessage, type Currency, type FeeBearer, type InitializeTransactionParams, type InitializeTransactionResult, KonetPayApiError, KonetPayClient, type KonetPayClientConfig, KonetPayError, KonetPayServerClient, type KonetPayServerClientConfig, KonetPayValidationError, type PaymentMethodType, type PaymentStatus, type TransactionCustomer, type VerifyTransactionResult };

package/dist/index.d.ts

@@ -0,0 +1,135 @@
+type Currency = "NGN" | "USD" | "GBP" | "EUR";
+type PaymentMethodType = "card" | "bank_transfer";
+/** Who pays the transaction fee. Extend as the API adds more values. */
+type FeeBearer = "merchant" | "customer" | (string & {});
+/**
+ * Known values seen from the API so far — treated as an open string union
+ * since the full set hasn't been confirmed. Widen this as more are observed.
+ */
+type PaymentStatus = "abandoned" | "pending" | "successful" | "failed" | "expired" | (string & {});
+interface TransactionCustomer {
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    phoneNumber?: string;
+}
+interface InitializeTransactionParams {
+    /** Positive integer, minor currency units (e.g. kobo, not naira). */
+    amount: number;
+    currency: Currency;
+    customer: TransactionCustomer;
+    /** Restrict which payment methods the hosted checkout offers. Omit to allow all enabled methods. */
+    channels?: PaymentMethodType[];
+    feeBearer?: FeeBearer;
+    metadata?: Record<string, unknown>;
+    /** Where the API's own redirect fallback points after payment (?reference=&status=). Omit to fall back to the business's configured default redirect URL. Separate from this SDK's iframe/postMessage flow. */
+    callbackUrl?: string;
+}
+interface InitializeTransactionResult {
+    reference: string;
+    accessCode: string;
+    /** The hosted checkout page to open in a popup/iframe/redirect — never rendered by this SDK. */
+    authorizationUrl: string;
+}
+interface VerifyTransactionResult {
+    reference: string;
+    /** Amounts below are in MAJOR currency units (e.g. naira, not kobo) — unlike InitializeTransactionParams.amount. */
+    originalAmount: number;
+    paidAmount: number;
+    totalAmount: number;
+    totalFee: number;
+    currencyCode: Currency;
+    currencySymbol: string;
+    paymentStatus: PaymentStatus;
+    message: string;
+    mode: "test" | "live";
+    /** Merchant's post-payment redirect URL (`?reference=&status=`), populated only once the transaction reaches a terminal status. This is the same fallback the hosted checkout page redirects to when it wasn't opened inside the SDK's iframe. */
+    paymentRedirectUrl: string | null;
+}
+
+interface KonetPayClientConfig {
+    /** Publishable key — safe to ship in a browser bundle. Never put a secret key here. */
+    publicKey: string;
+    baseUrl?: string;
+    environment?: "sandbox" | "live";
+}
+/**
+ * Browser-safe client. Initializing a transaction requires a secret key and
+ * lives on KonetPayServerClient instead, which must only run on your
+ * backend. This client only checks transaction status — that's safe with a
+ * publishable key, so it can be called directly from the browser or from
+ * your backend, whichever suits your flow.
+ */
+declare class KonetPayClient {
+    private readonly http;
+    constructor(config: KonetPayClientConfig);
+    verifyTransaction(reference: string): Promise<VerifyTransactionResult>;
+}
+
+interface KonetPayServerClientConfig {
+    /** Secret key — backend-only. Never ship this to a browser bundle. */
+    secretKey: string;
+    baseUrl?: string;
+    environment?: "sandbox" | "live";
+}
+/**
+ * Backend-only client. Requires a secret key, so it must never run in a
+ * browser bundle or React Native app. Only the secret key can initialize a
+ * transaction — this is what makes the amount trustworthy, since the client
+ * never sees this key or picks the amount itself.
+ */
+declare class KonetPayServerClient {
+    private readonly http;
+    constructor(config: KonetPayServerClientConfig);
+    initializeTransaction(params: InitializeTransactionParams): Promise<InitializeTransactionResult>;
+}
+
+declare class KonetPayError extends Error {
+    readonly code: string;
+    readonly details?: unknown;
+    constructor(message: string, code?: string, details?: unknown);
+}
+declare class KonetPayApiError extends KonetPayError {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number, code?: string, details?: unknown);
+}
+declare class KonetPayValidationError extends KonetPayError {
+    readonly field?: string;
+    constructor(message: string, field?: string);
+}
+
+/**
+ * Message contract between the hosted checkout page and any SDK-side trigger
+ * (browser iframe overlay via postMessage, React Native via a WebView bridge, ...).
+ * Kept here, not in a platform package, so every transport agrees on the same shape.
+ */
+declare const CHECKOUT_MESSAGE_TYPE: {
+    readonly SUCCESS: "konetpay:checkout:success";
+    readonly CLOSE: "konetpay:checkout:close";
+    readonly ERROR: "konetpay:checkout:error";
+};
+interface CheckoutSuccessMessage {
+    type: typeof CHECKOUT_MESSAGE_TYPE.SUCCESS;
+    reference: string;
+}
+interface CheckoutCloseMessage {
+    type: typeof CHECKOUT_MESSAGE_TYPE.CLOSE;
+}
+interface CheckoutErrorMessage {
+    type: typeof CHECKOUT_MESSAGE_TYPE.ERROR;
+    reference: string;
+    message?: string;
+}
+type CheckoutMessage = CheckoutSuccessMessage | CheckoutCloseMessage | CheckoutErrorMessage;
+type CheckoutResult = {
+    status: "success";
+    reference: string;
+} | {
+    status: "cancelled";
+} | {
+    status: "error";
+    reference: string;
+    message?: string;
+};
+
+export { CHECKOUT_MESSAGE_TYPE, type CheckoutCloseMessage, type CheckoutErrorMessage, type CheckoutMessage, type CheckoutResult, type CheckoutSuccessMessage, type Currency, type FeeBearer, type InitializeTransactionParams, type InitializeTransactionResult, KonetPayApiError, KonetPayClient, type KonetPayClientConfig, KonetPayError, KonetPayServerClient, type KonetPayServerClientConfig, KonetPayValidationError, type PaymentMethodType, type PaymentStatus, type TransactionCustomer, type VerifyTransactionResult };

package/dist/index.js

@@ -0,0 +1,145 @@
+// src/errors/index.ts
+var KonetPayError = class extends Error {
+  constructor(message, code = "unknown_error", details) {
+    super(message);
+    this.name = "KonetPayError";
+    this.code = code;
+    this.details = details;
+  }
+};
+var KonetPayApiError = class extends KonetPayError {
+  constructor(message, statusCode, code = "api_error", details) {
+    super(message, code, details);
+    this.name = "KonetPayApiError";
+    this.statusCode = statusCode;
+  }
+};
+var KonetPayValidationError = class extends KonetPayError {
+  constructor(message, field) {
+    super(message, "validation_error");
+    this.name = "KonetPayValidationError";
+    this.field = field;
+  }
+};
+
+// src/transport/index.ts
+var DEFAULT_BASE_URLS = {
+  sandbox: "https://core-dev-api.konetpay.com",
+  live: "https://core-api.konetpay.com"
+};
+var HttpClient = class {
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new KonetPayApiError("A valid API key is required to initialize this client.", 0, "missing_api_key");
+    }
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URLS[config.environment ?? "sandbox"];
+  }
+  async request(path, init = {}) {
+    const response = await fetch(`${this.baseUrl}${path}`, {
+      ...init,
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`,
+        ...init.headers
+      }
+    });
+    const body = await response.json().catch(() => void 0);
+    if (!response.ok || body?.status === "error") {
+      throw new KonetPayApiError(
+        body?.message ?? `Request to ${path} failed with status ${response.status}`,
+        response.status,
+        body?.code ?? "api_error",
+        body
+      );
+    }
+    return body?.data;
+  }
+};
+
+// src/client.ts
+var KonetPayClient = class {
+  constructor(config) {
+    this.http = new HttpClient({
+      apiKey: config.publicKey,
+      baseUrl: config.baseUrl,
+      environment: config.environment
+    });
+  }
+  async verifyTransaction(reference) {
+    const raw = await this.http.request(`/api/transactions/status/${reference}/`);
+    return {
+      reference: raw.reference,
+      originalAmount: raw.original_amount,
+      paidAmount: raw.paid_amount,
+      totalAmount: raw.total_amount,
+      totalFee: raw.total_fee,
+      currencyCode: raw.currency_code,
+      currencySymbol: raw.currency_symbol,
+      paymentStatus: raw.payment_status,
+      message: raw.message,
+      mode: raw.mode,
+      paymentRedirectUrl: raw.payment_redirect_url
+    };
+  }
+};
+
+// src/validate-transaction-params.ts
+function assertValidInitializeTransactionParams(params) {
+  if (!Number.isInteger(params.amount) || params.amount <= 0) {
+    throw new KonetPayValidationError("amount must be a positive integer (minor currency units).", "amount");
+  }
+  if (!params.customer?.email) {
+    throw new KonetPayValidationError("customer.email is required.", "customer.email");
+  }
+}
+
+// src/server-client.ts
+var KonetPayServerClient = class {
+  constructor(config) {
+    this.http = new HttpClient({
+      apiKey: config.secretKey,
+      baseUrl: config.baseUrl,
+      environment: config.environment
+    });
+  }
+  async initializeTransaction(params) {
+    assertValidInitializeTransactionParams(params);
+    const raw = await this.http.request("/api/transactions/initialize/", {
+      method: "POST",
+      body: JSON.stringify({
+        amount: params.amount,
+        currency: params.currency,
+        email: params.customer.email,
+        customer_first_name: params.customer.firstName,
+        customer_last_name: params.customer.lastName,
+        customer_phone_number: params.customer.phoneNumber,
+        channels: params.channels,
+        fee_bearer: params.feeBearer,
+        metadata: params.metadata,
+        callback_url: params.callbackUrl
+      })
+    });
+    return {
+      reference: raw.reference,
+      accessCode: raw.access_code,
+      authorizationUrl: raw.authorization_url
+    };
+  }
+};
+
+// src/checkout/protocol.ts
+var CHECKOUT_MESSAGE_TYPE = {
+  SUCCESS: "konetpay:checkout:success",
+  CLOSE: "konetpay:checkout:close",
+  ERROR: "konetpay:checkout:error"
+};
+export {
+  CHECKOUT_MESSAGE_TYPE,
+  KonetPayApiError,
+  KonetPayClient,
+  KonetPayError,
+  KonetPayServerClient,
+  KonetPayValidationError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/index.ts","../src/transport/index.ts","../src/client.ts","../src/validate-transaction-params.ts","../src/server-client.ts","../src/checkout/protocol.ts"],"sourcesContent":["export class KonetPayError extends Error {\n  readonly code: string;\n  readonly details?: unknown;\n\n  constructor(message: string, code = \"unknown_error\", details?: unknown) {\n    super(message);\n    this.name = \"KonetPayError\";\n    this.code = code;\n    this.details = details;\n  }\n}\n\nexport class KonetPayApiError extends KonetPayError {\n  readonly statusCode: number;\n\n  constructor(message: string, statusCode: number, code = \"api_error\", details?: unknown) {\n    super(message, code, details);\n    this.name = \"KonetPayApiError\";\n    this.statusCode = statusCode;\n  }\n}\n\nexport class KonetPayValidationError extends KonetPayError {\n  readonly field?: string;\n\n  constructor(message: string, field?: string) {\n    super(message, \"validation_error\");\n    this.name = \"KonetPayValidationError\";\n    this.field = field;\n  }\n}\n","import { KonetPayApiError } from \"../errors\";\n\nexport interface HttpClientConfig {\n  apiKey: string;\n  baseUrl?: string;\n  environment?: \"sandbox\" | \"live\";\n}\n\nconst DEFAULT_BASE_URLS: Record<\"sandbox\" | \"live\", string> = {\n  sandbox: \"https://core-dev-api.konetpay.com\",\n  live: \"https://core-api.konetpay.com\",\n};\n\nexport class HttpClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n\n  constructor(config: HttpClientConfig) {\n    if (!config.apiKey) {\n      throw new KonetPayApiError(\"A valid API key is required to initialize this client.\", 0, \"missing_api_key\");\n    }\n    this.apiKey = config.apiKey;\n    this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URLS[config.environment ?? \"sandbox\"];\n  }\n\n  async request<T>(path: string, init: RequestInit = {}): Promise<T> {\n    const response = await fetch(`${this.baseUrl}${path}`, {\n      ...init,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${this.apiKey}`,\n        ...init.headers,\n      },\n    });\n\n    const body = await response.json().catch(() => undefined);\n\n    if (!response.ok || body?.status === \"error\") {\n      throw new KonetPayApiError(\n        body?.message ?? `Request to ${path} failed with status ${response.status}`,\n        response.status,\n        body?.code ?? \"api_error\",\n        body,\n      );\n    }\n\n    // Every response is wrapped as { status, message, data }.\n    return body?.data as T;\n  }\n}\n","import { HttpClient } from \"./transport\";\nimport type { Currency, PaymentStatus, VerifyTransactionResult } from \"./types\";\n\nexport interface KonetPayClientConfig {\n  /** Publishable key — safe to ship in a browser bundle. Never put a secret key here. */\n  publicKey: string;\n  baseUrl?: string;\n  environment?: \"sandbox\" | \"live\";\n}\n\n/**\n * Browser-safe client. Initializing a transaction requires a secret key and\n * lives on KonetPayServerClient instead, which must only run on your\n * backend. This client only checks transaction status — that's safe with a\n * publishable key, so it can be called directly from the browser or from\n * your backend, whichever suits your flow.\n */\nexport class KonetPayClient {\n  private readonly http: HttpClient;\n\n  constructor(config: KonetPayClientConfig) {\n    this.http = new HttpClient({\n      apiKey: config.publicKey,\n      baseUrl: config.baseUrl,\n      environment: config.environment,\n    });\n  }\n\n  async verifyTransaction(reference: string): Promise<VerifyTransactionResult> {\n    // Not /api/transactions/verify/ — that endpoint is secret-key-gated and\n    // returns an unrelated webhook-payload shape. This is the one publishable\n    // keys can actually call, and the one the hosted checkout page itself uses.\n    const raw = await this.http.request<RawVerifyTransactionResponse>(`/api/transactions/status/${reference}/`);\n    return {\n      reference: raw.reference,\n      originalAmount: raw.original_amount,\n      paidAmount: raw.paid_amount,\n      totalAmount: raw.total_amount,\n      totalFee: raw.total_fee,\n      currencyCode: raw.currency_code,\n      currencySymbol: raw.currency_symbol,\n      paymentStatus: raw.payment_status,\n      message: raw.message,\n      mode: raw.mode,\n      paymentRedirectUrl: raw.payment_redirect_url,\n    };\n  }\n}\n\n/** Wire shape — the API returns snake_case, the SDK exposes camelCase. */\ninterface RawVerifyTransactionResponse {\n  reference: string;\n  original_amount: number;\n  paid_amount: number;\n  total_amount: number;\n  total_fee: number;\n  currency_code: Currency;\n  currency_symbol: string;\n  payment_status: PaymentStatus;\n  message: string;\n  mode: \"test\" | \"live\";\n  payment_redirect_url: string | null;\n}\n","import { KonetPayValidationError } from \"./errors\";\nimport type { InitializeTransactionParams } from \"./types\";\n\nexport function assertValidInitializeTransactionParams(params: InitializeTransactionParams): void {\n  if (!Number.isInteger(params.amount) || params.amount <= 0) {\n    throw new KonetPayValidationError(\"amount must be a positive integer (minor currency units).\", \"amount\");\n  }\n  if (!params.customer?.email) {\n    throw new KonetPayValidationError(\"customer.email is required.\", \"customer.email\");\n  }\n}\n","import { HttpClient } from \"./transport\";\nimport { assertValidInitializeTransactionParams } from \"./validate-transaction-params\";\nimport type { InitializeTransactionParams, InitializeTransactionResult } from \"./types\";\n\nexport interface KonetPayServerClientConfig {\n  /** Secret key — backend-only. Never ship this to a browser bundle. */\n  secretKey: string;\n  baseUrl?: string;\n  environment?: \"sandbox\" | \"live\";\n}\n\n/**\n * Backend-only client. Requires a secret key, so it must never run in a\n * browser bundle or React Native app. Only the secret key can initialize a\n * transaction — this is what makes the amount trustworthy, since the client\n * never sees this key or picks the amount itself.\n */\nexport class KonetPayServerClient {\n  private readonly http: HttpClient;\n\n  constructor(config: KonetPayServerClientConfig) {\n    this.http = new HttpClient({\n      apiKey: config.secretKey,\n      baseUrl: config.baseUrl,\n      environment: config.environment,\n    });\n  }\n\n  async initializeTransaction(params: InitializeTransactionParams): Promise<InitializeTransactionResult> {\n    assertValidInitializeTransactionParams(params);\n    const raw = await this.http.request<RawInitializeTransactionResponse>(\"/api/transactions/initialize/\", {\n      method: \"POST\",\n      body: JSON.stringify({\n        amount: params.amount,\n        currency: params.currency,\n        email: params.customer.email,\n        customer_first_name: params.customer.firstName,\n        customer_last_name: params.customer.lastName,\n        customer_phone_number: params.customer.phoneNumber,\n        channels: params.channels,\n        fee_bearer: params.feeBearer,\n        metadata: params.metadata,\n        callback_url: params.callbackUrl,\n      }),\n    });\n    return {\n      reference: raw.reference,\n      accessCode: raw.access_code,\n      authorizationUrl: raw.authorization_url,\n    };\n  }\n}\n\n/** Wire shape — the API returns snake_case, the SDK exposes camelCase. */\ninterface RawInitializeTransactionResponse {\n  reference: string;\n  access_code: string;\n  authorization_url: string;\n}\n","/**\n * Message contract between the hosted checkout page and any SDK-side trigger\n * (browser iframe overlay via postMessage, React Native via a WebView bridge, ...).\n * Kept here, not in a platform package, so every transport agrees on the same shape.\n */\nexport const CHECKOUT_MESSAGE_TYPE = {\n  SUCCESS: \"konetpay:checkout:success\",\n  CLOSE: \"konetpay:checkout:close\",\n  ERROR: \"konetpay:checkout:error\",\n} as const;\n\nexport interface CheckoutSuccessMessage {\n  type: typeof CHECKOUT_MESSAGE_TYPE.SUCCESS;\n  reference: string;\n}\n\nexport interface CheckoutCloseMessage {\n  type: typeof CHECKOUT_MESSAGE_TYPE.CLOSE;\n}\n\nexport interface CheckoutErrorMessage {\n  type: typeof CHECKOUT_MESSAGE_TYPE.ERROR;\n  reference: string;\n  message?: string;\n}\n\nexport type CheckoutMessage = CheckoutSuccessMessage | CheckoutCloseMessage | CheckoutErrorMessage;\n\nexport type CheckoutResult =\n  | { status: \"success\"; reference: string }\n  | { status: \"cancelled\" }\n  | { status: \"error\"; reference: string; message?: string };\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@konetpay/core",
+  "version": "0.1.0",
+  "description": "Framework-agnostic core client for KonetPay: API client and the checkout protocol shared by platform-specific triggers.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/21st-Century-Technologies/konetpay-sdk-frontend.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/21st-Century-Technologies/konetpay-sdk-frontend/tree/main/packages/core#readme",
+  "bugs": {
+    "url": "https://github.com/21st-Century-Technologies/konetpay-sdk-frontend/issues"
+  },
+  "keywords": [
+    "konetpay",
+    "payments",
+    "checkout",
+    "payment-gateway",
+    "nigeria",
+    "sdk"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.2.4",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.5"
+  }
+}