@kerembay9/horizon-pay 1.0.0

package/README.md

@@ -0,0 +1,101 @@
+# horizon-pay
+
+TypeScript/JavaScript client for the **Horizon Zeta Payment** API. Create sessions, get payment info, build checkout URLs, and complete payments with a simple, typed API.
+
+## Install
+
+```bash
+npm install horizon-pay
+```
+
+Requires Node 18+ (uses native `fetch`) or any browser with `fetch`.
+
+## Setup
+
+```ts
+import { PaymentClient } from "horizon-pay";
+
+const client = new PaymentClient({
+  baseUrl: "https://pay.horizonzeta.com",
+  apiKey: "sk_your_api_key_here", // required for createSession
+});
+```
+
+## Usage
+
+### Backend: create session and return checkout URL
+
+```ts
+const { token } = await client.createSession({
+  amount: 99.99,
+  payerEmail: "user@example.com",
+  currency: "TL",
+  successRedirectUrl: "https://yoursite.com/success",
+  failRedirectUrl: "https://yoursite.com/failed",
+  webhookUrl: "https://yoursite.com/webhooks/payment", // optional
+  metadata: { plan: "pro", userId: "123" }, // optional
+});
+
+const checkoutUrl = client.getCheckoutUrl(token, "tr"); // or "en"
+// Redirect the user to checkoutUrl.
+```
+
+### Frontend (or Node): get payment info and complete payment
+
+```ts
+// Get session info (e.g. token from URL query)
+const info = await client.getPaymentInfo(token);
+console.log(info.totalPayment, info.currency, info.payment_type);
+
+// When user submits the form, complete payment and show PayTR iframe
+const { iframeToken } = await client.completePayment({
+  token,
+  userName: "John Doe",
+  userAddress: "Istanbul, Turkey",
+  userPhone: "+905551234567",
+});
+// Use iframeToken in the PayTR iframe as per PayTR docs.
+```
+
+### Checkout URL helper
+
+```ts
+client.getCheckoutUrl(token);       // Turkish checkout: .../tr?token=...
+client.getCheckoutUrl(token, "en"); // English: .../en?token=...
+```
+
+## API reference
+
+| Method | Description |
+|--------|-------------|
+| `createSession(params, options?)` | Create a payment session. Requires API key. Returns `{ token }`. |
+| `getPaymentInfo(token)` | Get payment/session info by token. Returns `PaymentInfo`. |
+| `getCheckoutUrl(token, locale?)` | Build checkout page URL (`"tr"` or `"en"`, default `"tr"`). |
+| `completePayment(params)` | Submit customer details. Returns `{ iframeToken }` for PayTR iframe. |
+
+Types: `CreateSessionParams`, `CreateSessionResponse`, `PaymentInfo`, `CompletePaymentParams`, `CompletePaymentResponse`, `PaymentClientConfig`. See TypeScript definitions.
+
+## Errors
+
+On 4xx/5xx or network failure, the client throws `PaymentClientError`:
+
+- `message`: Human-readable message (or server `error` field when JSON).
+- `status`: HTTP status code (optional).
+- `body`: Raw response body (optional).
+
+```ts
+import { PaymentClient, PaymentClientError } from "horizon-pay";
+
+try {
+  await client.createSession({ ... });
+} catch (err) {
+  if (err instanceof PaymentClientError) {
+    console.error(err.status, err.message, err.body);
+  }
+  throw err;
+}
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,147 @@
+"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, {
+  PaymentClient: () => PaymentClient,
+  PaymentClientError: () => PaymentClientError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var PaymentClientError = class _PaymentClientError extends Error {
+  constructor(message, status, code, body) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.body = body;
+    this.name = "PaymentClientError";
+    Object.setPrototypeOf(this, _PaymentClientError.prototype);
+  }
+};
+
+// src/client.ts
+var PaymentClient = class {
+  baseUrl;
+  apiKey;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+  }
+  /**
+   * Create a payment session. Requires API key (constructor or passed here).
+   * Returns a token to use in checkout URL and getPaymentInfo/completePayment.
+   */
+  async createSession(params, options) {
+    const apiKey = options?.apiKey ?? this.apiKey;
+    if (!apiKey) {
+      throw new PaymentClientError(
+        "API key is required for createSession. Pass it in PaymentClient config or createSession options."
+      );
+    }
+    const body = {
+      amount: params.amount,
+      currency: params.currency ?? "TL",
+      payer_email: params.payerEmail,
+      payment_type: params.paymentType ?? "one_time",
+      metadata: params.metadata ?? {},
+      success_redirect_url: params.successRedirectUrl,
+      fail_redirect_url: params.failRedirectUrl,
+      webhook_url: params.webhookUrl
+    };
+    const res = await this.request("/payment/sessions", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": apiKey
+      },
+      body: JSON.stringify(body)
+    });
+    return res;
+  }
+  /**
+   * Get payment/session info by token (for checkout UI).
+   */
+  async getPaymentInfo(token) {
+    const res = await this.request(
+      `/payment/sessions?token=${encodeURIComponent(token)}`,
+      { method: "GET" }
+    );
+    return res;
+  }
+  /**
+   * Build checkout page URL for the given token and locale.
+   * @param token - Session token from createSession
+   * @param locale - "tr" or "en" (default "tr")
+   */
+  getCheckoutUrl(token, locale = "tr") {
+    const path = locale === "en" ? "en" : "tr";
+    return `${this.baseUrl}/${path}?token=${encodeURIComponent(token)}`;
+  }
+  /**
+   * Submit customer details and get PayTR iframe token.
+   * Use the returned iframeToken in the PayTR iframe to complete the payment.
+   */
+  async completePayment(params) {
+    const body = {
+      token: params.token,
+      user_name: params.userName,
+      user_address: params.userAddress,
+      user_phone: params.userPhone
+    };
+    const res = await this.request("/payment/complete-payment", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    return res;
+  }
+  async request(path, init) {
+    const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+    let res;
+    try {
+      res = await fetch(url, init);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      throw new PaymentClientError(`Network error: ${message}`);
+    }
+    const text = await res.text();
+    let body = null;
+    if (text) {
+      try {
+        body = JSON.parse(text);
+      } catch {
+        body = text;
+      }
+    }
+    if (!res.ok) {
+      const errBody = body;
+      const message = (errBody?.error && typeof errBody.error === "string" ? errBody.error : res.statusText) || `Request failed with status ${res.status}`;
+      throw new PaymentClientError(message, res.status, void 0, body);
+    }
+    return body ?? {};
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PaymentClient,
+  PaymentClientError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["export { PaymentClient } from \"./client.js\";\nexport type {\n  CreateSessionParams,\n  CreateSessionResponse,\n  PaymentInfo,\n  CompletePaymentParams,\n  CompletePaymentResponse,\n  PaymentClientConfig,\n} from \"./types.js\";\nexport { PaymentClientError } from \"./errors.js\";\n","/**\n * Thrown when a payment API request fails (4xx/5xx or network error).\n */\nexport class PaymentClientError extends Error {\n  constructor(\n    message: string,\n    public readonly status?: number,\n    public readonly code?: string,\n    public readonly body?: unknown\n  ) {\n    super(message);\n    this.name = \"PaymentClientError\";\n    Object.setPrototypeOf(this, PaymentClientError.prototype);\n  }\n}\n","import { PaymentClientError } from \"./errors.js\";\nimport type {\n  PaymentClientConfig,\n  CreateSessionParams,\n  CreateSessionResponse,\n  PaymentInfo,\n  CompletePaymentParams,\n  CompletePaymentResponse,\n  ApiErrorBody,\n} from \"./types.js\";\n\n/**\n * Client for the Horizon Zeta Payment API.\n * Use createSession (with API key), getPaymentInfo, getCheckoutUrl, and completePayment.\n */\nexport class PaymentClient {\n  private readonly baseUrl: string;\n  private readonly apiKey?: string;\n\n  constructor(config: PaymentClientConfig) {\n    this.baseUrl = config.baseUrl.replace(/\\/$/, \"\");\n    this.apiKey = config.apiKey;\n  }\n\n  /**\n   * Create a payment session. Requires API key (constructor or passed here).\n   * Returns a token to use in checkout URL and getPaymentInfo/completePayment.\n   */\n  async createSession(\n    params: CreateSessionParams,\n    options?: { apiKey?: string }\n  ): Promise<CreateSessionResponse> {\n    const apiKey = options?.apiKey ?? this.apiKey;\n    if (!apiKey) {\n      throw new PaymentClientError(\n        \"API key is required for createSession. Pass it in PaymentClient config or createSession options.\"\n      );\n    }\n    const body = {\n      amount: params.amount,\n      currency: params.currency ?? \"TL\",\n      payer_email: params.payerEmail,\n      payment_type: params.paymentType ?? \"one_time\",\n      metadata: params.metadata ?? {},\n      success_redirect_url: params.successRedirectUrl,\n      fail_redirect_url: params.failRedirectUrl,\n      webhook_url: params.webhookUrl,\n    };\n    const res = await this.request(\"/payment/sessions\", {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-API-Key\": apiKey,\n      },\n      body: JSON.stringify(body),\n    });\n    return res as unknown as CreateSessionResponse;\n  }\n\n  /**\n   * Get payment/session info by token (for checkout UI).\n   */\n  async getPaymentInfo(token: string): Promise<PaymentInfo> {\n    const res = await this.request(\n      `/payment/sessions?token=${encodeURIComponent(token)}`,\n      { method: \"GET\" }\n    );\n    return res as unknown as PaymentInfo;\n  }\n\n  /**\n   * Build checkout page URL for the given token and locale.\n   * @param token - Session token from createSession\n   * @param locale - \"tr\" or \"en\" (default \"tr\")\n   */\n  getCheckoutUrl(token: string, locale: \"tr\" | \"en\" = \"tr\"): string {\n    const path = locale === \"en\" ? \"en\" : \"tr\";\n    return `${this.baseUrl}/${path}?token=${encodeURIComponent(token)}`;\n  }\n\n  /**\n   * Submit customer details and get PayTR iframe token.\n   * Use the returned iframeToken in the PayTR iframe to complete the payment.\n   */\n  async completePayment(params: CompletePaymentParams): Promise<CompletePaymentResponse> {\n    const body = {\n      token: params.token,\n      user_name: params.userName,\n      user_address: params.userAddress,\n      user_phone: params.userPhone,\n    };\n    const res = await this.request(\"/payment/complete-payment\", {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    });\n    return res as unknown as CompletePaymentResponse;\n  }\n\n  private async request(\n    path: string,\n    init: RequestInit\n  ): Promise<Record<string, unknown>> {\n    const url = `${this.baseUrl}${path.startsWith(\"/\") ? path : `/${path}`}`;\n    let res: Response;\n    try {\n      res = await fetch(url, init);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new PaymentClientError(`Network error: ${message}`);\n    }\n    const text = await res.text();\n    let body: unknown = null;\n    if (text) {\n      try {\n        body = JSON.parse(text) as Record<string, unknown>;\n      } catch {\n        body = text;\n      }\n    }\n    if (!res.ok) {\n      const errBody = body as ApiErrorBody | undefined;\n      const message =\n        (errBody?.error && typeof errBody.error === \"string\"\n          ? errBody.error\n          : res.statusText) || `Request failed with status ${res.status}`;\n      throw new PaymentClientError(message, res.status, undefined, body);\n    }\n    return (body ?? {}) as Record<string, unknown>;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,111 @@
+/**
+ * Configuration for the payment API client.
+ */
+interface PaymentClientConfig {
+    /** Base URL of the payment service (e.g. https://pay.horizonzeta.com) */
+    baseUrl: string;
+    /** API key for createSession (required when calling createSession) */
+    apiKey?: string;
+}
+/**
+ * Parameters for creating a payment session.
+ */
+interface CreateSessionParams {
+    /** Payment amount (e.g. in TL) */
+    amount: number;
+    /** Payer email address */
+    payerEmail: string;
+    /** Currency code (default "TL") */
+    currency?: string;
+    /** "one_time" or "subscription" */
+    paymentType?: "one_time" | "subscription";
+    /** Optional metadata (discount, plan, users, etc.) */
+    metadata?: Record<string, unknown>;
+    /** URL to redirect after successful payment */
+    successRedirectUrl?: string;
+    /** URL to redirect after failed payment */
+    failRedirectUrl?: string;
+    /** Webhook URL for payment completion notification */
+    webhookUrl?: string;
+}
+/**
+ * Response from createSession.
+ */
+interface CreateSessionResponse {
+    /** Token to use in checkout URL and subsequent calls */
+    token: string;
+}
+/**
+ * Payment/session info returned by getPaymentInfo.
+ */
+interface PaymentInfo {
+    totalPayment: number;
+    discount: number;
+    upgradeDisc: number;
+    users: unknown[];
+    plan: unknown | null;
+    productDetailText: unknown | null;
+    currency: string;
+    payment_type: string;
+}
+/**
+ * Parameters for completing payment (customer details + session token).
+ */
+interface CompletePaymentParams {
+    /** Session token from createSession */
+    token: string;
+    userName: string;
+    userAddress: string;
+    userPhone: string;
+}
+/**
+ * Response from completePayment (PayTR iframe token).
+ */
+interface CompletePaymentResponse {
+    iframeToken: string;
+}
+
+/**
+ * Client for the Horizon Zeta Payment API.
+ * Use createSession (with API key), getPaymentInfo, getCheckoutUrl, and completePayment.
+ */
+declare class PaymentClient {
+    private readonly baseUrl;
+    private readonly apiKey?;
+    constructor(config: PaymentClientConfig);
+    /**
+     * Create a payment session. Requires API key (constructor or passed here).
+     * Returns a token to use in checkout URL and getPaymentInfo/completePayment.
+     */
+    createSession(params: CreateSessionParams, options?: {
+        apiKey?: string;
+    }): Promise<CreateSessionResponse>;
+    /**
+     * Get payment/session info by token (for checkout UI).
+     */
+    getPaymentInfo(token: string): Promise<PaymentInfo>;
+    /**
+     * Build checkout page URL for the given token and locale.
+     * @param token - Session token from createSession
+     * @param locale - "tr" or "en" (default "tr")
+     */
+    getCheckoutUrl(token: string, locale?: "tr" | "en"): string;
+    /**
+     * Submit customer details and get PayTR iframe token.
+     * Use the returned iframeToken in the PayTR iframe to complete the payment.
+     */
+    completePayment(params: CompletePaymentParams): Promise<CompletePaymentResponse>;
+    private request;
+}
+
+/**
+ * Thrown when a payment API request fails (4xx/5xx or network error).
+ */
+declare class PaymentClientError extends Error {
+    readonly status?: number | undefined;
+    readonly code?: string | undefined;
+    readonly body?: unknown | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined, body?: unknown | undefined);
+}
+
+export { type CompletePaymentParams, type CompletePaymentResponse, type CreateSessionParams, type CreateSessionResponse, PaymentClient, type PaymentClientConfig, PaymentClientError, type PaymentInfo };

package/dist/index.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Configuration for the payment API client.
+ */
+interface PaymentClientConfig {
+    /** Base URL of the payment service (e.g. https://pay.horizonzeta.com) */
+    baseUrl: string;
+    /** API key for createSession (required when calling createSession) */
+    apiKey?: string;
+}
+/**
+ * Parameters for creating a payment session.
+ */
+interface CreateSessionParams {
+    /** Payment amount (e.g. in TL) */
+    amount: number;
+    /** Payer email address */
+    payerEmail: string;
+    /** Currency code (default "TL") */
+    currency?: string;
+    /** "one_time" or "subscription" */
+    paymentType?: "one_time" | "subscription";
+    /** Optional metadata (discount, plan, users, etc.) */
+    metadata?: Record<string, unknown>;
+    /** URL to redirect after successful payment */
+    successRedirectUrl?: string;
+    /** URL to redirect after failed payment */
+    failRedirectUrl?: string;
+    /** Webhook URL for payment completion notification */
+    webhookUrl?: string;
+}
+/**
+ * Response from createSession.
+ */
+interface CreateSessionResponse {
+    /** Token to use in checkout URL and subsequent calls */
+    token: string;
+}
+/**
+ * Payment/session info returned by getPaymentInfo.
+ */
+interface PaymentInfo {
+    totalPayment: number;
+    discount: number;
+    upgradeDisc: number;
+    users: unknown[];
+    plan: unknown | null;
+    productDetailText: unknown | null;
+    currency: string;
+    payment_type: string;
+}
+/**
+ * Parameters for completing payment (customer details + session token).
+ */
+interface CompletePaymentParams {
+    /** Session token from createSession */
+    token: string;
+    userName: string;
+    userAddress: string;
+    userPhone: string;
+}
+/**
+ * Response from completePayment (PayTR iframe token).
+ */
+interface CompletePaymentResponse {
+    iframeToken: string;
+}
+
+/**
+ * Client for the Horizon Zeta Payment API.
+ * Use createSession (with API key), getPaymentInfo, getCheckoutUrl, and completePayment.
+ */
+declare class PaymentClient {
+    private readonly baseUrl;
+    private readonly apiKey?;
+    constructor(config: PaymentClientConfig);
+    /**
+     * Create a payment session. Requires API key (constructor or passed here).
+     * Returns a token to use in checkout URL and getPaymentInfo/completePayment.
+     */
+    createSession(params: CreateSessionParams, options?: {
+        apiKey?: string;
+    }): Promise<CreateSessionResponse>;
+    /**
+     * Get payment/session info by token (for checkout UI).
+     */
+    getPaymentInfo(token: string): Promise<PaymentInfo>;
+    /**
+     * Build checkout page URL for the given token and locale.
+     * @param token - Session token from createSession
+     * @param locale - "tr" or "en" (default "tr")
+     */
+    getCheckoutUrl(token: string, locale?: "tr" | "en"): string;
+    /**
+     * Submit customer details and get PayTR iframe token.
+     * Use the returned iframeToken in the PayTR iframe to complete the payment.
+     */
+    completePayment(params: CompletePaymentParams): Promise<CompletePaymentResponse>;
+    private request;
+}
+
+/**
+ * Thrown when a payment API request fails (4xx/5xx or network error).
+ */
+declare class PaymentClientError extends Error {
+    readonly status?: number | undefined;
+    readonly code?: string | undefined;
+    readonly body?: unknown | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined, body?: unknown | undefined);
+}
+
+export { type CompletePaymentParams, type CompletePaymentResponse, type CreateSessionParams, type CreateSessionResponse, PaymentClient, type PaymentClientConfig, PaymentClientError, type PaymentInfo };

package/dist/index.js

@@ -0,0 +1,119 @@
+// src/errors.ts
+var PaymentClientError = class _PaymentClientError extends Error {
+  constructor(message, status, code, body) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.body = body;
+    this.name = "PaymentClientError";
+    Object.setPrototypeOf(this, _PaymentClientError.prototype);
+  }
+};
+
+// src/client.ts
+var PaymentClient = class {
+  baseUrl;
+  apiKey;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+  }
+  /**
+   * Create a payment session. Requires API key (constructor or passed here).
+   * Returns a token to use in checkout URL and getPaymentInfo/completePayment.
+   */
+  async createSession(params, options) {
+    const apiKey = options?.apiKey ?? this.apiKey;
+    if (!apiKey) {
+      throw new PaymentClientError(
+        "API key is required for createSession. Pass it in PaymentClient config or createSession options."
+      );
+    }
+    const body = {
+      amount: params.amount,
+      currency: params.currency ?? "TL",
+      payer_email: params.payerEmail,
+      payment_type: params.paymentType ?? "one_time",
+      metadata: params.metadata ?? {},
+      success_redirect_url: params.successRedirectUrl,
+      fail_redirect_url: params.failRedirectUrl,
+      webhook_url: params.webhookUrl
+    };
+    const res = await this.request("/payment/sessions", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": apiKey
+      },
+      body: JSON.stringify(body)
+    });
+    return res;
+  }
+  /**
+   * Get payment/session info by token (for checkout UI).
+   */
+  async getPaymentInfo(token) {
+    const res = await this.request(
+      `/payment/sessions?token=${encodeURIComponent(token)}`,
+      { method: "GET" }
+    );
+    return res;
+  }
+  /**
+   * Build checkout page URL for the given token and locale.
+   * @param token - Session token from createSession
+   * @param locale - "tr" or "en" (default "tr")
+   */
+  getCheckoutUrl(token, locale = "tr") {
+    const path = locale === "en" ? "en" : "tr";
+    return `${this.baseUrl}/${path}?token=${encodeURIComponent(token)}`;
+  }
+  /**
+   * Submit customer details and get PayTR iframe token.
+   * Use the returned iframeToken in the PayTR iframe to complete the payment.
+   */
+  async completePayment(params) {
+    const body = {
+      token: params.token,
+      user_name: params.userName,
+      user_address: params.userAddress,
+      user_phone: params.userPhone
+    };
+    const res = await this.request("/payment/complete-payment", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    return res;
+  }
+  async request(path, init) {
+    const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+    let res;
+    try {
+      res = await fetch(url, init);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      throw new PaymentClientError(`Network error: ${message}`);
+    }
+    const text = await res.text();
+    let body = null;
+    if (text) {
+      try {
+        body = JSON.parse(text);
+      } catch {
+        body = text;
+      }
+    }
+    if (!res.ok) {
+      const errBody = body;
+      const message = (errBody?.error && typeof errBody.error === "string" ? errBody.error : res.statusText) || `Request failed with status ${res.status}`;
+      throw new PaymentClientError(message, res.status, void 0, body);
+    }
+    return body ?? {};
+  }
+};
+export {
+  PaymentClient,
+  PaymentClientError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":["/**\n * Thrown when a payment API request fails (4xx/5xx or network error).\n */\nexport class PaymentClientError extends Error {\n  constructor(\n    message: string,\n    public readonly status?: number,\n    public readonly code?: string,\n    public readonly body?: unknown\n  ) {\n    super(message);\n    this.name = \"PaymentClientError\";\n    Object.setPrototypeOf(this, PaymentClientError.prototype);\n  }\n}\n","import { PaymentClientError } from \"./errors.js\";\nimport type {\n  PaymentClientConfig,\n  CreateSessionParams,\n  CreateSessionResponse,\n  PaymentInfo,\n  CompletePaymentParams,\n  CompletePaymentResponse,\n  ApiErrorBody,\n} from \"./types.js\";\n\n/**\n * Client for the Horizon Zeta Payment API.\n * Use createSession (with API key), getPaymentInfo, getCheckoutUrl, and completePayment.\n */\nexport class PaymentClient {\n  private readonly baseUrl: string;\n  private readonly apiKey?: string;\n\n  constructor(config: PaymentClientConfig) {\n    this.baseUrl = config.baseUrl.replace(/\\/$/, \"\");\n    this.apiKey = config.apiKey;\n  }\n\n  /**\n   * Create a payment session. Requires API key (constructor or passed here).\n   * Returns a token to use in checkout URL and getPaymentInfo/completePayment.\n   */\n  async createSession(\n    params: CreateSessionParams,\n    options?: { apiKey?: string }\n  ): Promise<CreateSessionResponse> {\n    const apiKey = options?.apiKey ?? this.apiKey;\n    if (!apiKey) {\n      throw new PaymentClientError(\n        \"API key is required for createSession. Pass it in PaymentClient config or createSession options.\"\n      );\n    }\n    const body = {\n      amount: params.amount,\n      currency: params.currency ?? \"TL\",\n      payer_email: params.payerEmail,\n      payment_type: params.paymentType ?? \"one_time\",\n      metadata: params.metadata ?? {},\n      success_redirect_url: params.successRedirectUrl,\n      fail_redirect_url: params.failRedirectUrl,\n      webhook_url: params.webhookUrl,\n    };\n    const res = await this.request(\"/payment/sessions\", {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-API-Key\": apiKey,\n      },\n      body: JSON.stringify(body),\n    });\n    return res as unknown as CreateSessionResponse;\n  }\n\n  /**\n   * Get payment/session info by token (for checkout UI).\n   */\n  async getPaymentInfo(token: string): Promise<PaymentInfo> {\n    const res = await this.request(\n      `/payment/sessions?token=${encodeURIComponent(token)}`,\n      { method: \"GET\" }\n    );\n    return res as unknown as PaymentInfo;\n  }\n\n  /**\n   * Build checkout page URL for the given token and locale.\n   * @param token - Session token from createSession\n   * @param locale - \"tr\" or \"en\" (default \"tr\")\n   */\n  getCheckoutUrl(token: string, locale: \"tr\" | \"en\" = \"tr\"): string {\n    const path = locale === \"en\" ? \"en\" : \"tr\";\n    return `${this.baseUrl}/${path}?token=${encodeURIComponent(token)}`;\n  }\n\n  /**\n   * Submit customer details and get PayTR iframe token.\n   * Use the returned iframeToken in the PayTR iframe to complete the payment.\n   */\n  async completePayment(params: CompletePaymentParams): Promise<CompletePaymentResponse> {\n    const body = {\n      token: params.token,\n      user_name: params.userName,\n      user_address: params.userAddress,\n      user_phone: params.userPhone,\n    };\n    const res = await this.request(\"/payment/complete-payment\", {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    });\n    return res as unknown as CompletePaymentResponse;\n  }\n\n  private async request(\n    path: string,\n    init: RequestInit\n  ): Promise<Record<string, unknown>> {\n    const url = `${this.baseUrl}${path.startsWith(\"/\") ? path : `/${path}`}`;\n    let res: Response;\n    try {\n      res = await fetch(url, init);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new PaymentClientError(`Network error: ${message}`);\n    }\n    const text = await res.text();\n    let body: unknown = null;\n    if (text) {\n      try {\n        body = JSON.parse(text) as Record<string, unknown>;\n      } catch {\n        body = text;\n      }\n    }\n    if (!res.ok) {\n      const errBody = body as ApiErrorBody | undefined;\n      const message =\n        (errBody?.error && typeof errBody.error === \"string\"\n          ? errBody.error\n          : res.statusText) || `Request failed with status ${res.status}`;\n      throw new PaymentClientError(message, res.status, undefined, body);\n    }\n    return (body ?? {}) as Record<string, unknown>;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@kerembay9/horizon-pay",
+  "version": "1.0.0",
+  "description": "TypeScript client for Horizon Zeta Payment API",
+  "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"],
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}