@paymove-io/sdk 0.1.0

package/README.md

@@ -0,0 +1,157 @@
+# @paymove-io/sdk
+
+Official Paymove SDK for payment integration.
+
+## Requirements
+
+- Node.js >= 18.0.0
+
+## Installation
+
+```bash
+npm install @paymove-io/sdk
+```
+
+## Usage
+
+```typescript
+import { PaymoveClient, PaymoveApiError } from '@paymove-io/sdk';
+
+// Initialize the client
+const client = new PaymoveClient({
+  apiKey: 'your-api-key',
+  merchantId: 'your-merchant-id',
+  environment: 'sandbox', // or 'production'
+});
+
+// Create a payment
+try {
+  const response = await client.createPayment({
+    amount: 1000, // amount in smallest currency unit (e.g., cents)
+    currency: 'PLN',
+    orderId: 'order-123',
+    returnUrl: 'https://your-shop.com/success',
+    // optional: description
+    description: 'Payment for order #123',
+    // optional: any additional custom fields
+    customField: 'custom-value',
+  });
+
+  // Redirect user to payment page
+  console.log(response.redirectUrl);
+} catch (error) {
+  if (error instanceof PaymoveApiError) {
+    console.error('API Error:', error.statusCode, error.message);
+  }
+}
+```
+
+## API Reference
+
+### PaymoveClient
+
+#### Constructor
+
+```typescript
+new PaymoveClient(config: PaymoveConfig)
+```
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `config.apiKey` | `string` | Your Paymove API key |
+| `config.merchantId` | `string` | Your merchant ID |
+| `config.environment` | `'sandbox' \| 'production'` | API environment |
+
+#### Methods
+
+##### createPayment(params)
+
+Creates a new payment and returns the response with redirect URL.
+
+```typescript
+client.createPayment(params: CreatePaymentParams): Promise<PaymentResponse>
+```
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `amount` | `number` | Yes | Payment amount in smallest currency unit |
+| `currency` | `string` | Yes | Currency code (e.g., 'PLN', 'EUR') |
+| `orderId` | `string` | Yes | Your unique order identifier |
+| `returnUrl` | `string` | Yes | URL to redirect after payment |
+| `description` | `string` | No | Payment description |
+| `[key]` | `unknown` | No | Additional custom fields |
+
+**Returns:** `Promise<PaymentResponse>` - Response containing `redirectUrl` and other API fields.
+
+## Error Handling
+
+The SDK provides custom error classes for different error scenarios:
+
+### PaymoveValidationError
+
+Thrown when input validation fails.
+
+```typescript
+import { PaymoveValidationError } from '@paymove-io/sdk';
+
+try {
+  await client.createPayment({ /* invalid params */ });
+} catch (error) {
+  if (error instanceof PaymoveValidationError) {
+    console.error('Validation failed for field:', error.field);
+    console.error('Message:', error.message);
+  }
+}
+```
+
+### PaymoveApiError
+
+Thrown when the API returns an error response.
+
+```typescript
+import { PaymoveApiError } from '@paymove-io/sdk';
+
+try {
+  await client.createPayment({ /* params */ });
+} catch (error) {
+  if (error instanceof PaymoveApiError) {
+    console.error('Status code:', error.statusCode);
+    console.error('Message:', error.message);
+    console.error('Response body:', error.responseBody);
+  }
+}
+```
+
+### PaymoveNetworkError
+
+Thrown when a network error occurs.
+
+```typescript
+import { PaymoveNetworkError } from '@paymove-io/sdk';
+
+try {
+  await client.createPayment({ /* params */ });
+} catch (error) {
+  if (error instanceof PaymoveNetworkError) {
+    console.error('Network error:', error.message);
+    console.error('Original error:', error.cause);
+  }
+}
+```
+
+## TypeScript Support
+
+This package is written in TypeScript and includes type definitions.
+
+```typescript
+import type {
+  PaymoveConfig,
+  CreatePaymentParams,
+  PaymentResponse,
+  Environment,
+} from '@paymove-io/sdk';
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +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={...u,price:a,externalId:s,description:l??s,details:JSON.stringify({currency:o,redirectUrl:c})};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;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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      ...rest,\n      price: amount,\n      externalId: orderId,\n      description: description ?? orderId,\n      details: JSON.stringify({\n        currency,\n        redirectUrl: returnUrl,\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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"}

package/dist/index.d.cts

@@ -0,0 +1,130 @@
+//#region src/types.d.ts
+/**
+ * Environment type for Paymove API
+ */
+type Environment = 'sandbox' | 'production';
+/**
+ * Configuration for PaymoveClient initialization
+ */
+interface PaymoveConfig {
+  /** Your Paymove API key */
+  apiKey: string;
+  /** Your merchant ID */
+  merchantId: string;
+  /** Environment to use (sandbox or production) */
+  environment: Environment;
+}
+/**
+ * Parameters for creating a payment
+ */
+interface CreatePaymentParams {
+  /** Payment amount in smallest currency unit (e.g., cents) */
+  amount: number;
+  /** Currency code (e.g., 'PLN', 'EUR', 'USD') */
+  currency: string;
+  /** Your unique order identifier */
+  orderId: string;
+  /** URL to redirect the user after payment */
+  returnUrl: string;
+  /** Optional payment description */
+  description?: string;
+  /** Additional custom fields */
+  [key: string]: unknown;
+}
+/**
+ * Response from payment creation
+ */
+interface PaymentResponse {
+  /** URL to redirect the user for payment */
+  redirectUrl: string;
+  /** Additional response fields from the API */
+  [key: string]: unknown;
+} //#endregion
+//#region src/client.d.ts
+
+/**
+ * API error response structure
+ */
+/**
+ * Paymove SDK client for payment integration
+ *
+ * @example
+ * ```typescript
+ * const client = new PaymoveClient({
+ *   apiKey: 'your-api-key',
+ *   merchantId: 'your-merchant-id',
+ *   environment: 'sandbox'
+ * });
+ *
+ * const response = await client.createPayment({
+ *   amount: 1000,
+ *   currency: 'PLN',
+ *   orderId: 'order-123',
+ *   returnUrl: 'https://your-shop.com/success'
+ * });
+ *
+ * console.log(response.redirectUrl);
+ * ```
+ */
+declare class PaymoveClient {
+  private readonly apiKey;
+  private readonly merchantId;
+  private readonly baseUrl;
+  constructor(config: PaymoveConfig);
+  /**
+   * Creates a new payment and returns the response with redirect URL
+   *
+   * @param params - Payment parameters
+   * @returns Payment response containing redirectUrl
+   * @throws {PaymoveValidationError} When required parameters are missing or invalid
+   * @throws {PaymoveApiError} When the API returns an error response
+   * @throws {PaymoveNetworkError} When a network error occurs
+   */
+  createPayment(params: CreatePaymentParams): Promise<PaymentResponse>;
+  private validateConfig;
+  private validatePaymentParams;
+  private parseResponse;
+  private extractErrorMessage;
+}
+
+//#endregion
+//#region src/errors.d.ts
+//# sourceMappingURL=client.d.ts.map
+/**
+ * Base error class for all Paymove SDK errors
+ */
+declare class PaymoveError extends Error {
+  constructor(message: string);
+}
+/**
+ * Error thrown when the API returns an error response
+ */
+declare class PaymoveApiError extends PaymoveError {
+  /** HTTP status code from the API */
+  readonly statusCode: number;
+  /** Raw response body from the API */
+  readonly responseBody: unknown;
+  constructor(message: string, statusCode: number, responseBody?: unknown);
+}
+/**
+ * Error thrown when input validation fails
+ */
+declare class PaymoveValidationError extends PaymoveError {
+  /** The field that failed validation */
+  readonly field: string;
+  constructor(message: string, field: string);
+}
+/**
+ * Error thrown when a network error occurs
+ */
+declare class PaymoveNetworkError extends PaymoveError {
+  /** The original error that caused this network error */
+  readonly cause: Error;
+  constructor(message: string, cause: Error);
+}
+
+//#endregion
+//# sourceMappingURL=errors.d.ts.map
+
+export { CreatePaymentParams, Environment, PaymentResponse, PaymoveApiError, PaymoveClient, PaymoveConfig, PaymoveError, PaymoveNetworkError, PaymoveValidationError };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,130 @@
+//#region src/types.d.ts
+/**
+ * Environment type for Paymove API
+ */
+type Environment = 'sandbox' | 'production';
+/**
+ * Configuration for PaymoveClient initialization
+ */
+interface PaymoveConfig {
+  /** Your Paymove API key */
+  apiKey: string;
+  /** Your merchant ID */
+  merchantId: string;
+  /** Environment to use (sandbox or production) */
+  environment: Environment;
+}
+/**
+ * Parameters for creating a payment
+ */
+interface CreatePaymentParams {
+  /** Payment amount in smallest currency unit (e.g., cents) */
+  amount: number;
+  /** Currency code (e.g., 'PLN', 'EUR', 'USD') */
+  currency: string;
+  /** Your unique order identifier */
+  orderId: string;
+  /** URL to redirect the user after payment */
+  returnUrl: string;
+  /** Optional payment description */
+  description?: string;
+  /** Additional custom fields */
+  [key: string]: unknown;
+}
+/**
+ * Response from payment creation
+ */
+interface PaymentResponse {
+  /** URL to redirect the user for payment */
+  redirectUrl: string;
+  /** Additional response fields from the API */
+  [key: string]: unknown;
+} //#endregion
+//#region src/client.d.ts
+
+/**
+ * API error response structure
+ */
+/**
+ * Paymove SDK client for payment integration
+ *
+ * @example
+ * ```typescript
+ * const client = new PaymoveClient({
+ *   apiKey: 'your-api-key',
+ *   merchantId: 'your-merchant-id',
+ *   environment: 'sandbox'
+ * });
+ *
+ * const response = await client.createPayment({
+ *   amount: 1000,
+ *   currency: 'PLN',
+ *   orderId: 'order-123',
+ *   returnUrl: 'https://your-shop.com/success'
+ * });
+ *
+ * console.log(response.redirectUrl);
+ * ```
+ */
+declare class PaymoveClient {
+  private readonly apiKey;
+  private readonly merchantId;
+  private readonly baseUrl;
+  constructor(config: PaymoveConfig);
+  /**
+   * Creates a new payment and returns the response with redirect URL
+   *
+   * @param params - Payment parameters
+   * @returns Payment response containing redirectUrl
+   * @throws {PaymoveValidationError} When required parameters are missing or invalid
+   * @throws {PaymoveApiError} When the API returns an error response
+   * @throws {PaymoveNetworkError} When a network error occurs
+   */
+  createPayment(params: CreatePaymentParams): Promise<PaymentResponse>;
+  private validateConfig;
+  private validatePaymentParams;
+  private parseResponse;
+  private extractErrorMessage;
+}
+
+//#endregion
+//#region src/errors.d.ts
+//# sourceMappingURL=client.d.ts.map
+/**
+ * Base error class for all Paymove SDK errors
+ */
+declare class PaymoveError extends Error {
+  constructor(message: string);
+}
+/**
+ * Error thrown when the API returns an error response
+ */
+declare class PaymoveApiError extends PaymoveError {
+  /** HTTP status code from the API */
+  readonly statusCode: number;
+  /** Raw response body from the API */
+  readonly responseBody: unknown;
+  constructor(message: string, statusCode: number, responseBody?: unknown);
+}
+/**
+ * Error thrown when input validation fails
+ */
+declare class PaymoveValidationError extends PaymoveError {
+  /** The field that failed validation */
+  readonly field: string;
+  constructor(message: string, field: string);
+}
+/**
+ * Error thrown when a network error occurs
+ */
+declare class PaymoveNetworkError extends PaymoveError {
+  /** The original error that caused this network error */
+  readonly cause: Error;
+  constructor(message: string, cause: Error);
+}
+
+//#endregion
+//# sourceMappingURL=errors.d.ts.map
+
+export { CreatePaymentParams, Environment, PaymentResponse, PaymoveApiError, PaymoveClient, PaymoveConfig, PaymoveError, PaymoveNetworkError, PaymoveValidationError };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +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={...u,price:a,externalId:s,description:l??s,details:JSON.stringify({currency:o,redirectUrl:c})};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};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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      ...rest,\n      price: amount,\n      externalId: orderId,\n      description: description ?? orderId,\n      details: JSON.stringify({\n        currency,\n        redirectUrl: returnUrl,\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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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@paymove-io/sdk",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Official Paymove SDK for payment integration",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "paymove",
+    "payment",
+    "sdk",
+    "api"
+  ],
+  "author": "Paymove",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsdown": "^0.9.0",
+    "typescript": "^5.3.0"
+  }
+}