@paymove-io/sdk 0.1.1 → 0.1.3

package/README.md

@@ -35,6 +35,8 @@ try {
     description: 'Payment for order #123',
     // optional: any additional custom fields
     customField: 'custom-value',
+    // optional: locale
+    locale: 'pl-PL'
   });
 
   // Redirect user to payment page
@@ -79,6 +81,7 @@ client.createPayment(params: CreatePaymentParams): Promise<PaymentResponse>
 | `orderId` | `string` | Yes | Your unique order identifier |
 | `returnUrl` | `string` | Yes | URL to redirect after payment |
 | `description` | `string` | No | Payment description |
+| `locale` | `string` | No | Locale |
 | `[key]` | `unknown` | No | Additional custom fields |
 
 **Returns:** `Promise<PaymentResponse>` - Response containing `redirectUrl` and other API fields.

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";const e={sandbox:`https://gateway-api.sandbox.paymove.io`,production:`https://gateway-api.paymove.io`};var t=class extends Error{constructor(e){super(e),this.name=`PaymoveError`,Object.setPrototypeOf(this,new.target.prototype)}},n=class extends t{statusCode;responseBody;constructor(e,t,n){super(e),this.name=`PaymoveApiError`,this.statusCode=t,this.responseBody=n}},r=class extends t{field;constructor(e,t){super(e),this.name=`PaymoveValidationError`,this.field=t}},i=class extends t{cause;constructor(e,t){super(e),this.name=`PaymoveNetworkError`,this.cause=t}},a=class{apiKey;merchantId;baseUrl;constructor(t){this.validateConfig(t),this.apiKey=t.apiKey,this.merchantId=t.merchantId,this.baseUrl=e[t.environment]}async createPayment(e){this.validatePaymentParams(e);let t=`${this.baseUrl}/api/pay/product/${this.merchantId}/subproduct/pricing`,{amount:a,currency:o,orderId:s,returnUrl:c,description:l,...u}=e,d={price:a,externalId:s,description:l??s,details:JSON.stringify({currency:o,redirectUrl:c,...u})};try{let e=await fetch(t,{method:`POST`,headers:{"Content-Type":`application/json`,"X-API-KEY":this.apiKey},body:JSON.stringify(d)}),r=await this.parseResponse(e);if(!e.ok){let t=this.extractErrorMessage(r);throw new n(t,e.status,r)}return r}catch(e){throw e instanceof n||e instanceof r?e:e instanceof Error?new i(`Network error while creating payment: ${e.message}`,e):new i(`Unknown network error while creating payment`,Error(String(e)))}}validateConfig(e){if(!e.apiKey||typeof e.apiKey!=`string`)throw new r(`apiKey is required and must be a string`,`apiKey`);if(!e.merchantId||typeof e.merchantId!=`string`)throw new r(`merchantId is required and must be a string`,`merchantId`);if(!e.environment||![`sandbox`,`production`].includes(e.environment))throw new r(`environment must be either "sandbox" or "production"`,`environment`)}validatePaymentParams(e){if(typeof e.amount!=`number`||e.amount<=0)throw new r(`amount is required and must be a positive number`,`amount`);if(!e.currency||typeof e.currency!=`string`)throw new r(`currency is required and must be a string`,`currency`);if(!e.orderId||typeof e.orderId!=`string`)throw new r(`orderId is required and must be a string`,`orderId`);if(!e.returnUrl||typeof e.returnUrl!=`string`)throw new r(`returnUrl is required and must be a string`,`returnUrl`);try{new URL(e.returnUrl)}catch{throw new r(`returnUrl must be a valid URL`,`returnUrl`)}}async parseResponse(e){let t=e.headers.get(`content-type`);if(t?.includes(`application/json`))try{return await e.json()}catch{throw new n(`Failed to parse JSON response from API`,e.status)}let r=await e.text();return{message:r}}extractErrorMessage(e){if(typeof e==`object`&&e){let t=e;return t.message||t.error||`Unknown API error`}return`Unknown API error`}};exports.PaymoveApiError=n,exports.PaymoveClient=a,exports.PaymoveError=t,exports.PaymoveNetworkError=i,exports.PaymoveValidationError=r;
+"use strict";const e={sandbox:`https://gateway-api.sandbox.paymove.io`,production:`https://gateway-api.paymove.io`};var t=class extends Error{constructor(e){super(e),this.name=`PaymoveError`,Object.setPrototypeOf(this,new.target.prototype)}},n=class extends t{statusCode;responseBody;constructor(e,t,n){super(e),this.name=`PaymoveApiError`,this.statusCode=t,this.responseBody=n}},r=class extends t{field;constructor(e,t){super(e),this.name=`PaymoveValidationError`,this.field=t}},i=class extends t{cause;constructor(e,t){super(e),this.name=`PaymoveNetworkError`,this.cause=t}},a=class{apiKey;merchantId;baseUrl;constructor(t){this.validateConfig(t),this.apiKey=t.apiKey,this.merchantId=t.merchantId,this.baseUrl=e[t.environment]}async createPayment(e){this.validatePaymentParams(e);let t=`${this.baseUrl}/api/pay/product/${this.merchantId}/subproduct/pricing`,{amount:a,orderId:o,returnUrl:s,description:c,...l}=e,u={price:a,externalId:o,description:c,details:{orderId:o,redirectUrl:s,...l}};try{let e=await fetch(t,{method:`POST`,headers:{"Content-Type":`application/json`,"X-API-KEY":this.apiKey},body:JSON.stringify(u)}),r=await this.parseResponse(e);if(!e.ok){let t=this.extractErrorMessage(r);throw new n(t,e.status,r)}return r}catch(e){throw e instanceof n||e instanceof r?e:e instanceof Error?new i(`Network error while creating payment: ${e.message}`,e):new i(`Unknown network error while creating payment`,Error(String(e)))}}validateConfig(e){if(!e.apiKey||typeof e.apiKey!=`string`)throw new r(`apiKey is required and must be a string`,`apiKey`);if(!e.merchantId||typeof e.merchantId!=`string`)throw new r(`merchantId is required and must be a string`,`merchantId`);if(!e.environment||![`sandbox`,`production`].includes(e.environment))throw new r(`environment must be either "sandbox" or "production"`,`environment`)}validatePaymentParams(e){if(typeof e.amount!=`number`||e.amount<=0)throw new r(`amount is required and must be a positive number`,`amount`);if(!e.currency||typeof e.currency!=`string`)throw new r(`currency is required and must be a string`,`currency`);if(!e.orderId||typeof e.orderId!=`string`)throw new r(`orderId is required and must be a string`,`orderId`);if(!e.returnUrl||typeof e.returnUrl!=`string`)throw new r(`returnUrl is required and must be a string`,`returnUrl`);if(!e.email||typeof e.email!=`string`)throw new r(`email is required and must be a string`,`email`);try{new URL(e.returnUrl)}catch{throw new r(`returnUrl must be a valid URL`,`returnUrl`)}}async parseResponse(e){let t=e.headers.get(`content-type`);if(t?.includes(`application/json`))try{return await e.json()}catch{throw new n(`Failed to parse JSON response from API`,e.status)}let r=await e.text();return{message:r}}extractErrorMessage(e){if(typeof e==`object`&&e){let t=e;return t.message||t.error||`Unknown API error`}return`Unknown API error`}};exports.PaymoveApiError=n,exports.PaymoveClient=a,exports.PaymoveError=t,exports.PaymoveNetworkError=i,exports.PaymoveValidationError=r;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["ENDPOINTS: Record<Environment, string>","message: string","statusCode: number","responseBody?: unknown","field: string","cause: Error","config: PaymoveConfig","params: CreatePaymentParams","response: Response","responseData: unknown"],"sources":["../src/constants.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["import type { Environment } from \"./types.js\";\n\nexport const ENDPOINTS: Record<Environment, string> = {\n  sandbox: \"https://gateway-api.sandbox.paymove.io\",\n  production: \"https://gateway-api.paymove.io\",\n} as const;\n","/**\n * Base error class for all Paymove SDK errors\n */\nexport class PaymoveError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'PaymoveError';\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Error thrown when the API returns an error response\n */\nexport class PaymoveApiError extends PaymoveError {\n  /** HTTP status code from the API */\n  public readonly statusCode: number;\n  /** Raw response body from the API */\n  public readonly responseBody: unknown;\n\n  constructor(message: string, statusCode: number, responseBody?: unknown) {\n    super(message);\n    this.name = 'PaymoveApiError';\n    this.statusCode = statusCode;\n    this.responseBody = responseBody;\n  }\n}\n\n/**\n * Error thrown when input validation fails\n */\nexport class PaymoveValidationError extends PaymoveError {\n  /** The field that failed validation */\n  public readonly field: string;\n\n  constructor(message: string, field: string) {\n    super(message);\n    this.name = 'PaymoveValidationError';\n    this.field = field;\n  }\n}\n\n/**\n * Error thrown when a network error occurs\n */\nexport class PaymoveNetworkError extends PaymoveError {\n  /** The original error that caused this network error */\n  public readonly cause: Error;\n\n  constructor(message: string, cause: Error) {\n    super(message);\n    this.name = 'PaymoveNetworkError';\n    this.cause = cause;\n  }\n}\n","import { ENDPOINTS } from \"./constants.js\";\nimport {\n  PaymoveApiError,\n  PaymoveNetworkError,\n  PaymoveValidationError,\n} from \"./errors.js\";\nimport type {\n  ApiErrorResponse,\n  CreatePaymentParams,\n  PaymoveConfig,\n  PaymentResponse,\n} from \"./types.js\";\n\n/**\n * Paymove SDK client for payment integration\n *\n * @example\n * ```typescript\n * const client = new PaymoveClient({\n *   apiKey: 'your-api-key',\n *   merchantId: 'your-merchant-id',\n *   environment: 'sandbox'\n * });\n *\n * const response = await client.createPayment({\n *   amount: 1000,\n *   currency: 'PLN',\n *   orderId: 'order-123',\n *   returnUrl: 'https://your-shop.com/success'\n * });\n *\n * console.log(response.redirectUrl);\n * ```\n */\nexport class PaymoveClient {\n  private readonly apiKey: string;\n  private readonly merchantId: string;\n  private readonly baseUrl: string;\n\n  constructor(config: PaymoveConfig) {\n    this.validateConfig(config);\n\n    this.apiKey = config.apiKey;\n    this.merchantId = config.merchantId;\n    this.baseUrl = ENDPOINTS[config.environment];\n  }\n\n  /**\n   * Creates a new payment and returns the response with redirect URL\n   *\n   * @param params - Payment parameters\n   * @returns Payment response containing redirectUrl\n   * @throws {PaymoveValidationError} When required parameters are missing or invalid\n   * @throws {PaymoveApiError} When the API returns an error response\n   * @throws {PaymoveNetworkError} When a network error occurs\n   */\n  async createPayment(params: CreatePaymentParams): Promise<PaymentResponse> {\n    this.validatePaymentParams(params);\n\n    const url = `${this.baseUrl}/api/pay/product/${this.merchantId}/subproduct/pricing`;\n\n    const { amount, currency, orderId, returnUrl, description, ...rest } =\n      params;\n\n    const body = {\n      price: amount,\n      externalId: orderId,\n      description: description ?? orderId,\n      details: JSON.stringify({\n        currency,\n        redirectUrl: returnUrl,\n        ...rest,\n      }),\n    };\n\n    try {\n      const response = await fetch(url, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-API-KEY\": this.apiKey,\n        },\n        body: JSON.stringify(body),\n      });\n\n      const responseData = await this.parseResponse(response);\n\n      if (!response.ok) {\n        const errorMessage = this.extractErrorMessage(responseData);\n        throw new PaymoveApiError(errorMessage, response.status, responseData);\n      }\n\n      return responseData as PaymentResponse;\n    } catch (error) {\n      if (\n        error instanceof PaymoveApiError ||\n        error instanceof PaymoveValidationError\n      ) {\n        throw error;\n      }\n\n      if (error instanceof Error) {\n        throw new PaymoveNetworkError(\n          `Network error while creating payment: ${error.message}`,\n          error\n        );\n      }\n\n      throw new PaymoveNetworkError(\n        \"Unknown network error while creating payment\",\n        new Error(String(error))\n      );\n    }\n  }\n\n  private validateConfig(config: PaymoveConfig): void {\n    if (!config.apiKey || typeof config.apiKey !== \"string\") {\n      throw new PaymoveValidationError(\n        \"apiKey is required and must be a string\",\n        \"apiKey\"\n      );\n    }\n\n    if (!config.merchantId || typeof config.merchantId !== \"string\") {\n      throw new PaymoveValidationError(\n        \"merchantId is required and must be a string\",\n        \"merchantId\"\n      );\n    }\n\n    if (\n      !config.environment ||\n      ![\"sandbox\", \"production\"].includes(config.environment)\n    ) {\n      throw new PaymoveValidationError(\n        'environment must be either \"sandbox\" or \"production\"',\n        \"environment\"\n      );\n    }\n  }\n\n  private validatePaymentParams(params: CreatePaymentParams): void {\n    if (typeof params.amount !== \"number\" || params.amount <= 0) {\n      throw new PaymoveValidationError(\n        \"amount is required and must be a positive number\",\n        \"amount\"\n      );\n    }\n\n    if (!params.currency || typeof params.currency !== \"string\") {\n      throw new PaymoveValidationError(\n        \"currency is required and must be a string\",\n        \"currency\"\n      );\n    }\n\n    if (!params.orderId || typeof params.orderId !== \"string\") {\n      throw new PaymoveValidationError(\n        \"orderId is required and must be a string\",\n        \"orderId\"\n      );\n    }\n\n    if (!params.returnUrl || typeof params.returnUrl !== \"string\") {\n      throw new PaymoveValidationError(\n        \"returnUrl is required and must be a string\",\n        \"returnUrl\"\n      );\n    }\n\n    try {\n      new URL(params.returnUrl);\n    } catch {\n      throw new PaymoveValidationError(\n        \"returnUrl must be a valid URL\",\n        \"returnUrl\"\n      );\n    }\n  }\n\n  private async parseResponse(response: Response): Promise<unknown> {\n    const contentType = response.headers.get(\"content-type\");\n\n    if (contentType?.includes(\"application/json\")) {\n      try {\n        return await response.json();\n      } catch {\n        throw new PaymoveApiError(\n          \"Failed to parse JSON response from API\",\n          response.status\n        );\n      }\n    }\n\n    const text = await response.text();\n    return { message: text };\n  }\n\n  private extractErrorMessage(responseData: unknown): string {\n    if (typeof responseData === \"object\" && responseData !== null) {\n      const data = responseData as ApiErrorResponse;\n      return data.message || data.error || \"Unknown API error\";\n    }\n\n    return \"Unknown API error\";\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["ENDPOINTS: Record<Environment, string>","message: string","statusCode: number","responseBody?: unknown","field: string","cause: Error","config: PaymoveConfig","params: CreatePaymentParams","response: Response","responseData: unknown"],"sources":["../src/constants.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["import type { Environment } from \"./types.js\";\n\nexport const ENDPOINTS: Record<Environment, string> = {\n  sandbox: \"https://gateway-api.sandbox.paymove.io\",\n  production: \"https://gateway-api.paymove.io\",\n} as const;\n","/**\n * Base error class for all Paymove SDK errors\n */\nexport class PaymoveError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'PaymoveError';\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Error thrown when the API returns an error response\n */\nexport class PaymoveApiError extends PaymoveError {\n  /** HTTP status code from the API */\n  public readonly statusCode: number;\n  /** Raw response body from the API */\n  public readonly responseBody: unknown;\n\n  constructor(message: string, statusCode: number, responseBody?: unknown) {\n    super(message);\n    this.name = 'PaymoveApiError';\n    this.statusCode = statusCode;\n    this.responseBody = responseBody;\n  }\n}\n\n/**\n * Error thrown when input validation fails\n */\nexport class PaymoveValidationError extends PaymoveError {\n  /** The field that failed validation */\n  public readonly field: string;\n\n  constructor(message: string, field: string) {\n    super(message);\n    this.name = 'PaymoveValidationError';\n    this.field = field;\n  }\n}\n\n/**\n * Error thrown when a network error occurs\n */\nexport class PaymoveNetworkError extends PaymoveError {\n  /** The original error that caused this network error */\n  public readonly cause: Error;\n\n  constructor(message: string, cause: Error) {\n    super(message);\n    this.name = 'PaymoveNetworkError';\n    this.cause = cause;\n  }\n}\n","import { ENDPOINTS } from \"./constants.js\";\nimport {\n  PaymoveApiError,\n  PaymoveNetworkError,\n  PaymoveValidationError,\n} from \"./errors.js\";\nimport type {\n  ApiErrorResponse,\n  CreatePaymentParams,\n  PaymoveConfig,\n  PaymentResponse,\n} from \"./types.js\";\n\n/**\n * Paymove SDK client for payment integration\n *\n * @example\n * ```typescript\n * const client = new PaymoveClient({\n *   apiKey: 'your-api-key',\n *   merchantId: 'your-merchant-id',\n *   environment: 'sandbox'\n * });\n *\n * const response = await client.createPayment({\n *   amount: 1000,\n *   currency: 'PLN',\n *   orderId: 'order-123',\n *   returnUrl: 'https://your-shop.com/success'\n * });\n *\n * console.log(response.redirectUrl);\n * ```\n */\nexport class PaymoveClient {\n  private readonly apiKey: string;\n  private readonly merchantId: string;\n  private readonly baseUrl: string;\n\n  constructor(config: PaymoveConfig) {\n    this.validateConfig(config);\n\n    this.apiKey = config.apiKey;\n    this.merchantId = config.merchantId;\n    this.baseUrl = ENDPOINTS[config.environment];\n  }\n\n  /**\n   * Creates a new payment and returns the response with redirect URL\n   *\n   * @param params - Payment parameters\n   * @returns Payment response containing redirectUrl\n   * @throws {PaymoveValidationError} When required parameters are missing or invalid\n   * @throws {PaymoveApiError} When the API returns an error response\n   * @throws {PaymoveNetworkError} When a network error occurs\n   */\n  async createPayment(params: CreatePaymentParams): Promise<PaymentResponse> {\n    this.validatePaymentParams(params);\n\n    const url = `${this.baseUrl}/api/pay/product/${this.merchantId}/subproduct/pricing`;\n\n    const { amount, orderId, returnUrl, description, ...rest } = params;\n\n    const body = {\n      price: amount,\n      externalId: orderId,\n      description,\n      details: {\n        orderId,\n        redirectUrl: returnUrl,\n        ...rest,\n      },\n    };\n\n    try {\n      const response = await fetch(url, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-API-KEY\": this.apiKey,\n        },\n        body: JSON.stringify(body),\n      });\n\n      const responseData = await this.parseResponse(response);\n\n      if (!response.ok) {\n        const errorMessage = this.extractErrorMessage(responseData);\n        throw new PaymoveApiError(errorMessage, response.status, responseData);\n      }\n\n      return responseData as PaymentResponse;\n    } catch (error) {\n      if (\n        error instanceof PaymoveApiError ||\n        error instanceof PaymoveValidationError\n      ) {\n        throw error;\n      }\n\n      if (error instanceof Error) {\n        throw new PaymoveNetworkError(\n          `Network error while creating payment: ${error.message}`,\n          error\n        );\n      }\n\n      throw new PaymoveNetworkError(\n        \"Unknown network error while creating payment\",\n        new Error(String(error))\n      );\n    }\n  }\n\n  private validateConfig(config: PaymoveConfig): void {\n    if (!config.apiKey || typeof config.apiKey !== \"string\") {\n      throw new PaymoveValidationError(\n        \"apiKey is required and must be a string\",\n        \"apiKey\"\n      );\n    }\n\n    if (!config.merchantId || typeof config.merchantId !== \"string\") {\n      throw new PaymoveValidationError(\n        \"merchantId is required and must be a string\",\n        \"merchantId\"\n      );\n    }\n\n    if (\n      !config.environment ||\n      ![\"sandbox\", \"production\"].includes(config.environment)\n    ) {\n      throw new PaymoveValidationError(\n        'environment must be either \"sandbox\" or \"production\"',\n        \"environment\"\n      );\n    }\n  }\n\n  private validatePaymentParams(params: CreatePaymentParams): void {\n    if (typeof params.amount !== \"number\" || params.amount <= 0) {\n      throw new PaymoveValidationError(\n        \"amount is required and must be a positive number\",\n        \"amount\"\n      );\n    }\n\n    if (!params.currency || typeof params.currency !== \"string\") {\n      throw new PaymoveValidationError(\n        \"currency is required and must be a string\",\n        \"currency\"\n      );\n    }\n\n    if (!params.orderId || typeof params.orderId !== \"string\") {\n      throw new PaymoveValidationError(\n        \"orderId is required and must be a string\",\n        \"orderId\"\n      );\n    }\n\n    if (!params.returnUrl || typeof params.returnUrl !== \"string\") {\n      throw new PaymoveValidationError(\n        \"returnUrl is required and must be a string\",\n        \"returnUrl\"\n      );\n    }\n\n    if (!params.email || typeof params.email !== \"string\") {\n      throw new PaymoveValidationError(\n        \"email is required and must be a string\",\n        \"email\"\n      );\n    }\n\n    try {\n      new URL(params.returnUrl);\n    } catch {\n      throw new PaymoveValidationError(\n        \"returnUrl must be a valid URL\",\n        \"returnUrl\"\n      );\n    }\n  }\n\n  private async parseResponse(response: Response): Promise<unknown> {\n    const contentType = response.headers.get(\"content-type\");\n\n    if (contentType?.includes(\"application/json\")) {\n      try {\n        return await response.json();\n      } catch {\n        throw new PaymoveApiError(\n          \"Failed to parse JSON response from API\",\n          response.status\n        );\n      }\n    }\n\n    const text = await response.text();\n    return { message: text };\n  }\n\n  private extractErrorMessage(responseData: unknown): string {\n    if (typeof responseData === \"object\" && responseData !== null) {\n      const data = responseData as ApiErrorResponse;\n      return data.message || data.error || \"Unknown API error\";\n    }\n\n    return \"Unknown API error\";\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -2,7 +2,7 @@
 /**
  * Environment type for Paymove API
  */
-type Environment = 'sandbox' | 'production';
+type Environment = "sandbox" | "production";
 /**
  * Configuration for PaymoveClient initialization
  */
@@ -26,8 +26,12 @@ interface CreatePaymentParams {
   orderId: string;
   /** URL to redirect the user after payment */
   returnUrl: string;
+  /** Email of the user */
+  email: string;
   /** Optional payment description */
   description?: string;
+  /** Locale of the payment */
+  locale?: string;
   /** Additional custom fields */
   [key: string]: unknown;
 }

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/client.ts","../src/errors.ts"],"sourcesContent":null,"mappings":";;;;KAGY,WAAA;AAAZ;;;UAKiB,aAAA;EAAA;;;;EAYA;eANF;;;AAwBf;;UAlBiB,mBAAA;;;;;;;;;;;;;;;;;UAkBA,eAAA;;;;;;;;ACJjB;;;;;;AD/BA;;;;AAKA;;;;AAYA;;;;AAkBA;;;;;;cCJa,aAAA;;;;sBAKS;;;;;;;;;;wBAiBQ,sBAAsB,QAAQ;;;;;AAtB5D;;;;;;;;cC/Ba,YAAA,SAAqB,KAAK;EFA3B,WAAA,CAAA,OAAW,EAAA,MAAA;;;;AAKvB;cEMa,eAAA,SAAwB,YAAY;;;EFMhC;;;;AAkBjB;;;cEPa,sBAAA,SAA+B,YAAY;;;;;;;;cAc3C,mBAAA,SAA4B,YAAA;;kBAEhB;sCAEa"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/client.ts","../src/errors.ts"],"sourcesContent":null,"mappings":";;;;KAGY,WAAA;AAAZ;;;UAKiB,aAAA;EAAA;;;;EAYA;eANF;;;AA4Bf;;UAtBiB,mBAAA;;;;;;;;;;;;;;;;;;;;;UAsBA,eAAA;;ECRJ,WAAA,EAAA,MAAa;EAAA;EAAA,CAAA,GAKJ,EAAA,MAAA,CAAA,EAAA,OAAA;CAAa;;;;;AAiBwB;;;;ADrD3D;;;;AAKA;;;;AAYA;;;;AAsBA;;;;;;cCRa,aAAA;;;;sBAKS;;;;;;;;;;wBAiBQ,sBAAsB,QAAQ;;;;;AAtB5D;;;;;;;;cC/Ba,YAAA,SAAqB,KAAK;EFA3B,WAAA,CAAA,OAAW,EAAA,MAAA;;;;AAKvB;cEMa,eAAA,SAAwB,YAAY;;;EFMhC;;;;AAsBjB;;;cEXa,sBAAA,SAA+B,YAAY;;;;;;;;cAc3C,mBAAA,SAA4B,YAAA;;kBAEhB;sCAEa"}

package/dist/index.d.ts

@@ -2,7 +2,7 @@
 /**
  * Environment type for Paymove API
  */
-type Environment = 'sandbox' | 'production';
+type Environment = "sandbox" | "production";
 /**
  * Configuration for PaymoveClient initialization
  */
@@ -26,8 +26,12 @@ interface CreatePaymentParams {
   orderId: string;
   /** URL to redirect the user after payment */
   returnUrl: string;
+  /** Email of the user */
+  email: string;
   /** Optional payment description */
   description?: string;
+  /** Locale of the payment */
+  locale?: string;
   /** Additional custom fields */
   [key: string]: unknown;
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/client.ts","../src/errors.ts"],"sourcesContent":null,"mappings":";;;;KAGY,WAAA;AAAZ;;;UAKiB,aAAA;EAAA;;;;EAYA;eANF;;;AAwBf;;UAlBiB,mBAAA;;;;;;;;;;;;;;;;;UAkBA,eAAA;;;;;;;;ACJjB;;;;;;AD/BA;;;;AAKA;;;;AAYA;;;;AAkBA;;;;;;cCJa,aAAA;;;;sBAKS;;;;;;;;;;wBAiBQ,sBAAsB,QAAQ;;;;;AAtB5D;;;;;;;;cC/Ba,YAAA,SAAqB,KAAK;EFA3B,WAAA,CAAA,OAAW,EAAA,MAAA;;;;AAKvB;cEMa,eAAA,SAAwB,YAAY;;;EFMhC;;;;AAkBjB;;;cEPa,sBAAA,SAA+B,YAAY;;;;;;;;cAc3C,mBAAA,SAA4B,YAAA;;kBAEhB;sCAEa"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/client.ts","../src/errors.ts"],"sourcesContent":null,"mappings":";;;;KAGY,WAAA;AAAZ;;;UAKiB,aAAA;EAAA;;;;EAYA;eANF;;;AA4Bf;;UAtBiB,mBAAA;;;;;;;;;;;;;;;;;;;;;UAsBA,eAAA;;ECRJ,WAAA,EAAA,MAAa;EAAA;EAAA,CAAA,GAKJ,EAAA,MAAA,CAAA,EAAA,OAAA;CAAa;;;;;AAiBwB;;;;ADrD3D;;;;AAKA;;;;AAYA;;;;AAsBA;;;;;;cCRa,aAAA;;;;sBAKS;;;;;;;;;;wBAiBQ,sBAAsB,QAAQ;;;;;AAtB5D;;;;;;;;cC/Ba,YAAA,SAAqB,KAAK;EFA3B,WAAA,CAAA,OAAW,EAAA,MAAA;;;;AAKvB;cEMa,eAAA,SAAwB,YAAY;;;EFMhC;;;;AAsBjB;;;cEXa,sBAAA,SAA+B,YAAY;;;;;;;;cAc3C,mBAAA,SAA4B,YAAA;;kBAEhB;sCAEa"}

package/dist/index.js

@@ -1,2 +1,2 @@
-const e={sandbox:`https://gateway-api.sandbox.paymove.io`,production:`https://gateway-api.paymove.io`};var t=class extends Error{constructor(e){super(e),this.name=`PaymoveError`,Object.setPrototypeOf(this,new.target.prototype)}},n=class extends t{statusCode;responseBody;constructor(e,t,n){super(e),this.name=`PaymoveApiError`,this.statusCode=t,this.responseBody=n}},r=class extends t{field;constructor(e,t){super(e),this.name=`PaymoveValidationError`,this.field=t}},i=class extends t{cause;constructor(e,t){super(e),this.name=`PaymoveNetworkError`,this.cause=t}},a=class{apiKey;merchantId;baseUrl;constructor(t){this.validateConfig(t),this.apiKey=t.apiKey,this.merchantId=t.merchantId,this.baseUrl=e[t.environment]}async createPayment(e){this.validatePaymentParams(e);let t=`${this.baseUrl}/api/pay/product/${this.merchantId}/subproduct/pricing`,{amount:a,currency:o,orderId:s,returnUrl:c,description:l,...u}=e,d={price:a,externalId:s,description:l??s,details:JSON.stringify({currency:o,redirectUrl:c,...u})};try{let e=await fetch(t,{method:`POST`,headers:{"Content-Type":`application/json`,"X-API-KEY":this.apiKey},body:JSON.stringify(d)}),r=await this.parseResponse(e);if(!e.ok){let t=this.extractErrorMessage(r);throw new n(t,e.status,r)}return r}catch(e){throw e instanceof n||e instanceof r?e:e instanceof Error?new i(`Network error while creating payment: ${e.message}`,e):new i(`Unknown network error while creating payment`,Error(String(e)))}}validateConfig(e){if(!e.apiKey||typeof e.apiKey!=`string`)throw new r(`apiKey is required and must be a string`,`apiKey`);if(!e.merchantId||typeof e.merchantId!=`string`)throw new r(`merchantId is required and must be a string`,`merchantId`);if(!e.environment||![`sandbox`,`production`].includes(e.environment))throw new r(`environment must be either "sandbox" or "production"`,`environment`)}validatePaymentParams(e){if(typeof e.amount!=`number`||e.amount<=0)throw new r(`amount is required and must be a positive number`,`amount`);if(!e.currency||typeof e.currency!=`string`)throw new r(`currency is required and must be a string`,`currency`);if(!e.orderId||typeof e.orderId!=`string`)throw new r(`orderId is required and must be a string`,`orderId`);if(!e.returnUrl||typeof e.returnUrl!=`string`)throw new r(`returnUrl is required and must be a string`,`returnUrl`);try{new URL(e.returnUrl)}catch{throw new r(`returnUrl must be a valid URL`,`returnUrl`)}}async parseResponse(e){let t=e.headers.get(`content-type`);if(t?.includes(`application/json`))try{return await e.json()}catch{throw new n(`Failed to parse JSON response from API`,e.status)}let r=await e.text();return{message:r}}extractErrorMessage(e){if(typeof e==`object`&&e){let t=e;return t.message||t.error||`Unknown API error`}return`Unknown API error`}};export{n as PaymoveApiError,a as PaymoveClient,t as PaymoveError,i as PaymoveNetworkError,r as PaymoveValidationError};
+const e={sandbox:`https://gateway-api.sandbox.paymove.io`,production:`https://gateway-api.paymove.io`};var t=class extends Error{constructor(e){super(e),this.name=`PaymoveError`,Object.setPrototypeOf(this,new.target.prototype)}},n=class extends t{statusCode;responseBody;constructor(e,t,n){super(e),this.name=`PaymoveApiError`,this.statusCode=t,this.responseBody=n}},r=class extends t{field;constructor(e,t){super(e),this.name=`PaymoveValidationError`,this.field=t}},i=class extends t{cause;constructor(e,t){super(e),this.name=`PaymoveNetworkError`,this.cause=t}},a=class{apiKey;merchantId;baseUrl;constructor(t){this.validateConfig(t),this.apiKey=t.apiKey,this.merchantId=t.merchantId,this.baseUrl=e[t.environment]}async createPayment(e){this.validatePaymentParams(e);let t=`${this.baseUrl}/api/pay/product/${this.merchantId}/subproduct/pricing`,{amount:a,orderId:o,returnUrl:s,description:c,...l}=e,u={price:a,externalId:o,description:c,details:{orderId:o,redirectUrl:s,...l}};try{let e=await fetch(t,{method:`POST`,headers:{"Content-Type":`application/json`,"X-API-KEY":this.apiKey},body:JSON.stringify(u)}),r=await this.parseResponse(e);if(!e.ok){let t=this.extractErrorMessage(r);throw new n(t,e.status,r)}return r}catch(e){throw e instanceof n||e instanceof r?e:e instanceof Error?new i(`Network error while creating payment: ${e.message}`,e):new i(`Unknown network error while creating payment`,Error(String(e)))}}validateConfig(e){if(!e.apiKey||typeof e.apiKey!=`string`)throw new r(`apiKey is required and must be a string`,`apiKey`);if(!e.merchantId||typeof e.merchantId!=`string`)throw new r(`merchantId is required and must be a string`,`merchantId`);if(!e.environment||![`sandbox`,`production`].includes(e.environment))throw new r(`environment must be either "sandbox" or "production"`,`environment`)}validatePaymentParams(e){if(typeof e.amount!=`number`||e.amount<=0)throw new r(`amount is required and must be a positive number`,`amount`);if(!e.currency||typeof e.currency!=`string`)throw new r(`currency is required and must be a string`,`currency`);if(!e.orderId||typeof e.orderId!=`string`)throw new r(`orderId is required and must be a string`,`orderId`);if(!e.returnUrl||typeof e.returnUrl!=`string`)throw new r(`returnUrl is required and must be a string`,`returnUrl`);if(!e.email||typeof e.email!=`string`)throw new r(`email is required and must be a string`,`email`);try{new URL(e.returnUrl)}catch{throw new r(`returnUrl must be a valid URL`,`returnUrl`)}}async parseResponse(e){let t=e.headers.get(`content-type`);if(t?.includes(`application/json`))try{return await e.json()}catch{throw new n(`Failed to parse JSON response from API`,e.status)}let r=await e.text();return{message:r}}extractErrorMessage(e){if(typeof e==`object`&&e){let t=e;return t.message||t.error||`Unknown API error`}return`Unknown API error`}};export{n as PaymoveApiError,a as PaymoveClient,t as PaymoveError,i as PaymoveNetworkError,r as PaymoveValidationError};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["ENDPOINTS: Record<Environment, string>","message: string","statusCode: number","responseBody?: unknown","field: string","cause: Error","config: PaymoveConfig","params: CreatePaymentParams","response: Response","responseData: unknown"],"sources":["../src/constants.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["import type { Environment } from \"./types.js\";\n\nexport const ENDPOINTS: Record<Environment, string> = {\n  sandbox: \"https://gateway-api.sandbox.paymove.io\",\n  production: \"https://gateway-api.paymove.io\",\n} as const;\n","/**\n * Base error class for all Paymove SDK errors\n */\nexport class PaymoveError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'PaymoveError';\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Error thrown when the API returns an error response\n */\nexport class PaymoveApiError extends PaymoveError {\n  /** HTTP status code from the API */\n  public readonly statusCode: number;\n  /** Raw response body from the API */\n  public readonly responseBody: unknown;\n\n  constructor(message: string, statusCode: number, responseBody?: unknown) {\n    super(message);\n    this.name = 'PaymoveApiError';\n    this.statusCode = statusCode;\n    this.responseBody = responseBody;\n  }\n}\n\n/**\n * Error thrown when input validation fails\n */\nexport class PaymoveValidationError extends PaymoveError {\n  /** The field that failed validation */\n  public readonly field: string;\n\n  constructor(message: string, field: string) {\n    super(message);\n    this.name = 'PaymoveValidationError';\n    this.field = field;\n  }\n}\n\n/**\n * Error thrown when a network error occurs\n */\nexport class PaymoveNetworkError extends PaymoveError {\n  /** The original error that caused this network error */\n  public readonly cause: Error;\n\n  constructor(message: string, cause: Error) {\n    super(message);\n    this.name = 'PaymoveNetworkError';\n    this.cause = cause;\n  }\n}\n","import { ENDPOINTS } from \"./constants.js\";\nimport {\n  PaymoveApiError,\n  PaymoveNetworkError,\n  PaymoveValidationError,\n} from \"./errors.js\";\nimport type {\n  ApiErrorResponse,\n  CreatePaymentParams,\n  PaymoveConfig,\n  PaymentResponse,\n} from \"./types.js\";\n\n/**\n * Paymove SDK client for payment integration\n *\n * @example\n * ```typescript\n * const client = new PaymoveClient({\n *   apiKey: 'your-api-key',\n *   merchantId: 'your-merchant-id',\n *   environment: 'sandbox'\n * });\n *\n * const response = await client.createPayment({\n *   amount: 1000,\n *   currency: 'PLN',\n *   orderId: 'order-123',\n *   returnUrl: 'https://your-shop.com/success'\n * });\n *\n * console.log(response.redirectUrl);\n * ```\n */\nexport class PaymoveClient {\n  private readonly apiKey: string;\n  private readonly merchantId: string;\n  private readonly baseUrl: string;\n\n  constructor(config: PaymoveConfig) {\n    this.validateConfig(config);\n\n    this.apiKey = config.apiKey;\n    this.merchantId = config.merchantId;\n    this.baseUrl = ENDPOINTS[config.environment];\n  }\n\n  /**\n   * Creates a new payment and returns the response with redirect URL\n   *\n   * @param params - Payment parameters\n   * @returns Payment response containing redirectUrl\n   * @throws {PaymoveValidationError} When required parameters are missing or invalid\n   * @throws {PaymoveApiError} When the API returns an error response\n   * @throws {PaymoveNetworkError} When a network error occurs\n   */\n  async createPayment(params: CreatePaymentParams): Promise<PaymentResponse> {\n    this.validatePaymentParams(params);\n\n    const url = `${this.baseUrl}/api/pay/product/${this.merchantId}/subproduct/pricing`;\n\n    const { amount, currency, orderId, returnUrl, description, ...rest } =\n      params;\n\n    const body = {\n      price: amount,\n      externalId: orderId,\n      description: description ?? orderId,\n      details: JSON.stringify({\n        currency,\n        redirectUrl: returnUrl,\n        ...rest,\n      }),\n    };\n\n    try {\n      const response = await fetch(url, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-API-KEY\": this.apiKey,\n        },\n        body: JSON.stringify(body),\n      });\n\n      const responseData = await this.parseResponse(response);\n\n      if (!response.ok) {\n        const errorMessage = this.extractErrorMessage(responseData);\n        throw new PaymoveApiError(errorMessage, response.status, responseData);\n      }\n\n      return responseData as PaymentResponse;\n    } catch (error) {\n      if (\n        error instanceof PaymoveApiError ||\n        error instanceof PaymoveValidationError\n      ) {\n        throw error;\n      }\n\n      if (error instanceof Error) {\n        throw new PaymoveNetworkError(\n          `Network error while creating payment: ${error.message}`,\n          error\n        );\n      }\n\n      throw new PaymoveNetworkError(\n        \"Unknown network error while creating payment\",\n        new Error(String(error))\n      );\n    }\n  }\n\n  private validateConfig(config: PaymoveConfig): void {\n    if (!config.apiKey || typeof config.apiKey !== \"string\") {\n      throw new PaymoveValidationError(\n        \"apiKey is required and must be a string\",\n        \"apiKey\"\n      );\n    }\n\n    if (!config.merchantId || typeof config.merchantId !== \"string\") {\n      throw new PaymoveValidationError(\n        \"merchantId is required and must be a string\",\n        \"merchantId\"\n      );\n    }\n\n    if (\n      !config.environment ||\n      ![\"sandbox\", \"production\"].includes(config.environment)\n    ) {\n      throw new PaymoveValidationError(\n        'environment must be either \"sandbox\" or \"production\"',\n        \"environment\"\n      );\n    }\n  }\n\n  private validatePaymentParams(params: CreatePaymentParams): void {\n    if (typeof params.amount !== \"number\" || params.amount <= 0) {\n      throw new PaymoveValidationError(\n        \"amount is required and must be a positive number\",\n        \"amount\"\n      );\n    }\n\n    if (!params.currency || typeof params.currency !== \"string\") {\n      throw new PaymoveValidationError(\n        \"currency is required and must be a string\",\n        \"currency\"\n      );\n    }\n\n    if (!params.orderId || typeof params.orderId !== \"string\") {\n      throw new PaymoveValidationError(\n        \"orderId is required and must be a string\",\n        \"orderId\"\n      );\n    }\n\n    if (!params.returnUrl || typeof params.returnUrl !== \"string\") {\n      throw new PaymoveValidationError(\n        \"returnUrl is required and must be a string\",\n        \"returnUrl\"\n      );\n    }\n\n    try {\n      new URL(params.returnUrl);\n    } catch {\n      throw new PaymoveValidationError(\n        \"returnUrl must be a valid URL\",\n        \"returnUrl\"\n      );\n    }\n  }\n\n  private async parseResponse(response: Response): Promise<unknown> {\n    const contentType = response.headers.get(\"content-type\");\n\n    if (contentType?.includes(\"application/json\")) {\n      try {\n        return await response.json();\n      } catch {\n        throw new PaymoveApiError(\n          \"Failed to parse JSON response from API\",\n          response.status\n        );\n      }\n    }\n\n    const text = await response.text();\n    return { message: text };\n  }\n\n  private extractErrorMessage(responseData: unknown): string {\n    if (typeof responseData === \"object\" && responseData !== null) {\n      const data = responseData as ApiErrorResponse;\n      return data.message || data.error || \"Unknown API error\";\n    }\n\n    return \"Unknown API error\";\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["ENDPOINTS: Record<Environment, string>","message: string","statusCode: number","responseBody?: unknown","field: string","cause: Error","config: PaymoveConfig","params: CreatePaymentParams","response: Response","responseData: unknown"],"sources":["../src/constants.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["import type { Environment } from \"./types.js\";\n\nexport const ENDPOINTS: Record<Environment, string> = {\n  sandbox: \"https://gateway-api.sandbox.paymove.io\",\n  production: \"https://gateway-api.paymove.io\",\n} as const;\n","/**\n * Base error class for all Paymove SDK errors\n */\nexport class PaymoveError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'PaymoveError';\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Error thrown when the API returns an error response\n */\nexport class PaymoveApiError extends PaymoveError {\n  /** HTTP status code from the API */\n  public readonly statusCode: number;\n  /** Raw response body from the API */\n  public readonly responseBody: unknown;\n\n  constructor(message: string, statusCode: number, responseBody?: unknown) {\n    super(message);\n    this.name = 'PaymoveApiError';\n    this.statusCode = statusCode;\n    this.responseBody = responseBody;\n  }\n}\n\n/**\n * Error thrown when input validation fails\n */\nexport class PaymoveValidationError extends PaymoveError {\n  /** The field that failed validation */\n  public readonly field: string;\n\n  constructor(message: string, field: string) {\n    super(message);\n    this.name = 'PaymoveValidationError';\n    this.field = field;\n  }\n}\n\n/**\n * Error thrown when a network error occurs\n */\nexport class PaymoveNetworkError extends PaymoveError {\n  /** The original error that caused this network error */\n  public readonly cause: Error;\n\n  constructor(message: string, cause: Error) {\n    super(message);\n    this.name = 'PaymoveNetworkError';\n    this.cause = cause;\n  }\n}\n","import { ENDPOINTS } from \"./constants.js\";\nimport {\n  PaymoveApiError,\n  PaymoveNetworkError,\n  PaymoveValidationError,\n} from \"./errors.js\";\nimport type {\n  ApiErrorResponse,\n  CreatePaymentParams,\n  PaymoveConfig,\n  PaymentResponse,\n} from \"./types.js\";\n\n/**\n * Paymove SDK client for payment integration\n *\n * @example\n * ```typescript\n * const client = new PaymoveClient({\n *   apiKey: 'your-api-key',\n *   merchantId: 'your-merchant-id',\n *   environment: 'sandbox'\n * });\n *\n * const response = await client.createPayment({\n *   amount: 1000,\n *   currency: 'PLN',\n *   orderId: 'order-123',\n *   returnUrl: 'https://your-shop.com/success'\n * });\n *\n * console.log(response.redirectUrl);\n * ```\n */\nexport class PaymoveClient {\n  private readonly apiKey: string;\n  private readonly merchantId: string;\n  private readonly baseUrl: string;\n\n  constructor(config: PaymoveConfig) {\n    this.validateConfig(config);\n\n    this.apiKey = config.apiKey;\n    this.merchantId = config.merchantId;\n    this.baseUrl = ENDPOINTS[config.environment];\n  }\n\n  /**\n   * Creates a new payment and returns the response with redirect URL\n   *\n   * @param params - Payment parameters\n   * @returns Payment response containing redirectUrl\n   * @throws {PaymoveValidationError} When required parameters are missing or invalid\n   * @throws {PaymoveApiError} When the API returns an error response\n   * @throws {PaymoveNetworkError} When a network error occurs\n   */\n  async createPayment(params: CreatePaymentParams): Promise<PaymentResponse> {\n    this.validatePaymentParams(params);\n\n    const url = `${this.baseUrl}/api/pay/product/${this.merchantId}/subproduct/pricing`;\n\n    const { amount, orderId, returnUrl, description, ...rest } = params;\n\n    const body = {\n      price: amount,\n      externalId: orderId,\n      description,\n      details: {\n        orderId,\n        redirectUrl: returnUrl,\n        ...rest,\n      },\n    };\n\n    try {\n      const response = await fetch(url, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-API-KEY\": this.apiKey,\n        },\n        body: JSON.stringify(body),\n      });\n\n      const responseData = await this.parseResponse(response);\n\n      if (!response.ok) {\n        const errorMessage = this.extractErrorMessage(responseData);\n        throw new PaymoveApiError(errorMessage, response.status, responseData);\n      }\n\n      return responseData as PaymentResponse;\n    } catch (error) {\n      if (\n        error instanceof PaymoveApiError ||\n        error instanceof PaymoveValidationError\n      ) {\n        throw error;\n      }\n\n      if (error instanceof Error) {\n        throw new PaymoveNetworkError(\n          `Network error while creating payment: ${error.message}`,\n          error\n        );\n      }\n\n      throw new PaymoveNetworkError(\n        \"Unknown network error while creating payment\",\n        new Error(String(error))\n      );\n    }\n  }\n\n  private validateConfig(config: PaymoveConfig): void {\n    if (!config.apiKey || typeof config.apiKey !== \"string\") {\n      throw new PaymoveValidationError(\n        \"apiKey is required and must be a string\",\n        \"apiKey\"\n      );\n    }\n\n    if (!config.merchantId || typeof config.merchantId !== \"string\") {\n      throw new PaymoveValidationError(\n        \"merchantId is required and must be a string\",\n        \"merchantId\"\n      );\n    }\n\n    if (\n      !config.environment ||\n      ![\"sandbox\", \"production\"].includes(config.environment)\n    ) {\n      throw new PaymoveValidationError(\n        'environment must be either \"sandbox\" or \"production\"',\n        \"environment\"\n      );\n    }\n  }\n\n  private validatePaymentParams(params: CreatePaymentParams): void {\n    if (typeof params.amount !== \"number\" || params.amount <= 0) {\n      throw new PaymoveValidationError(\n        \"amount is required and must be a positive number\",\n        \"amount\"\n      );\n    }\n\n    if (!params.currency || typeof params.currency !== \"string\") {\n      throw new PaymoveValidationError(\n        \"currency is required and must be a string\",\n        \"currency\"\n      );\n    }\n\n    if (!params.orderId || typeof params.orderId !== \"string\") {\n      throw new PaymoveValidationError(\n        \"orderId is required and must be a string\",\n        \"orderId\"\n      );\n    }\n\n    if (!params.returnUrl || typeof params.returnUrl !== \"string\") {\n      throw new PaymoveValidationError(\n        \"returnUrl is required and must be a string\",\n        \"returnUrl\"\n      );\n    }\n\n    if (!params.email || typeof params.email !== \"string\") {\n      throw new PaymoveValidationError(\n        \"email is required and must be a string\",\n        \"email\"\n      );\n    }\n\n    try {\n      new URL(params.returnUrl);\n    } catch {\n      throw new PaymoveValidationError(\n        \"returnUrl must be a valid URL\",\n        \"returnUrl\"\n      );\n    }\n  }\n\n  private async parseResponse(response: Response): Promise<unknown> {\n    const contentType = response.headers.get(\"content-type\");\n\n    if (contentType?.includes(\"application/json\")) {\n      try {\n        return await response.json();\n      } catch {\n        throw new PaymoveApiError(\n          \"Failed to parse JSON response from API\",\n          response.status\n        );\n      }\n    }\n\n    const text = await response.text();\n    return { message: text };\n  }\n\n  private extractErrorMessage(responseData: unknown): string {\n    if (typeof responseData === \"object\" && responseData !== null) {\n      const data = responseData as ApiErrorResponse;\n      return data.message || data.error || \"Unknown API error\";\n    }\n\n    return \"Unknown API error\";\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paymove-io/sdk",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "publishConfig": {
     "access": "public"
   },